ReWords.AI API

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_key

1. 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.

En esta página