功能描述
对提供的一张图像进行基于人脸的活体检测,将检测结果以Json格式返回给调用者。
接口调用
对提供的一张图像进行基于人脸的活体检测,将检测结果以Json格式返回给调用者。
- 请求方法
http://ip:Port/v1/liveness/image?code=PERSON_FACE_IMAGE_CHECKLIVE
- Header参数
Key | Value | 请求或响应 |
---|---|---|
Content-type | application/json | 存在于请求和响应中,不可为空 |
Abis-Request-Sequence | 请求流水号 | 存在于请求和响应中,请求中可以为空,如为空则由服务自动生成一个流水号 |
Authorization | 接口鉴权标识 | 若使用ABIS云平台的接口API,则需要去 ABIS门户控制台-基本资料-鉴权密钥 中获取 立即获取 |
- Body参数
Json Path | 类型 | 必填 | 含义 | 注意事项 |
---|---|---|---|---|
$.image.content | String | 是 | Base64 编码的图像数据 | 需要传入人脸图像 |
对应示例:
{
"content": "SU1BR0U6IEhlbGxvIFdvcmxkCg=="
}
- 返回参数
Json Path | 类型 | 含义 | 注意事项 |
---|---|---|---|
$.reply.result | boolean | 是否为活体 | true:活体 false:非活体 |
$.reply.score | double | 检活分数 | 得分范围 0-100,得分越低表示活体可能性越大 |
$.reply.additional.alg.score | double | 检活分数 | |
$.reply.additional.alg.errCode | String | 检活算法返回的错误码 | |
$.reply.additional.alg.errMsg | String | 检活错误码对应的信息 | |
$.reply.additional.alg.scores | List | 检活原始分数 | |
$.reply.additional.alg.result | int | 检活接口调用是否成功 | 大于等于 0 成功 |
$.reply.additional.quality.checked | boolean | 是否进行图片质量检测 | 根据后台是否开启了图像质量检测 |
$.reply.additional.quality.passed | boolean | 图片质量检测通过 | 质量检测分数>阈值 |
$.reply.additional.quality.threshold | double | 图片质量检测阈值 | 后台配置文件中配置 |
$.reply.additional.quality.score | double | 图片质量检测分数 | 可根据阈值作为参考判断图片质量是否可用与人脸检活 |
$.response.status | String | 状态码; | 2000:正常 |
$.response.content | String | 状态码描述 |
对应示例:
{
"reply": {
"result": true,
"score": 0,
"additional": {
"alg.score": "0.0",
"quality.passed": "true",
"quality.score": "0.0",
"alg.errCode"