# OpenRouter APIs — ByteDance: Seedance 2.0 Mini (bytedance/seedance-2.0-mini)

Guide for calling every confirmed OpenRouter API that serves `bytedance/seedance-2.0-mini`.

Model page: https://openrouter.ai/bytedance/seedance-2.0-mini
Create an API key: https://openrouter.ai/settings/keys

## Pricing

Standard-variant prices for `bytedance/seedance-2.0-mini`, per provider, in the unit each provider bills (tokens, images, seconds of video, or characters of audio). Pay-as-you-go with no markup on the provider's price.

- Seed: from $0.03363/second (plus 5 more; see the model page for the full price list)

Full price table, including other variants and per-request charges: https://openrouter.ai/bytedance/seedance-2.0-mini
How OpenRouter prices requests: https://openrouter.ai/pricing

## EU in-region routing

`bytedance/seedance-2.0-mini` is not currently available through EU in-region routing.

Docs: https://openrouter.ai/docs/guides/features/in-region-routing

## Authentication

Send this header with every request:

- Authorization: Bearer $OPENROUTER_API_KEY

## Video API

Generate videos with `bytedance/seedance-2.0-mini` through OpenRouter's Video API.

Docs: https://openrouter.ai/docs/guides/overview/multimodal/video-generation
Model discovery API: https://openrouter.ai/api/v1/videos/models

### Endpoint

POST https://openrouter.ai/api/v1/videos

Headers:
- Content-Type: application/json

Generation is asynchronous: the submit call returns a job, which is polled until it
finishes. The finished video is downloaded from the job, not returned inline.

### Request fields (bytedance/seedance-2.0-mini)

- model: string (required) — `"bytedance/seedance-2.0-mini"`
- prompt: string (optional when frame_images is set, otherwise required) — text description of the desired video
- duration: 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 (optional) — length of the video in seconds
- size: "480x480" | "480x640" | "480x854" | "640x480" | "854x480" | "1120x480" | "720x720" | "720x960" | "720x1280" | "720x1680" | "960x720" | "1280x720" | "1680x720" (optional) — exact pixel dimensions, as WIDTHxHEIGHT
- resolution: "480p" | "720p" (optional) — resolution tier; interchangeable with size when paired with aspect_ratio
- aspect_ratio: "1:1" | "3:4" | "9:16" | "4:3" | "16:9" | "21:9" | "9:21" (optional) — aspect ratio of the generated video
- frame_images: array of frame references (optional) — images to condition the named frame on, as `{ "type": "image_url", "image_url": { "url": "…" }, "frame_type": "first_frame" }` entries; frame_type is one of "first_frame" | "last_frame", and the url is an https URL or a base64 data URL
- input_references: array of reference assets (optional) — images to guide the generation, as `{ "type": "image_url", "image_url": { "url": "…" } }` entries
- generate_audio: boolean (optional) — generate audio alongside the video
- seed: integer (optional) — sample deterministically; determinism is not guaranteed for every provider
- callback_url: string (optional) — https URL notified by webhook when the job finishes, instead of polling

These are the generation parameters this model accepts between its providers; an unlisted
value is rejected, and a listed one can still be refused by whichever provider serves the
call. `provider` (routing preferences) is accepted on every request.

### Response

The submit call returns `202` with the job:

```json
{
  "id": "job-abc123",
  "generation_id": "gen-xyz789",
  "polling_url": "/api/v1/videos/job-abc123",
  "status": "pending"
}
```

Poll `GET https://openrouter.ai/api/v1/videos/{id}` with the same Authorization header while `status` is
`pending` or `in_progress`, and stop once it is `completed`, `failed`, `cancelled`, or
`expired`:

```json
{
  "id": "job-abc123",
  "status": "completed",
  "unsigned_urls": ["https://storage.example.com/video.mp4"],
  "usage": { "cost": 0.5 }
}
```

Download the bytes from `GET https://openrouter.ai/api/v1/videos/{id}/content` (`?index=N` selects a clip
when the job produced more than one). `usage.cost` is the USD charge for the call.

### Examples

#### Text to Video

```bash
curl -X POST https://openrouter.ai/api/v1/videos \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bytedance/seedance-2.0-mini",
  "prompt": "a slow cinematic push-in on a glowing neon sign that reads \"OpenRouter\" in the window of a cozy coffee shop on a rainy night, rain streaking down the glass, reflections rippling on wet pavement",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}'
```

#### Image to Video

```bash
curl -X POST https://openrouter.ai/api/v1/videos \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bytedance/seedance-2.0-mini",
  "prompt": "Bring this photo to life: a slow cinematic push-in on the storefront as its sign flickers warmly and people stroll past in the blue-hour dusk.",
  "duration": 5,
  "frame_images": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://model-assets.openrouter.ai/model-examples/bytedance/seedance-2.0-mini-20260811/28f7652e-e8bf-47b7-8a58-6cfa18ad8d4d/input-0.png"
      },
      "frame_type": "first_frame"
    }
  ]
}'
```

#### Video to Video

```bash
curl -X POST https://openrouter.ai/api/v1/videos \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bytedance/seedance-2.0-mini",
  "prompt": "Turn this scene into a snowy winter night: snow falling and settling on the sidewalk and bicycle, frost creeping across the windows, keeping the original camera move and the glowing OpenRouter sign.",
  "duration": 5,
  "input_references": [
    {
      "type": "video_url",
      "video_url": {
        "url": "https://model-assets.openrouter.ai/model-examples/bytedance/seedance-2.0-mini-20260811/c6e956e5-b3c5-4cf4-b04b-4c3ac3c2e73f/input-video-0.mp4"
      }
    }
  ]
}'
```

#### Image + Audio to Video

```bash
curl -X POST https://openrouter.ai/api/v1/videos \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bytedance/seedance-2.0-mini",
  "prompt": "Bring this storefront photo to life as a short ad: a slow push-in at dusk as people stroll past, with the reference voiceover as narration.",
  "duration": 5,
  "input_references": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://model-assets.openrouter.ai/model-examples/black-forest-labs/flux-3-image-20261001/bab10114-feb0-49da-bb01-e7f659474293/original-0.png"
      }
    },
    {
      "type": "audio_url",
      "audio_url": {
        "url": "https://model-assets.openrouter.ai/model-examples/minimax/speech-2.8-hd-20260716/82758d34-58ee-40cf-96ed-853481149e6d/original-0.mp3"
      }
    }
  ]
}'
```

### Error differences

- 404 also covers an unknown video job
- 500 — the job could not be submitted

A job that fails after acceptance reports `status: "failed"` with an `error` message rather than
an HTTP error, since the submit call already succeeded.

## Errors

Failures return `{"error": {"code": <number>, "message": <string>}}` with the HTTP status:

- 400 — malformed request or an unsupported parameter
- 401 — missing or invalid API key
- 402 — insufficient credits
- 403 — spend limit reached, key disabled, or access blocked
- 404 — unknown model or no provider can serve the request
- 429 — rate limited; retry with backoff
- 502 — the operation failed upstream; failed generations are not billed

---

Canonical version of this document: https://openrouter.ai/bytedance/seedance-2.0-mini/llms.txt