Skip to main content
POST
Pricing: See vibetool.ai/pricing for current rates.
This endpoint creates a new video generation task. Seedance 2.0 accepts multimodal inputs (video, image, text) and produces a short video. The task runs asynchronously; use the returned task_id to poll for completion with the Get Video Result endpoint.
The generated video is available for 24 hours after completion. Download it promptly via the video_url returned in the status response.

Authorization

string
required
All API requests require Bearer Token authentication. Format: Bearer YOUR_API_KEY

Request Body

string
required
URL or base64-encoded data of the reference video. Maximum duration of 10 seconds recommended.
string
default:"null"
A text description to guide the video generation. Can be omitted if using a reference video or image.
string
default:"null"
URL or base64-encoded data of an optional reference image to influence the style or composition.
number
default:"4"
Desired video duration in seconds. Seedance 2.0 supports up to 10 seconds.
string
default:"16:9"
Aspect ratio of the output video. Supported: 16:9, 9:16, 1:1, 4:3, 3:4.

Response Schema

string
required
Unique identifier for the generation task. Use this with the status endpoint to track progress.
string
required
Initial task status. Always "pending" upon creation.
integer
required
Unix timestamp (seconds) of task creation.
After receiving a task_id, you can poll the Get Video Result endpoint every few seconds until status becomes "completed" or "failed". Results include the download URL and duration.
For best quality with human subjects, we recommend providing a reference video at least 2 seconds long and a clear description of the desired motion.

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.0-reference-to-video.

Available options:
seedance-2.0-reference-to-video
reference_video
string<uri>
required

Reference video URL

prompt
string

Text description of the video to generate

reference_image
string<uri>

Reference image URL

duration
number
default:4

Duration in seconds

aspect_ratio
string
default:16:9

Output aspect ratio

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