Seedance Digital Human Asset Library

Use the native Action APIs to create, verify, upload, and reference Seedance digital human assets.

The Seedance Digital Human Asset Library manages real-person and virtual-character assets that Seedance 2.0 and Seedance 2.5 can reference. The native APIs preserve Action, Version, and the corresponding request and response structures, and use an AGTCloud API Key for authentication.

Choose an asset type

Asset type	Creation method	Suitable use cases	Main limitation
Virtual character (AIGC)	Create an asset container, then upload files	Virtual presenters, characters, and product assets	The upload URL must be accessible to the server
Real person (LivenessFace)	Complete liveness face verification first	Real-person digital humans and personal likenesses	The asset must match the verified face

Virtual-character integration workflow

Create an asset container

Call CreateAssetGroup to create an AIGC asset group, and save the returned asset group ID.

Upload an asset

Upload a publicly accessible image, video, or audio file to the asset group. A successful upload only means the request has been accepted; the asset normally enters a processing state first.

Wait until the asset is available

Poll the asset retrieval API until the status changes to Active. If it changes to Failed, read the error information and do not continue using the asset.

Reference the asset in a video task

Use asset://ASSET_ID or asset://ASSET_GROUP_ID as the asset URL in a Seedance native create request. The referenced asset must belong to the current account and be available.

Real-person integration workflow

For a real-person asset, first create a verification session and direct the user to complete liveness capture in a mobile browser. Then call GetVisualValidateResult to obtain the real-person asset group ID. Create a new session if the previous session expires.

After obtaining the real-person asset group, you can upload assets to it, but the face must match the verified person. A mismatched asset enters the failed state and returns FaceMismatch.

Asset status and results

Processing: The asset is still being processed. Query about every 3 seconds and avoid polling without a delay.
Active: The asset can be used for video generation.
Failed: Read the error reason and stop polling. Correct the asset and upload it again.
The signed URL returned by GetAsset is valid for approximately 11.5 hours and should not be stored as a permanent URL or distributed publicly.

Assets are bound to the account associated with the API Key. Accessing an asset that does not exist or does not belong to the current account may return ResourceNotFound. Deleting an asset group also deletes all assets in the group, so confirm the target ID and deletion scope before proceeding.

Start with Create an asset group or Create a human verification session.
After an asset becomes available, use Seedance 2.5 native video creation or Seedance 2.0 native video creation to submit an asset://... reference.

Seedance Digital Human Asset Library

On this page