身份证OCR识别

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

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

接口简介

身份证OCR识别接口上传身份证照片即自动判断人像面或国徽面，也可手动指定识别面，返回对应面的结构化字段：正面提取姓名、性别、民族、出生日期、住址与公民身份号码，反面提取签发机关和有效期起止。出生日期与有效期均归一为YYYY-MM-DD格式，有效期截止支持返回「长期」，适合实名认证、开户面签与入职登记等场景。

详细介绍

![身份证OCR识别接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261109/apiops_idimage__1794169332_3cf9ded966df.png)

实名认证、入职登记、开户面签都要收身份证，还在正反两面逐字手敲？上传一张身份证照片，平台自动判断正反面，把该面的关键信息变成结构化字段，直接落入你的业务系统。

## 接口概述

身份证OCR识别接口面向实名认证、金融开户、企业入职、政务办理等身份材料收取场景：传入一张居民身份证照片（公网URL、Base64 或平台文件ID），由阿里云百炼视觉大模型（默认 qwen3.5-ocr，平台可在后台切换）完成读取，同步返回结构化结果。支持三种识别模式：`side=front` 只识别正面（人像面），`side=back` 只识别反面（国徽面），`side` 留空则自动判断——先按正面识别，未取到有效正面信息时自动改按反面识别。**响应只包含所识别面的字段加 `side` 标识**：正面返回姓名、性别、民族、出生日期、住址、身份证号码；反面返回签发机关、有效期起始、有效期截止；另一面的字段不会出现在响应中。所识别面的字段按固定清单构造，未识别到的为空字符串，不会出现 null；日期自动标准化为 YYYY-MM-DD，有效期截止可为「长期」。本接口开启结果缓存：缓存有效期为 1000 秒，期间的相同请求直接复用上次结果。

## 核心能力

1. **正反面自动判断**：不传 `side` 时平台自动尝试正面、失败再尝试反面，一次接口调用即拿到结果；自动模式最多产生两次内部识别尝试。
2. **分面固定字段契约**：所识别面的字段始终全部返回，未识别到的为空字符串，不会缺键、不会返回 null；`side` 字段明示本次识别的是哪一面。
3. **日期自动规范**：出生日期、有效期起始/截止统一转为 YYYY-MM-DD，自动兼容「2015.06.01」等写法；反面「有效期限」合并返回时自动拆分为起止两个字段；长期有效的证件截止返回「长期」。
4. **占位值过滤**：模型误把示例占位文本当结果返回时自动判空，避免脏数据入库。
5. **结果缓存**：相同请求在缓存窗口期内直接复用结果，适合短时间重复提交的补偿重试场景。

## 产品优势

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

## 效果展示

一句话理解：它就像一位熟练的核验员，接过身份证先看一眼是哪一面，再把这一面「念」成一张标准表格，并告诉你念的是正面还是反面。

以一次典型调用为例（自动模式，上传的是人像面），你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| file | https://example.com/demo/idcard.jpg | 身份证照片的公网URL，也支持 Base64（data:开头）或文件ID（fileid_开头） |
| side | （留空） | front=正面，back=反面，留空自动判断识别面 |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 识别面 | front | `side`，标明本次识别的是正面 |
| 姓名 | 张大诚 | `name` |
| 性别 | 男 | `sex` |
| 民族 | 汉 | `nation` |
| 出生日期 | 1990-01-01 | `birth`，已标准化为 YYYY-MM-DD |
| 住址 | 北京市朝阳区阜通东大街6号院3号楼501 | `address` |
| 身份证号码 | `"110101199001011237"` | `id_number`，属敏感信息，入库请脱敏 |

API请求示例：

```
POST /api/v1/idimage
file=https://example.com/demo/idcard.jpg
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "side": "front",
    "name": "张大诚",
    "sex": "男",
    "nation": "汉",
    "birth": "1990-01-01",
    "address": "北京市朝阳区阜通东大街6号院3号楼501",
    "id_number": "110101199001011237"
  }
}
```

若上传的是国徽面（或 `side=back`），`data` 则为 `side`、`issue_authority`、`valid_start`、`valid_end` 四个字段，例如「北京市公安局朝阳分局 / 2015-06-01 / 2035-06-01」；长期有效证件的 `valid_end` 返回「长期」。

## 应用场景

- **实名认证**：注册与认证流程中读取姓名与身份证号，自动填充并交叉核验。
- **金融开户面签**：正反两面分别识别，签发机关与有效期自动入账，临期证件即时提示。
- **企业入职登记**：新员工证件拍照上传即入库，减少人事手工录入。
- **政务办理预审**：身份材料要素自动提取，异常件转人工复核。
- **酒店与园区登记**：前台拍摄身份证即完成住客/访客信息登记。

## 应用案例

- **互联网金融开户系统**：用户先后上传人像面与国徽面照片，系统自动判断识别面并分别回填姓名、身份证号与有效期信息，原先客服逐项核对的流程被压缩为一次接口调用，临期与过期证件在提交时即被拦截提示。
- **企业HR入职平台**：批量入职季人事逐份录入身份证信息的重复劳动被接口替代，员工拍照上传即完成登记；短时间内的重复提交命中结果缓存，页面几乎即传即回，台账差错率显著下降。
- **连锁酒店前台系统**：住客出示身份证、前台拍摄上传，姓名与证号自动进入登记系统，单客入住办理时间大幅压缩，夜间高峰排队明显缓解。

常见问题

Q：身份证OCR识别接口能做什么？

A：对居民身份证图片做结构化识别。side=front 识别正面（人像面），返回姓名、性别、民族、出生日期、住址、身份证号码；side=back 识别反面（国徽面），返回签发机关、有效期起始、有效期截止；side 留空自动判断识别面。同步接口，调用后直接返回结果。

Q：响应里为什么没有另一面的字段？

A：本接口按面返回：响应只包含所识别面的字段加 side 标识，另一面的字段键不会出现在 data 中（而不是返回空字符串）。请以 side 值判断本次识别的是哪一面，再按对应字段清单解析。

Q：自动模式会识别两次吗？

A：side 留空时平台先按正面识别，未取到有效正面信息才自动改按反面，最多产生两次内部识别尝试，但对使用者而言是一次接口调用。

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

A：所识别面的字段按固定清单构造，始终全部返回，未识别到的为空字符串，不会出现 null。长期有效证件的 valid_end 返回「长期」。识别由大模型完成，无法承诺百分之百准确，建议对姓名、身份证号等关键字段做非空校验并辅以人工复核。

Q：结果会缓存吗？

A：会。本接口开启结果缓存，缓存有效期为 1000 秒，期间的相同请求（业务参数完全一致）直接复用上次结果，省去重复识别的等待。

身份证识别正反面识别实名认证开户面签入职登记证件OCR

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

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`file`	string	必填	-	文件输入（自动识别）：公网URL / Base64(data:开头) / 文件ID(fileid_开头)
`side`	string	选填	-	识别面：front=正面（人像面），back=反面（国徽面），留空自动识别

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

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`side`	string	识别面：front/back
`name`	string	姓名（正面）
`sex`	string	性别（正面）
`nation`	string	民族（正面）
`birth`	string	出生日期，格式YYYY-MM-DD（正面）
`address`	string	住址（正面）
`id_number`	string	身份证号（正面）
`issue_authority`	string	签发机关（反面）
`valid_start`	string	有效期起始，格式YYYY-MM-DD（反面）
`valid_end`	string	有效期截止，格式YYYY-MM-DD或「长期」（反面）
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

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

调用失败：

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

请先登录后使用在线测试