结婚证OCR识别

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

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

接口简介

结婚证OCR识别接口上传结婚证内页照片，一次返回 14 个结构化字段：证书侧给出持证人姓名、结婚证字号、登记日期与备注，双方信息侧分列配偶1与配偶2的姓名、性别、国籍、出生日期与身份证号码，持证人即配偶1。登记日期与双方出生日期均按 YYYY-MM-DD 格式返回，适合购房资格审核、生育登记、保险投保等需要核验婚姻状况的场景。

详细介绍

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

购房资格审核、生育登记、保险投保都要收结婚证，还在逐字手敲双方身份证号？上传一张结婚证内页照片，持证人、结婚证字号、登记日期与配偶双方信息即自动变成结构化字段，直接落入你的业务系统。

## 接口概述

结婚证OCR识别接口面向购房资格审核、生育登记、婚姻状况核验、保险与信贷材料收取等场景：传入一张结婚证内页（含双方信息的个人页）照片（公网URL、Base64 或平台文件ID），由阿里云百炼视觉大模型（默认 qwen3.5-flash，平台可在后台切换）完成整页读取，同步返回持证人、结婚证字号、登记日期、备注及配偶双方的姓名、性别、国籍、出生日期、身份证号码共 14 个字段。字段对应关系固定：持证人即配偶1（spouse1），另一方即配偶2（spouse2）。响应按固定字段清单构造：未识别到的字段统一返回空字符串，不会出现 null；登记日期与双方出生日期自动标准化为 YYYY-MM-DD。

## 核心能力

1. **双方信息一次读全**：持证人、字号、登记日期与配偶双方的姓名、性别、国籍、出生日期、身份证号共 14 个字段，免去人工录入。
2. **固定字段契约**：响应始终返回全部 14 个字段，未识别到的为空字符串，不会缺键、不会返回 null，解析与入库无需防御性判断。
3. **配偶归位处理**：按「持证人=配偶1、另一方=配偶2」自动归位；模型偶尔把双方信息填到同一侧时自动搬移修正，配偶1姓名为空时用持证人姓名补全。
4. **日期自动规范与推导**：登记日期、双方出生日期统一转为 YYYY-MM-DD，自动兼容「2015年05月20日」等写法；出生日期与性别缺失时可从身份证号自动推导补全。
5. **交叉校验防串位**：内置双方信息一致性校验，检出双方生日相同等明显串位时，将易错字段置空而非返回错位数据，宁缺勿错。

## 产品优势

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

## 效果展示

一句话理解：它就像请了一位细致的民政登记员，把整页结婚证「念」成一张标准表格——持证人、字号、双方姓名与身份证号，一个字段都不落，还会顺手核对双方信息有没有填串。

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

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

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 持证人 | 陈志远 | `holder`，即配偶1 |
| 结婚证字号 | 杭民结字2015第01234号 | `certificate_number` |
| 登记日期 | 2015-05-20 | `register_date`，已标准化为 YYYY-MM-DD |
| 配偶1姓名 | 陈志远 | `spouse1_name` |
| 配偶1身份证号码 | `"320102198807153219"` | `spouse1_id_number`，属敏感信息，入库请脱敏 |
| 配偶2姓名 | 李婷 | `spouse2_name` |
| 配偶2出生日期 | 1991-08-15 | `spouse2_birth`，已标准化为 YYYY-MM-DD |
| 备注 | （空字符串） | `remarks`，证面无备注时为空 |

API请求示例：

```
POST /api/v1/marriagecertocr
file=https://example.com/demo/marriage.jpg
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "holder": "陈志远",
    "certificate_number": "杭民结字2015第01234号",
    "register_date": "2015-05-20",
    "remarks": "",
    "spouse1_name": "陈志远",
    "spouse1_gender": "男",
    "spouse1_nation": "中国",
    "spouse1_birth": "1988-07-15",
    "spouse1_id_number": "320102198807153219",
    "spouse2_name": "李婷",
    "spouse2_gender": "女",
    "spouse2_nation": "中国",
    "spouse2_birth": "1991-08-15",
    "spouse2_id_number": "330102199108154323"
  }
}
```

一次调用即完成整页读取：示例中双方出生日期与各自身份证号的出生段一致；`spouse1_id_number` 等数字形态字段均以字符串返回，入库前无需做类型转换。

## 应用场景

- **购房资格审核**：读取双方姓名与身份证号，自动核验家庭婚姻状况材料。
- **生育登记与社保**：提取登记日期与双方信息，自动填充申请表单。
- **保险与信贷**：夫妻共同投保、联名贷款时自动带入双方身份信息，减少错填退回。
- **婚姻状况核验**：政务与公证流程中核对证号与登记日期，异常件转人工复核。
- **档案数字化**：纸质结婚证批量转结构化数据，便于检索与统计。

## 应用案例

- **房产交易资格审核系统**：购房家庭上传结婚证内页照片，系统自动带出双方姓名、身份证号并与户籍材料交叉比对，原先人工核对一份要几分钟，接入后仅需对空字段与置空字段人工复核，审核周期大幅压缩。
- **保险公司线上投保平台**：夫妻共同投保时上传结婚证，双方信息自动回填投保单并校验出生日期与身份证号一致性，因信息错填导致的核保退回明显减少。
- **政务婚姻登记档案室**：历史纸质结婚证统一扫描后调用接口识别入库，结婚证字号与登记日期实现数字化检索，群众办事调档效率显著提升。

常见问题

Q：结婚证OCR识别接口能做什么？

A：对结婚证内页（含双方信息的个人页）图片做结构化识别，提取持证人、结婚证字号、登记日期、备注及配偶双方的姓名、性别、国籍、出生日期、身份证号码共14个字段。同步接口，调用后直接返回结果。

Q：配偶1和配偶2分别对应证面上的谁？

A：持证人即配偶1（spouse1 系列字段），另一方即配偶2（spouse2 系列字段）。模型偶尔把双方信息填到同一侧时，接口会自动归位修正；配偶1姓名为空时用持证人姓名补全。

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

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

Q：识别不到的字段会怎样？为什么有的字段返回了空值？

A：响应按固定字段清单构造，14个字段始终全部返回，未识别到的字段为空字符串，不会出现 null。另外接口内置双方交叉校验：检出双方生日相同、身份证号与出生日期冲突等明显串位时，会把易错字段置空，宁缺勿错——收到空值请结合证面人工复核。识别由大模型完成，无法承诺百分之百准确。

Q：日期字段的格式统一吗？

A：登记日期与双方出生日期统一标准化为 YYYY-MM-DD，自动兼容「2015年05月20日」等写法；无法识别时保留证面原文。出生日期与性别缺失时，接口会从18位身份证号自动推导补全，推导结果与证面冲突时以置空处理。

结婚证识别婚姻证明购房资格审核生育登记配偶信息提取证件OCR

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

请求方式： POST

业务请求参数

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

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

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`holder`	string	持证人姓名
`certificate_number`	string	结婚证字号（如：林民结字2011第07888号）
`register_date`	string	登记日期，格式YYYY-MM-DD
`remarks`	string	备注（无则返回空）
`spouse1_name`	string	配偶1姓名
`spouse1_gender`	string	配偶1性别
`spouse1_nation`	string	配偶1国籍
`spouse1_birth`	string	配偶1出生日期，格式YYYY-MM-DD
`spouse1_id_number`	string	配偶1身份证号码
`spouse2_name`	string	配偶2姓名
`spouse2_gender`	string	配偶2性别
`spouse2_nation`	string	配偶2国籍
`spouse2_birth`	string	配偶2出生日期，格式YYYY-MM-DD
`spouse2_id_number`	string	配偶2身份证号码
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

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

调用失败：

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

请先登录后使用在线测试