ByteDance Seedance Videos API
POSThttps://api.acedata.cloud/seedance/videos
ByteDance Seedance video generation API allows you to input images and text to generate videos.
Related Products
SeeDance - Ace Data Cloud
SeeDance video generation platform, directly interfaces with this API, high-speed and stable availability.
Request Headers
acceptstring
Specify the format of the server response. If not specified, the default format is `application/json`.
Please select
authorizationstring
Bearer token
Request Body
seedinteger
The random seed used for reproducible generation has a value range from -1 to 4294967295; -1 indicates randomness.
asyncboolean
Whether to process in asynchronous mode. When set to `true`, the interface immediately returns `task_id`, without the need to provide `callback_url`, and then the result can be obtained by polling the corresponding task query interface; if `callback_url` is also provided, the result will be pushed to that callback address.
Please select
modelstringRequired parameter
Model ID for video generation
ratiostring
Aspect ratio of the generated video
Please select
framesinteger
The frame rate for generating videos ranges from [29, 289] and must satisfy 25+4n (such as 29, 33, 37...289). Only the Seedance 1.0 series supports this; for Seedance 1.5 Pro and 2.0 series, please use duration instead. You can choose either duration or frames; if both are specified, the priority is given to frames over duration.
contentarrayRequired parameter
Input content for video generation. Each entry must include one of `text`, `image_url`, `audio_url`, or `video_url` corresponding to the `type`. The meaning of other fields and whether they are required depends on the value of `type`.
durationinteger
The duration of the generated video, in seconds. Either duration or frames can be specified; if both are specified, frames take priority over duration. The duration range varies for each model: Seedance 2.0 series is 4 to 15 seconds or -1, Seedance 1.5 Pro is 4 to 12 seconds or -1, and Seedance 1.0 series is 2 to 12 seconds. -1 indicates automatic duration.
watermarkboolean
Whether to add a watermark to the generated video.
Please select
resolutionstring
Video resolution. The default value depends on the model used: most models default to 720p, while the lite model defaults to 480p. Note that the supported resolutions vary by model: `4k` is only supported by doubao-seedance-2-0 (standard version); doubao-seedance-2-0-fast and doubao-seedance-2-0-mini do not support 1080p and 4k.
Please select
camerafixedboolean
Is the camera position fixed during the generation process?
Please select
callback_urlstring
Callback URL for receiving the final result notification of the task. Once provided, the API will immediately return `task_id` and push the results to that URL when the task is completed.
generate_audioboolean
Whether to generate audio from video. The `doubao-seedance-1-5-pro-251215` and `doubao-seedance-2-0` series models support this parameter, while other models will ignore this parameter.
Please select
return_last_frameboolean
Whether to return the last frame of the generated video.
Please select
execution_expires_afterinteger
Task timeout threshold, unit in seconds
Response
Integration guide
Kind reminder: For streaming requests, the above code may not be fully applicable. Please refer to the integration documentation for changes.
ByteDance Seedance Video Generation
Allow Use General Balance
When 'Allow General Balance' is enabled, the general balance is used automatically if an app's balance is insufficient.