本文档介绍人脸比对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小时后会被系统自动清理删除。