Fehler und Wiederholungsversuche
Lesen Sie den HTTP-Status und den JSON-Fehler-Body zusammen. Bewahren Sie alle vom Dienst zurückgegebenen Anfrage- oder Referenzkennungen auf. Damit kann der Support den passenden Datensatz finden, ohne den Prompt oder den vollständigen Schlüssel zu erhalten.
Statuscodes
| Code | Bedeutung | Aktion |
|---|---|---|
400 | Ungültiges JSON, Feld, Parameter oder abgelehnte Anfrage | Korrigieren Sie die Anfrage; wiederholen Sie sie nicht unverändert |
401 | Fehlender, ungültiger, abgelaufener oder widerrufener Schlüssel | Überprüfen Sie Authorization: Bearer <key> und die beabsichtigte Umgebung |
402 | Das Guthaben des Schlüssels deckt den Preis des Auftrags nicht (Unternehmensanalyse, Video) | Laden Sie das Guthaben auf und senden Sie die Anfrage dann erneut |
403 | Das Konto oder der Schlüssel kann das angeforderte Produkt oder die Route nicht verwenden | Überprüfen Sie GET /v1/models und die für das Konto aktivierten Produkte |
404 | Falsche Route oder nicht verfügbare Ressource | Überprüfen Sie die aktuelle Dokumentation und die Kennung |
413 | Anfrage-Body ist zu groß | Reduzieren oder teilen Sie die Eingabe |
422 | Eine unterstützte Route hat die übermittelte Struktur abgelehnt | Lesen Sie die Probleme und korrigieren Sie den Body |
429 | Ein Anfrage-, Kapazitäts- oder Kontolimit wurde erreicht, oder das Budget des Schlüssels ist aufgebraucht | Warten Sie und wiederholen Sie den Versuch mit zunehmender Verzögerung; ist das Budget aufgebraucht, laden Sie zuerst Guthaben auf |
500, 502, 503 | Vorübergehendes serverseitiges Problem | Wiederholen Sie den Versuch eine begrenzte Anzahl von Malen und kontaktieren Sie dann den Support |
Die Bild-Jobs-API (/api/v1/jobs/*) ist die Ausnahme: Sie antwortet mit dem HTTP-Status 200 und schreibt den Code in den Body, {"code": 422, "msg": "…", "data": null}. Siehe Bilderzeugung.
Wiederholungsrichtlinie
Wiederholen Sie nur bei 429, temporären 5xx-Antworten und vorübergehenden Netzwerkfehlern. Verwenden Sie eine geringe maximale Anzahl von Versuchen, ein Gesamt-Timeout, zunehmende Verzögerungen wie 1, 2 und 4 Sekunden und eine kleine zufällige Variation, wenn viele Worker gleichzeitig Wiederholungsversuche starten könnten.
Wiederholen Sie eine unveränderte 400-, 401-, 402-, 403-, 404-, 413- oder 422-Anfrage nicht. Eine unterbrochene Verbindung erfordert Vorsicht: Die Anfrage könnte bereits abgeschlossen sein und Guthaben verbraucht haben, sodass ein automatisches Duplikat zusätzliche Arbeit und Kosten verursachen kann.
Was zu protokollieren ist
Protokollieren Sie die ungefähre Zeit und Zeitzone, das öffentliche Modell, die Route, den Status, die Anfrage- oder Referenzkennung sowie den Schlüssel-Alias, das Präfix oder die letzten vier Zeichen. Protokollieren oder senden Sie niemals den vollständigen Schlüssel, Passwörter, vertrauliche Prompts, Stack-Traces oder interne Namen.
Wenn ein begrenzter Wiederholungsversuch weiterhin fehlschlägt, kontaktieren Sie support@omev.be mit einem bereinigten Beispiel und den protokollierten Kennungen.