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-5-pro - 1.5 Pro version, supports audio generation and first/last frame
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: 4 ~ 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:"720p"
Video resolutionOptions:
  • 480p - Standard definition
  • 720p - High definition
  • 1080p - Full HD
Default: 720p
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
boolean
default:"true"
Whether to generate audioWhen set to true, the video will include AI-generated accompanying audioDefault: true
Audio generation is only supported by the Seedance 2.0 series and Seedance 1.5 Pro
boolean
default:"false"
Whether to fix the cameraWhen set to true, the camera position remains fixedDefault: false

Resolution and Aspect Ratio Combinations

array<url>
Image URL array for image-to-video generationAuto role assignment rules:
  • 1 image = first frame
  • 2 images = first frame + last frame
Example: ["https://example.com/first.png", "https://example.com/last.png"]
  • image_urls and image_with_roles cannot be used together
array
Image array with roles for more precise controlExample:
  • image_urls and image_with_roles cannot be used together
  • First frame and last frame only support one each

Response

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

Use Cases

Case 1: Text-to-Video with Audio

Case 2: High-Quality Portrait Short Video

Case 3: First Frame to Dynamic Video

Case 4: Transition Effect with 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.

Differences from 1.0 Version