本文为您介绍人脸活体检测DetectLivingFace的语法及示例。
功能描述
人脸活体检测能力可以检测图片中的活体对象(主要是人脸)来自直接拍摄或者是翻拍。活体判断的前置条件是图像中有人脸。
应用场景
系统人脸登录防攻击:通过检测上传的图像是否是真人,而非翻拍照片,以防止攻击者登录系统。
前提条件
输入限制
- 图像格式:PNG、JPG、JPEG、BMP、GIF、WEBP。
- 图像大小:不超过10MB。如您有大图需求,请提工单进行调整。
- 图像分辨率:建议大于256×256,像素过低可能会影响识别效果。
- URL地址中不能包含中文字符。
检测说明
- 最长检测时间是6秒,如果在该时间内没有完成检测,系统会强制返回超时错误码。
- 图像下载时间限制为3秒,如果下载时间超过3秒,系统会返回下载超时。
- 图像检测接口响应时间依赖图像的下载时间。请保证被检测图像所在的存储服务稳定可靠,建议您使用阿里云OSS存储或者CDN缓存。
- 最多可检测10张图像。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DetectLivingFace |
要执行的操作。取值:DetectLivingFace。 |
Tasks.N.ImageURL | String | 否 | https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/facebody/RecognizeBodyCount/149e4c0998ea6268938577ff98a0f497.jpg |
待检测的图像URL地址。JSON数组中的每个元素是一个图片检测任务结构体(image表)。最多支持10个元素,即同时最多对10张图片进行检测。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL。 说明 对于该接口,系统会自动将OSS链接地址转成内网地址然后再下载文件,所以调用该接口并不会产生OSS流量计费。
|
Tasks.N.ImageData | String | 否 | 9j/4AAQSkZJRgABAQAAAQABAAD/2**** |
图像Base64编码字符串。当与URL方式共存时,URL方式优先。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Data | Struct |
返回的结果数据内容。 |
|
Elements | Array of Element |
返回的元素。 |
|
ImageURL | String | https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/facebody/RecognizeBodyCount/149e4c0998ea6268938577ff98a0f497.jpg |
对应请求中的图像URL地址。 |
Results | Array of Result |
返回结果。调用成功时返回结果中包含一个或多个元素。 |
|
Frames | Array of Frame |
输入图像为长图(长宽比大于 3:1 )时,会把原图截成几张正常比例的图,frames保存从图像中裁剪出来的而且是翻拍命中的截图。 |
|
Rate | Float | 84.83 |
结果为该分类的概率,取值范围为 |
Url | String | http://aligreen-shanghai.oss-cn-shanghai.aliyuncs.com/prod/hammal/26210da42/28118541_TB1urBOQFXXXXbMXFXXXXXXXXXX-1442-257.png?Expires=1582703593&OSSAccessKeyId=H4sp5QfNbuDg****&Signature=%2B8iUkb5YjomYR8ujV2c8wMAavs****&x-oss-process=image%2Fcrop%2Cx_0%2Cw_288%2Fauto-orient%2C0 |
命中的截图。 |
Label | String | liveness |
检测结果的分类,取值包括:
|
Rate | Float | 76.22 |
结果为该分类的概率,取值范围为 |
Suggestion | String | review |
建议您执行的操作,取值范围如下:
|
TaskId | String | img5GI4bP3sHdq7gRg$6Ccqh4-1u7Ldl |
该检测任务的ID。 |
RequestId | String | 155027BB-E1D1-494F-8C24-6C5A69EFF39A |
请求ID。 |
示例
请求示例
http(s)://facebody.cn-shanghai.aliyuncs.com/?Action=DetectLivingFace
&Tasks.1.ImageURL=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/facebody/RecognizeBodyCount/149e4c0998ea6268938577ff98a0f497.jpg
&<公共请求参数>
正常返回示例
XML
格式
<RequestId>155027BB-E1D1-494F-8C24-6C5A69EFF39A</RequestId>
<Data>
<Elements>
<TaskId>img5GI4bP3sHdq7gRg$6Ccqh4-1u7Ldl</TaskId>
<ImageURL>https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/facebody/RecognizeBodyCount/149e4c0998ea6268938577ff98a0f497.jpg</ImageURL>
<Results>
<Suggestion>review</Suggestion>
<Rate>76.22</Rate>
<Label>liveness</Label>
<Frames>
<Rate>84.83</Rate>
<Url>http://aligreen-shanghai.oss-cn-shanghai.aliyuncs.com/prod/hammal/26210da42/28118541_TB1urBOQFXXXXbMXFXXXXXXXXXX-1442-257.png?Expires=1582703593&OSSAccessKeyId=H4sp5QfNbuDg****&Signature=%2B8iUkb5YjomYR8ujV2c8wMAavs****&x-oss-process=image%2Fcrop%2Cx_0%2Cw_288%2Fauto-orient%2C0</Url>
</Frames>
</Results>
</Elements>
</Data>
JSON
格式
{
"RequestId": "155027BB-E1D1-494F-8C24-6C5A69EFF39A",
"Data": {
"Elements": {
"TaskId": "img5GI4bP3sHdq7gRg$6Ccqh4-1u7Ldl",
"ImageURL": "https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/facebody/RecognizeBodyCount/149e4c0998ea6268938577ff98a0f497.jpg",
"Results": {
"Suggestion": "review",
"Rate": 76.22,
"Label": "liveness",
"Frames": {
"Rate": 84.83,
"Url": "http://aligreen-shanghai.oss-cn-shanghai.aliyuncs.com/prod/hammal/26210da42/28118541_TB1urBOQFXXXXbMXFXXXXXXXXXX-1442-257.png?Expires=1582703593&OSSAccessKeyId=H4sp5QfNbuDg****&Signature=%2B8iUkb5YjomYR8ujV2c8wMAavs****&x-oss-process=image%2Fcrop%2Cx_0%2Cw_288%2Fauto-orient%2C0"
}
}
}
}
}
错误码
关于人脸活体检测的错误码,详情请参见常见错误码。
SDK参考
阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。
安全声明
- 请确保上传的图片或文件来源符合相应的法律法规。
- 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。
在文档使用中是否遇到以下问题
更多建议
匿名提交