API gratuite d’OCR de passeports

Faites votre première reconnaissance sans compte

Copiez la clé depuis la documentation et envoyez une image. C’est toute l’intégration :

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 est la clé publique du sandbox : elle est publiée volontairement, ce n’est pas un secret, et elle est soumise à une limite de requêtes. Idempotency-Key garantit qu’une requête relancée n’est pas facturée une seconde fois, ce qui compte le jour où vous rejouez une file d’attente.

Ce que vous recevez

Une seule structure de réponse, huit groupes, toutes les clés toujours présentes. L’explorateur de champs liste chaque clé avec son type, et la référence de l’API (en anglais) est le contrat lui-même.

{
  "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 est exactement l’une de ces cinq chaînes : recognized, no_document_found, unreadable, unsupported_document, rejected.
• Les dates sont toujours au format ISO-8601. Une valeur manquante vaut null, jamais une clé absente.
• meta.billed figure dans chaque réponse et indique si cet appel a coûté quelque chose.
• fields[] contient chaque champ du document, lu séparément dans la zone encodée et dans la zone imprimée, chacun avec son propre niveau de confiance, pour que les deux lectures puissent être comparées. Les valeurs dans leur propre écriture arrivent à côté de la translittération latine, étiquetées avec leur langue.

La titulaire de l’exemple est un spécimen synthétique : une personne inventée, avec une vraie arithmétique de chiffres de contrôle appliquée à des valeurs inventées. La zone qu’elle porte est détaillée sur la page des formats MRZ.

Ce que cela coûte après les appels gratuits

Ce que devient l’image

Sur une clé sandbox, rien n’est conservé. L’image n’est jamais écrite sur disque – elle vit en mémoire le temps de la requête – et le résultat n’est pas stocké non plus. Avec votre propre clé live, un résultat est conservé pour que vous puissiez le relire : pendant les retain_hours que la requête indique ou, à défaut, pendant la durée de conservation réglée sur votre compte, qui est d’un an (8760 heures) tant que vous ne la changez pas.

Envoyez retain_hours: 0 pour ne rien conserver – aucun résultat stocké, rien à récupérer plus tard. C’est votre choix, à chaque appel.

Quand la photo est illisible

La réponse le dit, et c’est gratuit. meta.status distingue les cas, et dans les trois meta.billed vaut false :

• no_document_found – rien qui ressemble à un document dans le cadre.
• unreadable – trouvé, mais illisible : reflets, flou, résolution.
• unsupported_document – lu, mais ce type n’est pas pris en charge.

Chaque réponse comporte sa propre ventilation des temps, et la médiane en direct est publiée sur la page de statut plutôt que promise ici.

Des outils gratuits qui ne demandent aucune clé

• Analyseur MRZ – collez une zone TD1, TD2 ou TD3 et voyez chaque champ et chaque chiffre de contrôle. Fonctionne dans votre navigateur.
• Générateur MRZ – créez une zone valide pour vos tests.
• Explorateur de champs du document – parcourez le vocabulaire de champs avec lequel l’API répond.

Vous l’appelez depuis un assistant plutôt que depuis du code ? Le serveur MCP expose la même reconnaissance sous la forme de trois outils.