# Hotel Lobby AI

Hotel Lobby AI turns two character photos into a two-person rap performance. Pick your duo, use the motion template and download your video with the soundtrack.

Create a duet: https://seedrouter.ai/tools/hotel-lobby-ai
Tutorial: https://seedrouter.ai/blog/how-to-make-hotel-lobby-ai-video

## Workflow

1. Choose your two characters: Upload a clear image for each side. Use photos or original characters you have permission to use, with visible faces and enough of the outfit to guide the scene.
2. Review the Hotel Lobby AI preset: Watch the motion reference and listen to the soundtrack. Keep the preset prompt for a first attempt, or edit the scene description to suit your characters.
3. Pick a model and generate: Choose among the four Seedance models and check the live estimate. Start generation once the images are ready; your task continues while the result is being prepared.
4. Preview and download: Watch the whole duet before sharing it. Check both characters, hands and timing, then download the Hotel Lobby AI video with the soundtrack added.

## Scene preset

Default model: `dreamina-seedance-2-0`.
Two performer images and a motion video are prefilled in their upload fields. Output starts at 15 seconds, 720p, 16:9, with generate_audio fixed to false. No reference audio is sent. The soundtrack is merged after generation. Reset restores the preset inputs. Other model options remain editable.
Left performer: https://file.deepytb.com/tools/hotel-lobby-ai/seedrouter/v1/left-performer.png
Right performer: https://file.deepytb.com/tools/hotel-lobby-ai/seedrouter/v1/right-performer.png
Motion reference: https://file.deepytb.com/tools/hotel-lobby-ai/motion-reference-v1.mp4
Soundtrack (post-generation only): https://file.deepytb.com/tools/hotel-lobby-ai/reference-audio-v2.mp3

## Current estimates

Estimates for the preset include output plus motion-reference seconds. Failed requests are not charged.

- Seedance 2.0 (dreamina-seedance-2-0): approximately $2.7725. API reference: https://seedrouter.ai/docs/seedance-2-0.md
- Seedance 2.0 Fast (dreamina-seedance-2-0-fast): approximately $2.1256. API reference: https://seedrouter.ai/docs/seedance-2-0.md
- Seedance 2.0 Mini (dreamina-seedance-2-0-mini): approximately $1.4431. API reference: https://seedrouter.ai/docs/seedance-2-0.md
- Seedance 2.5 (dreamina-seedance-2-5): approximately $4.1232. API reference: https://seedrouter.ai/docs/seedance-2-5.md

## Prompt

Create a single continuous two-person rap performance. Image 1 is the LEFT performer; Image 2 is the RIGHT performer. Preserve each character’s face, hair, clothing and identity from their own image throughout the shot. Use Video 1 only for choreography, body gestures, mouth movements, camera framing and performance timing. Do not copy appearance or line-art styling from Video 1. Both performers share one silver microphone against a warm orange studio backdrop. Follow the reference’s turns, arm movements and exchanges while keeping each character on their assigned side. Natural coherent anatomy, consistent hands, expressive faces. No extra people, text, cuts or scene changes. Render the characters in the visual style of their uploaded images.

## Soundtrack export

The browser tool adds the supplied soundtrack to the completed video. The model generation API alone does not add this soundtrack. Retrying export reuses the completed video.

## Use one character in a video

Choose a view, adjust the crop to include one character, then send it to a character slot. The other character, motion and audio stay unchanged. No video is generated automatically.
The crop is saved as a PNG. White padding keeps it within the video model’s image limits. Review the reference on the next page before generating.

Start with a [character reference sheet](https://seedrouter.ai/tools/ai-character-reference-sheet-generator). Sign in to save the crop, then choose character slot 1 or 2 in [Hotel Lobby AI](https://seedrouter.ai/tools/hotel-lobby-ai) or [Raindance AI](https://seedrouter.ai/tools/raindance-ai). This is a browser workflow, not an additional model API parameter.

## Questions

### Is Hotel Lobby AI free?

Generation uses your SeedRouter balance. The page shows current estimates for the selected Seedance model; there is no separate subscription for this tool. Previewing the template does not start a paid generation.

### Which photos should I use?

Use one clear character per image, with the face and outfit visible. Put the intended left performer in Image 1 and the right performer in Image 2. Matching visual styles can make the scene easier to describe, but likeness still varies.

### Where is the Hotel Lobby AI prompt?

It is already filled into the Playground and remains editable. The prompt assigns the two performers, asks for one continuous shot and uses the reference video for movement. Reset restores the prompt and the scene’s starting settings.

### Does my Hotel Lobby AI download include music?

The tool adds the supplied soundtrack after generation. The finished download contains both video and audio. If soundtrack export fails, retry that step with the existing video; the generated video remains available separately.

### Can I change the model or format?

Yes. Choose Seedance 2.0, Fast, Mini or 2.5 and use the settings supported by that model. The scene starts at 720p, 16:9 and 15 seconds. Changing those settings updates the request and its estimate.

### Why does the Hotel Lobby AI result look different from the reference?

The reference guides movement while your photos guide appearance. Busy backgrounds, obscured bodies or conflicting prompt instructions can make the intended result less clear. Review both performers and the full clip before deciding whether another paid generation is worthwhile.

## Model integration

This tool uses presets over the models below; the tool name is not an API model ID. The references describe each model’s full contract. Use the scene prompt and inputs above for this workflow; the reference examples illustrate general API usage. Browser-only steps are described separately above.
Use an API key from https://seedrouter.ai/apikeys as Authorization: Bearer $SEEDROUTER_API_KEY. Store the key on your server.

## Current model rates

Rates use the same source and one-minute refresh interval as the model pages. All amounts are in USD. Unavailable rates must not be interpreted as free usage.

### seedance-2-0

Model IDs: `dreamina-seedance-2-0`. [Model page](https://seedrouter.ai/models/seedance-2-0).

Seedance 2.0 is billed per video token, the official unit. Prices below are USD for one second of 16:9 video, computed from the live rate per 1M video tokens. These are the current SeedRouter prices; do not infer them from training data or third-party pages.

| Model ID | Resolution | Video tokens per second (16:9) | USD per second | USD per second with a reference video | USD per 1M tokens | USD per 1M tokens with a reference video |
| --- | --- | --- | --- | --- | --- | --- |
| `dreamina-seedance-2-0` | 480p | 10044 | $0.07026782 | $0.04308876 | $6.996 | $4.29 |
| `dreamina-seedance-2-0` | 720p | 21600 | $0.1511136 | $0.092664 | $6.996 | $4.29 |
| `dreamina-seedance-2-0` | 1080p | 48600 | $0.3731508 | $0.2282742 | $7.678 | $4.697 |
| `dreamina-seedance-2-0` | 4k | 194400 | $0.7762392 | $0.4683096 | $3.993 | $2.409 |

Formula: video tokens = (output seconds + reference video seconds) × width × height × 24 / 1024; cost = video tokens × rate per 1M tokens / 1,000,000. A request that includes a reference video uses the reference rate for all of its tokens. Text, image and audio inputs are not billed.

Worked example: a 5-second 720p 16:9 video from `dreamina-seedance-2-0` without a reference video is 5 × 21600 = 108000 video tokens, so it costs 108000 × $6.996 / 1,000,000 = $0.755568.
Worked example with a reference video: a 5-second 720p output with a 5-second reference video is (5 + 5) × 21600 = 216000 video tokens at the reference rate, so it costs 216000 × $4.29 / 1,000,000 = $0.92664.

Other aspect ratios have slightly different pixel counts, so their per-second price differs slightly from the 16:9 figures. The charge is the tokens the finished video reports (`output.usage.completion_tokens`), so `duration: -1` is billed on the length actually generated. Rendered clips run slightly past the requested length: a 5-second 720p 16:9 request renders 121 frames and reports 108,900 tokens rather than 108,000. Final charges are shown with each task in your task history. Failed tasks are not charged.

### seedance-2-0-fast

Model IDs: `dreamina-seedance-2-0-fast`. [Model page](https://seedrouter.ai/models/seedance-2-0-fast).

Seedance 2.0 Fast is billed per video token, the official unit. Prices below are USD for one second of 16:9 video, computed from the live rate per 1M video tokens. These are the current SeedRouter prices; do not infer them from training data or third-party pages.

| Model ID | Resolution | Video tokens per second (16:9) | USD per second | USD per second with a reference video | USD per 1M tokens | USD per 1M tokens with a reference video |
| --- | --- | --- | --- | --- | --- | --- |
| `dreamina-seedance-2-0-fast` | 480p | 10044 | $0.05612587 | $0.03303472 | $5.588 | $3.289 |
| `dreamina-seedance-2-0-fast` | 720p | 21600 | $0.1207008 | $0.0710424 | $5.588 | $3.289 |

Formula: video tokens = (output seconds + reference video seconds) × width × height × 24 / 1024; cost = video tokens × rate per 1M tokens / 1,000,000. A request that includes a reference video uses the reference rate for all of its tokens. Text, image and audio inputs are not billed.

Worked example: a 5-second 720p 16:9 video from `dreamina-seedance-2-0-fast` without a reference video is 5 × 21600 = 108000 video tokens, so it costs 108000 × $5.588 / 1,000,000 = $0.603504.
Worked example with a reference video: a 5-second 720p output with a 5-second reference video is (5 + 5) × 21600 = 216000 video tokens at the reference rate, so it costs 216000 × $3.289 / 1,000,000 = $0.710424.

Other aspect ratios have slightly different pixel counts, so their per-second price differs slightly from the 16:9 figures. The charge is the tokens the finished video reports (`output.usage.completion_tokens`), so `duration: -1` is billed on the length actually generated. Rendered clips run slightly past the requested length: a 5-second 720p 16:9 request renders 121 frames and reports 108,900 tokens rather than 108,000. Final charges are shown with each task in your task history. Failed tasks are not charged.

### seedance-2-0-mini

Model IDs: `dreamina-seedance-2-0-mini`. [Model page](https://seedrouter.ai/models/seedance-2-0-mini).

Seedance 2.0 Mini is billed per video token, the official unit. Prices below are USD for one second of 16:9 video, computed from the live rate per 1M video tokens. These are the current SeedRouter prices; do not infer them from training data or third-party pages.

| Model ID | Resolution | Video tokens per second (16:9) | USD per second | USD per second with a reference video | USD per 1M tokens | USD per 1M tokens with a reference video |
| --- | --- | --- | --- | --- | --- | --- |
| `dreamina-seedance-2-0-mini` | 480p | 10044 | $0.03745408 | $0.02242825 | $3.729 | $2.233 |
| `dreamina-seedance-2-0-mini` | 720p | 21600 | $0.0805464 | $0.0482328 | $3.729 | $2.233 |

Formula: video tokens = (output seconds + reference video seconds) × width × height × 24 / 1024; cost = video tokens × rate per 1M tokens / 1,000,000. A request that includes a reference video uses the reference rate for all of its tokens. Text, image and audio inputs are not billed.

Worked example: a 5-second 720p 16:9 video from `dreamina-seedance-2-0-mini` without a reference video is 5 × 21600 = 108000 video tokens, so it costs 108000 × $3.729 / 1,000,000 = $0.402732.
Worked example with a reference video: a 5-second 720p output with a 5-second reference video is (5 + 5) × 21600 = 216000 video tokens at the reference rate, so it costs 216000 × $2.233 / 1,000,000 = $0.482328.

Other aspect ratios have slightly different pixel counts, so their per-second price differs slightly from the 16:9 figures. The charge is the tokens the finished video reports (`output.usage.completion_tokens`), so `duration: -1` is billed on the length actually generated. Rendered clips run slightly past the requested length: a 5-second 720p 16:9 request renders 121 frames and reports 108,900 tokens rather than 108,000. Final charges are shown with each task in your task history. Failed tasks are not charged.

### seedance-2-5

Model IDs: `dreamina-seedance-2-5`. [Model page](https://seedrouter.ai/models/seedance-2-5).

Seedance 2.5 is billed per video token, the official unit. Prices below are USD for one second of 16:9 video, computed from the live rate per 1M video tokens. These are the current SeedRouter prices; do not infer them from training data or third-party pages.

| Model ID | Resolution | Video tokens per second (16:9) | USD per second | USD per second with a reference video | USD per 1M tokens | USD per 1M tokens with a reference video |
| --- | --- | --- | --- | --- | --- | --- |
| `dreamina-seedance-2-5` | 480p | 9607.5 | $0.10261771 | $0.06129585 | $10.681 | $6.38 |
| `dreamina-seedance-2-5` | 720p | 21600 | $0.2307096 | $0.137808 | $10.681 | $6.38 |
| `dreamina-seedance-2-5` | 1080p | 48600 | $0.5672106 | $0.3400056 | $11.671 | $6.996 |

Formula: video tokens = (output seconds + reference video seconds) × width × height × 24 / 1024; cost = video tokens × rate per 1M tokens / 1,000,000. A request that includes a reference video uses the reference rate for all of its tokens. Text, image and audio inputs are not billed.

For Seedance 2.5 requests with reference videos, use at least ceil(output seconds × 2 / 3) reference seconds in this estimate, or the actual reference duration if longer. This minimum applies to draft and final tasks; final charges follow completed usage.

Worked example: a 5-second 720p 16:9 video from `dreamina-seedance-2-5` without a reference video is 5 × 21600 = 108000 video tokens, so it costs 108000 × $10.681 / 1,000,000 = $1.153548.
Worked example with a reference video: a 5-second 720p output with a 5-second reference video is (5 + 5) × 21600 = 216000 video tokens at the reference rate, so it costs 216000 × $6.38 / 1,000,000 = $1.37808.

Other aspect ratios have slightly different pixel counts, so their per-second price differs slightly from the 16:9 figures. The charge is the tokens the finished video reports (`output.usage.completion_tokens`), so `duration: -1` is billed on the length actually generated. Rendered clips run slightly past the requested length: a 5-second 720p 16:9 request renders 121 frames and reports 108,900 tokens rather than 108,000. Final charges are shown with each task in your task history. Failed tasks are not charged.

## API reference: seedance-2-0

- [Markdown](https://seedrouter.ai/docs/seedance-2-0.md)
- [OpenAPI request and response schemas](https://seedrouter.ai/docs/seedance-2-0.openapi.json)

Seedance 2.0 is ByteDance's video generation model (Dreamina Seedance 2.0). Send the official ModelArk task body to `POST /v1/videos/generations`, keep the returned task ID, and read the finished video from `GET /v1/tasks/{id}`. Images, videos and audio go in `content` as URLs.

## Model IDs

| Model ID                     | Resolutions           | Notes                   |
| ---------------------------- | --------------------- | ----------------------- |
| `dreamina-seedance-2-0`      | 480p, 720p, 1080p, 4K | Full model              |
| `dreamina-seedance-2-0-fast` | 480p, 720p            | Lower price per second  |
| `dreamina-seedance-2-0-mini` | 480p, 720p            | Lowest price per second |

All three IDs accept the same parameters. See the [model page](https://seedrouter.ai/models/seedance-2-0#pricing) for current prices.

## Quick example

```bash
curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0",
    "content": [{"type": "text", "text": "A red paper boat drifts across a calm pond at sunrise, slow dolly-in"}],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "generate_audio": true
  }'
```

```python
import os
import requests

response = requests.post(
    "https://api.seedrouter.ai/v1/videos/generations",
    headers={"Authorization": f"Bearer {os.environ['SEEDROUTER_API_KEY']}"},
    json={
        "model": "dreamina-seedance-2-0",
        "content": [{"type": "text", "text": "A red paper boat drifts across a calm pond at sunrise, slow dolly-in"}],
        "resolution": "720p",
        "ratio": "16:9",
        "duration": 5,
        "generate_audio": True,
    },
    timeout=60,
)
response.raise_for_status()
task_id = response.json()["id"]
```

```javascript
const response = await fetch('https://api.seedrouter.ai/v1/videos/generations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SEEDROUTER_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'dreamina-seedance-2-0',
    content: [{ type: 'text', text: 'A red paper boat drifts across a calm pond at sunrise, slow dolly-in' }],
    resolution: '720p',
    ratio: '16:9',
    duration: 5,
    generate_audio: true,
  }),
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const { id: taskId } = await response.json();
```

```go
package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "os"
    "strings"
    "time"
)

func main() {
    body := strings.NewReader(`{
      "model": "dreamina-seedance-2-0",
      "content": [{"type": "text", "text": "A red paper boat drifts across a calm pond at sunrise, slow dolly-in"}],
      "resolution": "720p",
      "ratio": "16:9",
      "duration": 5,
      "generate_audio": true
    }`)
    req, err := http.NewRequest("POST", "https://api.seedrouter.ai/v1/videos/generations", body)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", "Bearer " + os.Getenv("SEEDROUTER_API_KEY"))
    req.Header.Set("Content-Type", "application/json")
    client := &http.Client{Timeout: 60 * time.Second}
    res, err := client.Do(req)
    if err != nil { panic(err) }
    defer res.Body.Close()
    if res.StatusCode != http.StatusOK { panic(res.Status) }
    var task struct { ID string `json:"id"` }
    if err := json.NewDecoder(res.Body).Decode(&task); err != nil { panic(err) }
    fmt.Println(task.ID)
}
```

## Endpoint

```text
POST https://api.seedrouter.ai/v1/videos/generations
```

| Header        | Value                 |
| ------------- | --------------------- |
| Authorization | `Bearer YOUR_API_KEY` |
| Content-Type  | `application/json`    |

The body is the official ModelArk "create a video generation task" request body; this is the same endpoint every SeedRouter video model uses. The response is the new task (`id`, `status: "processing"`), not the finished video. Keep API keys in server-side code.

## Parameters

| Name                      | Type      | Required | Default    | Notes                                                                                                 |
| ------------------------- | --------- | -------- | ---------- | ----------------------------------------------------------------------------------------------------- |
| `model`                   | string    | Yes      | —          | One of the three model IDs above.                                                                     |
| `content`                 | object\[] | Yes      | —          | The prompt and media; see below.                                                                      |
| `resolution`              | enum      | No       | `720p`     | `480p`, `720p`, `1080p`, `4k`; the Fast and Mini IDs accept `480p` and `720p` only.                   |
| `ratio`                   | enum      | No       | `adaptive` | `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `adaptive`.                                              |
| `duration`                | integer   | No       | `5`        | 4–15 seconds, or `-1` to let the model choose.                                                        |
| `generate_audio`          | boolean   | No       | `true`     | Generate sound with the video.                                                                        |
| `watermark`               | boolean   | No       | `false`    | Add a watermark.                                                                                      |
| `return_last_frame`       | boolean   | No       | `false`    | Also return the final frame as an image URL.                                                          |
| `execution_expires_after` | integer   | No       | `172800`   | 3600–259200 seconds. A task still unfinished after this fails with `task_expired` and is not charged. |
| `priority`                | integer   | No       | `0`        | 0–9.                                                                                                  |
| `safety_identifier`       | string    | No       | —          | 1–64 characters identifying your end user. A hash is fine.                                            |
| `service_tier`            | enum      | No       | `default`  | Only `default`.                                                                                       |
| `content_filter`          | boolean   | No       | `true`     | SeedRouter extension. `false` turns off content filtering on this request.                            |

### `content` items

| Item  | Shape                                                                                   | Role                                           | Limit                                      |
| ----- | --------------------------------------------------------------------------------------- | ---------------------------------------------- | ------------------------------------------ |
| Text  | `{"type": "text", "text": "..."}`                                                       | —                                              | One.                                       |
| Image | `{"type": "image_url", "image_url": {"url": "https://..."}, "role": "..."}`             | `first_frame`, `last_frame`, `reference_image` | Up to 9 reference images.                  |
| Video | `{"type": "video_url", "video_url": {"url": "https://..."}, "role": "reference_video"}` | `reference_video`                              | Up to 3.                                   |
| Audio | `{"type": "audio_url", "audio_url": {"url": "https://..."}, "role": "reference_audio"}` | `reference_audio`                              | Up to 3. Needs a reference image or video. |

Unknown fields are rejected. Not supported: `seed`, `callback_url` (poll the task instead), `draft` and `draft_task`, `tools`, and the 1.x-only `frames` and `camera_fixed`, as well as `output_format` and `omni_reference_task_type` (Seedance 2.5 only). Tasks cannot be cancelled or deleted.

## Modes

The mode follows from the `content` items; there is no mode parameter.

| Mode                 | `content`                                                                          |
| -------------------- | ---------------------------------------------------------------------------------- |
| Text to video        | one text item                                                                      |
| First frame          | text (optional) + one image with role `first_frame`, or one image with no role     |
| First and last frame | text (optional) + one `first_frame` image + one `last_frame` image                 |
| Multimodal reference | text + any mix of `reference_image`, `reference_video` and `reference_audio` items |

First-frame modes cannot be combined with reference items. With several images or any other media, every image needs a `role`.

### Reference example

```bash
curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0",
    "content": [
      {"type": "text", "text": "The character from the image walks through the market in the video, same camera move"},
      {"type": "image_url", "image_url": {"url": "https://example.com/character.png"}, "role": "reference_image"},
      {"type": "video_url", "video_url": {"url": "https://example.com/market.mp4"}, "role": "reference_video"}
    ],
    "ratio": "adaptive",
    "duration": 8
  }'
```

Replace the example URLs with your own accessible files.

## Media inputs

This API accepts URL references only. Base64, `data:` URLs, `asset://` IDs and multipart uploads are not accepted. The Playground uploads selected files to storage before submitting their URLs.

Media must be public HTTP(S) URLs and meet the model's official limits:

| Media | Formats                                     | Limits                                                                                                                                                                            |
| ----- | ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Image | JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF | Smaller than 30 MB; width and height 300–6000 px; aspect ratio (width / height) 0.4–2.5; 1–9 reference images                                                                     |
| Video | MP4, MOV (H.264 or H.265)                   | 2–15 seconds each, up to 3, at most 15 seconds in total; at most 200 MB; 24–60 FPS; width and height 300–6000 px; aspect ratio 0.4–2.5; 407,696–8,295,044 pixels (width × height) |
| Audio | WAV, MP3                                    | 2–15 seconds each, up to 3, at most 15 seconds in total; needs a reference image or video; at most 15 MB                                                                          |

Reference images and videos that contain real human faces are not supported by the model.

Media is checked when the task starts, before any generation. A task whose media breaks one of these limits ends as `failed` with `invalid_request_error` and a message naming the rule, for example `The request was rejected: content reference videos must total at most 15 seconds.`, and is not charged. A file that cannot be read at that point is passed to the model, which accepts or rejects it; a failed task is not charged either way.

## Pricing dimensions

Check the [model pricing section](https://seedrouter.ai/models/seedance-2-0#pricing) for current rates. Seedance 2.0 bills video tokens, the official unit:

```text
video tokens = (output seconds + reference video seconds) × width × height × 24 / 1024
```

The rate per million tokens depends on the output resolution and on whether the request includes a reference video; a request with a reference video uses a lower rate for all of its tokens. Text, image and audio inputs are not billed. At 16:9, one second is 10,044 tokens at 480p (864×496), 21,600 at 720p, 48,600 at 1080p, and 194,400 at 4K.

The charge follows the tokens the finished video reports (`output.usage.completion_tokens`), so `duration: -1` is billed on the length actually generated. Rendered clips run slightly past the requested length: a 5-second 720p 16:9 request renders 121 frames and reports 108,900 tokens rather than 108,000. View final charges in your account usage history. Failed tasks are not charged.

## Output schema

Submission returns the new task:

```json
{"id": "task_...", "model": "dreamina-seedance-2-0", "status": "processing", "created_at": 1790321515}
```

### Get the task

```bash
curl https://api.seedrouter.ai/v1/tasks/YOUR_TASK_ID \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"
```

Poll every 10–20 seconds until `status` is `completed` or `failed`. A network timeout while polling does not mean generation failed: keep the task ID and resume checking it. Do not create another task to check progress.

### Complete polling example

Run this after the Python submission example above.

```python
import time

deadline = time.monotonic() + 1800
while time.monotonic() < deadline:
    result = requests.get(
        f"https://api.seedrouter.ai/v1/tasks/{task_id}",
        headers={"Authorization": f"Bearer {os.environ['SEEDROUTER_API_KEY']}"},
        timeout=30,
    )
    result.raise_for_status()
    task = result.json()
    if task["status"] == "completed":
        print(task["output"]["video_url"])
        break
    if task["status"] == "failed":
        raise RuntimeError(task["error"]["message"])
    time.sleep(15)
else:
    raise TimeoutError(f"Still waiting. Resume polling task {task_id}.")
```

### Completed task

```json
{
  "id": "task_...",
  "model": "dreamina-seedance-2-0",
  "status": "completed",
  "created_at": 1790321515,
  "finished_at": 1790321652,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4",
    "last_frame_url": "https://static.seedrouter.ai/media/tasks/task_example/last_frame/0.jpg",
    "content": {
      "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4",
      "last_frame_url": "https://static.seedrouter.ai/media/tasks/task_example/last_frame/0.jpg"
    },
    "usage": {"completion_tokens": 108900, "total_tokens": 108900},
    "seed": 42,
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "framespersecond": 24,
    "generate_audio": true,
    "draft": false,
    "output_format": "mp4",
    "service_tier": "default",
    "execution_expires_after": 172800,
    "priority": 0
  }
}
```

| Field                                                                                           | Meaning                                                         |
| ----------------------------------------------------------------------------------------------- | --------------------------------------------------------------- |
| `id`                                                                                            | Keep this ID for later queries.                                 |
| `status`                                                                                        | `processing`, `completed` or `failed`.                          |
| `output.video_url`                                                                              | The generated video.                                            |
| `output.last_frame_url`                                                                         | The final frame, when `return_last_frame` is `true`.            |
| `output.content`                                                                                | The same URLs in the official ModelArk shape.                   |
| `output.usage.completion_tokens`                                                                | Video tokens of the finished video; the billed quantity.        |
| `output.duration`, `output.resolution`, `output.ratio`, `output.framespersecond`, `output.seed` | What was actually rendered; `seed` is the one the model picked. |
| `created_at`, `finished_at`                                                                     | Unix timestamps in seconds.                                     |
| `error`                                                                                         | `{"code", "message"}` on a failed task.                         |

Video URLs are hosted on our storage. Save the file to your own storage when you need a durable copy.

## Errors

Requests rejected before a task is created return an HTTP error with an `error` object and are not charged. A task that fails after acceptance returns HTTP 200 when queried, with `status: "failed"` and an `error` object. Output withheld by content filtering fails with `content_policy_violation`; a task that runs past `execution_expires_after` fails with `task_expired`.

See the [shared error catalog](https://seedrouter.ai/docs/api/errors) for codes, HTTP statuses, and retry guidance.

```json
{
  "id": "task_...",
  "model": "dreamina-seedance-2-0",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}
```

If submission itself times out, check your [task history](https://seedrouter.ai/tasks) before submitting again: the first request may have been accepted.

## Tips

* Describe the subject, the action, the camera move, and the lighting in full sentences.
* Draft at 480p with a short `duration`, then render the keeper at a higher resolution.
* Chain shots with `return_last_frame`: use the returned frame as the next task's `first_frame`.

## Related

* [Seedance 2.0 Playground and pricing](https://seedrouter.ai/models/seedance-2-0)
* [Download OpenAPI](https://seedrouter.ai/docs/seedance-2-0.openapi.json)
* [Copyable Markdown](https://seedrouter.ai/docs/seedance-2-0.md)
## API reference: seedance-2-5

- [Markdown](https://seedrouter.ai/docs/seedance-2-5.md)
- [OpenAPI request and response schemas](https://seedrouter.ai/docs/seedance-2-5.openapi.json)

Seedance 2.5 is ByteDance's newest video generation model (Dreamina Seedance 2.5). Send the official ModelArk task body to `POST /v1/videos/generations`, keep the returned task ID, and read the finished video from `GET /v1/tasks/{id}`. Images, videos and audio go in `content` as URLs.

## Model IDs

| Model ID                | Resolutions       | Length                     |
| ----------------------- | ----------------- | -------------------------- |
| `dreamina-seedance-2-5` | 480p, 720p, 1080p | 4–30 seconds, or automatic |

See the [model page](https://seedrouter.ai/models/seedance-2-5#pricing) for current prices.

## Quick example

```bash
curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-5",
    "content": [{"type": "text", "text": "A red paper boat drifts across a calm pond at sunrise, slow dolly-in"}],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "generate_audio": true
  }'
```

```python
import os
import requests

response = requests.post(
    "https://api.seedrouter.ai/v1/videos/generations",
    headers={"Authorization": f"Bearer {os.environ['SEEDROUTER_API_KEY']}"},
    json={
        "model": "dreamina-seedance-2-5",
        "content": [{"type": "text", "text": "A red paper boat drifts across a calm pond at sunrise, slow dolly-in"}],
        "resolution": "720p",
        "ratio": "16:9",
        "duration": 5,
        "generate_audio": True,
    },
    timeout=60,
)
response.raise_for_status()
task_id = response.json()["id"]
```

```javascript
const response = await fetch('https://api.seedrouter.ai/v1/videos/generations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SEEDROUTER_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'dreamina-seedance-2-5',
    content: [{ type: 'text', text: 'A red paper boat drifts across a calm pond at sunrise, slow dolly-in' }],
    resolution: '720p',
    ratio: '16:9',
    duration: 5,
    generate_audio: true,
  }),
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const { id: taskId } = await response.json();
```

```go
package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "os"
    "strings"
    "time"
)

func main() {
    body := strings.NewReader(`{
      "model": "dreamina-seedance-2-5",
      "content": [{"type": "text", "text": "A red paper boat drifts across a calm pond at sunrise, slow dolly-in"}],
      "resolution": "720p",
      "ratio": "16:9",
      "duration": 5,
      "generate_audio": true
    }`)
    req, err := http.NewRequest("POST", "https://api.seedrouter.ai/v1/videos/generations", body)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", "Bearer " + os.Getenv("SEEDROUTER_API_KEY"))
    req.Header.Set("Content-Type", "application/json")
    client := &http.Client{Timeout: 60 * time.Second}
    res, err := client.Do(req)
    if err != nil { panic(err) }
    defer res.Body.Close()
    if res.StatusCode != http.StatusOK { panic(res.Status) }
    var task struct { ID string `json:"id"` }
    if err := json.NewDecoder(res.Body).Decode(&task); err != nil { panic(err) }
    fmt.Println(task.ID)
}
```

## Endpoint

```text
POST https://api.seedrouter.ai/v1/videos/generations
```

| Header        | Value                 |
| ------------- | --------------------- |
| Authorization | `Bearer YOUR_API_KEY` |
| Content-Type  | `application/json`    |

The body is the official ModelArk "create a video generation task" request body; this is the same endpoint every SeedRouter video model uses. The response is the new task (`id`, `status: "processing"`), not the finished video. Keep API keys in server-side code.

## Parameters

| Name                       | Type      | Required | Default                        | Notes                                                                                                                                     |
| -------------------------- | --------- | -------- | ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `model`                    | string    | Yes      | —                              | `dreamina-seedance-2-5`.                                                                                                                  |
| `content`                  | object\[] | Yes      | —                              | The prompt and media; see below.                                                                                                          |
| `draft`                    | boolean   | No       | `false`                        | `true` creates a 480p draft.                                                                                                              |
| `resolution`               | enum      | No       | `720p` standard / `480p` draft | `480p`, `720p`, `1080p`. A final request from `draft_task` must explicitly specify `1080p`.                                               |
| `ratio`                    | enum      | No       | `adaptive`                     | `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `adaptive`. Must be `adaptive` (or omitted) with a first frame, and for `edit` and `extend`. |
| `duration`                 | integer   | No       | `-1`                           | 4–30 seconds, or `-1` to let the model choose. Must be `-1` for `edit`.                                                                   |
| `generate_audio`           | boolean   | No       | `true`                         | Generate sound with the video.                                                                                                            |
| `watermark`                | boolean   | No       | `false`                        | Add a watermark.                                                                                                                          |
| `return_last_frame`        | boolean   | No       | `false`                        | Also return the final frame as an image URL.                                                                                              |
| `output_format`            | enum      | No       | `mp4`                          | `mp4` or `mov`.                                                                                                                           |
| `omni_reference_task_type` | enum      | No       | `auto`                         | `auto`, `reference`, `edit`, `extend`. `edit` and `extend` need a reference video.                                                        |
| `execution_expires_after`  | integer   | No       | `172800`                       | 3600–259200 seconds. A task still unfinished after this fails with `task_expired` and is not charged.                                     |
| `priority`                 | integer   | No       | `0`                            | 0–9.                                                                                                                                      |
| `safety_identifier`        | string    | No       | —                              | 1–64 characters identifying your end user. A hash is fine.                                                                                |
| `service_tier`             | enum      | No       | `default`                      | Only `default`.                                                                                                                           |
| `content_filter`           | boolean   | No       | `true`                         | SeedRouter extension. `false` turns off content filtering on this request.                                                                |

### `content` items

| Item  | Shape                                                                                   | Role                                           | Limit                      |
| ----- | --------------------------------------------------------------------------------------- | ---------------------------------------------- | -------------------------- |
| Text  | `{"type": "text", "text": "..."}`                                                       | —                                              | One.                       |
| Image | `{"type": "image_url", "image_url": {"url": "https://..."}, "role": "..."}`             | `first_frame`, `last_frame`, `reference_image` | Up to 30 reference images. |
| Video | `{"type": "video_url", "video_url": {"url": "https://..."}, "role": "reference_video"}` | `reference_video`                              | Up to 10.                  |
| Audio | `{"type": "audio_url", "audio_url": {"url": "https://..."}, "role": "reference_audio"}` | `reference_audio`                              | Up to 10.                  |

Unknown fields are rejected. Not supported: `seed`, `callback_url` (poll the task instead), `tools`, and the 1.x-only `frames` and `camera_fixed`. Tasks cannot be cancelled or deleted.

## Modes

The mode follows from the `content` items; there is no mode parameter.

| Mode                 | `content`                                                                          |
| -------------------- | ---------------------------------------------------------------------------------- |
| Text to video        | one text item                                                                      |
| First frame          | text (optional) + one image with role `first_frame`, or one image with no role     |
| First and last frame | text (optional) + one `first_frame` image + one `last_frame` image                 |
| Multimodal reference | text + any mix of `reference_image`, `reference_video` and `reference_audio` items |
| Edit a video         | text + one `reference_video`, with `omni_reference_task_type: "edit"`              |
| Extend a video       | text + one `reference_video`, with `omni_reference_task_type: "extend"`            |

First-frame modes cannot be combined with reference items. With several images or any other media, every image needs a `role`.

### Reference example

```bash
curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-5",
    "content": [
      {"type": "text", "text": "The character from the image walks through the market in the video, same camera move"},
      {"type": "image_url", "image_url": {"url": "https://example.com/character.png"}, "role": "reference_image"},
      {"type": "video_url", "video_url": {"url": "https://example.com/market.mp4"}, "role": "reference_video"}
    ],
    "ratio": "adaptive",
    "duration": 8
  }'
```

Replace the example URLs with your own accessible files.

## Media inputs

This API accepts URL references only. Base64, `data:` URLs, `asset://` IDs and multipart uploads are not accepted. The Playground uploads selected files to storage before submitting their URLs.

Media must be public HTTP(S) URLs and meet the model's official limits:

| Media | Formats                                     | Limits                                                                                                                                                                                                       |
| ----- | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Image | JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF | Smaller than 30 MB; width and height 300–6000 px; aspect ratio (width / height) 0.4–2.5; 1–30 reference images                                                                                               |
| Video | MP4, MOV (H.264 or H.265)                   | 2–30 seconds each (4–30 seconds for `edit`), up to 10, at most 30 seconds in total; at most 200 MB; 24–60 FPS; width and height 300–6000 px; aspect ratio 0.4–2.5; 407,696–8,295,044 pixels (width × height) |
| Audio | WAV, MP3                                    | 2–30 seconds each, up to 10, at most 30 seconds in total; at most 15 MB                                                                                                                                      |

Reference images and videos that contain real human faces are not supported by the model.

Media is checked when the task starts, before any generation. A task whose media breaks one of these limits ends as `failed` with `invalid_request_error` and a message naming the rule, for example `The request was rejected: content reference videos must total at most 15 seconds.`, and is not charged. A file that cannot be read at that point is passed to the model, which accepts or rejects it; a failed task is not charged either way.

## Pricing dimensions

Check the [model pricing section](https://seedrouter.ai/models/seedance-2-5#pricing) for current rates. Seedance 2.5 bills video tokens, the official unit:

```text
video tokens = (output seconds + reference video seconds) × width × height × 24 / 1024
```

The rate per million tokens depends on the output resolution and on whether the request includes a reference video; a request with a reference video uses a lower rate for all of its tokens. Text, image and audio inputs are not billed. At 16:9, one second is 9,607.5 tokens at 480p (854×480), 21,600 at 720p, 48,600 at 1080p.

Requests with reference videos also have a minimum token threshold. For estimates, use at least `ceil(output seconds × 2 / 3)` reference seconds in the formula, even when the original reference videos are shorter. This applies to both draft and final tasks; the draft clip itself does not become a reference video. Actual charges follow the completed task's reported usage.

The charge follows the tokens the finished video reports (`output.usage.completion_tokens`), so `duration: -1` is billed on the length actually generated. Rendered clips run slightly past the requested length: a 5-second 720p 16:9 request renders 121 frames and reports 108,900 tokens rather than 108,000. View final charges in your account usage history. Failed tasks are not charged.

## Output schema

Submission returns the new task:

```json
{"id": "task_...", "model": "dreamina-seedance-2-5", "status": "processing", "created_at": 1790321515}
```

### Get the task

```bash
curl https://api.seedrouter.ai/v1/tasks/YOUR_TASK_ID \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"
```

Poll every 10–20 seconds until `status` is `completed` or `failed`. A network timeout while polling does not mean generation failed: keep the task ID and resume checking it. Do not create another task to check progress.

### Complete polling example

Run this after the Python submission example above.

```python
import time

deadline = time.monotonic() + 1800
while time.monotonic() < deadline:
    result = requests.get(
        f"https://api.seedrouter.ai/v1/tasks/{task_id}",
        headers={"Authorization": f"Bearer {os.environ['SEEDROUTER_API_KEY']}"},
        timeout=30,
    )
    result.raise_for_status()
    task = result.json()
    if task["status"] == "completed":
        print(task["output"]["video_url"])
        break
    if task["status"] == "failed":
        raise RuntimeError(task["error"]["message"])
    time.sleep(15)
else:
    raise TimeoutError(f"Still waiting. Resume polling task {task_id}.")
```

### Completed task

```json
{
  "id": "task_...",
  "model": "dreamina-seedance-2-5",
  "status": "completed",
  "created_at": 1790321515,
  "finished_at": 1790321652,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4",
    "last_frame_url": "https://static.seedrouter.ai/media/tasks/task_example/last_frame/0.jpg",
    "content": {
      "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4",
      "last_frame_url": "https://static.seedrouter.ai/media/tasks/task_example/last_frame/0.jpg"
    },
    "usage": {"completion_tokens": 108900, "total_tokens": 108900},
    "seed": 42,
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "framespersecond": 24,
    "generate_audio": true,
    "draft": false,
    "output_format": "mp4",
    "service_tier": "default",
    "execution_expires_after": 172800,
    "priority": 0
  }
}
```

| Field                                                                                           | Meaning                                                         |
| ----------------------------------------------------------------------------------------------- | --------------------------------------------------------------- |
| `id`                                                                                            | Keep this ID for later queries.                                 |
| `status`                                                                                        | `processing`, `completed` or `failed`.                          |
| `output.video_url`                                                                              | The generated video.                                            |
| `output.last_frame_url`                                                                         | The final frame, when `return_last_frame` is `true`.            |
| `output.content`                                                                                | The same URLs in the official ModelArk shape.                   |
| `output.usage.completion_tokens`                                                                | Video tokens of the finished video; the billed quantity.        |
| `output.duration`, `output.resolution`, `output.ratio`, `output.framespersecond`, `output.seed` | What was actually rendered; `seed` is the one the model picked. |
| `created_at`, `finished_at`                                                                     | Unix timestamps in seconds.                                     |
| `error`                                                                                         | `{"code", "message"}` on a failed task.                         |

Video URLs are hosted on our storage. Save the file to your own storage when you need a durable copy.

## Errors

Requests rejected before a task is created return an HTTP error with an `error` object and are not charged. A task that fails after acceptance returns HTTP 200 when queried, with `status: "failed"` and an `error` object. Output withheld by content filtering fails with `content_policy_violation`; a task that runs past `execution_expires_after` fails with `task_expired`.

See the [shared error catalog](https://seedrouter.ai/docs/api/errors) for codes, HTTP statuses, and retry guidance.

```json
{
  "id": "task_...",
  "model": "dreamina-seedance-2-5",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}
```

If submission itself times out, check your [task history](https://seedrouter.ai/tasks) before submitting again: the first request may have been accepted.

## Tips

* Describe the subject, the action, the camera move, and the lighting in full sentences.
* Draft at 480p with a short `duration`, then render the keeper at a higher resolution.
* Chain shots with `return_last_frame`: use the returned frame as the next task's `first_frame`.
* To edit footage, set `omni_reference_task_type` to `edit` and describe only what should change.

## Related

* [Seedance 2.5 Playground and pricing](https://seedrouter.ai/models/seedance-2-5)
* [Download OpenAPI](https://seedrouter.ai/docs/seedance-2-5.openapi.json)
* [Copyable Markdown](https://seedrouter.ai/docs/seedance-2-5.md)

## Draft preview and final video

Set `draft: true` to generate a 480p preview. Other resolutions are invalid in draft mode. Preview generation uses the same token usage and unit price as standard 480p generation.

```json
{
  "model": "dreamina-seedance-2-5",
  "content": [{ "type": "text", "text": "A fox walks through a sunny garden." }],
  "draft": true,
  "resolution": "480p",
  "duration": 4,
  "ratio": "16:9"
}
```

Poll the returned SeedRouter task ID until `status` is `completed` and `output.draft` is `true`. Within 7 days of the draft's creation, submit a separate request using that ID:

```json
{
  "model": "dreamina-seedance-2-5",
  "content": [{ "type": "draft_task", "draft_task": { "id": "task_YOUR_DRAFT_ID" } }],
  "resolution": "1080p"
}
```

The draft must belong to your account, have completed, and use the same model. `content` must contain only one `draft_task` item. Explicitly set `resolution` to `1080p`; omit `draft` or set it to `false`. Do not send `duration`, `ratio`, `seed`, `generate_audio`, `omni_reference_task_type`, text, or media again, even with the same values. These settings are inherited from the draft.

You may set `watermark`, `return_last_frame`, `output_format`, `execution_expires_after`, `priority`, `safety_identifier`, and `service_tier: "default"` for the new task. Omitted output options use their defaults. `content_filter` is inherited and cannot be changed. A successful final video returns a new task ID, `output.draft: false`, and `output.draft_task_id` containing your original SeedRouter draft ID. One draft can be used for multiple separate final generations before it expires.

Draft and final video are billed independently. The final video uses the 1080p rate for **the original draft's input category**: if the draft used reference video, the final also uses the reference-video rate and includes the original reference video's duration in token usage. The draft clip itself is not added as an input video. Each task uses the price in effect when it is submitted. Failed requests are not charged.

## More resources

- [Task lifecycle](https://seedrouter.ai/docs/api/tasks.md)
- [Error catalog and retry guidance](https://seedrouter.ai/docs/api/errors.md)
- [Account usage](https://seedrouter.ai/usage)
- [All tools and models](https://seedrouter.ai/llms.txt)
- [Documentation index](https://seedrouter.ai/docs/llms.txt)
