主题
静默活体检测引擎V2.0
接口描述
传入视频进行视频静默活体检测.
请求说明
HTTP 方法:
POST请求 URL：
/ai-cloud-face/api/liveness/silence/videoHeader如下：
| 参数名称 | 值 |
|---|---|
| Content-Type | application/json;charset=UTF-8 |
Body中放置请求参数，参数详情如下：
请求参数：
请求方式1（推荐使用）:
| 参数名称 | 必填 | 数据类型 | 长度 | 参数描述 |
|---|---|---|---|---|
| action | 否 | int | 0-1 | 动作检测开关(非必填) 0或者不传：不检测动作； 1：眨眼动作检测； |
| filterType | 否 | int | 0-4 | 图片质量过滤掩码(非必填，action为1时才需要控制，action为0时默认四个过滤开关全开)(如果需要打开多个过滤功能，filterType为各自数值相加，如打开口罩、遮挡和墨镜过滤，为2+4+8，即filterType=14)；0或者不传：不过滤；过滤说明：1:人行人脸识别质量标准过滤；2:戴口罩过滤；4:遮挡过滤；8:墨镜过滤 |
| video | 是 | String | 1-20M | 视频的base64编码 |
| busFlowId | 否 | String | 0-64 | 业务流水号，业务系统唯一序列号（对账用，建议传入） |
请求方式2:
| 参数名称 | 必填 | 数据类型 | 长度 | 参数描述 |
|---|---|---|---|---|
| action | 否 | int | 0-1 | 动作检测开关(非必填) 0或者不传：不检测动作； 1：眨眼动作检测； |
| quality | 否 | int | 0-1 | 人脸识别标准过滤开关(非必填，action为1时才需要控制，action为0时默认四个过滤开关全开) 0或者不传:不过滤； 1:过滤； |
| mask | 否 | int | 0-1 | 口罩过滤开关(非必填，action为1时才需要控制，action为0时默认四个过滤开关全开) 0或者不传:不过滤； 1:过滤； |
| occlusion | 否 | int | 0-1 | 遮挡过滤开关(非必填，action为1时才需要控制，action为0时默认四个过滤开关全开) 0或者不传:不过滤； 1:过滤； |
| sunglasses | 否 | int | 0-1 | 墨镜过滤开关(非必填，action为1时才需要控制，action为0时默认四个过滤开关全开) 0或者不传:不过滤； 1:过滤； |
| video | 是 | String | 1-20M | 视频的base64编码 |
| busFlowId | 否 | String | 0-64 | 业务流水号，业务系统唯一序列号（对账用，建议传入） |
请求示例：
{
"video":"AAAAGGZ0eXBtcDQyAAAAAGlzb21tcDQyAAAHFW1vb3YAAABsbXZoZAAAAADjRKK/40SivwAAJx..."
}返回说明
返回参数：
| 返回值名称 | 数据类型 | 长度 | 描述 |
|---|---|---|---|
| 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,
"confidence":0.999962,
"image":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQ......"
},
"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 |
是否仍需要帮助？ 请保持联络！