免费的护照 OCR API

无需账户，完成您的首次识别

从文档中复制密钥，然后 POST 一张图像。整个集成就是这么简单：

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 确保重试的请求不会被重复收费，等到您需要重放一个队列的那天，这一点就很重要。

返回什么

只有一种响应结构，共八个分组，每个键始终存在。字段浏览器列出了每个键及其类型，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，绝不会缺少键。
• 每个响应都带有 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 服务器以三个工具的形式提供同样的识别功能。