本文介绍视频活体检测DetectVideoLivingFace的语法及示例。
功能描述
视频活体检测能力可以检测输入视频中的人脸来自直接拍摄还是翻拍。当视频中出现多个人脸时,对画面中面积最大的人脸进行判断,需要确保待检测人脸五官清晰可见。
前提条件
说明 本能力仅限企业认证用户开通。更多实名认证操作信息,请参见实名认证。
输入限制
- 视频格式:MP4、AVI。
- 视频大小:不超过30 MB。
- 视频分辨率:大于64×64像素以上,视频长度大于3秒。其中人脸尺寸建议大于64×64像素。
- URL地址中不能包含中文字符。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DetectVideoLivingFace |
系统规定参数。取值:DetectVideoLivingFace。 |
VideoUrl | String | 是 | http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectVideoLivingFace/DetectVideoLivingFace1.mp4 |
输入待检测人脸的视频URL。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 8E92F28B-F889-48CB-9FCC-3207CFA2215E |
请求ID。 |
Data | Object |
返回的结果数据内容。 |
|
Elements | Array of Element |
检测结果数据。 |
|
Rect | Array of Integer | [374, 6, 493,106 ] |
检测出的人脸位置。 |
LiveConfidence | Float | 0.72464925050735474 |
活体的置信度,取值范围为0~1。 |
FaceConfidence | Float | 0.84644949436187744 |
人脸的置信度,取值范围为0~1。 |
示例
请求示例
http(s)://[Endpoint]/?Action=DetectVideoLivingFace
&VideoUrl=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectVideoLivingFace/DetectVideoLivingFace1.mp4
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<RequestId>8E92F28B-F889-48CB-9FCC-3207CFA2215E</RequestId>
<Data>
<Elements>
<FaceConfidence>0.84644949436187744</FaceConfidence>
<Rect>374</Rect>
<Rect>6</Rect>
<Rect>493</Rect>
<Rect>106</Rect>
<LiveConfidence>0.72464925050735474</LiveConfidence>
</Elements>
</Data>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "8E92F28B-F889-48CB-9FCC-3207CFA2215E",
"Data" : {
"Elements" : [ {
"FaceConfidence" : "0.84644949436187744",
"Rect" : [ 374, 6, 493, 106 ],
"LiveConfidence" : "0.72464925050735474"
} ]
}
}
错误码
关于视频活体检测的错误码,详情请参见常见错误码。
SDK参考
阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。
安全声明
- 请确保上传的图片或文件来源符合相应的法律法规。
- 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。