中国护照OCR识别

接口标识: cnpassportocr 价格: 0.0005 元/次 VIP免费同步响应

接口介绍
接口文档
在线测试

接口简介

中国护照OCR识别接口上传护照信息页照片，一次返回 11 个结构化字段：中文姓名与英文拼音姓名分列输出，另有性别、国籍、出生日期、出生地、护照号码、签发日期、有效期至、签发机关与机读码。日期按统一格式返回、护照号码自动转为大写，省去人工二次清洗，适合签证代办、跨境开户、商旅建档等材料收取场景。

详细介绍

![中国护照OCR识别接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261109/apiops_cnpassportocr__1794169290_d98dade937d0.png)

出入境材料收取还在人工誊抄护照？上传一张中国护照信息页照片，姓名、护照号、签发与有效期等字段即自动结构化返回，直接落入业务系统。

## 接口概述

中国护照OCR识别接口面向签证代办、跨境金融开户、出入境登记、商旅系统建档等场景：传入一张中国护照信息页图片（公网URL、Base64 或平台文件ID），由阿里云百炼视觉大模型（默认 qwen3.5-ocr，平台可在后台切换）完成整页读取，同步返回中文姓名、英文姓名、性别、国籍、出生日期、出生地、护照号码、签发日期、有效期至、签发机关共 10 个字段。响应按固定字段清单构造：未识别到的字段统一返回空字符串，不会出现 null；三个日期字段自动标准化为 YYYY-MM-DD；性别、国籍、出生地自动从「中文/英文」双语值中取英文侧（如「中国/CHINESE」返回 CHINESE）；护照号码自动转为大写。

## 核心能力

1. **信息页整页提取**：中英文姓名、号码、日期、签发机关共 10 个字段一次读全，免去人工誊抄。
2. **固定字段契约**：响应始终返回全部字段，未识别到的为空字符串，不会缺键、不会返回 null，解析入库简单。
3. **日期自动规范**：出生日期、签发日期、有效期至统一转为 YYYY-MM-DD；模型把签发与有效期合并返回（如 2026.02.04-2036.02.03）时自动拆分为两个字段。
4. **双语值智能拆分**：性别、国籍、出生地的「中文/英文」组合值自动取英文侧，输出形态稳定，便于跨境系统直接存储。
5. **号码自动大写**：护照号码统一转为大写字母，避免因大小写混用导致的比对失败。

## 产品优势

- **接入简单**：仅 `file` 一个业务参数，POST 请求即返 JSON，无需自建识别引擎与维护模板。
- **稳定可靠**：响应字段与文档约定一致，识别不到时返回空字符串而非报错，集成侧无需防御性解析。

## 效果展示

一句话理解：它就像一位熟练的签证专员，把护照信息页逐项誊进登记表——中英文姓名、号码、日期一次抄齐，还顺手把格式统一了。

以一次典型调用为例，你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| file | https://example.com/demo/passport.jpg | 护照信息页照片的公网URL，也支持 Base64（data:开头）或文件ID（fileid_开头） |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 中文姓名 | 张小明 | `name_cn` |
| 英文姓名 | ZHANG,XIAOMING | `name_en`，拼音格式 |
| 护照号码 | `"ER1234567"` | `passport_number`，已统一大写 |
| 国籍 | CHINESE | `country`，双语值自动取英文侧 |
| 出生日期 | 1990-01-01 | `date_of_birth`，已标准化为 YYYY-MM-DD |
| 签发日期 | 2026-02-04 | `date_of_issue` |
| 有效期至 | 2036-02-03 | `date_of_expiry`，合并日期自动拆分 |
| 签发机关 | 中华人民共和国国家移民管理局 | `authority` |

API请求示例：

```
POST /api/v1/cnpassportocr
file=https://example.com/demo/passport.jpg
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "name_cn": "张小明",
    "name_en": "ZHANG,XIAOMING",
    "sex": "M",
    "country": "CHINESE",
    "date_of_birth": "1990-01-01",
    "place_of_birth": "HENAN",
    "passport_number": "ER1234567",
    "date_of_issue": "2026-02-04",
    "date_of_expiry": "2036-02-03",
    "authority": "中华人民共和国国家移民管理局"
  }
}
```

一次调用即完成信息页整页读取：日期已标准化、号码已大写、双语值已取英文侧，接入方拿到的就是可直接入库的形态。

## 应用场景

- **签证与出入境代办**：自动录入申请人护照信息，减少手抄错号导致的送签退回。
- **跨境金融开户**：境外人员身份材料收取时自动提取护照要素，加速开户审核。
- **商旅系统建档**：企业差旅平台自动同步员工护照号与有效期，订票填单一步到位。
- **酒店与航司登记**：外宾入住、值机场景快速核验证件信息并留存结构化档案。
- **证件效期管理**：批量提取有效期至字段，到期前自动提醒换发。

## 应用案例

- **签证代办机构**：顾问原先逐本手抄护照信息填申请表，旺季错抄号码时有发生；接入后上传信息页照片即自动回填，仅需复核空字段，单本录入时间大幅缩短。
- **跨境电商平台**：海外仓与清关环节需登记经办人护照信息，系统接入接口后自动提取姓名拼音与护照号，清关资料一致性明显提升。
- **企业差旅管理系统**：员工首次建档时上传护照照片，系统自动保存号码与有效期，并在到期前推送换发提醒，避免因证件过期影响出差行程。

常见问题

Q：中国护照OCR识别接口能做什么？

A：对中国护照信息页图片做结构化识别，提取中文姓名、英文姓名、性别、国籍、出生日期、出生地、护照号码、签发日期、有效期至、签发机关共10个字段。同步接口，调用后直接返回结果。

Q：支持什么格式的文件输入？

A：file 参数可传公网图片URL、data: 开头的 Base64 字符串或 fileid_ 开头的文件ID，平台自动检测类型。支持 JPG、PNG、BMP、GIF、WEBP、TIFF 等常见图片格式；Word、Excel、PPT 等办公文档不支持，会返回参数错误。

Q：会返回机读码（MRZ）吗？

A：当前版本响应不包含机读码字段，仅返回上述10个结构化字段。若文档返回参数表中列有机读码，请以实际响应为准。

Q：识别不到的字段会怎样？

A：响应按固定字段清单构造，10个字段始终全部返回，未识别到的字段为空字符串，不会出现 null。识别由大模型完成，无法承诺百分之百准确，建议对护照号码、有效期等关键字段做非空校验并辅以人工复核。

护照识别中国护照OCR 出入境证件签证材料录入护照信息提取商旅建档

接口地址： https://www.phpwc.cn/api/cnpassportocr

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`file`	string	必填	-	文件输入（自动识别）：公网URL / Base64(data:开头) / 文件ID(fileid_开头)

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`name_cn`	string	中文姓名
`name_en`	string	英文姓名（拼音）
`sex`	string	性别
`country`	string	国籍/国家
`date_of_birth`	string	出生日期
`place_of_birth`	string	出生地
`passport_number`	string	护照号码
`date_of_issue`	string	签发日期
`date_of_expiry`	string	有效期至
`authority`	string	签发机关
`mrz`	string	机读码（MRZ）
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试