Máksin

Juohke modealla máksá juste dan maid modealla ráhkadeaddji gáibida das, US-dollariin. Don mávssát iežat API-saldos, masa rehkenastojuvvojit API-kredihtta: 1 000 API-kreditta = 1 $. API-saldo lea iežas saldo, earálágan go Doitong-appaid kredihtta. Plánat, unnimusmearit dahje modeallaid mielde máksut eai leat: gohččun máksá dan hatti, ja dat váldojuvvo API-saldos dalle go jearaldat dohkkehuvvo.

Ruoŧŧas (doitong.ru, api.doitong.ru dahje ?currency=rub) čájehuvvojit hattit maiddái rublain: USD-haddi × USD/RUB-kursa × 1,3.

Ovttadat#

Juohke modeallas lea okta máksinovttadat, mii čájehuvvo dan siiddus ja GET https://api.doitong.ru/v1/models/{model_id}:

Haddi = mearri × API-kredihtta ovttadaga nammii, bajásguvlui meroštallojuvvon olles API-kredihtan (0,001 $), ja ii goassege unnit go 1. Hui hálbi ovttadagain sáhttá leat oassehaddi ovttadaga nammii (0.4 API-kredihtta sekundas); dušše gohččuma oppalaš haddi meroštallo bajásguvlui.

Muhtin modeallat gáibidit iešguđet lágan hatti sisa-addi mielde: jietnavideo máksá eanet go jietnadoaibma haga, 4K máksá eanet go 1K, ja nu ain. Dát njuolggadusat čájehuvvojit juohke modealla siiddus. Paramehter maid don guođát eret rehkenastojuvvo dan standárdan árvun, nu ahte haddi maid oainnát sisa-addái lea haddi maid mávssát.

Dárkilis, meroštallon, árvvoštallon ja geavaheami hattit#

Juohke hattis lea mode:

• exact: haddi meroštallojuvvo iežat sisa-addi vuođul (sekunddat, govat, megapikselat, bustávat, tegat, dahje okta fásta haddi juohke videoa dahje gohččuma nammii).
• measured: haddi čuovvu fiillaid maid sáddet: sisa-addi videoa dahje jiena guhkkodaga, sisa-addi gova sturrodaga, video rámmaáigodaga dahje rámmaid logu. Resolvánta, njálmmálaš synkroniseren, video-videos, transkripšuvdna ja jietnaneavvut máksojuvvojit dán vuogi mielde. Ovdal vuođđudeami API lohká fiilla guhkkodaga, resolušuvnna ja rámmaáigodaga (maiddái haddi árvvoštallan dahká dan), nu ahte árvvoštallan lea juste dan maid vuođđudeapmi máksá. Modealla siidu muitala maid mávssát ("Price per sekunda of your input video") ja dan rehkenastin geavaha iežat fiilla loguid. Fiila masa ii sáhte beassat, hilgojuvvo unmeasurable_input dainna, iige mihkkege mákso.
• estimate: modealla iežas golu sorjá das maid sisa-addi ii sáhte ovddalgihtii muitalit (tokenat, rehkenastináigi). Dakkár modealla máksá fásta árvvoštallojuvvon hatti juohke vuođđudeami nammii (juohke boađusgova nammii go lea govaidlohku), mii lea ásahuvvon dan modealla duohta vuođđudeami gaskamearálaš golu vuođul. Don diehtát ain hatti ovdal vuođđudeami: árvvoštallan lea dat maid mávssát.
• metered: modealla máksojuvvo duohta geavaheami mielde, maid dušše vuođđudeapmi ieš diehtá: tokenat maid gielladahje- dahje oaidnánmodealla lohká ja čállá, jietnámodealla ráhkadan hupmasekunddat, dahje modealla gieđahallanáigi. Geahča dás vuollelis Máksojuvvon geavaheami mielde.

Modealla-siiddut čájehit "Price per run", "Price per sekunda of your input video" (ja sullasaš), "Estimated price per run" dahje "Charged by usage"; GET https://api.doitong.ru/v1/models?mode=measured, ?mode=estimate ja ?mode=metered listet daid.

Máksojuvvon geavaheami mielde#

metered modeallas lea geavaheami haddi ("$0.01 per 1000 tokens", "$0.002 per sekunda of generated audio", "$0.00111 per sekunda of processing time") ja maksimálahaddi juohke vuođđudeami nammii: stuorámus haddi maid vuođđudeapmi sáhttá máksit, dan vuođul maid jearaldat muitala (max_tokens, iežat teavstta guhkkodat, resolušuvdna, boađusaid lohku) ja modealla almmuhuvvon ráddjehusaid. Dat ii goassege sorjá fiilla sisdoalus URL:a duohken. Modeallaide mat máksojuvvojit gieđahallanáiggi dahje jietnasaji guhkkodaga mielde, lea maksimálahaddi guhkimus áigi masa jearaldat sáhttá bistit (15 minuhtta govaide, 30 jietnii, 60 videoi), nu ahte dat lea olu badjel dábálaš vuođđudeami. Sisa-addi masa maksimálahaddi livččii badjel modealla juohke-vuođđudeami ráddjehusa (hui guhkes teaksta), hilgojuvvo 422 invalid_input:

1. Árvvoštallan máhcaha dan maksimálahatti credits-n (hold ja typical lassin, dábálaš vuođđudeapmi). Go vuođđudeapmi álgá, váldojuvvo maksimálahaddi API-saldos, ja dat lea maid saldo ja iežat čoavdda bušeahtta ferte gokčat.
2. Go vuođđudeapmi lihkostuvvá, jearaldat giddestuvvo geavaheapmái maid modealla raportere: geavaheapmi × geavaheami haddi, bajásguvlui meroštallojuvvon olles API-kredihtan. Maksimálahatti báhcán oassi máhcahuvvo automáhtalaččat, okta geardde, refund-rámmažin iežat API-saldos.
3. Vuođđudeapmi ii goassege máksá eanet go maksimálahaddi, vaikko geavaheapmi livččii stuorit. Fillet dahje gaskkalduvvon vuođđudeapmi máhcaheapmi lea olles, nugo dábálaččat.

Eanaš vuođđudeamit mákset olu unnit go maksimálahaddi; modealla siidu čájeha "Up to $X per run" ráhkadeaddji sisa-addái ja dábálaš vuođđudeapmái ("from" katalogas). Moatti modeallaide mat máksojuvvojit gieđahallanáiggi mielde, lea geavaheapmi modealla gieđahallanáigi (mearkkašuvvon approximate).

{
  "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"
}

Vuođđudeami maŋŋá čájeha jearaldaga cost maid váldojuvvui ja man stuoris geavaheapmi lei:

{
  "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 lea dan vuođđudeami haddi. settled.status lea pending áigodagas boađusa ja giddesteami gaskkas, ja no_usage hui hárddus dilis go modealla ii raporteren geavaheami ollenge (dalle báhcá maksimálahaddi hattin).

Árvvoštallan ovdal vuođđudeami#

POST https://api.doitong.ru/v1/quote/{model_id} váldá juste dan lága gieđahallama maid sáddet run-ii ja máhcaha dan sisa-addi hatti: dárkilis hatti, earret modealla máksojuvvon geavaheami mielde, mas dat lea stuorámus haddi maid vuođđudeapmi sáhttá máksit. Dasa ii dárbbaš API-čoavdda ja dat ii máksse maidege:

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

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

Čoavddain máhcaha árvvoštallan maiddái balance_credits ja balance_usd (iežat API-saldo), affordable ja key_budget_remaining. Lasit ?currency=rub oažžun dihte rub meari.

Hatti-objektat#

Juohke hattis API:s lea seamma hápmi:

• 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" } — lassin rub, rub_display ja from_rub Ruoŧŧas dahje ?currency=rub geavahettiin;
• requests: cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 } (API-kredihtta; metered jearaldat lasiha mode, held, typical ja settled, geahča Máksojuvvon geavaheami mielde);
• account: GET https://api.doitong.ru/v1/account máhcaha credits (API-saldo), balance: { "credits", "usd" } ja storage (fiila-vurken haddi, geavaheapmi ja mánotbáhtaid árvvoštallan).

Máhcaheamit#

• Gustohis jearaldat (juohke 4xx ovdal vuođđudeami álggu) ii goassege mákso.
• Jearaldat mii nohká failed (maiddái timeout) máhcaheapmi lea olles API-saldos, automáhtalaččat.
• Jearaldat maid don gaskkalduvvat ovdal dan álgga lea máhcaheapmi olles. Go modealla lea ráhkadeamen, lea gaskkalduhttin dušše jearaldat: jos modealla geargá, boađus sáddejuvvo ja mákso.
• metered jearaldat mii lihkostuvvá oažžu ruovttoluotta dan oasi maksimálahattis maid ii geavahan.

Jearaldat-objekta čájeha dan buot: cost.credits, cost.charged ja cost.refunded.

Fiila-vurken#

Boađusfiillat vurkejuvvojit min vurkkis. Don válljet, kontus dahje juohke vuođđudeamis (?storage=):

Álo-vurken máksojuvvo oktii beaivvis API-saldos: vurkejuvvon GB × mánotbaji haddi ÷ mánotbaji beivviid lohku, storage-šlája ledger-rámmaiguin. API-kredihta oassemearit doalahuvvojit boahtti beaivái, nu ahte mánotbadji oktiibuot lea juste GB × 100 API-kredihtta (1 GB = 1024³ bytes; 10 GB vurkejuvvon mánotbajis máksá 1 000 API-kredihtta). Saldo ii goassege man vuollelis nolla: go ii sáhte máksit, dan beaivvi ii mákso, don oaččut e-boasta ja dus leat 30 beaivvi lasáhusa dahje 7 beivvi maŋŋá fiillat šaddet gaskaboddosaččat ja sihkkojuvvojit. Lassedieđut: Fiillat.

Dálá hattit#

Dát leat válljejuvvon modeallat. Buot 1 496 modealla ja daid haddit gávdnojit modeallakataloga ja GET /models (čoavdda ii dárbbaš).

Lasáhus#

Lasit ruđa API-saldoi dáppe: https://doitong.ru/developers/dashboard#balance. Go saldo lea menddo vuollegis, vuođđudeapmi vástida 402 insufficient_credits dainna top_up_url. Juohke API-čoavdda sáhttá maiddái ráddjejuvvot iežas bušeahtain API-kredihtain (geahča Autentiseren).