人脸识别API
说明 用于对用户上传的静态图片进行人脸活体检测。与动态活体检测的区别是:静态活体检测中,用户不需要通过唇语或摇头眨眼等动作来识别。 静态活体检测适用于手机自拍的场景,或对防攻击要求不高的场景。如果对活体检测有更高安全性要求,请使用人脸核身·云智慧眼产品。 图片的宽高比请接近3:4,不符合宽高比的图片返回的分值不具备参考意义。本接口适用于类手机自拍场景,非类手机自拍照返回的分值不具备参考意义。
HTTP头信息
参数 | 内容 |
---|---|
Accept | application/json;charset=utf-8; |
Content-Type | application/json;charset=utf-8; |
请求
URL: https://api.moziapi.com/ai/faceid
请求方式: POST
请求参数
参数 | 类型 | 最大长度 | 是否必填 | 说明 |
---|---|---|---|---|
imgData | String | 不限 | 是 | 图片 base64 数据(图片的宽高比请接近3:4,不符合宽高比的图片返回的分值不具备参考意义)。 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。 |
参数示例
{
"imgData": "WdCI34354f"
}
响应结果
参数 | 类型 | 最大长度 | 是否必填 | 说明 |
---|---|---|---|---|
Response | Object | 是 | ||
- RequestId | String | 是 | 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 | |
- Score | Number | 是 | 活体打分,取值范围 [0,100],分数一般落于[80, 100]区间内,0分也为常见值。推荐相大于 87 时可判断为活体。可根据具体场景自行调整阈值。 | |
remark | String | 否 | 返回说明 | |
ret_code | Number | 是 | 返回标识,0为成功,其余为失败 |
json返回正确参数示例
{
"showapi_res_error": "",
"showapi_res_id": "9dc36661517648a290968e96e32f93e0",
"showapi_res_code": 0,
"showapi_res_body": {
"Response": {
"RequestId": "8770afe8-b94a-45de-9e38-71d89c1d9d9f",
"Score": 100
},
"remark": "查询成功!",
"ret_code": 0
}
}