Bei

Kila modeli inagharimu exactly kiasi anachotoza mtengenezaji wa modeli hiyo, kwa dola za Marekani. Unalipa kutoka kwenye salio lako la API, ambalo huhesabiwa kwa krediti za API: salio za API 1,000 = $ 1. Salio la API ni salio lake lenyewe, tofauti na krediti za programu za Doitong. Hakuna mipango, kiwango cha chini au ada kwa kila modeli: ombi hugharimu bei yake, inayokatwa kutoka kwenye salio la API ombi linapokubaliwa.

Nchini Urusi (doitong.ru, api.doitong.ru, au ?currency=rub) bei pia huonyeshwa kwa ruble: bei ya USD × kiwango cha USD/RUB × 1.3.

Vipimo#

Kila modeli ina kipimo kimoja cha utozaji, kinachoonyeshwa kwenye ukurasa wake na katika GET https://api.doitong.com/v1/models/{model_id}:

Bei = kiasi × krediti za API kwa kila kipimo, ikizungushwa juu hadi krediti nzima ya API ($ 0.001), na kamwe si chini ya 1. Vipimo vya bei ya chini sana vinaweza kuwa na bei ya sehemu kwa kila kipimo (0.4 krediti za API kwa sekunde); jumla ya ombi pekee ndiyo huzungushwa.

Baadhi ya modeli hutoza kiwango tofauti kulingana na ingizo: video yenye sauti hugharimu zaidi kuliko isiyo na sauti, 4K hugharimu zaidi kuliko 1K, na kadhalika. Sheria hizi zimeorodheshwa kwenye ukurasa wa kila modeli. Kigezo unachoacha nje huhesabiwa kuwa thamani yake ya chaguomsingi, kwa hiyo bei unayoona ya ingizo ndiyo bei unayolipa.

Bei kamili, iliyopimwa, iliyokadiriwa na ya matumizi#

Kila bei ina mode:

• exact: bei huhesabiwa kutokana na ingizo lako (sekunde, picha, megapikseli, herufi, hatua, au bei moja ya kudumu kwa kila video au ombi).
• measured: bei hufuata faili unazotuma: urefu wa video au sauti ya ingizo, ukubwa wa picha ya ingizo, kasi ya fremu au idadi ya fremu ya video. Zana za kuongeza mwonekano, ulandanishi wa midomo, video-kwa-video, unukuzi na zana za sauti huwekewa bei kwa njia hii. Kabla ya kuendesha, API husoma urefu wa faili, mwonekano na kasi ya fremu (nukuu hufanya vivyo hivyo), kwa hiyo nukuu ndiyo hasa utakayotozwa. Ukurasa wa modeli unasema unalipia nini ("Bei kwa sekunde ya video yako ya ingizo") na kikokotoo chake hutumia nambari za faili lako. Faili lisiloweza kusomwa hukataliwa kwa unmeasurable_input na hakuna kinachotozwa.
• estimate: gharama ya modeli yenyewe hutegemea kitu ambacho ingizo haliwezi kuonyesha mapema (tokeni, muda wa uchakataji). Modeli kama hiyo hutoza bei iliyokadiriwa kwa kila uendeshaji (kwa kila picha ya tokeo ikiwa ina idadi ya picha), iliyowekwa kutokana na wastani wa gharama za uendeshaji halisi wa modeli hiyo. Bado unajua bei kabla ya kuendesha: nukuu ndiyo unayolipa.
• metered: modeli hutozwa kulingana na matumizi halisi, ambayo inajulikana na uendeshaji wenyewe pekee: tokeni ambazo modeli ya lugha au maono husoma na kuandika, sekunde za usemi ambazo modeli ya sauti huzalisha, au muda wa uchakataji wa modeli. Tazama Hutozwa kulingana na matumizi hapa chini.

Kurasa za modeli husema "Bei kwa kila uendeshaji", "Bei kwa sekunde ya video yako ya ingizo" (na zinazofanana), "Bei iliyokadiriwa kwa kila uendeshaji" au "Hutozwa kulingana na matumizi"; GET https://api.doitong.com/v1/models?mode=measured, ?mode=estimate na ?mode=metered huziorodhesha.

Hutozwa kulingana na matumizi#

Modeli ya metered ina bei ya matumizi ("$0.01 kwa tokeni 1000", "$0.002 kwa sekunde ya sauti iliyozalishwa", "$0.00111 kwa sekunde ya muda wa uchakataji") na kiwango cha juu kwa kila uendeshaji: kiasi cha juu ambacho uendeshaji unaweza kugharimu, kulingana na kile ombi lako linasema (max_tokens, urefu wa maandishi yako, mwonekano, idadi ya matokeo) na mipaka iliyochapishwa ya modeli. Kamwe hakitegemei maudhui ya faili lililo nyuma ya URL. Kwa modeli inayotozwa kulingana na muda wa uchakataji au urefu wa kipindi cha sauti, kiwango cha juu ni muda mrefu zaidi ambao ombi linaweza kuendeshwa (dakika 15 kwa picha, 30 kwa sauti, 60 kwa video), kwa hiyo huwa juu sana kuliko uendeshaji wa kawaida. Ingizo ambalo kiwango chake cha juu kingezidi kikomo cha modeli kwa kila uendeshaji (maandishi marefu sana) hukataliwa kwa 422 invalid_input:

1. Nukuu hurudisha kiwango hicho cha juu kama credits (pamoja na hold na typical, uendeshaji wa kawaida). Uendeshaji unapoanza, kiwango cha juu hukatwa kutoka kwenye salio la API, na ndicho ambacho salio na bajeti ya ufunguo wako lazima viweze kugharamia.
2. Uendeshaji unapofaulu, ombi hutatuliwa kulingana na matumizi ambayo modeli inaripoti: matumizi × bei ya matumizi, ikizungushwa juu hadi krediti nzima ya API. Sehemu iliyobaki ya kiwango cha juu hurejeshwa kiotomatiki, mara moja, kama safu ya refund kwenye salio lako la API.
3. Uendeshaji kamwe hauzidi kugharimu kiwango chake cha juu, hata kama matumizi yake yangekuwa makubwa. Uendeshaji ulioshindwa au ulioghairiwa hurejeshewa fedha kikamilifu, kama kawaida.

Uendeshaji mwingi hugharimu chini sana ya kiwango cha juu; ukurasa wa modeli huonyesha "Hadi $X kwa kila uendeshaji" kwa ingizo la mjenzi na uendeshaji wa kawaida ("from" kwenye katalogi). Kwa modeli chache zinazotozwa kulingana na muda wa uchakataji, matumizi ni muda wa uchakataji wa modeli (uliowekwa alama 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"
}

Baada ya uendeshaji, cost ya ombi huonyesha kilichoshikiliwa na matumizi yaliyofikia:

{
  "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 ndiyo gharama ya uendeshaji. settled.status ni pending kwa muda kati ya matokeo na utatuzi, na no_usage katika hali nadra ambayo modeli haikuripoti matumizi yoyote (hapo kiwango cha juu hubaki kuwa bei).

Nukuu kabla ya kuendesha#

POST https://api.doitong.com/v1/quote/{model_id} hupokea mwili uleule ambao ungetuma kwa run na kurudisha bei ya ingizo hilo: bei kamili, isipokuwa kwa modeli inayotozwa kulingana na matumizi, ambapo ni kiwango cha juu ambacho uendeshaji unaweza kugharimu. Haihitaji ufunguo na haina gharama:

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

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

Ukiwa na ufunguo, nukuu pia hurudisha balance_credits na balance_usd (salio lako la API), affordable na key_budget_remaining. Ongeza ?currency=rub kwa kiasi cha rub.

Vitu vya bei#

Kila bei katika API ina muundo uleule:

• 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" } — pamoja na rub, rub_display na from_rub nchini Urusi au kwa ?currency=rub;
• requests: cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 } (krediti za API; ombi la metered huongeza mode, held, typical na settled, tazama Hutozwa kulingana na matumizi);
• account: GET https://api.doitong.com/v1/account hurudisha credits (salio la API), balance: { "credits", "usd" } na storage (bei ya hifadhi ya faili, matumizi na makadirio ya kila mwezi).

Marejesho ya fedha#

• Ombi batili (yoyote ya 4xx kabla ya uendeshaji kuanza) halitozwi kamwe.
• Ombi linalomalizika kwa failed (pamoja na timeout) hurejeshewa fedha kikamilifu kwenye salio la API, kiotomatiki.
• Ombi unaloghairi kabla halijaanza hurejeshewa fedha kikamilifu. Modeli inapoanza kuzalisha, kughairi ni ombi pekee: ikiwa modeli itamaliza, tokeo hutolewa na kutozwa.
• Ombi la metered linalofaulu hurejeshewa sehemu ya kiwango chake cha juu ambayo halikutumia.

Kipengee cha ombi huonyesha yote: cost.credits, cost.charged na cost.refunded.

Hifadhi ya faili#

Faili za matokeo huhifadhiwa kwenye hifadhi yetu. Unachagua, katika akaunti au kwa kila uendeshaji (?storage=):

Hifadhi ya kudumu hutozwa mara moja kwa siku kutoka kwenye salio la API: GB zilizohifadhiwa × bei ya kila mwezi ÷ siku za mwezi, kama safu za leja za aina storage. Sehemu za krediti ya API hubebwa hadi siku inayofuata, kwa hiyo mwezi hujumlisha hasa GB × 100 krediti za API (1 GB = 1024³ baiti; GB 10 zilizohifadhiwa kwa mwezi hugharimu 1,000 krediti za API). Salio haliwi chini ya sufuri: linaposhindwa kulipa, siku hiyo haitozwi, unapokea barua pepe, na una siku 30 za kuongeza salio kabla faili zilizohifadhiwa kuwa za muda na kufutwa siku 7 baadaye. Maelezo: Faili.

Bei za sasa#

Hizi ndizo modeli zilizoangaziwa. Modeli zote 1,496 na bei zake zinapatikana kwenye katalogi ya modeli na katika GET /models (ufunguo hauhitajiki).

Ongeza salio#

Ongeza pesa kwenye salio la API katika https://doitong.com/developers/dashboard#balance. Salio linapokuwa dogo sana, uendeshaji hujibu 402 insufficient_credits pamoja na top_up_url. Kila ufunguo wa API pia unaweza kuwekewa bajeti yake ya juu kwa krediti za API (tazama Uthibitishaji).