主题
图片静默活体检测V2.0
接口描述
传入图片进行静默活体检测.
请求说明
HTTP 方法:
POST
请求 URL:
/ai-cloud-face/api/liveness/silence/image
Header如下:
参数名称 | 值 |
---|---|
Content-Type | application/json;charset=UTF-8 |
Body中放置请求参数,参数详情如下:
请求参数:
参数名称 | 必填 | 数据类型 | 长度 | 参数描述 |
---|---|---|---|---|
filterType | 否 | int | 0-1 | 图片质量过滤掩码(打开多个过滤功能,filterType为各过滤数值相加,如打开口罩、遮挡和墨镜过滤,filterType=2+4+8=14)1:人行人脸识别质量标准过滤;2:戴口罩过滤;4:遮挡过滤;8:墨镜过滤 |
img | 是 | String | 1-3000k | 图片数据(base64编码),原始图片建议小于3M,格式限定为jpg |
busFlowId | 否 | String | 0-64 | 业务流水号,业务系统唯一序列号(对账用,建议传入) |
请求示例:
{
"img":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQ......"
}
返回说明
返回参数:
返回值名称 | 数据类型 | 长度 | 描述 |
---|---|---|---|
code | int | 1-8 | 返回结果,0表示成功 |
message | String | 1-255 | 返回码描述 |
data | Object | - | 返回的数据 |
-isAlive | Boolean | 1 | 活体标签(true:活体;false:非活体) |
-confidence | float | 2,6 | 置信分 |
-image | String | 1-200k | 最佳人脸图像的人脸框(base64编码) |
-attackType | int | 4 | 攻击类型(isAlive为false时才返回),详见攻击类型码表 |
-busFlowId | String | 1-64 | 业务流水号,业务系统唯一序列号 |
-flowId | String | 1-64 | 交易流水ID(建议保存) |
返回示例:
{
"code":0,
"data":{
"isAlive":true,
"attackType":5
},
"success":true,
"message":"success"
}
攻击类型码表:
攻击码 | 描述 |
---|---|
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 |
是否仍需要帮助? 请保持联络!