Início rápido
Substitua o texto da sua primeira imagem com a API da ReWords.AI — OCR, envio da edição e busca dos resultados com três requisições curl.
Você precisa de uma chave de API: compre um pacote de API e crie uma chave na sua página de chaves de API (veja Autenticação). Defina-a no seu terminal:
export REWORDS_API_KEY=rw_live_your_key1. Encontre o texto
curl https://api.rewords.ai/v1/ocr \
-H "Authorization: Bearer $REWORDS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"image_url": "https://example.com/banner.png", "language": "en"}'{
"image_id": "img_abc123",
"width": 1080,
"height": 1350,
"texts": [
{ "id": "t1", "text": "SALE", "box": [120, 80, 300, 60] },
{ "id": "t2", "text": "50% OFF", "box": [140, 160, 260, 50] }
],
"charged_ocr": 1
}As caixas são [x, y, largura, altura] numa escala de 0 a 1000 da imagem, então não dependem do tamanho em pixels.
O image_id pode ser reutilizado por 24 horas, então você não precisa enviar a imagem de novo.
Defina language como o idioma do texto da imagem — ko para coreano, ja para japonês e assim por diante. Ele não é
detectado automaticamente e, sem ele, o OCR só lê bem chinês e inglês (veja as perguntas frequentes).
2. Envie a edição
Envie um box do resultado do OCR, ou só from e to, e nós localizamos o texto para você.
curl https://api.rewords.ai/v1/edits \
-H "Authorization: Bearer $REWORDS_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"image_id": "img_abc123",
"replacements": [
{ "from": "SALE", "to": "HOT DEAL", "box": [120, 80, 300, 60] },
{ "from": "50% OFF", "to": "70% OFF" }
]
}'{
"id": "edit_9f8e7d",
"status": "queued",
"queue_position": 0,
"estimated_seconds": 120,
"replacements": [
{ "from": "SALE", "to": "HOT DEAL", "box": [120, 80, 300, 60] },
{ "from": "50% OFF", "to": "70% OFF", "box": [140, 160, 260, 50] }
],
"balance": 4,
"created_at": "2026-11-04T13:55:33.240Z"
}replacements mostra a caixa que encontramos para 50% OFF, e uma edição já está reservada em balance.
Use um Idempotency-Key novo para cada job novo e o mesmo apenas para reenviar aquele job — uma chave reutilizada retorna o
job anterior, não uma nova edição.
3. Obtenha os resultados
Consulte até que status seja succeeded ou failed: a cada 5 segundos enquanto estiver em processing ou em queued com
queue_position 0, e a cada 30 segundos enquanto estiver mais atrás na fila — veja
Fila e limites. Ou passe callback_url e receba um webhook.
curl https://api.rewords.ai/v1/edits/edit_9f8e7d \
-H "Authorization: Bearer $REWORDS_API_KEY"{
"id": "edit_9f8e7d",
"status": "succeeded",
"results": {
"A": { "status": "succeeded", "url": "https://img.rewords.ai/api/edit_9f8e7d_a.jpg" },
"B": { "status": "succeeded", "url": "https://img.rewords.ai/api/edit_9f8e7d_b.jpg" },
"C": { "status": "succeeded", "url": "https://img.rewords.ai/api/edit_9f8e7d_c.jpg" }
},
"replacements": [
{ "from": "SALE", "to": "HOT DEAL", "box": [120, 80, 300, 60] },
{ "from": "50% OFF", "to": "70% OFF", "box": [140, 160, 260, 50] }
],
"charged": 1,
"balance": 4,
"created_at": "2026-11-04T13:55:33.240Z",
"completed_at": "2026-11-04T13:56:21.808Z"
}Veja Exemplos para clientes completos em Node.js e Python e todas as outras respostas.
Baixe as imagens de que você precisa — os resultados são arquivos JPEG em links públicos mantidos por pelo menos 7 dias. Veja Resultados e reembolsos para saber o que são A, B e C, e Imagens para enviar um arquivo local em vez de uma URL.
API para editar texto em imagens
Substitua o texto dentro de imagens com IA mantendo a fonte, a cor e o fundo originais. OCR, edições, resultados e webhooks com uma API REST simples.
Exemplos
Clientes completos em Node.js e Python para a API da ReWords.AI, e todas as respostas que você vai encontrar — OCR, uma edição na fila, em processamento, concluída, com falha parcial e com falha, e cada erro.