Skip to main content
Real-person and virtual human asset interfaces are still being developed for compatibility and have not launched yet. This page describes the expected integration flow and pre-launch preparation only. It does not mean these interfaces are ready for production use. Full endpoint paths, fields, error codes, and code examples will be added after launch.
Basic text-to-video, image reference, first/last frame, and video reference workflows still use the Seedance 2.0 Video Generation API. This page only covers the extra asset flow expected for real-person and virtual human assets.

Capability Status

CapabilityCurrent statusNotes
Basic text-to-video / image-to-videoAvailable through the base Seedance APICreate tasks with /seedance/api/v3/contents/generations/tasks
Real-person assetsCompatibility in development, waiting for launchExpected to require authorization, verification, and asset status checks
Virtual human assetsCompatibility in development, waiting for launchExpected to use a virtual human asset library or authorized asset ID
Real-person + virtual human combined tasksCompatibility in development, waiting for launchExpected to reference multiple verified character assets in one video task

Flow Overview

1

Prepare assets and authorization

Confirm that the real-person likeness, voice, styling, or virtual human identity is legally authorized. Real-person assets are expected to require authorization and verification; virtual human assets are expected to require asset library usage permission.
2

Create or select character assets

A real-person verification flow is expected to produce a reusable asset ID after approval. Virtual humans are expected to be selected or created from an asset library. Field names and creation paths are not fixed before launch.
3

Submit the Seedance video task

The video task will still use Seedance parameters such as prompt, model, duration, ratio, and resolution. Character assets will be passed as additional references. The final request schema will be defined in the launch documentation.
4

Query and download the result

After task creation, keep polling by task ID. When the task succeeds, read the result URL or download the MP4 through the compatibility endpoint /v1/videos/{id}/content.

Real-Person Asset Flow

Real-person assets are for workflows that need to keep a specific person’s likeness, motion style, or character consistency. After launch, the flow is expected to include:
  1. Upload or submit real-person source material.
  2. Complete authorization and the required verification flow.
  3. Wait until the asset becomes available.
  4. Reference the real-person asset in a Seedance video task.
  5. Query the video task and download the result.
Do not send real-person face images or real-person videos as ordinary image_url / video_url inputs for real-person consistency generation yet. This capability must wait for the dedicated compatibility interfaces to launch.

Virtual Human Asset Flow

Virtual human assets are for digital humans, brand characters, virtual hosts, and enterprise spokesperson workflows. After launch, the flow is expected to include:
  1. Select an authorized asset from the virtual human asset library, or create one through the platform workflow.
  2. Obtain the character asset ID for video tasks.
  3. Describe the virtual human’s action, camera movement, speech, or scene in the prompt.
  4. Reference the virtual human asset ID in the Seedance video task.
  5. Query the task and download the result.
A virtual human asset does not bypass real-person authorization. Virtual characters based on real people still need to satisfy likeness, voice, name, trademark, and related authorization requirements.

Real-Person + Virtual Human Combined Tasks

When a video needs both real-person and virtual human assets, the expected shape is “multiple verified character asset references + one Seedance task”:
StageReal-person assetVirtual human asset
Pre-checkAuthorization, verification, asset statusAsset library permission and asset status
Task referenceReference the real-person asset IDReference the virtual human asset ID
Prompt controlDescribe action, expression, and camera positionDescribe action, interaction, and scene
Result retrievalQuery and download with the same task IDQuery and download with the same task ID

Integration Preparation

  • Prepare real-person authorization, asset ownership, virtual human copyright, and allowed usage scope before integration.
  • Design the client flow as separate steps: asset creation, asset selection, asset status check, and video task submission.
  • Do not hard-code unreleased field names, endpoint paths, or asset ID formats before launch.
  • After launch, test with short, low-resolution jobs before expanding into production workflows.
Before launch, this public document only describes the workflow. When the capability is released, this page will add callable endpoints, request examples, response fields, error codes, and a complete Python example.