静默活体检测引擎V2.0


接口描述

传入视频进行视频静默活体检测

请求说明

HTTP 方法:

POST

请求 URL:

/ai-cloud-face/api/liveness/silence/video

Header如下:

参数名称
Content-Type application/json;charset=UTF-8

请求说明

请求参数

请求方式1(推荐使用):

参数名称 数据类型 参数描述
appKey String 应用生成的appkey
sign String 签名
nonceStr String 随机字符串
video String 视频数据(base64编码)
action可选 int 动作检测开关(非必填) 0或者不传:不检测动作; 1:眨眼动作检测;
filterType可选 int 图片质量过滤掩码(非必填,action为1时才需要控制,action为0时默认四个过滤开关全开)(如果需要打开多个过滤功能,filterType为各自数值相加,如打开口罩、遮挡和墨镜过滤,为2+4+8,即filterType=14);0或者不传:不过滤;
过滤说明:1:人行人脸识别质量标准过滤;2:戴口罩过滤;4:遮挡过滤;8:墨镜过滤

请求方式2:

参数名称 数据类型 参数描述
appKey String 应用生成的appkey
sign String 签名
nonceStr String 随机字符串
video String 视频数据(base64编码)
action可选 int 动作检测开关(非必填) 0或者不传:不检测动作; 1:眨眼动作检测;
quality可选 int 人脸识别标准过滤开关(非必填,action为1时才需要控制,action为0时默认四个过滤开关全开) 0或者不传:不过滤; 1:过滤;
mask可选 int 口罩过滤开关(非必填,action为1时才需要控制,action为0时默认四个过滤开关全开) 0或者不传:不过滤; 1:过滤;
occlusion可选 int 遮挡过滤开关(非必填,action为1时才需要控制,action为0时默认四个过滤开关全开) 0或者不传:不过滤; 1:过滤;
sunglasses可选 int 墨镜过滤开关(非必填,action为1时才需要控制,action为0时默认四个过滤开关全开) 0或者不传:不过滤; 1:过滤;

返回说明

返回参数:

参数名称 类型 参数描述
code int 返回结果,0表示成功,非0为对应错误号
success Boolean 是否成功
message String 返回描述
isAlive Boolean 活体标签(true:活体;false:非活体)
image String 最佳人脸图像的人脸框(base64编码)
confidence float 置信分
attackType int 攻击类型(isAlive为false时才返回) 2:判断为扣眼攻击; 3:判断为扣嘴攻击; 4:判断为半张脸攻击; 5:判断为视频回放攻击; 6:判断为黑白图片; 7:判断为纸面攻击; 8:判断为边框(包括纸面、手机等边框); 9:判断为摩尔纹攻击; 10:判断为脸优攻击; 11:判断为纸面攻击(光流); 12:判断为面具攻击; 16:判断动作活体检测失败; 20:判断为不满足人行人脸识别图片质量要求; 21:判断为戴口罩/遮挡或者墨镜; 22:判断为未检测到人脸;23:人脸检测或质量分或活体分模块运行异常;50:判断为合成图像攻击;51:判断为合成图像攻击;52:判断为黑产软件攻击;53:判断为T型面具攻击;54:判断为黑白照片;55:判断为模糊图片;56:补充攻击模型1;57:补充攻击模型2;58:补充攻击模型3;59:补充攻击模型4

返回示例:

{
    "code":0,
    "data":{
        "isAlive":true,
        "confidence":0.999962,
        "image":"图片BASE64编码"
    },
    "success":true,
    "message":"success"
}
是否仍需要帮助? 请保持联络!
最后更新于 23rd Apr 2024