人脸比对1:1

功能描述

人脸比对1:1能力基于您输入的两张图片，分别挑选两张图片中的最大人脸进行比较，判断是否为同一人。

• 两张人脸图片对比：比对两张图片中人脸的相似度，返回这两个人脸的矩形框坐标、人脸五点关键点坐标、比对的置信度，以及不同误识率的置信度阈值。
• 支持多种图片类型：支持生活照、证件照、身份证芯片照、带网纹照等类型的人脸对比。

关于该接口功能的示例图如下：

应用场景

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

特色优势

• 高精度识别： 人脸检测识别算法精度处于业内领先水平。
• 平台服务稳定：提供在高并发、大流量下的毫秒级识别响应和保障。
• 关键点精准定位：支持眼睛、鼻子、嘴部五官位置的高精度精准定位。
• 简单易用：可直接调用的 API 接口，服务简单易用，易被集成，兼容性强。

接入指引

1. 注册阿里云账号：打开阿里云官网，在阿里云官网右上角，单击立即注册，按照操作提示完成账号注册。

2. 开通能力：请确保您已开通人脸人体服务，若未开通服务请立即开通。

3. 创建AccessKey：请确保您已创建AccessKey，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见RAM授权。

4. 在线调试（可选）：您可以通过OpenAPI Explorer在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。

5. 开发接入步骤：

• 在SDK总览中选择您要接入使用的SDK语言。
• 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。
• 参考文档中提供的示例代码进行适当修改后调用。

6. 示例代码：该能力常用语言的示例代码，请参见人脸比对1:1示例代码。

7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。

• Web前端直接调用
• 小程序场景下直接调用
• Android端直接调用
• iOS端直接调用

输入限制

• 图像格式：JPEG、JPG、PNG、BMP、WEBP。
• 图像大小：不超过5 MB。
• 图像分辨率：大于32×32像素，小于4096×4096像素，人脸占比不低于64×64像素。
• URL地址中不能包含中文字符。

• 可使用URL与Base64编码字符串混合输入。例如：输入ImageURLA和ImageDataB的值，不输入ImageURLB和ImageDataA的值。

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

计费说明

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

请求参数

返回数据

SDK参考

阿里云视觉AI人脸人体类目下的人脸比对1:1能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见SDK总览。

示例代码

该能力常用语言的示例代码，请参见人脸比对1:1示例代码。

示例

请求示例

http(s)://facebody.cn-shanghai.aliyuncs.com/?Action=CompareFace      //更多关于访问域名（Endpoint）信息，请参见：https://help.aliyun.com/document_detail/143103.html
&QualityScoreThreshold=98.5
&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

<CompareFaceResponse>
    <RequestId>B352CD68-C847-5C48-BE68-3F266356FDD7</RequestId>
    <Data>
        <Thresholds>61</Thresholds>
        <Thresholds>69</Thresholds>
        <Thresholds>75</Thresholds>
        <RectBList>169</RectBList>
        <RectBList>48</RectBList>
        <RectBList>125</RectBList>
        <RectBList>162</RectBList>
        <Confidence>88.4831771850586</Confidence>
        <RectAList>157</RectAList>
        <RectAList>82</RectAList>
        <RectAList>147</RectAList>
        <RectAList>188</RectAList>
        <QualityScoreA>99.65772247314453</QualityScoreA>
        <QualityScoreB>98.01177978515625</QualityScoreB>
        <IsMaskA>0</IsMaskA>
        <IsMaskB>0</IsMaskB>
        <LandmarksAList>201</LandmarksAList>
        <LandmarksAList>146</LandmarksAList>
        <LandmarksAList>266</LandmarksAList>
        <LandmarksAList>159</LandmarksAList>
        <LandmarksAList>222</LandmarksAList>
        <LandmarksAList>190</LandmarksAList>
        <LandmarksAList>187</LandmarksAList>
        <LandmarksAList>208</LandmarksAList>
        <LandmarksAList>255</LandmarksAList>
        <LandmarksAList>219</LandmarksAList>
        <LandmarksBList>199</LandmarksBList>
        <LandmarksBList>115</LandmarksBList>
        <LandmarksBList>248</LandmarksBList>
        <LandmarksBList>109</LandmarksBList>
        <LandmarksBList>215</LandmarksBList>
        <LandmarksBList>146</LandmarksBList>
        <LandmarksBList>206</LandmarksBList>
        <LandmarksBList>167</LandmarksBList>
        <LandmarksBList>260</LandmarksBList>
        <LandmarksBList>162</LandmarksBList>
    </Data>
</CompareFaceResponse>

JSON格式

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

{
  "RequestId" : "B352CD68-C847-5C48-BE68-3F266356FDD7",
  "Data" : {
    "Thresholds" : [ 61, 69, 75 ],
    "RectBList" : [ 169, 48, 125, 162 ],
    "Confidence" : 88.4831771850586,
    "RectAList" : [ 157, 82, 147, 188 ],
    "QualityScoreA" : 99.65772247314453,
    "QualityScoreB" : 98.01177978515625,
    "IsMaskA" : 0,
    "IsMaskB" : 0,
    "LandmarksAList" : [ 201, 146, 266, 159, 222, 190, 187, 208, 255, 219 ],
    "LandmarksBList" : [ 199, 115, 248, 109, 215, 146, 206, 167, 260, 162 ]
  }
}

错误码

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

开源模型体验

更多开源免费模型体验及下载，详见魔搭社区：人脸识别OOD模型、ArcFace人脸识别模型、IR人脸识别模型FRIR、口罩人脸识别模型FRFM-large、口罩人脸识别模型FaceMask。

安全声明

• 请确保上传的图片或文件来源符合相应的法律法规。
• 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。
• 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。