मुफ़्त पासपोर्ट OCR API

बिना खाते के अपनी पहली पहचान चलाएँ

डॉक्यूमेंटेशन से कुंजी कॉपी करें और एक इमेज भेजें। पूरा इंटीग्रेशन बस इतना है:

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 सार्वजनिक सैंडबॉक्स कुंजी है – इसे जान-बूझकर प्रकाशित किया गया है, यह कोई सीक्रेट नहीं है, और इस पर रिक्वेस्ट की सीमा है। Idempotency-Key का मतलब है कि दोबारा भेजी गई रिक्वेस्ट का दूसरी बार शुल्क नहीं लगता, जो उस दिन काम आता है जब आप कोई क्यू फिर से चलाते हैं।

आपको क्या मिलता है

रिस्पॉन्स की एक ही बनावट, आठ ग्रुप, और हर की (key) हमेशा मौजूद। फ़ील्ड एक्सप्लोरर में हर की उसके टाइप के साथ दी गई है, और API रेफ़रेंस (अंग्रेज़ी में) ख़ुद कॉन्ट्रैक्ट है।

{
  "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 ठीक पाँच स्ट्रिंग में से एक होता है: recognized, no_document_found, unreadable, unsupported_document, rejected.
• तारीख़ें हमेशा ISO-8601 में होती हैं। कोई वैल्यू न हो तो वह null होती है, की (key) कभी ग़ायब नहीं होती।
• meta.billed हर रिस्पॉन्स में होता है और बताता है कि उस कॉल का कोई शुल्क लगा या नहीं।
• fields[] में डॉक्यूमेंट का हर फ़ील्ड होता है, जो एन्कोडेड ज़ोन और छपे ज़ोन से अलग-अलग पढ़ा जाता है, हर एक का अपना कॉन्फ़िडेंस होता है, ताकि दोनों रीडिंग की तुलना की जा सके। अपनी लिपि में लिखी वैल्यू लैटिन लिप्यंतरण के साथ आती हैं, अपनी भाषा के टैग के साथ।

उदाहरण की धारक एक सिंथेटिक नमूना है: एक काल्पनिक व्यक्ति, जिसके काल्पनिक डेटा पर चेक डिजिट का असली हिसाब लगाया गया है। उसका ज़ोन MRZ फ़ॉर्मैट पेज पर समझाया गया है।

मुफ़्त कॉल के बाद कितना शुल्क लगता है

इमेज का क्या होता है

सैंडबॉक्स कुंजी पर कुछ भी नहीं रखा जाता। इमेज कभी डिस्क पर नहीं लिखी जाती – वह रिक्वेस्ट चलने तक मेमोरी में रहती है – और नतीजा भी सेव नहीं होता। आपकी अपनी live कुंजी पर नतीजा रखा जाता है ताकि आप उसे दोबारा पढ़ सकें: उतने retain_hours तक जितने रिक्वेस्ट में दिए हों, और न दिए हों तो आपके खाते की रिटेंशन सेटिंग जितना, जो बदलने तक एक साल (8760 घंटे) है।

कुछ भी न रखने के लिए retain_hours: 0 भेजें – न कोई सेव नतीजा, न बाद में वापस लाने को कुछ। यह आपकी पसंद है, हर कॉल के लिए।

जब फ़ोटो पढ़ी न जा सके

जवाब यह साफ़ बताता है, और यह मुफ़्त है। meta.status इन मामलों को अलग करता है, और तीनों में meta.billed false होता है:

• no_document_found – फ़्रेम में डॉक्यूमेंट जैसी कोई चीज़ नहीं.
• unreadable – मिल गया, पर पढ़ा नहीं जा सका – चमक, धुंधलापन, रेज़ोल्यूशन.
• unsupported_document – पढ़ लिया, पर यह प्रकार सपोर्ट नहीं होता.

हर रिस्पॉन्स में उसका अपना टाइमिंग ब्रेकडाउन होता है, और लाइव मीडियन यहाँ वादा करने के बजाय स्टेटस पेज पर प्रकाशित किया जाता है।

मुफ़्त टूल, जिनके लिए किसी कुंजी की ज़रूरत नहीं

• MRZ पार्सर – TD1, TD2 या TD3 ज़ोन पेस्ट करें, और हर फ़ील्ड और हर चेक डिजिट देखें। आपके ब्राउज़र में चलता है।
• MRZ जनरेटर – टेस्टिंग के लिए एक वैध ज़ोन बनाएँ।
• डॉक्यूमेंट फ़ील्ड एक्सप्लोरर – वे फ़ील्ड देखें जिनके साथ API जवाब देता है।

कोड के बजाय किसी असिस्टेंट से कॉल कर रहे हैं? MCP सर्वर यही पहचान तीन टूल के रूप में देता है।