Fehlerantwortformat
Wenn eine Aufgabe fehlschlagt (status: "failed"), enthalt die Antwort ein error-Objekt:
| Feld | Typ | Beschreibung |
|---|---|---|
error.code | string | Fehlercode-Kennung. Siehe vollstandige Liste unten |
error.message | string | Benutzerfreundliche Fehlerbeschreibung mit Fehlerbehebungstipps |
Fehlercode-Ubersicht
Client-Fehler (vom Benutzer behebbar)
Client-Fehler (vom Benutzer behebbar)
| Fehlercode | Beschreibung | Wiederholbar |
|---|---|---|
content_policy_violation | Inhalt verletzt Sicherheitsrichtlinien | Inhalt andern, dann erneut versuchen |
invalid_parameters | Ungultige Anfrageparameter | Parameter korrigieren, dann erneut versuchen |
image_processing_error | Bildverarbeitung fehlgeschlagen | Anderes Bild verwenden |
image_dimension_mismatch | Bildabmessungen stimmen nicht mit Anfrage uberein | Bild anpassen, dann erneut versuchen |
request_cancelled | Anfrage wurde abgebrochen | Erneut einreichen |
Server-Fehler (Spater erneut versuchen)
Server-Fehler (Spater erneut versuchen)
| Fehlercode | Beschreibung | Wiederholbar |
|---|---|---|
generation_failed_no_content | Modell konnte keine Ausgabe erzeugen | Anderen Prompt versuchen |
service_error | Interner Servicefehler | Automatische Wiederherstellung, spater erneut versuchen |
generation_timeout | Aufgabenverarbeitung hat Zeitlimit uberschritten | Spater erneut versuchen |
resource_exhausted | Upstream-Ressourcen vorubergehend erschopft | Automatische Wiederherstellung, spater erneut versuchen |
quota_exceeded | Ratenlimit oder Kontingent uberschritten | Haufigkeit reduzieren, spater erneut versuchen |
service_unavailable | Dienst vorubergehend nicht verfugbar | Automatische Wiederherstellung, spater erneut versuchen |
resource_not_found | Aufgaben-ID ungultig oder abgelaufen | Aufgaben-ID prufen |
unknown_error | Nicht klassifizierter Fehler | Support kontaktieren |
Fehlercode-Details
content_policy_violation
Inhaltspolitik-Verstoss
Ihre Anfrage wurde von Sicherheitsfiltern blockiert. Dies ist der haufigste Fehlertyp, der folgende Szenarien abdeckt:
| Untertyp | Beschreibung | Beispielmeldung |
|---|---|---|
| Fotorealistische Personen | Hochgeladenes Bild enthalt echte Gesichter | photorealistic people detected |
| Prominente | Betrifft Prominente oder offentliche Personen | celebrity detected in image |
| Urheberrecht/Marke | Betrifft Markenlogos, Marken oder urheberrechtlich geschutztes IP | third-party content violation |
| Erwachsene/NSFW | Enthalt Nacktheit oder sexuell anzugliche Inhalte | nudity detected |
| Gewalt/Selbstverletzung | Enthalt gewaltatige, grafische oder selbstverletzende Inhalte | violence content blocked |
| Minderjahrigenschutz | Betrifft sensible Inhalte im Zusammenhang mit Minderjahrigen | minor content not allowed |
| Allgemeine Richtlinie | Andere Inhaltspolitik-Verstesse | content policy violation |
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.
| Untertyp | Beschreibung | Beispiel |
|---|---|---|
| Prompt zu lang | Prompt uberschreitet maximale Lange des Modells | Prompt is too long |
| Bildabmessung | Bildbreite/-hohe oder Seitenverhaltnis ausserhalb des Bereichs | image dimensions must be between 240 and 7680 |
| Datei zu gross | Hochgeladene Datei uberschreitet Grossenlimit | file size exceeds 10MB |
| Nicht unterstutztes Format | Hochgeladenes Dateiformat wird nicht unterstutzt | unsupported file type |
| Videodauer | Videodauer ausserhalb des unterstutzten Bereichs des Modells | Video duration must be between 1-30 seconds |
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