Skip to main content
POST
  1. After submission, a task_id will be returned. If you provided a callback_url, when the task status becomes finished or failed, a POST request will be sent to the callback_url.
  2. Regardless of whether callback_url is provided, you can retrieve the response result through the unified Query Task Status endpoint.

Available Model

  • seedance-2-mini - Fast Seedance 2 Mini video generation

Key Features

  • Text-to-Video: Generate videos directly from prompt text
  • First and Last Frame Control: Use up to 2 images as the first and last frame
  • Reference-to-Video: Guide generation with reference images, videos, and audio
  • Optional Audio: Request generated audio together with the video

Important Notes

  • prompt is required.
  • duration supports integer values from 4 to 15.
  • resolution supports 480p and 720p.
  • aspect_ratio is optional. Supported values are auto, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16.
  • image_urls and any reference_*_urls fields are mutually exclusive.
  • reference_image_urls supports up to 9 images.
  • reference_video_urls supports up to 3 videos.
  • reference_audio_urls supports up to 3 audio files and requires at least one reference image or reference video.
  • The total number of reference files across image, video, and audio references must not exceed 12.
  • Usage is billed by generated video duration.
  • All remote URLs should be publicly accessible and directly downloadable.

Authorizations

Authorization
string
header
required

All API endpoints require Bearer Token authentication

Get your API Key:

Visit the API Key Management Page to get your API Key

Add it to the request header:

Body

application/json
model
enum<string>
required

Seedance 2 Mini model identifier

Available options:
seedance-2-mini
input
object
required

Input parameters for generation

callback_url
string<uri>

Webhook callback URL for result notifications. Use a publicly reachable endpoint that you control.

Response

200 - application/json

Task submitted successfully

code
integer
required

HTTP status code

Example:

200

data
object
required