身份证人像比对

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

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

接口简介

身份证人像比对接口输入姓名、18位身份证号码和一张人脸照片，与公安库身份证头像进行权威比对，返回百分制相似度分值与是否同一人的明确结论，分值越高越匹配。响应只给比对结论、不返回原始人脸图片，降低敏感信息二次泄露风险。适用于实名认证、远程开户核身、门禁核验等合法身份核验场景，调用前须取得被核验人单独授权。

详细介绍

![身份证人像比对接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261109/apiops_faceidcompare__1794169447_59def690a131.png)

姓名、身份证号加一张照片，一次调用核验「人证是否合一」。远程开户、实名注册、在线监考都在回答同一个问题：屏幕前的人是不是证件本人？本接口将人脸照片与公安库身份证头像直接比对，给出权威的同一人结论。

## 接口概述

身份证人像比对接口面向实名认证与风控核验场景：传入被核验人的姓名、18位身份证号码和一张人脸照片（支持 base64 字符串与图片 URL 两种传入方式，系统自动识别），接口将照片与公安库身份证头像进行比对，同步返回百分制相似度分值与是否同一人的结论。响应仅包含分值与结论，不返回原始人脸图片。本接口涉及个人生物特征信息，调用方必须事先取得被核验人的单独授权同意，仅用于实名认证、远程开户、合规风控等合法业务场景，不得用于非法追踪或歧视性用途。

## 核心能力

1. **权威比对**：照片与公安库身份证头像直接比对，结论有权威数据支撑。
2. **双传图方式**：支持 base64 字符串与图片 URL 两种传图方式，自动识别，客户端与服务端接入都方便。
3. **结论直出**：result 字段直接给出 1/0 的同一人判断，业务系统无需自设阈值即可分支处理。
4. **分值可溯**：同时返回百分制相似度分值，便于风控侧按分值分层设置复核策略。
5. **隐私友好**：响应不返回原始人脸图片，减少生物特征信息的二次流转。

## 产品优势

- **接入简单**：三个必填参数、一次 POST 调用完成人证核验，无需自研人脸算法能力。
- **同步实时**：阻塞式调用、同步返回比对结论，适合注册、开户、支付等高时效流程。
- **稳定可靠**：统一错误码与失败原因描述，参数错误、比对异常界限清晰，便于排障。
- **合规支撑**：仅输出分值与结论、不回传原始图片，配合调用侧授权流程满足个人信息保护要求。
- **降本增效**：替代人工证件审核，远程开户、考试核身等高风险环节的审核成本大幅下降。

## 效果展示

一句话理解：它就像证件照查验处的「机器眼」——把你提交的现场照片和公安库里的身份证头像放在一起比对，判断是不是同一个人。

以一次真实调用为例，你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| idcard | 110101199001011237 | 被核验人的18位身份证号码，末位为 X 也支持 |
| name | 张三 | 被核验人姓名，须与身份证号码对应 |
| image | https://example.com/demo/face.jpg | 人脸照片，支持图片 URL 或 base64 字符串，自动识别 |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 相似度分值 | 92.5 | `score`，百分制，越高越相似 |
| 是否同一人 | 1 | `result`，1=同一人，0=非同一人 |
| 结果描述 | 比对通过，为同一人 | `desc`，可直接展示给用户 |

API请求示例：

```
POST /api/v1/faceidcompare
idcard=110101199001011237&name=张三&image=https://example.com/demo/face.jpg
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "score": "92.5",
    "result": "1",
    "desc": "比对通过，为同一人"
  }
}
```

一次调用即完成人证合一判断：业务系统读取 `result` 分支处理即可，`score` 可作为人工复核的参考依据。身份证号格式错误、缺少姓名或照片时返回参数错误提示；上游比对异常时返回非 0 错误码与原因描述。

## 应用场景

以下场景均要求调用方事先取得被核验人的单独授权同意，并限于身份核验、风控等合法用途，不得用于非法追踪、找人定位或歧视性对待：

- **实名认证**：APP 注册、账号实名环节核验操作者身份真实性
- **远程开户**：金融、证券等机构线上开户时的人证合一核验
- **在线考试**：考试登录身份确认，防范替考作弊
- **电子签约**：合同签署前确认签署人身份，增强签约效力
- **门禁核验**：园区、楼宇访客登记时的人证一致性核验

## 应用案例

- **消费金融APP**：借款人提交证件信息与现场照片后，系统自动调用人像比对完成核身，通过者直接进入授信环节，未通过者转人工复核，远程开户审核时效从天级缩短到分钟级。
- **在线考试平台**：每场正式考试开考前要求考生完成人脸比对，配合考中随机抽拍核验，替考行为明显减少，考试成绩的公信力显著提升。
- **园区物业管理**：访客预约登记时比对上传照片与证件信息，核验通过才放行入园，通行效率与安全水平同步提升。

常见问题

Q：这个接口是做什么的？

A：将您提交的人脸照片与公安库中的身份证头像进行比对，返回相似度分值与是否同一人的结论，用于「人证合一」核验，如实名认证、远程开户、在线考试身份确认。

Q：比对分值是什么含义？

A：score 为百分制相似度分值（0-100），分值越高越相似；result 字段直接给出结论：1=同一人，0=非同一人，业务系统按 result 分支处理即可，无需自设阈值。

Q：人脸照片怎么传？

A：image 参数支持两种方式：图片的 base64 编码字符串，或 http/https 可访问的图片 URL，系统自动识别。支持 JPG、PNG 等常见格式，请使用正面免冠、五官清晰的照片以保证比对效果。

Q：接口会返回人脸照片吗？

A：不会。响应中只包含比对分值、结论与结果描述，不返回任何原始人脸图片，降低生物特征信息的二次流转风险。

Q：使用这个接口有哪些合规要求？

A：人脸信息属于个人敏感信息，调用方必须事先取得被核验人的单独授权同意，仅用于实名认证、风控核验等合法场景，不得用于非法追踪、骚扰或任何形式的歧视。

Q：比对失败或参数错误怎么办？

A：身份证号码须为18位（末位可为X），格式错误、缺少姓名或照片时返回参数错误提示；上游比对异常返回非0错误码与原因描述。

人像比对人证核验实名认证人脸核身身份核验合规风控

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

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`idcard`	string	必填	-	身份证号码（18位）
`name`	string	必填	-	姓名
`image`	string	必填	-	人脸照片（base64字符串或图片URL）

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

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`score`	string	比对分值（0-100，越高越匹配），字符串类型；上游未返回分值时为空字符串
`result`	string	比对结果：1=同一人，0=非同一人。以上游返回的判定为准；上游未给出判定时，平台按 score ≥ 60 兜底判定为同一人
`desc`	string	结果描述
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

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

调用失败：

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

请先登录后使用在线测试