1. 接口说明

该接口用于对一段短视频进行静默活体检测，判断视频中人脸是否为活体。

2. 接口地址

POST http[s]://api.xfyun.cn/v1/service/v1/image_identify/silent_detection HTTP/1.1
Content-Type:application/x-www-form-urlencoded; charset=utf-8

3. 请求参数

在 Http Request Header 中配置授权认证参数，见【接口描述-授权认证】。其中 X-Param 为各配置参数组成的 JSON 串经 BASE64 编码之后的字符串，原始 JSON 串各字段说明如下：

参数	类型	必须	说明	示例
get_image	bool	否	是否返回base64视频图片。默认值为false,不返回；值为true时，返回	true

X-Param生成示例：

原始JSON串：
{
    "get_image": True,
}
BASE64编码（即X-Param）：
eyJnZXRfaW1hZ2UiOiB0cnVlfQ==

在 Http Request Body 中配置以下参数：

参数	类型	必须	说明
file	string	是	待检测视频，为了保证效果建议视频长度不小于3秒，需要base64编码后进行urlencode，格式包括且不限于.mp4,.avi,.flv,.wmv,.mov,.rm,要求编码后视频大小不超过10M，建议mp4

4. 返回值

返回值为 json 串，各字段如下：

参数	类型	说明
code	string	结果码(具体见错误码)
data	float	检测结果
desc	string	描述
sid	string	会话ID

其中 sid 字段主要用于追查问题，如果出现问题，可以提供 sid 给讯飞技术人员帮助确认问题。

data中结果字段解释说明：

参数	类型	说明
passed	bool	是否通过活体检测
liveness_score	float	静默活体检测得分
image_timestamp	float	视频选帧时间戳
base64_image	string	base64编码后的图片文件流(可选，默认不返回)

注意：

1、如果活体检测不通过，即'passed'为false,image_timestamp和base64_image字段将无意义；

2、活体检测通过情况下，base64_image是否返回由输入参数get_image控制；

3、liveness_score字段为保留字段，返回值不具备参考价值，实际活体检测结果以passed字段值为准。

结果示例如下：

失败结果：

{
    "code": "10106",
    "desc": "invalid parameter|invalid X-Appid",
    "data": 0,
    "sid": "wsr0000bb3f@ch3d5c059d83b3477200"
}

成功结果：

{
"data":{
    "passed":true,
    "liveness_score":0.96,
    "image_timestamp":1534747248,
    "base64_image":""
},
"code":"0",
"desc":"success",
"sid":"wsr00000001@ch36940e324c59000100"
}

5. 调用示例