人脸比对1:1 - 阿里云视觉智能开放平台

功能描述

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

应用场景

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

特色优势

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

前提条件

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

说明本能力仅限企业认证用户开通。更多实名认证操作信息，请参见实名认证。

输入限制

图像格式：JPEG、JPG、PNG、BMP。
图像大小：不超过3 MB。
图像分辨率：大于32×32像素，小于4096×4096像素，人脸占比不低于64×64像素。
URL地址中不能包含中文字符。
可使用URL与Base64编码字符串混合输入。例如：输入ImageURLA和ImageDataB的值，不输入ImageURLB和ImageDataA的值。

说明当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见图片缩放。

计费说明

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

说明下方调试接口为付费接口，如需免费体验调试请前往体验中心。

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	CompareFace	系统规定参数。取值：CompareFace。
QualityScoreThreshold	Float	否	97	质量分阈值，对人脸图片进行质量分析判断，得到的质量分小于该阈值则表示人脸图片质量不符合要求，比对失败。取值范围[0.0,100.0]。0.0或空则表示不做质量分判断逻辑。
ImageURLA	String	否	http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/CompareFace/CompareFace-right1.png	图像A的URL地址。当前仅支持上海地域的OSS链接，如何生成URL请参见生成URL。说明 ImageURLA与ImageDataA二选一，当URL方式与Base64编码方式共存时，URL方式优先。
ImageURLB	String	否	http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/CompareFace/CompareFace-left1.png	图像B的URL地址。当前仅支持上海地域的OSS链接，如何生成URL请参见生成URL。说明 ImageURLB与ImageDataB二选一，当URL方式与Base64编码方式共存时，URL方式优先。
ImageDataA	String	否	/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgK****	图像A的Base64编码字符串。当与URL方式共存时，URL方式优先。说明 ImageURLA与ImageDataA二选一，当URL方式与Base64编码方式共存时，URL方式优先。
ImageDataB	String	否	/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgQ****	图像B的Base64编码字符串。当与URL方式共存时，URL方式优先。说明 ImageURLB与ImageDataB二选一，当URL方式与Base64编码方式共存时，URL方式优先。

返回数据


名称	类型	示例值	描述
RequestId	String	C6499918-E932-41B3-96F5-A18F50D262DD	请求ID。
Data	Object		返回的结果数据内容。
Thresholds	Array of Float	[61,69,75]	误识率在1/1000，1/10000，1/100000的情况下分别对应的置信度阈值。例如`[61.0,69.0,75.0]`，表示误识率为1/1000的情况下，置信度（Confidence）超过61%就可以认为是同一个人。
RectBList	Array of Integer	[132,58,84,105]	图片B中最大人脸矩形框`[left, top, width, height]`，例如`[771, 118, 222, 303]`。如果图片中没有人脸，则返回的矩形框数值均为0。
Confidence	Float	89.88594055175781	两张图片中的最大人脸属于同一个人的置信度，取值范围0~100。如果某张图片中没有人脸，则返回的置信度为0。
RectAList	Array of Integer	[105,62,87,110]	图片A中最大人脸矩形框`[left, top, width, height]`，例如`[106,61,86,112]`。如果图片中没有人脸，则返回的矩形框数值均为0。
QualityScoreA	Float	97.26718139648438	输入图像A的质量分。
QualityScoreB	Float	96.01641845703125	输入图像B的质量分。
MessageTips	String	imageB quality score less threshold	信息提示信息，纯文字描述，目前支持质量分的提示信息。例如，图像B的质量分小于输入参数设置的阈值，则系统会返回`imageB quality score less threshold`。

示例

请求示例

http(s)://[Endpoint]/?Action=CompareFace
&QualityScoreThreshold=97.0
&ImageURLA=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/CompareFace/CompareFace-right1.png
&ImageURLB=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/CompareFace/CompareFace-left1.png
&ImageDataA=/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgK****
&ImageDataB=/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgQ****
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<RequestId>C6499918-E932-41B3-96F5-A18F50D262DD</RequestId>
<Data>
    <MessageTips>imageB quality score less threshold</MessageTips>
    <QualityScoreA>97.26718139648438</QualityScoreA>
    <QualityScoreB>96.01641082763672</QualityScoreB>
    <Thresholds>61</Thresholds>
    <Thresholds>69</Thresholds>
    <Thresholds>75</Thresholds>
    <Confidence>89.88594055175781</Confidence>
    <RectAList>105</RectAList>
    <RectAList>62</RectAList>
    <RectAList>87</RectAList>
    <RectAList>110</RectAList>
    <RectBList>132</RectBList>
    <RectBList>58</RectBList>
    <RectBList>84</RectBList>
    <RectBList>105</RectBList>
</Data>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "C6499918-E932-41B3-96F5-A18F50D262DD",
  "Data" : {
    "MessageTips" : "imageB quality score less threshold",
    "QualityScoreA" : 97.26718139648438,
    "QualityScoreB" : 96.01641082763672,
    "Thresholds" : [ 61, 69, 75 ],
    "Confidence" : 89.88594055175781,
    "RectAList" : [ 105, 62, 87, 110 ],
    "RectBList" : [ 132, 58, 84, 105 ]
  }
}

错误码

关于人脸比对1:1的错误码，详情请参见常见错误码。

SDK参考

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

安全声明

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