智能多媒体服务

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

    防翻拍活体检测

    最近更新时间: 2021-03-29 11:21:26

    接口简介

    七牛防翻拍活体检测接口face-piclive ,即检测单张静态图片中的人脸是否为活体。

    注意

    • 接口超时时间为 30 秒。
    • 资源的 Mime 文件格式仅支持图片类型:image/*,如:image/jpeg、image/png。
    • 请求接口为标准的HTTP/HTTPS 协议。

    API使用

    请求语法

    POST http(s)://face-piclive.qiniuapi.com/picturelive
    Host: face-piclive.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

    字段 是否必填 类型 说明
    frames [ ]frame json 列表,每个 json 包含 base64 编码的二进制图片数据、 相应的 image_id 和图像质量分数A

    frame

    字段 是否必填 类型 说明
    image_b64 string base64 编码的二进制图像数据
    image_id string 图片相应的 image_id
    quality float 图像质量分数

    存储资源使用

    请求语法

    GET <DownloadURI>?face-piclive HTTP/1.1
    Host: <DownloadHost>
    

    返回

    字段 类型 说明
    session_id string 唯一会话 id
    best_frames [ ]best_frame json 列表,每个 json 包含返回图片的 image_id、活体分数和图像质量分数
    errorcode int 返回状态码
    errormsg string 返回错误消息

    best_frame

    字段 类型 说明
    image_id string 图片相应的 image_id
    live_score float 防翻拍活体分数, 取值范围是[0,100]
    quality float 图像质量分数, 取值范围是[0,100]

    示例

    POST face-piclive.qiniuapi.com/picturelive HTTP/1.1
    Host: face-piclive.qiniuapi.com
    		
    Authorization: Qiniu aWQ6lF1Zxxse43jB6V7lsdfaadf:7cWZPxxxxxasdffed60zkI8=
    Content-Type: application/json 
    {
    	frames: [
    	{
        image_b64: "<image_data>",
    		image_id: "<image_id>",
    		quality: 80.0
    	},
    	{
    		image_b64: "<image_data>",
    		image_id: "<image_id>",
    		quality: 90.0
    	},
    	]
    }
    

    返回示例

    {
    "best_frames": [
    	{
    		"image_id": "0", 
    		"live_score": 0,
    		"quality": 80
    	},
    	{
    		"image_id": "1", 
    		"live_score": 0, 
    		"quality": 90
    	}],
    "errorcode": 0,
    "errormsg": "OK",
    "session_id": "20200408090650YcZfT2eMSE"
    }
    

    防翻拍活体检测错误码

    错误码 错误信息 说明
    0 OK 请求成功,无错误
    55060001 ERROR_PARAMETER_INVALID 请求字段有非法传输
    55060002 IMAGE_DECODE_FAILED 图片解码失败
    55060006 FEATURE_EXTRACT_FAILED 人脸特征提取失败
    55060016 NOT_LIVE_BODY 不是活体
    以上内容是否对您有帮助?
  • Qvm free helper
    Close