Skip to main content
POST
  • ByteDance Doubao video generation model
  • Use model parameter to select doubao-seedance-1-0-pro-fast or doubao-seedance-1-0-pro-quality model
  • Supports text-to-video generation
  • Supports first frame / last frame / reference image control
  • Async task management, query results by task ID
Important Change: For better performance and cost control, we no longer support passing base64 image data directly in image_urls. Please use the Upload Image API first to upload images and get URLs, then call this endpoint.

Authorizations

string
required
All endpoints require Bearer Token authenticationGet your API Key from the API Key Management PageAdd to request header:

Body

string
default:"doubao-seedance-1-0-pro-fast"
required
Video generation model nameAvailable models:
  • doubao-seedance-1-0-pro-fast - Fast version (40-90 seconds generation)
  • doubao-seedance-1-0-pro-quality - Quality version (90-300 seconds generation)
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:"720p"
Video resolutionOptions:
  • 480p - Standard definition
  • 720p - High definition
  • 1080p - Full HD
Default: 720p1080p Limitation: When using reference images (role: reference in image_with_roles), 1080p resolution is not supported

Resolution and Aspect Ratio Combinations

string[]
First frame image URL array for image-to-video generation⚠️ URL format only (base64 no longer supported)
  • Publicly accessible image URL (http:// or https://)
  • You can use the Upload Image API to upload local images and get URLs
Example: ["https://example.com/cat.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
  • 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
object
Extended parameters (optional)

Response

string
Unique task identifier for status queries
string
Object type, always generation.task
string
Model name used
string
Task status
  • queued - Queued for processing
  • in_progress - Processing
  • completed - Successfully completed
  • failed - Failed
integer
Task progress percentage (0-100)
integer
Task creation timestamp (Unix timestamp)
object
Task metadata