光线活体检测
接口简介
七牛光线活体检测接口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 | 不是活体 |
文档反馈
(如有产品使用问题,请 提交工单)