API de OCR de passaportes grátis

Faça o seu primeiro reconhecimento sem conta

Copie a chave da documentação e envie uma imagem. Essa é a integração inteira:

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 é a chave pública do sandbox – ela é publicada de propósito, não é um segredo e tem limite de requisições. Idempotency-Key significa que uma requisição repetida não gera uma segunda cobrança, o que faz diferença no dia em que você reprocessa uma fila.

O que você recebe

Um único formato de resposta, oito grupos, todas as chaves sempre presentes. O explorador de campos lista cada chave com o seu tipo, e a referência da API (em inglês) é o próprio contrato.

{
  "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 é exatamente uma de cinco strings: recognized, no_document_found, unreadable, unsupported_document, rejected.
• As datas estão sempre em ISO-8601. Um valor ausente é null, nunca uma chave faltando.
• meta.billed está em toda resposta e diz se aquela chamada custou alguma coisa.
• fields[] traz todos os campos do documento, lidos separadamente da zona codificada e da zona impressa, cada um com a sua própria confiança, para que as duas leituras possam ser comparadas. Valores na sua própria escrita chegam ao lado da transliteração latina, marcados com o seu idioma.

A titular do exemplo é um espécime sintético: uma pessoa inventada, com a aritmética real dos dígitos verificadores aplicada a valores inventados. A zona que ela traz é explicada na página de formatos de MRZ.

Quanto custa depois das chamadas grátis

O que acontece com a imagem

Numa chave de sandbox nada é guardado. A imagem nunca é gravada em disco – ela fica na memória durante a requisição – e o resultado também não é armazenado. Com a sua própria chave live, um resultado é mantido para que você possa lê-lo de novo: pelas retain_hours que a requisição indicar ou, sem elas, pelo prazo de retenção da sua conta, que é de um ano (8760 horas) até você mudar.

Envie retain_hours: 0 para não guardar nada – nenhum resultado armazenado, nada para buscar depois. A escolha é sua, a cada chamada.

Quando a foto não pode ser lida

A resposta diz isso, e é grátis. meta.status distingue os casos, e nos três meta.billed é false:

• no_document_found – nada com cara de documento no enquadramento.
• unreadable – encontrado, mas não foi possível ler – reflexo, desfoque, resolução.
• unsupported_document – lido, mas esse tipo não é suportado.

Cada resposta traz a sua própria divisão de tempos, e a mediana ao vivo é publicada na página de status em vez de ser prometida aqui.

Ferramentas grátis que não precisam de chave nenhuma

• Leitor de MRZ – cole uma zona TD1, TD2 ou TD3 e veja cada campo e cada dígito verificador. Roda no seu navegador.
• Gerador de MRZ – monte uma zona válida para testes.
• Explorador de campos do documento – navegue pelo vocabulário de campos com que a API responde.

Vai chamar a partir de um assistente, e não de código? O servidor MCP expõe o mesmo reconhecimento como três ferramentas.