BYOK is live — 1,000,000 free BYOK requests every month, no top-up requiredLearn more

Video model · ByteDance

ByteDance Seedance 2.5 API — price and setup

seedance-2.5

Generate ByteDance Seedance 2.5 videos with one BoostRail key: submit a task, poll it, download the MP4. Billed in USD per second of video; failed tasks are not charged.

LabByteDance
From$0.2195 / sec
Clip length5 or 10 seconds
Aspect ratio16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9
AudioGenerated with the video

Price per second

One price per spec, billed on the seconds you request. Prices follow the live catalog.

SpecPrice per second
720p$0.2195 / sec
1080p$0.5401 / sec

What the API accepts

  • Input: Text prompt (text to video), Image (image to video)
  • Reference images: Accepted
  • Clip length: 5 or 10 seconds
  • For vertical short-drama clips, send upstream_options with aspect_ratio set to 9:16.

Submit, poll, download

The video API is asynchronous. Submitting returns a task id; poll it until the status is succeeded, then download the MP4 from the signed link in data[0].url, which is valid for 10 minutes.

# 1. Submit the task
curl https://api.boostrail.com/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"seedance-2.5","prompt":"A woman in a red coat stops in the rain, turns to the camera and smiles","seconds":5,"size":"720p","upstream_options":{"aspect_ratio":"9:16"}}'

# 2. Poll every 10 seconds until status is succeeded, failed, cancelled or expired
curl https://api.boostrail.com/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

# 3. Download from data[0].url (a signed link, valid for 10 minutes)
curl -L -o clip.mp4 "SIGNED_URL"
import time, requests

API = "https://api.boostrail.com/v1"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

task = requests.post(f"{API}/videos", headers=HEADERS, json={
    "model": "seedance-2.5",
    "prompt": "A woman in a red coat stops in the rain, turns to the camera and smiles",
    "seconds": 5,
    "size": "720p",
    "upstream_options": {"aspect_ratio": "9:16"},
}).json()

while True:
    status = requests.get(f"{API}/videos/{task['id']}", headers=HEADERS).json()
    if status["status"] in ("succeeded", "failed", "cancelled", "expired"):
        break
    time.sleep(10)

if status["status"] == "succeeded":
    video = requests.get(status["data"][0]["url"])  # signed link, valid for 10 minutes
    with open("clip.mp4", "wb") as f:
        f.write(video.content)
else:
    print(status["error"])  # failed tasks are not charged

Good to know

  • Failed, cancelled and expired tasks are not charged.
  • Download finished videos soon: the generated file is kept for about 24 hours.

Questions about ByteDance Seedance 2.5

How much does ByteDance Seedance 2.5 cost on BoostRail?

seedance-2.5 is billed per second of video: 720p $0.2195, 1080p $0.5401. Failed tasks are not charged.

How long can a ByteDance Seedance 2.5 clip be?

5 or 10 seconds per request. Longer scenes are made by joining several clips in editing.

Can ByteDance Seedance 2.5 make vertical 9:16 video?

Yes. Send upstream_options with aspect_ratio set to 9:16. Accepted ratios: 16:9, 9:16, 1:1, 4:3, 3:4, 21:9.

Does ByteDance Seedance 2.5 accept reference images?

Yes. Pass up to 4 public https image URLs in input_reference, each at least 300 × 300 pixels. The model takes subject and style from them; the first frame is not locked to the image. The price is the same as text to video, and a request rejected for an image that is too small is not charged.

Does ByteDance Seedance 2.5 generate sound?

Yes. The MP4 comes with an audio track generated with the video. Music and subtitles are easier to control when added in editing.

What happens when a ByteDance Seedance 2.5 task fails?

Failed, cancelled and expired tasks are not charged; the amount held when you submitted is released.

How long can I download a finished ByteDance Seedance 2.5 video?

The signed link in data[0].url is valid for 10 minutes; poll the task again for a fresh link. content_expires_at in the task response shows how long the file stays available. The generated file is kept for about 24 hours, so download it soon.

More on video

Last updated: 2026-11-22