Inicio rápido
Sustituye el texto de tu primera imagen con la API de ReWords.AI: OCR, envío de la edición y descarga de resultados con tres solicitudes curl.
Necesitas una clave de API: compra un paquete de API y crea una clave en tu página de claves de API (consulta Autenticación). Defínela en tu terminal:
export REWORDS_API_KEY=rw_live_your_key1. Encuentra el 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
}Los cuadros son [x, y, ancho, alto] en una escala de 0 a 1000 de la imagen, así que no dependen de su tamaño en píxeles.
El image_id se puede reutilizar durante 24 horas, así que no tienes que volver a subir la imagen.
Pon en language el idioma del texto de la imagen: ko para coreano, ja para japonés, etc. No se detecta
automáticamente y, sin él, el OCR solo lee bien chino e inglés (consulta las preguntas frecuentes).
2. Envía la edición
Envía un box del resultado del OCR, o solo from y to, y localizamos el texto por ti.
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 muestra el cuadro que encontramos para 50% OFF, y ya hay una edición reservada en balance.
Usa un Idempotency-Key nuevo para cada trabajo nuevo y el mismo solo para reenviar ese trabajo: una clave reutilizada devuelve el
trabajo anterior, no una edición nueva.
3. Obtén los resultados
Consulta hasta que status sea succeeded o failed: cada 5 segundos mientras esté en processing o en queued con
queue_position 0, y cada 30 segundos mientras esté más atrás en la cola; consulta
Cola y límites. O pasa callback_url y recibe un 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"
}Consulta Ejemplos para ver clientes completos en Node.js y Python y todas las demás respuestas.
Descarga las imágenes que necesites: los resultados son archivos JPEG en enlaces públicos que se conservan al menos 7 días. Consulta Resultados y reembolsos para saber qué son A, B y C, e Imágenes para subir un archivo local en lugar de una URL.
API para editar texto en imágenes
Sustituye el texto dentro de imágenes con IA conservando la fuente, el color y el fondo originales. OCR, ediciones, resultados y webhooks con una API REST sencilla.
Ejemplos
Clientes completos en Node.js y Python para la API de ReWords.AI, y cada respuesta que encontrarás: OCR, una edición en cola, en proceso, completada, parcialmente fallida y fallida, y cada error.