API OCR paspor gratis

Jalankan pengenalan pertama Anda tanpa akun

Salin kunci dari dokumentasi lalu kirim sebuah gambar. Itulah seluruh integrasinya:

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 adalah kunci sandbox publik – kunci ini sengaja dipublikasikan, bukan rahasia, dan jumlah permintaannya dibatasi. Idempotency-Key berarti permintaan yang diulang tidak ditagih dua kali, dan itu penting pada hari Anda memutar ulang sebuah antrean.

Apa yang Anda terima

Satu bentuk respons, delapan grup, setiap kunci selalu ada. Penjelajah kolom mencantumkan setiap kunci beserta tipenya, dan referensi API (dalam bahasa Inggris) adalah kontraknya sendiri.

{
  "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 selalu berupa tepat satu dari lima string: recognized, no_document_found, unreadable, unsupported_document, rejected.
• Tanggal selalu dalam format ISO-8601. Nilai yang tidak ada adalah null, tidak pernah kunci yang hilang.
• meta.billed ada di setiap respons dan menyatakan apakah panggilan itu dikenai biaya.
• fields[] memuat setiap kolom yang ada di dokumen, dibaca secara terpisah dari zona yang dikodekan dan dari zona cetak, masing-masing dengan tingkat keyakinannya sendiri, sehingga kedua hasil pembacaan bisa dibandingkan. Nilai dalam aksara aslinya dikirim di samping transliterasi Latinnya, ditandai dengan bahasanya.

Pemegang dalam contoh ini adalah spesimen sintetis: orang fiktif, dengan perhitungan check digit sungguhan atas nilai-nilai fiktif. Zona yang dibawanya dijelaskan di halaman format MRZ.

Biayanya setelah panggilan gratis habis

Apa yang terjadi pada gambar

Pada kunci sandbox tidak ada yang disimpan. Gambar tidak pernah ditulis ke disk – gambar hanya ada di memori selama permintaan berlangsung – dan hasilnya juga tidak disimpan. Dengan kunci live Anda sendiri, hasil disimpan agar bisa dibaca ulang: selama retain_hours yang disebut permintaan atau, jika tidak disebut, selama pengaturan retensi akun Anda, yaitu satu tahun (8760 jam) sampai Anda mengubahnya.

Kirim retain_hours: 0 agar tidak ada yang disimpan – tidak ada hasil yang tersimpan, tidak ada yang bisa diambil kembali nanti. Itu pilihan Anda, per panggilan.

Jika foto tidak dapat dibaca

Jawabannya menyatakan hal itu, dan gratis. meta.status membedakan kasusnya, dan pada ketiganya meta.billed bernilai false:

• no_document_found – tidak ada apa pun yang berbentuk dokumen di dalam bingkai.
• unreadable – dokumen ditemukan, tetapi tidak bisa dibaca – pantulan cahaya, buram, resolusi.
• unsupported_document – dokumen terbaca, tetapi jenisnya tidak didukung.

Setiap respons membawa rincian waktunya sendiri, dan median terkininya dipublikasikan di halaman status, bukan dijanjikan di sini.

Alat gratis yang sama sekali tidak butuh kunci

• Parser MRZ – tempelkan zona TD1, TD2, atau TD3, lalu lihat setiap kolom dan check digit. Berjalan di browser Anda.
• Generator MRZ – buat zona yang valid untuk pengujian.
• Penjelajah kolom dokumen – jelajahi kosakata kolom yang dipakai API dalam jawabannya.

Memanggilnya dari asisten, bukan dari kode? Server MCP menyediakan pengenalan yang sama sebagai tiga alat.