## 接口简介身份认证（有源认证）纯API接入，不调用活体检测、ocr等算法能力，只上传姓名、身份证号、人脸图信息，直接请求数据源验证是否为本人 ## 限制条件 1. QPS不得超过10。如有确切需求需要扩容QPS，请联系我们。 ## 请求说明 |名称 |内容 | |---|---| |接口地址 |[https://visual.volcengineapi.com](https://visual.volcengineapi.com/)?Action=CertSrcFaceComp&Version=2022\-08\-31 | |请求方式 |POST | |Content\-Type |application/json | ### **请求参数** 公共请求参数请参考[调用方法](https://www.volcengine.com/docs/86081/1660357) **Body请求参数** 业务请求参数 |字段名 |类型 |必选/可选 |说明 |备注 | |---|---|---|---|---| |req_key |string |必选 |此处请填写`cert_src_face_comp` | | |idcard_name |string |在有源比对时必选 |身份证姓名 | | |idcard_no |string |在有源比对时必选 |身份证号 | | |image |string |必选 |人脸图 |人脸图Base64，不带mime前缀 | ## 输出说明 **（1）通用输出参数** 请参考[通用返回字段及错误码](https://www.volcengine.com/docs/6444/69728) **（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）输出示例** ```Plain { "code": 10000, "data": { "algorithm_base_resp": { "status_code": 0, "status_message": "SUCCESS" }, "binary_data_base64": [], "byted_token": "20230402111924116A47A3C09337C67B64", "req_measure_info": { "measure_type": "query_num", "value": 1 }, "result": true, "source_comp_details": { "score": 92.709, "thresholds": { "1e-3": 60, "1e-4": 70, "1e-5": 80, "1e-6": 90 } } }, "message": "Success", "request_id": "20230402111924116A47A3C09337C67B64", "status": 10000, "time_elapsed": "269.784086ms" } ``` ## 错误码 ### 通用错误码请参考[通用返回字段及错误码](https://www.volcengine.com/docs/6444/69728) ### 业务错误码 #### 子错误码及计费说明此处列举了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为计费。 | |

图像生成大模型