API OCR gratuita per passaporti

Esegui il tuo primo riconoscimento senza account

Copia la chiave dalla documentazione e invia un'immagine. È tutta qui l'integrazione:

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 è la chiave pubblica della sandbox: è pubblicata di proposito, non è un segreto e ha un limite di richieste. Idempotency-Key fa sì che una richiesta ripetuta non venga addebitata una seconda volta, cosa che conta il giorno in cui rielabori una coda.

Cosa ricevi

Una sola struttura di risposta, otto gruppi, ogni chiave sempre presente. L'esploratore dei campi elenca ogni chiave con il suo tipo, e il riferimento dell'API (in inglese) è il contratto stesso.

{
  "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 è esattamente una di cinque stringhe: recognized, no_document_found, unreadable, unsupported_document, rejected.
• Le date sono sempre in ISO-8601. Un valore mancante è null, mai una chiave assente.
• meta.billed è presente in ogni risposta e indica se quella chiamata è costata qualcosa.
• fields[] contiene ogni campo del documento, letto separatamente dalla zona codificata e dalla zona stampata, ciascuno con il proprio livello di confidenza, così puoi confrontare le due letture. I valori nella loro scrittura originale arrivano accanto alla traslitterazione latina, etichettati con la loro lingua.

La titolare dell'esempio è un campione sintetico: una persona inventata, con un calcolo reale delle cifre di controllo su valori inventati. La zona che porta è illustrata nella pagina dei formati MRZ.

Quanto costa dopo le chiamate gratuite

Cosa succede all'immagine

Su una chiave sandbox non viene conservato nulla. L'immagine non viene mai scritta su disco – vive in memoria per la durata della richiesta – e nemmeno il risultato viene memorizzato. Con la tua chiave live, un risultato viene conservato perché tu possa rileggerlo: per le retain_hours indicate dalla richiesta o, se mancano, per il periodo di conservazione impostato sul tuo account, che è di un anno (8760 ore) finché non lo cambi.

Invia retain_hours: 0 per non conservare nulla – nessun risultato memorizzato, nulla da recuperare in seguito. La scelta è tua, chiamata per chiamata.

Quando la foto non si può leggere

La risposta lo dice, ed è gratis. meta.status distingue i casi, e in tutti e tre meta.billed è false:

• no_document_found – nell'inquadratura non c'è nulla che somigli a un documento.
• unreadable – trovato, ma non leggibile: riflessi, sfocatura, risoluzione.
• unsupported_document – letto, ma quel tipo non è supportato.

Ogni risposta riporta la propria suddivisione dei tempi, e la mediana in tempo reale è pubblicata nella pagina di stato invece di essere promessa qui.

Strumenti gratuiti che non richiedono alcuna chiave

• Parser MRZ – incolla una zona TD1, TD2 o TD3 e vedi ogni campo e ogni cifra di controllo. Funziona nel tuo browser.
• Generatore MRZ – crea una zona valida per i test.
• Esplora i campi del documento – consulta il vocabolario dei campi con cui risponde l'API.

La chiami da un assistente invece che dal codice? Il server MCP espone lo stesso riconoscimento come tre strumenti.