Limits
Die Ratenlimits der Direct API, die Header, die sie melden, sowie ihre Größen- und Mengenlimits.
Anfragerate
| Kontingent | Limit | Gezählt pro |
|---|---|---|
| Lesen von Generierungen | 30 pro Minute pro Generierung, insgesamt 1200 pro Minute | API-Schlüssel |
Kostenlose Tool-Aufrufe (Listen, Katalog, plan_media und jede Medien-URL, die ein Aufruf importiert) | 1000 pro Stunde | API-Schlüssel |
Webhook-Verwaltung (/webhooks und seine Pfade) | 60 pro Minute | API-Schlüssel |
/usage, /me | 60 pro Minute | API-Schlüssel |
Anfragen, deren API-Schlüssel nicht funktioniert (401) | 60 pro 10 Minuten; darüber hinaus erhalten Anfragen von dieser Adresse 429 (mit Retry-After), bis das Zeitfenster abgelaufen ist, außer mit einem Schlüssel, der sich in den letzten 10 Minuten authentifiziert hat | IP-Adresse des Clients (eine IPv6-Adresse nach ihrem /64) |
| Kostenpflichtige Tool-Aufrufe | kein Ratenlimit |
- Kostenpflichtige Aufrufe sind durch Geld begrenzt, nicht durch die Rate: durch die Credit-Limits Ihres Schlüssels und das Guthaben Ihrer Organisation.
- Unter hoher Last wartet eine Generierung in
queuedauf Modellkapazität, statt abgelehnt zu werden. Wenn Sie mehr Arbeit starten, als ein Modell gleichzeitig ausführen kann, dauern spätere Generierungen länger, schlagen aber nie fehl. - Ein kostenpflichtiger Aufruf, der sich als kostenlos herausstellt, etwa
video_remove_audiobei einem stummen Video, zählt gegen das Kontingent für kostenlose Aufrufe.
Antworten bei Ratenlimits
Jeder Endpunkt mit Ratenlimit liefert diese Header:
X-RateLimit-Limit: 1200
X-RateLimit-Remaining: 1187
X-RateLimit-Reset: 1792919760Eine abgelehnte Anfrage antwortet mit 429, Retry-After: <seconds> und diesem Body:
{
"description": "This API key read generations more than 1200 times a minute. Poll less often, or pass ?wait= to be answered when a status changes.",
"code": "rate_limited",
"data": { "retry_after_seconds": 14 }
}Warten Sie Retry-After Sekunden, bevor Sie es erneut versuchen. Ein 429 berechnet nie etwas.
Größen- und Mengenlimits
| Limit | Wert |
|---|---|
| Anfrage-Body | 1 MB |
variations pro Bildstart | 1 bis 4 |
| IDs pro gebündeltem Lesen | 10 |
wait | 45 s |
metadata | 20 Schlüssel; Schlüssel bis zu 40 Zeichen, Wert bis zu 500 |
Idempotency-Key | bis zu 200 Zeichen, 24 h lang gespeichert |
| Aktive API-Schlüssel pro Organisation | 10 |
| Webhook-Endpunkte pro Organisation | 10 |
| Gültigkeit von Asset-Links | kein Ablauf |
| Eingaben je Modell (Prompt-Länge, Referenzbilder, Dauer, Dateigrößen) | wie unter Modelle und im input_schema jedes Tools angegeben |
Wenn Sie Probleme haben oder Fragen haben, können Sie sich gerne an uns wenden. Wir helfen Ihnen gerne. Schreiben Sie uns an support@morphic.com.
Fehler
Jeder Fehlercode der Direct API, was er bedeutet und ob Sie es erneut versuchen sollten, einschließlich des Vorgehens, wenn ein kostenpflichtiger Aufruf mit einem 5xx fehlschlägt.
Tool-Katalog
Entdecken Sie die Tools der Direct API und ihre JSON-Schemas und sehen Sie jedes Tool von v1 mit der Berechtigung, die es benötigt.