Real-Person Verification and Asset Management Overview

This document describes the Real-Person verification and portrait asset management capabilities. This capability is specifically designed to launch the liveness validation H5 page, and query or manage the generated real-person portrait asset groups (GroupId) and corresponding assets upon successful verification.

For the list of specific operation APIs, please refer to each independent endpoint document on the left.

Typical Calling Flow

1. Session Creation: The business server issues a POST /sessions request to EasyRouter with a callback URL, returning a session ID (session_id), byted_token, and the redirection H5 link h5_link for liveness validation.
2. Client Redirection: Redirect the client browser or web view to the liveness validation H5 page.
3. Verification Completion: The user completes liveness verification, and the page is redirected back to the pre-configured callback_url.
4. Extract Callback Parameters: The business server extracts the bytedToken and resultCode from the redirect URL parameters.
5. Query GroupId: If resultCode=10000 (success), call GET /sessions/:session_id to query and fetch the generated real-person portrait asset group group_id.
6. Asset Management: Once the group_id is retrieved, use the asset list, uploads, and deletion endpoints described on the left for related management operations.

Callback Handling Description

Once the user completes liveness validation, the redirection callback_url will append parameters with the following structure:

https://easyrouter.io/v1/callback?bytedToken=202603311449168C23BA26**************&resultCode=10000&algorithmBaseRespCode=0&reqMeasureInfoValue=1&verify_type=real_time

Key Parameters to Parse:

• bytedToken: The unique session token identifier.
• resultCode: Only when resultCode equals 10000 is the verification successful.

Special Notes: Using Real-person Avatar Assets in Video Generation API

When using a successfully uploaded, active real-person avatar asset in the video generation API, you can reference it via the asset://{asset_id} protocol path format. Currently, only dreamina-seedance-2-0 and dreamina-seedance-2-0-fast support this feature.

API Request Example

• Request Path: POST https://easyrouter.io/v1/video/generations

Request Parameters (Body)

{
  "model": "dreamina-seedance-2-0",
  "prompt": "图片中的我，穿着宇航服在月球表面漫步，背景是璀璨的星空",
  "duration": 5,
  "metadata": {
    "content": [
      {
        "type": "image_url",
        "image_url": {
          "url": "asset://asset-20260520153701-pgxsl"
        }
      }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "seed": 42
  }
}

For more advanced generation controls and detailed parameters of this model, please refer to: Dreamina Seedance Video Generation Documentation