Fehler
Fehlerformat der ReWords.AI API, HTTP-Statuscodes und Fehlercodes und welche Fehler berechnet werden.
Alle Fehler haben dieselbe Form:
{ "error": { "code": "queue_full", "message": "30 jobs are already waiting. Retry in 30 seconds.", "details": {} } }| HTTP | Code | Berechnet | Was tun |
|---|---|---|---|
| 400 | invalid_request | Nein | Korrigieren Sie den Request-Body. Senden Sie genau eine Bildeingabe, als application/json oder multipart/form-data. |
| 400 | invalid_image | Nein | Senden Sie ein JPEG, PNG oder WebP bis 20 MB und 8000 px (JSON-Body bis 28 MB), oder prüfen Sie, ob sich image_url herunterladen lässt. Siehe Bilder. |
| 401 | invalid_api_key | Nein | Prüfen Sie den Authorization-Header. |
| 402 | insufficient_balance | Nein | Kaufen Sie ein Bearbeitungspaket. |
| 402 | insufficient_ocr_balance | Nein | Kaufen Sie ein OCR-Paket, oder senden Sie Text ohne box an POST /edits (OCR ist dort kostenlos). |
| 403 | image_blocked | Nein | Das Bild hat die Inhaltsprüfung nicht bestanden. |
| 404 | not_found | Nein | Die Bearbeitungs-id existiert für Ihr Konto nicht, oder der Pfad ist falsch. |
| 422 | text_not_found | Nein | Versuchen Sie es erneut mit Boxen aus error.details.texts. |
| 429 | rate_limited | Nein | Warten Sie Retry-After Sekunden. Limits: 30 Sendungen und 240 Abfragen pro Minute. |
| 503 | queue_full | Nein | Warten Sie Retry-After Sekunden. |
| 500 | upstream_failed | Nein | Auf unserer Seite ist etwas schiefgegangen. Versuchen Sie es nach ein paar Sekunden erneut. |
Eine Anfrage wird in dieser Reihenfolge geprüft, und das erste gefundene Problem wird zurückgegeben: API-Schlüssel (401),
Rate-Limit (429), Request-Body (400 invalid_request), Bild (400 invalid_image), Guthaben (402), Inhaltsprüfung (403),
Warteschlange (503), Textabgleich (422). Ein Konto ohne Guthaben, das einen fehlerhaften Body sendet, erhält also 400, nicht 402.
Timeouts, Netzwerkfehler und 5xx
Läuft POST /edits in einen Timeout, bricht die Verbindung ab oder erhalten Sie ein 5xx, können Sie nicht wissen, ob ein Job
angelegt wurde. Wiederholen Sie mit demselben Idempotency-Key: Hat die erste Anfrage einen Job angelegt, erhalten Sie diesen
zurück und zahlen nicht doppelt. POST /ocr braucht keinen Schlüssel – dasselbe Bild innerhalb von 24 Stunden wird nicht erneut
berechnet. Antworten außer 2xx können von einem Proxy stammen und kein JSON sein, prüfen Sie also den Status, bevor Sie den Body parsen.
Die Fehler oben kommen direkt bei der Anfrage. Jobs, die später während der Verarbeitung fehlschlagen, melden
content_blocked, ai_generation_failed, timeout, upstream_failed oder invalid_image in error.code des Jobs und werden
nicht berechnet. Siehe Ergebnisse und Erstattungen.
Hilfe erhalten
Ein Fehler, den Sie nicht erklären können, ein Job, der nach 60 Minuten noch queued ist, oder ein falsches Ergebnis: Schreiben
Sie an [email protected] mit der Job-id, der Uhrzeit in UTC und dem
erhaltenen Fehler, oder erreichen Sie uns per WhatsApp oder TikTok über die Kontaktseite. Die
FAQ nennt, was Sie angeben sollten.
Webhooks
Erhalten Sie einen signierten ReWords.AI-Webhook, wenn eine Bearbeitung fertig ist, und prüfen Sie das HMAC in X-Rewords-Signature mit Node.js oder Python.
Häufige Fragen
Antworten auf häufige Fragen zur ReWords.AI API – was die OCR lesen kann, Schriften und längere Texte, Text entfernen, A oder B, Wiederholungen, Abrechnung, Nutzung im Frontend, SDKs und wie Sie Hilfe bekommen.