Skip to content

图片静默活体检测V2.0


接口描述

传入图片进行静默活体检测.

请求说明

HTTP 方法:

POST

请求 URL:

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

Header如下:

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

Body中放置请求参数,参数详情如下:

请求参数:

参数名称必填数据类型长度参数描述
filterTypeint0-1图片质量过滤掩码(打开多个过滤功能,filterType为各过滤数值相加,如打开口罩、遮挡和墨镜过滤,filterType=2+4+8=14)1:人行人脸识别质量标准过滤;2:戴口罩过滤;4:遮挡过滤;8:墨镜过滤
imgString1-3000k图片数据(base64编码),原始图片建议小于3M,格式限定为jpg
busFlowIdString0-64业务流水号,业务系统唯一序列号(对账用,建议传入)

请求示例:

{
    "img":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQ......"
}

返回说明

返回参数:

返回值名称数据类型长度描述
codeint1-8返回结果,0表示成功
messageString1-255返回码描述
dataObject-返回的数据
-isAliveBoolean1活体标签(true:活体;false:非活体)
-confidencefloat2,6置信分
-imageString1-200k最佳人脸图像的人脸框(base64编码)
-attackTypeint4攻击类型(isAlive为false时才返回),详见攻击类型码表
-busFlowIdString1-64业务流水号,业务系统唯一序列号
-flowIdString1-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

是否仍需要帮助? 请保持联络!