> ## Documentation Index
> Fetch the complete documentation index at: https://docs.routerbase.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Doubao-Seedance 2.0 — Image to Video

> Animate a still image into a 3–12s video with Doubao-Seedance 2.0 at 720p or 1080p.

|              |                               |
| ------------ | ----------------------------- |
| **Model ID** | `bytedance/seedance-2-i2v`    |
| **Family**   | `seedance-2`                  |
| **Task**     | `image-to-video`              |
| **Modality** | Video                         |
| **Upstream** | ByteDance Doubao-Seedance 2.0 |

## Endpoint

```http theme={null}
POST https://routerbase.com/v1/videos/generations
```

Async — returns `{id, status: "pending"}`; poll
`GET /v1/videos/generations/{id}` until `success` or `failed`.

## Parameters

<ParamField body="prompt" type="string" required>
  Text prompt guiding how the first-frame image should animate. Max 5000
  characters.
</ParamField>

<ParamField body="image_urls" type="string[]" required>
  Single-element array with the first-frame image URL (public HTTPS).
  `min_items: 1, max_items: 1`.
</ParamField>

<ParamField body="resolution" type="&#x22;720p&#x22; | &#x22;1080p&#x22;" default="&#x22;1080p&#x22;">
  Output resolution. Standard supports both; Fast is 720p-only.
</ParamField>

<ParamField body="ratio" type="&#x22;16:9&#x22; | &#x22;9:16&#x22; | &#x22;1:1&#x22; | &#x22;4:3&#x22; | &#x22;3:4&#x22; | &#x22;21:9&#x22;" default="&#x22;16:9&#x22;">
  Aspect ratio of the generated video.
</ParamField>

<ParamField body="duration" type="integer" default="5">
  Length of the generated clip in seconds. Range `[3, 12]`.
</ParamField>

<ParamField body="generate_audio" type="boolean" default="false">
  Generate a native audio track alongside the video (Standard tier).
</ParamField>

<ParamField body="seed" type="integer">
  Random-generator initialiser. Range `[0, 2147483647]`.
</ParamField>

## Example

```bash theme={null}
curl https://routerbase.com/v1/videos/generations \
  -H "Authorization: Bearer $ROUTERBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2-i2v",
    "prompt": "the character turns and smiles, camera slowly zooms in",
    "image_urls": ["https://example.com/first-frame.jpg"],
    "resolution": "1080p",
    "duration": 5
  }'
```

```json theme={null}
{ "id": "task_abc123…", "status": "pending", "model": "bytedance/seedance-2-i2v" }
```

Poll until terminal:

```bash theme={null}
curl https://routerbase.com/v1/videos/generations/task_abc123… \
  -H "Authorization: Bearer $ROUTERBASE_API_KEY"
```

```json theme={null}
{
  "id": "task_abc123…",
  "status": "success",
  "data": [{ "url": "https://…mp4" }]
}
```