Key capabilities
Output specifications
Workflow
Face asset management workflow
To use persistent image, video, or audio assets (such as a fixed character reference), upload them via the Asset Management API and reference them withasset://<ID> in generation requests.
Step 1: Create an asset group
Create an asset group to get a group ID.Step 2: Create an asset in the group
Use the group ID from Step 1 to upload an image asset (e.g., a character face reference photo).Step 3: Generate a video using the asset
Reference the asset ID from Step 2 to generate a video.asyn).
Step 4: Poll for the result
Query the generation status using the task ID.Notes
- Download links expire after 12 hours; re-fetch after expiry.
- If the task reaches 100% but returns an error, the content was likely blocked by the provider’s content moderation system (e.g., celebrity likeness or copyrighted content). Try modifying the prompt or replacing the reference image.
Examples
Text-to-video
Multimodal reference (image + video + audio)
Reference assets in the prompt with@image1, @video1, @audio1 — numbered per media type by their order in the content array.
Important: Assets must be passed in strict order:text,image_url,video_url,audio_url. Do not reorder them — doing so may cause errors. When multiple assets are included, do not mix in other asset types.
cURL
Video editing
cURL
Web search enhanced (text-to-video only)
cURL
Parameters
Input modes
Note: First frame, first+last frame, and multimodal reference are mutually exclusive — do not mix them in the same request.
Referencing assets in prompts
Inside the text prompt, you can refer to media items using@<type><N> placeholders — numbered per media type by their order in the content array:
Example:
"The character from @image1 walks through the scene in @video1 with @audio1 as background".
Note: Assets must be passed in strict order:text,image_url,video_url,audio_url. Do not reorder them — doing so may cause errors. When multiple assets are included, do not mix in other asset types.
Resolution pixel values
Note: 4k resolution is supported only by Seedance 2.0 (not Fast, Mini, or Ultra).
API Reference
View the interactive API playground for Seedance 2.0.