Skip to main content
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 video
  • seedance-2.0-fast - Fast version, same features as the standard version with faster generation speed
  • seedance-2.0-mini - Mini version, same features as the standard version
boolean
default:"false"
Whether to run content moderation before submitting the video task.
  • true: use omni-moderation-latest to review prompts and input images
  • false or omitted: do not send a moderation request, adding no moderation cost or latency (default)
Content reviewed:
  • 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.
  • Flagged content returns a synchronous HTTP 400 (nsfw_content_detected). No task or task_id is created, and no video-generation quota is charged
  • If moderation is unavailable, times out, or returns an invalid response, the request fails open and generation continues. Do not treat this option as an absolute content-safety guarantee
  • Inputs that cannot be resolved to a public image URL are skipped; unsupported models silently ignore nsfw_check: true
Example:
Response when flagged:
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 results
  • The prompt is limited to 4000 characters, but 500 characters are recommended.
  • The model seedance-2.0-mini has no character limit. Recommendation: keep Chinese prompts under 500 characters and English prompts under 1000 words. Excessive length tends to disperse the information, and the model may overlook details and focus only on the key points, resulting in some elements being missing from the video.
Example: "A kitten yawning at the camera"
integer
default:"5"
Video duration (seconds)Supported range: 4 to 15 secondsDefault: 5
string
default:"16:9"
Video aspect ratioThe aspect ratio must be between 0.5 and 2.5Options:
  • 16:9 - Landscape
  • 9:16 - Portrait
  • 1:1 - Square
  • 4:3 - Traditional ratio
  • 3:4 - Vertical traditional ratio
  • 21:9 - Ultra-wide
  • adaptive - Adaptive (automatically matches the input image/video)
Default: 16:9
string
default:"720p"
Video resolutionOptions:
  • 480p - Standard definition
  • 720p - High definition
  • 1080p - Full HD (only supported by seedance-2.0)
  • 4k - Ultra HD (only supported by seedance-2.0)
Default: 720p
integer
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: true
boolean
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: false
array<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
Example: ["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.
  • image_urls and image_with_roles cannot be used simultaneously
  • Maximum of 9 reference images
array
Image array with roles, supports specifying first frame/last frame
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.
Example:
Asset URL format:
  • image_urls and image_with_roles cannot be used simultaneously
  • When using first/last frame images, video_urls and audio_urls are not available
array<string>
Reference video URL arraySupports two formats:
  • Regular video URL: https://example.com/reference.mp4
  • Asset URL (approved asset): asset://asset_a
Example: ["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.
  • When using first/last frame images (image_with_roles), reference videos are not available
  • Maximum of 3 reference videos, 1.8s < total duration < 15.2s
  • Reference video resolution must be between 480P and 720P
array<string>
Reference audio URL arraySupports two formats:
  • Regular audio URL: https://example.com/speech.wav
  • Asset URL (approved asset): asset://asset_a
Example: ["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.
  • When using first/last frame images (image_with_roles), reference audio is not available
  • Maximum of 3 reference audio files, total duration must be 15s or less
  • Reference audio must be used together with reference images or reference videos

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.

Differences from 1.5 Pro Version