curl -X POST https://api.vibetool.ai/v1/videos/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-text-to-video",
"prompt": "a mountain river flowing through a pine forest at dawn, drone shot, cinematic",
"duration": 8,
"quality": "720p"
}'
import requests
url = "https://api.vibetool.ai/v1/videos/generations"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
}
payload = {
"model": "seedance-2.5-text-to-video",
"prompt": "a mountain river flowing through a pine forest at dawn, drone shot, cinematic",
"duration": 8,
"quality": "720p"
}
r = requests.post(url, json=payload, headers=headers, timeout=60)
print(r.status_code, r.json())
const response = await fetch("https://api.vibetool.ai/v1/videos/generations", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "seedance-2.5-text-to-video",
prompt: "a mountain river flowing through a pine forest at dawn, drone shot, cinematic",
duration: 8,
quality: "720p"
})
});
const data = await response.json();
console.log(data);
package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
)
func main() {
payload := map[string]interface{}{
"model": "seedance-2.5-text-to-video",
"prompt": "a mountain river flowing through a pine forest at dawn, drone shot, cinematic",
"duration": 8,
"quality": "720p",
}
b, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://api.vibetool.ai/v1/videos/generations", bytes.NewReader(b))
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
var result map[string]interface{}
json.NewDecoder(resp.Body).Decode(&result)
fmt.Println(result)
}
{
"id": "gen_vid_abc123",
"object": "video.generation",
"model": "seedance-2.5-text-to-video",
"created_at": 1786549095,
"status": "pending",
"task_id": "vid_202608130137_444412dd"
}
{
"error": {
"message": "The prompt field is required",
"type": "invalid_request_error",
"param": "prompt",
"code": 400
}
}
Seedance Series
Seedance 2.5 Text To Video
ByteDance’s latest video model for generating 480p/720p video from natural-language prompts, with native audio, flexible aspect ratios, and per-second billing via Vibetool’s asynchronous API.
POST
/
v1
/
videos
/
generations
curl -X POST https://api.vibetool.ai/v1/videos/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-text-to-video",
"prompt": "a mountain river flowing through a pine forest at dawn, drone shot, cinematic",
"duration": 8,
"quality": "720p"
}'
import requests
url = "https://api.vibetool.ai/v1/videos/generations"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
}
payload = {
"model": "seedance-2.5-text-to-video",
"prompt": "a mountain river flowing through a pine forest at dawn, drone shot, cinematic",
"duration": 8,
"quality": "720p"
}
r = requests.post(url, json=payload, headers=headers, timeout=60)
print(r.status_code, r.json())
const response = await fetch("https://api.vibetool.ai/v1/videos/generations", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "seedance-2.5-text-to-video",
prompt: "a mountain river flowing through a pine forest at dawn, drone shot, cinematic",
duration: 8,
quality: "720p"
})
});
const data = await response.json();
console.log(data);
package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
)
func main() {
payload := map[string]interface{}{
"model": "seedance-2.5-text-to-video",
"prompt": "a mountain river flowing through a pine forest at dawn, drone shot, cinematic",
"duration": 8,
"quality": "720p",
}
b, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://api.vibetool.ai/v1/videos/generations", bytes.NewReader(b))
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
var result map[string]interface{}
json.NewDecoder(resp.Body).Decode(&result)
fmt.Println(result)
}
{
"id": "gen_vid_abc123",
"object": "video.generation",
"model": "seedance-2.5-text-to-video",
"created_at": 1786549095,
"status": "pending",
"task_id": "vid_202608130137_444412dd"
}
{
"error": {
"message": "The prompt field is required",
"type": "invalid_request_error",
"param": "prompt",
"code": 400
}
}
Pricing: See vibetool.ai/pricing for current rates.
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_KEYRequest 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.
curl -X POST https://api.vibetool.ai/v1/videos/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-text-to-video",
"prompt": "a mountain river flowing through a pine forest at dawn, drone shot, cinematic",
"duration": 8,
"quality": "720p"
}'
import requests
url = "https://api.vibetool.ai/v1/videos/generations"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
}
payload = {
"model": "seedance-2.5-text-to-video",
"prompt": "a mountain river flowing through a pine forest at dawn, drone shot, cinematic",
"duration": 8,
"quality": "720p"
}
r = requests.post(url, json=payload, headers=headers, timeout=60)
print(r.status_code, r.json())
const response = await fetch("https://api.vibetool.ai/v1/videos/generations", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "seedance-2.5-text-to-video",
prompt: "a mountain river flowing through a pine forest at dawn, drone shot, cinematic",
duration: 8,
quality: "720p"
})
});
const data = await response.json();
console.log(data);
package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
)
func main() {
payload := map[string]interface{}{
"model": "seedance-2.5-text-to-video",
"prompt": "a mountain river flowing through a pine forest at dawn, drone shot, cinematic",
"duration": 8,
"quality": "720p",
}
b, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://api.vibetool.ai/v1/videos/generations", bytes.NewReader(b))
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
var result map[string]interface{}
json.NewDecoder(resp.Body).Decode(&result)
fmt.Println(result)
}
{
"id": "gen_vid_abc123",
"object": "video.generation",
"model": "seedance-2.5-text-to-video",
"created_at": 1786549095,
"status": "pending",
"task_id": "vid_202608130137_444412dd"
}
{
"error": {
"message": "The prompt field is required",
"type": "invalid_request_error",
"param": "prompt",
"code": 400
}
}
task_id until status is "completed" and the generated video URL is available.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Use seedance-2.5-text-to-video.
Available options:
seedance-2.5-text-to-video Text description of the video to generate
Duration in seconds (4-30)
Required range:
4 <= x <= 30Output resolution tier
Available options:
480p, 720p Available options:
adaptive, 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 Was this page helpful?