Errores
Formato de error de la API de ReWords.AI, códigos de estado HTTP y códigos de error, y qué errores se cobran.
Todos los errores tienen la misma forma:
{ "error": { "code": "queue_full", "message": "30 jobs are already waiting. Retry in 30 seconds.", "details": {} } }| HTTP | Código | Se cobra | Qué hacer |
|---|---|---|---|
| 400 | invalid_request | No | Corrige el cuerpo de la solicitud. Envía exactamente una entrada de imagen, como application/json o multipart/form-data. |
| 400 | invalid_image | No | Envía un JPEG, PNG o WebP de hasta 20 MB y 8000 px (cuerpo JSON de hasta 28 MB), o comprueba que image_url se pueda descargar. Consulta Imágenes. |
| 401 | invalid_api_key | No | Revisa la cabecera Authorization. |
| 402 | insufficient_balance | No | Compra un paquete de ediciones. |
| 402 | insufficient_ocr_balance | No | Compra un paquete de OCR, o envía el texto sin box a POST /edits (allí el OCR es gratis). |
| 403 | image_blocked | No | La imagen no superó la revisión de contenido. |
| 404 | not_found | No | El id de edición no existe en tu cuenta, o la ruta es incorrecta. |
| 422 | text_not_found | No | Reintenta con las cajas de error.details.texts. |
| 429 | rate_limited | No | Espera Retry-After segundos. Límites: 30 envíos y 240 lecturas por minuto. |
| 503 | queue_full | No | Espera Retry-After segundos. |
| 500 | upstream_failed | No | Algo falló de nuestro lado. Reintenta tras unos segundos. |
Una solicitud se comprueba en este orden y se devuelve el primer problema encontrado: clave de API (401), límite de frecuencia
(429), cuerpo de la solicitud (400 invalid_request), imagen (400 invalid_image), saldo (402), revisión de contenido (403),
cola (503), coincidencia de texto (422). Así, una cuenta sin saldo que envía un cuerpo defectuoso recibe 400, no 402.
Tiempos de espera, errores de red y 5xx
Si POST /edits agota el tiempo de espera, se corta la conexión o recibes un 5xx, no puedes saber si se creó un trabajo.
Reintenta con la misma Idempotency-Key: si la primera solicitud sí creó un trabajo, recibes ese trabajo y no se te cobra dos
veces. POST /ocr no necesita clave: la misma imagen en 24 horas no se vuelve a cobrar. Las respuestas que no son 2xx pueden
venir de un proxy y no ser JSON, así que comprueba el estado antes de analizar el cuerpo.
Los errores de arriba se devuelven al hacer la solicitud. Los trabajos que fallan después, durante el procesamiento, indican
content_blocked, ai_generation_failed, timeout, upstream_failed o invalid_image en el error.code del trabajo, y no se
cobran. Consulta Resultados y reembolsos.
Obtener ayuda
Un error que no sabes explicar, un trabajo que sigue queued después de 60 minutos o un resultado incorrecto: escribe a
[email protected] con el id del trabajo, la hora en UTC y el error que
recibiste, o contáctanos por WhatsApp o TikTok desde la página de contacto. Las
preguntas frecuentes indican qué incluir.
Webhooks
Recibe un webhook firmado de ReWords.AI cuando termina una edición y verifica el HMAC de X-Rewords-Signature en Node.js o Python.
Preguntas frecuentes
Respuestas a preguntas comunes sobre la API de ReWords.AI: qué puede leer el OCR, fuentes y textos más largos, eliminar texto, A frente a B, reintentos, facturación, uso desde el front-end, SDK y cómo obtener ayuda.