Pasaport ve kimlik kartı OCR API'si – tek HTTP çağrısı, belge başına 1¢
doc.cheap, bir seyahat belgesinin fotoğrafını tek bir HTTP isteğiyle yapılandırılmış JSON'a dönüştüren bir pasaport ve kimlik kartı OCR API'sidir. Bir görüntü gönderirsiniz; ayrıştırılmış makinede okunabilir bölgeyi (MRZ), doğrulanmış ICAO 9303 kontrol basamaklarını ve görsel inceleme bölgesinden çıkarılmış alanları aynı yanıtta alırsınız. Sorgulanacak bir kuyruk ya da kurulacak bir SDK yoktur. İlk başarılı çağrınız 60 saniyeden kısa sürer ve kayıt gerektirmez: aşağıdaki örnekte herkese açık bir sandbox anahtarı zaten bulunuyor. Tanınan her belge 1¢ tutar; ilk belgenizden on milyonuncusuna kadar fiyat aynıdır ve hiçbir şey bulamayan bir tarama hiçbir ücret doğurmaz.
- ✓ Tek bir senkron çağrı
- ✓ 60 saniyede ilk çağrı
- ✓ Başlamak için kayıt gerekmez
- ✓ Düz JSON, ayrıştırma gerekmez
Dekoratif bir animasyon: kıtaları makinede okunabilir bölge karakterleriyle çizilmiş Dünya döner ve ardından düz bir haritaya açılır. Altında, bu sitenin her yerinde kullanılan örnek pasaportun makinede okunabilir bölgesi yazılır.
Hemen deneyin – hesap yok, kart yok, deneme süresi yok
Bir belge görüntüsü yükleyin, tanınan alanları ekranda görün. Demo, kendi görüntünüzü herkese açık sandbox anahtarıyla işler – gerçek bir tanıma, ücretsiz ve hesap olmadan – ve yanındaki istek birebir aynıdır, terminale yapıştırılmaya hazırdır. Kendi kodunuzda kullanmak istediğinizde ilk tanıma rehberi (İngilizce) buradan devam eder.
Hemen deneyin – hesap gerekmez
Bir pasaport veya kimlik kartı görüntüsünü bırakın, tanıma hemen başlasın. Görüntü tarayıcınızda yeniden boyutlandırılır ve herkese açık sandbox'a gönderilir; görüntü hiçbir zaman saklanmaz.
Aynı çağrı, terminalinizde
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')\"}"Bir görüntü seçtiğiniz anda tanıma sonucu aşağıda görünür: her alan, okunduğu her dilde, makinede okunabilir bölge basamak basamak kontrol edilmiş olarak.
Neler döner: her alan, çapraz kontrolle
Tek bir yanıt, okumanın tamamını taşır. Makinede okunabilir bölge ICAO 9303'e göre basamak basamak kontrol edilir ve okunduğu satırlarla birlikte tek bir hüküm olarak döner; sayfada basılı her alan, okunduğu her dil için bir kez olmak üzere sabit bir adla döner. Her alan kendi güven düzeyini belirtir. Pasaport tanıma rehberi (İngilizce) çağrının tamamını adım adım anlatır, alan gezgini ise her anahtarı türüyle birlikte listeler.
meta
Bu taramanın ne olduğu ve nasıl geçtiği: kimliği, durumu, kredi düşüp düşmediği ve sürenin nereye harcandığı.
schema_version · id · status · billed · confidence · timing · created_at · reference
document
Ne tür bir belgenin tanındığı, onu hangi devletin düzenlediği, numarası ve tarihleri, süresinin dolup dolmadığı. Hiçbir şey tanınmadığında null.
kind · country · country_name · issuing_state · type_name · type_confidence · number · series · issue_date · expiry_date · is_expired · days_remaining
holder
Belgenin kimliğini tanımladığı kişi. Hiçbir şey tanınmadığında null.
given_names · surname · full_name · birth_date · sex · nationality
fields[]
Basılı sayfadan okunan her alan, sabit bir adla. Her okuma için bir kayıt; her biri kendi dili ve güven düzeyiyle.
id · name · label · category · value · language · confidence
mrz
Makinede okunabilir bölge: doğrulanıp doğrulanmadığına dair bir hüküm, doğrulanmadığında nedeni ve satırların okunduğu hâliyle kendisi.
status · reason · lines · text
images
Gönderdiğiniz görüntüden alınan kırpımlar, her biri bir data URL olarak.
document_crop · rear · main_photo · signature · watermark_face · barcode · chip
quality
Gönderdiğiniz görüntünün tanıma için yeterince iyi olup olmadığı.
overall
authenticity
Orijinallik doğrulaması. Yalnızca tanıma yapan çağrıda çalışmaz; bu çağrı onu kontrol edilmedi olarak bildirir.
overall · checks
Örnek bir bölge ve ayrıştırıcının onunla yaptığı
Uydurma bir hamil, uydurma numaralar ve bunlardan hesaplanmış kontrol basamakları. Her basamağın kendi tarayıcınızda yeniden hesaplandığını görmek için bölgeyi MRZ ayrıştırıcıya yapıştırın ya da TD1, TD2 ve TD3 arasındaki farkları okuyun.
P<GRCPARADEIGMA<<ELENI<SOFIA<<<<<<<<<<<<<<<<
AM73045184GRC9403084F3203101PN48291630<<<<72Fiyatlandırma: belge başına 1¢ – ve yalnızca işe yaradığında
1¢ belge başına
Herkes için ve her hacimde aynı fiyat: ilk belge de on milyonuncu belge de aynı tutardadır.
Yalnızca gerçekten tanıdığımız belgeler için ödeme yaparsınız.
Bulanık fotoğraf, karede belge yok, bilinmeyen tür: ücretsiz. Başarısız bir tarama için asla ödeme yapmazsınız.
- ✓ Herkese açık sandbox anahtarıyla, hiç hesap açmadan, adres başına 10 ücretsiz tanınan belge; yanıt ne olursa olsun saatte en fazla 10 istek.
- ✓ Kayıt olduğunuzda bakiyenize 20 ücretsiz belge tanımlanır.
doc.cheap diğerleriyle nasıl kıyaslanıyor
Liste fiyatları; her biri sağlayıcının kendi fiyat sayfasında okundu ve o sayfaya bağlantı verildi. Fiyatları herkese açık sayfalarından okunamayan bir sağlayıcı tahmin edilmek yerine tablo dışında bırakıldı: doğrulanamayan tek bir sayı bütün tabloyu değersiz kılardı. Ayrıntılı karşılaştırma, başarısız bir taramanın neye mal olduğunu, hangilerinin hesap olmadan çağrılabildiğini ve her birinin neyi bizden daha iyi yaptığını da ekler.
| Sağlayıcı | Yayımlanan fiyat | Ücretsiz başlangıç |
|---|---|---|
| doc.cheap | Belge başına $0.01, her hacimde sabit | Herkese açık sandbox, kayıt gerekmez |
| AWS Textract – Analyze ID | Ayda 100.000 sayfaya kadar sayfa başına $0.025; bunun üzerinde sayfa başına $0.01 (us-west-2) kaynak | İlk üç ay boyunca ayda 100 sayfa |
| Google Document AI | Belge başına $0.10 (ABD pasaportu ayrıştırıcısı); $0.10 (sürücü belgesi) kaynak | – |
| Mindee | Ek krediler "starting from $0.05", artı %20 aşım ücreti kaynak | – |
| doc.cheap | $0 – belge bulamayan bir tarama ücretlendirilmez ve yanıt bunu billed işaretinde belirtir. |
|---|---|
| Yukarıdaki üç sağlayıcı | Hiçbirinin fiyat sayfasında böyle bir istisna yayımlanmıyor. |
Belgelerinizi fiziksel olarak saklamıyoruz
Yüklenen görüntü yalnızca istek süresince bellekte tutulur ve hiçbir zaman diske yazılmaz. Saklanan şey sonuçtur – belgenin bir görüntüsü asla değil, sonuç durumu ve çıkarılan alanlar – ve siz ne kadar süre seçerseniz o kadar saklanır: bir yıl, bir ay, bir hafta, bir gün ya da hiç.
Yapay zekâ ajanları için pasaport OCR: MCP sunucusu
Pasaport okuması gereken bir ajanın, kendisi için yazılmış bir HTTP istemcisine ihtiyacı yoktur. doc.cheap bir Model Context Protocol sunucusuyla gelir; böylece bir asistan tanımayı bir araç olarak çağırır: ona bir görüntü verir, aynı yapılandırılmış alanları geri alır. API ile aynı anahtar, aynı fiyat, aynı yanıt yapısı – hiçbiri ayrı bir ürün değildir.
Geliştiricilerin sorduğu sorular
Pasaportta OCR nedir?
Optik karakter tanıma (OCR), belgenin fotoğrafındaki basılı karakterleri okur ve metne dönüştürür. Bir pasaportta okunacak iki şey vardır: sayfanın altındaki, bir makinenin okuması için tasarlanmış bir yazı tipiyle basılan makinede okunabilir bölgenin iki satırı ve bunun üzerindeki, her düzenleyicinin farklı yerleştirdiği sıradan baskıdan oluşan görsel inceleme bölgesi.
MRZ nedir?
Makinede okunabilir bölge (MRZ), bir pasaportun veya kimlik kartının altındaki, ICAO Doc 9303 ile standartlaştırılmış sabit genişlikli satırlardan oluşan bloktur. Belge numarasını, düzenleyen devleti, adı, uyruğu, doğum tarihini, cinsiyeti ve son geçerlilik tarihini her biri sabit bir konumda olacak şekilde kodlar; okumayı doğrulayan kontrol basamakları da içerir.
ICAO Doc 9303 nedir?
ICAO Doc 9303, Machine Readable Travel Documents, makinede okunabilir tüm pasaport ve kimlik kartlarının uyduğu spesifikasyondur. Bölümler hâlinde yayımlanır: Bölüm 3, makinede okunabilir tüm seyahat belgelerine ortak spesifikasyonları içerir; Bölüm 4, 5 ve 6 ise sırasıyla TD3 pasaportu, TD1 kartı ve TD2 kartını kapsar. Herhangi bir yerde düzenlenen bir pasaportun, herhangi bir yerde üretilmiş bir okuyucu tarafından okunabilmesini sağlayan budur.
Pasaport OCR API'si hata yapar mı?
Bir fotoğrafın her okuması yanlış olabilir; bu yüzden yanıt, körü körüne güvenilmek yerine kontrol edilebilecek şekilde tasarlanmıştır. Her makinede okunabilir bölge kendi ICAO 9303 kontrol basamaklarıyla doğrulanır ve hüküm yanıtta yer alır; her alan bir güven düzeyi taşır; bölge ile görsel inceleme bölgesi uyuşmadığında da biri sessizce tercih edilmek yerine iki okuma birden döndürülür.
Verilerimden herhangi birini saklıyor musunuz?
Yüklenen görüntü istek süresince bellekte tutulur ve hiçbir zaman diske yazılmaz. Saklanabilecek olan sonuçtur – sonuç durumu ve çıkarılan alanlar – ve bu, hesap için veya istek başına seçtiğiniz bir süre boyunca, bir yıldan sıfıra kadar saklanır; sıfır, hiçbir şeyin yazılmadığı anlamına gelir.
Ücretsiz deneme veya demo sürümü var mı?
Kaydolunacak bir deneme sürümü yok, çünkü önce kaydolmanız gereken hiçbir şey yok. Dokümantasyonda ve bu sayfadaki örnekte herkese açık bir sandbox anahtarı yer alır ve bu anahtar gerçek tanımalar yapar. Kayıt olduğunuzda bakiyenize ücretsiz belgeler eklenir; sonrasında bakiyenize yükleme yaparsınız ve tanınan her belge bir kredi düşer.
Sahte veya üzerinde oynanmış belgeler tespit edilebilir mi?
Hayır, ve yanıt bunu gizlemek yerine açıkça söyler: orijinallik alanı not_checked değerini taşır. Bu hizmet tanıma yapar ve tanıma, kimlik doğrulama değildir – burada hiçbir şey bir belgenin güvenlik unsurlarını incelemez. Kontrol basamaklarının tutması yalnızca bölgenin kendi içinde tutarlı olduğunu kanıtlar ve sahte belge üreten biri de bunu doğru yapar; bu basamakların yakaladığı şey hasar, parlama ve yanlış okumadır.
Belge işleme için MCP sunucusu nedir?
Model Context Protocol, bir yapay zekâ asistanının bir araca ulaştığı standarttır. Belge işleme için bir MCP sunucusu, tanımayı asistanın çağırabileceği bir araç olarak sunar; böylece bir ajan ona bir pasaport görüntüsü verip, kimse HTTP kodu yazmadan yapılandırılmış alanları geri alabilir. doc.cheap böyle bir sunucuyla gelir ve API ile aynı anahtarı ve aynı fiyatı kullanır.