Beta ByteDance Seedance Videos API
https://api.acedata.cloud/seedance/videos
ByteDance Seedance video generation API allows you to input images and text to generate videos.
Related Products
SeeDance - YourBrand AI
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. Seedance 2.5 uses `doubao-seedance-2-5-260628`.
ratiostring
Aspect ratio of the generated video
Please select
toolsarray
Optional tool configuration. Currently supports the web search tool `web_search`.
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
Video generation input list. Image-to-video first frame, image-to-video first and last frames, and full-modality reference are three mutually exclusive scenarios: first frame/first and last frames use `first_frame`/`last_frame`; full-modality reference uses `reference_image`/`reference_video`/`reference_audio`, and they cannot be mixed.
durationinteger
The duration of the generated video, in seconds. The Seedance 1.0 series supports 2–12 seconds and does not support -1; Seedance 1.5 Pro supports 4–12 seconds or -1; the Seedance 2.0 series supports 4–15 seconds or -1; Seedance 2.5 supports 4–30 seconds or -1. -1 indicates automatic duration; Seedance 2.5 video editing supports only -1.
priorityinteger
Task execution priority, with values ranging from 0 to 9, where a higher number indicates a higher queuing priority.
watermarkboolean
Whether to add a watermark to the generated video.
Please select
resolutionstring
Video resolution. Seedance 2.5 supports 480p, 720p, and 1080p; Seedance 2.0 Standard supports up to 4k, while Fast/Mini supports 480p and 720p. For other model capabilities, see the service documentation.
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.
output_formatstring
Seedance 2.5 output format, optional mp4 or mov. Other models use only their default format.
Please select
generate_audioboolean
Whether to generate synchronized audio. Seedance 2.5, the Seedance 2.0 series, and Seedance 1.5 Pro support this parameter.
Please select
return_last_frameboolean
Whether to return the last frame of the generated video.
Please select
safety_identifierstring
Stable anonymous identifier for end users, up to 64 English characters long. Please use a hash or internal anonymous ID, do not pass in personal information such as name, email, phone number, etc.
execution_expires_afterinteger
Task timeout threshold, unit in seconds
omni_reference_task_typestring
Seedance 2.5 full-modal task types: auto automatic determination; reference generation based on reference materials; edit reference video editing; extend reference video extension. reference requires at least one reference_image/reference_video/reference_audio; edit/extend require reference_video and adaptive ratio; edit duration must be -1.
Please select
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.