智能多媒体 >
API 文档 >
人脸核验 >
动作活体检测
动作活体检测
最近更新时间:2020-06-10 18:49:30
接口简介
七牛动作活体检测接口face-actlive
,基于深度神经网络的活体检测技术,通过人类自然微动作(注视、点头、摇头)分辨出活体并截取现场人脸照片,有效防止伪造照片、视频、人脸面具,抵御人脸伪造攻击。
注意
- 接口超时时间为 30 秒。
- 资源的 Mime 文件格式仅支持视频类型:video/mp4。
- 请求接口为标准的HTTP/HTTPS 协议。
请求语法
POST http(s)://face-actlive.qiniuapi.com/actionlive
Host: face-actlive.qiniuapi.com
Content-Type: application/json
Authorization: QiniuToken
头部信息
头部名称 |
必填 |
说明 |
Host |
是 |
固定为 face-piclive.qiniuapi.com |
Content-Type |
是 |
固定为 application/json |
Authorization |
是 |
该参数应严格按照管理凭证格式进行填充,否则会返回 401 错误码。一个合法的 Authorization 值应类似于:Qiniu QNJi_bYJlmO5LeY08FfoNj9w_r7... |
请求 body
字段 |
是否必填 |
类型 |
说明 |
video_b64 |
是 |
string |
base64 编码的二进制视频数据,视频编码格式为 h264 或 mp4 |
video_type |
是 |
int |
视频格式,1 表示 mp4, 2 表示 h264,默认值为 1 |
action_types |
是 |
list |
动作的标示字符串列表,nod 表示点头,shake 表示摇头, blink 表示眨眼,mouth 表示张嘴 |
返回
字段 |
类型 |
说明 |
session_id |
string |
唯一会话 id |
live_status |
int |
返回动作活体状态码,1 表示通过,0 表示不通过 |
best_frames |
list |
最优帧列表,列表中每个元素格式是 json,包括 base64 编码的二进制图片数据和图像质量分数 |
errorcode |
int |
返回状态码 |
errormsg |
string |
返回错误消息 |
best_frame
字段 |
类型 |
说明 |
image_b64 |
string |
base64 编码的二进制图像数据 |
quality |
float |
图像质量分数, 取值范围是[0,100] |
示例
POST face-actlive.qiniuapi.com/actionlive
HTTP/1.1
Host: face-actlive.qiniuapi.com
Authorization: Qiniu aWQ6lF1Zxxse43jB6V7lsdfaadf:7cWZPxxxxxasdffed60zkI8=
Content-Type: application/json
{
“video_b64”: VIDEO_DATA, “video_type”: 1,
“action_types”: [“node”, “shake”] }
}
返回示例
{
“live_status”: 1,
“errorcode”: 0,
“errormsg’: “OK”,
“best_frames”: [
{“image_b64”: IMAGE_DATA, “quality”:100},
{“image_b64”: IMAGE_DATA,“quality”:90},
{“image_b64”: IMAGE_DATA, “quality”:80}
]
}
动作活体检测错误码
错误码 |
错误信息 |
说明 |
0 |
OK |
请求成功,无错误 |
55060001 |
ERROR_PARAMETER_INVALID |
请求字段有非法传输 |
55060002 |
IMAGE_DECODE_FAILED |
图片解码失败 |
55060012 |
ACTION_NODE_DETECTED_FAILED |
点头动作检测失败 |
55060013 |
ACTION_SHAKE_DETECTED_FAILED |
摇头动作检测失败 |
55060014 |
ACTION_BLINK_DETECTED_FAILED |
眨眼动作检测失败 |
55060015 |
ACTION_MOUTH_DETECTED_FAILED |
张嘴动作检测失败 |
55060016 |
NOT_LIVE_BODY |
不是活体 |
55060024 |
VIDEO_FPS_IS_TOO_FEW |
视频帧率过低 |
55060016 |
ACTION_TYPE_INVALIDY |
动作类型无效 |