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
    ]
  }
}

错误码

具体请参见常见错误码