seedance-2-0
seedance-2.0 Video Generation
- Async processing mode, returns task ID for subsequent queries
- Supports text-to-video, image-to-video (first frame/last frame)
- Supports reference video, reference audio, audio-enabled video
- Supports landscape, portrait, square, ultra-wide, and adaptive aspect ratios
POST
Authentication
string
required
All API endpoints require Bearer Token authenticationGet your API Key:Visit the API Key Management Page to get your API KeyAdd it to the request header:
Request Parameters
string
required
Video generation model nameSupported models:
seedance-2.0- Standard version, supports text-to-video, image-to-video, first/last frame video, reference video, reference audio, and audio-enabled videoseedance-2.0-fast- Fast version, same features as the standard version with faster generation speedseedance-2.0-mini- Mini version, same features as the standard version
boolean
default:"false"
Whether to run content moderation before submitting the video task.Response when flagged:
true: useomni-moderation-latestto review prompts and input imagesfalseor omitted: do not send a moderation request, adding no moderation cost or latency (default)
- Text:
prompt,negative_prompt - Images:
image_urls,image_with_roles[].url,first_frame_image,last_frame_image - Image-type private
asset://assets: resolve and review their original public URL - Base64 images: review them after conversion to a public URL
video_urls, audio_urls, and video/audio private assets are not reviewed, because the moderation model does not support video or audio.Supported model IDs: seedance-2.0, seedance-2.0-fast, seedance-2.0-mini, seedance-2.0-face, seedance-2.0-fast-face, seedance-2-0 (legacy), and seedance-2.5.The moderation call itself is not billed to the user submitting the video request.Example:string
Video content descriptionRequired for text-to-video; optional for image-to-video or video-reference-to-videoIt is recommended to clearly specify the subject, action, camera movement, and style for better generation resultsExample:
"A kitten yawning at the camera"integer
default:"5"
Video duration (seconds)Supported range:
4 to 15 secondsDefault: 5string
default:"16:9"
Video aspect ratioThe aspect ratio must be between 0.5 and 2.5Options:
16:9- Landscape9:16- Portrait1:1- Square4:3- Traditional ratio3:4- Vertical traditional ratio21:9- Ultra-wideadaptive- Adaptive (automatically matches the input image/video)
16:9string
default:"720p"
Video resolutionOptions:
480p- Standard definition720p- High definition1080p- Full HD (only supported byseedance-2.0)4k- Ultra HD (only supported byseedance-2.0)
720pinteger
Random seed for controlling the randomness of generated content
- With the same request, different seed values will produce different results
- With the same request, the same seed value will produce similar results, but exact consistency is not guaranteed
boolean
default:"true"
Whether to generate audio (audio-enabled video)When set to
true, the video will include AI-generated accompanying audioWhen set to false, the video will not include audio (silent video)Default: trueboolean
default:"false"
Whether to return the last frame imageWhen set to
true, the task result will additionally return the URL of the video’s last frame image, which can be used for continuous video generationDefault: falsearray<object>
Tool list for enhanced capabilities such as web searchExample:
[{"type": "web_search"}]array<string>
Image URL array for image-to-videoSupports two formats:
- Regular image URL:
https://example.com/cat.jpg - Asset URL (approved asset):
asset://asset_a
["https://example.com/cat.jpg"] or ["asset://asset_a"]Asset URLs are supported by all Seedance 2.0 models:
seedance-2.0, seedance-2.0-fast, and seedance-2.0-mini.array
Image array with roles, supports specifying first frame/last frameExample:Asset URL format:
When the
url field uses an Asset URL, all Seedance 2.0 models are supported: seedance-2.0, seedance-2.0-fast, and seedance-2.0-mini.array<string>
Reference video URL arraySupports two formats:
- Regular video URL:
https://example.com/reference.mp4 - Asset URL (approved asset):
asset://asset_a
["https://example.com/reference.mp4"] or ["asset://asset_a"]Asset URLs are supported by all Seedance 2.0 models:
seedance-2.0, seedance-2.0-fast, and seedance-2.0-mini.array<string>
Reference audio URL arraySupports two formats:
- Regular audio URL:
https://example.com/speech.wav - Asset URL (approved asset):
asset://asset_a
["https://example.com/speech.wav"] or ["asset://asset_a"]Asset URLs are supported by all Seedance 2.0 models:
seedance-2.0, seedance-2.0-fast, and seedance-2.0-mini.Response
integer
Response status code, 200 on success
array
Response data array
Use Cases
Case 1: Text-to-Video
Case 2: Image-to-Video (First Frame)
Case 3: First/Last Frame Video
Case 4: Video-Reference-to-Video
Case 5: Reference Video + Reference Audio
Case 6: Audio-Enabled Video
Case 7: Continuous Video Generation (Return Last Frame)
Case 8: Fast Version Generation
Case 9: Reference Images + Reference Video + Reference Audio (Multi-Modal Video)
Combine reference images, reference video, and reference audio to generate an immersive first-person perspective advertisement video. Ideal for product promotions, brand ads, and other scenarios requiring multi-source material fusion.Case 10: Image-to-Video with Asset URL
Approved virtual avatar assets can be passed directly as reference images without re-uploading or re-reviewing.Case 11: Specify Reference Portrait with Asset URL (image_with_roles)
Case 12: Fast Version + Asset URL Image-to-Video
Case 13: Asset URL Image + Reference Video (Motion Transfer)
Combine an approved portrait asset with a reference video to drive the character to perform specified movements.Query Task ResultsVideo generation is an async task that returns a
task_id upon submission. Use the Get Task Status endpoint to query generation progress and results.