加载接口文档…
人像三要素核验
API将「真实姓名 + 身份证号 + 人脸照片」与公安库身份证头像做 1:1 比对，返回是否一致及相似度。适用于实名认证、开户核身等场景。请在取得被核验人授权后调用。
由 APISpace 提供·更新于 2 天前
16
累计调用
134ms
平均响应
100.00%
服务可用性
访问限制
查看更多方案 →
接入文档
在线工具
接口请求地址
https://v1.apizero.cn/api/idcard-face-3c
接口请求方式
POST
请求参数格式
APPLICATION/JSON
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/idcard-face-3c
接口信息备注
须携带 API Key；登录后无每日免费，按套餐或按次计费；黄金会员不享受免费额度；钻石会员不享受免费额度；企业会员不享受免费额度。批量查询请控制在每秒 3 次以内。
请求参数说明
namestring
必填 · 真实姓名（中文），兼容别名 realname · 示例：张三
idcardstring
必填 · 18 位身份证号（末位可为 X），兼容别名 id_card · 示例：11010519491231002X
image（图片）string
必填 · 人脸照片 base64（可带 data URL 前缀），兼容别名 face_image · 示例：data:image/jpeg;base64,...
| 名称 | 类型 | 说明 |
|---|---|---|
| name | string | 必填 · 真实姓名（中文），兼容别名 realname · 示例：张三 |
| idcard | string | 必填 · 18 位身份证号（末位可为 X），兼容别名 id_card · 示例：11010519491231002X |
| image（图片） | string | 必填 · 人脸照片 base64（可带 data URL 前缀），兼容别名 face_image · 示例：data:image/jpeg;base64,... |
请求头说明
Authorizationstring
必填 · 必填鉴权。推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。付费接口需携带有效 Key。
Content-Typestring
可选 · 也支持 application/json
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 必填 · 必填鉴权。推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。付费接口需携带有效 Key。 |
| Content-Type | string | 可选 · 也支持 application/json |
返回字段说明
namestring
回显的姓名
idcardstring
脱敏后的身份证号
validboolean
是否一致：true=一致
scorenumber
人脸相似度（有则返回）
result_codenumber
100=一致 101=不一致
messagestring
结果描述
faceboolean
固定 true，表示走人像三要素
tipsstring
品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn
| 名称 | 类型 | 说明 |
|---|---|---|
| name | string | 回显的姓名 |
| idcard | string | 脱敏后的身份证号 |
| valid | boolean | 是否一致：true=一致 |
| score | number | 人脸相似度（有则返回） |
| result_code | number | 100=一致 101=不一致 |
| message | string | 结果描述 |
| face | boolean | 固定 true，表示走人像三要素 |
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn |
免责声明
仅返回是否一致与相似度，不返回额外户籍信息；身份证号在响应中脱敏。须取得被核验人授权。