CompareFaces
进行人脸比对
服务地址:
华东1 金融云
输入参数
只看必填
TargetImageType图片2的类型
SourceImageType图片1的类型
SourceImageValue图片1的地址
TargetImageValue图片2的地址
插件下载了解更多
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 方法发送请求。

接口描述:指定两张人脸图片进行比对,输出两张图片中人脸的相似度分值作为结果。

  • 指定的比对图片中至少应含有一个图片类型是人脸照(FacePic)。
  • 一张图片中含有多个人脸时,算法会自动选取图片中占幅最大的人脸。
  • 两张比对的图片中,如果其中一张检测不到人脸,系统会返回“未检测到人脸”的错误提示。

在传入图片时,您需要上传图片对应的 HTTP 地址或 base64 编码。

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

图片限制

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

请求参数

字段名称字段详情
TargetImageTypestring

图片 2 的类型,取值:展开详情

示例值:FacePic
SourceImageTypestring

图片 1 的类型,取值:展开详情

示例值:FacePic
SourceImageValuestring

图片 1 的地址。具体请参见关于上传图片地址的说明。

示例值:http%3A%2F%2Fjiangsu.china.com.cn%2Fuploadfile%2F2015%2F0114%2F1421221304095989.jpg
TargetImageValuestring

图片 2 的地址。具体请参见关于上传图片地址的说明。

示例值:http%3A%2F%2Fjiangsu.china.com.cn%2Fuploadfile%2F2015%2F0114%2F1421221304095989.jpg

返回参数

字段名称字段详情
Codestring

HTTP 状态码。

示例值:200
Messagestring

错误代码。

示例值:Error.InternalError
RequestIdstring

本次请求的 ID。

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

是否成功响应。

示例值:true
Dataobject

人脸比对结果。

变更历史
暂无变更历史