口罩人脸比对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。
• 图像大小：不超过3 MB。
• 图像分辨率：大于32×32像素，小于4096×4096像素，人脸占比不低于64×64像素。

• URL地址中不能包含中文字符。

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

计费说明

关于口罩人脸比对1:1的计费方式及报价，请参见计费介绍。

请求参数

返回数据

SDK参考

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

示例代码

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

示例

请求示例

http(s)://facebody.cn-shanghai.aliyuncs.com/?Action=CompareFaceWithMask      //更多关于访问域名（Endpoint）信息，请参见：https://help.aliyun.com/document_detail/143103.html
&ImageURLA=https://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/CompareFaceWithMask/CompareFaceWithMask-left1.jpeg
&ImageURLB=https://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/CompareFaceWithMask/CompareFaceWithMask-right1.jpeg
&QualityScoreThreshold=97.0
&公共请求参数

正常返回示例

XML格式

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

<CompareFaceWithMaskResponse>
    <RequestId>C6499918-E932-41B3-96F5-A18F50D262DD</RequestId>
    <Data>
        <Confidence>88.025604</Confidence>
        <IsMaskA>1</IsMaskA>
        <IsMaskB>0</IsMaskB>
        <LandmarksAList>348</LandmarksAList>
        <LandmarksAList>490</LandmarksAList>
        <LandmarksAList>523</LandmarksAList>
        <LandmarksAList>478</LandmarksAList>
        <LandmarksAList>446</LandmarksAList>
        <LandmarksAList>577</LandmarksAList>
        <LandmarksAList>386</LandmarksAList>
        <LandmarksAList>677</LandmarksAList>
        <LandmarksAList>514</LandmarksAList>
        <LandmarksAList>668</LandmarksAList>
        <LandmarksBList>356</LandmarksBList>
        <LandmarksBList>590</LandmarksBList>
        <LandmarksBList>487</LandmarksBList>
        <LandmarksBList>589</LandmarksBList>
        <LandmarksBList>410</LandmarksBList>
        <LandmarksBList>676</LandmarksBList>
        <LandmarksBList>368</LandmarksBList>
        <LandmarksBList>754</LandmarksBList>
        <LandmarksBList>476</LandmarksBList>
        <LandmarksBList>753</LandmarksBList>
        <QualityScoreA>75.89126</QualityScoreA>
        <QualityScoreB>98.71688</QualityScoreB>
        <RectAList>238</RectAList>
        <RectAList>310</RectAList>
        <RectAList>388</RectAList>
        <RectAList>492</RectAList>
        <RectBList>284</RectBList>
        <RectBList>467</RectBList>
        <RectBList>293</RectBList>
        <RectBList>373</RectBList>
        <Thresholds>61</Thresholds>
        <Thresholds>69</Thresholds>
        <Thresholds>75</Thresholds>
        <MessageTips>imageB quality score less threshold</MessageTips>
    </Data>
</CompareFaceWithMaskResponse>

JSON格式

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

{
  "RequestId" : "C6499918-E932-41B3-96F5-A18F50D262DD",
  "Data" : {
    "Confidence" : 88.025604,
    "IsMaskA" : 1,
    "IsMaskB" : 0,
    "LandmarksAList" : [ 348, 490, 523, 478, 446, 577, 386, 677, 514, 668 ],
    "LandmarksBList" : [ 356, 590, 487, 589, 410, 676, 368, 754, 476, 753 ],
    "QualityScoreA" : 75.89126,
    "QualityScoreB" : 98.71688,
    "RectAList" : [ 238, 310, 388, 492 ],
    "RectBList" : [ 284, 467, 293, 373 ],
    "Thresholds" : [ 61, 69, 75 ],
    "MessageTips" : "imageB quality score less threshold"
  }
}

错误码

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

开源模型体验

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

安全声明

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