/liveness/check_silent_liveness

1.接口描述

对用户拍摄的视频进行静默活体检测

请求方式

POST

请求 URL

https://cloudapi.linkface.cn/liveness/check_silent_liveness

2.请求参数

字段 类型 必需 描述
api_id string API 账户
api_secret string API 密钥
video_file file 待检查的活体视频文件,上传本地文件进行检测时选取此参数
return_image boolean 是否返回提取的base64编码特征图片,默认不返
  • 视频大小最大15M,视频格式建议MP4

3.返回参数

正常响应

字段 类型 说明
request_id string 本次请求的id
status string 状态,正常为 OK
liveness_score object 活体检测得分,仅供参考
passed bool 是否通过活体检测
feature_image_id string 从活体视频中提取的一张特征照片,请调用liveness/liveness_image接口获取图片, 服务器仅保留该图片一小时,请及时保存图片。
base64_feature_image string base64编码后的特征图片文件流(可选,默认不返回)。

返回样例

{
  "request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e",
  "status": "OK",
  "passed": true,
  "liveness_score": 0.133746067343,
  "feature_image_id": "xxxxxx",
  "base64_feature_image": "xxxxxx"
}

4.错误码

状态码 status 字段 说明
400 DOWNLOAD_TIMEOUT 网络地址视频获取超时
400 DOWNLOAD_ERROR 网络地址视频获取失败
400 INVALID_ARGUMENT 请求参数错误,具体原因见 reason 字段内容
400 WRONG_LIVENESS_DATA liveness_data 出错
401 UNAUTHORIZED 账号或密钥错误
401 KEY_EXPIRED 账号过期,具体情况见 reason 字段内容
403 RATE_LIMIT_EXCEEDED 调用频率超出限额
403 NO_PERMISSION 无调用权限
404 NOT_FOUND 请求路径错误
500 INTERNAL_ERROR 服务器内部错误

返回样例

{
   "status": "INVALID_ARGUMENT",
   "reason": "must specify 'video_file' argument",
   "request_id": "TIDa892b593c0354b0e989b5db67a331607"
}

5.输入示例

  • cURL样例
curl -X POST "https://cloudapi.linkface.cn/liveness/check_silent_liveness?api_id=ID&api_secret=SECRET" \
  -F video_file =@/PATH/TO/IMAGE

results matching ""

    No results matching ""