CompareFace基于用户输入的两张图片，可检测两张图片中的人脸，并挑选两张图片的最大人脸进行比较，判断是否是同一人。同时返回这两个人脸的矩形框坐标、比对的置信度，以及不同误识率的置信度阈值。

图片限制

  • 请求格式：JPEG、JPG、PNG、BMP。
  • 图像大小：图像大小小于等于3M。
  • 图像分辨率：图片大小要求5x5像素以上，人脸的尺寸建议大于64x64像素。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 CompareFace

系统规定参数。取值：CompareFace。
ImageURLA String 是 https://viapi-demo.oss-cn-shanghai.aliyuncs.com/图片1.jpg

图片url地址（http/https）。
ImageURLB String 是 https://viapi-demo.oss-cn-shanghai.aliyuncs.com/图片2.jpg

图片url地址（http/https）。

返回数据

名称 类型 示例值 描述
RequestId String 3A4092F5-C708-4258-953B-4B3FCEF3F8FB

当前请求的request id。
Data Struct

返回的数据内容。
Confidence Float 26.42851448059082

两张图片中最大人脸属于同一个人的置信度，取值范围0~100。如某张图片中没有人脸，返回置信度为0。
Thresholds List 61.0

误识率在10e-3，10e-4，10e-5时对应的置信度分类阈值。例如[61.0,69.0,75.0]。

RectAList List 106

图片1最大人脸矩形框[left, top, width, height]，如图片中没有人脸，返回矩形框数值均为0。例如[106,61,86,112]。

RectBList List 771

图片2最大人脸矩形框[left, top, width, height]，如图片中没有人脸，返回矩形框数值均为0。例如[771, 118, 222, 303]。

示例

请求示例

https://facebody.cn-shanghai.aliyuncs.com/?Action=CompareFace&<公共请求参数>

正常返回示例

JSON 格式 

{
  "RequestId": "3A4092F5-C708-4258-953B-4B3FCEF3F8FB",
  "Data": {
    "Thresholds": [
      61.0,
      69.0,
      75.0
    ],
    "Confidence": 26.42851448059082,
    "RectAList": [
      106,
      61,
      86,
      112
    ],
    "RectBList": [
      771,
      118,
      222,
      303
    ]
  }
}

错误码

具体请参见常见错误码。