DetectFaceAttributes
检测人脸照片中的有效性属性
服务地址:
华东1 金融云
输入参数
只看必填
MaterialValue待检测照片
BizType使用实人认证服务的业务场景标识
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

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

接口描述:对输入照片中人脸的有效性相关属性进行检测,便于业务方判定该照片是否满足自身业务留存或比对的要求。目前支持的人脸有效性相关属性有:是否人脸、是否模糊、是否戴眼镜、脸部姿态、是否笑脸等。

上传图片地址的说明:在传入图片时,您需要上传其对应的 HTTP、OSS 地址或 Base64 编码。

  • HTTP 地址:可访问的公网 HTTP 地址。例如,http://image-demo.img-cn-hangzhou.aliyuncs.com/example.jpg
  • Base64 编码:通过 base64 编码的图片,格式为base64://<图片 base64 字符串>

图片限制:

  • 不支持本地图片的相对路径或绝对路径。
  • 单张图片大小请控制在 2 MB 内,避免算法拉取超时。
  • 单个请求的 Body 有 8 MB 的大小限制,请计算好请求中所有图片和其他信息的大小,不要超限。
  • 使用 Base64 传递图片时,接口的请求方法需要改成 POST;图片 Base64 字符串需要去掉头部描述,如data:image/png;base64

请求参数

字段名称字段详情
MaterialValuestring

待检测照片,格式描述见上传图片地址的说明。同一张图片最多检测其中的 5 张人脸。

示例值:http://image-demo.img-cn-hangzhou.aliyuncs.com/example.jpg
BizTypestring

使用实人认证服务的业务场景标识。

示例值:RPBasicTest

返回参数

字段名称字段详情
Codestring

HTTP 状态码。

示例值:200
Messagestring

错误代码。

示例值:Error.InternalError
RequestIdstring

本次请求的 ID。

示例值:473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
Successboolean

是否成功响应。

示例值:true
Dataobject

返回数据。

变更历史
暂无变更历史