## 接口简介用于将自身客户端传入的参数透传至火山引擎服务端完成认证，如果你有业务服务端直接获取认证结果的需求，可以参考以下接口。 ## 限制条件 1. QPS不得超过10。如有确切需求需要扩容QPS，请联系我们。 ## 请求说明 |名称 |内容 | |---|---| |接口地址 |https://visual.volcengineapi.com?Action=CertVerify&Version=2022\-08\-31 | |请求方式 |POST | |Content\-Type |application/json | ### **请求参数** 公共请求参数请参考[调用方法](./1660357) **Body请求参数** 业务请求参数 |字段名 |类型 |必选/可选 |说明 |备注 | |---|---|---|---|---| |req_key |string |必选 |有源比对填写`cert_pro_src_verify`，无源比对填写`cert_pro_no_src_verify` | | |byted_token |string |必选 |本次核验的唯一token | | |sdk_data |string |必选（与video_key二选一） |客户端上数据直接透传即可，以SDK形式接入时必传 | | |video_key |string |必选（与sdk_data二选一） |客户端上数据直接透传即可，以H5形式接入时必传 | | |risk_info |string |必选 |客户端上数据直接透传即可 | | |extra |json |在H5接入场景下必选 |客户端上数据直接透传即可 | | ## 输出说明 **（1）通用输出参数** 请参考[通用返回字段及错误码](https://www.volcengine.com/docs/6444/69728) **（2）业务输出参数** data 字段说明 |字段名 |类型 |必选/可选 |说明 |备注 | |---|---|---|---|---| |result |bool |必选 |是否核验通过 | | |risk_result |json string |必选 |风控接口返回结果的json编码字符串，详细内容见下文 | | |images |json |必选 |客户端采集的人脸图 | | |source_comp_details |json |必选 |认证结果的细节信息，包括比对的分数和阈值，比对图片的各维度得分，活体算法通过情况，详见下文说明 | | |algorithm_base_resp |json |可选 |子错误说明，可以进一步区分错误原因，部分服务异常情况时无法返回。详细见：[错误码和计费说明](./1660363) | | |req_measure_info |bool |可选 |计费说明，部分服务异常情况时无法返回。详细见：[错误码和计费说明](./1660363) | | **risk_result说明** |字段名 |类型 |必选/可选 |说明 |备注 | |---|---|---|---|---| |score |int |必选 |风控分数 |取值见[风控分数与返回码](./1660362) | |tags |array of string |必选 |风险归因列表 |取值见[风控分数与返回码](./1660362) | **images说明** |字段名 |类型 |必选/可选 |说明 |备注 | |---|---|---|---|---| |image_best |string |必选 |人脸图的base64 | | |image_env |string |必选 |环境图的base64 | | **source_comp_details说明** |字段名 |类型 |必选/可选 |说明 |备注 | |---|---|---|---|---| |score |float64 |必选 |比对分数 | | |thresholds |json |必选 |比对分数阈值 | | |image_face_detail |json string |必选 |人脸图质量得分的json编码字符串，具体内容见下文 | | |image_env_detail |json string |必选 |环境图质量得分的json编码字符串 | | |alive |bool |必选 |活体算法是否通过 |活体认证成功为`true`，无论认证是否失败 | **thresholds说明** |字段名 |类型 |必选/可选 |说明 |备注 | |---|---|---|---|---| |1e\-3 |float64 |必选 |0.1%置信度阈值 | | |1e\-4 |float64 |必选 |0.01%置信度阈值 |此值为判断是否通过的标准 | |1e\-5 |float64 |必选 |0.001%置信度阈值 | | |1e\-6 |float64 |必选 |0.0001%置信度阈值 | | **image_face_detail说明** 人脸图质量得分 |字段名 |类型 |必选/可选 |说明 |备注 | |---|---|---|---|---| |comprehensive_score |float64 |必选 |人脸综合得分，用于评估图片中人脸质量的综合分数 |`0-100`之间，`50`以上质量较高 | |face_clarity |float64 |必选 |人脸清晰度 |`0-5`，`3`以上比较清晰 | |brightness |float64 |必选 |人脸亮度 |`0-1`，小于`0.08`可判定为昏暗 | |exposure |float64 |必选 |人脸区域曝光度 |通常为`0`，大于`0.6`可判定为有过曝光现象 | |pose_pitch |float64 |必选 |俯仰角，代表人脸的上下偏移程度，一般指人在点头时变化的角度 | | |pose_yaw |float64 |必选 |偏航角，代表人脸左右偏移的程度，一般指人在摇头时变化的角度 | | |pose_roll |float64 |必选 |旋转角，代表人歪头时变化的角度 | | |mouth_occlude |float64 |必选 |嘴巴遮挡程度，得分越高遮挡越严重 |`0-1` | |left_eye_occlude |float64 |必选 |左眼遮挡程度，得分越高遮挡越严重 |`0-1` | |right_eye_occlude |float64 |必选 |右眼遮挡程度，得分越高遮挡越严重 |`0-1` | |have_cap |float64 |必选 |是否佩戴帽子，得分越高概率越大 |`0-1` | **image_env_detail说明** 环境图质量得分，各项内容同`image_face_detail` **（3）输出示例** ```Plain { "code":10000, "data":{ "result": false, "risk_result": '{"score":600,"tags":["14004","13001"]}', "images": { "image_best": "", "image_env": "" }, "source_comp_details": { "alive": true, "image_env_detail": '{"comprehensive_score":72.7593973238521,"face_clarity":3.6389399293661118,"exposure":0,"brightness":0.9492753623188406,"pose_pitch":-0.53,"pose_yaw":0.405,"pose_roll":0.388,"mouth_occlude":0.000026744861315819435,"left_eye_occlude":0.000018301761883776635,"right_eye_occlude":0.0026939630042761564,"have_cap":0.00002657439654285554}', 'image_face_detail': '{"comprehensive_score":72.7593973238521,"face_clarity":3.6389399293661118,"exposure":0,"brightness":0.9492753623188406,"pose_pitch":-0.53,"pose_yaw":0.405,"pose_roll":0.388,"mouth_occlude":0.000026744861315819435,"left_eye_occlude":0.000018301761883776635,"right_eye_occlude":0.0026939630042761564,"have_cap":0.00002657439654285554}', "score": 87.69, "thresholds": { "1e-3": 60, "1e-4": 70, "1e-5": 80, "1e-6": 90 } }, "algorithm_base_resp": { "status_code": 0, "status_message": "" }, "req_measure_info": { "measure_type": "query_num", "value": 1 } }, "message":"Success", "request_id":"6838889517957515275", "time_elapsed":"41.897331ms" } ``` ## 错误码 **（1）通用错误码** 请参考[错误码和计费](https://www.volcengine.com/docs/86081/1660363?lang=zh) **（2）业务错误码** |HttpCode |错误码 |错误消息 |描述 | |---|---|---|---| |200 |10000 |"Success" |成功 | |400 |50215 |"RPCProcess: xxx" |由于输入的图片、视频、参数等不满足要求，导致认证失败或不通过。此时需要参考上方algorithm_base_resp子错误码。 |

图像生成大模型