Zum Hauptinhalt springen

Fehlerantwortformat

Wenn eine Aufgabe fehlschlagt (status: "failed"), enthalt die Antwort ein error-Objekt:

Fehlercode-Ubersicht

Client-Fehler (vom Benutzer behebbar)


Fehlercode-Details

content_policy_violation

Inhaltspolitik-Verstoss

Ihre Anfrage wurde von Sicherheitsfiltern blockiert. Dies ist der haufigste Fehlertyp, der folgende Szenarien abdeckt:
Haufige Ausloser:
So vermeiden Sie dies:
  • Vermeiden Sie das Hochladen echter Personenfotos — verwenden Sie stattdessen Illustrations- oder Cartoon-Stile
  • Entfernen Sie Markenlogos, Marken und urheberrechtlich geschutzte IP-Charaktere
  • Vermeiden Sie Erwachsenen-, Gewalt- oder Selbstverletzungsthemen
  • Verwenden Sie generische Charakterbeschreibungen (z.B. “a person”) anstelle von Verweisen auf bestimmte Prominente

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.
Haufige Ursachen:
  • 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
So beheben Sie dies:
  • Passen Sie Ihren Prompt an, um ihn klarer und spezifischer zu machen
  • Verwenden Sie andere Referenzbilder — vermeiden Sie Bilder mit Wasserzeichen oder Logos
  • Vereinfachen Sie die Anfrage (niedrigere Auflosung oder Komplexitat)
  • Einfach erneut versuchen — einige Falle sind beim erneuten Versuch erfolgreich

invalid_parameters

Ungultige Parameter

Anfrageparameter entsprechen nicht den Modellanforderungen.
Haufige Untertypen:
So beheben Sie dies:
  • Prufen Sie die modellspezifische API-Dokumentation fur Parameteranforderungen
  • Unterstutzte Bildformate: JPG, PNG, WebP, GIF (HEIC, AVIF, TIFF werden nicht unterstutzt)
  • Bildgrossenlimits: typischerweise < 10MB, einige Modelle < 30MB
  • Kurzen Sie Ihren Prompt oder teilen Sie lange Prompts in Kernbeschreibungen auf

image_processing_error

Bildverarbeitung fehlgeschlagen

Das System konnte das Eingabebild nicht verarbeiten.
Haufige Ursachen:
  • 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
So beheben Sie dies:
  • Stellen Sie sicher, dass die Bild-URL offentlich zuganglich ist, ohne Authentifizierung oder Regionseinschrankungen
  • Verwenden Sie Standardformate: JPG, PNG, WebP
  • Versuchen Sie die Datei-Upload-API anstelle von URLs
  • Uberprufen Sie, ob das Bild im Browser korrekt geoffnet wird

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.
Beispiel:
  • aspect_ratio=1280x720 (16:9) erfordert ein 1280x720 Querformatbild
  • aspect_ratio=720x1280 (9:16) erfordert ein 720x1280 Hochformatbild
So beheben Sie dies: Andern Sie die Grosse Ihres Bildes, um den angeforderten aspect_ratio-Parameter anzupassen, oder andern Sie aspect_ratio, um Ihrem Bild zu entsprechen.

service_error

Dienstfehler

Ein internes Problem trat im Upstream-Dienst auf. Dies ist normalerweise vorubergehend — das System wechselt automatisch zu anderen verfugbaren Routen.
Haufige Ursachen:
  • Upstream-Modelldienst vorubergehend nicht verfugbar
  • Server-Uberlastung / hoher Datenverkehr
  • Wartung in Bearbeitung
  • Netzwerkverbindung unterbrochen
So beheben Sie dies:
  • Warten Sie 30-60 Sekunden und versuchen Sie es erneut — das System erholt sich normalerweise automatisch
  • Bei anhaltenden Problemen wenden Sie sich an den technischen Support
  • Keine Anderung Ihrer Anfrage erforderlich — versuchen Sie dieselbe Anfrage erneut

generation_timeout

Generierungs-Zeituberschreitung

Die Aufgabe wurde nicht innerhalb der erlaubten Zeit abgeschlossen.
Haufige Ursachen:
  • Hohe Systemauslastung verursacht Warteschlangeverzogerungen
  • Hohe Aufgabenkomplexitat (hohe Auflosung, langes Video usw.)
  • Langsame Upstream-Dienst-Antwort
So beheben Sie dies:
  • Spater erneut versuchen, vorzugsweise wahrend der Nebenzeiten
  • Aufgabenkomplexitat reduzieren: niedrigere Auflosung, kurzere Videodauer
  • Prompt-Beschreibungen vereinfachen

quota_exceeded

Kontingent / Ratenlimit uberschritten

Anfragehaufigkeit oder Gleichzeitigkeitslimits wurden uberschritten.
Haufige Ursachen:
  • Zu viele Anfragen in kurzer Zeit gesendet (Ratenlimitierung)
  • Mehrere Aufgaben werden gleichzeitig verarbeitet (Gleichzeitigkeitslimit)
  • Kontokontingent erschopft
So beheben Sie dies:
  • Anfragehaufigkeit reduzieren — empfohlenes Intervall von 1-2 Sekunden zwischen Anfragen
  • Warten Sie, bis laufende Aufgaben abgeschlossen sind, bevor Sie neue einreichen
  • Wenn das Kontingent erschopft ist, besuchen Sie die Abrechnungsseite zum Aufladen

resource_exhausted

Ressourcen erschopft

Die Rechenressourcen des Upstream-Dienstes sind vorubergehend erschopft. Tritt normalerweise wahrend Spitzennutzungszeiten des Modells auf.
So beheben Sie dies:
  • 1-5 Minuten warten fur automatische Wiederherstellung
  • Das System wechselt automatisch zwischen mehreren Routen — spateres Erneut-Versuchen ist normalerweise erfolgreich

resource_not_found

Ressource nicht gefunden

Die angeforderte Aufgaben-ID existiert nicht oder ist abgelaufen.
So beheben Sie dies:
  • Uberprufen Sie, ob die Aufgaben-ID korrekt geschrieben ist
  • Aufgabenergebnisse haben eine Ablaufrist — abgelaufene Aufgaben konnen nicht abgefragt werden
  • Wenn die ID korrekt ist, versuchen Sie es nach einer kurzen Wartezeit erneut

request_cancelled

Anfrage abgebrochen

Die Aufgabe wurde wahrend der Verarbeitung abgebrochen oder unterbrochen.
Wenn Sie nicht absichtlich abgebrochen haben, reichen Sie einfach dieselbe Anfrage erneut ein.

service_unavailable

Dienst nicht verfugbar

Ein internes Authentifizierungs- oder Verbindungsproblem ist aufgetreten. Dieser Fehler wurde automatisch protokolliert und wird typischerweise schnell behoben.
So beheben Sie dies:
  • Warten Sie einige Minuten und versuchen Sie es erneut
  • Bei anhaltenden Problemen wenden Sie sich mit Ihrer Aufgaben-ID an den technischen Support

unknown_error

Unbekannter Fehler

Ein nicht klassifizierter Fehler. Das System konnte den spezifischen Fehlertyp nicht identifizieren.
So beheben Sie dies:
  • Nach einer kurzen Wartezeit erneut versuchen
  • Wenn das Problem weiterhin besteht, wenden Sie sich mit der vollstandigen Aufgaben-ID an den technischen Support

Best Practices

Beispiel fur Fehlerbehandlung

Wiederholbar vs Nicht wiederholbar

Anfrage vor erneutem Versuch andern

  • content_policy_violation — Inhalt andern
  • invalid_parameters — Parameter korrigieren
  • image_processing_error — Anderes Bild verwenden
  • image_dimension_mismatch — Bild anpassen

Direkt erneut versuchbar

  • generation_failed_no_content — Anderen Prompt versuchen
  • service_error — Warten, dann erneut versuchen
  • generation_timeout — Warten, dann erneut versuchen
  • resource_exhausted — Automatische Wiederherstellung
  • quota_exceeded — Haufigkeit reduzieren, dann erneut versuchen