# Seedance 2.0 US Reference to Video API

> Vidéo à partir d’un prompt et d’images, vidéos et clips audio de référence, avec des formats d’image jusqu’à 21:9 et 4k

Construit une vidéo à partir d’un prompt textuel guidé par des médias de référence : jusqu’à 9 images dans `image_urls`, 3 clips dans `video_urls` et 3 fichiers audio dans `audio_urls`. Référencez-les dans le prompt sous la forme @Image1, @Video1, @Audio1, etc. La sortie dure de 4 à 15 secondes ou est automatique, en 480p, 720p, 1080p ou 4k, avec des formats d’image de 9:16 à 21:9. L’audio synchronisé est généré par défaut.

- Model id: `bytedance/seedance-2.0/us/reference-to-video`
- Made by: ByteDance
- Category: Reference to Video
- Output: video
- Price per 1000 tokens: from $0.0096 / 1000 tokens (cheapest run $0.01 (10 API credits))
- Run: `POST https://api.doitong.ru/v1/run/bytedance/seedance-2.0/us/reference-to-video`
- Quote: `POST https://api.doitong.ru/v1/quote/bytedance/seedance-2.0/us/reference-to-video`
- Docs page: https://doitong.com/fr/developers/models/bytedance/seedance-2.0/us/reference-to-video

## Pricing

Price: **from $0.0096 / 1000 tokens** (the lowest tier; the quote prices your exact input). Price per 1000 tokens: the input files are measured before the run (length, resolution, frame rate). The quote measures the same files and is exactly what the run charges.

Price by tier:

- 4k: $0.0096 / 1000 tokens
- 480p: $0.0168 / 1000 tokens
- 720p: $0.0168 / 1000 tokens
- 1080p: $0.0168 / 1000 tokens

The full example input below costs $5.571 = 5571 API credits (331.5586 × 1000 tokens × $0.0168 (720p)).

Prices are the upstream price in USD, paid from the API balance in API credits (1000 API credits = 1 USD). `POST https://api.doitong.ru/v1/quote/bytedance/seedance-2.0/us/reference-to-video` with the same JSON body returns the exact price for that input; the quote is exactly what a run charges. Invalid input is never charged and failed or canceled requests are refunded automatically.

## Input parameters

Send either the canonical name or the native field name (not both). Canonical names are the same across models.

| Parameter | Canonical name | Type | Required | Default | Allowed values / range | Description |
|---|---|---|---|---|---|---|
| `prompt` |  | string | yes |  |  | Prompt textuel qui guide la génération vidéo. |
| `image_urls` | `images` | array of image URL | no |  | ≤ 9 items | Références d’image pour guider la vidéo, limitées à 9 images et soumises à un maximum de 12 fichiers toutes modalités confondues. Chaque image peut faire au plus 30 MB et doit être au format JPEG, PNG ou WebP. Utilisez @Image1, @Image2 et les libellés numérotés suivants pour identifier ces références dans le prompt. |
| `video_urls` | `videos` | array of video URL | no |  | ≤ 3 items | Références vidéo pour la génération, fournies sous forme de fichiers MP4 ou MOV et identifiées dans le prompt par @Video1, @Video2 et les libellés numérotés suivants. Chacune doit avoir une résolution d’environ 480p (640x640) à environ 720p (834x1112). L’ensemble est limité à 3 vidéos totalisant moins de 50 MB, avec une durée cumulée de 2 à 15 secondes. |
| `audio_urls` | `audios` | array of audio URL | no |  | ≤ 3 items | Les références audio pour guider la vidéo nécessitent au moins une référence d’image ou de vidéo associée. Fournissez des fichiers MP3 ou WAV de 15 MB maximum chacun, avec au plus 3 fichiers et une durée cumulée limitée à 15 secondes. Identifiez-les dans le prompt avec @Audio1, @Audio2 et les libellés numérotés suivants. |
| `resolution` |  | enum (string) | no | `720p` | `480p`, `720p`, `1080p`, `4k` | Résolution de sortie : 480p privilégie la vitesse, 720p offre un équilibre, 1080p fournit une haute qualité et 4k fournit la qualité maximale. |
| `duration` |  | enum (string) | no | `auto` | `auto`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` | Sélection de la durée vidéo : `auto` délègue le choix au modèle à partir du prompt, tandis qu’une durée explicite doit être comprise entre 4 et 15 secondes. |
| `aspect_ratio` |  | enum (string) | no | `auto` | `auto`, `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16` | Rapport d’aspect de sortie : 16:9 produit un format paysage, 9:16 un format portrait/vertical, 1:1 un format carré et 21:9 un format cinématographique ultra-large. Sélectionnez `auto` pour laisser le modèle choisir le rapport. |
| `generate_audio` |  | boolean | no | `true` |  | Activez cette option pour accompagner la vidéo d’un audio synchronisé. L’audio généré inclut une parole synchronisée avec les mouvements des lèvres, une ambiance et des effets sonores. |
| `bitrate_mode` |  | enum (string) | no | `standard` | `standard`, `high` | Choisissez le débit binaire d’encodage de sortie : 'standard' conserve la valeur par défaut, tandis que 'high' demande au modèle d’améliorer la qualité d’encodage au prix d’un fichier plus volumineux. |
| `codec` |  | enum (string) | no | `auto` | `auto`, `H264`, `H265` | Sélection du codec vidéo : `auto` conserve le comportement du codec par défaut, `H264` sélectionne H.264 et `H265` sélectionne H.265. |
| `end_user_id` |  | string \| null | no |  |  | Identifiant unique attribué à l’utilisateur final. |

File parameters (`images`, `videos`, `audios`) take a public `https://` URL, a `data:` URI up to 10 MB, or the `file_url` of an upload from `POST /files`.

## Example input

Required parameters only:

```json
{
  "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
}
```

A fuller example:

```json
{
  "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
}
```

## Run it

Set `DOITONG_API_KEY` to a key from https://doitong.com/developers/dashboard#keys. `?wait=20` returns the finished request in the same call when it is ready within 20 seconds; otherwise poll `GET /requests/{id}` (it also accepts `?wait=`), or pass `webhook_url`.

### curl

```bash
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/bytedance/seedance-2.0/us/reference-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"
```

### JavaScript

```javascript
const API = "https://api.doitong.ru/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/bytedance/seedance-2.0/us/reference-to-video?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");
```

### Python

```python
import os
import requests

API = "https://api.doitong.ru/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/bytedance/seedance-2.0/us/reference-to-video", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])
```

### MCP

The MCP server at `https://api.doitong.ru/v1/mcp` exposes the tools `search_models`, `get_model`, `quote`, `run`, `get_request`, `cancel_request`, `list_requests`, `create_upload` and `get_account`. A `run` call for this model:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run",
    "arguments": {
      "model_id": "bytedance/seedance-2.0/us/reference-to-video",
      "input": {
        "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
      },
      "wait_seconds": 20
    }
  }
}
```

## Response

Every call returns a request object. `status` is one of `queued`, `running`, `succeeded`, `failed`, `canceled`. `outputs` lists the generated files with URLs on our storage (kept forever, or 7 days with `?storage=temporary`; `storage` says which); `output` is the model's own result object with the same URLs.

```json
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "bytedance/seedance-2.0/us/reference-to-video",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 5571,
    "usd": "5.571",
    "charged": 5571,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    },
    "seed": 42
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
```

### Output fields (`output`)

| Field | Type | Description |
|---|---|---|
| `video` | object {url, content_type, file_name, file_size} | Fichier vidéo produit par la génération. |
| `seed` | integer | Valeur du seed appliquée pendant la génération. |

## Related models

- [Seedance 2.0 US Text to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/us/text-to-video.md) (`bytedance/seedance-2.0/us/text-to-video`): from $0.1731 / second
- [Seedance 2.0 US Image to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/us/image-to-video.md) (`bytedance/seedance-2.0/us/image-to-video`): from $0.141 / second
- [Seedance 2.0 Fast Reference to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/fast/reference-to-video.md) (`bytedance/seedance-2.0/fast/reference-to-video`): from $0.113 / second
- [Seedance 2.0 Reference to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/reference-to-video.md) (`bytedance/seedance-2.0/reference-to-video`): from $0.141 / second
- [Wan 3.0 Reference to Video](https://doitong.com/developers/models/alibaba/wan-3.0/reference-to-video.md) (`alibaba/wan-3.0/reference-to-video`): from $0.05 / second
- [Seedance 2.0 Mini](https://doitong.com/developers/models/bytedance/seedance-2.0/mini/reference-to-video.md) (`bytedance/seedance-2.0/mini/reference-to-video`): $0.007 / 1000 tokens
- [Seedance 2.5 US Reference to Video](https://doitong.com/developers/models/bytedance/seedance-2.5/us/reference-to-video.md) (`bytedance/seedance-2.5/us/reference-to-video`): $0.0107 / 1000 tokens
- [Alibaba V2.6 · Reference to Video · Flash](https://doitong.com/developers/models/wan/v2.6/reference-to-video/flash.md) (`wan/v2.6/reference-to-video/flash`): from $0.05 / second of output video

## Links

- HTML page: https://doitong.com/developers/models/bytedance/seedance-2.0/us/reference-to-video
- All models and guides for AI agents: https://doitong.com/developers/llms.txt
- OpenAPI 3.1 with this model's typed request body: https://doitong.com/developers/openapi.json?model=bytedance/seedance-2.0/us/reference-to-video
- Errors: https://doitong.com/developers/docs/errors
- Model details as JSON: https://api.doitong.ru/v1/models/bytedance/seedance-2.0/us/reference-to-video