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

功能描述

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

应用场景

  • 金融业务：比对用户身份证照片和现场拍摄的已获授权的真人照片，判断用户信息真实性，可提供快速安全的身份核验流程，适用于互联网远程开户、刷脸支付等金融业务。
  • 人脸考勤：无接触式刷脸考勤，疫情防控场景下企业考勤首选，且能有效防止代打卡等作弊行为。
  • 公共服务：客户直接刷脸办理业务，通过人脸比对识别身份信息，减少身份证查验、复印存档等环节，提高公共服务窗口办理业务的效率。
  • 酒店自助入住：住客刷脸自助办理入住，将现场授权获取的人脸照片，与身份证提取的照片进行1:1比对，确保住客身份的真实性的同时，减少人工核查和服务成本，向住客提供便捷的入住体验。

特色优势

  • 高精度识别： 由达摩院提供业内领先的人脸识别算法，算法准确率超过99%。
  • 平台服务稳定：提供在高并发，大流量下的毫秒级识别响应和99.999%的可靠性保障。

前提条件

请确保您已开通人脸人体服务，若未开通服务请立即开通。

计费说明

关于人脸比对的计费方式及报价，详情请参见计费介绍。

输入限制

  • 图片格式：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参考

阿里云视觉AI能力支持使用SDK调用，具体可参见SDK总览下载安装。

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。