ZOLOZZOLOZDOCS

RealID升级Deeper指南

购买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功能后，serviceLevel和operationMode参数将失效，此时开放参数生效。下表提供了开放参数的推荐标准配置，其中推荐值仅供参考，客户可根据实际业务需求自行设置，详见initialize API。

参数名称

参数描述

推荐值

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个其他动作（例如MOUTHOPEN、HEADSHAKE、HEADLOWER）

actionRandom

动作检测顺序是否随机。

  • Y：随机。
  • N：不随机，则按照actionCheckItems中的顺序进行检测。

Y

actionFrame

采集其他帧图片。

  • EYECLOSE：设置此值可返回在眨眼检测过程中采集的闭眼帧。

按需选择

riskMode

RealID中的多维度风控规则校验，用于拦截可疑交易。

  • CLOSED：所有有关风险检测的算法都未开启。该等级可用于测试场景，测试进程不受算法和风控规则的影响。
  • STANDARD：推荐的标准等级。
  • LOOSE：相对宽松的等级，可用于低风险场景。
  • STRICT：相对严格的等级，可用于高风险场景。

STANDARD

  1. 查看Deeper相关结果。
    在checkresult API中查看Deeper功能对应的业务结果，相关出参包括deeperFaceResult、deeperFaceResultDescription、deeperDocResult、deeperDocResultDescription、deeperRiskResult、deeperRiskResultDescription，详见checkresult API。

antiInjectionMode与Deeper的关系

在RealID initialize API中，antiInjectionMode参数曾作为注入攻击检测的试用功能开关，自2024年6月起，该参数已不再生效。现ZOLOZ已全新推出Deeper产品，该产品同时具备Deepfake检测及注入攻击检测能力。如需启用这些功能，您需要购买Deeper产品并设置deeperMode入参，详见升级Deeper指南。

注意：

  • 对于仍在使用antiInjectionMode的老客户，为确保API兼容性与平稳过渡，ZOLOZ将继续保留该参数一段时间。
  • 如果老客户启用了deeperMode参数，ZOLOZ将以deeperMode为准生效，此时antiInjectionMode将失效。