Behandeln Sie Fehler, ohne den Anfragekontext zu verlieren.
{
"text": "Komplexer Ausgangstext in der ausgewählten Sprache.",
"locale": "de",
"mode": "simple-language"
}SDK und cURL-Beispiele verfügbar
Einheitliche Fehlermeldungen
{
"error": {
"code": "invalid_request",
"message": "Check the request fields."
}
}Die meisten Fehler verwenden die oben dargestellte error-Struktur. Antworten auf Ratenbegrenzungen enthalten zusätzlich die Felder limit, remaining und reset auf oberster Ebene.
{
"error": {
"code": "rate_limited",
"message": "Too many requests."
},
"limit": 1000,
"remaining": 0,
"reset": 1787836800
}Warte bei einer HTTP 429-Ratenbegrenzung entsprechend dem Retry-After-Header. allowance_exhausted enthält stattdessen error.details.used, limit und periodEndsAt.
Fehlercodes
Diese Fehlercodes verwendet API-Version 2:
| HTTP | Code | Bedeutung | Kundenaktion |
|---|---|---|---|
| 400 | invalid_json | Der Anfragetext ist kein gültiges JSON | Korrigieren Sie den JSON-Body |
| 400 | invalid_request | Ein Feld fehlt, ist unbekannt oder ungültig oder der Text umfasst mehr als 5.000 Zeichen | Korrigieren Sie die Anfrage |
| 400 | idempotency_key_required | Ein Job oder eine Batch-Anfrage hat keinen gültigen Idempotency-Key | Senden Sie einen eindeutigen Schlüssel mit maximal 255 Zeichen |
| 400 | invalid_webhook_endpoint | Der ausgewählte Webhook-Endpunkt fehlt oder ist inaktiv | Wählen Sie einen aktiven Endpunkt oder verwenden Sie Polling |
| 401 | invalid_api_key | Das Bearer-Token fehlt, ist ungültig oder widerrufen | Überprüfen oder ersetzen Sie den API-Schlüssel |
| 402 | billing_required | Die Abrechnung muss aktualisiert werden, bevor die Verarbeitung fortgesetzt werden kann | Aktualisieren Sie die Abrechnung in der Anwendung |
| 403 | feature_not_available | Der Arbeitsbereich verfügt über keine aktive Berechtigung | Wählen Sie einen Plan oder wenden Sie sich an den Support |
| 403 | email_not_verified | Es wird keine E-Mail-Adresse des Besitzers oder Administrators bestätigt | Bestätigen Sie die E-Mail-Adresse eines berechtigten Kontos |
| 404 | job_not_found | Der Job existiert nicht, gehört zu einem anderen Arbeitsbereich oder ist abgelaufen | Stoppen Sie die Statusabfrage und starten Sie bei Bedarf einen neuen Auftrag |
| 404 | batch_not_found | Der Stapel existiert nicht, gehört zu einem anderen Arbeitsbereich oder ist abgelaufen | Stoppen Sie die Abfrage und erstellen Sie bei Bedarf einen neuen Stapel |
| 429 | rate_limited | Die Anforderungsrate wurde erreicht | Respektieren Sie „Retry-After“. |
| 429 | concurrency_limit | Es werden zu viele Anfragen gleichzeitig bearbeitet | Versuchen Sie es erneut, nachdem eine aktive Anfrage abgeschlossen ist |
| 429 | allowance_exhausted | Das monatliche Zeichenlimit ist erreicht und die zusätzliche Nutzung ist nicht verfügbar oder deaktiviert | Warten Sie auf den nächsten Abrechnungszeitraum oder aktivieren Sie die zusätzliche Nutzung für einen berechtigten Plan |
| 502 | processing_failed | Der Dienst konnte den Text nicht verarbeiten | Wiederholen Sie die Anfrage und wenden Sie sich an den Support, falls das Problem weiterhin besteht |
Dokumentieren Sie für jeden Fehler: Kann die Anfrage wiederholt werden? Werden Zeichen berechnet? Was steht im Protokoll? Welche Angaben braucht der Support?