Überblick
Alle Generierungsanfragen folgen demselben grundlegenden Lebenszyklus:Job-Status
queued Job wartet in der Warteschlange auf Verarbeitung backlogged Job wartet hinter deinem aktuellen Concurrency-Limit scheduled Job wurde akzeptiert und für die Verarbeitung eingeplant processing Job wird gerade von einem Worker verarbeitet sampling Job generiert Ausgabe-Samples intermediate-complete Job hat ein Zwischenergebnis und kann weiter verarbeitet werden completed Job erfolgreich abgeschlossen, Ergebnis verfügbar inresult.urls
failed Job aufgrund eines Fehlers fehlgeschlagen. Die Details stehen im error-Objekt auf oberster Ebene: code ist immer vorhanden, message ist optional. Moderationsablehnungen verwenden code: "content_policy".
cancelled Job wurde durch Nutzer oder System abgebrochen
Fehler & Abbruch
Jobs können aus mehreren Gründen fehlschlagen:- API-Fehler des Generierungsdienstes
- Ungültige Parameter oder nicht unterstützte Konfigurationen
- Content-Moderation (NSFW-Filter)
- Automatische Timeout-Erkennung (3 Minuten für gehostete Tools, 2 Stunden für externe Anbieter)
error.code bedeutet, welche Meldung dazugehört und was als Nächstes zu tun ist, findest du unter Fehler und Debugging.
So brichst du einen Job ab: Sende eine DELETE-Anfrage an /jobs/{id}. Hinweis: Jobs können nur abgebrochen werden, solange ihr Status queued oder processing ist.
Wichtig: Fehlgeschlagene und abgebrochene Jobs werden nicht abgerechnet. Du zahlst nur für abgeschlossene Jobs.
Job-Status abfragen
Frage den Job-Status perGET-Anfrage an /jobs/{id} ab. Empfohlene Vorgehensweisen:
- Poll alle 2–5 Sekunden, solange der Job aussteht (
backlogged,queued,scheduled,processing,samplingoderintermediate-complete) - Verwende Exponential Backoff für länger laufende Jobs
- Beende das Polling, sobald der Status completed, failed oder cancelled ist
- Einige Jobs können während des processing-Status Vorschaubilder in den Antworten enthalten
Nächste Schritte
Webhooks
Erhalte Benachrichtigungen, wenn Jobs abgeschlossen sind
Rate Limits
Verstehe die API-Limits nach Plan-Tier
Fehler und Debugging
HTTP-Fehler und Fehlercodes fehlgeschlagener Jobs
Model APIs
Entdecke alle verfügbaren Endpunkte und Parameter
API-Keys & Abrechnung
Erstelle und verwalte deine API-Keys