API OCR hộ chiếu miễn phí cho lập trình viên

Chạy lần nhận dạng đầu tiên mà không cần tài khoản

Sao chép khóa từ tài liệu và gửi một ảnh. Đó là toàn bộ việc tích hợp:

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 là khóa sandbox công khai – nó được công bố có chủ đích, không phải bí mật, và có giới hạn tần suất. Idempotency-Key nghĩa là một yêu cầu được gửi lại sẽ không bị tính phí lần thứ hai, điều quan trọng vào ngày bạn phải chạy lại một hàng đợi.

Bạn nhận lại gì

Một cấu trúc phản hồi, tám nhóm, mọi khóa luôn có mặt. Trình tra cứu trường dữ liệu liệt kê mọi khóa cùng kiểu của nó, và tài liệu tham chiếu API (bằng tiếng Anh) chính là bản hợp đồng.

{
  "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 là đúng một trong năm chuỗi: recognized, no_document_found, unreadable, unsupported_document, rejected.
• Ngày tháng luôn theo ISO-8601. Giá trị bị thiếu là null, không bao giờ là một khóa vắng mặt.
• meta.billed có trong mọi phản hồi và cho biết lệnh gọi đó có mất phí hay không.
• fields[] chứa mọi trường mà giấy tờ có, được đọc riêng từ vùng mã hóa và từ vùng in, mỗi trường có độ tin cậy riêng, để bạn có thể so sánh hai kết quả đọc. Các giá trị viết bằng hệ chữ gốc được trả về bên cạnh bản chuyển tự Latinh, có gắn nhãn ngôn ngữ.

Người sở hữu trong ví dụ là một mẫu tổng hợp: một người giả định, với phép tính chữ số kiểm tra thật trên các giá trị giả định. Vùng MRZ của cô ấy được trình bày trên trang định dạng MRZ.

Chi phí sau các lệnh gọi miễn phí

Điều gì xảy ra với ảnh

Với khóa sandbox, không có gì được lưu lại. Ảnh không bao giờ được ghi xuống đĩa – nó chỉ nằm trong bộ nhớ trong thời gian xử lý yêu cầu – và kết quả cũng không được lưu. Với khóa live của riêng bạn, kết quả được giữ để bạn đọc lại: trong số retain_hours mà yêu cầu nêu hoặc, nếu không nêu, theo thiết lập thời hạn lưu của tài khoản, là một năm (8760 giờ) cho đến khi bạn đổi.

Gửi retain_hours: 0 để không lưu gì – không có kết quả nào được lưu, không có gì để lấy lại sau này. Đó là lựa chọn của bạn, cho từng lệnh gọi.

Khi ảnh không đọc được

Phản hồi sẽ nói rõ điều đó, và không mất phí. meta.status phân biệt các trường hợp, và trong cả ba trường hợp meta.billed đều là false:

• no_document_found – không có gì trông giống giấy tờ trong khung hình.
• unreadable – đã tìm thấy nhưng không đọc được – lóa sáng, mờ, độ phân giải.
• unsupported_document – đã đọc được nhưng loại giấy tờ đó không được hỗ trợ.

Mỗi phản hồi đều kèm phần chia nhỏ thời gian xử lý của chính nó, và giá trị trung vị thực tế được công bố trên trang trạng thái thay vì được hứa hẹn ở đây.

Công cụ miễn phí hoàn toàn không cần khóa

• Trình phân tích MRZ – dán một vùng TD1, TD2 hoặc TD3, xem từng trường và từng chữ số kiểm tra. Chạy ngay trong trình duyệt của bạn.
• Trình tạo MRZ – tạo một vùng MRZ hợp lệ để kiểm thử.
• Tra cứu trường dữ liệu giấy tờ – xem bộ từ vựng các trường mà API trả về.

Bạn gọi từ trợ lý AI thay vì từ mã? Máy chủ MCP cung cấp cùng chức năng nhận dạng đó dưới dạng ba công cụ.