本文档为您介绍人脸活体检测DetectLivingFace的语法及示例。

功能描述

DetectLivingFace可以检测图片中的活体对象(主要是人脸)来自直接拍摄或者是翻拍。活体判断的前置条件是图像中有人脸。

前提条件

请确保您已开通人脸人体服务,详情请参见服务开通

输入限制

  • 图片格式:PNG、JPG、JPEG、BMP、GIF、WEBP。
  • 图片大小:图片大小不超过10MB。如您有大图需求,请提工单进行调整。
  • 图片像素:建议大于256×256,像素过低可能会影响识别效果。
  • URL地址中不能包含中文字符。

检测说明

  • 最长检测时间是6秒,如果在该时间内没有完成检测,系统会强制返回超时错误码。
  • 图片下载时间限制为3秒,如果下载时间超过3秒,系统会返回下载超时。
  • 图片检测接口响应时间依赖图片的下载时间。请保证被检测图片所在的存储服务稳定可靠,建议您使用阿里云OSS存储或者CDN缓存。

调试

您可以在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流量计费。

返回数据

名称 类型 示例值 描述
Data Struct

返回的结果数据内容。

Elements Array

返回的元素。

ImageURL String https://img.alicdn.com/tfs/TB1urBOQFXXXXbMXFXXXXXXXXXX-1442-257.png

对应请求中的图像URL地址。

Results Array

返回结果。调用成功时返回结果中包含一个或多个元素。

Frames Array

输入图像为长图(长宽比大于 3:1 )时,会把原图截成几张正常比例的图,frames保存从图像中裁剪出来的而且是翻拍命中的截图。

Rate Float 84.83

结果为该分类的概率,取值范围为[0.00-100.00]。取值越高,表示属于该分类的概率越大。

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

检测结果的分类,取值包括:

  • normal:活体照片
  • liveness:翻拍照片
Rate Float 84.83

结果为该分类的概率,取值范围为[0.00-100.00]。表示属于该分类的概率越大。

Suggestion String block

建议您执行的操作,取值范围如下:

  • pass:图片中的活体对象来自直接拍摄,无需进行其余操作。
  • review:图片中的活体对象可能来自翻拍,建议您确认后再进行操作。
  • block:图片中的活体对象大概率来自翻拍,建议您执行后续操作。
TaskId String img7HZHfB214aO49fpLZ9YvwW-1s81wP

该检测任务的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>img7HZHfB214aO49fpLZ9YvwW-1s81wP</TaskId>
        <Results>
            <Suggestion>block</Suggestion>
            <Frames>
                <Rate>84.83</Rate>
                <Url>http://aligreen-shanghai.oss-cn-shanghai.aliyuncs.com/prod/hammal/26210da42/28118541_TB1urBOQFXXXXbMXFXXXXXXXXXX-1442-257.png?Expires=1582703593&amp;OSSAccessKeyId=H4sp5QfNbuDg****&amp;Signature=%2B8iUkb5YjomYR8ujV2c8wMAavs****&amp;x-oss-process=image%2Fcrop%2Cx_0%2Cw_288%2Fauto-orient%2C0</Url>
            </Frames>
            <Rate>84.83</Rate>
            <Label>liveness</Label>
        </Results>
        <ImageURL>https://img.alicdn.com/tfs/TB1urBOQFXXXXbMXFXXXXXXXXXX-1442-257.png</ImageURL>
    </Elements>
</Data>

JSON 格式

{
	"RequestId": "155027BB-E1D1-494F-8C24-6C5A69EFF39A",
	"Data": {
		"Elements": [{
			"TaskId": "img7HZHfB214aO49fpLZ9YvwW-1s81wP",
			"Results": [{
				"Suggestion": "block",
				"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"
				}],
				"Rate": 84.83,
				"Label": "liveness"
			}],
			"ImageURL": "https://img.alicdn.com/tfs/TB1urBOQFXXXXbMXFXXXXXXXXXX-1442-257.png"
		}]
	}
}

错误码

关于人脸活体检测的错误码,详情请参见常见错误码

SDK参考

单击SDK简介查看SDK信息。