Dokumentation

Fehler / Rate Limits

Fehler

HTTP-Fehler enthalten ein error-Objekt mit code und message. Auch ein erfolgreich angenommener Task kann später noch fehlschlagen; fragen Sie den Task ab oder verarbeiten Sie den Callback für Fehler.

{
  "error": {
    "code": "invalid_request",
    "message": "input.prompt is required."
  }
}

HTTP	Feld	Vorgehensweise
400	`invalid_request`	Korrigieren Sie das JSON, den fehlenden Prompt, den Parameterbereich oder die Medien-URL, bevor Sie es erneut versuchen.
401	`invalid_api_key`	Überprüfen Sie das Bearer-Token und ob der API-Key aktiv ist.
402	`insufficient_credits`	Laden Sie Credits auf oder reduzieren Sie die Task-Kosten. Die Antwort kann den benötigten und den verfügbaren Betrag enthalten.
403	`forbidden`	Überprüfen Sie die in der Fehlermeldung beschriebene Einschränkung auf Kontoebene.
404	`not_found`	Überprüfen Sie die Task-ID und ob der Key dem Besitzer des Tasks gehört.
429	`rate_limited`	Warten Sie das Retry-After-Intervall ab, bevor Sie es erneut versuchen.
500	`internal_error`	Prüfen Sie die Fehlermeldung und die API-Protokolle. Gehen Sie bei erneuten Versuchen vorsichtig vor; das erneute Senden einer Erstellungsanfrage kann einen weiteren kostenpflichtigen Task auslösen.

Rate Limits

Tasks erstellen: Pro API-Schlüssel sind standardmäßig bis zu 100 Anfragen pro Minute zulässig. Individuelle Ratenbegrenzungen sind derzeit nicht verfügbar.

Tasks abfragen: Pro API-Schlüssel sind standardmäßig bis zu 120 Anfragen pro Minute zulässig. Abfragen und Erstellungsanfragen werden separat gezählt.

Anfragen zur Bild- und Videoerstellung teilen sich das gleiche Ratenlimit des API-Keys.

HTTP 429 enthält Retry-After: 60 bei der Erstellung und Retry-After: 5 bei Abfragen. Nutzen Sie Backoff-Verfahren und vermeiden Sie unnötig häufiges Polling.

HTTP/1.1 429 Too Many Requests
Content-Type: application/json
Retry-After: 60

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded."
  }
}