How do I call the endpoint?

Send an HTTP request to https://api.acedata.cloud/seedance/videos with a Bearer token in the Authorization header. See the documentation for request parameters and response format.

What authentication does ByteDance Seedance Video Generation require?

All Ace Data Cloud APIs use Bearer token authentication. Get your API key from the platform dashboard at https://platform.acedata.cloud and include it as: Authorization: Bearer YOUR_TOKEN

How much does ByteDance Seedance Video Generation cost?

ByteDance Seedance Video Generation uses pay-as-you-go pricing with no monthly fees. Each API call costs credits based on the model and parameters used. Visit the service page for detailed pricing.

Ace Data Cloud

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.

https://hub.acedata.cloud/seedance

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 number of frames for generating a video must meet 25+4n (such as 29, 33, 37...289). It is mutually exclusive with the `duration` parameter and cannot be specified at the same time.

contentarrayRequired parameter

Input content for video generation. Each entry must contain either `text` or `image_url`, but cannot contain both at the same time. The meaning of other fields and whether they are required depends on the value of `type`.

durationnumber

The duration of the video, in seconds. It is mutually exclusive with the `frames` parameter and cannot be specified at the same time.

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 lite models default to 480p.

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.

service_tierstring

Service level type used for processing this request

Please select

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

Request successful (OK).

Response Body

dataarray

Generate or edit a list of video entries based on the prompts.

Array of

idstring

The unique ID of this result

seedinteger

Random seed used during generation

modelstring

Model used for generation

ratiostring

Aspect ratio of the video

usageobject

Resource usage information for this request

total_tokensinteger

The total number of tokens consumed by this request.

completion_tokensinteger

The number of tokens consumed by generated content

statusstring

Generate status, for example, `succeeded` indicates successful generation.

contentobject

Detailed information about the generated content

video_urlstring

The URL of the generated video file, if not available, is an empty string.

durationinteger

Duration, measured in seconds

created_atinteger

The creation time of this result

resolutionstring

Video resolution

updated_atinteger

The most recent update time of this result.

service_tierstring

Service level used for handling this task

framespersecondinteger

Frame rate of the video (frames per second)

execution_expires_afterinteger

The expiration time of the task execution result, in seconds.

successboolean

Flag indicating whether this request was successful.

task_idstring

The task ID for this request

trace_idstring

The tracking ID for this request

Example

{
  "data": [
    {
      "id": "cgt-2025******-***",
      "seed": 10,
      "model": "doubao-seedance-1-0-pro-250528",
      "ratio": "16:9",
      "usage": {
        "total_tokens": 108900,
        "completion_tokens": 108900
      },
      "status": "succeeded",
      "content": {
        "video_url": "https://ark-content-generation-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-1-0-pro/****"
      },
      "duration": 5,
      "created_at": 1743414619,
      "resolution": "720p",
      "updated_at": 1743414673,
      "service_tier": "default",
      "framespersecond": 24,
      "execution_expires_after": 172800
    }
  ],
  "success": true,
  "task_id": "93f11baf-347b-4bb4-9520-8653cb46d6a3",
  "trace_id": "a9063166-26ed-4451-85b5-54e896817c69"
}

Allow Use General Balance

When 'Allow General Balance' is enabled, the general balance is used automatically if an app's balance is insufficient.

Shell

Python

JavaScript

Java

PHP

Kind reminder: For streaming requests, the above code may not be fully applicable. Please refer to the integration documentation for changes.