API gratuita de OCR de pasaportes

Haz tu primer reconocimiento sin cuenta

Copia la clave de la documentación y envía una imagen. Esa es toda la integración:

IMG=$(base64 -i passport.jpg | tr -d '\n')

curl -s https://api.doc.cheap/v1/scans \
  -H "Authorization: Bearer sk_sandbox_public" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: first-call-1" \
  -d '{"image":"'"$IMG"'","options":{"mode":"full"}}'

sk_sandbox_public es la clave pública del sandbox: se publica a propósito, no es un secreto y tiene un límite de solicitudes. Idempotency-Key significa que una solicitud reintentada no se cobra dos veces, algo que importa el día que reproduces una cola.

Qué recibes

Una sola forma de respuesta, ocho grupos, y todas las claves siempre presentes. El explorador de campos enumera cada clave con su tipo, y la referencia de la API (en inglés) es el contrato en sí.

{
  "meta": { "schema_version": "1.0", "status": "recognized", "billed": true,
            "confidence": "high",
            "timing": { "upload_ms": 118, "processing_ms": 684, "total_ms": 826 } },
  "document": { "kind": "passport", "country": "GRC", "country_name": "Greece",
                "number": "AM7304518", "series": null,
                "issue_date": "2022-03-10", "expiry_date": "2032-03-10",
                "is_expired": false, "days_remaining": 2001 },
  "holder": { "given_names": "ELENI SOFIA", "surname": "PARADEIGMA",
              "birth_date": "1994-03-08", "sex": "F", "nationality": "GRC" },
  "mrz": { "status": "passed", "reason": null, "lines": ["…", "…"] },
  "fields": [ "…" ], "images": { "…": null },
  "quality": { "overall": "pass" },
  "authenticity": { "overall": "not_checked", "checks": [] }
}

• meta.status es exactamente una de cinco cadenas: recognized, no_document_found, unreadable, unsupported_document, rejected.
• Las fechas van siempre en ISO-8601. Un valor ausente es null, nunca una clave que falta.
• meta.billed está en todas las respuestas e indica si esa llamada costó algo.
• fields[] contiene todos los campos del documento, leídos por separado de la zona codificada y de la zona impresa, cada uno con su propia confianza, para que puedas comparar las dos lecturas. Los valores en su propia escritura llegan junto a la transliteración latina, etiquetados con su idioma.

La titular del ejemplo es un espécimen sintético: una persona inventada, con aritmética real de dígitos de control sobre valores inventados. La zona que lleva se explica en la página de formatos MRZ.

Cuánto cuesta después de las llamadas gratuitas

Qué pasa con la imagen

En una clave de sandbox no se guarda nada. La imagen nunca se escribe en disco – vive en memoria mientras dura la solicitud – y el resultado tampoco se almacena. Con tu propia clave live, un resultado se conserva para que puedas volver a leerlo: durante las retain_hours que indique la solicitud o, si no las indica, durante el plazo de conservación de tu cuenta, que es de un año (8760 horas) mientras no lo cambies.

Envía retain_hours: 0 para no guardar nada – ningún resultado almacenado, nada que recuperar después. Lo decides tú, en cada llamada.

Cuando la foto no se puede leer

La respuesta lo dice, y es gratis. meta.status distingue los casos, y en los tres meta.billed es false:

• no_document_found – no hay nada con forma de documento en el encuadre.
• unreadable – se encontró, pero no se pudo leer: reflejos, desenfoque, resolución.
• unsupported_document – se leyó, pero ese tipo no está admitido.

Cada respuesta incluye su propio desglose de tiempos, y la mediana en vivo se publica en la página de estado en lugar de prometerse aquí.

Herramientas gratuitas que no necesitan ninguna clave

• Analizador de MRZ – pega una zona TD1, TD2 o TD3 y ve cada campo y cada dígito de control. Funciona en tu navegador.
• Generador de MRZ – crea una zona válida para hacer pruebas.
• Explorador de campos del documento – consulta el vocabulario de campos con el que responde la API.

¿La llamas desde un asistente en lugar de desde código? El servidor MCP ofrece el mismo reconocimiento como tres herramientas.