全部產品
Search
文件中心

Financial Intelligence Engine:RealID升級Deeper指南

更新時間:Aug 15, 2025

購買Deeper產品後,您可以根據本指南在RealID中完成Deeper的升級操作。

Deeper功能概述

Deeper是ZOLOZ提供的端雲一體全鏈路AIGC檢測能力,結合多模態演算法、終端注入安全檢測能力和豐富的動態風控策略,可從多維度識別身份認證過程中的AIGC風險。

Deeper不是一個獨立的產品,而是RealID、Face Capture、Connect等產品的增強功能,更多關於Deeper的介紹,詳見什麼是Deeper

升級Deeper指南

  1. 購買Deeper產品。

  2. 升級Native SDK版本。

    自1.4版本起,Native SDK新增多種終端防控能力。為充分發揮Deeper功能,建議您將Native SDK升級到1.4及以上版本,具體版本號碼詳見Release Notes

    注意:1.4及以上版本SDK無需額外引入NearX相關依賴,如果您之前使用過NearX功能,升級後需刪除NearX實現行,以避免執行衝突,詳見使用原生App SDK模式接入

  3. 配置deeperMode入參。

    通過deeperMode開啟Deeper功能後,serviceLeveloperationMode參數將失效,此時開放參數生效。下表提供了開放參數的推薦標準配置,其中推薦值僅供參考,客戶可根據實際業務需求自行設定,詳見initializeAPI。

參數名稱

參數描述

推薦值

docUiType

證件照片的採集方式。

  • 1:手拍版(Self-capture),使用者需要手動拍攝證件照片,僅具備基礎防偽能力。

  • 2:Native防偽版(Deep-scan),僅適用於Native SDK。ZOLOZ SDK將自動對齊並拍攝證件照片,具備攔截彩打等進階防偽能力。

  • 3:H5掃描版(Auto-scan),僅適用於Web SDK。ZOLOZ SDK將自動對齊並拍攝證件照片,僅具備基礎防偽能力。

    建議Web SDK使用自動掃描的採集方式,因為與手拍版相比,自動掃描的使用者體驗更好且證件圖片品質更高。

  • 4:甩證版(Trace-scan),僅適用於Native SDK。當ZOLOZ SDK在網路攝影機範圍內檢測到證件時將自動拍攝。該版式可用於提升使用者體驗,但防偽能力較弱,僅具備基礎防偽能力。

  • 5:多角度版(Multi-angle),僅適用於Web SDK中的中國香港證件。使用者需要分別拍攝正對證件的照片和證件傾斜30°的照片,具備攔截彩打等進階防偽能力。

說明:Deeper功能依賴Deep-scan和Auto-scan這兩種採集方式。當開啟Deeper功能時,為確保最佳檢測效果,請根據您的實際應用情境選擇對應的採集方式,Native端使用Deep-scan,H5端使用Auto-scan,否則會影響檢測效果。

  • Native端:2

  • H5端:3

spoofMode

證件防偽等級。

  • CLOSED:所有的防偽演算法都未開啟。該等級可用於測試情境,測試進程不受演算法和風控規則的影響。

  • STANDARD:推薦的標準等級。

  • LOOSE:預留等級,暫不支援使用。

  • STRICT:預留等級,暫不支援使用。

STANDARD

livenessMode

人臉活體檢測等級。

  • CLOSED:所有的演算法和風控規則都未開啟。該等級可用於測試情境,測試進程不受演算法和風控規則的影響。

  • STANDARD:推薦的標準等級。

  • LOOSE:相對寬鬆的等級,可用於低風險情境。

  • STRICT:相對嚴格的等級,可用於高風險情境。

STANDARD

actionCheckItems

用戶端和Web端的動作檢測列表。

  • FACEBLINK:眨眼

  • MOUTHOPEN:張嘴

  • HEADSHAKE:搖頭

  • HEADLOWER:低頭

  • HEADRAISE:抬頭

FACEBLINK+1個其他動作(例如MOUTHOPENHEADSHAKEHEADLOWER

actionRandom

動作檢測順序是否隨機。

  • Y:隨機。

  • N:不隨機,則按照actionCheckItems中的順序進行檢測。

Y

actionFrame

採集其他幀圖片。

  • EYECLOSE:設定此值可返回在眨眼檢測過程中採集的閉眼幀。

按需選擇

riskMode

RealID中的多維度風控規則校正,用於攔截可疑交易。

  • CLOSED:關閉風控冷卻規則。該等級適用於測試情境,測試進程不受風控規則的影響。

  • STANDARD:推薦的標準等級。

  • LOOSE:相對寬鬆的等級,可用於低風險情境。

  • STRICT:相對嚴格的等級,可用於高風險情境。

STANDARD

  1. 查看Deeper相關結果。

    在checkresult API中查看Deeper功能對應的業務結果,相關出參包括deeperFaceResultdeeperFaceResultDescriptiondeeperDocResultdeeperDocResultDescriptiondeeperRiskResultdeeperRiskResultDescription,詳見checkresultAPI。

antiInjectionMode與Deeper的關係

在RealID initialize API中,antiInjectionMode參數曾作為注入攻擊檢測的試用功能開關,自2024年6月起,該參數已不再生效。現ZOLOZ已全新推出Deeper產品,該產品同時具備Deepfake檢測及注入攻擊檢測能力。如需啟用這些功能,您需要購買Deeper產品並設定deeperMode入參,詳見升級Deeper指南

注意:

  • 對於仍在使用antiInjectionMode的老客戶,為確保API相容性與平穩過渡,ZOLOZ將繼續保留該參數一段時間。

  • 如果老客戶啟用了deeperMode參數,ZOLOZ將以deeperMode為準生效,此時antiInjectionMode將失效。