Praghsáil

Cosnaíonn gach samhail go díreach an méid a ghearrann déantóir na samhla uirthi, i ndollair SAM. Íocann tú as d’iarmhéid API, a áirítear i gcreidmheasanna API: 1,000 gcreidmheas API = $1. Is iarmhéid ar leith é iarmhéid API, scartha ó chreidmheasanna aipeanna Doitong. Níl aon phleananna, íosmhéideanna ná táillí in aghaidh na samhla ann: cosnaíonn glao a phraghas, agus baintear den iarmhéid API é nuair a ghlactar leis an iarratas.

Sa Rúis (doitong.ru, api.doitong.ru, nó ?currency=rub) taispeántar praghsanna i rúbal freisin: praghas USD × ráta USD/RUB × 1.3.

Aonaid#

Tá aonad billeála amháin ag gach samhail, a thaispeántar ar a leathanach agus in GET https://api.doitong.ru/v1/models/{model_id}:

Praghas = cainníocht × creidmheasanna API in aghaidh an aonaid, slánaithe suas go dtí creidmheas API iomlán ($0.001), agus 1 ar a laghad. Is féidir praghas codánach in aghaidh an aonaid a bheith ag aonaid an-saora (0.4 creidmheas API in aghaidh an tsoicind); ní shlánaítear ach iomlán an ghlao.

Gearrann roinnt samhlacha ráta éagsúil ag brath ar an ionchur: cosnaíonn físeán le fuaim níos mó ná físeán gan fuaim, cosnaíonn 4K níos mó ná 1K, agus mar sin de. Liostaítear na rialacha seo ar leathanach gach samhla. Áirítear paraiméadar a fhágann tú ar lár mar a luach réamhshocraithe, mar sin is é an praghas a fheiceann tú d’ionchur an praghas a íocann tú.

Praghsanna beacht, tomhaiste, measta agus bunaithe ar úsáid#

Tá mode ag gach praghas:

• exact: ríomhtar an praghas ó d’ionchur (soicind, íomhánna, meigiphicteilíní, carachtair, céimeanna, nó praghas cothrom amháin in aghaidh an fhíseáin nó an ghlao).
• measured: leanann an praghas na comhaid a sheolann tú: fad físeáin nó fuaime ionchuir, méid íomhá ionchuir, ráta fráma nó comhaireamh frámaí físeáin. Praghsáiltear uirlisí uas-scálaithe, sioncronaithe liopaí, físeáin-go-físeán, tras-scríobh agus fuaime ar an mbealach seo. Roimh an rith léann an API fad, taifeach agus ráta fráma an chomhaid (déanann an luachan amhlaidh freisin), mar sin is é an luachan go díreach an méid a ghearrtar ar an rith. Deir leathanach na samhla cad a íocann tú as ("Praghas in aghaidh an tsoicind de d’fhíseán ionchuir") agus úsáideann a áireamhán uimhreacha do chomhaid. Diúltaítear do chomhad nach féidir a léamh le unmeasurable_input agus ní ghearrtar aon táille.
• estimate: braitheann costas na samhla ar rud nach féidir leis an ionchur a insint roimh ré (tócain, am ríofa). Gearrann samhail den sórt sin praghas seasta measta in aghaidh an rith (in aghaidh na híomhá aschuir nuair a bhíonn comhaireamh íomhánna aici), socraithe ó mheánchostas ritheanna iarbhír na samhla sin. Bíonn an praghas ar eolas agat fós roimh an rith: is é an luachan an méid a íocann tú.
• metered: gearrtar táille ar an tsamhail de réir na húsáide iarbhír, rud nach mbíonn ar eolas ach ag an rith féin: na tócain a léann agus a scríobhann samhail teanga nó físe, na soicindí cainte a ghineann samhail ghutha, nó am próiseála na samhla. Féach Gearrtar táille de réir úsáide thíos.

Deir leathanaigh na samhlacha "Praghas in aghaidh an rith", "Praghas in aghaidh an tsoicind de d’fhíseán ionchuir" (agus a leithéid), "Praghas measta in aghaidh an rith" nó "Gearrtar táille de réir úsáide"; liostaíonn GET https://api.doitong.ru/v1/models?mode=measured, ?mode=estimate agus ?mode=metered iad.

Gearrtar táille de réir úsáide#

Tá praghas úsáide ag samhail metered ("$0.01 in aghaidh 1000 tócain", "$0.002 in aghaidh an tsoicind d’fhuaim ghinte", "$0.00111 in aghaidh an tsoicind d’am próiseála") agus uasmhéid in aghaidh an rith: an méid is mó a d’fhéadfadh an rith costas, bunaithe ar an méid a deir d’iarratas (max_tokens, fad do théacs, an taifeach, líon na n-aschur) agus teorainneacha foilsithe na samhla. Ní bhraitheann sé riamh ar ábhar comhaid taobh thiar de URL. I gcás samhla a bhilleáiltear de réir am próiseála nó fad seisiúin ghutha, is é an t-uasmhéid an tréimhse is faide a fhéadfaidh iarratas rith (15 nóiméad le haghaidh íomhánna, 30 le haghaidh fuaime, 60 le haghaidh físeáin), mar sin bíonn sé i bhfad os cionn gnáth-rith. Diúltaítear d’ionchur a mbeadh a uasmhéid os cionn theorainn in aghaidh an rith na samhla (téacs an-fhada) le 422 invalid_input:

1. Tugann an luachan an t-uasmhéid sin ar ais mar credits (le hold agus typical, gnáth-rith). Nuair a thosaíonn an rith, baintear an t-uasmhéid den iarmhéid API, agus caithfidh an t-iarmhéid agus buiséad d’eochrach é a chlúdach.
2. Nuair a éiríonn leis an rith, socraítear an t-iarratas de réir na húsáide a thuairiscíonn an tsamhail dó: úsáid × praghas na húsáide, slánaithe suas go dtí creidmheas API iomlán. Faightear aisíocaíocht uathoibríoch ar an gcuid eile den uasmhéid, uair amháin, mar ró refund d’iarmhéid API.
3. Ní chosnaíonn rith níos mó ná a uasmhéid riamh, fiú dá mbeadh a úsáid níos mó. Faigheann rith ar theip air nó a cuireadh ar ceal aisíocaíocht iomlán, mar is gnách.

Cosnaíonn formhór na ritheanna i bhfad níos lú ná an t-uasmhéid; taispeánann leathanach na samhla "Suas le $X in aghaidh an rith" d’ionchur an chruthaitheora agus an gnáth-rith ("ó" sa chatalóg). Maidir leis an mbeagán samhlacha a bhilleáiltear de réir am próiseála, is é úsáid am próiseála na samhla (marcáilte 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"
}

Tar éis an rith, taispeánann cost an iarratais an méid a coinníodh agus an méid úsáide:

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

Is é charged − refunded costas an rith. Is é settled.status pending don nóiméad idir an toradh agus an socrú, agus no_usage sa chás annamh nach dtuairiscíonn an tsamhail aon úsáid ar chor ar bith (ansin seasann an t-uasmhéid mar an praghas).

Luaigh roimh an rith#

Glacann POST https://api.doitong.ru/v1/quote/{model_id} go díreach leis an gcorp a sheolfá chuig run agus tugann sé praghas an ionchuir sin ar ais: an praghas beacht, seachas i gcás samhla a ghearrann de réir úsáide, áit arb é an t-uasmhéid a d’fhéadfadh an rith costas. Níl eochair de dhíth air agus ní chosnaíonn sé tada:

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

Le heochair, tugann an luachan balance_credits agus balance_usd (d’iarmhéid API), affordable agus key_budget_remaining ar ais freisin. Cuir ?currency=rub leis le haghaidh méid rub.

Oibiachtaí praghais#

Tá an cruth céanna ar gach praghas san API:

• samhlacha: 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" } — móide rub, rub_display agus from_rub sa Rúis nó le ?currency=rub;
• iarratais: cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 } (creidmheasanna API; cuireann iarratas metered mode, held, typical agus settled leis, féach Gearrtar táille de réir úsáide);
• cuntas: tugann GET https://api.doitong.ru/v1/account credits (iarmhéid API), balance: { "credits", "usd" } agus storage (praghas stórála comhad, úsáid agus meastachán míosúil) ar ais.

Aisíocaíochtaí#

• Ní ghearrtar táille riamh ar iarratas neamhbhailí (aon 4xx sula dtosaíonn an rith).
• Faigheann iarratas a chríochnaíonn failed (lena n-áirítear timeout) aisíocaíocht iomlán go huathoibríoch chuig an iarmhéid API.
• Faigheann iarratas a chealaíonn tú sula dtosaíonn sé aisíocaíocht iomlán. Nuair a bhíonn an tsamhail ag giniúint, níl i gcealú ach iarratas: má chríochnaíonn an tsamhail, seachadtar agus gearrtar táille ar an toradh.
• Faigheann iarratas metered a n-éiríonn leis an chuid dá uasmhéid nár úsáideadh ar ais.

Taispeánann oibiacht an iarratais gach rud: cost.credits, cost.charged agus cost.refunded.

Stóráil comhad#

Coinnítear comhaid aschuir ar ár stóráil. Roghnaíonn tú, sa chuntas nó in aghaidh an rith (?storage=):

Gearrtar táille ar stóráil bhuan uair sa lá ón iarmhéid API: GB coinnithe × an praghas míosúil ÷ líon na laethanta sa mhí, mar rónna mórleabhair de chineál storage. Tugtar codáin de chreidmheas API ar aghaidh go dtí an lá dár gcionn, mar sin suimíonn mí go díreach le GB × 100 creidmheasanna API (1 GB = 1024³ beart; cosnaíonn 10 GB coinnithe ar feadh míosa 1,000 creidmheasanna API). Ní théann an t-iarmhéid faoi bhun nialais riamh: nuair nach féidir leis íoc, ní ghearrtar táille an lá sin, faigheann tú ríomhphost, agus bíonn 30 lá agat le breisiú a dhéanamh sula n-éiríonn na comhaid choinnithe sealadach agus sula scriostar iad 7 lá ina dhiaidh sin. Sonraí: Comhaid.

Praghsanna reatha#

Seo iad na samhlacha atá faoi chaibidil. Tá gach 1,496 múnla agus a bpraghsanna sa chatalóg samhlacha agus in GET /models (níl eochair ag teastáil).

Breisiú#

Cuir airgead leis an iarmhéid API ag https://doitong.ru/developers/dashboard#balance. Nuair a bhíonn an t-iarmhéid ró-íseal, freagraíonn rith le 402 insufficient_credits agus top_up_url. Is féidir buiséad dá chuid féin i gcreidmheasanna API a chur ar gach eochair API freisin (féach Fíordheimhniú).