API de OCR para passaportes e documentos de identidade – uma chamada HTTP, 1¢ por documento
O doc.cheap é uma API de OCR para passaportes e documentos de identidade que transforma a foto de um documento de viagem em JSON estruturado com uma única requisição HTTP. Você envia uma imagem e recebe a zona de leitura mecânica (MRZ) interpretada, os dígitos verificadores da ICAO 9303 conferidos e os campos da zona de inspeção visual extraídos, tudo na mesma resposta, sem fila para consultar e sem SDK para instalar. A sua primeira chamada bem-sucedida leva menos de 60 segundos e não exige cadastro: o exemplo abaixo já traz uma chave pública de sandbox. Cada documento reconhecido custa 1¢, o mesmo preço do primeiro ao décimo milionésimo documento, e uma leitura que não encontra nada não custa nada.
- ✓ Uma única chamada síncrona
- ✓ Primeira chamada em 60 segundos
- ✓ Sem cadastro para começar
- ✓ JSON plano, nada para interpretar
Uma animação decorativa: a Terra, com os continentes desenhados com os caracteres de uma zona de leitura mecânica, gira e depois se desdobra em um mapa plano. Embaixo dela é digitada a zona de leitura mecânica do passaporte de exemplo usado em todo este site.
Teste agora – sem conta, sem cartão, sem período de teste
Envie a imagem de um documento e veja na tela os campos reconhecidos. A demonstração processa a sua própria imagem com a chave pública do sandbox – um reconhecimento real, grátis e sem conta – e a requisição ao lado é exatamente a mesma, pronta para colar em um terminal. Quando quiser levar isso para o seu próprio código, o guia do primeiro reconhecimento (em inglês) continua a partir daqui.
Teste agora – sem conta
Solte a imagem de um passaporte ou documento de identidade e o reconhecimento começa na hora. Ela é redimensionada no seu navegador e enviada ao sandbox público; a imagem nunca é armazenada.
A mesma chamada, no seu terminal
curl -X POST https://api.doc.cheap/v1/scans \
-H "Authorization: Bearer sk_sandbox_public" \
-H "Content-Type: application/json" \
-d "{\"image\": \"$(base64 < document.jpg | tr -d '\n')\"}"O resultado do reconhecimento aparece abaixo assim que você escolhe uma imagem: cada campo, em cada idioma em que foi lido, com a zona de leitura mecânica conferida dígito a dígito.
O que você recebe: cada campo, com verificação cruzada
Uma única resposta traz a leitura inteira. A zona de leitura mecânica é conferida dígito a dígito segundo a ICAO 9303 e volta como um único veredito, ao lado das linhas das quais foi lida; cada campo impresso na página volta com um nome estável, uma vez para cada idioma em que foi lido. Cada campo informa o seu próprio nível de confiança. Reconhecer um passaporte percorre a chamada inteira, e o explorador de campos lista cada chave com o seu tipo.
meta
O que é esta leitura e como ela foi: o id, o status, se consumiu um crédito e onde o tempo foi gasto.
schema_version · id · status · billed · confidence · timing · created_at · reference
document
Que tipo de documento foi reconhecido, que Estado o emitiu, o número e as datas dele, e se está vencido. Null quando nada foi reconhecido.
kind · country · country_name · issuing_state · type_name · type_confidence · number · series · issue_date · expiry_date · is_expired · days_remaining
holder
A pessoa que o documento identifica. Null quando nada foi reconhecido.
given_names · surname · full_name · birth_date · sex · nationality
fields[]
Cada campo lido na página impressa, com um nome estável. Uma entrada por leitura, cada uma com o seu idioma e o seu nível de confiança.
id · name · label · category · value · language · confidence
mrz
A zona de leitura mecânica: um veredito sobre se ela confere, o motivo quando não confere e as próprias linhas exatamente como foram lidas.
status · reason · lines · text
images
Recortes da imagem que você enviou, cada um como data URL.
document_crop · rear · main_photo · signature · watermark_face · barcode · chip
quality
Se a imagem que você enviou era boa o bastante para ser reconhecida.
overall
authenticity
Verificação de autenticidade. Ela não roda na chamada só de reconhecimento, que a informa como não verificada.
overall · checks
Uma zona de exemplo, e o que o leitor faz com ela
Titular inventado, números inventados, dígitos verificadores calculados a partir deles. Cole-a no leitor de MRZ para ver cada dígito recalculado no seu próprio navegador, ou veja em que TD1, TD2 e TD3 diferem.
P<GRCPARADEIGMA<<ELENI<SOFIA<<<<<<<<<<<<<<<<
AM73045184GRC9403084F3203101PN48291630<<<<72Preços: 1¢ por documento – e só quando funciona
1¢ por documento
O mesmo preço para todos, em qualquer volume: o primeiro documento e o décimo milionésimo custam o mesmo.
Você paga só pelos documentos que de fato reconhecemos.
Foto borrada, nenhum documento no enquadramento, tipo desconhecido: grátis. Você nunca paga por uma leitura que falhou.
- ✓ 10 documentos reconhecidos grátis por endereço com a chave pública do sandbox, sem nenhuma conta, com no máximo 10 requisições por hora, seja qual for a resposta.
- ✓ 20 documentos grátis ao se cadastrar, creditados no seu saldo.
Como o doc.cheap se compara
Preços de tabela, cada um lido na página de preços do próprio fornecedor e com link para ela. Um fornecedor cujos preços não podem ser lidos nas páginas públicas dele fica de fora em vez de ser estimado: um único número impossível de verificar tiraria o valor da tabela inteira. A comparação completa acrescenta quanto custa uma leitura que falha, quais deles podem ser chamados sem conta e o que cada um faz melhor do que nós.
| Fornecedor | Preço publicado | Grátis para começar |
|---|---|---|
| doc.cheap | $0.01 por documento, preço fixo em qualquer volume | Sandbox público, sem cadastro |
| AWS Textract – Analyze ID | $0.025 por página até 100,000 por mês; $0.01 por página acima disso (us-west-2) fonte | 100 páginas por mês nos três primeiros meses |
| Google Document AI | $0.10 por documento (leitor de passaportes dos EUA); $0.10 (carteira de motorista) fonte | – |
| Mindee | Créditos adicionais "starting from $0.05", mais uma cobrança de 20 % por excedente fonte | – |
| doc.cheap | $0 – uma leitura que não encontra nenhum documento não é cobrada, e a resposta informa isso no indicador billed. |
|---|---|
| Os três acima | Nenhuma exceção é publicada em nenhuma das páginas de preços deles. |
Fisicamente, não guardamos os seus documentos
A imagem enviada fica só na memória, durante a requisição, e nunca é gravada em disco. O que se guarda é o resultado – o desfecho e os campos extraídos, nunca uma imagem do documento – pelo tempo que você escolher: um ano, um mês, uma semana, um dia ou nada.
OCR de passaportes para agentes de IA: o servidor MCP
Um agente que precisa ler um passaporte não precisa que alguém escreva um cliente HTTP para ele. O doc.cheap inclui um servidor Model Context Protocol, então um assistente chama o reconhecimento como uma ferramenta: entrega uma imagem e recebe de volta os mesmos campos estruturados. A mesma chave, o mesmo preço e o mesmo formato de resposta da API – nada disso é um produto à parte.
O que os desenvolvedores perguntam
O que é OCR em um passaporte?
O reconhecimento óptico de caracteres lê os caracteres impressos na fotografia de um documento e os transforma em texto. Em um passaporte há duas coisas para ler: as duas linhas da zona de leitura mecânica no pé da página, impressas em uma fonte feita para ser lida por máquina, e a zona de inspeção visual acima dela, que é texto impresso comum com um layout diferente em cada emissor.
O que é uma MRZ?
Uma zona de leitura mecânica (MRZ) é o bloco de linhas de largura fixa no pé de um passaporte ou documento de identidade, padronizado pelo Doc 9303 da ICAO. Ela codifica o número do documento, o Estado emissor, o nome, a nacionalidade, a data de nascimento, o sexo e a data de validade, cada um em uma posição fixa, com dígitos verificadores que conferem a leitura.
O que é o Doc 9303 da ICAO?
O Doc 9303 da ICAO, Machine Readable Travel Documents, é a especificação que todo passaporte e todo documento de identidade de leitura mecânica seguem. Ele é publicado em partes: a Parte 3 traz as especificações comuns a todos os documentos de viagem de leitura mecânica, e as Partes 4, 5 e 6 tratam do passaporte TD3, do cartão TD1 e do cartão TD2, respectivamente. É isso que faz um passaporte emitido em qualquer lugar ser legível por um leitor fabricado em qualquer outro.
A API de OCR de passaportes comete erros?
Qualquer leitura de uma fotografia pode estar errada, por isso a resposta é feita para ser conferida, e não para ser aceita de olhos fechados. Cada zona de leitura mecânica é verificada com os seus próprios dígitos verificadores da ICAO 9303 e o veredito vem na resposta; cada campo traz um nível de confiança; e quando a zona de leitura mecânica e a zona de inspeção visual discordam, as duas leituras são devolvidas, em vez de uma ser preferida em silêncio.
Vocês guardam algum dado meu?
A imagem enviada fica na memória durante a requisição e nunca é gravada em disco. O que pode ser guardado é o resultado – o desfecho e os campos extraídos – por um prazo que você escolhe para a conta ou por requisição, de um ano até zero, e zero significa que nada é gravado.
Existe período de teste gratuito ou versão de demonstração?
Não há período de teste para assinar, porque não há nada para assinar antes. Uma chave pública de sandbox está impressa na documentação e no exemplo desta página, e ela faz reconhecimentos reais. O cadastro adiciona documentos grátis a um saldo; depois disso você recarrega o saldo e cada documento reconhecido desconta um crédito.
É possível detectar documentos falsos ou adulterados?
Não, e a resposta diz isso em vez de ficar calada: o campo de autenticidade traz not_checked. Este serviço faz reconhecimento, e reconhecer não é autenticar: nada aqui inspeciona os elementos de segurança de um documento. Dígitos verificadores que conferem provam que a zona é coerente consigo mesma, algo que qualquer falsificador também acerta; o que eles detectam são danos, reflexos e erros de leitura.
O que é um servidor MCP para processamento de documentos?
O Model Context Protocol é o padrão pelo qual um assistente de IA acessa uma ferramenta. Um servidor MCP para processamento de documentos expõe o reconhecimento como uma ferramenta que o assistente pode chamar, então um agente entrega a imagem de um passaporte e recebe campos estruturados sem que ninguém escreva código HTTP. O doc.cheap inclui um, e ele usa a mesma chave e o mesmo preço da API.