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

功能描述

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

应用场景

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

特色优势

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

前提条件

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

计费说明

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

输入限制

  • 图像格式:JPEG、JPG、PNG、BMP。
  • 图像大小:不超过3M。
  • 图像分辨率:大于32×32像素,小于2048×2048像素,人脸占比不低于64×64像素。
  • URL地址中不能包含中文字符。
  • 可使用URL与Base64编码字符串混合输入。例如:输入ImageURLA和ImageDateB的值,不输入ImageURLB和ImageDateA的值。
说明 当图像分辨率超过最大限制时,请先将图片进行缩放,调整图片大小,具体请参见图片缩放

调试

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

请求参数

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

系统规定参数。取值:CompareFace

QualityScoreThreshold Float 97

质量分阈值,取值范围[0.0,100.0]。0.0或空则表示不做质量分判断逻辑。

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

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

说明 ImageURLAImageDataA二选一,当URL方式与Base64编码方式共存时,URL方式优先。
ImageURLB String https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/ceshi/CompareFaceB.jpg

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

说明 ImageURLBImageDataB二选一,当URL方式与Base64编码方式共存时,URL方式优先。
ImageDataA String /9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgK****

图像A的Base64编码字符串。当与URL方式共存时,URL方式优先。

说明 ImageURLAImageDataA二选一,当URL方式与Base64编码方式共存时,URL方式优先。
ImageDataB String /9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgQ****

图像B的Base64编码字符串。当与URL方式共存时,URL方式优先。

说明 ImageURLBImageDataB二选一,当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
&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格式

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小时后会被系统自动清理删除。