Zum Hauptinhalt springen

Überblick

Alle Generierungsanfragen folgen demselben grundlegenden Lebenszyklus: Job-Lebenszyklus-Diagramm Job-Lebenszyklus-Diagramm

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 in result.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)
Was 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 per GET-Anfrage an /jobs/{id} ab. Empfohlene Vorgehensweisen:
  • Poll alle 2–5 Sekunden, solange der Job aussteht (backlogged, queued, scheduled, processing, sampling oder intermediate-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
Beispielimplementierung für Polling:

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