# Ceny

Každý model stojí přesně tolik, kolik za něj účtuje jeho tvůrce, v amerických dolarech. Platíte ze svého **zůstatku API**, který se počítá v **API kreditech**: **1 000 kreditů API = 1 $**. Zůstatek API je samostatný a oddělený od kreditů aplikací Doitong. Neexistují žádné tarify, minima ani poplatky za model: volání stojí svou cenu, která se odečte ze zůstatku API, jakmile je požadavek přijat.

V Rusku (doitong.ru, api.doitong.ru nebo `?currency=rub`) se ceny zobrazují také v rublech: cena v USD × kurz USD/RUB × 1,3.

## Jednotky

Každý model má jednu fakturační jednotku uvedenou na své stránce a v `GET https://api.doitong.com/v1/models/{model_id}`:

| Jednotka | Množství |
|---|---|
| `second` | Sekundy výstupního videa nebo zvuku (`duration`) |
| `image` | Vygenerované obrázky (`num_images`) |
| `megapixel` | Šířka × výška výstupu v megapixelech (1 MP = 1024 × 1024 pixelů) |
| `video` | Jedno vygenerované video |
| `request` | Jedno volání |
| `1000_characters` | Znaky vstupního textu na 1000 |
| `step` | Trénovací kroky |

Cena = množství × počet API kreditů za jednotku, zaokrouhleno nahoru na celé API kredity (0,001 $), nikdy méně než 1. Velmi levné jednotky mohou mít zlomkovou cenu za jednotku (`0.4` API kreditu za sekundu); zaokrouhluje se pouze celková cena volání.

Některé modely účtují různé sazby podle vstupu: video se zvukem stojí více než bez zvuku, 4K více než 1K atd. Tato **pravidla** jsou uvedena na stránce každého modelu. Parametr, který vynecháte, se považuje za výchozí hodnotu, takže cena zobrazená pro vstup je cena, kterou zaplatíte.

## Přesné, měřené, odhadované ceny a ceny podle využití

Každá cena má `mode`:

- `exact`: cena se vypočítá ze vstupu (sekundy, obrázky, megapixely, znaky, kroky nebo jedna pevná cena za video či volání).
- `measured`: cena vychází ze souborů, které odešlete: délky vstupního videa nebo zvuku, velikosti vstupního obrázku, snímkové frekvence nebo počtu snímků videa. Upscaling, synchronizace rtů, převod videa na video, přepis a zvukové nástroje se účtují tímto způsobem. Před spuštěním API načte délku, rozlišení a snímkovou frekvenci souboru (totéž provede cenová nabídka), takže nabídka přesně odpovídá ceně spuštění. Stránka modelu uvádí, za co platíte ("Cena za sekundu vašeho vstupního videa") a kalkulačka používá hodnoty vašeho souboru. Soubor, který nelze přečíst, se odmítne s `unmeasurable_input` a nic se neúčtuje.
- `estimate`: vlastní cena modelu závisí na něčem, co vstup nedokáže předem určit (tokenech, výpočetním čase). Takový model účtuje pevnou **odhadovanou cenu za spuštění** (za výstupní obrázek, pokud má počet obrázků), stanovenou z průměrné ceny skutečných spuštění tohoto modelu. Cenu stále znáte před spuštěním: nabídka je částka, kterou zaplatíte.
- `metered`: model se **účtuje podle skutečného využití**, které zná pouze samotné spuštění: tokenů, které jazykový nebo obrazový model přečte a zapíše, sekund řeči vygenerovaných hlasovým modelem nebo času zpracování modelu. Viz [Účtování podle využití](#metered) níže.

Stránky modelů uvádějí „Cena za spuštění“, „Cena za sekundu vašeho vstupního videa“ (a podobně), „Odhadovaná cena za spuštění“ nebo „Účtováno podle využití“; `GET https://api.doitong.com/v1/models?mode=measured`, `?mode=estimate` a `?mode=metered` je vypisují.

## Účtování podle využití

Model `metered` má cenu podle využití ("$0.01 za 1000 tokenů", "$0.002 za sekundu vygenerovaného zvuku", "$0.00111 za sekundu času zpracování") a **maximum za spuštění**: nejvyšší částku, kterou může spuštění stát, podle toho, co uvádí váš požadavek (`max_tokens`, délka textu, rozlišení, počet výstupů) a zveřejněných limitů modelu. Nikdy nezávisí na obsahu souboru za URL. U modelu účtovaného podle času zpracování nebo délky hlasové relace je maximum nejdelší doba, po kterou může požadavek běžet (15 minut pro obrázky, 30 pro zvuk, 60 pro video), takže je výrazně vyšší než typická cena. Vstup, jehož maximum by překročilo limit modelu za spuštění (velmi dlouhý text), se odmítne s `422 invalid_input`:

1. Nabídka vrátí toto maximum jako `credits` (s `hold` a `typical`, tedy obvyklým spuštěním). Když spuštění začne, maximum se odečte ze zůstatku API a právě tuto částku musí pokrýt zůstatek i rozpočet vašeho klíče.
2. Po úspěšném dokončení se požadavek vyúčtuje podle využití, které model nahlásí: využití × cena podle využití, zaokrouhleno nahoru na celé API kredity. **Zbytek maxima se automaticky refunduje**, jednou jako řádek `refund` ve zůstatku API.
3. Spuštění nikdy nestojí více než jeho maximum, ani kdyby jeho využití bylo vyšší. Neúspěšné nebo zrušené spuštění se jako vždy refunduje v plné výši.

Většina spuštění stojí výrazně méně než maximum; stránka modelu u vstupu nástroje zobrazuje „Až $X za spuštění“ a typické spuštění („od“ v katalogu). U několika modelů účtovaných podle času zpracování je využitím čas zpracování modelu (označený `approximate`).

```json 200 OK · nabídka modelu metered
{
  "object": "quote",
  "credits": 621,
  "usd": "0.621",
  "mode": "metered",
  "label": "Charged by usage",
  "hold": { "credits": 621, "usd": "0.621" },
  "typical": { "credits": 10, "usd": "0.01" },
  "settlement": "usage",
  "display": "$0.01 / 1000 tokens",
  "breakdown": "up to 62.035 × 1000 tokens × $0.01"
}
```

Po spuštění `cost` požadavku ukazuje, co bylo zadrženo a kolik činilo využití:

```json
{
  "cost": { "credits": 621, "usd": "0.621", "charged": 621, "refunded": 611, "mode": "metered", "held": 621,
            "typical": 10, "settled": { "status": "settled", "credits": 10, "usd": "0.01", "quantity": 1,
            "unit": "1000_tokens", "unit_usd": "0.01", "source": "billed_usage", "approximate": false } }
}
```

`charged − refunded` je cena spuštění. `settled.status` je `pending` v okamžiku mezi výsledkem a vyúčtováním a `no_usage` ve vzácném případě, kdy model nenahlásil žádné využití (pak maximum zůstává cenou).

## Nabídka před spuštěním

`POST https://api.doitong.com/v1/quote/{model_id}` přijímá přesně tělo, které byste poslali do `run`, a vrací cenu tohoto vstupu: přesnou cenu, s výjimkou modelu [účtovaného podle využití](#metered), u kterého jde o nejvyšší možnou cenu spuštění. Nevyžaduje klíč a nic nestojí:

```bash
curl -X POST "https://api.doitong.com/v1/quote/flux/schnell" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A lighthouse at dusk", "num_images": 2}'
```

```json 200 OK · nabídka
{
  "object": "quote",
  "model": "flux/schnell",
  "credits": 6,
  "usd": "0.006",
  "unit": "megapixel",
  "quantity": 2,
  "unit_credits": 3,
  "mode": "exact",
  "label": "Price per run",
  "display": "$0.003 / megapixel",
  "breakdown": "2 MP (2 images) × 3 API credits",
  "input": { "prompt": "A lighthouse at dusk", "num_images": 2 },
  "warnings": []
}
```

S klíčem nabídka vrací také `balance_credits` a `balance_usd` (váš zůstatek API), `affordable` a `key_budget_remaining`. Pro částku v `rub` přidejte `?currency=rub`.

> [!TIP]
> **Nabídka je účtovaná částka.** Stejná funkce vypočítá obojí, takže spuštění s tímto vstupem stojí přesně `credits`.
> Jedinou výjimkou je model [účtovaný podle využití](#metered) (`mode: metered`): zde `credits` představuje nejvyšší možnou cenu spuštění, odečtenou při jeho zahájení; nevyužitá část se po spuštění refunduje.

## Objekty cen

Každá cena v API má stejný tvar:

- models: `price: { "credits": 112, "usd": "0.112", "unit": "second", "display": "$0.112 / second",
  "credits_display": "112 API credits / second", "from_credits": 560, "from_usd": "0.56", "mode": "exact" }` — v Rusku nebo s `?currency=rub` navíc `rub`, `rub_display` a `from_rub`;
- requests: `cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 }` (API kredity; požadavek `metered` navíc obsahuje `mode`, `held`, `typical` a `settled`, viz [Účtování podle využití](#metered));
- account: `GET https://api.doitong.com/v1/account` vrací `credits` (zůstatek API), `balance: { "credits", "usd" }` a `storage` (cenu úložiště souborů, využití a měsíční odhad).

## Refundace

- Neplatný požadavek (jakýkoli `4xx` před zahájením spuštění) se nikdy neúčtuje.
- Požadavek, který skončí stavem `failed` (včetně `timeout`), se automaticky v plné výši refunduje do zůstatku API.
- Požadavek, který zrušíte před jeho zahájením, se refunduje v plné výši. Jakmile model začne generovat, zrušení je pouze požadavek: pokud model dokončí práci, výsledek se doručí a naúčtuje.
- Úspěšný požadavek `metered` získá zpět část svého maxima, kterou nevyužil.

Objekt požadavku zobrazuje vše: `cost.credits`, `cost.charged` a `cost.refunded`.

## Úložiště souborů

Výstupní soubory uchováváme v našem úložišti. Zvolíte ho v účtu nebo pro jednotlivé spuštění (`?storage=`):

| | Uchování | Cena |
|---|---|---|
| Navždy (`permanent`, výchozí) | Dokud je nesmažete | 100 API kredity (0,10 $) za GB za měsíc |
| 7 dní (`temporary`) | 7 dní | Zdarma |

Za trvalé úložiště se ze zůstatku API účtuje jednou denně: uchovávané GB × měsíční cena ÷ počet dní v měsíci, jako řádky účetní knihy druhu `storage`. Zlomky API kreditu se přenášejí do dalšího dne, takže za měsíc se přesně nasčítají na GB × 100 API kreditů (1 GB = 1024³ bajtů; 10 GB uchovávaných měsíc stojí 1 000 API kreditů). Zůstatek nikdy neklesne pod nulu: když nelze zaplatit, daný den se nic neúčtuje, dostanete e-mail a máte 30 dní na dobití, než se uchovávané soubory změní na dočasné a 7 dní poté se smažou. Podrobnosti: [Soubory](https://doitong.com/developers/docs/files#storage).

## Aktuální ceny

| Model | ID | Cena | Od |
|---|---|---|---|
| [FLUX.1 \[dev\]](https://doitong.com/developers/models/flux/dev) | `flux/dev` | 0,025 $ / megapixel | 0,025 $ (25 kreditů API) |
| [FLUX.1 \[schnell\]](https://doitong.com/developers/models/flux/schnell) | `flux/schnell` | 0,003 $ / megapixel | 0,003 $ (3 kredity API) |
| [FLUX.2 \[dev\]](https://doitong.com/developers/models/flux-2) | `flux-2` | 0,012 $ / megapixel | 0,012 $ (12 kreditů API) |
| [FLUX.2 \[pro\]](https://doitong.com/developers/models/flux-2-pro) | `flux-2-pro` | 0,015 $ / megapixel výstupního obrázku | 0,015 $ (15 kreditů API) |
| [GPT Image 2.5 Text to Image](https://doitong.com/developers/models/openai/gpt-image-2.5/flare/text-to-image) | `openai/gpt-image-2.5/flare/text-to-image` | od 0,008 $ / obrázek | 0,008 $ (8 kreditů API) |
| [Ideogram V4.5](https://doitong.com/developers/models/ideogram/v4.5) | `ideogram/v4.5` | od 0,03 $ / obrázek | 0,03 $ (30 kreditů API) |
| [Nano Banana 2](https://doitong.com/developers/models/nano-banana-2) | `nano-banana-2` | od 0,06 $ / obrázek | 0,06 $ (60 kreditů API) |
| [Nano Banana Pro](https://doitong.com/developers/models/nano-banana-pro) | `nano-banana-pro` | od 0,15 $ / obrázek | 0,15 $ (150 kreditů API) |
| [Qwen Image 3 Text to Image](https://doitong.com/developers/models/alibaba/qwen-image-3/text-to-image) | `alibaba/qwen-image-3/text-to-image` | od 0,04 $ / obrázek | 0,04 $ (40 kreditů API) |
| [Recraft V4.1 Text to Image](https://doitong.com/developers/models/recraft/v4.1/text-to-image) | `recraft/v4.1/text-to-image` | 0,035 $ / obrázek | 0,035 $ (35 kreditů API) |
| [Seedream 5.0 Pro Text to Image](https://doitong.com/developers/models/bytedance/seedream/v5/pro/text-to-image) | `bytedance/seedream/v5/pro/text-to-image` | od 0,068 $ | 0,068 $ (68 kreditů API) |
| [FLUX.1 Kontext \[pro\]](https://doitong.com/developers/models/flux-pro/kontext) | `flux-pro/kontext` | 0,04 $ / obrázek | 0,04 $ (40 kreditů API) |
| [Nano Banana 2 Edit](https://doitong.com/developers/models/nano-banana-2/edit) | `nano-banana-2/edit` | od 0,06 $ / obrázek | 0,06 $ (60 kreditů API) |
| [Nano Banana Pro Edit](https://doitong.com/developers/models/nano-banana-pro/edit) | `nano-banana-pro/edit` | od 0,15 $ / obrázek | 0,15 $ (150 kreditů API) |
| [Qwen Image 3 Edit](https://doitong.com/developers/models/alibaba/qwen-image-3/edit) | `alibaba/qwen-image-3/edit` | od 0,04 $ / obrázek | 0,04 $ (40 kreditů API) |
| [FLUX 3 Max Text to Video](https://doitong.com/developers/models/blackforestlabs/flux-3-max/text-to-video) | `blackforestlabs/flux-3-max/text-to-video` | od 0,0425 $ / sekunda výstupního videa | 0,043 $ (43 kreditů API) |
| [Grok Imagine Video 1.5 Text to Video](https://doitong.com/developers/models/xai/grok-imagine-video/v1.5/text-to-video) | `xai/grok-imagine-video/v1.5/text-to-video` | od 0,08 $ / sekunda | 0,48 $ (480 kreditů API) |
| [Kling 3.0 Pro Text to Video](https://doitong.com/developers/models/kling-video/v3/pro/text-to-video) | `kling-video/v3/pro/text-to-video` | od 0,112 $ / sekunda | 0,56 $ (560 kreditů API) |
| [LTX 2.5 Pro Text to Video](https://doitong.com/developers/models/lightricks/ltx-2.5/text-to-video/pro) | `lightricks/ltx-2.5/text-to-video/pro` | od 0,12 $ / sekunda | 0,72 $ (720 kreditů API) |
| [MiniMax H3 Text to Video](https://doitong.com/developers/models/minimax/h3/text-to-video) | `minimax/h3/text-to-video` | od 0,05 $ / sekunda | 0,25 $ (250 kreditů API) |
| [Seedance 2.0 Fast Text to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/fast/text-to-video) | `bytedance/seedance-2.0/fast/text-to-video` | od 0,113 $ / sekunda | 0,452 $ (452 kreditů API) |
| [Seedance 2.0 Text to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/text-to-video) | `bytedance/seedance-2.0/text-to-video` | od 0,141 $ / sekunda | 0,564 $ (564 kreditů API) |
| [Veo 3.1](https://doitong.com/developers/models/veo3.1) | `veo3.1` | od 0,20 $ / sekunda | 1,60 $ (1 600 kreditů API) |
| [Veo 3.1 Fast](https://doitong.com/developers/models/veo3.1/fast) | `veo3.1/fast` | od 0,10 $ / sekunda | 0,80 $ (800 kreditů API) |
| [Wan 3.0 Text to Video](https://doitong.com/developers/models/alibaba/wan-3.0/text-to-video) | `alibaba/wan-3.0/text-to-video` | od 0,05 $ / sekunda | 0,25 $ (250 kreditů API) |
| [FLUX 3 Max Image to Video](https://doitong.com/developers/models/blackforestlabs/flux-3-max/image-to-video) | `blackforestlabs/flux-3-max/image-to-video` | od 0,0425 $ / sekunda výstupního videa | 0,043 $ (43 kreditů API) |
| [Grok Imagine Video 1.5 Image to Video](https://doitong.com/developers/models/xai/grok-imagine-video/v1.5/image-to-video) | `xai/grok-imagine-video/v1.5/image-to-video` | od 0,082 $ / sekunda | 0,492 $ (492 kreditů API) |
| [Kling 3.0 Pro Image to Video](https://doitong.com/developers/models/kling-video/v3/pro/image-to-video) | `kling-video/v3/pro/image-to-video` | od 0,112 $ / sekunda | 0,56 $ (560 kreditů API) |
| [LTX 2.5 Pro Image to Video](https://doitong.com/developers/models/lightricks/ltx-2.5/image-to-video/pro) | `lightricks/ltx-2.5/image-to-video/pro` | od 0,12 $ / sekunda | 0,72 $ (720 kreditů API) |
| [MiniMax H3 Image to Video](https://doitong.com/developers/models/minimax/h3/image-to-video) | `minimax/h3/image-to-video` | od 0,05 $ / sekunda | 0,25 $ (250 kreditů API) |
| [Seedance 2.0 Fast Image to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/fast/image-to-video) | `bytedance/seedance-2.0/fast/image-to-video` | od 0,113 $ / sekunda | 0,452 $ (452 kreditů API) |
| [Seedance 2.0 Image to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/image-to-video) | `bytedance/seedance-2.0/image-to-video` | od 0,141 $ / sekunda | 0,564 $ (564 kreditů API) |
| [Veo 3.1 Fast Image to Video](https://doitong.com/developers/models/veo3.1/fast/image-to-video) | `veo3.1/fast/image-to-video` | od 0,10 $ / sekunda | 0,80 $ (800 kreditů API) |
| [Veo 3.1 Image to Video](https://doitong.com/developers/models/veo3.1/image-to-video) | `veo3.1/image-to-video` | od 0,20 $ / sekunda | 1,60 $ (1 600 kreditů API) |
| [Wan 3.0 Image to Video](https://doitong.com/developers/models/alibaba/wan-3.0/image-to-video) | `alibaba/wan-3.0/image-to-video` | od 0,05 $ / sekunda | 0,25 $ (250 kreditů API) |
| [Seedance 2.0 Fast Reference to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/fast/reference-to-video) | `bytedance/seedance-2.0/fast/reference-to-video` | od 0,113 $ / sekunda | 0,452 $ (452 kreditů API) |
| [Seedance 2.0 Reference to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/reference-to-video) | `bytedance/seedance-2.0/reference-to-video` | od 0,141 $ / sekunda | 0,564 $ (564 kreditů API) |
| [Kling AI Avatar 2.0 Pro](https://doitong.com/developers/models/kling-video/ai-avatar/v2/pro) | `kling-video/ai-avatar/v2/pro` | 0,115 $ / sekunda vstupního zvuku | 0,115 $ (115 kreditů API) |
| [Sync Lipsync 3](https://doitong.com/developers/models/sync-lipsync/v3) | `sync-lipsync/v3` | 8,00 $ / minuta výstupního videa | 8,00 $ (8 000 kreditů API) |
| [VEED Fabric 1.0](https://doitong.com/developers/models/veed/fabric-1.0) | `veed/fabric-1.0` | od 0,08 $ / sekunda vstupního zvuku | 0,08 $ (80 kreditů API) |
| [Topaz Image Upscale](https://doitong.com/developers/models/topaz/upscale/image/precision) | `topaz/upscale/image/precision` | 0,08 $ / 24 megapixelu výstupního obrázku | 0,08 $ (80 kreditů API) |
| [Topaz Video Upscale](https://doitong.com/developers/models/topaz/upscale/video/precision) | `topaz/upscale/video/precision` | od 0,00667 $ / sekunda vstupního videa | 0,10 $ (100 kreditů API) |
| [Bria RMBG 2.0](https://doitong.com/developers/models/bria/background/remove) | `bria/background/remove` | od 0,018 $ | 0,018 $ (18 kreditů API) |
| [Eleven v4 Text to Speech](https://doitong.com/developers/models/elevenlabs/tts/eleven-v4) | `elevenlabs/tts/eleven-v4` | 0,08 $ / 1000 znaků | 0,08 $ (80 kreditů API) |
| [MiniMax Speech 2.8 HD](https://doitong.com/developers/models/minimax/speech-2.8-hd) | `minimax/speech-2.8-hd` | 0,10 $ / 1000 znaků | 0,10 $ (100 kreditů API) |
| [MiniMax Music 3](https://doitong.com/developers/models/minimax/music-3) | `minimax/music-3` | 0,002 $ / sekunda | 0,12 $ (120 kreditů API) |
| [MMAudio V2](https://doitong.com/developers/models/mmaudio-v2) | `mmaudio-v2` | 0,001 $ / sekunda | 0,008 $ (8 kreditů API) |

Toto jsou doporučené modely. Všech 1 496 modelů a jejich ceny jsou v [katalogu modelů](https://doitong.com/developers/models) a v `GET /models` (klíč není potřeba).

## Dobití

Přidejte peníze do zůstatku API na adrese [https://doitong.com/developers/dashboard#balance](https://doitong.com/developers/dashboard#balance). Když je zůstatek příliš nízký, spuštění odpoví `402 insufficient_credits` s `top_up_url`. Každý API klíč lze také omezit vlastním rozpočtem v API kreditech (viz [Autentizace](https://doitong.com/developers/docs/authentication#credit-budgets)).
