Skip to content

H5动作活体(视频文件)


接口描述

根据传入的视频,进行视频内活体的动作检测.

请求说明

HTTP 方法:

POST

请求 URL:

/ai-cloud-face/liveness/action/video

Header如下:

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

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

请求参数:

参数名称必填数据类型长度参数描述
actionint11 为眨眼,2 为张嘴,5 为转头,如传1,2,5 按照顺序先检测眨眼再张嘴再转头,传2,1,5 按照顺序先检测张嘴再检测眨眼再转头
videoString1-20M视频的base64编码
deviceTypeint0-1设备信息: 0 未知,1 android,2 ios,3 windows
thresholdsString0-32策略等级 默认使用 medium.txt
filterTypeint0-4图片质量过滤掩码,打开多个过滤功能,filterType 为各过滤数值相加,如打开口罩、遮挡和墨镜过滤,filterType=2+4+8=14);1:人行人脸识别质量标准过滤;2:戴口罩过滤;4:遮挡过滤;8:墨镜过滤;16:confidence 0.35 过滤;32:best_score 0.3 过滤;64:质量分过滤
busFlowIdString0-64业务流水号,业务系统唯一序列号(对账用,建议传入)

请求示例:

{
    "action":"1",
    "video":"AAAAGGZ0eXBtcDQyAAAAAGlzb21tcDQyAAAHFW1vb3YAAABsbXZoZAAAAADjRKK/40SivwAAJx..."
}

返回说明

返回参数:

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

返回示例:

{
    "message": "success",
    "code": 0,
    "success": true,
    "data": {
        "isAlive": true,
        "confidence": 0.996242,
        "image": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQ......"
    }
}

攻击类型码表:

攻击码描述
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