Kostenlose OCR-API für Reisepässe

Ihre erste Erkennung ohne Konto

Kopieren Sie den Schlüssel aus der Dokumentation und senden Sie ein Bild. Das ist die ganze Integration:

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 ist der öffentliche Sandbox-Schlüssel – er ist absichtlich veröffentlicht, kein Geheimnis und durch ein Anfragelimit begrenzt. Idempotency-Key bedeutet, dass eine wiederholte Anfrage nicht ein zweites Mal berechnet wird, was an dem Tag zählt, an dem Sie eine Warteschlange erneut abspielen.

Was zurückkommt

Eine einzige Antwortstruktur, acht Gruppen, jeder Schlüssel immer vorhanden. Der Feld-Explorer listet jeden Schlüssel mit seinem Typ auf, und die API-Referenz (auf Englisch) ist der Vertrag selbst.

{
  "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 ist genau einer von fünf Strings: recognized, no_document_found, unreadable, unsupported_document, rejected.
• Datumsangaben sind immer ISO-8601. Ein fehlender Wert ist null, nie ein fehlender Schlüssel.
• meta.billed steht in jeder Antwort und sagt, ob dieser Aufruf etwas gekostet hat.
• fields[] enthält jedes Feld des Dokuments, getrennt aus der codierten und aus der gedruckten Zone gelesen, jedes mit eigener Konfidenz, sodass sich die beiden Lesungen vergleichen lassen. Werte in ihrer eigenen Schrift kommen neben der lateinischen Transliteration, mit ihrer Sprache gekennzeichnet.

Die Inhaberin im Beispiel ist ein synthetisches Muster: eine erfundene Person, mit echter Prüfziffern-Arithmetik über erfundenen Werten. Ihre Zone wird auf der Seite zu den MRZ-Formaten erklärt.

Was es nach den kostenlosen Aufrufen kostet

Was mit dem Bild passiert

Auf einem Sandbox-Schlüssel wird nichts aufbewahrt. Das Bild wird nie auf die Festplatte geschrieben – es liegt für die Dauer der Anfrage im Arbeitsspeicher –, und auch das Ergebnis wird nicht gespeichert. Mit Ihrem eigenen Live-Schlüssel wird ein Ergebnis aufbewahrt, damit Sie es erneut lesen können: für die retain_hours, die die Anfrage nennt, oder, ohne sie, für die Aufbewahrungseinstellung Ihres Kontos, die ein Jahr (8760 Stunden) beträgt, solange Sie sie nicht ändern.

Senden Sie retain_hours: 0, um nichts aufzubewahren – kein gespeichertes Ergebnis, nichts, was später abzurufen wäre. Sie entscheiden das bei jedem Aufruf selbst.

Wenn sich das Foto nicht lesen lässt

Die Antwort sagt es, und es ist kostenlos. meta.status unterscheidet die Fälle, und in allen drei ist meta.billed false:

• no_document_found – nichts im Bild, das wie ein Dokument aussieht.
• unreadable – gefunden, aber nicht lesbar – Spiegelung, Unschärfe, Auflösung.
• unsupported_document – gelesen, aber dieser Typ wird nicht unterstützt.

Jede Antwort enthält ihre eigene Zeitaufschlüsselung, und der aktuelle Median wird auf der Statusseite veröffentlicht, statt hier versprochen zu werden.

Kostenlose Tools, die gar keinen Schlüssel brauchen

• MRZ-Parser – eine TD1-, TD2- oder TD3-Zone einfügen und jedes Feld und jede Prüfziffer sehen. Läuft in Ihrem Browser.
• MRZ-Generator – eine gültige Zone zum Testen erzeugen.
• Dokumentfeld-Explorer – das Feldvokabular durchsuchen, mit dem die API antwortet.

Sie rufen sie aus einem Assistenten statt aus Code auf? Der MCP-Server stellt dieselbe Erkennung als drei Tools bereit.