本文介绍了调用LivenessDetect接口进行静默活体检测的方法。静默活体检测帮助您检测传入的图片和视频中人脸是否是直接拍摄。

请求方法:支持以HTTPS POST或GET方法发送请求。

接口描述:通过对输入的人脸图片和视频进行检测,判断图片中人脸是否是直接拍摄。

上传图片地址的说明:在传入图片时,您需要上传其对应的HTTP或OSS地址。
说明 必须传入公网可访问的HTTP地址,例如,http://image-demo.img-cn-hangzhou.aliyuncs.com/example.jpg

图片或视频限制:

  • 支持传入本地图片。传入本地图片时,可以使用图片的相对路径或绝对路径。
  • 单张图片大小请控制在2 M及以下,避免算法拉取超时。
  • 视频大小不超过16 M。
  • 视频格式支持:MP4AVIFLVWMVMOVRM

调试

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

请求参数

名称 类型 是否必选 示例值 描述
BizId String 39ecf51e-2f81-4dc5-90ee-ff86125be683 认证ID。标识一次认证任务的唯一ID,不超过64字符。
说明 发起不同的认证任务时需要更换不同的BizId
BizType String LivenessDetectTest 使用实人认证服务的业务场景标识。关于如何通过控制台创建BizType,请参见业务设置
MediaCategory String VIDEO 认证的资源类型。取值:
  • IMAGE:图片。
  • VIDEO:视频。
MediaUrl String https://www.aliyun.com/test.mov 认证的资源地址。公网可访问的HTTP、HTTPS链接。
说明 MediaUrlMediaFileObject二选一。
MediaFileObject InputStream FileInputStream 认证的本地资源文件。
说明 MediaUrlMediaFileObject二选一。

返回数据

名称 类型 示例值 描述
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E 请求ID。
Code String 200 返回码。取值:
Message String Error.InternalError 返回信息。
ResultObject.Passed String T 静默活体检测是否通过。取值:
  • T:检测通过。
  • F:检测不通过。
ResultObject.Score Float 0.4312818 静默活体检测结果的分值。取值范围:0~1,阈值为0.82分。
  • 当分值小于0.82分,则ResultObject.Passed返回T
  • 当分值大于或等于0.82分,则ResultObject.Passed返回F
ResultObject.FrameUrl String http://cloudauth-zhangjiakou-new.oss-cn-zhangjiakou.aliyuncs.com/pre/hammal/1260051251634779/a545f594ed12444fa3c7bcceb0c67df4/04935c45f00e3a2.webm-frames/f00001.jpg?Expires=1603877940&OSSAccessKeyId=H4sp5QfNbuDghquU&Signature=BMZu2%2FfpJmj2blcVIyabcJmQRgc%3D 截帧的图片链接。
说明 当传入的MediaCategoryVIDEO时,返回该参数。

错误码

Code Message 说明
200 success 接口响应成功。
400 参数不能为空 参数不能为空。
401 参数非法 参数非法,不符合要求。
411 RAM用户无权限 需要给RAM用户授予AliyunYundunCloudAuthFullAccess的操作权限。
412 欠费中 调用账号存在欠费,请充值后再进行操作。
421 传入资源过大 传入资源超过了最大限制。
422 下载资源超时 下载资源超时(3秒)。
435 检测不到人脸 图片或者视频中检测不到人脸信息。
500 系统错误 系统内部错误,请提交工单进行反馈,由阿里云工程师协助排查。