Fehlerantwortformat
Wenn eine Aufgabe fehlschlagt (status: "failed"), enthalt die Antwort ein error-Objekt:
Fehlercode-Ubersicht
Client-Fehler (vom Benutzer behebbar)
Client-Fehler (vom Benutzer behebbar)
Server-Fehler (Spater erneut versuchen)
Server-Fehler (Spater erneut versuchen)
Fehlercode-Details
content_policy_violation
Inhaltspolitik-Verstoss
Ihre Anfrage wurde von Sicherheitsfiltern blockiert. Dies ist der haufigste Fehlertyp, der folgende Szenarien abdeckt:
generation_failed_no_content
Generierung fehlgeschlagen
Das Modell konnte fur Ihre Anfrage keine Ausgabe erzeugen. Obwohl das Anfrageformat gultig war, konnte das Modell wahrend der Verarbeitung kein Ergebnis erzeugen.
- Schlechte Prompt-Qualitat: Beschreibung ist zu vage oder widerspuchlich
- Modellfahigkeitsgrenzen: Der Prompt ubersteigt die Generierungsfahigkeiten des Modells
- Upstream-Dienstprobleme: Der zugrunde liegende Modelldienst hat ein leeres Ergebnis zuruckgegeben
- Geschutzter Inhalt erkannt: Der Prompt oder das Referenzbild kann Wasserzeichenentfernung oder geschutzte Inhalte (Logos, Marken usw.) betreffen
invalid_parameters
Ungultige Parameter
Anfrageparameter entsprechen nicht den Modellanforderungen.
image_processing_error
Bildverarbeitung fehlgeschlagen
Das System konnte das Eingabebild nicht verarbeiten.
- Bild-URL ist nicht zuganglich (Authentifizierung erforderlich, CDN-Einschrankungen, abgelaufener Link)
- Bildformat wird nicht unterstutzt (z.B. HEIC, AVIF)
- Bilddatei ist beschadigt
- Netzwerkprobleme verhinderten den Bilddownload
image_dimension_mismatch
Bildabmessungen stimmen nicht uberein
Die Eingabebildabmessungen stimmen nicht mit den in der Anfrage angegebenen Abmessungen uberein. Haufig bei Bild-zu-Video-Szenarien.
aspect_ratio=1280x720(16:9) erfordert ein 1280x720 Querformatbildaspect_ratio=720x1280(9:16) erfordert ein 720x1280 Hochformatbild
service_error
Dienstfehler
Ein internes Problem trat im Upstream-Dienst auf. Dies ist normalerweise vorubergehend — das System wechselt automatisch zu anderen verfugbaren Routen.
- Upstream-Modelldienst vorubergehend nicht verfugbar
- Server-Uberlastung / hoher Datenverkehr
- Wartung in Bearbeitung
- Netzwerkverbindung unterbrochen
generation_timeout
Generierungs-Zeituberschreitung
Die Aufgabe wurde nicht innerhalb der erlaubten Zeit abgeschlossen.
- Hohe Systemauslastung verursacht Warteschlangeverzogerungen
- Hohe Aufgabenkomplexitat (hohe Auflosung, langes Video usw.)
- Langsame Upstream-Dienst-Antwort
quota_exceeded
Kontingent / Ratenlimit uberschritten
Anfragehaufigkeit oder Gleichzeitigkeitslimits wurden uberschritten.
- Zu viele Anfragen in kurzer Zeit gesendet (Ratenlimitierung)
- Mehrere Aufgaben werden gleichzeitig verarbeitet (Gleichzeitigkeitslimit)
- Kontokontingent erschopft
resource_exhausted
Ressourcen erschopft
Die Rechenressourcen des Upstream-Dienstes sind vorubergehend erschopft. Tritt normalerweise wahrend Spitzennutzungszeiten des Modells auf.
resource_not_found
Ressource nicht gefunden
Die angeforderte Aufgaben-ID existiert nicht oder ist abgelaufen.
request_cancelled
Anfrage abgebrochen
Die Aufgabe wurde wahrend der Verarbeitung abgebrochen oder unterbrochen.
service_unavailable
Dienst nicht verfugbar
Ein internes Authentifizierungs- oder Verbindungsproblem ist aufgetreten. Dieser Fehler wurde automatisch protokolliert und wird typischerweise schnell behoben.
unknown_error
Unbekannter Fehler
Ein nicht klassifizierter Fehler. Das System konnte den spezifischen Fehlertyp nicht identifizieren.
Best Practices
Beispiel fur Fehlerbehandlung
Wiederholbar vs Nicht wiederholbar
Anfrage vor erneutem Versuch andern
content_policy_violation— Inhalt anderninvalid_parameters— Parameter korrigierenimage_processing_error— Anderes Bild verwendenimage_dimension_mismatch— Bild anpassen
Direkt erneut versuchbar
generation_failed_no_content— Anderen Prompt versuchenservice_error— Warten, dann erneut versuchengeneration_timeout— Warten, dann erneut versuchenresource_exhausted— Automatische Wiederherstellungquota_exceeded— Haufigkeit reduzieren, dann erneut versuchen