# Árazás

Minden modell pontosan annyiba kerül, amennyit a készítője kér érte, amerikai dollárban. A fizetés a **API-egyenlegből** történik, amelyet **API-kreditben** tartunk nyilván: **1000 API-jóváírás = 1 $**. Az API-egyenleg különálló egyenleg, nem azonos a Doitong alkalmazások kreditjeivel. Nincsenek csomagok, minimumok vagy modellenkénti díjak: egy hívás az árába kerül, amelyet a kérés elfogadásakor levonunk az API-egyenlegből.

Oroszországban (doitong.ru, api.doitong.ru vagy `?currency=rub`) az árakat rubelben is megjelenítjük: USD-ár × USD/RUB-árfolyam × 1,3.

## Egységek

Minden modellnek egy számlázási egysége van, amely az oldalán és a `GET https://api.doitong.com/v1/models/{model_id}` válaszában látható:

| Egység | Mennyiség |
|---|---|
| `second` | A kimeneti videó vagy hang másodpercei (`duration`) |
| `image` | A létrehozott képek száma (`num_images`) |
| `megapixel` | A kimenet szélessége × magassága megapixelben (1 MP = 1024 × 1024 képpont) |
| `video` | Egy létrehozott videó |
| `request` | Egy hívás |
| `1000_characters` | A bemeneti szöveg karakterei, ezrenként |
| `step` | Tanítási lépések |

Ár = mennyiség × egységenkénti API-kredit, felfelé kerekítve egész API-kreditre (0,001 $), de legalább 1-re. A nagyon olcsó egységek egységenként tört árat is tartalmazhatnak (`0.4` API-kredit másodpercenként); csak a teljes hívás ára kerekítődik.

Egyes modellek a bemenettől függően eltérő díjat számítanak fel: a hanggal készült videó drágább a hang nélkülinél, a 4K drágább az 1K-nál, és így tovább. Ezek a **szabályok** minden modelloldalon fel vannak sorolva. A kihagyott paraméter alapértelmezett értéknek számít, ezért a bemenethez megjelenített ár az az ár, amelyet fizetnie kell.

## Pontos, mért, becsült és használatalapú árak

Minden árhoz tartozik egy `mode`:

- `exact`: az ár a bemenetből számítható ki (másodpercek, képek, megapixelek, karakterek, lépések, illetve videónként vagy hívásonként egy átalányár).
- `measured`: az ár az elküldött fájlokat követi: a bemeneti videó vagy hang hossza, a bemeneti kép mérete, illetve a videó képkockasebessége vagy képkockáinak száma. A felskálázók, a lip sync, a videóból videó, az átírási és a hangkezelő eszközök így vannak árazva. A futtatás előtt az API beolvassa a fájl hosszát, felbontását és képkockasebességét, ezért az árajánlat pontosan azt az árat mutatja, amelyet a futtatás felszámít. A modelloldal megadja, miért fizet („Price per másodperc of your input videó”), a kalkulátor pedig a fájl adatait használja. A nem olvasható fájlt `unmeasurable_input` hibával elutasítjuk, és nem számítunk fel díjat.
- `estimate`: a modell saját költsége valamitől függ, amit a bemenet előre nem árul el (tokenek, számítási idő). Az ilyen modell futtatásonként rögzített **becsült árat** számít fel (képszám esetén kimeneti képenként), amelyet a modell valós futtatásainak átlagos költségéből határozunk meg. A futtatás előtt így is ismeri az árat: az árajánlat az az összeg, amelyet fizet.
- `metered`: a modell **tényleges használat alapján számlázott**, amelyet csak maga a futtatás ismer: a nyelvi vagy látásmodell által beolvasott és létrehozott tokenek, a hangmodell által létrehozott beszéd másodpercei vagy a modell feldolgozási ideje. Lásd alább: [Használat alapján számlázva](#metered).

A modelloldalak a „Price per run”, „Price per másodperc of your input videó” és hasonló, „Estimated price per run” vagy „Charged by usage” szövegeket használják; a `GET https://api.doitong.com/v1/models?mode=measured`, `?mode=estimate` és `?mode=metered` ezek alapján listáz.

## Használat alapján számlázva

A `metered` modell használati ára például „$0.01 per 1000 tokens”, „$0.002 per second of generated audio” vagy „$0.00111 per second of processing time”, és **futtatásonkénti maximuma** is van: ez a legmagasabb összeg, amibe a futtatás kerülhet a kérés adatai (`max_tokens`, a szöveg hossza, a felbontás, a kimenetek száma) és a modell közzétett korlátai alapján. Soha nem függ az URL mögötti fájl tartalmától. A feldolgozási idő vagy hangmunkamenet hossza alapján számlázott modellnél a maximum a kérés maximális futási ideje (képnél 15 perc, hangnál 30, videónál 60), ezért jóval magasabb lehet egy szokásos futtatásnál. Ha a bemenet maximuma meghaladná a modell futtatásonkénti korlátját, a bemenetet `422 invalid_input` hibával elutasítjuk:

1. Az árajánlat ezt a maximumot `credits` értékként adja vissza (`hold` és `typical` értékekkel, amelyek egy szokásos futtatást jelölnek). A futtatás kezdetekor a maximumot levonjuk az API-egyenlegből, ezért ezt kell fedeznie az egyenlegnek és a kulcs keretének.
2. Sikeres futtatáskor a kérés elszámolása a modell által jelentett használathoz igazodik: használat × használati ár, egész API-kreditre felfelé kerekítve. **A maximum fennmaradó részét automatikusan, egyszer visszatérítjük** az API-egyenleg egy `refund` soraként.
3. Egy futtatás soha nem kerülhet többe a maximumnál, még akkor sem, ha a használat alapján többe kerülne. A sikertelen vagy megszakított futtatást szokás szerint teljes egészében visszatérítjük.

A legtöbb futtatás jóval kevesebbe kerül a maximumnál; a modelloldal a készítő bemenetéhez és a szokásos futtatáshoz az „Up to $X per run” értéket mutatja („from” a katalógusban). A feldolgozási idő alapján számlázott néhány modellnél a használat a modell feldolgozási ideje (`approximate` jelöléssel).

```json 200 OK · egy metered modell árajánlata
{
  "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"
}
```

A futtatás után a kérés `cost` értéke mutatja a zárolt összeget és a használat szerinti összeget:

```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 } }
}
```

A `charged − refunded` érték a futtatás költsége. A `settled.status` a találat és az elszámolás közötti időre `pending`, abban a ritka esetben pedig, amikor a modell egyáltalán nem jelent használatot, `no_usage` (ilyenkor a maximum marad az ár).

## Árajánlat a futtatás előtt

A `POST https://api.doitong.com/v1/quote/{model_id}` pontosan azt a törzset fogadja, amelyet a `run` végpontra küldene, és visszaadja a bemenet árát: a pontos árat, kivéve a [használat alapján számlázott](#metered) modellt, amelynél azt a maximumot, amibe a futtatás kerülhet. Nem igényel kulcsot, és díjmentes:

```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 · árajánlat
{
  "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": []
}
```

Kulccsal az árajánlat a `balance_credits` és `balance_usd` értékeket (az API-egyenleget), az `affordable` és a `key_budget_remaining` értéket is visszaadja. A `rub` összeghez adja hozzá a `?currency=rub` paramétert.

> [!TIP]
> **Az árajánlat a felszámított díj.** Ugyanaz a függvény számítja ki mindkettőt, ezért egy ilyen bemenettel végzett futtatás pontosan `credits` összegbe kerül.
> Az egyetlen kivétel a [használat alapján számlázott](#metered) modell (`mode: metered`): ennél a `credits` a futtatás lehetséges legmagasabb költsége, amelyet az indításkor levonunk, a fel nem használt részt pedig a futtatás után visszatérítjük.

## Árobjektumok

Az API minden ára azonos felépítésű:

- modellek: `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" }` — Oroszországban vagy `?currency=rub` esetén a `rub`, a `rub_display` és a `from_rub` mezővel kiegészítve;
- kérések: `cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 }` (API-kredit; egy `metered` kéréshez a `mode`, `held`, `typical` és `settled` is hozzáadódik, lásd: [Használat alapján számlázva](#metered));
- fiók: a `GET https://api.doitong.com/v1/account` a `credits` értéket (az API-egyenleget), a `balance: { "credits", "usd" }` és a `storage` értéket (a fájltárhely árát, használatát és havi becslését) adja vissza.

## Visszatérítések

- Az érvénytelen kérésért (bármely `4xx`, mielőtt a futtatás elindulna) soha nem számítunk fel díjat.
- A `failed` állapotban végződő kérést (a `timeout` esetén is) automatikusan teljes egészében visszatérítjük az API-egyenlegre.
- Az indulás előtt megszakított kérést teljes egészében visszatérítjük. Miután a modell generálni kezdett, a megszakítás csak kérés: ha a modell befejezi a munkát, az eredményt kézbesítjük és felszámítjuk a díjat.
- A sikeres `metered` kérés visszakapja a maximum fel nem használt részét.

A kérésobjektum mindezt megjeleníti: `cost.credits`, `cost.charged` és `cost.refunded`.

## Fájltárhely

A kimeneti fájlokat a tárhelyünkön tároljuk. A fiókban vagy futtatásonként választhat (`?storage=`):

| | Megőrzés | Ár |
|---|---|---|
| Örökre (`permanent`, alapértelmezett) | Amíg nem törli őket | 100 API-kredit (0,10 $) GB-onként havonta |
| 7 nap (`temporary`) | 7 nap | Ingyenes |

A végleges tárhely díját naponta egyszer vonjuk le az API-egyenlegből: a tárolt GB × havi ár ÷ a hónap napjainak száma, `storage` típusú főkönyvi sorokként. Az API-kredit tört részeit a következő napra visszük át, ezért egy hónap pontosan GB × 100 API-kreditet tesz ki (1 GB = 1024³ bájt; 10 GB egy hónapos tárolása 1000 API-kredit). Az egyenleg soha nem megy nulla alá: ha nem tud fizetni, arra a napra nem számítunk fel díjat, e-mailt küldünk, és 30 napja van feltölteni az egyenleget, mielőtt a megőrzött fájlok ideiglenessé válnak, majd 7 nappal később törlődnek. Részletek: [Fájlok](https://doitong.com/developers/docs/files#storage).

## Aktuális árak

| Modell | Azonosító | Ár | Ettől |
|---|---|---|---|
| [FLUX.1 \[dev\]](https://doitong.com/developers/models/flux/dev) | `flux/dev` | 0,025 $ / megapixel | 0,025 $ (25 API-jóváírás) |
| [FLUX.1 \[schnell\]](https://doitong.com/developers/models/flux/schnell) | `flux/schnell` | 0,003 $ / megapixel | 0,003 $ (3 API-jóváírás) |
| [FLUX.2 \[dev\]](https://doitong.com/developers/models/flux-2) | `flux-2` | 0,012 $ / megapixel | 0,012 $ (12 API-jóváírás) |
| [FLUX.2 \[pro\]](https://doitong.com/developers/models/flux-2-pro) | `flux-2-pro` | 0,015 $ / kimeneti kép megapixelje | 0,015 $ (15 API-jóváírás) |
| [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` | 0,008 $-tól / kép | 0,008 $ (8 API-jóváírás) |
| [Ideogram V4.5](https://doitong.com/developers/models/ideogram/v4.5) | `ideogram/v4.5` | 0,03 $-tól / kép | 0,03 $ (30 API-jóváírás) |
| [Nano Banana 2](https://doitong.com/developers/models/nano-banana-2) | `nano-banana-2` | 0,06 $-tól / kép | 0,06 $ (60 API-jóváírás) |
| [Nano Banana Pro](https://doitong.com/developers/models/nano-banana-pro) | `nano-banana-pro` | 0,15 $-tól / kép | 0,15 $ (150 API-jóváírás) |
| [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` | 0,04 $-tól / kép | 0,04 $ (40 API-jóváírás) |
| [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 $ / kép | 0,035 $ (35 API-jóváírás) |
| [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` | 0,068 $-tól | 0,068 $ (68 API-jóváírás) |
| [FLUX.1 Kontext \[pro\]](https://doitong.com/developers/models/flux-pro/kontext) | `flux-pro/kontext` | 0,04 $ / kép | 0,04 $ (40 API-jóváírás) |
| [Nano Banana 2 Edit](https://doitong.com/developers/models/nano-banana-2/edit) | `nano-banana-2/edit` | 0,06 $-tól / kép | 0,06 $ (60 API-jóváírás) |
| [Nano Banana Pro Edit](https://doitong.com/developers/models/nano-banana-pro/edit) | `nano-banana-pro/edit` | 0,15 $-tól / kép | 0,15 $ (150 API-jóváírás) |
| [Qwen Image 3 Edit](https://doitong.com/developers/models/alibaba/qwen-image-3/edit) | `alibaba/qwen-image-3/edit` | 0,04 $-tól / kép | 0,04 $ (40 API-jóváírás) |
| [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` | 0,0425 $-tól / kimeneti videómásodperc | 0,043 $ (43 API-jóváírás) |
| [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` | 0,08 $-tól / másodperc | 0,48 $ (480 API-jóváírás) |
| [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` | 0,112 $-tól / másodperc | 0,56 $ (560 API-jóváírás) |
| [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` | 0,12 $-tól / másodperc | 0,72 $ (720 API-jóváírás) |
| [MiniMax H3 Text to Video](https://doitong.com/developers/models/minimax/h3/text-to-video) | `minimax/h3/text-to-video` | 0,05 $-tól / másodperc | 0,25 $ (250 API-jóváírás) |
| [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` | 0,113 $-tól / másodperc | 0,452 $ (452 API-jóváírás) |
| [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` | 0,141 $-tól / másodperc | 0,564 $ (564 API-jóváírás) |
| [Veo 3.1](https://doitong.com/developers/models/veo3.1) | `veo3.1` | 0,20 $-tól / másodperc | 1,60 $ (1600 API-jóváírás) |
| [Veo 3.1 Fast](https://doitong.com/developers/models/veo3.1/fast) | `veo3.1/fast` | 0,10 $-tól / másodperc | 0,80 $ (800 API-jóváírás) |
| [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` | 0,05 $-tól / másodperc | 0,25 $ (250 API-jóváírás) |
| [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` | 0,0425 $-tól / kimeneti videómásodperc | 0,043 $ (43 API-jóváírás) |
| [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` | 0,082 $-tól / másodperc | 0,492 $ (492 API-jóváírás) |
| [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` | 0,112 $-tól / másodperc | 0,56 $ (560 API-jóváírás) |
| [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` | 0,12 $-tól / másodperc | 0,72 $ (720 API-jóváírás) |
| [MiniMax H3 Image to Video](https://doitong.com/developers/models/minimax/h3/image-to-video) | `minimax/h3/image-to-video` | 0,05 $-tól / másodperc | 0,25 $ (250 API-jóváírás) |
| [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` | 0,113 $-tól / másodperc | 0,452 $ (452 API-jóváírás) |
| [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` | 0,141 $-tól / másodperc | 0,564 $ (564 API-jóváírás) |
| [Veo 3.1 Fast Image to Video](https://doitong.com/developers/models/veo3.1/fast/image-to-video) | `veo3.1/fast/image-to-video` | 0,10 $-tól / másodperc | 0,80 $ (800 API-jóváírás) |
| [Veo 3.1 Image to Video](https://doitong.com/developers/models/veo3.1/image-to-video) | `veo3.1/image-to-video` | 0,20 $-tól / másodperc | 1,60 $ (1600 API-jóváírás) |
| [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` | 0,05 $-tól / másodperc | 0,25 $ (250 API-jóváírás) |
| [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` | 0,113 $-tól / másodperc | 0,452 $ (452 API-jóváírás) |
| [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` | 0,141 $-tól / másodperc | 0,564 $ (564 API-jóváírás) |
| [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 $ / bemeneti hangmásodperc | 0,115 $ (115 API-jóváírás) |
| [Sync Lipsync 3](https://doitong.com/developers/models/sync-lipsync/v3) | `sync-lipsync/v3` | 8,00 $ / kimeneti videóperc | 8,00 $ (8000 API-jóváírás) |
| [VEED Fabric 1.0](https://doitong.com/developers/models/veed/fabric-1.0) | `veed/fabric-1.0` | 0,08 $-tól / bemeneti hangmásodperc | 0,08 $ (80 API-jóváírás) |
| [Topaz Image Upscale](https://doitong.com/developers/models/topaz/upscale/image/precision) | `topaz/upscale/image/precision` | 0,08 $ / 24 kimeneti képmegapixel | 0,08 $ (80 API-jóváírás) |
| [Topaz Video Upscale](https://doitong.com/developers/models/topaz/upscale/video/precision) | `topaz/upscale/video/precision` | 0,00667 $-tól / bemeneti videómásodperc | 0,10 $ (100 API-jóváírás) |
| [Bria RMBG 2.0](https://doitong.com/developers/models/bria/background/remove) | `bria/background/remove` | 0,018 $-tól | 0,018 $ (18 API-jóváírás) |
| [Eleven v4 Text to Speech](https://doitong.com/developers/models/elevenlabs/tts/eleven-v4) | `elevenlabs/tts/eleven-v4` | 0,08 $ / 1000 karakter | 0,08 $ (80 API-jóváírás) |
| [MiniMax Speech 2.8 HD](https://doitong.com/developers/models/minimax/speech-2.8-hd) | `minimax/speech-2.8-hd` | 0,10 $ / 1000 karakter | 0,10 $ (100 API-jóváírás) |
| [MiniMax Music 3](https://doitong.com/developers/models/minimax/music-3) | `minimax/music-3` | 0,002 $ / másodperc | 0,12 $ (120 API-jóváírás) |
| [MMAudio V2](https://doitong.com/developers/models/mmaudio-v2) | `mmaudio-v2` | 0,001 $ / másodperc | 0,008 $ (8 API-jóváírás) |

Ezek a kiemelt modellek. Mind a(z) 1496 modell és azok ára megtalálható a [modellkatalógusban](https://doitong.com/developers/models) és a `GET /models` végponton (nem szükséges kulcs).

## Feltöltés

Töltsön fel pénzt az API-egyenlegre itt: [https://doitong.com/developers/dashboard#balance](https://doitong.com/developers/dashboard#balance). Ha az egyenleg túl alacsony, a futtatás `402 insufficient_credits` hibával és `top_up_url` értékkel tér vissza. Minden API-kulcshoz saját, API-kreditben megadott keret is beállítható (lásd: [Hitelesítés](https://doitong.com/developers/docs/authentication#credit-budgets)).
