智能多媒体服务 > API 文档 > 人脸核验 >功能接口 >动作活体检测

动作活体检测

最近更新时间: 2022-04-08 17:27:02

接口简介

七牛动作活体检测接口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	视频帧率过低
55060025	ACTION_TYPE_INVALIDY	动作类型无效
55060011	VIDEO_FACE_DETECTED_FAILED	人脸检测失败

以上内容是否对您有帮助？