All Products
Search
Document Center

Financial Intelligence Engine:RealID Deeper Upgrade Guide

Last Updated:Jun 17, 2026

After purchasing Deeper, follow this guide to upgrade RealID with Deeper capabilities.

Deeper Function Overview

Deeper is an end-to-cloud AIGC detection capability from ZOLOZ. It combines multi-modal algorithms, terminal injection security detection, and dynamic risk control strategies to identify AIGC risks across multiple dimensions during identity verification.

Deeper is not an independent product but an enhancement for RealID, Face Capture, and Connect. For more information, see What is Deeper.

Deeper Upgrade Guide

  1. Purchase Deeper Products

  2. Upgrade Native SDK Version

  • Starting from version 1.4, the Native SDK includes enhanced terminal control capabilities. To fully utilize Deeper, upgrade your Native SDK to version 1.4 or later. For specific version numbers, refer to the Release Notes.

  • SDK versions 1.4 and later do not require additional NearX dependencies. If you previously used NearX features, remove the NearX implementation lines after upgrading to avoid execution conflicts. For details, refer to the App SDK-mode integration.

  1. Configure deeperMode Input Parameter:

    When Deeper is enabled through deeperMode, the parameters serviceLevel and operationMode will become inactive, and the detailed product config parameters will take effect. The following table lists recommended standard configurations for detailed product config parameters. These values are for reference only; set them based on your business needs. For more information, see the initialize API.

Field name

Description

Example

docUiType

ID photo capture method. Valid values:

  • 1: Self-capture. Users manually take ID photos. Provides basic anti-spoofing capabilities only.

  • 2: Deep-scan, Native SDK only. The ZOLOZ SDK automatically aligns and captures ID photos with advanced anti-spoofing capabilities, such as intercepting printed color images.

  • 3: Auto-scan, Web SDK only. The ZOLOZ SDK automatically aligns and captures ID photos with basic anti-spoofing capabilities. Auto-scan is recommended for the Web SDK because it provides a better user experience and higher-quality document images than Self-scan.

  • 4: Trace-scan, Native SDK only. The ZOLOZ SDK automatically captures ID photos when the document enters the camera range. This improves user experience but provides basic anti-spoofing capabilities only.

  • 5: Multi-angle, HKID in Web SDK only. Users take two document photos from different angles: one with the camera directly facing the ID document, and another with the ID document inclined at 30° against the camera.

Note: Deeper relies on Deep-scan and Auto-scan. When Deeper is enabled, select the appropriate capture method for your scenario: Deep-scan for the Native SDK, Auto-scan for the Web SDK. Detection performance degrades significantly if these modes are not selected.

  • Native: 2

  • H5: 3

spoofMode

Document anti-spoofing level. Valid values:

  • CLOSED: No algorithms are applied. Use this mode during testing to prevent algorithms and risk control rules from affecting tests.

  • STANDARD: A standard recommended level is applied.

  • LOOSE: Reserved value, not currently supported for use.

  • STRICT: Reserved value, not currently supported for use.

STANDARD

livenessMode

Liveness level for face liveness detection. Valid values:

  • CLOSED: No algorithms are applied. Use this mode during testing to prevent algorithms and risk control rules from affecting tests.

  • STANDARD: A standard recommended level is applied.

  • LOOSE: A looser level. Suitable for low-risk scenarios.

  • STRICT: A stricter level. Suitable for high-risk scenarios.

STANDARD

actionCheckItems

User actions to detect during liveness check. To maintain a good user experience, avoid using more than two actions. Valid values:

  • FACEBLINK: Requires the user to blink their eyes.

  • MOUTHOPEN: Requires the user to open their mouth once.

  • HEADSHAKE: Requires the user to shake their head. Left or right headshake will be specified for the user to perform.

  • HEADLOWER: Requires the user to lower their head once.

  • HEADRAISE: Requires the user to raise their head once.

FACEBLINK+1 other action (for example, MOUTHOPEN, HEADSHAKE, HEADLOWER)

actionRandom

Whether the actions in actionCheckItems are detected in random order. Valid values:

  • Y: Random

  • N: Not random. Actions are detected in the order listed in actionCheckItems.

Y

actionFrame

Additional frame capture configuration. Valid values:

  • EYECLOSE: Returns closed-eye frames captured during blink detection.

EYECLOSE

riskMode

Multi-dimensional risk control rule verification in RealID, used to intercept suspicious transactions. Valid values:

  • CLOSED: No risk detection algorithms are applied. Use this mode during testing to prevent algorithms and risk control rules from affecting tests.

  • STANDARD: A standard recommended level is applied.

  • LOOSE: Reserved value, not currently supported for use.

  • STRICT: Reserved value, not currently supported for use.

STANDARD

  1. View Deeper results.

    Check the Deeper-related business results in the checkresult API. The relevant output parameters include deeperFaceResultdeeperFaceResultDescriptiondeeperDocResultdeeperDocResultDescriptiondeeperRiskResult, and deeperRiskResultDescription. For more details, see the checkresult API.

Relationship Between antiInjectionMode and Deeper

In the RealID initialize API, the antiInjectionMode parameter was a trial feature switch for injection attack detection. As of June 2024, this parameter is no longer effective. ZOLOZ has launched the Deeper product, which covers both Deepfake detection and injection attack detection. To enable these features, purchase Deeper and set the deeperMode parameter. See the Deeper Upgrade Guide.

Note:

  • For existing customers still using antiInjectionMode, ZOLOZ will retain this parameter temporarily to ensure API compatibility and a smooth transition.

  • If existing customers enable ​deeperMode​, ZOLOZ will prioritize ​deeperMode​, and ​antiInjectionMode ​will be ignored.