智能多媒体服务

    • 智能多媒体 > 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 人脸检测失败
    以上内容是否对您有帮助？
    • Qvm free helper
    Close