API OCR per passaporti e documenti d'identità – una chiamata HTTP, 1¢ a documento
doc.cheap è un'API OCR per passaporti e documenti d'identità che trasforma la foto di un documento di viaggio in JSON strutturato con una sola richiesta HTTP. Invii un'immagine e ricevi la zona a lettura ottica (MRZ) analizzata, le cifre di controllo ICAO 9303 verificate e i campi della zona di ispezione visiva estratti, nella stessa risposta, senza code da interrogare né SDK da installare. La tua prima chiamata riuscita richiede meno di 60 secondi e nessuna registrazione: nell'esempio qui sotto c'è già una chiave pubblica della sandbox. Ogni documento riconosciuto costa 1¢, lo stesso prezzo dal primo documento al decimilionesimo, e una scansione che non trova nulla non costa nulla.
- ✓ Una sola chiamata sincrona
- ✓ Prima chiamata in 60 secondi
- ✓ Nessuna registrazione per iniziare
- ✓ JSON piatto, niente da analizzare
Un'animazione decorativa: la Terra, con i continenti disegnati con i caratteri di una zona a lettura ottica, ruota e poi si apre in una mappa piana. Sotto viene digitata la zona a lettura ottica del passaporto campione usato in tutto il sito.
Provalo subito – senza account, senza carta, senza periodo di prova
Carica l'immagine di un documento e vedrai a schermo i campi riconosciuti. La demo elabora la tua immagine con la chiave pubblica della sandbox – un riconoscimento reale, gratuito e senza account – e la richiesta accanto è esattamente la stessa, pronta da incollare in un terminale. Quando la vorrai nel tuo codice, la guida al primo riconoscimento (in inglese) ti accompagna da qui.
Provalo subito – senza account
Trascina l'immagine di un passaporto o di un documento d'identità e il riconoscimento parte subito. L'immagine viene ridimensionata nel tuo browser e inviata alla sandbox pubblica; non viene mai conservata.
La stessa chiamata, nel tuo terminale
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')\"}"Il risultato del riconoscimento compare qui sotto non appena scegli un'immagine: ogni campo, in ogni lingua in cui è stato letto, con la zona a lettura ottica verificata cifra per cifra.
Cosa ricevi: ogni campo, con controllo incrociato
Una sola risposta contiene l'intera lettura. La zona a lettura ottica viene verificata cifra per cifra secondo ICAO 9303 e torna come un unico verdetto, insieme alle righe da cui è stata letta; ogni campo stampato sulla pagina torna con un nome stabile, una volta per ogni lingua in cui è stato letto. Ogni campo indica il proprio livello di confidenza. Riconoscere un passaporto percorre l'intera chiamata, e l'esploratore dei campi elenca ogni chiave con il suo tipo.
meta
Che cos'è questa scansione e com'è andata: il suo id, il suo stato, se ha consumato un credito e dove è andato il tempo.
schema_version · id · status · billed · confidence · timing · created_at · reference
document
Che tipo di documento è stato riconosciuto, quale Stato lo ha emesso, il numero e le date, e se è scaduto. Null quando non è stato riconosciuto nulla.
kind · country · country_name · issuing_state · type_name · type_confidence · number · series · issue_date · expiry_date · is_expired · days_remaining
holder
La persona che il documento identifica. Null quando non è stato riconosciuto nulla.
given_names · surname · full_name · birth_date · sex · nationality
fields[]
Ogni campo letto sulla pagina stampata, con un nome stabile. Una voce per ogni lettura, ciascuna con la propria lingua e il proprio livello di confidenza.
id · name · label · category · value · language · confidence
mrz
La zona a lettura ottica: un verdetto sulla sua correttezza, il motivo quando non è corretta e le righe esattamente come sono state lette.
status · reason · lines · text
images
Ritagli dell'immagine che hai inviato, ciascuno come data URL.
document_crop · rear · main_photo · signature · watermark_face · barcode · chip
quality
Se l'immagine che hai inviato era abbastanza buona per il riconoscimento.
overall
authenticity
Verifica di autenticità. Non viene eseguita nella chiamata di solo riconoscimento, che la segnala come non verificata.
overall · checks
Una zona campione, e cosa ne fa il parser
Titolare inventato, numeri inventati, cifre di controllo calcolate a partire da questi. Incollala nel parser MRZ per vedere ogni cifra ricalcolata nel tuo browser, oppure leggi in cosa differiscono TD1, TD2 e TD3.
P<GRCPARADEIGMA<<ELENI<SOFIA<<<<<<<<<<<<<<<<
AM73045184GRC9403084F3203101PN48291630<<<<72Prezzi: 1¢ a documento – e solo quando funziona
1¢ a documento
Lo stesso prezzo per tutti, a qualsiasi volume: il primo documento e il decimilionesimo costano uguale.
Paghi solo i documenti che riconosciamo davvero.
Foto sfocata, nessun documento nell'inquadratura, tipo sconosciuto: gratis. Una scansione non riuscita non la paghi mai.
- ✓ 10 documenti riconosciuti gratis per indirizzo con la chiave pubblica della sandbox, senza alcun account: al massimo 10 richieste all'ora, qualunque sia la risposta.
- ✓ 20 documenti gratuiti quando ti registri, accreditati sul tuo saldo.
doc.cheap a confronto
Prezzi di listino, ciascuno letto sulla pagina dei prezzi del fornitore stesso e collegato a essa. Un fornitore i cui prezzi non si possono leggere sulle sue pagine pubbliche viene escluso anziché stimato: un solo numero non verificabile renderebbe inutile l'intera tabella. Il confronto completo aggiunge quanto costa una scansione non riuscita, quali si possono chiamare senza account e cosa ciascuno di loro fa meglio di noi.
| Fornitore | Prezzo pubblicato | Gratis per iniziare |
|---|---|---|
| doc.cheap | $0.01 a documento, tariffa fissa a qualsiasi volume | Sandbox pubblica, senza registrazione |
| AWS Textract – Analyze ID | $0.025 a pagina fino a 100,000 al mese; $0.01 a pagina oltre (us-west-2) fonte | 100 pagine al mese per i primi tre mesi |
| Google Document AI | $0.10 a documento (parser per passaporti USA); $0.10 (patente di guida) fonte | – |
| Mindee | Crediti aggiuntivi "starting from $0.05", più un sovrapprezzo del 20 % per l'eccedenza fonte | – |
| doc.cheap | $0 – una scansione che non trova alcun documento non viene addebitata, e la risposta lo indica nel flag billed. |
|---|---|
| I tre qui sopra | Nessuna delle loro pagine dei prezzi pubblica un'eccezione. |
Fisicamente non conserviamo i tuoi documenti
L'immagine caricata vive solo in memoria, per la durata della richiesta, e non viene mai scritta su disco. Ciò che viene conservato è il risultato – l'esito e i campi estratti, mai un'immagine del documento – per il tempo che scegli tu: un anno, un mese, una settimana, un giorno o per niente.
OCR per passaporti per agenti di IA: il server MCP
Un agente che deve leggere un passaporto non ha bisogno che qualcuno gli scriva un client HTTP. doc.cheap include un server Model Context Protocol, così un assistente richiama il riconoscimento come uno strumento: gli passa un'immagine e riceve gli stessi campi strutturati. Stessa chiave, stesso prezzo, stessa struttura di risposta dell'API – niente è un prodotto a parte.
Le domande degli sviluppatori
Che cos'è l'OCR di un passaporto?
Il riconoscimento ottico dei caratteri legge i caratteri stampati dalla fotografia di un documento e li trasforma in testo. In un passaporto ci sono due cose da leggere: le due righe della zona a lettura ottica in fondo alla pagina, stampate con un carattere progettato per essere letto da una macchina, e la zona di ispezione visiva sopra di esse, che è normale testo stampato con una disposizione diversa per ogni emittente.
Che cos'è una MRZ?
Una zona a lettura ottica (MRZ) è il blocco di righe a larghezza fissa in fondo a un passaporto o a una carta d'identità, standardizzato dal Doc 9303 dell'ICAO. Codifica il numero del documento, lo Stato di emissione, il nome, la cittadinanza, la data di nascita, il sesso e la data di scadenza, ciascuno in una posizione fissa, con cifre di controllo che verificano la lettura.
Che cos'è il Doc 9303 dell'ICAO?
Il Doc 9303 dell'ICAO, Machine Readable Travel Documents, è la specifica che seguono tutti i passaporti e le carte d'identità a lettura ottica. È pubblicato in parti: la Parte 3 contiene le specifiche comuni a tutti i documenti di viaggio a lettura ottica, e le Parti 4, 5 e 6 riguardano rispettivamente il passaporto TD3, la carta TD1 e la carta TD2. È ciò che rende un passaporto emesso ovunque leggibile da un lettore costruito ovunque.
L'API OCR per passaporti commette errori?
Qualsiasi lettura di una fotografia può essere sbagliata, per questo la risposta è pensata per essere verificabile anziché presa sulla fiducia. Ogni zona a lettura ottica viene verificata con le sue cifre di controllo ICAO 9303 e il verdetto è nella risposta; ogni campo riporta una fascia di confidenza; e quando la zona a lettura ottica e la zona di ispezione visiva non coincidono, vengono restituite entrambe le letture invece di preferirne una in silenzio.
Conservate qualcuno dei miei dati?
L'immagine caricata resta in memoria per la durata della richiesta e non viene mai scritta su disco. Ciò che può essere conservato è il risultato – l'esito e i campi estratti – per un periodo che scegli per l'account o per richiesta, da un anno fino a zero, e zero significa che non viene scritto nulla.
Sono disponibili prove gratuite o versioni demo?
Non c'è nessuna prova a cui iscriversi, perché prima non c'è nulla a cui iscriversi. Nella documentazione e nell'esempio di questa pagina è riportata una chiave pubblica della sandbox, che esegue riconoscimenti reali. Registrandoti ricevi documenti gratuiti sul saldo; dopo di che ricarichi il saldo e ogni documento riconosciuto scala un credito.
È possibile rilevare documenti falsi o manomessi?
No, e la risposta lo dice invece di tacerlo: il campo di autenticità riporta not_checked. Questo servizio esegue il riconoscimento, e riconoscere non significa autenticare: qui nulla esamina gli elementi di sicurezza di un documento. Cifre di controllo corrette dimostrano che la zona è coerente al suo interno, cosa che chiunque produca un falso sa ottenere; ciò che rilevano sono danni, riflessi ed errori di lettura.
Che cos'è un server MCP per l'elaborazione dei documenti?
Il Model Context Protocol è lo standard con cui un assistente di IA accede a uno strumento. Un server MCP per l'elaborazione dei documenti espone il riconoscimento come uno strumento che l'assistente può richiamare, così un agente gli passa l'immagine di un passaporto e riceve campi strutturati senza che nessuno scriva codice HTTP. doc.cheap ne include uno, che usa la stessa chiave e lo stesso prezzo dell'API.