# Seedance 2.0 Text to Video API

> Синхрондалған дыбысы бар, 480p-ден 4K-ға дейінгі көп кадрлы көріністерге арналған ByteDance компаниясының үздік бейне моделі.

Seedance 2.0 промпт бойынша шағын толық көріністер жасайды: бірнеше кадр, кейіпкерлердің бірізділігі, диалог және дыбыс әсерлері бейнемен бірге жасалады. 4–15 секундты таңдауға немесе ұзақтықты модельге таңдауға беруге, жеті кадр пішімінің кез келгенін және 480p, 720p, 1080p немесе 4K сапасын таңдауға болады. H.264 немесе H.265 нәтижесі.

- Model id: `bytedance/seedance-2.0/text-to-video`
- Made by: ByteDance
- Category: Text to Video
- Output: video
- Price: from $0.141 / second (4 s ≈ $0.564) (cheapest run $0.564 (564 API credits))
- Run: `POST https://api.doitong.ru/v1/run/bytedance/seedance-2.0/text-to-video`
- Quote: `POST https://api.doitong.ru/v1/quote/bytedance/seedance-2.0/text-to-video`
- Docs page: https://doitong.com/kk/developers/models/bytedance/seedance-2.0/text-to-video

## Pricing

Price: **from $0.141 / second (4 s ≈ $0.564)** (the lowest tier; the quote prices your exact input). Billed per second of output (`duration`, default 15).

The full example input below costs $1.52 = 1520 API credits (5 s × 304 API credits).

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/text-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

| Parameter | Canonical name | Type | Required | Default | Allowed values / range | Description |
|---|---|---|---|---|---|---|
| `prompt` |  | string | yes |  |  | Бейне генерациясын бағыттайтын мәтіндік нұсқау. |
| `resolution` |  | enum (string) | no | `720p` | `480p`, `720p`, `1080p`, `4k` | Шығыс ажыратымдылығы: 480p жылдамдыққа, 720p теңгерімге, 1080p жоғары сапаға, 4k ең жоғары сапаға басымдық береді. |
| `duration` |  | enum (string) | no | `auto` | `auto`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` | Бейне ұзақтығын таңдау: `auto` нұсқауға сүйеніп таңдауды модельге береді, ал нақты ұзақтық 4–15 секунд аралығында болуы керек. |
| `aspect_ratio` |  | enum (string) | no | `auto` | `auto`, `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16` | Шығыс арақатынасы: 16:9 альбомдық, 9:16 портреттік/тік, 1:1 шаршы, 21:9 кинематографиялық ультракең бейне береді. Арақатынасты модель таңдауы үшін `auto` таңдаңыз. |
| `generate_audio` |  | boolean | no | `true` |  | Бейнеге синхрондалған аудио қосу үшін осыны қосыңыз. Генерацияланған аудио ерін қимылдарына сәйкестендірілген сөйлеуді, қоршаған орта үнін және дыбыс әсерлерін қамтиды. |
| `bitrate_mode` |  | enum (string) | no | `standard` | `standard`, `high` | Шығыс кодтау битрейтін таңдаңыз: 'standard' әдепкі мәнді сақтайды, ал 'high' файл өлшемін үлкейту есебінен кодтау сапасын жақсартуды сұрайды. |
| `codec` |  | enum (string) | no | `auto` | `auto`, `H264`, `H265` | Бейне кодегін таңдау: `auto` әдепкі кодек әрекетін өзгертпейді, `H264` H.264 таңдайды, `H265` H.265 таңдайды. |

## Example input

Required parameters only:

```json
{
  "prompt": "An octopus finds a football on the sea floor and calls its friends to play, cut to a lively underwater match"
}
```

A fuller example:

```json
{
  "prompt": "An octopus finds a football on the sea floor and calls its friends to play, cut to a lively underwater match",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}
```

## 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/text-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "An octopus finds a football on the sea floor and calls its friends to play, cut to a lively underwater match",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

# 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/text-to-video?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "An octopus finds a football on the sea floor and calls its friends to play, cut to a lively underwater match",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }),
});
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": "An octopus finds a football on the sea floor and calls its friends to play, cut to a lively underwater match",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
}

# 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/text-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/text-to-video",
      "input": {
        "prompt": "An octopus finds a football on the sea floor and calls its friends to play, cut to a lively underwater match",
        "duration": 5,
        "resolution": "720p",
        "aspect_ratio": "16:9"
      },
      "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/text-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": 1520,
    "usd": "1.52",
    "charged": 1520,
    "refunded": 0
  },
  "input": {
    "prompt": "An octopus finds a football on the sea floor and calls its friends to play, cut to a lively underwater match",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  },
  "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} | Генерация нәтижесінде алынған бейне файлы. |
| `seed` | integer | Генерация кезінде қолданылатын seed мәні. |

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