人脸活体检测 - 阿里云视觉智能开放平台

功能描述

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

应用场景

系统人脸登录防攻击：通过检测上传的图像是否是真人，而非翻拍照片，以防止攻击者登录系统。

前提条件

请确保您已开通人脸人体服务，若未开通服务请立即开通。

说明本能力仅限企业认证用户开通。更多实名认证操作信息，请参见实名认证。

输入限制

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

说明当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见图片缩放。

检测说明

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

计费说明

关于人脸活体检测的计费方式及报价，请参见计费介绍。

说明下方调试接口为付费接口，如需免费体验调试请前往体验中心。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	DetectLivingFace	系统规定参数。取值：DetectLivingFace。
Tasks.N.ImageURL	String	否	http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectLivingFace/DetectLivingFace4.jpg	待检测的图像URL地址。JSON数组中的每个元素是一个图片检测任务结构体（image表）。最多支持10个元素，即同时最多对10张图片进行检测。当前仅支持上海地域的OSS链接，如何生成URL请参见生成URL。说明对于该接口，系统会自动将OSS链接地址转成内网地址然后再下载文件，所以调用该接口并不会产生OSS流量计费。
Tasks.N.ImageData	String	否	9j/4AAQSkZJRgABAQAAAQABAAD/2****	图像Base64编码字符串。当与URL方式共存时，URL方式优先。

返回数据


名称	类型	示例值	描述
RequestId	String	2EEA0396-BD84-5729-B8BD-D60776FCEF2B	请求ID。
Data	Object		返回的结果数据内容。
Elements	Array of Element		返回的元素。
ImageURL	String	http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectLivingFace/DetectLivingFace4.jpg	对应请求中的图像URL地址。
TaskId	String	img1owc8WGskNm78OEAPJTZal-1****	该检测任务的ID。
Results	Array of Result		返回结果。调用成功时返回结果中包含一个或多个元素。
Suggestion	String	review	建议您执行的操作，取值范围如下： pass：图片中的活体对象来自直接拍摄，无需进行其余操作。 review：图片中的活体对象可能来自翻拍，建议您确认后再进行操作。 block：图片中的活体对象大概率来自翻拍，建议您执行后续操作。
Frames	Array of Frame		（该字段已废弃）输入图像为长图（长宽比大于 3:1 ）时，会把原图截成几张正常比例的图，frames保存从图像中裁剪出来的而且是翻拍命中的截图。
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	命中的截图。
Rate	Float	84.83	结果为该分类的概率，取值范围为`[0.00-100.00]`。取值越高，表示属于该分类的概率越大。
Label	String	liveness	检测结果的分类，取值包括： normal：活体照片 liveness：翻拍照片
Rate	Float	76.22	结果为该分类的概率，取值范围为`[0.00-100.00]`。表示属于该分类的概率越大。

示例

请求示例

http(s)://facebody.cn-shanghai.aliyuncs.com/?Action=DetectLivingFace
&Tasks=[{"ImageURL":"http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectLivingFace/DetectLivingFace4.jpg","ImageData":"9j/4AAQSkZJRgABAQAAAQABAAD/2****"}]
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DetectLivingFaceResponse>
    <RequestId>2EEA0396-BD84-5729-B8BD-D60776FCEF2B</RequestId>
    <Data>
        <Elements>
            <TaskId>img1owc8WGskNm78OEAPJTZal-1****</TaskId>
            <Results>
                <Suggestion>review</Suggestion>
                <Rate>73.04</Rate>
                <Label>liveness</Label>
            </Results>
            <ImageURL>http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectLivingFace/DetectLivingFace4.jpg</ImageURL>
        </Elements>
    </Data>
</DetectLivingFaceResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "2EEA0396-BD84-5729-B8BD-D60776FCEF2B",
  "Data" : {
    "Elements" : {
      "TaskId" : "img1owc8WGskNm78OEAPJTZal-1****",
      "Results" : {
        "Suggestion" : "review",
        "Rate" : 73.04,
        "Label" : "liveness"
      },
      "ImageURL" : "http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectLivingFace/DetectLivingFace4.jpg"
    }
  }
}

错误码

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

SDK参考

阿里云视觉AI能力支持使用SDK调用，具体可参见SDK总览下载安装。

安全声明

请确保上传的图片或文件来源符合相应的法律法规。
通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。