Skip to main content
POST

Authorization

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:
  • doubao-seedance-1-0-pro-fast - Fast version, quick generation, suitable for preview and iteration
  • doubao-seedance-1-0-pro-quality - High-quality version, longer generation time, better quality
string
required
Video content descriptionDescribe scenes, actions, styles in detail for better generation resultsExample: "Sunset at the beach, golden sunlight on the sea, waves gently hitting the sand"
integer
default:"5"
Video duration (seconds)Supported range: 2 ~ 12 secondsDefault: 5
string
default:"16:9"
Video aspect ratioOptions:
  • 16:9 - Landscape
  • 9:16 - Portrait
  • 1:1 - Square
  • 4:3 - Traditional ratio
  • 3:4 - Vertical traditional ratio
  • 21:9 - Ultra-wide
Default: 16:9
string
default:"1080p"
Video resolutionOptions:
  • 480p - Standard definition
  • 720p - High definition
  • 1080p - Full HD
Default: 1080p
integer
Seed integer for controlling the randomness of generated contentValue range: Integer between -1 and 2^32-1
  • With the same request, if the model receives different seed values (e.g., not specifying seed or setting seed to -1, which will use a random number), different results will be generated
  • With the same request, if the model receives the same seed value, similar results will be generated, but not guaranteed to be identical

Resolution and Aspect Ratio Combinations

array
Image array with roles for more precise controlExample:
  • Only one image per role is supported
  • last_frame is only supported by doubao-seedance-1-0-pro-quality version, fast version does not support first and last frame together

Response

integer
Response status code, 200 on success
array
Response data array

Use Cases

Case 1: Quick Preview Landscape Video

Case 2: High-Quality Portrait Short Video

Case 3: Dynamic Transition Effect (First/Last Frame)

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.