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.
HTTP Status
Abschnitt betitelt „HTTP Status“| Status | Bedeutung | Ratschläge |
|---|---|---|
400 | Ungültige Anfrage, z. B. ist die gewählte Einstellung nicht verfügbar | Korrigieren Sie die Anfrage; führen Sie keinen erneuten Versuch durch |
401 | Anmeldeinformation fehlt, ist ungültig, abgelaufen oder widerrufen | Ändern Sie die Anmeldedaten |
402 | Der 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. |
403 | Die 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. |
404 | Die Ressource existiert nicht, wurde gelöscht oder gehört einem anderen Konto (alle drei Fälle sehen gleich aus). | Überprüfen Sie die ID |
409 | Der 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. |
410 | Die 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 |
413 | Die Datei oder der Anfragekörper überschreitet das Limit | Verwenden Sie eine kleinere Datei |
415 | Nicht unterstütztes Dateiformat | Verwenden Sie ein anderes Format |
422 | Die Validierung ist fehlgeschlagen, oder die Datei ist leer oder enthält nichts zur Verarbeitung. | Felder korrigieren; nicht automatisch erneut versuchen |
429 | Rate, Warteschlangengröße oder Budget begrenzt | Siehe unten |
5xx | Temporärer Dienstfehler | Exponentieller Backoff mit einer maximalen Anzahl von Versuchen |
Umgang mit 429
Abschnitt betitelt „Umgang mit 429“code | Bedeutung | Was ist zu tun? |
|---|---|---|
RATE_LIMITED | Zu viele Anfragen | Warten Sie auf Retry-After und versuchen Sie es dann erneut. |
CONCURRENCY_LIMITED | Zu viele Dateiübersetzungsaufträge sind in der Warteschlange | Warten Sie auf Retry-After oder bis einige Aufträge abgeschlossen sind. |
AUTH_API_KEY_QUOTA_EXCEEDED | Das 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.
Wiederholungsstrategie
Abschnitt betitelt „Wiederholungsstrategie“- Abfragen können direkt erneut versucht werden.
- Beim erneuten Versuch einer Erstellungsanfrage verwenden Sie denselben
Idempotency-Keyund 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 randomimport 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())