Generate video with SeeDance 2.5

curl --request POST \
  --url https://api.budgetpixel.com/v1/videos/seedance-2.5 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "aspect_ratio": "16:9",
  "end_image": "<string>",
  "generate_audio": true,
  "image": "<string>",
  "length_seconds": 5,
  "reference_audios": [
    "<string>"
  ],
  "reference_images": [
    "<string>"
  ],
  "reference_videos": [
    "<string>"
  ],
  "resolution": "720p"
}
'

import requests

url = "https://api.budgetpixel.com/v1/videos/seedance-2.5"

payload = {
    "prompt": "<string>",
    "aspect_ratio": "16:9",
    "end_image": "<string>",
    "generate_audio": True,
    "image": "<string>",
    "length_seconds": 5,
    "reference_audios": ["<string>"],
    "reference_images": ["<string>"],
    "reference_videos": ["<string>"],
    "resolution": "720p"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    prompt: '<string>',
    aspect_ratio: '16:9',
    end_image: '<string>',
    generate_audio: true,
    image: '<string>',
    length_seconds: 5,
    reference_audios: ['<string>'],
    reference_images: ['<string>'],
    reference_videos: ['<string>'],
    resolution: '720p'
  })
};

fetch('https://api.budgetpixel.com/v1/videos/seedance-2.5', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.budgetpixel.com/v1/videos/seedance-2.5",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'prompt' => '<string>',
    'aspect_ratio' => '16:9',
    'end_image' => '<string>',
    'generate_audio' => true,
    'image' => '<string>',
    'length_seconds' => 5,
    'reference_audios' => [
        '<string>'
    ],
    'reference_images' => [
        '<string>'
    ],
    'reference_videos' => [
        '<string>'
    ],
    'resolution' => '720p'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.budgetpixel.com/v1/videos/seedance-2.5"

	payload := strings.NewReader("{\n  \"prompt\": \"<string>\",\n  \"aspect_ratio\": \"16:9\",\n  \"end_image\": \"<string>\",\n  \"generate_audio\": true,\n  \"image\": \"<string>\",\n  \"length_seconds\": 5,\n  \"reference_audios\": [\n    \"<string>\"\n  ],\n  \"reference_images\": [\n    \"<string>\"\n  ],\n  \"reference_videos\": [\n    \"<string>\"\n  ],\n  \"resolution\": \"720p\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.budgetpixel.com/v1/videos/seedance-2.5")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prompt\": \"<string>\",\n  \"aspect_ratio\": \"16:9\",\n  \"end_image\": \"<string>\",\n  \"generate_audio\": true,\n  \"image\": \"<string>\",\n  \"length_seconds\": 5,\n  \"reference_audios\": [\n    \"<string>\"\n  ],\n  \"reference_images\": [\n    \"<string>\"\n  ],\n  \"reference_videos\": [\n    \"<string>\"\n  ],\n  \"resolution\": \"720p\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.budgetpixel.com/v1/videos/seedance-2.5")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"prompt\": \"<string>\",\n  \"aspect_ratio\": \"16:9\",\n  \"end_image\": \"<string>\",\n  \"generate_audio\": true,\n  \"image\": \"<string>\",\n  \"length_seconds\": 5,\n  \"reference_audios\": [\n    \"<string>\"\n  ],\n  \"reference_images\": [\n    \"<string>\"\n  ],\n  \"reference_videos\": [\n    \"<string>\"\n  ],\n  \"resolution\": \"720p\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "message": "<string>",
  "model": "<string>"
}

{
  "error": {
    "code": "model_not_available",
    "message": "<string>",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "model_not_available",
    "message": "<string>",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "model_not_available",
    "message": "<string>",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "model_not_available",
    "message": "<string>",
    "type": "invalid_request_error"
  }
}

ByteDance (SeeDance)

Generate video with SeeDance 2.5

ByteDance SeeDance 2.5 — flagship multimodal video. Text-to-video; image-to-video (start + optional end frame); and reference-to-video mixing up to 15 reference images (free), up to 5 reference video clips (2-15s each, 30s combined — billed per second of INPUT at half the output rate, see POST /v1/cost), and up to 5 reference audio clips (30s combined, free; audio-only input is supported). Video editing and extension are reference-video modes — no separate edit endpoint. Reference media can’t be combined with start/end frames. 480p/720p/1080p, any duration 4-30 seconds, optional audio.

Asynchronous. Returns a job id (the video is not in this response). Poll GET /v1/videos/{id} until status is succeeded — the video URL is in that response’s video_url.

POST

videos

seedance-2.5

Generate video with SeeDance 2.5

curl --request POST \
  --url https://api.budgetpixel.com/v1/videos/seedance-2.5 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "aspect_ratio": "16:9",
  "end_image": "<string>",
  "generate_audio": true,
  "image": "<string>",
  "length_seconds": 5,
  "reference_audios": [
    "<string>"
  ],
  "reference_images": [
    "<string>"
  ],
  "reference_videos": [
    "<string>"
  ],
  "resolution": "720p"
}
'

import requests

url = "https://api.budgetpixel.com/v1/videos/seedance-2.5"

payload = {
    "prompt": "<string>",
    "aspect_ratio": "16:9",
    "end_image": "<string>",
    "generate_audio": True,
    "image": "<string>",
    "length_seconds": 5,
    "reference_audios": ["<string>"],
    "reference_images": ["<string>"],
    "reference_videos": ["<string>"],
    "resolution": "720p"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    prompt: '<string>',
    aspect_ratio: '16:9',
    end_image: '<string>',
    generate_audio: true,
    image: '<string>',
    length_seconds: 5,
    reference_audios: ['<string>'],
    reference_images: ['<string>'],
    reference_videos: ['<string>'],
    resolution: '720p'
  })
};

fetch('https://api.budgetpixel.com/v1/videos/seedance-2.5', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.budgetpixel.com/v1/videos/seedance-2.5",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'prompt' => '<string>',
    'aspect_ratio' => '16:9',
    'end_image' => '<string>',
    'generate_audio' => true,
    'image' => '<string>',
    'length_seconds' => 5,
    'reference_audios' => [
        '<string>'
    ],
    'reference_images' => [
        '<string>'
    ],
    'reference_videos' => [
        '<string>'
    ],
    'resolution' => '720p'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.budgetpixel.com/v1/videos/seedance-2.5"

	payload := strings.NewReader("{\n  \"prompt\": \"<string>\",\n  \"aspect_ratio\": \"16:9\",\n  \"end_image\": \"<string>\",\n  \"generate_audio\": true,\n  \"image\": \"<string>\",\n  \"length_seconds\": 5,\n  \"reference_audios\": [\n    \"<string>\"\n  ],\n  \"reference_images\": [\n    \"<string>\"\n  ],\n  \"reference_videos\": [\n    \"<string>\"\n  ],\n  \"resolution\": \"720p\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.budgetpixel.com/v1/videos/seedance-2.5")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prompt\": \"<string>\",\n  \"aspect_ratio\": \"16:9\",\n  \"end_image\": \"<string>\",\n  \"generate_audio\": true,\n  \"image\": \"<string>\",\n  \"length_seconds\": 5,\n  \"reference_audios\": [\n    \"<string>\"\n  ],\n  \"reference_images\": [\n    \"<string>\"\n  ],\n  \"reference_videos\": [\n    \"<string>\"\n  ],\n  \"resolution\": \"720p\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.budgetpixel.com/v1/videos/seedance-2.5")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"prompt\": \"<string>\",\n  \"aspect_ratio\": \"16:9\",\n  \"end_image\": \"<string>\",\n  \"generate_audio\": true,\n  \"image\": \"<string>\",\n  \"length_seconds\": 5,\n  \"reference_audios\": [\n    \"<string>\"\n  ],\n  \"reference_images\": [\n    \"<string>\"\n  ],\n  \"reference_videos\": [\n    \"<string>\"\n  ],\n  \"resolution\": \"720p\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "message": "<string>",
  "model": "<string>"
}

{
  "error": {
    "code": "model_not_available",
    "message": "<string>",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "model_not_available",
    "message": "<string>",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "model_not_available",
    "message": "<string>",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "model_not_available",
    "message": "<string>",
    "type": "invalid_request_error"
  }
}

Authorizations

Authorization

string

header

required

API key as a bearer token: Authorization: Bearer bpx_live_xxx

Body

application/json

prompt

string

required

Text description of the video.

aspect_ratio

enum<string>

default:16:9

Aspect ratio for text-to-video. Ignored (adaptive) when a start frame or any reference media sets the frame.

Available options:

16:9,

9:16,

1:1,

4:3,

3:4,

21:9

end_image

string

Optional end frame, used together with image (the start frame) to interpolate the video between the two frames. Same input forms as image.

generate_audio

boolean

Generate audio with the video (no price impact).

image

string

Optional start frame for image-to-video. Provide a public image URL, a data URI, raw base64, or an uploaded-file URL from POST /v1/uploads. Omit for text-to-video. Can't be combined with reference media.

length_seconds

integer

default:5

Output video length in seconds (4-30).

Required range: 4 <= x <= 30

reference_audios

string[]

Optional reference audio clips (up to 5; each 2-15s, 30s combined; WAV/MP3) that guide sound/voice. Audio-only input is supported. Each item is a public audio URL or an uploaded-file URL from POST /v1/uploads. Free — no input billing. Can't be combined with image/end_image.

Maximum array length: 5

reference_images

string[]

Optional reference images (up to 15, free) that guide identity/style in reference-to-video mode. Each item is a public image URL, a data URI, raw base64, or an uploaded-file URL from POST /v1/uploads. Can't be combined with image/end_image.

Maximum array length: 15

reference_videos

string[]

Optional reference video clips (up to 5; each 2-15s, 30s combined; MP4/MOV, ≤50MB each) for editing, extension, and motion/identity guidance. Each item is a public video URL or an uploaded-file URL from POST /v1/uploads (videos are passed by URL, not inlined). Billed on the INPUT duration at half the output per-second rate (80/sec at 480p, 160/sec at 720p, 375/sec at 1080p) in addition to the output — estimate via POST /v1/cost. Can't be combined with image/end_image.

Maximum array length: 5

resolution

enum<string>

default:720p

Output resolution. Pricing varies by resolution — see resolution_pricing in GET /v1/models.

Available options:

480p,

720p,

1080p

Response

Job accepted.

string

Opaque job id — use it to poll status.

message

string

model

string

status

enum<string>

Lifecycle state. succeeded/failed/timeout are terminal.

Available options:

pending,

starting,

processing,

completing,

succeeded,

failed,

timeout

Account

Models

Files

Images

Videos

Music

Motion Control

Lip Sync

Classification

Conversions

Moderation

Social

Jobs

Generate video with SeeDance 2.5

Authorizations

Body

Response