Skip to main content
POST
Pricing: See vibetool.ai/pricing for current rates.
Seedance 2.5 is ByteDance’s latest video generation model, exposed through Vibetool as a text-to-video endpoint. It turns a natural-language prompt into a 480p or 720p video of 4–30 seconds with native audio, and supports a wide range of aspect ratios from vertical 9:16 to cinematic 21:9. Generation is billed per second of output video.

Input Modalities

  • Text – a prompt describing the subject, action, setting, camera movement, and style (up to 10,000 tokens)

Output Modality

  • Video – an MP4 file with native audio, available at 480p or 720p and 4–30 seconds long

Authorization

string
required
All APIs require Bearer Token authentication. Format: Bearer YOUR_API_KEY

Request Body

string
required
The model identifier. Use "seedance-2.5-text-to-video".
string
required
Text description of the video to generate, including subject, motion, scene, camera work, and style. Up to 10,000 tokens.
number
default:"5"
Requested video duration in seconds, between 4 and 30. Defaults to 5 when omitted.
string
default:"720p"
Output resolution tier: "480p" or "720p". Affects the per-second rate — see the pricing page.
string
default:"adaptive"
Output aspect ratio: "adaptive", "16:9", "9:16", "1:1", "4:3", "3:4", or "21:9".
boolean
default:"true"
Whether to generate native audio for the video.

Response Schema

string
required
Unique identifier for the generation task.
string
required
Type of object, always "video.generation".
string
required
The model used, e.g., "seedance-2.5-text-to-video".
integer
required
Unix timestamp (seconds) of task creation.
string
required
Initial status: "pending" or "processing". Use the Get Video Status endpoint to poll for completion.
string
required
The task ID to query in the status endpoint.
Once the task is created, poll the Get Video Status endpoint with the returned task_id until status is "completed" and the generated video URL is available.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
model
enum<string>
required

Use seedance-2.5-text-to-video.

Available options:
seedance-2.5-text-to-video
prompt
string
required

Text description of the video to generate

duration
integer
default:5

Duration in seconds (4-30)

Required range: 4 <= x <= 30
quality
enum<string>
default:720p

Output resolution tier

Available options:
480p,
720p
aspect_ratio
enum<string>
default:adaptive
Available options:
adaptive,
16:9,
9:16,
1:1,
4:3,
3:4,
21:9
generate_audio
boolean
default:true

Response

Task created

id
string

Unique identifier for the generation task

object
string
Example:

"video.generation"

model
string
created_at
integer

Unix timestamp (seconds)

status
enum<string>

Initial task status

Available options:
pending,
processing
task_id
string

Task ID for the status polling endpoint