API OCR hộ chiếu và thẻ căn cước – một lệnh gọi HTTP, 1¢ mỗi giấy tờ
doc.cheap là API OCR hộ chiếu và thẻ căn cước, biến ảnh chụp giấy tờ đi lại thành JSON có cấu trúc chỉ bằng một yêu cầu HTTP. Gửi một ảnh, bạn nhận lại vùng đọc máy (MRZ) đã được phân tích, các chữ số kiểm tra theo ICAO 9303 đã được xác minh và các trường của vùng kiểm tra thị giác đã được trích xuất – trong cùng một phản hồi, không có hàng đợi phải thăm dò, không có SDK phải cài đặt. Lệnh gọi thành công đầu tiên mất chưa đến 60 giây và không cần đăng ký: khóa sandbox công khai đã có sẵn trong ví dụ bên dưới. Mỗi giấy tờ được nhận dạng có giá 1¢, cùng một mức giá từ giấy tờ đầu tiên đến giấy tờ thứ mười triệu, và một lần quét không tìm thấy gì thì hoàn toàn không mất phí.
- ✓ Một lệnh gọi đồng bộ
- ✓ Lệnh gọi đầu tiên trong 60 giây
- ✓ Không cần đăng ký để bắt đầu
- ✓ JSON phẳng, không cần phân tích
Một hình động trang trí: Trái Đất, với các lục địa được vẽ bằng ký tự của vùng đọc máy, xoay tròn rồi trải phẳng thành bản đồ. Bên dưới, vùng đọc máy của hộ chiếu mẫu dùng xuyên suốt trang web này được gõ ra từng ký tự.
Dùng thử ngay – không tài khoản, không thẻ, không thời gian dùng thử
Tải lên ảnh một giấy tờ và xem các trường được nhận dạng ngay trên màn hình. Demo xử lý chính ảnh của bạn bằng khóa sandbox công khai – một lần nhận dạng thật, miễn phí, không cần tài khoản – và yêu cầu hiển thị bên cạnh chính là yêu cầu đó, sẵn sàng để dán vào terminal. Khi bạn muốn đưa vào mã của mình, hướng dẫn nhận dạng đầu tiên (bằng tiếng Anh) sẽ dẫn bạn tiếp từ đây.
Dùng thử ngay – không cần tài khoản
Thả ảnh hộ chiếu hoặc thẻ căn cước vào đây và quá trình nhận dạng bắt đầu ngay. Ảnh được thu nhỏ trong trình duyệt của bạn rồi gửi đến sandbox công khai; ảnh không bao giờ được lưu.
Cùng lệnh gọi đó, trong terminal của bạn
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')\"}"Kết quả nhận dạng xuất hiện bên dưới ngay khi bạn chọn ảnh – mọi trường, bằng mọi ngôn ngữ mà nó được đọc, cùng vùng đọc máy được kiểm tra từng chữ số.
Bạn nhận lại gì: mọi trường, đều được đối chiếu chéo
Một phản hồi chứa toàn bộ kết quả đọc. Vùng đọc máy được kiểm tra từng chữ số theo ICAO 9303 và trả về dưới dạng một kết luận duy nhất, kèm theo các dòng mà nó được đọc ra; mọi trường in trên trang giấy tờ đều được trả về với một tên ổn định, mỗi ngôn ngữ đọc được một lần. Mỗi trường đều nêu độ tin cậy riêng của nó. Nhận dạng hộ chiếu trình bày toàn bộ lệnh gọi, và trình tra cứu trường dữ liệu liệt kê mọi khóa cùng kiểu của nó.
meta
Lần quét này là gì và diễn ra thế nào: id, trạng thái, có trừ credit hay không, và thời gian được dùng vào đâu.
schema_version · id · status · billed · confidence · timing · created_at · reference
document
Loại giấy tờ nào được nhận dạng, quốc gia nào cấp, số giấy tờ và các ngày tháng, và giấy tờ đã hết hạn hay chưa. Null khi không nhận dạng được gì.
kind · country · country_name · issuing_state · type_name · type_confidence · number · series · issue_date · expiry_date · is_expired · days_remaining
holder
Người mà giấy tờ xác định danh tính. Null khi không nhận dạng được gì.
given_names · surname · full_name · birth_date · sex · nationality
fields[]
Mọi trường đọc được trên trang in, với một tên ổn định. Mỗi lần đọc là một mục, mỗi mục có ngôn ngữ và mức độ tin cậy riêng.
id · name · label · category · value · language · confidence
mrz
Vùng đọc máy: kết luận nó có hợp lệ hay không, lý do khi không hợp lệ, và chính các dòng đúng như đã đọc.
status · reason · lines · text
images
Các phần cắt từ ảnh bạn gửi, mỗi phần là một data URL.
document_crop · rear · main_photo · signature · watermark_face · barcode · chip
quality
Ảnh bạn gửi có đủ tốt để nhận dạng hay không.
overall
authenticity
Xác minh tính xác thực. Bước này không chạy trong lệnh gọi chỉ nhận dạng, và được báo là chưa kiểm tra.
overall · checks
Một vùng MRZ mẫu, và trình phân tích xử lý nó ra sao
Chủ sở hữu giả định, số liệu giả định, chữ số kiểm tra được tính từ chính các số liệu đó. Dán nó vào trình phân tích MRZ để xem từng chữ số được tính lại ngay trong trình duyệt của bạn, hoặc đọc về sự khác nhau giữa TD1, TD2 và TD3.
P<GRCPARADEIGMA<<ELENI<SOFIA<<<<<<<<<<<<<<<<
AM73045184GRC9403084F3203101PN48291630<<<<72Bảng giá: 1¢ mỗi giấy tờ – và chỉ khi nhận dạng thành công
1¢ mỗi giấy tờ
Cùng một mức giá cho mọi người, ở mọi khối lượng – giấy tờ đầu tiên và giấy tờ thứ mười triệu có giá như nhau.
Bạn chỉ trả tiền cho những giấy tờ chúng tôi thực sự nhận dạng được.
Ảnh mờ, không có giấy tờ trong khung hình, loại giấy tờ không xác định – miễn phí. Bạn không bao giờ phải trả tiền cho một lần quét thất bại.
- ✓ 10 giấy tờ được nhận dạng miễn phí cho mỗi địa chỉ với khóa sandbox công khai, hoàn toàn không cần tài khoản – tối đa 10 yêu cầu mỗi giờ, bất kể kết quả trả về là gì.
- ✓ 20 giấy tờ miễn phí khi bạn đăng ký, được cộng vào số dư của bạn.
doc.cheap so với các dịch vụ khác
Giá niêm yết, mỗi mức giá được đọc trên chính trang bảng giá của nhà cung cấp và có liên kết tới đó. Nhà cung cấp nào không công bố giá trên các trang công khai thì bị loại khỏi bảng thay vì được ước tính: chỉ một con số không kiểm chứng được cũng đủ khiến cả bảng mất giá trị. Bản so sánh đầy đủ bổ sung chi phí của một lần quét thất bại, dịch vụ nào gọi được mà không cần tài khoản, và mỗi dịch vụ làm tốt hơn chúng tôi ở điểm nào.
| Nhà cung cấp | Giá công bố | Bắt đầu miễn phí |
|---|---|---|
| doc.cheap | $0.01 mỗi giấy tờ, giá cố định ở mọi khối lượng | Sandbox công khai, không cần đăng ký |
| AWS Textract – Analyze ID | $0.025 mỗi trang cho tới 100,000 trang mỗi tháng; $0.01 mỗi trang khi vượt mức đó (us-west-2) nguồn | 100 trang mỗi tháng trong ba tháng đầu |
| Google Document AI | $0.10 mỗi giấy tờ (trình phân tích hộ chiếu Hoa Kỳ); $0.10 (giấy phép lái xe) nguồn | – |
| Mindee | Credit bổ sung "starting from $0.05", cộng thêm phụ phí vượt mức 20 % nguồn | – |
| doc.cheap | $0 – lần quét không tìm thấy giấy tờ thì không bị tính phí, và phản hồi cho biết điều đó qua cờ billed. |
|---|---|
| Ba nhà cung cấp trên | Không trang bảng giá nào của họ công bố ngoại lệ này. |
Về mặt vật lý, chúng tôi không lưu giấy tờ của bạn
Ảnh tải lên chỉ nằm trong bộ nhớ, trong thời gian xử lý yêu cầu, và không bao giờ được ghi xuống đĩa. Thứ được lưu lại là kết quả – trạng thái và các trường đã trích xuất, không bao giờ là hình ảnh của giấy tờ – trong khoảng thời gian bạn chọn: một năm, một tháng, một tuần, một ngày, hoặc không lưu gì cả.
OCR hộ chiếu cho AI agent: máy chủ MCP
Một agent cần đọc hộ chiếu không cần ai viết sẵn HTTP client cho nó. doc.cheap cung cấp một máy chủ Model Context Protocol, nên trợ lý AI gọi chức năng nhận dạng như một công cụ: đưa cho nó một ảnh, nhận lại đúng các trường có cấu trúc đó. Cùng khóa, cùng giá, cùng cấu trúc phản hồi như API – không có gì là một sản phẩm riêng.
Câu hỏi thường gặp từ lập trình viên
OCR trên hộ chiếu là gì?
Nhận dạng ký tự quang học (OCR) đọc các ký tự in trên ảnh chụp giấy tờ và chuyển chúng thành văn bản. Trên hộ chiếu có hai phần cần đọc: hai dòng của vùng đọc máy ở cuối trang, được in bằng phông chữ thiết kế để máy đọc, và vùng kiểm tra thị giác phía trên, là chữ in thông thường với bố cục khác nhau tùy từng nơi cấp.
MRZ là gì?
Vùng đọc máy (MRZ) là khối các dòng có độ rộng cố định ở cuối trang hộ chiếu hoặc thẻ căn cước, được chuẩn hóa theo ICAO Doc 9303. Nó mã hóa số giấy tờ, quốc gia cấp, họ tên, quốc tịch, ngày sinh, giới tính và ngày hết hạn, mỗi thông tin ở một vị trí cố định, kèm các chữ số kiểm tra để xác minh kết quả đọc.
ICAO Doc 9303 là gì?
ICAO Doc 9303, Machine Readable Travel Documents, là đặc tả mà mọi hộ chiếu và thẻ căn cước đọc được bằng máy đều tuân theo. Nó được công bố thành nhiều phần: Phần 3 gồm các đặc tả chung cho mọi giấy tờ đi lại đọc được bằng máy, còn Phần 4, 5 và 6 lần lượt dành cho hộ chiếu TD3, thẻ TD1 và thẻ TD2. Chính đặc tả này giúp một hộ chiếu cấp ở bất kỳ đâu cũng đọc được bằng đầu đọc sản xuất ở bất kỳ nơi nào khác.
API OCR hộ chiếu có hay bị sai không?
Mọi kết quả đọc từ ảnh chụp đều có thể sai, vì vậy phản hồi được thiết kế để bạn kiểm tra được thay vì phải tin tưởng mù quáng. Mọi vùng đọc máy đều được xác minh bằng chính các chữ số kiểm tra ICAO 9303 của nó và kết luận nằm trong phản hồi; mọi trường đều có mức độ tin cậy; và khi vùng đọc máy và vùng kiểm tra thị giác không khớp nhau, cả hai kết quả đọc đều được trả về thay vì âm thầm chọn một.
Các bạn có lưu dữ liệu nào của tôi không?
Ảnh tải lên được giữ trong bộ nhớ trong thời gian xử lý yêu cầu và không bao giờ được ghi xuống đĩa. Thứ có thể được lưu là kết quả – trạng thái và các trường đã trích xuất – trong khoảng thời gian bạn chọn cho tài khoản hoặc cho từng yêu cầu, từ một năm xuống đến không, và không nghĩa là hoàn toàn không ghi gì.
Có bản dùng thử miễn phí hoặc bản demo không?
Không có bản dùng thử nào phải đăng ký, vì bạn không cần đăng ký gì trước cả. Khóa sandbox công khai được in sẵn trong tài liệu và trong ví dụ trên trang này, và nó thực hiện nhận dạng thật. Khi đăng ký, bạn được cộng giấy tờ miễn phí vào số dư; sau đó bạn nạp thêm số dư và mỗi giấy tờ được nhận dạng sẽ trừ một credit.
Có phát hiện được giấy tờ giả hoặc bị chỉnh sửa không?
Không, và phản hồi nói rõ điều đó thay vì im lặng: trường authenticity có giá trị not_checked. Dịch vụ này thực hiện nhận dạng, và nhận dạng không phải là xác thực – ở đây không có gì kiểm tra các đặc điểm bảo an của giấy tờ. Chữ số kiểm tra hợp lệ chứng minh vùng đọc máy nhất quán nội bộ, điều mà bất kỳ ai làm giấy tờ giả cũng làm đúng được; thứ chúng phát hiện được là hư hỏng, lóa sáng và đọc sai.
Máy chủ MCP cho xử lý giấy tờ là gì?
Model Context Protocol là tiêu chuẩn để trợ lý AI truy cập một công cụ. Máy chủ MCP cho xử lý giấy tờ cung cấp chức năng nhận dạng như một công cụ mà trợ lý có thể gọi, nên agent có thể đưa cho nó ảnh hộ chiếu và nhận lại các trường có cấu trúc mà không ai phải viết mã HTTP. doc.cheap cung cấp một máy chủ như vậy, dùng cùng khóa và cùng mức giá với API.