ByteDancevideoNewUnavailable

Seedance 2.5 Reference to Video API

Name: Seedance 2.5 API
Brand: ByteDance
Availability: OutOfStock

Reference to Video with Seedance 2.5 by ByteDance. ByteDance's newest video model — longer, sharper, more controllable.

bytedance/seedance-2.5/reference-to-video

FromUp to −14%

$0.092/s$0.107

per second of video · 480p

Open in Studio API

Try Seedance 2.5 Reference to Video

Prompt*

Type @ to point at a reference image, video or audio clip0/5000

Reference images

Up to 30 images for characters, products, style or scene. Refer to them in the prompt as @Image1, @Image2…

Reference videos

Up to 10 MP4/MOV clips for motion, camera moves or effects (2–30 s each, 30 s in total, ≤ 200 MB each). Refer to them as @Video1, @Video2… Reference-video seconds are billed together with the output, at the lower with-video token rate.

Reference audio

Up to 10 MP3/WAV clips for voice, music or sound (2–30 s each, 30 s in total, ≤ 15 MB each). Refer to them as @Audio1, @Audio2…

Aspect ratio

Output frame shape.

Resolution

Output resolution. Higher resolutions cost more per second.

Duration

Length of the generated clip in seconds (4–15s). You pay per second.

Generate audio

Generate synchronized sound, ambience and dialogue. No extra cost.

Estimated cost…

Create a free account with Google or email — pay only for what you generate.

Your video will appear here

Write a prompt, pick your settings and hit Run. You only pay for successful generations.

Also available: Seedance 2.5 Text to Video · Seedance 2.5 Image to Video

Seedance 2.5 Reference to Video API

POST/api/v1/run/bytedance/seedance-2.5/reference-to-video

Submits an asynchronous job and returns 202 with a generation id. Poll GET /api/v1/generations/{id} or pass webhook_url. See job lifecycle.

Input parameters

Name	Type	Description	Affects price
`prompt`required	string	Describe the shot: subject, action, camera movement, lighting and style.	No
`reference_image_urls`	string[] (URLs)	Up to 30 images for characters, products, style or scene. Refer to them in the prompt as @Image1, @Image2… Max items: 30	No
`reference_video_urls`	string[] (video URLs)	Up to 10 MP4/MOV clips for motion, camera moves or effects (2–30 s each, 30 s in total, ≤ 200 MB each). Refer to them as @Video1, @Video2… Reference-video seconds are billed together with the output, at the lower with-video token rate. Max items: 10	Yes
`reference_audio_urls`	string[] (audio URLs)	Up to 10 MP3/WAV clips for voice, music or sound (2–30 s each, 30 s in total, ≤ 15 MB each). Refer to them as @Audio1, @Audio2… Max items: 10	No
`aspect_ratio`	string (enum)	Output frame shape. Values: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 Default: 16:9	Yes
`resolution`	string (enum)	Output resolution. Higher resolutions cost more per second. Values: 480p · 720p · 1080p Default: 720p	Yes
`duration`	integer	Length of the generated clip in seconds (4–15s). You pay per second. Range: 4–15s Default: 5	Yes
`generate_audio`	boolean	Generate synchronized sound, ambience and dialogue. No extra cost. Default: true	No
`seed`	integer	Use the same seed and settings to reproduce a result. Leave empty for random.	No
`webhook_url`	string (URL)	Optional. We POST the finished generation here, signed with your webhook secret. Webhooks	No

Request

curl -X POST https://cheapergen.com/api/v1/run/bytedance/seedance-2.5/reference-to-video \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "@Image1 unboxes the product from @Image2 on a marble desk, copying the camera move of @Video1",
  "reference_image_urls": [
    "https://cdn.cheapergen.ai/samples/reference-1.jpg",
    "https://cdn.cheapergen.ai/samples/reference-2.jpg"
  ],
  "reference_video_urls": [
    "https://cdn.cheapergen.ai/samples/reference-1.mp4"
  ],
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5
}'

import os, time, requests

API = "https://cheapergen.com/api/v1"
headers = {"Authorization": f"Bearer {os.environ['CHEAPERGEN_API_KEY']}"}

# 1. Submit the job
job = requests.post(f"{API}/run/bytedance/seedance-2.5/reference-to-video", headers=headers, json={
    "prompt": "@Image1 unboxes the product from @Image2 on a marble desk, copying the camera move of @Video1",
    "reference_image_urls": [
        "https://cdn.cheapergen.ai/samples/reference-1.jpg",
        "https://cdn.cheapergen.ai/samples/reference-2.jpg"
    ],
    "reference_video_urls": [
        "https://cdn.cheapergen.ai/samples/reference-1.mp4"
    ],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
}).json()

# 2. Poll until it finishes (or pass "webhook_url" and skip polling)
while job["status"] in ("queued", "running"):
    time.sleep(3)
    job = requests.get(f"{API}/generations/{job['id']}", headers=headers).json()

print(job["status"], job["output"]["video"]["url"] if job["status"] == "succeeded" else job["error"])

const API = "https://cheapergen.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Submit the job
let job = await fetch(`${API}/run/bytedance/seedance-2.5/reference-to-video`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "@Image1 unboxes the product from @Image2 on a marble desk, copying the camera move of @Video1",
    "reference_image_urls": [
      "https://cdn.cheapergen.ai/samples/reference-1.jpg",
      "https://cdn.cheapergen.ai/samples/reference-2.jpg"
    ],
    "reference_video_urls": [
      "https://cdn.cheapergen.ai/samples/reference-1.mp4"
    ],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  }),
}).then((r) => r.json());

// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 3000));
  job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}

console.log(job.status === "succeeded" ? job.output.video.url : job.error);

Response

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "bytedance/seedance-2.5",
  "endpoint": "bytedance/seedance-2.5/reference-to-video",
  "mode": "reference-to-video",
  "status": "queued",
  "input": {
    "prompt": "@Image1 unboxes the product from @Image2 on a marble desk, copying the camera move of @Video1",
    "reference_image_urls": [
      "https://cdn.cheapergen.ai/samples/reference-1.jpg",
      "https://cdn.cheapergen.ai/samples/reference-2.jpg"
    ],
    "reference_video_urls": [
      "https://cdn.cheapergen.ai/samples/reference-1.mp4"
    ],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  },
  "output": null,
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": true,
    "official_usd": null,
    "saved_usd": null
  },
  "source": "api",
  "started_at": null,
  "completed_at": null,
  "urls": {
    "get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
    "cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
  },
  "created_at": "2026-10-15T09:21:04Z"
}

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "bytedance/seedance-2.5",
  "endpoint": "bytedance/seedance-2.5/reference-to-video",
  "mode": "reference-to-video",
  "status": "succeeded",
  "input": {
    "prompt": "@Image1 unboxes the product from @Image2 on a marble desk, copying the camera move of @Video1",
    "reference_image_urls": [
      "https://cdn.cheapergen.ai/samples/reference-1.jpg",
      "https://cdn.cheapergen.ai/samples/reference-2.jpg"
    ],
    "reference_video_urls": [
      "https://cdn.cheapergen.ai/samples/reference-1.mp4"
    ],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  },
  "output": {
    "video": {
      "url": "https://cdn.cheapergen.ai/outputs/gen_8c2Q.mp4",
      "content_type": "video/mp4",
      "duration": 5,
      "width": 1280,
      "height": 720
    }
  },
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": false,
    "official_usd": 0.264,
    "saved_usd": 0.0385
  },
  "source": "api",
  "created_at": "2026-10-15T09:21:04Z",
  "started_at": "2026-10-15T09:21:06Z",
  "completed_at": "2026-10-15T09:22:31Z"
}

Seedance 2.5 pricing

Pay per second of video. No subscription. Failed generations are refunded automatically.

Tier	Official price	Cheaper Gen.	You save
480p 16:9 · 24 fps	~~$0.107~~/s	$0.092/s	−14%
720p 16:9 · 24 fps	~~$0.231~~/s	$0.198/s	−14%
1080p 16:9 · 24 fps	~~$0.569~~/s	$0.491/s	−14%

Official price: BytePlus ModelArk official price ($10.7 / 1M tokens at 480p–720p, $11.7 at 1080p; with video input $6.4 / $7). Prices verified 2026-10-14.
Billed by video tokens; per-second figures assume 16:9 and no input video.
With reference videos, (reference video seconds + output seconds) are billed at the lower with-video token rate.

About Seedance 2.5 All Seedance 2.5 endpoints