# Kainodara

Kiekvienas modelis kainuoja tiksliai tiek, kiek už jį ima jo kūrėjas, JAV doleriais. Mokate iš savo **API likučio**,
kuris skaičiuojamas **API kreditais**: **1 000 API kreditų = 1 $**. API likutis yra atskiras likutis, nesusijęs su
Doitong programėlių kreditais. Planų, minimalių sumų ar mokesčių už modelį nėra: iškvietimas kainuoja jo kainą, kuri iš API likučio
nuskaičiuojama priėmus užklausą.

Rusijoje (doitong.ru, api.doitong.ru arba naudojant `?currency=rub`) kainos taip pat rodomos rubliais: USD kaina ×
USD/RUB kursas × 1,3.

## Vienetai

Kiekvienas modelis turi vieną atsiskaitymo vienetą, rodomą jo puslapyje ir `GET https://api.doitong.com/v1/models/{model_id}`:

| Vienetas | Kiekis |
|---|---|
| `second` | Išvesties vaizdo įrašo arba garso sekundės (`duration`) |
| `image` | Sugeneruoti vaizdai (`num_images`) |
| `megapixel` | Išvesties plotis × aukštis megapikseliais (1 MP = 1024 × 1024 pikseliai) |
| `video` | Vienas sugeneruotas vaizdo įrašas |
| `request` | Vienas iškvietimas |
| `1000_characters` | Įvesties teksto simboliai, 1000 simbolių |
| `step` | Mokymo žingsniai |

Kaina = kiekis × API kreditų skaičius vienetui, suapvalinta į didesnę pusę iki sveiko API kredito (0,001 $), bet ne mažesnė nei 1. Labai pigūs
vienetai gali turėti trupmeninę kainą už vienetą (`0.4` API kredito už sekundę); apvalinama tik bendra iškvietimo suma.

Kai kurie modeliai taiko skirtingą tarifą priklausomai nuo įvesties: vaizdo įrašas su garsu kainuoja daugiau nei be jo, 4K kainuoja daugiau
nei 1K ir taip toliau. Šios **taisyklės** pateikiamos kiekvieno modelio puslapyje. Nepateiktas parametras laikomas turinčiu numatytąją
reikšmę, todėl įvesties kaina, kurią matote, yra ta, kurią mokate.

## Tikslios, išmatuotos, apskaičiuotos ir pagal naudojimą nustatomos kainos

Kiekviena kaina turi `mode`:

- `exact`: kaina apskaičiuojama pagal jūsų įvestį (sekundes, vaizdus, megapikselius, simbolius, žingsnius arba vienodą
  kainą už vaizdo įrašą ar iškvietimą).
- `measured`: kaina priklauso nuo jūsų siunčiamų failų: įvesties vaizdo įrašo arba garso trukmės, įvesties
  vaizdo dydžio, vaizdo įrašo kadrų dažnio arba kadrų skaičiaus. Taip kainuojami raiškos didinimo, lūpų sinchronizavimo, vaizdo į vaizdą, transkripcijos ir garso įrankiai.
  Prieš paleidžiant API nuskaito failo trukmę, raišką ir kadrų dažnį (tą patį atlieka ir kainos pasiūlymas), todėl pasiūlyta kaina tiksliai atitinka paleidimo kainą.
  Modelio puslapyje nurodoma, už ką mokate ("Kaina už jūsų įvesties vaizdo įrašo sekundę"), o skaičiuotuvas naudoja jūsų failo duomenis. Failas, kurio nepavyksta perskaityti, atmetamas su
  `unmeasurable_input`, o mokestis netaikomas.
- `estimate`: tikroji modelio kaina priklauso nuo to, ko įvestis iš anksto neatskleidžia (žetonų, skaičiavimo laiko).
  Toks modelis taiko fiksuotą **apskaičiuotą kainą už paleidimą** (už išvesties vaizdą, kai nurodomas vaizdų skaičius), nustatytą pagal
  faktinių šio modelio paleidimų vidutinę kainą. Kainą vis tiek žinote prieš paleisdami: pasiūlyta kaina yra ta, kurią mokate.
- `metered`: modelis apmokestinamas pagal **faktinį naudojimą**, kurį žino tik pats paleidimas: kalbos arba
  vaizdo modelio perskaitytus ir sugeneruotus žetonus, balso modelio sugeneruoto kalbėjimo sekundes arba modelio apdorojimo laiką.
  Žr. toliau pateiktą skiltį [Apmokestinama pagal naudojimą](#metered).

Modelių puslapiuose rašoma "Kaina už paleidimą", "Kaina už jūsų įvesties vaizdo įrašo sekundę" (ir panašiai), "Apskaičiuota kaina už paleidimą" arba
"Apmokestinama pagal naudojimą"; `GET https://api.doitong.com/v1/models?mode=measured`, `?mode=estimate` ir `?mode=metered` juos išvardija.

## Apmokestinama pagal naudojimą

`metered` modelis turi naudojimo kainą ("$0.01 už 1000 žetonų", "$0.002 už sugeneruoto garso sekundę", "$0.00111 už
apdorojimo laiko sekundę") ir **didžiausią kainą už paleidimą**: didžiausią sumą, kurią gali kainuoti paleidimas, nustatomą pagal tai, ką nurodo jūsų užklausa
(`max_tokens`, teksto ilgį, raišką, išvesčių skaičių) ir paskelbtus modelio apribojimus. Ji niekada nepriklauso nuo URL nurodyto failo turinio. Modelio, apmokestinamo pagal apdorojimo laiką arba balso
seanso trukmę, didžiausia kaina atitinka ilgiausią galimą užklausos trukmę (15 minučių vaizdams, 30 garsui, 60 vaizdo įrašui), todėl ji gerokai
viršija įprasto paleidimo kainą. Įvestis, kurios didžiausia kaina viršytų modelio paleidimo ribą (labai ilgas tekstas), atmetama
su `422 invalid_input`:

1. Kainos pasiūlymas grąžina šią didžiausią sumą kaip `credits` (su `hold` ir `typical`, įprastu paleidimu). Paleidus, didžiausia suma nuskaičiuojama iš API likučio, todėl ją turi padengti likutis ir jūsų rakto biudžetas.
2. Kai paleidimas sėkmingas, užklausa galutinai apskaičiuojama pagal modelio praneštą naudojimą: naudojimas × naudojimo kaina,
   suapvalinta į didesnę pusę iki sveiko API kredito. **Likusi didžiausios sumos dalis grąžinama automatiškai**, vieną kartą, kaip `refund` eilutė
   jūsų API likutyje.
3. Paleidimas niekada nekainuoja daugiau nei didžiausia jo kaina, net jei naudojimas tai lemtų. Nepavykęs arba atšauktas paleidimas visada grąžinamas visas.

Dauguma paleidimų kainuoja gerokai mažiau nei didžiausia suma; modelio puslapyje rodomas "Iki $X už paleidimą" kūrėjo įvesties atveju ir
įprastas paleidimas (kataloge – "nuo"). Kelių modelių, apmokestinamų pagal apdorojimo laiką, naudojimas yra modelio apdorojimo laikas (pažymėtas
`approximate`).

```json 200 OK · metered modelio kainos pasiūlymas
{
  "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 paleidimo užklausos `cost` rodo, kas buvo rezervuota ir kiek sudarė naudojimas:

```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` yra paleidimo kaina. `settled.status` yra `pending` laikotarpiu nuo rezultato gavimo iki atsiskaitymo, o `no_usage` retu atveju, kai modelis apskritai nepranešė apie naudojimą (tuomet didžiausia suma lieka kaina).

## Kainos pasiūlymas prieš paleidžiant

`POST https://api.doitong.com/v1/quote/{model_id}` priima tiksliai tą turinį, kurį siųstumėte į `run`, ir grąžina šios įvesties kainą: tikslią kainą, išskyrus modelį, [apmokestinamą pagal naudojimą](#metered), kurio atveju tai yra didžiausia galima paleidimo kaina. Rakto nereikia ir nieko nekainuoja:

```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 · kainos pasiūlymas
{
  "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": []
}
```

Naudojant raktą, kainos pasiūlyme taip pat pateikiami `balance_credits` ir `balance_usd` (jūsų API likutis), `affordable` ir
`key_budget_remaining`. Pridėkite `?currency=rub`, kad gautumėte `rub` sumą.

> [!TIP]
> **Kainos pasiūlymas yra mokestis.** Ta pati funkcija apskaičiuoja abu dydžius, todėl paleidimas su šia įvestimi kainuoja tiksliai `credits`.
> Vienintelė išimtis – modelis, [apmokestinamas pagal naudojimą](#metered) (`mode: metered`): čia `credits` yra didžiausia galima paleidimo kaina,
> nuskaičiuojama paleidimo pradžioje, o nepanaudota dalis grąžinama po paleidimo.

## Kainos objektai

Kiekviena API kaina turi tokią pačią struktūrą:

- 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" }` – taip pat `rub`,
  `rub_display` ir `from_rub` Rusijoje arba naudojant `?currency=rub`;
- requests: `cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 }` (API kreditai; `metered` užklausoje
  papildomai pateikiami `mode`, `held`, `typical` ir `settled`, žr. [Apmokestinama pagal naudojimą](#metered));
- account: `GET https://api.doitong.com/v1/account` grąžina `credits` (API likutį), `balance: { "credits", "usd" }` ir
  `storage` (failų saugyklos kainą, naudojimą ir mėnesio sąmatą).

## Grąžinimai

- Už netinkamą užklausą (bet kurią `4xx` prieš paleidimo pradžią) mokestis niekada netaikomas.
- Užklausa, kuri baigiasi `failed` (įskaitant `timeout`), automatiškai grąžinama visa į API likutį.
- Užklausa, kurią atšaukiate prieš paleidimą, grąžinama visa. Modeliui pradėjus generuoti, atšaukimas yra tik užklausa: jei modelis baigia darbą, rezultatas pateikiamas ir už jį mokama.
- Sėkmingos `metered` užklausos nepanaudota didžiausios sumos dalis grąžinama.

Užklausos objektas rodo visą informaciją: `cost.credits`, `cost.charged` ir `cost.refunded`.

## Failų saugykla

Išvesties failai saugomi mūsų saugykloje. Pasirenkate paskyroje arba kiekvienam paleidimui (`?storage=`):

| | Saugojimo trukmė | Kaina |
|---|---|---|
| Neribotą laiką (`permanent`, numatytasis) | Kol juos ištrinsite | 100 API kreditų (0,10 $) už GB per mėnesį |
| 7 dienų (`temporary`) | 7 dienų | Nemokama |

Už nuolatinę saugyklą kartą per dieną mokama iš API likučio: saugomas GB kiekis × mėnesio kaina ÷ mėnesio dienų skaičius,
žurnalo eilutėse su rūšimi `storage`. API kreditų trupmenos perkeliamos į kitą dieną, todėl per mėnesį susidaro tiksliai
GB × 100 API kreditų (1 GB = 1024³ baitai; 10 GB saugojimas mėnesį kainuoja
1 000 API kreditų). Likutis niekada nenukrenta žemiau nulio: kai mokėti neįmanoma, tą dieną mokestis netaikomas,
gaunate el. laišką ir turite 30 dienas likutį papildyti, kol saugomi failai taps laikini ir bus
ištrinti po 7 dienų. Išsami informacija: [Failai](https://doitong.com/developers/docs/files#storage).

## Dabartinės kainos

| Modelis | ID | Kaina | Nuo |
|---|---|---|---|
| [FLUX.1 \[dev\]](https://doitong.com/developers/models/flux/dev) | `flux/dev` | 0,025 $ / megapikselį | 0,025 $ (25 API kreditai) |
| [FLUX.1 \[schnell\]](https://doitong.com/developers/models/flux/schnell) | `flux/schnell` | 0,003 $ / megapikselį | 0,003 $ (3 API kreditai) |
| [FLUX.2 \[dev\]](https://doitong.com/developers/models/flux-2) | `flux-2` | 0,012 $ / megapikselį | 0,012 $ (12 API kreditų) |
| [FLUX.2 \[pro\]](https://doitong.com/developers/models/flux-2-pro) | `flux-2-pro` | 0,015 $ / išvesties vaizdo megapikselį | 0,015 $ (15 API kreditų) |
| [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` | nuo 0,008 $ / vaizdą | 0,008 $ (8 API kreditai) |
| [Ideogram V4.5](https://doitong.com/developers/models/ideogram/v4.5) | `ideogram/v4.5` | nuo 0,03 $ / vaizdą | 0,03 $ (30 API kreditų) |
| [Nano Banana 2](https://doitong.com/developers/models/nano-banana-2) | `nano-banana-2` | nuo 0,06 $ / vaizdą | 0,06 $ (60 API kreditų) |
| [Nano Banana Pro](https://doitong.com/developers/models/nano-banana-pro) | `nano-banana-pro` | nuo 0,15 $ / vaizdą | 0,15 $ (150 API kreditų) |
| [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` | nuo 0,04 $ / vaizdą | 0,04 $ (40 API kreditų) |
| [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 $ / vaizdą | 0,035 $ (35 API kreditai) |
| [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` | nuo 0,068 $ | 0,068 $ (68 API kreditai) |
| [FLUX.1 Kontext \[pro\]](https://doitong.com/developers/models/flux-pro/kontext) | `flux-pro/kontext` | 0,04 $ / vaizdą | 0,04 $ (40 API kreditų) |
| [Nano Banana 2 Edit](https://doitong.com/developers/models/nano-banana-2/edit) | `nano-banana-2/edit` | nuo 0,06 $ / vaizdą | 0,06 $ (60 API kreditų) |
| [Nano Banana Pro Edit](https://doitong.com/developers/models/nano-banana-pro/edit) | `nano-banana-pro/edit` | nuo 0,15 $ / vaizdą | 0,15 $ (150 API kreditų) |
| [Qwen Image 3 Edit](https://doitong.com/developers/models/alibaba/qwen-image-3/edit) | `alibaba/qwen-image-3/edit` | nuo 0,04 $ / vaizdą | 0,04 $ (40 API kreditų) |
| [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` | nuo 0,0425 $ / išvesties vaizdo įrašo sekundę | 0,043 $ (43 API kreditai) |
| [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` | nuo 0,08 $ / sekundę | 0,48 $ (480 API kreditų) |
| [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` | nuo 0,112 $ / sekundę | 0,56 $ (560 API kreditų) |
| [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` | nuo 0,12 $ / sekundę | 0,72 $ (720 API kreditų) |
| [MiniMax H3 Text to Video](https://doitong.com/developers/models/minimax/h3/text-to-video) | `minimax/h3/text-to-video` | nuo 0,05 $ / sekundę | 0,25 $ (250 API kreditų) |
| [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` | nuo 0,113 $ / sekundę | 0,452 $ (452 API kreditai) |
| [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` | nuo 0,141 $ / sekundę | 0,564 $ (564 API kreditai) |
| [Veo 3.1](https://doitong.com/developers/models/veo3.1) | `veo3.1` | nuo 0,20 $ / sekundę | 1,60 $ (1 600 API kreditų) |
| [Veo 3.1 Fast](https://doitong.com/developers/models/veo3.1/fast) | `veo3.1/fast` | nuo 0,10 $ / sekundę | 0,80 $ (800 API kreditų) |
| [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` | nuo 0,05 $ / sekundę | 0,25 $ (250 API kreditų) |
| [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` | nuo 0,0425 $ / išvesties vaizdo įrašo sekundę | 0,043 $ (43 API kreditai) |
| [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` | nuo 0,082 $ / sekundę | 0,492 $ (492 API kreditai) |
| [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` | nuo 0,112 $ / sekundę | 0,56 $ (560 API kreditų) |
| [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` | nuo 0,12 $ / sekundę | 0,72 $ (720 API kreditų) |
| [MiniMax H3 Image to Video](https://doitong.com/developers/models/minimax/h3/image-to-video) | `minimax/h3/image-to-video` | nuo 0,05 $ / sekundę | 0,25 $ (250 API kreditų) |
| [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` | nuo 0,113 $ / sekundę | 0,452 $ (452 API kreditai) |
| [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` | nuo 0,141 $ / sekundę | 0,564 $ (564 API kreditai) |
| [Veo 3.1 Fast Image to Video](https://doitong.com/developers/models/veo3.1/fast/image-to-video) | `veo3.1/fast/image-to-video` | nuo 0,10 $ / sekundę | 0,80 $ (800 API kreditų) |
| [Veo 3.1 Image to Video](https://doitong.com/developers/models/veo3.1/image-to-video) | `veo3.1/image-to-video` | nuo 0,20 $ / sekundę | 1,60 $ (1 600 API kreditų) |
| [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` | nuo 0,05 $ / sekundę | 0,25 $ (250 API kreditų) |
| [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` | nuo 0,113 $ / sekundę | 0,452 $ (452 API kreditai) |
| [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` | nuo 0,141 $ / sekundę | 0,564 $ (564 API kreditai) |
| [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 $ / įvesties garso sekundę | 0,115 $ (115 API kreditų) |
| [Sync Lipsync 3](https://doitong.com/developers/models/sync-lipsync/v3) | `sync-lipsync/v3` | 8,00 $ / išvesties vaizdo įrašo minutę | 8,00 $ (8 000 API kreditų) |
| [VEED Fabric 1.0](https://doitong.com/developers/models/veed/fabric-1.0) | `veed/fabric-1.0` | nuo 0,08 $ / įvesties garso sekundę | 0,08 $ (80 API kreditų) |
| [Topaz Image Upscale](https://doitong.com/developers/models/topaz/upscale/image/precision) | `topaz/upscale/image/precision` | 0,08 $ / 24 išvesties vaizdo megapikselius | 0,08 $ (80 API kreditų) |
| [Topaz Video Upscale](https://doitong.com/developers/models/topaz/upscale/video/precision) | `topaz/upscale/video/precision` | nuo 0,00667 $ / įvesties vaizdo įrašo sekundę | 0,10 $ (100 API kreditų) |
| [Bria RMBG 2.0](https://doitong.com/developers/models/bria/background/remove) | `bria/background/remove` | nuo 0,018 $ | 0,018 $ (18 API kreditų) |
| [Eleven v4 Text to Speech](https://doitong.com/developers/models/elevenlabs/tts/eleven-v4) | `elevenlabs/tts/eleven-v4` | 0,08 $ / 1000 simbolių | 0,08 $ (80 API kreditų) |
| [MiniMax Speech 2.8 HD](https://doitong.com/developers/models/minimax/speech-2.8-hd) | `minimax/speech-2.8-hd` | 0,10 $ / 1000 simbolių | 0,10 $ (100 API kreditų) |
| [MiniMax Music 3](https://doitong.com/developers/models/minimax/music-3) | `minimax/music-3` | 0,002 $ / sekundę | 0,12 $ (120 API kreditų) |
| [MMAudio V2](https://doitong.com/developers/models/mmaudio-v2) | `mmaudio-v2` | 0,001 $ / sekundę | 0,008 $ (8 API kreditai) |

Tai yra rekomenduojami modeliai. Visi 1 496 modelių duomenys ir kainos pateikti [modelių kataloge](https://doitong.com/developers/models) ir `GET /models` (rakto nereikia).

## Papildymas

Papildykite API likutį adresu [https://doitong.com/developers/dashboard#balance](https://doitong.com/developers/dashboard#balance). Kai likutis per mažas, paleidimas grąžina
`402 insufficient_credits` su `top_up_url`. Kiekvienam API raktui taip pat galima nustatyti atskirą biudžetą API kreditais
(žr. [Autentifikavimas](https://doitong.com/developers/docs/authentication#credit-budgets)).
