# Pretschs

Mintga model custa exactamain quai che ses producent addebitescha, en dollars americans. Ti pajais dal tes **saldo API**, che vegn quintà en **credits API**: **1 000 credits API = $1**. Il saldo API è in saldo separat, independent dals credits da las apps Doitong. I na dat nagins plans, nagins minimums e naginas taxas per model: ina clamada custa ses pretsch, deducì dal saldo API cura che la dumonda vegn acceptada.

En Russia (doitong.ru, api.doitong.ru u `?currency=rub`) vegnan ils pretschs mussads er en rubels: il pretsch USD × il curs USD/RUB × 1,3.

## Units

Mintga model ha ina unitad da facturaziun, mussada sin sia pagina e en `GET https://api.doitong.com/v1/models/{model_id}`:

| Unitad | Quantitad |
|---|---|
| `second` | Secundas da video u audio d'output (`duration`) |
| `image` | Maletgs generads (`num_images`) |
| `megapixel` | Ladezza × autezza da l'output, en megapixels (1 MP = 1024 × 1024 pixels) |
| `video` | In video generà |
| `request` | Ina clamada |
| `1000_characters` | Caracteras dal text d'input, per 1000 |
| `step` | Pass da trenament |

Pretsch = quantitad × credits API per unitad, arrundà ensi ad in credit API entir ($0,001), mai damain che 1. Units fitg bunmartgadas pon avair in pretsch parzial per unitad (`0.4` credits API per secunda); mo il total d'ina clamada vegn arrundà.

Intgins models addebiteschan ina tariffa differenta tenor l'input: video cun tun custa dapli che senza, 4K dapli che 1K, e.u.v. Questas **reglas** èn enumeradas sin mintga pagina da model. In parameter che ti ometta val sco sia valur standard, uschia che il pretsch mussà per in input è il pretsch che ti pajas.

## Pretschs exacts, mesurads, stimads e tenor utilisaziun

Mintga pretsch ha in `mode`:

- `exact`: il pretsch vegn calculà da tes input (secundas, maletgs, megapixels, caracteras, pass, u in pretsch fix per video u clamada).
- `measured`: il pretsch suonda las datotecas che ti tramettas: la durada d'in video u audio d'input, la grondezza d'in maletg d'input, la frequenza da frames u il dumber da frames d'in video. Upscaler, lip sync, video-to-video, transcripziun ed utensils audio vegnan tarifads uschia. Avant l'execuziun legia l'API la durada, la resoluziun e la frequenza da frames da la datoteca (la citaziun fa il medem), perquai che la citaziun è exactamain quai che l'execuziun addebitescha. La pagina dal model inditgescha per tge che ti pajas ("Pretsch per secunda da tes video d'input") e ses calculatur utilisescha las cifras da tia datoteca. Ina datoteca che na po betg vegnir legida vegn refusada cun `unmeasurable_input` e nagut na vegn addebità.
- `estimate`: il cust dal model dependa d'ina chaussa che l'input na po betg dir ordavant (tokens, temp da calculaziun). In tal model addebitescha in **pretsch stimà fix per execuziun** (per maletg d'output, sch'el ha in dumber da maletgs), fixà tenor il cust mediu d'execuziuns realas da quel model. Ti sas tuttina il pretsch avant l'execuziun: la citaziun è quai che ti pajas.
- `metered`: il model vegn **facturà tenor l'utilisaziun reala**, che mo l'execuziun enconuscha: ils tokens che in model da lingua u visiun legia e scriva, las secundas da discurs che in model da vusch generescha, u il temp da processament dal model. Vesa [Facturà tenor utilisaziun](#metered) sutvart.

Las paginas dals models diclan "Pretsch per execuziun", "Pretsch per secunda da tes video d'input" (e sumegliant), "Pretsch stimà per execuziun" u "Facturà tenor utilisaziun"; `GET https://api.doitong.com/v1/models?mode=measured`, `?mode=estimate` e `?mode=metered` als enumereschan.

## Facturà tenor utilisaziun

In model `metered` ha in pretsch d'utilisaziun ("$0.01 per 1000 tokens", "$0.002 per secunda d'audio generà", "$0.00111 per secunda da temp da processament") ed in **maximum per execuziun**: il pli grond cust pussaivel, tenor quai che tia dumonda inditgescha (`max_tokens`, la lunghezza da tes text, la resoluziun, il dumber d'outputs) e las limitas publitgadas dal model. El na dependa mai dal cuntegn da ina datoteca davos ina URL. Per in model facturà tenor temp da processament u lunghezza d'ina sessiun da vusch, il maximum è la pli lunga durada permissibla (15 minutas per maletgs, 30 per audio, 60 per video), pia bler sur d'ina execuziun tipica. In input cun in maximum sur la limita dal model per execuziun (in text fitg lung) vegn refusà cun `422 invalid_input`:

1. La citaziun returna quest maximum sco `credits` (cun `hold` e `typical`, ina execuziun usitada). Cura che l'execuziun cumenza, il maximum vegn deducì dal saldo API, ed el è quai che il saldo e tes budget da clav ston cuvrir.
2. Cura che l'execuziun reussescha, la dumonda vegn reglada tenor l'utilisaziun rapportada dal model: utilisaziun × pretsch d'utilisaziun, arrundà ensi ad in credit API entir. **Il rest dal maximum vegn restituì automaticamain**, ina giada, sco lingia `refund` dal tes saldo API.
3. Ina execuziun na custa mai dapli che ses maximum, er sch'ella avess dapli utilisaziun. Ina execuziun fallada u annullada vegn restituida cumplettamain, sco adina.

La gronda part da las execuziuns custa bler damain che il maximum; la pagina dal model mussa "Fin a $X per execuziun" per l'input dal builder e l'execuziun tipica ("da" en il catalog). Per ils paucs models facturads tenor temp da processament è l'utilisaziun il temp da processament dal model (marcà `approximate`).

```json 200 OK · citaziun d'in model 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"
}
```

Suenter l'execuziun mussa `cost` da la dumonda quai ch'è vegnì tegnì e quai che l'utilisaziun ha custà:

```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` è il cust da l'execuziun. `settled.status` è `pending` per il mument tranter il resultat e la reglaziun, e `no_usage` en il cas rar che il model n'ha rapportà nagina utilisaziun (lura resta il maximum il pretsch).

## Citaziun avant l'execuziun

`POST https://api.doitong.com/v1/quote/{model_id}` accepta exactamain il corp che ti tramettessas a `run` e returna il pretsch da quest input: il pretsch exact, exceptà per in model [facturà tenor utilisaziun](#metered), nua ch'el è il maximum che l'execuziun po custar. El na dovra nagina clav e custa nagut:

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

Cun ina clav returna la citaziun er `balance_credits` e `balance_usd` (tes saldo API), `affordable` e `key_budget_remaining`. Agiunta `?currency=rub` per ina quantitad en `rub`.

> [!TIP]
> **La citaziun è la debitaziun.** La medema funcziun calculescha omadus, uschia che ina execuziun cun quest input custa exactamain `credits`.
> L'unica excepziun è in model [facturà tenor utilisaziun](#metered) (`mode: metered`): là è `credits` il maximum che l'execuziun po custar, deducì al cumenzament, e la part betg utilisada vegn restituida suenter l'execuziun.

## Objects da pretsch

Mintga pretsch en l'API ha la medema furma:

- 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" }` — ultra da quai `rub`, `rub_display` e `from_rub` en Russia u cun `?currency=rub`;
- dumondas: `cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 }` (credits API; ina dumonda `metered` agiunta `mode`, `held`, `typical` e `settled`, vesa [Facturà tenor utilisaziun](#metered));
- conto: `GET https://api.doitong.com/v1/account` returna `credits` (il saldo API), `balance: { "credits", "usd" }` e `storage` (pretsch, utilisaziun e stimaziun mensila da memorisaziun da datotecas).

## Restituziuns

- Ina dumonda invalida (mintga `4xx` avant il cumenzament da l'execuziun) na vegn mai addebitada.
- Ina dumonda che finescha `failed` (incl. `timeout`) vegn restituida cumplettamain al saldo API, automaticamain.
- Ina dumonda che ti annullas avant ch'ella cumenza vegn restituida cumplettamain. Cura che il model generescha, è in'annullaziun mo ina dumonda: sche il model finescha, il resultat vegn furnì e facturà.
- Ina dumonda `metered` che reussescha survegn enavos la part dal maximum ch'ella n'ha betg utilisà.

L'object da la dumonda mussa tut: `cost.credits`, `cost.charged` e `cost.refunded`.

## Memorisaziun da datotecas

Las datotecas d'output vegnan tegnidas en nossa memorisaziun. Ti tschernas, en il conto u per execuziun (`?storage=`):

| | Tegnì | Pretsch |
|---|---|---|
| Per adina (`permanent`, standard) | Fin che ti las stizzas | 100 credits API ($0,10) per GB per mais |
| 7 dis (`temporary`) | 7 dis | Gratuit |

La memorisaziun permanenta vegn addebitada ina giada per di dal saldo API: GB tegnids × il pretsch mensil ÷ dis dal mais, sco lingias da ledger dal gener `storage`. Fracziuns d'in credit API vegnan transferidas al proxim di, uschia ch'in mais resulta exactamain en GB × 100 credits API (1 GB = 1024³ bytes; 10 GB tegnids per in mais custan 1 000 credits API). Il saldo na va mai sut zero: cura ch'el na po betg pajar, quel di na vegn nagut addebità, ti survegns in e-mail, e ti has 30 dis per far ina chargiada avant che las datotecas tegnidas daventan temporaras e vegnan stizzadas 7 dis pli tard. Detagls: [Datotecas](https://doitong.com/developers/docs/files#storage).

## Pretschs actuals

| Model | ID | Pretsch | Da |
|---|---|---|---|
| [FLUX.1 \[dev\]](https://doitong.com/developers/models/flux/dev) | `flux/dev` | $0,025 / megapixel | $0,025 (25 credits API) |
| [FLUX.1 \[schnell\]](https://doitong.com/developers/models/flux/schnell) | `flux/schnell` | $0,003 / megapixel | $0,003 (3 credits API) |
| [FLUX.2 \[dev\]](https://doitong.com/developers/models/flux-2) | `flux-2` | $0,012 / megapixel | $0,012 (12 credits API) |
| [FLUX.2 \[pro\]](https://doitong.com/developers/models/flux-2-pro) | `flux-2-pro` | $0,015 / megapixel da maletg d'output | $0,015 (15 credits 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` | a partir da $0,008 / maletg | $0,008 (8 credits API) |
| [Ideogram V4.5](https://doitong.com/developers/models/ideogram/v4.5) | `ideogram/v4.5` | a partir da $0,03 / maletg | $0,03 (30 credits API) |
| [Nano Banana 2](https://doitong.com/developers/models/nano-banana-2) | `nano-banana-2` | a partir da $0,06 / maletg | $0,06 (60 credits API) |
| [Nano Banana Pro](https://doitong.com/developers/models/nano-banana-pro) | `nano-banana-pro` | a partir da $0,15 / maletg | $0,15 (150 credits 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` | a partir da $0,04 / maletg | $0,04 (40 credits 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 / maletg | $0,035 (35 credits 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` | a partir da $0,068 | $0,068 (68 credits API) |
| [FLUX.1 Kontext \[pro\]](https://doitong.com/developers/models/flux-pro/kontext) | `flux-pro/kontext` | $0,04 / maletg | $0,04 (40 credits API) |
| [Nano Banana 2 Edit](https://doitong.com/developers/models/nano-banana-2/edit) | `nano-banana-2/edit` | a partir da $0,06 / maletg | $0,06 (60 credits API) |
| [Nano Banana Pro Edit](https://doitong.com/developers/models/nano-banana-pro/edit) | `nano-banana-pro/edit` | a partir da $0,15 / maletg | $0,15 (150 credits API) |
| [Qwen Image 3 Edit](https://doitong.com/developers/models/alibaba/qwen-image-3/edit) | `alibaba/qwen-image-3/edit` | a partir da $0,04 / maletg | $0,04 (40 credits 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` | a partir da $0,0425 / secunda da video d'output | $0,043 (43 credits 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` | a partir da $0,08 / secunda | $0,48 (480 credits 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` | a partir da $0,112 / secunda | $0,56 (560 credits 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` | a partir da $0,12 / secunda | $0,72 (720 credits API) |
| [MiniMax H3 Text to Video](https://doitong.com/developers/models/minimax/h3/text-to-video) | `minimax/h3/text-to-video` | a partir da $0,05 / secunda | $0,25 (250 credits 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` | a partir da $0,113 / secunda | $0,452 (452 credits 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` | a partir da $0,141 / secunda | $0,564 (564 credits API) |
| [Veo 3.1](https://doitong.com/developers/models/veo3.1) | `veo3.1` | a partir da $0,20 / secunda | $1,60 (1 600 credits API) |
| [Veo 3.1 Fast](https://doitong.com/developers/models/veo3.1/fast) | `veo3.1/fast` | a partir da $0,10 / secunda | $0,80 (800 credits 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` | a partir da $0,05 / secunda | $0,25 (250 credits 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` | a partir da $0,0425 / secunda da video d'output | $0,043 (43 credits 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` | a partir da $0,082 / secunda | $0,492 (492 credits 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` | a partir da $0,112 / secunda | $0,56 (560 credits 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` | a partir da $0,12 / secunda | $0,72 (720 credits API) |
| [MiniMax H3 Image to Video](https://doitong.com/developers/models/minimax/h3/image-to-video) | `minimax/h3/image-to-video` | a partir da $0,05 / secunda | $0,25 (250 credits 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` | a partir da $0,113 / secunda | $0,452 (452 credits 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` | a partir da $0,141 / secunda | $0,564 (564 credits 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` | a partir da $0,10 / secunda | $0,80 (800 credits API) |
| [Veo 3.1 Image to Video](https://doitong.com/developers/models/veo3.1/image-to-video) | `veo3.1/image-to-video` | a partir da $0,20 / secunda | $1,60 (1 600 credits 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` | a partir da $0,05 / secunda | $0,25 (250 credits 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` | a partir da $0,113 / secunda | $0,452 (452 credits 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` | a partir da $0,141 / secunda | $0,564 (564 credits 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 / secunda d'audio d'input | $0,115 (115 credits API) |
| [Sync Lipsync 3](https://doitong.com/developers/models/sync-lipsync/v3) | `sync-lipsync/v3` | $8,00 / minuta da video d'output | $8,00 (8 000 credits API) |
| [VEED Fabric 1.0](https://doitong.com/developers/models/veed/fabric-1.0) | `veed/fabric-1.0` | a partir da $0,08 / secunda d'audio d'input | $0,08 (80 credits API) |
| [Topaz Image Upscale](https://doitong.com/developers/models/topaz/upscale/image/precision) | `topaz/upscale/image/precision` | $0,08 / 24 megapixels da maletg d'output | $0,08 (80 credits API) |
| [Topaz Video Upscale](https://doitong.com/developers/models/topaz/upscale/video/precision) | `topaz/upscale/video/precision` | a partir da $0,00667 / secunda da video d'input | $0,10 (100 credits API) |
| [Bria RMBG 2.0](https://doitong.com/developers/models/bria/background/remove) | `bria/background/remove` | a partir da $0,018 | $0,018 (18 credits API) |
| [Eleven v4 Text to Speech](https://doitong.com/developers/models/elevenlabs/tts/eleven-v4) | `elevenlabs/tts/eleven-v4` | $0,08 / 1000 caracteristicas | $0,08 (80 credits API) |
| [MiniMax Speech 2.8 HD](https://doitong.com/developers/models/minimax/speech-2.8-hd) | `minimax/speech-2.8-hd` | $0,10 / 1000 caracteristicas | $0,10 (100 credits API) |
| [MiniMax Music 3](https://doitong.com/developers/models/minimax/music-3) | `minimax/music-3` | $0,002 / secunda | $0,12 (120 credits API) |
| [MMAudio V2](https://doitong.com/developers/models/mmaudio-v2) | `mmaudio-v2` | $0,001 / secunda | $0,008 (8 credits API) |

Quests èn ils models recumandads. Tut 1 496 models e lur pretschs èn en il [catalog da models](https://doitong.com/developers/models) ed en `GET /models` (nagina clav necessaria).

## Far ina chargiada

Agiunta daners al saldo API tar [https://doitong.com/developers/dashboard#balance](https://doitong.com/developers/dashboard#balance). Cura che il saldo è memia bass, ina execuziun respunda cun `402 insufficient_credits` e cun in `top_up_url`. Mintga clav API po er vegnir limitada cun ses agen budget en credits API (vesa [Autentificaziun](https://doitong.com/developers/docs/authentication#credit-budgets)).