智能多媒体服务

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

    光线活体检测

    最近更新时间: 2021-11-23 17:11:53

    接口简介

    七牛光线活体检测接口face-flashlive, 即根据不同光线的数据计算视频中人脸属于活体的分数。

    注意

    • 接口超时时间为 30 秒。
    • 资源的 Mime 文件格式仅支持视频类型:video/mp4。
    • 请求接口为标准的HTTP/HTTPS 协议。
    • 需要配合光线活体sdk使用。

    请求语法

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

    头部信息

    头部名称 必填 说明
    Host 固定为 face-flashlive.qiniuapi.com
    Content-Type 固定为 application/json
    Authorization 该参数应严格按照管理凭证格式进行填充,否则会返回 401 错误码。一个合法的 Authorization 值应类似于:Qiniu QNJi_bYJlmO5LeY08FfoNj9w_r7…

    请求 body

    字段 是否必填 类型 说明
    video_b64 N string base64 编码的视频数据
    video_data N []image json 数组,每个 json 包含 base64 编码的二进制图片数据

    image

    字段 是否必填 类型 说明
    image string base64 编码的二进制图像数据

    返回

    字段 类型 说明
    session_id string 唯一会话 id
    score float 活体分数 [0,100]
    pass_num int 视频中通过的人脸帧数
    face_num int 视频中检测到的人脸帧数
    errorcode int 返回状态码
    errormsg string 返回错误消息

    示例

    POST face-flashlive.qiniuapi.com/flashlive
    HTTP/1.1
    Host: face-flashlive.qiniuapi.com
    		
    Authorization: Qiniu aWQ6lF1Zxxse43jB6V7lsdfaadf:7cWZPxxxxxasdffed60zkI8=
    Content-Type: application/json 	
    {
    	“video_b64”: VIDEO_DATA
    }
    
    

    {
    	“video_data”: [
    		{“image”: IMAGEA_DATA},
    		{“image”: IMAGEB_DATA},
    		{“image”: IMAGEB_DATA},
    		{“image”: IMAGEC_DATA}
    		]
    }
    

    返回示例

    {
    	“score”: 100,
    	“pass_num”: 20,
    	“face_num”: 20,
    	“errorcode”: 0,
    	“errormsg’: “OK”
    }
    

    光线活体检测错误码

    错误码 错误信息 说明
    0 OK 请求成功,无错误
    55060001 ERROR_PARAMETER_INVALID 请求字段有非法传输
    55060002 IMAGE_DECODE_FAILED 图片解码失败
    55060009 VIDEO_INVALID 视频无效
    55060011 VIDEO_FACE_DETECTED_FAILED 视频中人脸检测失败
    55060016 NOT_LIVE_BODY 不是活体
    以上内容是否对您有帮助?
  • Qvm free helper
    Close