Erreurs
Format d’erreur de l’API ReWords.AI, codes de statut HTTP et codes d’erreur, et quelles erreurs sont facturées.
Toutes les erreurs ont la même forme :
{ "error": { "code": "queue_full", "message": "30 jobs are already waiting. Retry in 30 seconds.", "details": {} } }| HTTP | Code | Facturé | Que faire |
|---|---|---|---|
| 400 | invalid_request | Non | Corrigez le corps de la requête. Envoyez exactement une entrée d’image, en application/json ou multipart/form-data. |
| 400 | invalid_image | Non | Envoyez un JPEG, PNG ou WebP jusqu’à 20 Mo et 8000 px (corps JSON jusqu’à 28 Mo), ou vérifiez que image_url peut être téléchargée. Voir Images. |
| 401 | invalid_api_key | Non | Vérifiez l’en-tête Authorization. |
| 402 | insufficient_balance | Non | Achetez un pack de modifications. |
| 402 | insufficient_ocr_balance | Non | Achetez un pack OCR, ou envoyez le texte sans box à POST /edits (l’OCR y est gratuit). |
| 403 | image_blocked | Non | L’image n’a pas passé la vérification du contenu. |
| 404 | not_found | Non | L’id de modification n’existe pas pour votre compte, ou le chemin est erroné. |
| 422 | text_not_found | Non | Réessayez avec les boîtes de error.details.texts. |
| 429 | rate_limited | Non | Attendez Retry-After secondes. Limites : 30 envois et 240 lectures par minute. |
| 503 | queue_full | Non | Attendez Retry-After secondes. |
| 500 | upstream_failed | Non | Un problème est survenu de notre côté. Réessayez après quelques secondes. |
Une requête est vérifiée dans cet ordre, et le premier problème trouvé est renvoyé : clé d’API (401), limite de débit (429),
corps de la requête (400 invalid_request), image (400 invalid_image), solde (402), vérification du contenu (403),
file d’attente (503), correspondance du texte (422). Un compte sans solde qui envoie un corps invalide reçoit donc 400, pas 402.
Délais dépassés, erreurs réseau et 5xx
Si POST /edits dépasse le délai, si la connexion est coupée ou si vous recevez un 5xx, vous ne pouvez pas savoir si une tâche
a été créée. Réessayez avec la même Idempotency-Key : si la première requête a bien créé une tâche, vous la récupérez et n’êtes
pas facturé deux fois. POST /ocr n’a pas besoin de clé — la même image dans les 24 heures n’est pas facturée à nouveau. Les
réponses autres que 2xx peuvent venir d’un proxy et ne pas être du JSON : vérifiez le statut avant d’analyser le corps.
Les erreurs ci-dessus sont renvoyées lors de la requête. Les tâches qui échouent plus tard, pendant le traitement, indiquent
content_blocked, ai_generation_failed, timeout, upstream_failed ou invalid_image dans le error.code de la tâche, et
ne sont pas facturées. Voir Résultats et remboursements.
Obtenir de l’aide
Une erreur que vous ne savez pas expliquer, une tâche encore queued après 60 minutes ou un résultat incorrect : écrivez à
[email protected] avec l’id de la tâche, l’heure en UTC et l’erreur reçue,
ou contactez-nous sur WhatsApp ou TikTok depuis la page de contact. La
FAQ indique quoi inclure.
Webhooks
Recevez un webhook ReWords.AI signé quand une modification se termine, et vérifiez le HMAC de X-Rewords-Signature en Node.js ou en Python.
Questions fréquentes
Réponses aux questions courantes sur l’API ReWords.AI — ce que l’OCR sait lire, polices et textes plus longs, supprimer du texte, A ou B, nouvelles tentatives, facturation, usage côté front-end, SDK et comment obtenir de l’aide.