Ipprezzar

Kull mudell jiswa eżattament dak li jitlob il-manifattur tiegħu, f’dollari Amerikani. Tħallas mill-bilanċ tal-API tiegħek, li jingħadd fi krediti tal-API: 1,000 krediti tal-API = $1. Il-bilanċ tal-API huwa bilanċ separat, differenti mill-krediti tal-apps ta’ Doitong. M’hemmx pjanijiet, minimi jew tariffi għal kull mudell: sejħa tiswa l-prezz tagħha, imnaqqas mill-bilanċ tal-API meta tiġi aċċettata t-talba.

Fir-Russja (doitong.ru, api.doitong.ru, jew ?currency=rub) il-prezzijiet jintwerew ukoll bir-rubli: il-prezz USD × ir-rata USD/RUB × 1.3.

Unitajiet#

Kull mudell għandu unità waħda ta’ fatturazzjoni, murija fuq il-paġna tiegħu u f’GET https://api.doitong.com/v1/models/{model_id}:

Prezz = kwantità × krediti tal-API għal kull unità, imqarreb ’il fuq għal kreditu tal-API sħiħ ($0.001), qatt inqas minn 1. Unitajiet irħas ħafna jista’ jkollhom prezz frazzjonali għal kull unità (0.4 krediti tal-API għal kull sekonda); it-total biss ta’ sejħa jiġi arrotondat.

Xi mudelli jitolbu rata differenti skont l-input: vidjo bil-ħoss jiswa aktar minn wieħed mingħajr ħoss, 4K jiswa aktar minn 1K, u l-bqija. Dawn ir-regoli jidhru fuq kull paġna tal-mudell. Parametru li tħalli barra jingħadd bħala l-valur prestabbilit tiegħu, għalhekk il-prezz li tara għal input huwa l-prezz li tħallas.

Prezzijiet eżatti, imkejla, stmati u skont l-użu#

Kull prezz għandu mode:

• exact: il-prezz jiġi kkalkulat mill-input tiegħek (sekondi, immaġnijiet, megapixels, karattri, passi, jew prezz fiss wieħed għal kull vidjo jew sejħa).
• measured: il-prezz isegwi l-fajls li tibgħat: it-tul ta’ vidjo jew awdjo tal-input, id-daqs ta’ immaġni tal-input, ir-rata tal-frejms jew in-numru ta’ frejms ta’ vidjo. Upscalers, lip sync, vidjo-to-vidjo, traskrizzjoni u għodod tal-awdjo jiġu pprezzati hekk. Qabel it-tħaddim l-API taqra t-tul, ir-riżoluzzjoni u r-rata tal-frejms tal-fajl (il-kwotazzjoni tagħmel l-istess), għalhekk il-kwotazzjoni hija eżattament dak li jħallas it-tħaddim. Il-paġna tal-mudell tgħid għal xiex tħallas ("Price per sekonda of your input vidjo") u l-kalkolatur tagħha juża n-numri tal-fajl tiegħek. Fajl li ma jistax jinqara jiġi rrifjutat b’unmeasurable_input u ma jitħallas xejn.
• estimate: l-ispiża proprja tal-mudell tiddependi fuq xi ħaġa li l-input ma jistax jgħid minn qabel (tokens, ħin tal-komputazzjoni). Mudell bħal dan jitlob prezz stmat fiss għal kull tħaddim (għal kull immaġni tal-output meta jkollu għadd ta’ immaġnijiet), stabbilit mill-ispiża medja ta’ tħaddim reali ta’ dak il-mudell. Xorta tkun taf il-prezz qabel tħaddmu: il-kwotazzjoni hija dak li tħallas.
• metered: il-mudell jiġi ċċarġjat skont l-użu attwali, li jkun magħruf biss mit-tħaddim innifsu: it-tokens li mudell tal-lingwa jew tal-viżjoni jaqra u jikteb, is-sekondi ta’ diskors li jiġġenera mudell tal-vuċi, jew il-ħin tal-ipproċessar tal-mudell. Ara Iċċarġjat skont l-użu hawn taħt.

Il-paġni tal-mudelli jgħidu "Price per run", "Price per sekonda of your input vidjo" (u simili), "Estimated price per run" jew "Charged by usage"; GET https://api.doitong.com/v1/models?mode=measured, ?mode=estimate u ?mode=metered jelenkawhom.

Iċċarġjat skont l-użu#

Mudell metered għandu prezz tal-użu ("$0.01 per 1000 tokens", "$0.002 per sekonda of generated audio", "$0.00111 per sekonda of processing time") u massimu għal kull tħaddim: l-aktar li jista’ jiswa t-tħaddim, skont dak li tgħid it-talba tiegħek (max_tokens, it-tul tat-test tiegħek, ir-riżoluzzjoni, in-numru ta’ outputs) u l-limiti ppubblikati tal-mudell. Qatt ma jiddependi mill-kontenut ta’ fajl wara URL. Għal mudell iffatturat skont il-ħin tal-ipproċessar jew it-tul ta’ sessjoni tal-vuċi, il-massimu huwa l-itwal ħin li fih tista’ taħdem talba (15-il minuta għall-immaġnijiet, 30 għall-awdjo, 60 għall-vidjo), għalhekk huwa ferm ogħla minn tħaddim tipiku. Input li l-massimu tiegħu jaqbeż il-limitu għal kull tħaddim tal-mudell (test twil ħafna) jiġi rrifjutat b’422 invalid_input:

1. Il-kwotazzjoni tirritorna dak il-massimu bħala credits (b’hold u typical, tħaddim tas-soltu). Meta jibda t-tħaddim, il-massimu jitnaqqas mill-bilanċ tal-API, u huwa dak li jridu jkopru l-bilanċ u l-baġit taċ-ċavetta tiegħek.
2. Meta t-tħaddim jirnexxi, it-talba tiġi ssetiljata għall-użu rrappurtat mill-mudell: użu × prezz tal-użu, imqarreb ’il fuq għal kreditu tal-API sħiħ. Il-bqija tal-massimu jiġi rifuż awtomatikament, darba waħda, bħala ringiela refund tal-bilanċ tal-API tiegħek.
3. Tħaddim qatt ma jiswa aktar mill-massimu tiegħu, anki jekk l-użu tiegħu jagħmel dan. Tħaddim li jfalli jew jiġi kkanċellat jirċievi rifużjoni sħiħa, bħal dejjem.

Il-biċċa l-kbira tat-tħaddim tiswa ferm inqas mill-massimu; il-paġna tal-mudell turi "Up to $X per run" għall-input tal-builder u t-tħaddim tipiku ("from" fil-katalgu). Għall-ftit mudelli ffatturati skont il-ħin tal-ipproċessar, l-użu huwa l-ħin tal-ipproċessar tal-mudell (immarkat 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"
}

Wara t-tħaddim, cost tat-talba juri dak li nżamm u dak li ammonta għalih l-użu:

{
  "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 huwa dak li sewa t-tħaddim. settled.status huwa pending għall-mument bejn ir-riżultat u s-settlement, u no_usage fil-każ rari fejn il-mudell ma rrapporta l-ebda użu (imbagħad il-massimu jibqa’ l-prezz).

Kwotazzjoni qabel tħaddem#

POST https://api.doitong.com/v1/quote/{model_id} jieħu eżattament il-body li tibgħat lil run u jirritorna l-prezz ta’ dak l-input: il-prezz eżatt, għajr għal mudell iċċarġjat skont l-użu, fejn ikun l-aktar li jista’ jiswa t-tħaddim. Ma jeħtieġx ċavetta u ma jiswa xejn:

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

B’ċavetta, il-kwotazzjoni tirritorna wkoll balance_credits u balance_usd (il-bilanċ tal-API tiegħek), affordable u key_budget_remaining. Żid ?currency=rub għal ammont rub.

Oġġetti tal-prezz#

Kull prezz fl-API għandu l-istess struttura:

• 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" } — flimkien ma’ rub, rub_display u from_rub fir-Russja jew b’?currency=rub;
• requests: cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 } (krediti tal-API; talba metered iżżid mode, held, typical u settled, ara Iċċarġjat skont l-użu);
• account: GET https://api.doitong.com/v1/account jirritorna credits (il-bilanċ tal-API), balance: { "credits", "usd" } u storage (prezz, użu u stima ta’ kull xahar tal-ħażna tal-fajls).

Rifużjonijiet#

• Talba invalida (kwalunkwe 4xx qabel ma jibda t-tħaddim) qatt ma tiġi ċċarġjata.
• Talba li tispiċċa failed (inkluż timeout) tirċievi rifużjoni sħiħa fil-bilanċ tal-API, awtomatikament.
• Talba li tikkanċella qabel ma tibda tirċievi rifużjoni sħiħa. Ladarba l-mudell ikun qed jiġġenera, kanċellazzjoni hija biss talba: jekk il-mudell jispiċċa, ir-riżultat jitwassal u jiġi ċċarġjat.
• Talba metered li tirnexxi tieħu lura l-parti tal-massimu li ma użatx.

L-oġġett tat-talba juri kollox: cost.credits, cost.charged u cost.refunded.

Ħażna tal-fajls#

Il-fajls tal-output jinżammu fil-ħażna tagħna. Int tagħżel, fil-kont jew għal kull tħaddim (?storage=):

Il-ħażna permanenti tiġi ċċarġjata darba kuljum mill-bilanċ tal-API: GB miżmuma × il-prezz ta’ kull xahar ÷ in-numru ta’ jiem fix-xahar, bħala ringieli tal-ledger tat-tip storage. Frazzjonijiet ta’ kreditu tal-API jgħaddu għall-jum ta’ wara, għalhekk xahar jammonta eżattament għal GB × 100 krediti tal-API (1 GB = 1024³ bytes; 10 GB miżmuma għal xahar jiswew 1,000 krediti tal-API). Il-bilanċ qatt ma jinżel taħt iż-żero: meta ma jkunx jista’ jħallas, dak il-jum ma jiġix iċċarġjat, tirċievi email, u jkollok 30 jum biex tagħmel top-up qabel ma l-fajls miżmuma jsiru temporanji u jitħassru 7 jum wara. Dettalji: Fajls.

Prezzijiet attwali#

Dawn huma l-mudelli magħżula. Il-mudelli kollha ta' 1,496 u l-prezzijiet tagħhom jinsabu fil-katalgu tal-mudelli u f'GET /models (mhi meħtieġa l-ebda ċavetta).

Top-up#

Żid flus mal-bilanċ tal-API fuq https://doitong.com/developers/dashboard#balance. Meta l-bilanċ ikun baxx wisq, tħaddim iwieġeb b’402 insufficient_credits u top_up_url. Kull ċavetta API tista’ wkoll tiġi limitata bil-baġit tagħha stess fi krediti tal-API (ara Awtentikazzjoni).