本文档介绍人脸比对CompareFace的语法及示例。

功能描述

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

前提条件

请确保您已开通人脸人体服务,详情请参见服务开通

输入限制

  • 图片格式:JPEG、JPG、PNG、BMP。
  • 图像大小:图像大小不超过3M。
  • 图像分辨率:图片大小要求5x5像素以上,人脸的尺寸建议大于64x64像素。
  • URL地址中不能包含中文字符。

调试

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

请求参数

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

要执行的操作。取值:CompareFace。

ImageURLA String https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/ceshi/CompareFaceA1.jpg

图片URL地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL

ImageURLB String https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/ceshi/CompareFaceB.jpg

图片URL地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL

返回数据

名称 类型 示例值 描述
Data Struct

返回的结果数据内容。

Confidence Float 83.176803588867188

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

RectAList List [234, 88,146, 206]

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

RectBList List [222,86,143,196]

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

Thresholds List [61,69,75]

误识率在1/1000,1/10000,1/100000的情况下分别对应的置信度阈值。例如[61.0,69.0,75.0],表示误识率为1/1000的情况下,置信度(Confidence)超过61%就可以认为是同一个人。

RequestId String 05D42434-1F6D-4866-8BF7-0AC670BCB8FE

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=CompareFace
&ImageURLA=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/ceshi/CompareFaceA1.jpg
&ImageURLB=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/ceshi/CompareFaceB.jpg
&<公共请求参数>

正常返回示例

XML 格式

<RequestId>05D42434-1F6D-4866-8BF7-0AC670BCB8FE</RequestId>
<Data>
    <Thresholds>61</Thresholds>
    <Thresholds>69</Thresholds>
    <Thresholds>75</Thresholds>
    <Confidence>83.176803588867188</Confidence>
    <RectAList>234</RectAList>
    <RectAList>88</RectAList>
    <RectAList>146</RectAList>
    <RectAList>206</RectAList>
    <RectBList>222</RectBList>
    <RectBList>86</RectBList>
    <RectBList>143</RectBList>
    <RectBList>196</RectBList>
</Data>

JSON 格式

{
	"RequestId": "05D42434-1F6D-4866-8BF7-0AC670BCB8FE",
	"Data": {
		"Thresholds": [
			61,
			69,
			75
		],
		"Confidence": "83.176803588867188",
		"RectAList": [
			234,
			88,
			146,
			206
		],
		"RectBList": [
			222,
			86,
			143,
			196
		]
	}
}

错误码

关于人脸比对的错误码,详情请参见常见错误码

SDK参考

单击SDK简介查看SDK信息。