户口本OCR识别

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

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

接口简介

户口本OCR识别接口面向常住人口登记卡，上传照片即可拿到结构化户籍信息：除姓名、性别、出生日期、民族、住址、身份证号码等个人基本信息外，还返回与户主关系、户号与户别等户籍特有字段，户别覆盖农业家庭户口、非农业家庭户口、居民户口等类型。出生日期归一为YYYY-MM-DD格式，适合招生报名、信贷面签、入职登记等户籍材料收取场景。

详细介绍

![户口本OCR识别接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261109/apiops_householdocr__1794169328_0c8abcf520d1.png)

入学报名、社保开户、贷款面签都要收户口本，还在逐字手敲户号和身份证号？上传一张常住人口登记卡照片，姓名、身份证号、与户主关系、户别等关键信息即自动变成结构化字段，直接落入你的业务系统。

## 接口概述

户口本OCR识别接口面向学校招生、银行信贷、政务窗口、企业入职等户籍材料收取场景：传入一张中国户口本（常住人口登记卡）照片（公网URL、Base64 或平台文件ID），由阿里云百炼视觉大模型（默认 qwen3.5-ocr，平台可在后台切换）完成整页读取，同步返回姓名、性别、出生日期、民族、住址、身份证号码、与户主关系、户别、户号等字段。响应按固定字段清单构造：未识别到的字段统一返回空字符串，不会出现 null；出生日期自动标准化为 YYYY-MM-DD。

## 核心能力

1. **整页结构化提取**：个人身份信息、户籍属性、与户主关系一次读全，免去人工逐字录入。
2. **固定字段契约**：响应始终返回全部字段，未识别到的为空字符串，不会缺键、不会返回 null，解析与入库无需防御性判断。
3. **出生日期自动规范**：统一转为 YYYY-MM-DD，自动兼容「1990年01月01日」「1990.01.01」等写法；无法识别时保留页面原文。
4. **户别与关系直接可用**：户别（农业家庭户口/非农业家庭户口/居民户口等）与「与户主关系」按登记卡原文提取，程序可直接归档判断。
5. **图片输入灵活**：公网URL、Base64、文件ID三种方式任选，旋转、侧拍的登记卡照片可自动方向适配。

## 产品优势

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

## 效果展示

一句话理解：它就像请了一位熟悉的户籍员，把整页常住人口登记卡「念」成一张标准表格——姓名、户号、身份证号、与户主关系，一个字段都不落。

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

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| file | https://example.com/demo/household.jpg | 户口本（常住人口登记卡）照片的公网URL，也支持 Base64（data:开头）或文件ID（fileid_开头） |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 姓名 | 张大诚 | `name` |
| 性别 | 男 | `gender` |
| 出生日期 | 1990-01-01 | `birth`，已标准化为 YYYY-MM-DD |
| 民族 | 汉 | `nation` |
| 身份证号码 | `"110101199001011237"` | `id_number`，属敏感信息，入库请脱敏 |
| 与户主关系 | 户主 | `relation` |
| 户别 | 非农业家庭户口 | `household_type` |
| 户号 | `"110105001234"` | `household_number`，字符串形态 |

API请求示例：

```
POST /api/v1/householdocr
file=https://example.com/demo/household.jpg
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "name": "张大诚",
    "gender": "男",
    "birth": "1990-01-01",
    "nation": "汉",
    "address": "北京市朝阳区阜通东大街6号院3号楼501",
    "id_number": "110101199001011237",
    "relation": "户主",
    "household_type": "非农业家庭户口",
    "household_number": "110105001234"
  }
}
```

一次调用即完成整页读取：表格与示例值一一对应；`id_number`、`household_number` 等数字形态字段均以字符串返回，入库前无需做类型转换，也不会丢失前导零。

## 应用场景

- **学校招生报名**：读取户号、与户主关系，自动核验学区户籍材料完整性。
- **银行信贷面签**：提取身份证号与住址，自动填充贷款申请表并辅助身份核验。
- **企业入职登记**：新员工户籍信息拍照上传即入库，减少人事手工录入。
- **政务窗口预审**：户籍材料要素自动提取，异常件转人工复核。
- **档案数字化**：纸质登记卡批量转结构化数据，便于检索与统计。

## 应用案例

- **小学招生报名系统**：家长上传登记卡照片，系统自动带出户号、与户主关系并校验户籍材料，原先人工核对一份要几分钟，接入后仅需对空字段与异常件复核，现场排队时间大幅压缩。
- **银行个贷面签系统**：客户经理拍摄户口本即自动回填申请人户籍信息，身份证号与出生日期交叉核验，因手抄错号导致的退件明显减少。
- **人力资源入职平台**：批量入职季人事逐份录入户籍信息的重复劳动被接口替代，员工拍照上传即完成登记，台账差错率显著下降。

常见问题

Q：户口本OCR识别接口能做什么？

A：对中国户口本（常住人口登记卡）图片做结构化识别，提取姓名、性别、出生日期、民族、住址、身份证号码、与户主关系、户别、户号等字段。同步接口，调用后直接返回结果。

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

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

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

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

Q：身份证号和户号是什么类型？会丢前导零吗？

A：均为字符串返回，不会丢失前导零，也不需要做类型转换。身份证号属个人敏感信息，建议按合规要求脱敏存储、控制访问权限。

户口本识别常住人口登记卡户籍录入招生报名信贷面签证件OCR

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

请求方式： POST

业务请求参数

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

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

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`name`	string	姓名
`gender`	string	性别
`birth`	string	出生日期，格式YYYY-MM-DD
`nation`	string	民族
`address`	string	住址
`id_number`	string	身份证号码
`relation`	string	与户主关系
`household_type`	string	户别（农业家庭户口/非农业家庭户口/居民户口等）
`household_number`	string	户号
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

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

调用失败：

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

请先登录后使用在线测试