功能描述

口罩人臉比對1:1能力基于您輸入的兩張圖片，分別挑選兩張圖片中的最大人臉進行比較，判斷是否為同一人。融合戴口罩生成、抗遮擋關(guān)鍵點定位、抗遮擋特征注意力三大技術(shù)優(yōu)化，實現(xiàn)戴口罩時的極速人臉識別。

• 兩張人臉圖片對比：比對兩張圖片中人臉的相似度，返回這兩個人臉的矩形框坐標、人臉五點關(guān)鍵點坐標、比對的置信度，以及不同誤識率的置信度閾值。
• 支持多種圖片類型：支持生活照、證件照等類型的人臉對比。
• 支持佩戴口罩場景：針對佩戴口罩場景對帶口罩的人臉進行對比識別。

關(guān)于該接口功能的示意圖如下：

應用場景

• 員工考勤：無接觸式刷臉考勤，疫情防控場景下企業(yè)考勤首選，且能有效防止代打卡等作弊行為。
• 公共服務：佩戴口罩客戶直接刷臉辦理業(yè)務，通過人臉比對識別身份信息，減少身份證查驗、復印存檔等環(huán)節(jié)，提高公共服務窗口辦理業(yè)務的效率。
• 外賣騎手人臉核驗：戴口罩外賣騎手送餐業(yè)務人臉打卡和定期本身人臉核驗，現(xiàn)場授權(quán)采集的戴口罩人臉照片，與本人認證照片進行1:1比對，確保外賣騎手身份真實性，提供不摘口罩人臉識別便捷體驗。

特色優(yōu)勢

• 平臺服務穩(wěn)定：提供在高并發(fā)，大流量下的毫秒級識別響應和保障。
• 抗遮擋五官定位：支持戴口罩、大部分遮擋情況下，實現(xiàn)準確度自評估的魯棒性關(guān)鍵點定位。
• 抗遮擋特征建模：支持戴口罩、大部分遮擋情況下，實現(xiàn)基于注意力機制的魯棒性特征建模。
• 簡單易用：可直接調(diào)用的 API 接口，服務簡單易用，易被集成，兼容性強。
• 佩戴口罩場景優(yōu)化：針對佩戴口罩場景，優(yōu)化戴口罩遮擋情境下的人臉比對。

接入指引

1. 注冊阿里云賬號：打開阿里云官網(wǎng)，在阿里云官網(wǎng)右上角，單擊立即注冊，按照操作提示完成賬號注冊。

2. 開通能力：請確保您已開通人臉人體服務，若未開通服務請立即開通。

3. 創(chuàng)建AccessKey：請確保您已創(chuàng)建AccessKey，如果您使用的是子賬號AccessKey，您需要給子賬號賦予AliyunVIAPIFullAccess權(quán)限，具體操作，請參見RAM授權(quán)。

4. 在線調(diào)試（可選）：您可以通過OpenAPI Explorer在線調(diào)試能力，查看完整的調(diào)用示例代碼及SDK依賴信息，也可以下載完整的工程。

5. 開發(fā)接入步驟：

• 在SDK總覽中選擇您要接入使用的SDK語言。
• 在對應語言的SDK文檔中找到AI類目為人臉人體（facebody）的SDK包進行安裝。
• 參考文檔中提供的示例代碼進行適當修改后調(diào)用。

6. 示例代碼：該能力常用語言的示例代碼，請參見口罩人臉比對1:1示例代碼。

7. 客戶端直接調(diào)用：該能力常用的客戶端調(diào)用方式包括以下幾種。

• Web前端直接調(diào)用
• 小程序場景下直接調(diào)用
• Android端直接調(diào)用
• iOS端直接調(diào)用

輸入限制

• 圖像格式：JPEG、JPG、PNG、BMP、WEBP。
• 圖像大小：不超過3 MB。
• 圖像分辨率：大于32×32像素，小于4096×4096像素，人臉占比不低于64×64像素。

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

  說明 當圖像分辨率超過最大限制時，請先將圖片進行縮放，調(diào)整圖片大小，具體請參見圖片縮放。

計費說明

關(guān)于口罩人臉比對1:1的計費方式及報價，請參見計費介紹。

請求參數(shù)

返回數(shù)據(jù)

SDK參考

阿里云視覺AI人臉人體類目下的口罩人臉比對1:1能力推薦使用SDK調(diào)用，支持多種編程語言，調(diào)用時請選擇AI類目為人臉人體（facebody）的SDK包，文件參數(shù)通過SDK調(diào)用可支持本地文件及任意URL，具體可參見SDK總覽。

示例代碼

該能力常用語言的示例代碼，請參見口罩人臉比對1:1示例代碼。

示例

請求示例

http(s)://facebody.cn-shanghai.aliyuncs.com/?Action=CompareFaceWithMask      //更多關(guān)于訪問域名（Endpoint）信息，請參見：http://bestwisewords.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
&公共請求參數(shù)

正常返回示例

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"
  }
}

錯誤碼

關(guān)于口罩人臉比對1:1的錯誤碼，詳情請參見常見錯誤碼。

開源模型體驗

更多開源免費模型體驗及下載，詳見魔搭社區(qū)：人臉識別OOD模型、ArcFace人臉識別模型、IR人臉識別模型FRIR、口罩人臉識別模型FRFM-large、口罩人臉識別模型FaceMask。

安全聲明

• 請確保上傳的圖片或文件來源符合相應的法律法規(guī)。
• 通過體驗調(diào)試上傳的臨時文件有效期為1小時，在24小時后會被系統(tǒng)自動清理刪除。
• 平臺不存儲用戶在使用服務過程中涉及的原始人臉圖片或文件信息。