功能描述

紅外人臉活體檢測(cè)能力可以檢測(cè)紅外圖片中的人臉是否為來(lái)自認(rèn)證設(shè)備端的近距離裸拍活體人臉對(duì)象，可廣泛應(yīng)用在紅外設(shè)備人臉實(shí)時(shí)采集場(chǎng)景，滿(mǎn)足紅外人臉注冊(cè)認(rèn)證的真實(shí)性和安全性要求，判斷的前置條件是紅外圖像中有人臉。

從能力范圍來(lái)看：

1. 認(rèn)證設(shè)備端是指借助近距離裸拍活體正面人臉用于認(rèn)證、通行等服務(wù)場(chǎng)景的含紅外攝像頭的硬件設(shè)備，常見(jiàn)的認(rèn)證設(shè)備端有門(mén)禁機(jī)、考勤機(jī)、PC等智能終端認(rèn)證設(shè)備。

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

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

• 真人
• 紙張人臉

應(yīng)用場(chǎng)景

• 系統(tǒng)人臉登錄防攻擊：通過(guò)檢測(cè)上傳的紅外圖像是否是真人實(shí)拍，而非攻擊及PS等后處理照片，以防止攻擊者登錄系統(tǒng)帶來(lái)安全風(fēng)險(xiǎn)。
• 門(mén)禁門(mén)鎖閘機(jī)刷臉通行：面向人臉注冊(cè)和認(rèn)證環(huán)節(jié)設(shè)備端實(shí)時(shí)的紅外活體檢測(cè)，實(shí)現(xiàn)注冊(cè)與認(rèn)證過(guò)程中的真人校驗(yàn)，防止非法分子盜用、偽造他人身份打卡通行。
• 智慧酒店自助入住：在酒店前臺(tái)自助辦理入住場(chǎng)景中，運(yùn)用紅外活體檢測(cè)技術(shù)實(shí)現(xiàn)無(wú)人監(jiān)管場(chǎng)景下，住客非活體攻擊（紙張人臉、電子屏人臉）的高效率攔截。

特色優(yōu)勢(shì)

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

接入指引

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

2. 開(kāi)通能力：請(qǐng)確保您已開(kāi)通人臉人體服務(wù)，若未開(kāi)通服務(wù)請(qǐng)立即開(kāi)通。

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

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

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

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

6. 示例代碼：該能力常用語(yǔ)言的示例代碼，請(qǐng)參見(jiàn)紅外人臉活體檢測(cè)示例代碼。

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

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

輸入限制

• 圖像格式：PNG、JPG、JPEG、BMP、GIF、WEBP。
• 圖像大小：不超過(guò)10 MB。如您有大圖需求，請(qǐng)通過(guò)釘釘群（23109592）加入阿里云視覺(jué)智能開(kāi)放平臺(tái)咨詢(xún)?nèi)郝?lián)系我們。
• 圖像分辨率：建議大于256×256，像素過(guò)低可能會(huì)影響識(shí)別效果。
• URL地址中不能包含中文字符。

  說(shuō)明 當(dāng)圖像分辨率超過(guò)最大限制時(shí)，請(qǐng)先將圖片進(jìn)行縮放，調(diào)整圖片大小，具體請(qǐng)參見(jiàn)圖片縮放。

檢測(cè)說(shuō)明

• 最長(zhǎng)檢測(cè)時(shí)間是5秒，如果在該時(shí)間內(nèi)沒(méi)有完成檢測(cè)，系統(tǒng)會(huì)強(qiáng)制返回超時(shí)錯(cuò)誤碼。
• 圖像下載時(shí)間限制為3秒，如果下載時(shí)間超過(guò)3秒，系統(tǒng)會(huì)返回下載超時(shí)。
• 圖像檢測(cè)接口響應(yīng)時(shí)間依賴(lài)圖像的下載時(shí)間。請(qǐng)保證被檢測(cè)圖像所在的存儲(chǔ)服務(wù)穩(wěn)定可靠，建議您使用阿里云OSS存儲(chǔ)或者CDN緩存。
• 最多可檢測(cè)10張圖像。
• 目前平臺(tái)提供的活體檢測(cè)為靜默活體，即基于圖片進(jìn)行檢測(cè)，暫不支持搖頭，張嘴、眨眼等動(dòng)作的活體檢測(cè)。

計(jì)費(fèi)說(shuō)明

關(guān)于紅外人臉活體檢測(cè)的計(jì)費(fèi)方式及報(bào)價(jià)，請(qǐng)參見(jiàn)計(jì)費(fèi)介紹。

請(qǐng)求參數(shù)

返回?cái)?shù)據(jù)

SDK參考

阿里云視覺(jué)AI人臉人體類(lèi)目下的紅外人臉活體檢測(cè)能力推薦使用SDK調(diào)用，支持多種編程語(yǔ)言，調(diào)用時(shí)請(qǐng)選擇AI類(lèi)目為人臉人體（facebody）的SDK包，文件參數(shù)通過(guò)SDK調(diào)用可支持本地文件及任意URL，具體可參見(jiàn)SDK總覽。

示例代碼

該能力常用語(yǔ)言的示例代碼，請(qǐng)參見(jiàn)紅外人臉活體檢測(cè)示例代碼。

示例

請(qǐng)求示例

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

正常返回示例

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

活體閾值參考

關(guān)于圖片活體檢測(cè)的判斷閾值選擇，可參考以下列表數(shù)值信息：

當(dāng)Label是normal時(shí)，表示的是活體，Rate表示活體置信度，Rate取值范圍是[80,100]。

當(dāng)Label是liveness時(shí)，表示的是非活體，Rate表示非活體置信度，Rate取值范圍是[20,100]。

關(guān)于以上數(shù)值的概念定義：

• 攻擊攔截率：如98%，代表100次作弊假體攻擊，會(huì)有98次被API識(shí)破拒絕。
• 活體通過(guò)率：如98%，代表100次真人請(qǐng)求，會(huì)有98次順利通過(guò)活體驗(yàn)證。

錯(cuò)誤碼

關(guān)于紅外人臉活體檢測(cè)的錯(cuò)誤碼，詳情請(qǐng)參見(jiàn)常見(jiàn)錯(cuò)誤碼。

開(kāi)源模型體驗(yàn)

更多開(kāi)源免費(fèi)模型體驗(yàn)及下載，詳見(jiàn)魔搭社區(qū)：人臉活體檢測(cè)模型-RGB、人臉活體檢測(cè)模型-IR、靜默人臉活體檢測(cè)模型-炫彩。

安全聲明

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