Erros
Formato de erro da API da ReWords.AI, códigos de status HTTP e códigos de erro, e quais erros são cobrados.
Todos os erros têm o mesmo formato:
{ "error": { "code": "queue_full", "message": "30 jobs are already waiting. Retry in 30 seconds.", "details": {} } }| HTTP | Código | Cobrado | O que fazer |
|---|---|---|---|
| 400 | invalid_request | Não | Corrija o corpo da requisição. Envie exatamente uma entrada de imagem, como application/json ou multipart/form-data. |
| 400 | invalid_image | Não | Envie um JPEG, PNG ou WebP de até 20 MB e 8000 px (corpo JSON de até 28 MB), ou verifique se image_url pode ser baixada. Veja Imagens. |
| 401 | invalid_api_key | Não | Verifique o cabeçalho Authorization. |
| 402 | insufficient_balance | Não | Compre um pacote de edições. |
| 402 | insufficient_ocr_balance | Não | Compre um pacote de OCR, ou envie o texto sem box para POST /edits (o OCR lá é grátis). |
| 403 | image_blocked | Não | A imagem não passou na revisão de conteúdo. |
| 404 | not_found | Não | O id da edição não existe na sua conta, ou o caminho está errado. |
| 422 | text_not_found | Não | Tente de novo com as caixas de error.details.texts. |
| 429 | rate_limited | Não | Espere Retry-After segundos. Limites: 30 envios e 240 leituras por minuto. |
| 503 | queue_full | Não | Espere Retry-After segundos. |
| 500 | upstream_failed | Não | Algo falhou do nosso lado. Tente de novo após alguns segundos. |
Uma requisição é verificada nesta ordem, e o primeiro problema encontrado é retornado: chave de API (401), limite de requisições
(429), corpo da requisição (400 invalid_request), imagem (400 invalid_image), saldo (402), revisão de conteúdo (403),
fila (503), correspondência de texto (422). Assim, uma conta sem saldo que envia um corpo com defeito recebe 400, não 402.
Timeouts, erros de rede e 5xx
Se POST /edits der timeout, a conexão cair ou você receber um 5xx, não dá para saber se um job foi criado.
Tente de novo com a mesma Idempotency-Key: se a primeira requisição criou um job, você recebe esse job e não é cobrado duas
vezes. POST /ocr não precisa de chave — a mesma imagem em até 24 horas não é cobrada de novo. Respostas que não são 2xx podem
vir de um proxy e não ser JSON, então verifique o status antes de interpretar o corpo.
Os erros acima são retornados quando você faz a requisição. Jobs que falham depois, durante o processamento, informam
content_blocked, ai_generation_failed, timeout, upstream_failed ou invalid_image no error.code do job, e não são
cobrados. Veja Resultados e reembolsos.
Como obter ajuda
Um erro que você não consegue explicar, um job que continua queued depois de 60 minutos ou um resultado errado: escreva para
[email protected] com o id do job, o horário em UTC e o erro recebido,
ou fale conosco pelo WhatsApp ou TikTok na página de contato. As
perguntas frequentes listam o que incluir.
Webhooks
Receba um webhook assinado da ReWords.AI quando uma edição termina e verifique o HMAC de X-Rewords-Signature em Node.js ou Python.
Perguntas frequentes
Respostas a perguntas comuns sobre a API da ReWords.AI — o que o OCR consegue ler, fontes e textos mais longos, remover texto, A ou B, novas tentativas, cobrança, uso no front-end, SDKs e como obter ajuda.