智能多媒体服务

  • 智能多媒体 > API Reference > 人脸核验 >动作活体检测

    动作活体检测

    最近更新时间:2020-05-22 17:39:59

    接口简介

    七牛动作活体检测接口face-actlive ,基于深度神经网络的活体检测技术,通过人类自然微动作(注视、点头、摇头)分辨出活体并截取现场人脸照片,有效防止伪造照片、视频、人脸面具,抵御人脸伪造攻击。

    注意

    • 接口超时时间为 30 秒。
    • 资源的 Mime 文件格式仅支持 application/json。
    • 请求接口为标准的HTTP/HTTPS 协议。

    请求语法

    POST http(s)://face-actlive.qiniuapi.com/actionlive
    Host: face-actlive.qiniuapi.com
    Content-Type: application/json
    Authorization: QiniuToken
    

    注意: 要在Authorization 头部的AccessToken 前添加 QBox和半角空格。

    头部信息

    头部名称 必填 说明
    Host 固定为 face-piclive.qiniuapi.com
    Content-Type 固定为 application/json
    Authorization 该参数应严格按照管理凭证格式进行填充,否则会返回 401 错误码。一个合法的 Authorization 值应类似于:QBox 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 动作类型无效
    以上内容是否对您有帮助?
  • Icon free helper
    Close