功能描述

紅外人臉活體檢測能力可以檢測紅外圖片中的人臉是否為來自認證設備端的近距離裸拍活體人臉對象，可廣泛應用在紅外設備人臉實時采集場景，滿足紅外人臉注冊認證的真實性和安全性要求，判斷的前置條件是紅外圖像中有人臉。

從能力范圍來看：

1. 認證設備端是指借助近距離裸拍活體正面人臉用于認證、通行等服務場景的含紅外攝像頭的硬件設備，常見的認證設備端有門禁機、考勤機、PC等智能終端認證設備。

2. 裸拍活體正面人臉是指真人未經重度PS、風格化、人工合成等后處理的含正面人臉（非模糊、遮擋、大角度的正面人臉）的裸紅外照片。常見的非真人有紙張人臉、3D模型人臉等。

關于該接口功能的示例圖如下：

• 真人
• 紙張人臉

應用場景

• 系統人臉登錄防攻擊：通過檢測上傳的紅外圖像是否是真人實拍，而非攻擊及PS等后處理照片，以防止攻擊者登錄系統帶來安全風險。
• 門禁門鎖閘機刷臉通行：面向人臉注冊和認證環節設備端實時的紅外活體檢測，實現注冊與認證過程中的真人校驗，防止非法分子盜用、偽造他人身份打卡通行。
• 智慧酒店自助入住：在酒店前臺自助辦理入住場景中，運用紅外活體檢測技術實現無人監管場景下，住客非活體攻擊（紙張人臉、電子屏人臉）的高效率攔截。

特色優勢

• 高精度防偽：基于圖片中人像目標的高維度特征（風格化、摩爾紋、成像畸形等），判斷目標對象是否為活體，有效防止屏幕二次翻拍等作弊攻擊，支持單張或多張判斷邏輯。
• 高靈敏攔截：支持紅外攝像頭設備的實時活體檢測，可有效防止翻拍、頭模、打印圖片等樣本攻擊。
• 使用范圍廣：對于門鎖等可見光照不理想的場景，具有更佳的適用性。
• 簡單易用：可直接調用的 API 接口，服務簡單易用，易被集成，兼容性強。

接入指引

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

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

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

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

5. 開發接入步驟：

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

6. 示例代碼：該能力常用語言的示例代碼，請參見紅外人臉活體檢測示例代碼。

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

• Web前端直接調用
• 小程序場景下直接調用
• Android端直接調用
• iOS端直接調用

輸入限制

• 圖像格式：PNG、JPG、JPEG、BMP、GIF、WEBP。
• 圖像大小：不超過10 MB。如您有大圖需求，請通過釘釘群（23109592）加入阿里云視覺智能開放平臺咨詢群聯系我們。
• 圖像分辨率：建議大于256×256，像素過低可能會影響識別效果。
• URL地址中不能包含中文字符。

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

檢測說明

• 最長檢測時間是5秒，如果在該時間內沒有完成檢測，系統會強制返回超時錯誤碼。
• 圖像下載時間限制為3秒，如果下載時間超過3秒，系統會返回下載超時。
• 圖像檢測接口響應時間依賴圖像的下載時間。請保證被檢測圖像所在的存儲服務穩定可靠，建議您使用阿里云OSS存儲或者CDN緩存。
• 最多可檢測10張圖像。
• 目前平臺提供的活體檢測為靜默活體，即基于圖片進行檢測，暫不支持搖頭，張嘴、眨眼等動作的活體檢測。

計費說明

關于紅外人臉活體檢測的計費方式及報價，請參見計費介紹。

請求參數

返回數據

SDK參考

阿里云視覺AI人臉人體類目下的紅外人臉活體檢測能力推薦使用SDK調用，支持多種編程語言，調用時請選擇AI類目為人臉人體（facebody）的SDK包，文件參數通過SDK調用可支持本地文件及任意URL，具體可參見SDK總覽。

示例代碼

該能力常用語言的示例代碼，請參見紅外人臉活體檢測示例代碼。

示例

請求示例

http(s)://facebody.cn-shanghai.aliyuncs.com/?Action=DetectInfraredLivingFace      //更多關于訪問域名（Endpoint）信息，請參見：http://bestwisewords.com/document_detail/143103.html
&Tasks=[{"ImageURL":"https://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectInfraredLivingFace/DetectInfraredLivingFace.jpeg"}]
&公共請求參數

正常返回示例

XML格式

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

<DetectInfraredLivingFaceResponse>
    <RequestId>68DF6EC7-3B1D-11EE-9FA7-1122F1AE92DD</RequestId>
    <Data>
        <Elements>
            <FaceNumber>1</FaceNumber>
            <ImageURL>http://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/SegmentCommonImage/segmentimage-src-hu.jpeg</ImageURL>
            <Results>
                <Label>liveness</Label>
                <Rate>83.3848</Rate>
                <Rect>
                    <Height>20</Height>
                    <Width>30</Width>
                    <Top>50</Top>
                    <Left>60</Left>
                </Rect>
                <Suggestion>review</Suggestion>
                <MessageTips>blurred, occluded or large angle face, please check.</MessageTips>
            </Results>
        </Elements>
    </Data>
</DetectInfraredLivingFaceResponse>

JSON格式

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

{
  "RequestId" : "68DF6EC7-3B1D-11EE-9FA7-1122F1AE92DD",
  "Data" : {
    "Elements" : [ {
      "FaceNumber" : 1,
      "ImageURL" : "http://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/SegmentCommonImage/segmentimage-src-hu.jpeg",
      "Results" : [ {
        "Label" : "liveness",
        "Rate" : 83.3848,
        "Rect" : {
          "Height" : 20,
          "Width" : 30,
          "Top" : 50,
          "Left" : 60
        },
        "Suggestion" : "review",
        "MessageTips" : "blurred, occluded or large angle face, please check."
      } ]
    } ]
  }
}

活體閾值參考

關于圖片活體檢測的判斷閾值選擇，可參考以下列表數值信息：

當Label是normal時，表示的是活體，Rate表示活體置信度，Rate取值范圍是[80,100]。

當Label是liveness時，表示的是非活體，Rate表示非活體置信度，Rate取值范圍是[20,100]。

關于以上數值的概念定義：

• 攻擊攔截率：如98%，代表100次作弊假體攻擊，會有98次被API識破拒絕。
• 活體通過率：如98%，代表100次真人請求，會有98次順利通過活體驗證。

錯誤碼

關于紅外人臉活體檢測的錯誤碼，詳情請參見常見錯誤碼。

開源模型體驗

更多開源免費模型體驗及下載，詳見魔搭社區：人臉活體檢測模型-RGB、人臉活體檢測模型-IR、靜默人臉活體檢測模型-炫彩。

安全聲明

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