Zum Hauptinhalt springen

Fehlerantwortformat

Wenn eine Aufgabe fehlschlagt (status: "failed"), enthalt die Antwort ein error-Objekt:
{
  "id": "task-unified-1772618027-cmeisy8h",
  "object": "image.generation.task",
  "status": "failed",
  "model": "gemini-3.1-flash-image-preview",
  "progress": 0,
  "error": {
    "code": "content_policy_violation",
    "message": "Content policy violation.\nYour request was blocked by safety filters..."
  }
}
FeldTypBeschreibung
error.codestringFehlercode-Kennung. Siehe vollstandige Liste unten
error.messagestringBenutzerfreundliche Fehlerbeschreibung mit Fehlerbehebungstipps

Fehlercode-Ubersicht

Client-Fehler (vom Benutzer behebbar)

FehlercodeBeschreibungWiederholbar
content_policy_violationInhalt verletzt SicherheitsrichtlinienInhalt andern, dann erneut versuchen
invalid_parametersUngultige AnfrageparameterParameter korrigieren, dann erneut versuchen
image_processing_errorBildverarbeitung fehlgeschlagenAnderes Bild verwenden
image_dimension_mismatchBildabmessungen stimmen nicht mit Anfrage ubereinBild anpassen, dann erneut versuchen
request_cancelledAnfrage wurde abgebrochenErneut einreichen
FehlercodeBeschreibungWiederholbar
generation_failed_no_contentModell konnte keine Ausgabe erzeugenAnderen Prompt versuchen
service_errorInterner ServicefehlerAutomatische Wiederherstellung, spater erneut versuchen
generation_timeoutAufgabenverarbeitung hat Zeitlimit uberschrittenSpater erneut versuchen
resource_exhaustedUpstream-Ressourcen vorubergehend erschopftAutomatische Wiederherstellung, spater erneut versuchen
quota_exceededRatenlimit oder Kontingent uberschrittenHaufigkeit reduzieren, spater erneut versuchen
service_unavailableDienst vorubergehend nicht verfugbarAutomatische Wiederherstellung, spater erneut versuchen
resource_not_foundAufgaben-ID ungultig oder abgelaufenAufgaben-ID prufen
unknown_errorNicht klassifizierter FehlerSupport kontaktieren

Fehlercode-Details

content_policy_violation

Inhaltspolitik-Verstoss

Ihre Anfrage wurde von Sicherheitsfiltern blockiert. Dies ist der haufigste Fehlertyp, der folgende Szenarien abdeckt:
Haufige Ausloser:
UntertypBeschreibungBeispielmeldung
Fotorealistische PersonenHochgeladenes Bild enthalt echte Gesichterphotorealistic people detected
ProminenteBetrifft Prominente oder offentliche Personencelebrity detected in image
Urheberrecht/MarkeBetrifft Markenlogos, Marken oder urheberrechtlich geschutztes IPthird-party content violation
Erwachsene/NSFWEnthalt Nacktheit oder sexuell anzugliche Inhaltenudity detected
Gewalt/SelbstverletzungEnthalt gewaltatige, grafische oder selbstverletzende Inhalteviolence content blocked
MinderjahrigenschutzBetrifft sensible Inhalte im Zusammenhang mit Minderjahrigenminor content not allowed
Allgemeine RichtlinieAndere Inhaltspolitik-Verstessecontent policy violation
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:
UntertypBeschreibungBeispiel
Prompt zu langPrompt uberschreitet maximale Lange des ModellsPrompt is too long
BildabmessungBildbreite/-hohe oder Seitenverhaltnis ausserhalb des Bereichsimage dimensions must be between 240 and 7680
Datei zu grossHochgeladene Datei uberschreitet Grossenlimitfile size exceeds 10MB
Nicht unterstutztes FormatHochgeladenes Dateiformat wird nicht unterstutztunsupported file type
VideodauerVideodauer ausserhalb des unterstutzten Bereichs des ModellsVideo duration must be between 1-30 seconds
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

import requests
import time

def poll_task_with_retry(task_id, api_key, max_retries=3):
    """Poll task status with automatic retry for server errors"""
    headers = {"Authorization": f"Bearer {api_key}"}

    for attempt in range(max_retries):
        resp = requests.get(
            f"https://api.evolink.ai/v1/tasks/{task_id}",
            headers=headers
        )
        data = resp.json()

        if data["status"] == "completed":
            return data["results"]

        if data["status"] == "failed":
            error = data.get("error", {})
            code = error.get("code", "unknown_error")
            message = error.get("message", "")

            # Client errors — not retryable, fix the request
            if code in [
                "content_policy_violation",
                "invalid_parameters",
                "image_processing_error",
                "image_dimension_mismatch",
            ]:
                raise Exception(f"Client error [{code}]: {message}")

            # Server errors — retryable
            if code in [
                "generation_failed_no_content",
                "service_error",
                "generation_timeout",
                "resource_exhausted",
                "quota_exceeded",
            ]:
                if attempt < max_retries - 1:
                    wait = 2 ** attempt * 5  # 5s, 10s, 20s
                    time.sleep(wait)
                    continue
                raise Exception(f"Server error [{code}]: {message}")

            raise Exception(f"Error [{code}]: {message}")

        # Task still processing
        time.sleep(3)

    raise Exception("Max polling attempts exceeded")

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