OpenOCR es una API unificada que te permite ejecutar OCR en más de 20 motores —Tesseract, EasyOCR, GPT-4o, Gemini y más— a través de una única interfaz consistente. Eliges el motor, envías una imagen y recibes el texto.

¿Cómo obtengo una clave de API de OpenOCR?

Regístrate para obtener una cuenta gratuita en open-ocr.com/signup. Las cuentas nuevas reciben $1.00 en créditos iniciales. Luego ve a tu panel, en la sección de claves de API, para generar una clave. Las claves comienzan con el prefijo sk-ocr- y se usan como tokens Bearer.

¿Existe un plan gratuito?

Sí. Las cuentas nuevas reciben $1.00 en créditos iniciales (hasta 2000 páginas con los motores más económicos). No se requiere tarjeta de crédito para empezar. Las cuentas iniciales tienen un límite de 50 solicitudes por día.

¿Qué motor de OCR debería usar para empezar?

Para documentos generales, escaneos y tablas, empieza con mistral-mistral-ocr-4-1 (Mistral OCR 4.1). Si el costo importa más que la precisión, prueba google-gemini-3.1-flash-lite. Compara todos los motores en la página de clasificación.

¿Qué formatos de imagen son compatibles?

OpenOCR acepta imágenes por URL o en base64. Los formatos compatibles incluyen JPEG, PNG, TIFF, BMP y PDF (con soporte para varias páginas). El motor que elijas puede tener restricciones de formato específicas.

OpenOCR

Iniciar sesión Obtener clave API

Cargando...

¿Qué cuenta como una página? Cómo entender los costos de OCR

Inicio rápido

Comienza con OpenOCR en 5 minutos.

1. Obtén tu clave de API

Regístrate para obtener una cuenta gratuita en open-ocr.com/signup. Las cuentas nuevas incluyen créditos para empezar. Luego, genera una clave de API desde tu panel.

La creación de la cuenta y de la clave de API requiere una persona (CAPTCHA). Agentes de IA: pide a tu usuario una clave sk-ocr-.

Cómo elegir un motor

Documentos generales, escaneos y tablas: mistral-mistral-ocr-4-1. Es nuestro motor predeterminado recomendado y lee PDF de varias páginas de forma nativa.
La opción más económica con calidad aceptable: google-gemini-3.1-flash-lite.
Mistral OCR 4.1 puede normalizar la ortografía (por ejemplo, corrige errores evidentes); para una transcripción estrictamente literal, los motores de visión LLM siguen nuestra instrucción de transcribir tal cual.
Compara todos los motores en la página de clasificación.

2. Realiza tu primera solicitud

Envía una solicitud POST al endpoint de OCR con tu clave de API y una URL de imagen. Cada solicitud requiere un encabezado Idempotency-Key para evitar el procesamiento duplicado:

bash

curl -X POST https://api.open-ocr.com/v1/ocr \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "engine": "mistral-mistral-ocr-4-1",
    "input": {
      "type": "url",
      "url": "https://tesseract-ocr.github.io/tessdoc/images/eurotext.png"
    }
  }'

3. Lee la respuesta

json

{
  "request_id": "req_abc123",
  "status": "succeeded",
  "engine": "mistral-mistral-ocr-4-1",
  "extracted_text": "INVOICE #12345\nDate: January 15, 2024\n...",
  "extracted_text_preview": "INVOICE #12345...",
  "cost_debited": 0.005,
  "remaining_balance": 0.995,
  "provider_latency_ms": 280
}

El costo por página depende del motor que elijas. Consulta la página de precios para ver las tarifas actuales. El campo remaining_balance muestra tu saldo de crédito actualizado.

4. Usa entrada en base64

También puedes enviar imágenes como datos codificados en base64, útil cuando tienes archivos en memoria:

bash

# Encode a local file and send it
BASE64=$(base64 -w0 receipt.png)

curl -X POST https://api.open-ocr.com/v1/ocr \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "engine": "mistral-mistral-ocr-4-1",
    "input": {
      "type": "base64",
      "data_base64": "'$BASE64'",
      "mime_type": "image/png"
    }
  }'

5. Llama desde cualquier lenguaje

OpenOCR es una API REST + JSON simple: no necesitas instalar ningún SDK. Usa el cliente HTTP que ya tengas.

python

import uuid
import requests

resp = requests.post(
    "https://api.open-ocr.com/v1/ocr",
    headers={
        "Authorization": "Bearer sk-ocr-your-api-key",
        "Content-Type": "application/json",
        "Idempotency-Key": str(uuid.uuid4()),  # new UUID per logical request
    },
    json={
        "engine": "mistral-mistral-ocr-4-1",
        "input": {"type": "url", "url": "https://example.com/receipt.png"},
    },
)
resp.raise_for_status()  # an error envelope has no "status" field
result = resp.json()
if result["status"] != "succeeded":
    raise RuntimeError(f"OCR ended as {result['status']}: {result.get('provider_error')}")
print(result["extracted_text"])

typescript

const resp = await fetch("https://api.open-ocr.com/v1/ocr", {
  method: "POST",
  headers: {
    Authorization: "Bearer sk-ocr-your-api-key",
    "Content-Type": "application/json",
    "Idempotency-Key": crypto.randomUUID(), // new UUID per logical request
  },
  body: JSON.stringify({
    engine: "mistral-mistral-ocr-4-1",
    input: { type: "url", url: "https://example.com/receipt.png" },
  }),
});
const result = await resp.json();
if (result.status !== "succeeded") throw new Error("OCR ended as " + (result.status ?? result.error?.code)); // error envelopes have no status
console.log(result.extracted_text);

6. Consulta el historial de uso (/api/usage)

Para un historial de uso al estilo del panel (con paginación y filtros de fecha), usa GET /api/usage. Usa autenticación mediante el encabezado Authorization. Pasar api_key como parámetro de consulta solo se admite como alternativa obsoleta.

bash

# Preferred — the API key alone identifies the caller
curl "https://open-ocr.com/api/usage?page=1&per_page=50"   -H "Authorization: Bearer sk-ocr-your-api-key"

# Deprecated fallback (migration only; avoid in new clients)
# curl "https://open-ocr.com/api/usage?api_key=sk-ocr-your-api-key"

Nota de migración: pasa los clientes existentes de autenticación por parámetro de consulta a autenticación por encabezado para evitar filtrar claves de API en URLs, registros, referrers de analítica e historial del navegador.

7. Explora los motores

OpenOCR ofrece varios motores de OCR, cada uno optimizado para distintos casos de uso. Consulta nuestro catálogo de motores o lee la herramienta de comparación para encontrar el más adecuado.

bash

# List available engines
curl https://api.open-ocr.com/v1/engines \
  -H "Authorization: Bearer YOUR_API_KEY"

# Quick guide:
# mistral-mistral-ocr-4-1       — Recommended default: general documents, scans, tables
# google-gemini-3.1-flash-lite  — Cheapest acceptable quality
# local-tesseract               — OpenOCR-hosted, clean printed text
# local-easyocr                 — OpenOCR-hosted, multi-language
# local-doctr                   — OpenOCR-hosted, complex layouts
# openocr-ocrmypdf              — OpenOCR-hosted, scanned PDFs with auto-deskew
# openocr-rapidocr              — OpenOCR-hosted, lightweight

8. Límites de frecuencia

Las respuestas de la API incluyen encabezados de límite de frecuencia:

text

X-RateLimit-Limit: 60        # requests per minute
X-RateLimit-Remaining: 59   # requests left in window
X-RateLimit-Reset: 60       # seconds until window resets

El límite predeterminado es de 60 solicitudes por minuto por clave de API. Si superas el límite, recibirás una respuesta 429.

Autenticación

Cargando...

¿Qué cuenta como una página? Cómo entender los costos de OCR

Inicio rápido

Comienza con OpenOCR en 5 minutos.

1. Obtén tu clave de API

Regístrate para obtener una cuenta gratuita en open-ocr.com/signup. Las cuentas nuevas incluyen créditos para empezar. Luego, genera una clave de API desde tu panel.

La creación de la cuenta y de la clave de API requiere una persona (CAPTCHA). Agentes de IA: pide a tu usuario una clave sk-ocr-.

Cómo elegir un motor

Documentos generales, escaneos y tablas: mistral-mistral-ocr-4-1. Es nuestro motor predeterminado recomendado y lee PDF de varias páginas de forma nativa.
La opción más económica con calidad aceptable: google-gemini-3.1-flash-lite.
Mistral OCR 4.1 puede normalizar la ortografía (por ejemplo, corrige errores evidentes); para una transcripción estrictamente literal, los motores de visión LLM siguen nuestra instrucción de transcribir tal cual.
Compara todos los motores en la página de clasificación.

2. Realiza tu primera solicitud

Envía una solicitud POST al endpoint de OCR con tu clave de API y una URL de imagen. Cada solicitud requiere un encabezado Idempotency-Key para evitar el procesamiento duplicado:

bash

curl -X POST https://api.open-ocr.com/v1/ocr \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "engine": "mistral-mistral-ocr-4-1",
    "input": {
      "type": "url",
      "url": "https://tesseract-ocr.github.io/tessdoc/images/eurotext.png"
    }
  }'

3. Lee la respuesta

json

{
  "request_id": "req_abc123",
  "status": "succeeded",
  "engine": "mistral-mistral-ocr-4-1",
  "extracted_text": "INVOICE #12345\nDate: January 15, 2024\n...",
  "extracted_text_preview": "INVOICE #12345...",
  "cost_debited": 0.005,
  "remaining_balance": 0.995,
  "provider_latency_ms": 280
}

El costo por página depende del motor que elijas. Consulta la página de precios para ver las tarifas actuales. El campo remaining_balance muestra tu saldo de crédito actualizado.

4. Usa entrada en base64

También puedes enviar imágenes como datos codificados en base64, útil cuando tienes archivos en memoria:

bash

# Encode a local file and send it
BASE64=$(base64 -w0 receipt.png)

curl -X POST https://api.open-ocr.com/v1/ocr \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "engine": "mistral-mistral-ocr-4-1",
    "input": {
      "type": "base64",
      "data_base64": "'$BASE64'",
      "mime_type": "image/png"
    }
  }'

5. Llama desde cualquier lenguaje

OpenOCR es una API REST + JSON simple: no necesitas instalar ningún SDK. Usa el cliente HTTP que ya tengas.

python

import uuid
import requests

resp = requests.post(
    "https://api.open-ocr.com/v1/ocr",
    headers={
        "Authorization": "Bearer sk-ocr-your-api-key",
        "Content-Type": "application/json",
        "Idempotency-Key": str(uuid.uuid4()),  # new UUID per logical request
    },
    json={
        "engine": "mistral-mistral-ocr-4-1",
        "input": {"type": "url", "url": "https://example.com/receipt.png"},
    },
)
resp.raise_for_status()  # an error envelope has no "status" field
result = resp.json()
if result["status"] != "succeeded":
    raise RuntimeError(f"OCR ended as {result['status']}: {result.get('provider_error')}")
print(result["extracted_text"])

typescript

const resp = await fetch("https://api.open-ocr.com/v1/ocr", {
  method: "POST",
  headers: {
    Authorization: "Bearer sk-ocr-your-api-key",
    "Content-Type": "application/json",
    "Idempotency-Key": crypto.randomUUID(), // new UUID per logical request
  },
  body: JSON.stringify({
    engine: "mistral-mistral-ocr-4-1",
    input: { type: "url", url: "https://example.com/receipt.png" },
  }),
});
const result = await resp.json();
if (result.status !== "succeeded") throw new Error("OCR ended as " + (result.status ?? result.error?.code)); // error envelopes have no status
console.log(result.extracted_text);

6. Consulta el historial de uso (/api/usage)

bash

# Preferred — the API key alone identifies the caller
curl "https://open-ocr.com/api/usage?page=1&per_page=50"   -H "Authorization: Bearer sk-ocr-your-api-key"

# Deprecated fallback (migration only; avoid in new clients)
# curl "https://open-ocr.com/api/usage?api_key=sk-ocr-your-api-key"

7. Explora los motores

OpenOCR ofrece varios motores de OCR, cada uno optimizado para distintos casos de uso. Consulta nuestro catálogo de motores o lee la herramienta de comparación para encontrar el más adecuado.

bash

# List available engines
curl https://api.open-ocr.com/v1/engines \
  -H "Authorization: Bearer YOUR_API_KEY"

# Quick guide:
# mistral-mistral-ocr-4-1       — Recommended default: general documents, scans, tables
# google-gemini-3.1-flash-lite  — Cheapest acceptable quality
# local-tesseract               — OpenOCR-hosted, clean printed text
# local-easyocr                 — OpenOCR-hosted, multi-language
# local-doctr                   — OpenOCR-hosted, complex layouts
# openocr-ocrmypdf              — OpenOCR-hosted, scanned PDFs with auto-deskew
# openocr-rapidocr              — OpenOCR-hosted, lightweight

8. Límites de frecuencia

Las respuestas de la API incluyen encabezados de límite de frecuencia:

text

X-RateLimit-Limit: 60        # requests per minute
X-RateLimit-Remaining: 59   # requests left in window
X-RateLimit-Reset: 60       # seconds until window resets

El límite predeterminado es de 60 solicitudes por minuto por clave de API. Si superas el límite, recibirás una respuesta 429.

Autenticación