# Seedance 2.0 Mini API

> Pembuatan video Mini Seedance 2.0 yang diarahkan oleh hingga 9 gambar, 3 video, dan 3 referensi audio

Menghasilkan video dari prompt ditambah media referensi: hingga 9 `image_urls`, 3 `video_urls`, dan 3 `audio_urls`, yang dirujuk dalam prompt sebagai @Image1, @Video1, @Audio1, dan seterusnya. Output adalah 480p atau 720p, auto atau 4 hingga 15 detik, dengan rasio aspek dari 21:9 hingga 9:16. Audio tersinkronisasi dibuat secara bawaan.

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

## Pricing

Price: **$0.007 / 1000 tokens**. 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.

The full example input below costs $2.321 = 2321 API credits (331.5586 × 1000 tokens × $0.007 (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/mini/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 teks yang mengarahkan pembuatan video. |
| `image_urls` | `images` | array of image URL | no |  | ≤ 9 items | Referensi gambar untuk panduan video, dibatasi hingga 9 gambar dan maksimal 12 file untuk semua modalitas. Setiap gambar berukuran maksimal 30 MB dan harus berformat JPEG, PNG, atau WebP. Gunakan @Image1, @Image2, dan label bernomor berikutnya untuk mengidentifikasi referensi ini dalam prompt. |
| `video_urls` | `videos` | array of video URL | no |  | ≤ 3 items | Referensi video untuk pembuatan, diberikan sebagai file MP4 atau MOV dan diidentifikasi dalam prompt dengan @Video1, @Video2, serta label bernomor berikutnya. Masing-masing harus memiliki resolusi sekitar 480p (640x640) hingga sekitar 720p (834x1112). Jumlahnya dibatasi hingga 3 video dengan total kurang dari 50 MB dan durasi gabungan 2 hingga 15 detik. |
| `audio_urls` | `audios` | array of audio URL | no |  | ≤ 3 items | Referensi audio untuk panduan video memerlukan setidaknya satu referensi gambar atau video. Berikan file MP3 atau WAV berukuran maksimal 15 MB per file, maksimal 3 file, dengan total durasi maksimal 15 detik. Identifikasi dalam prompt menggunakan @Audio1, @Audio2, dan label bernomor berikutnya. |
| `resolution` |  | enum (string) | no | `720p` | `480p`, `720p` | Resolusi output: 480p mengutamakan kecepatan pembuatan, sedangkan 720p menawarkan pilihan seimbang. |
| `duration` |  | enum (string) | no | `auto` | `auto`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` | Pemilihan durasi video: `auto` menyerahkan pilihan kepada model menggunakan prompt, sedangkan durasi eksplisit harus berada dalam 4 hingga 15 detik. |
| `aspect_ratio` |  | enum (string) | no | `auto` | `auto`, `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16` | Rasio aspek output: 16:9 menghasilkan lanskap, 9:16 potret/vertikal, 1:1 persegi, dan 21:9 ultrawide sinematik. Pilih `auto` agar model menentukan rasionya. |
| `generate_audio` |  | boolean | no | `true` |  | Aktifkan ini untuk menyertakan audio tersinkronisasi pada video. Audio yang dihasilkan mencakup ucapan yang disesuaikan dengan gerakan bibir, suasana lingkungan, dan efek suara. |
| `codec` |  | enum (string) | no | `auto` | `auto`, `H264`, `H265` | Pemilihan codec video: `auto` mempertahankan perilaku codec bawaan, `H264` memilih H.264, dan `H265` memilih H.265. |
| `end_user_id` |  | string \| null | no |  |  | Pengidentifikasi unik yang ditetapkan kepada pengguna akhir. |

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/mini/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/mini/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/mini/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/mini/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/mini/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": 2321,
    "usd": "2.321",
    "charged": 2321,
    "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} | File video yang dihasilkan oleh pembuatan. |
| `seed` | integer | Nilai seed yang diterapkan selama pembuatan. |

## Related models

- [Seedance 2.0 Fast Text to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/fast/text-to-video.md) (`bytedance/seedance-2.0/fast/text-to-video`): from $0.113 / second
- [Seedance 2.0 Mini Text to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/mini/text-to-video.md) (`bytedance/seedance-2.0/mini/text-to-video`): from $0.0721 / second
- [Seedance 2.0 Text to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/text-to-video.md) (`bytedance/seedance-2.0/text-to-video`): from $0.141 / second
- [Seedance 2.0 Fast Image to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/fast/image-to-video.md) (`bytedance/seedance-2.0/fast/image-to-video`): from $0.113 / second
- [Seedance 2.0 Image to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/image-to-video.md) (`bytedance/seedance-2.0/image-to-video`): from $0.141 / second
- [Seedance 2.0 Mini Image to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/mini/image-to-video.md) (`bytedance/seedance-2.0/mini/image-to-video`): from $0.0721 / 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

## Links

- HTML page: https://doitong.com/developers/models/bytedance/seedance-2.0/mini/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/mini/reference-to-video
- Errors: https://doitong.com/developers/docs/errors
- Model details as JSON: https://api.doitong.ru/v1/models/bytedance/seedance-2.0/mini/reference-to-video