Saltar al cuntegna
Guida API

Prets

Mussar sco Markdown Actualisà

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.ru/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 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.ru/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).

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.ru/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, nua ch'el è il maximum che l'execuziun po custar. El na dovra nagina clav e custa nagut:

terminal
curl -X POST "https://api.doitong.ru/v1/quote/flux/schnell" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A lighthouse at dusk", "num_images": 2}'
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.

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);
  • conto: GET https://api.doitong.ru/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.

Pretschs actuals

Model ID Pretsch Da
FLUX.1 [dev] flux/dev $0,025 / megapixel $0,025 (25 credits API)
FLUX.1 [schnell] flux/schnell $0,003 / megapixel $0,003 (3 credits API)
FLUX.2 [dev] flux-2 $0,012 / megapixel $0,012 (12 credits API)
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 openai/gpt-image-2.5/flare/text-to-image a partir da $0,008 / maletg $0,008 (8 credits API)
Ideogram V4.5 ideogram/v4.5 a partir da $0,03 / maletg $0,03 (30 credits API)
Nano Banana 2 nano-banana-2 a partir da $0,06 / maletg $0,06 (60 credits API)
Nano Banana Pro nano-banana-pro a partir da $0,15 / maletg $0,15 (150 credits API)
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 recraft/v4.1/text-to-image $0,035 / maletg $0,035 (35 credits API)
Seedream 5.0 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] flux-pro/kontext $0,04 / maletg $0,04 (40 credits API)
Nano Banana 2 Edit nano-banana-2/edit a partir da $0,06 / maletg $0,06 (60 credits API)
Nano Banana Pro Edit nano-banana-pro/edit a partir da $0,15 / maletg $0,15 (150 credits API)
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 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 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 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 lightricks/ltx-2.5/text-to-video/pro a partir da $0,12 / secunda $0,72 (720 credits API)
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 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 bytedance/seedance-2.0/text-to-video a partir da $0,141 / secunda $0,564 (564 credits API)
Veo 3.1 veo3.1 a partir da $0,20 / secunda $1,60 (1 600 credits API)
Veo 3.1 Fast veo3.1/fast a partir da $0,10 / secunda $0,80 (800 credits API)
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 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 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 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 lightricks/ltx-2.5/image-to-video/pro a partir da $0,12 / secunda $0,72 (720 credits API)
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 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 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 veo3.1/fast/image-to-video a partir da $0,10 / secunda $0,80 (800 credits API)
Veo 3.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 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 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 bytedance/seedance-2.0/reference-to-video a partir da $0,141 / secunda $0,564 (564 credits API)
Kling AI Avatar 2.0 Pro kling-video/ai-avatar/v2/pro $0,115 / secunda d'audio d'input $0,115 (115 credits API)
Sync Lipsync 3 sync-lipsync/v3 $8,00 / minuta da video d'output $8,00 (8 000 credits API)
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 topaz/upscale/image/precision $0,08 / 24 megapixels da maletg d'output $0,08 (80 credits API)
Topaz Video Upscale topaz/upscale/video/precision a partir da $0,00667 / secunda da video d'input $0,10 (100 credits API)
Bria RMBG 2.0 bria/background/remove a partir da $0,018 $0,018 (18 credits API)
Eleven v4 Text to Speech elevenlabs/tts/eleven-v4 $0,08 / 1000 caracteristicas $0,08 (80 credits API)
MiniMax Speech 2.8 HD minimax/speech-2.8-hd $0,10 / 1000 caracteristicas $0,10 (100 credits API)
MiniMax Music 3 minimax/music-3 $0,002 / secunda $0,12 (120 credits API)
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 ed en GET /models (nagina clav necessaria).

Far ina chargiada

Agiunta daners al saldo API tar https://doitong.ru/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).