# Seedance 2.0 US Reference to Video API

> Video kutoka kwa kidokezo pamoja na picha, video na klipu za sauti za marejeo, yenye uwiano wa picha hadi 21:9 na 4k

Huunda video kutoka kwa kidokezo cha maandishi kinachoongozwa na midia ya marejeo: hadi picha 9 kwenye `image_urls`, klipu 3 kwenye `video_urls` na faili 3 za sauti kwenye `audio_urls`. Zirejelee kwenye kidokezo kama @Image1, @Video1, @Audio1 na kuendelea. Tokeo hudumu sekunde 4 hadi 15 au auto, kwa 480p, 720p, 1080p au 4k, katika uwiano kutoka 9:16 hadi 21:9. Sauti iliyosawazishwa huzalishwa kwa chaguomsingi.

- 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/sw/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 |  |  | Kidokezo cha maandishi kinachoelekeza uzalishaji wa video. |
| `image_urls` | `images` | array of image URL | no |  | ≤ 9 items | Marejeleo ya picha kwa mwongozo wa video, yenye kikomo cha picha 9 na upeo wa faili 12 katika aina zote. Kila picha inaweza kuwa na ukubwa wa hadi 30 MB na lazima itumie JPEG, PNG, au WebP. Tumia @Image1, @Image2, na lebo zinazofuata zenye nambari kutambua marejeleo haya katika kidokezo. |
| `video_urls` | `videos` | array of video URL | no |  | ≤ 3 items | Marejeleo ya video kwa uzalishaji, yanayotolewa kama faili za MP4 au MOV na kutambuliwa katika kidokezo kwa @Video1, @Video2, na lebo zinazofuata zenye nambari. Kila moja lazima iwe na mwonekano wa takriban 480p (640x640) hadi takriban 720p (834x1112). Seti ina kikomo cha video 3 zenye jumla ya chini ya 50 MB, na muda wa jumla wa sekunde 2 hadi 15. |
| `audio_urls` | `audios` | array of audio URL | no |  | ≤ 3 items | Marejeleo ya sauti kwa mwongozo wa video yanahitaji angalau rejeleo moja la picha au video linaloandamana. Toa faili za MP3 au WAV zenye ukubwa wa hadi 15 MB kila moja, zisizozidi faili 3 na muda wa jumla wa hadi sekunde 15. Zitambue katika kidokezo kwa @Audio1, @Audio2, na lebo zinazofuata zenye nambari. |
| `resolution` |  | enum (string) | no | `720p` | `480p`, `720p`, `1080p`, `4k` | Mwonekano wa tokeo: 480p hupendelea kasi, 720p hutoa uwiano, 1080p hutoa ubora wa juu, na 4k hutoa ubora wa juu zaidi. |
| `duration` |  | enum (string) | no | `auto` | `auto`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` | Uteuzi wa urefu wa video: `auto` hukabidhi chaguo kwa modeli kwa kutumia kidokezo, huku muda ulioainishwa lazima uwe kati ya sekunde 4 hadi 15. |
| `aspect_ratio` |  | enum (string) | no | `auto` | `auto`, `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16` | Uwiano wa picha wa tokeo: 16:9 hutoa mlalo, 9:16 hutoa picha wima, 1:1 hutoa mraba, na 21:9 hutoa mwonekano mpana wa sinema. Chagua `auto` ili modeli ichague uwiano. |
| `generate_audio` |  | boolean | no | `true` |  | Washa hii ili video iambatane na sauti iliyosawazishwa. Sauti iliyozalishwa inajumuisha usemi unaolingana na miondoko ya midomo, mandhari ya mazingira na athari za sauti. |
| `bitrate_mode` |  | enum (string) | no | `standard` | `standard`, `high` | Chagua kiwango cha biti cha usimbaji wa tokeo: 'standard' huhifadhi chaguo chaguomsingi, ilhali 'high' huiomba modeli kuboresha ubora wa usimbaji kwa gharama ya faili kubwa zaidi. |
| `codec` |  | enum (string) | no | `auto` | `auto`, `H264`, `H265` | Uteuzi wa kodeki ya video: `auto` huacha tabia ya kodeki chaguomsingi bila kubadilika, `H264` huchagua H.264, na `H265` huchagua H.265. |
| `end_user_id` |  | string \| null | no |  |  | Kitambulisho cha kipekee alichopewa mtumiaji wa mwisho. |

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} | Faili ya video iliyozalishwa. |
| `seed` | integer | Thamani ya seed inayotumika wakati wa uzalishaji. |

## 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