文档中心

图像生成大模型

纯API接入(人像三要素)

纯API接入(三要素)

纯API接入(三要素)

接口简介

身份认证（有源认证）纯API接入，不调用活体检测、ocr等算法能力，只上传姓名、身份证号、人脸图信息，直接请求数据源验证是否为本人

限制条件

QPS不得超过10。如有确切需求需要扩容QPS，请联系我们。

请求说明

名称	内容
接口地址	https://visual.volcengineapi.com?Action=CertSrcFaceComp&Version=2022-08-31
请求方式	POST
Content-Type	application/json

请求参数

公共请求参数请参考调用方法

Body请求参数

业务请求参数

字段名	类型	必选/可选	说明	备注
req_key	string	必选	此处请填写cert_src_face_comp
idcard_name	string	在有源比对时必选	身份证姓名
idcard_no	string	在有源比对时必选	身份证号
image	string	必选	人脸图	人脸图Base64，不带mime前缀

输出说明

（1）通用输出参数

请参考通用返回字段及错误码

（2）业务输出参数

data 字段说明

字段名	类型	必选/可选	说明	备注
byted_token	string	必选	本次人脸核身的唯一token
result	bool	必选	是否核验通过
source_comp_details	json	必选	认证的分数和阈值
algorithm_base_resp	json	可选	子错误说明，可以进一步区分错误原因，部分服务异常情况时无法返回。详见下方业务错误码子错误码
req_measure_info	bool	可选	计费说明，部分服务异常情况时无法返回。详见下方业务错误码计费说明

source_comp_details说明

字段名	类型	必选/可选	说明	备注
score	float64	必选	有源比对分数
thresholds	json	必选	有源比对分数阈值

thresholds说明

字段名	类型	必选/可选	说明	备注
1e-3	float64	必选	0.1%置信度阈值
1e-4	float64	必选	0.01%置信度阈值	此值为判断是否通过的标准
1e-5	float64	必选	0.001%置信度阈值
1e-6	float64	必选	0.0001%置信度阈值

（3）输出示例

错误码

通用错误码

请参考通用返回字段及错误码

业务错误码

子错误码及计费说明

此处列举了algorithm_base_resp的字段结构和不同取值含义，同时也标注了哪些错误码会被实际计费。

对于计费，如果不关注细节，也可以直接参考req_measure_info字段查看计费信息。

字段结构

字段名	类型	必选/可选	说明	备注
algorithm_base_resp	json	必选	子错误说明。

algorithm_base_resp

字段名	类型	必选/可选	说明	备注
status_code	int	必选	子错误码
status_message	string	必选	子错误描述

子错误码

错误码(code)	认证子错误码(algorithm_base_resp)	认证子错误说明	是否计费
10000	0	认证一致	是
50500	100000	服务内部错误
50501	100001	数据源内部错误
50201	201201	缺少输入参数或输入参数为空
50200	201202	输入参数不合法
50206	201301	输入图片为空
50207	201302	输入图片解码失败
50207	201304	输入图片无法处理
60102	203101	输入图片未检测到人脸
50215	210101	输入认证字段不合格（空、不合法等）
50215	210102	输入认证字段查询不到结果
50215	210201	身份证号为空
50215	210202	身份证号无效或不符合规范
50215	210203	姓名为空
50215	210204	姓名不符合规则
50215	210205	身份证查询无结果
50215	210207	认证不一致，姓名与身份证号不匹配
50215	210301	人脸图格式不支持
50215	210302	人脸图质量不合格/已损坏
50215	210303	人脸图大小过小
50215	210304	人脸图为空
50215	210305	人脸图中未检测到人脸
50215	210306	人脸图中存在多个人脸
50215	210307	人脸图特征提取失败
50215	210308	数据源库中的底图质量不合格
50215	210309	数据源库中无该身份信息对应的底图
50215	210310	人脸图尺寸过大
50215	210311	人脸图不匹配	是
50215	210313	认证不一致，疑似本人	是
50215	210314	认证不一致,待对比图像建模失败	是

计费(req_measure_info)说明

标识此请求是否计费。

字段结构

字段名	类型	必选/可选	说明	备注
req_measure_info	json	必选	计费说明。

req_measure_info

字段名	类型	必选/可选	说明	备注
measure_type	string	必选	取值固定为"query_num"
value	int	必选	取值为0或1。0为不计费，1为计费。

最近更新时间：2026.09.07 20:29:48

这个页面对您有帮助吗？

有用

有用

无用

无用