Zum Inhalt springen

Fehler und Wiederholungen

Geschäftsfehler geben code und message auf der obersten Ebene des Antwortkörpers zurück. detail ist normalerweise identisch mit message, kann jedoch eine andere, kürzere Erklärung sein (wie unten); zeigen Sie message den Benutzern an. Die Meldungen sind auf Chinesisch:

{
"code": "CONCURRENCY_LIMITED",
"message": "排队中的文件已达上限(1000 个),请等部分文件翻译完成后再提交",
"detail": "排队文件完成一部分后可继续提交"
}

Einige Geschäftsfehler geben nur code zurück. Validierungsfehler geben 422 zurück, zusammen mit einer Liste der Feldfehler in detail:

{
"detail": [
{ "loc": ["body", "target_lang"], "msg": "Field required", "type": "missing" }
]
}

Behandeln Sie Fehler zuerst anhand des Status HTTP und anschließend anhand von code: Viele Fehler geben lediglich den generischen Code UNKNOWN_ERROR zurück, und nur einige enthalten einen spezifischen code (wie die nachfolgend aufgeführten 429 Fälle). Protokollieren Sie den Antwort-Header X-Request-Id zur Fehlerbehebung.

StatusBedeutungRatschläge
400Ungültige Anfrage, z. B. ist die gewählte Einstellung nicht verfügbarKorrigieren Sie die Anfrage; führen Sie keinen erneuten Versuch durch
401Anmeldeinformation fehlt, ist ungültig, abgelaufen oder widerrufenÄndern Sie die Anmeldedaten
402Der Saldo (nach Abzug der Schulden) liegt nicht über dem Job-Schwellenwert oder ist negativ; bei einem API-Schlüssel könnte das verbleibende Budget des Schlüssels zu niedrig sein.Laden Sie das Guthaben auf (oder erhöhen Sie das Budget des Schlüssels) und senden Sie die Anfrage anschließend erneut.
403Die Schlüsselbeschränkungen erlauben diese Operation nicht (z. B. ist die Übersetzungseinstellung nicht zulässig), das Konto ist deaktiviert oder die Operation muss in einem angemeldeten Browser durchgeführt werden (wie beim Verwalten von API-Schlüsseln).Überprüfen Sie die wichtigsten Einstellungen oder nutzen Sie die Website.
404Die Ressource existiert nicht, wurde gelöscht oder gehört einem anderen Konto (alle drei Fälle sehen gleich aus).Überprüfen Sie die ID
409Der Idempotenzschlüssel wurde für eine andere Anfrage verwendet, oder der Zustand der Ressource erlaubt die Operation nicht.Fragen Sie die ursprüngliche Operation ab und entscheiden Sie anschließend.
410Die Ressource oder der Endpunkt ist dauerhaft nicht mehr vorhanden, beispielsweise ein eingestellter Endpunkt oder ein gelöschter Job hinter einem Idempotenzschlüssel.Kein erneuter Versuch
413Die Datei oder der Anfragekörper überschreitet das LimitVerwenden Sie eine kleinere Datei
415Nicht unterstütztes DateiformatVerwenden Sie ein anderes Format
422Die Validierung ist fehlgeschlagen, oder die Datei ist leer oder enthält nichts zur Verarbeitung.Felder korrigieren; nicht automatisch erneut versuchen
429Rate, Warteschlangengröße oder Budget begrenztSiehe unten
5xxTemporärer DienstfehlerExponentieller Backoff mit einer maximalen Anzahl von Versuchen
codeBedeutungWas ist zu tun?
RATE_LIMITEDZu viele AnfragenWarten Sie auf Retry-After und versuchen Sie es dann erneut.
CONCURRENCY_LIMITEDZu viele Dateiübersetzungsaufträge sind in der WarteschlangeWarten Sie auf Retry-After oder bis einige Aufträge abgeschlossen sind.
AUTH_API_KEY_QUOTA_EXCEEDEDDas Budget des Schlüssels ist erschöpft.Führen Sie keine erneuten Versuche durch, bis das Budget erhöht wurde.

Ein 429 ohne Retry-After sollte mit exponentiellem Backoff behandelt werden.

  • Abfragen können direkt erneut versucht werden.
  • Beim erneuten Versuch einer Erstellungsanfrage verwenden Sie denselben Idempotency-Key und genau denselben Body; nutzen Sie für jede neue Übermittlung einen neuen Schlüssel.
  • Nach einem fehlgeschlagenen Upload fordern Sie eine neue Upload-Adresse an.
  • Legen Sie für jede Anfrage Verbindungs-, Lese- und Gesamtzeitüberschreitungen fest, fügen Sie den Wiederholungsversuchen zufälliges Jitter hinzu und begrenzen Sie die Anzahl der Versuche.
import random
import time
for attempt in range(5):
response = call_api()
if response.status_code not in {429, 500, 502, 503, 504}:
break
if response.status_code == 429 and response.json().get("code") == "AUTH_API_KEY_QUOTA_EXCEEDED":
break
retry_after = response.headers.get("Retry-After")
delay = float(retry_after) if retry_after else min(2 ** attempt, 16)
time.sleep(delay + random.random())