文档中心 > 活体检测
活体检测

最近更新时间:2021-08-26

1 功能描述

通过判断视频中人物的张嘴,眨眼,摇头动作与程序要求的是否一致判断视频中的人物是否为活体。

2 请求说明

2.1 请求方式

调用地址:https://apim.unicloud.com/api/face/liveness/1.0.0/

请求方式:POST

返回类型:JSON

2.2 请求参数

Header如下:

参数说明
Content-Typeapplication/json--
AuthorizationBearer参考Token获取

Body如下:

参数是否必选类型可选值范围说明
video_filetruefile--支持AVI、wma、rmvb、rm、mp4格式
detect_typetruestr--参数:"eyes", "mouth", "head"。"eyes"表示"眨眼";"mouth"表示"张嘴";"head"表示"摇头"。

注:Body使用form-data形式

2.3 请求示例

curl -k -H "Authorization:Bearer 2735fbc9-b797-31ad-812c-d8e9e903f6e3" \
    -F "video_file=@eyes.mp4" –F "detect_type=eyes" https://apim.unicloud.com/api/face/liveness/1.0.0/

3 返回说明

3.1 返回参数

字段类型说明
dataobject检测到的人脸数据
+resultbool是否检测到对应动作
codeint返回码(200:接口调用成功,400:文件格式错误或非法数据,500:程序异常退出)
messagestring提示信息

3.2 返回示例

{    
    "data":{        
        "result": true,    
  },    
  "code":200,    
  "message":"success"
}