# Seedance 2.5 (`seedance_2_5`)

> ByteDance Seedance 2.5 — the flagship Seedance model. High-quality video from text, with optional image (≤9), video (≤3), and audio (≤3) references. 480p/720p, 4-30s.

- Capability: Video (tool `video`) — Text to video, Image to video, Video to video
- Price: from $0.43 per run (1 credit = $0.01). Exact price for a request: POST https://api.varg.ai/v2/estimate
- Typical time: ~3 min
- JSON Schema: https://api.varg.ai/v2/tools/video?model=seedance_2_5 (public, no key)
- Try it: https://varg.ai/dashboard/tools/playground?model=seedance_2_5

## Call it

REST: `POST https://api.varg.ai/v2/tools/video/call` with `Authorization: Bearer $VARG_API_KEY` (create a key at https://varg.ai/dashboard/api).
It answers `202` with a job right away. Poll `GET /v2/jobs/{id}` until `status` is `completed`, then read `output.outputs[0].url` — or pass `options.webhook_url` and get the finished job POSTed to you.

```bash
curl -X POST https://api.varg.ai/v2/tools/video/call \
  -H "Authorization: Bearer $VARG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance_2_5",
  "prompt": "A cyberpunk city street at night, neon signs reflecting in puddles. A heavy-set woman in a worn military uniform stands breathing hard, out of shape. She begins military calisthenics — push-ups, burpees, mountain climbers — her body transforming in real-time: fat melting away, muscles defining, posture straightening. Holographic HUD overlays track her progress with glowing stats. Rain falls around her as she powers through the workout, her uniform tightening as she becomes lean and athletic. The transformation completes — she stands as a fit soldier-athlete, rain-soaked, neon-lit, triumphant. Cinematic, dramatic lighting, cyberpunk aesthetic.",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5
}'
```

MCP: the varg server `https://mcp.varg.ai/mcp` (OAuth sign-in, no key) runs it with `call_tool`:

```json
{
  "tool": "video",
  "input": {
    "model": "seedance_2_5",
    "prompt": "A cyberpunk city street at night, neon signs reflecting in puddles. A heavy-set woman in a worn military uniform stands breathing hard, out of shape. She begins military calisthenics — push-ups, burpees, mountain climbers — her body transforming in real-time: fat melting away, muscles defining, posture straightening. Holographic HUD overlays track her progress with glowing stats. Rain falls around her as she powers through the workout, her uniform tightening as she becomes lean and athletic. The transformation completes — she stands as a fit soldier-athlete, rain-soaked, neon-lit, triumphant. Cinematic, dramatic lighting, cyberpunk aesthetic.",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  },
  "wait": true
}
```

## Inputs

| field | type | required | default | allowed | description |
|---|---|---|---|---|---|
| `model` | string | yes | — | `seedance_2_5` or a route key below | Which model runs the job. |
| `prompt` | string | no | — | — | — |
| `files` | array of { url } | no | — | — | — |
| `aspect_ratio` | string | no | — | e.g. 16:9 \| 9:16 \| 1:1 \| 4:3 \| 3:4 \| 21:9 \| auto | — |
| `resolution` | string | no | — | 480p \| 720p \| 1080p \| 4k | Quality tier. Supported by this model: 480p, 720p, 1080p. Unsupported tiers fall back to the nearest available. |
| `audio` | boolean | no | — | — | Set true to generate the video with a native audio track. |
| `duration` | integer | no | — | 4–30 | Length in seconds. Supported by this model's routes: piapi: integer 4-30 or -1; byteplus: integer 4-30 or -1 or "auto"; fal: 4-30 or "auto". A non-numeric value such as "auto" is routed to a route whose schema accepts it; when none does, the request is rejected. |

Media inputs are URLs. Upload a local file first with `POST /v2/files` and pass the returned URL.

## Provider options

Optional, per provider, under `provider_options.<provider>`. Only the options of the provider that runs the job apply — pin a route to choose it.

### provider_options.piapi

| field | type | required | default | allowed | description |
|---|---|---|---|---|---|
| `input.mode` | string | no | — | first_last_frames \| omni_reference \| text_to_video | — |
| `input.audio` | boolean | no | — | — | No audio generated if false |
| `input.prompt` | string | no | — | — | The text prompt describing the video to generate. Reference media with @image1, @video1, @audio1 etc. (1-based position within each media type). |
| `input.audio_urls` | array of URL strings | no | — | — | — |
| `input.image_urls` | array of URL strings | no | — | — | — |
| `input.resolution` | string | no | — | 480p \| 720p \| 1080p | — |
| `input.video_urls` | array of URL strings | no | — | — | — |
| `input.aspect_ratio` | string | no | — | 1:1 \| 16:9 \| 21:9 \| 3:4 \| 4:3 \| 9:16 \| adaptive | — |
| `input.auto_upload_assets` | boolean | no | — | — | less-restriction only: auto-ingest raw URLs as ephemeral private assets |
| `input.asset_retention_hours` | integer | no | — | 3–8 | — |
| `input.omni_reference_task_type` | string | no | — | auto \| edit \| extend \| reference | — |
| `task_type` | string | no | — | — | Fixed by the route; ignored here. To run a specific route, send its model key as the model (piapi:seedance-2.5-less-restriction, piapi:seedance-2.5). |

### provider_options.byteplus

| field | type | required | default | allowed | description |
|---|---|---|---|---|---|
| `ratio` | string | no | — | 16:9 \| 4:3 \| 1:1 \| 3:4 \| 9:16 \| 21:9 \| adaptive | — |
| `duration` | integer | no | — | 4–30 | — |
| `watermark` | boolean | no | — | — | — |
| `resolution` | string | no | — | 480p \| 720p \| 1080p | — |
| `output_format` | string | no | — | mp4 \| mov | — |
| `generate_audio` | boolean | no | — | — | Generate a native audio track. |
| `return_last_frame` | boolean | no | — | — | Also return the last frame as an image URL (chain clips). |
| `safety_identifier` | string | no | — | — | — |
| `execution_expires_after` | integer | no | — | 3600–21600 | Seconds a task may wait in the queue before it expires unrun (default 1 h, the BytePlus minimum — an expired task fails over to the next provider; at most 6 h — the job times out at 7 h). |
| `omni_reference_task_type` | string | no | — | auto \| reference \| edit \| extend | — |

### provider_options.fal

| field | type | required | default | allowed | description |
|---|---|---|---|---|---|
| `prompt` | string | no | — | — | The text prompt used to generate the video |
| `audio_urls` | array of URL strings | no | — | — | — |
| `image_urls` | array of URL strings | no | — | — | — |
| `video_urls` | array of URL strings | no | — | — | — |
| `duration` | string | no | — | 4 \| 5 \| 6 \| 7 \| 8 \| 9 \| 10 \| 11 \| 12 \| 13 \| 14 \| 15 \| 16 \| 17 \| 18 \| 19 \| 20 \| 21 \| 22 \| 23 \| 24 \| 25 \| 26 \| 27 \| 28 \| 29 \| 30 \| auto | — |
| `resolution` | string | no | — | 480p \| 720p \| 1080p | — |
| `end_user_id` | string | no | — | — | — |
| `aspect_ratio` | string | no | — | e.g. 16:9 \| 9:16 \| 1:1 \| 4:3 \| 3:4 \| 21:9 \| auto | Always auto for image-to-video (follows the image). |
| `bitrate_mode` | string | no | — | standard \| high | — |
| `generate_audio` | boolean | no | — | — | — |
| `image_url` | string (URL) | no | — | — | The URL of the starting frame image to animate. JPEG/PNG/WebP, max 30 MB. |
| `end_image_url` | string (URL) | no | — | — | Optional last-frame image; the video transitions from image_url to it. |
| `seed` | integer | no | — | -9007199254740991–9007199254740991 | — |
| `task` | string | no | — | reference \| editing \| extension | — |

## Routes

`"model": "seedance_2_5"` picks a route automatically (priority order, then the inputs you send). To pin one, pass its key as `model`.

| model key | provider | modality | price from | typical time |
|---|---|---|---|---|
| `piapi:seedance-2.5-less-restriction` | piapi | text-to-video, image-to-video | $0.73 | ~5 min |
| `piapi:seedance-2.5` | piapi | text-to-video, image-to-video | $0.66 | ~5 min |
| `byteplus:dreamina-seedance-2-5-260628` | byteplus | text-to-video, image-to-video, video-to-video | $0.43 | ~3 min |
| `fal:bytedance/seedance-2.5/text-to-video` | fal | text-to-video | $0.89 | ~4 min |
| `fal:bytedance/seedance-2.5/image-to-video` | fal | image-to-video | $0.89 | ~4 min |
| `fal:bytedance/seedance-2.5/reference-to-video` | fal | image-to-video, video-to-video | $0.89 | ~4 min |
| `byteplus:dreamina-seedance-2-5-260628-less-restriction` | byteplus | text-to-video, image-to-video, video-to-video | $0.43 | ~4 min |

---

Catalog version 2026-11-11T12:59:09.901887+00:00. All models: https://varg.ai/models/llms.txt