Verð

Hvert líkan kostar nákvæmlega það sem framleiðandi líkansins rukkar fyrir það, í Bandaríkjadölum. Þú greiðir af API-stöðunni, sem er talin í API-inneign: 1.000 API-inneignir = 1 $. API-staðan er aðskilin staða, óháð inneign Doitong-forritanna. Engar áskriftir, lágmarksgjöld eða gjöld fyrir hvert líkan eru til: kall kostar sitt verð, sem dregið er af API-stöðunni þegar beiðnin er samþykkt.

Í Rússlandi (doitong.ru, api.doitong.ru eða ?currency=rub) eru verð einnig sýnd í rúblum: USD-verð × USD/RUB-gengi × 1,3.

Einingar#

Hvert líkan hefur eina gjaldseiningu, sem birtist á síðu þess og í GET https://api.doitong.com/v1/models/{model_id}:

Verð = magn × API-inneign á hverja einingu, námundað upp í heila API-inneign (0,001 $), aldrei minna en 1. Mjög ódýrar einingar geta haft brotaverð á einingu (0.4 API-inneign á sekúndu); aðeins heildarverð kalls er námundað.

Sum líkön rukka mismunandi verð eftir inntakinu: myndband með hljóði kostar meira en án hljóðs, 4K kostar meira en 1K og svo framvegis. Þessar reglur eru taldar upp á síðu hvers líkans. Færibreyta sem þú sleppir telst hafa sjálfgefið gildi, svo verðið sem þú sérð fyrir inntak er verðið sem þú greiðir.

Nákvæmt, mælt, áætlað og notkunarverð#

Hvert verð hefur mode:

• exact: Verðið er reiknað út frá inntakinu þínu (sekúndum, myndum, megapixlum, stöfum, skrefum eða föstu verði fyrir hvert myndband eða kall).
• measured: Verðið fylgir skránum sem þú sendir: lengd inntaksvídeós eða hljóðs, stærð inntaksmyndar, rammatíðni eða rammi myndbands. Stærðarbreyting, varasamstilling, myndband-í-myndband, umritun og hljóðverkfæri eru verðlögð þannig. Fyrir keyrslu les API lengd, upplausn og rammatíðni skrárinnar (tilboðið gerir það sama), svo tilboðið er nákvæmlega það sem keyrslan rukkar. Á síðu líkansins kemur fram fyrir hvað þú greiðir ("Verð á sekúndu af inntaksvídeói þínu") og reiknivélin notar tölur úr skránni þinni. Skrá sem ekki er hægt að lesa er höfnuð með unmeasurable_input og ekkert er rukkað.
• estimate: Kostnaður líkansins sjálfs ræðst af einhverju sem inntakið getur ekki sagt fyrir um (táknum, reiknitíma). Slíkt líkan rukkar fast áætlað verð fyrir hverja keyrslu (fyrir hverja úttaksmynd þegar myndafjöldi er til), ákvarðað út frá meðalkostnaði raunverulegra keyrslna líkansins. Þú veist samt verðið áður en þú keyrir: tilboðið er það sem þú greiðir.
• metered: Líkanið er rukkað eftir raunverulegri notkun, sem aðeins keyrslan sjálf þekkir: táknin sem mál- eða sjónlíkanið les og skrifar, sekúndur tals sem raddlíkan býr til eða vinnslutími líkansins. Sjá Rukkað eftir notkun hér að neðan.

Á síðum líkana stendur "Verð fyrir keyrslu", "Verð á sekúndu af inntaksvídeói þínu" (og sambærilegt), "Áætlað verð fyrir keyrslu" eða "Rukkað eftir notkun"; GET https://api.doitong.com/v1/models?mode=measured, ?mode=estimate og ?mode=metered sýna þau.

Rukkað eftir notkun#

metered-líkan hefur notkunarverð ("$0.01 fyrir hver 1000 tákn", "$0.002 á sekúndu af mynduðu hljóði", "$0.00111 á sekúndu vinnslutíma") og hámark fyrir hverja keyrslu: það mesta sem keyrslan getur kostað, út frá því sem beiðnin þín segir (max_tokens, lengd textans, upplausn, fjöldi úttaka) og birtum takmörkunum líkansins. Það ræðst aldrei af innihaldi skráar á bak við URL. Fyrir líkan sem er rukkað eftir vinnslutíma eða lengd raddlotu er hámarkið lengsta mögulega keyrsla (15 mínútur fyrir myndir, 30 fyrir hljóð, 60 fyrir myndband), svo það er langt yfir dæmigerðri keyrslu. Inntak þar sem hámarkið færi yfir mörk líkansins fyrir hverja keyrslu (mjög langur texti) er hafnað með 422 invalid_input:

1. Tilboðið skilar því hámarki sem credits (með hold og typical, venjulegri keyrslu). Þegar keyrsla hefst er hámarkið dregið af API-stöðunni og það er það sem staðan og fjárhagsrammi lykilsins verða að ná yfir.
2. Þegar keyrslan tekst er beiðnin gerð upp miðað við notkunina sem líkanið tilkynnir: notkun × notkunarverð, námundað upp í heila API-inneign. Afgangur hámarksins er endurgreiddur sjálfkrafa, einu sinni, sem refund-færsla á API-stöðunni.
3. Keyrsla kostar aldrei meira en hámarkið, jafnvel þótt notkunin myndi gera það. Misheppnuð eða aflýst keyrsla er endurgreidd að fullu, eins og alltaf.

Flestar keyrslur kosta mun minna en hámarkið; á síðu líkansins stendur "Allt að $X fyrir hverja keyrslu" fyrir inntak byggjarans og dæmigerða keyrslu ("frá" í vörulistanum). Fyrir þau fáu líkön sem eru rukkuð eftir vinnslutíma er notkunin vinnslutími líkansins (merkt 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"
}

Eftir keyrsluna sýnir cost í beiðninni hvað var haldið eftir og hver notkunin varð:

{
  "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 er kostnaður keyrslunnar. settled.status er pending á tímabilinu milli niðurstöðu og uppgjörs og no_usage í sjaldgæfu tilviki þar sem líkanið tilkynnti enga notkun (þá stendur hámarkið sem verðið).

Tilboð áður en þú keyrir#

POST https://api.doitong.com/v1/quote/{model_id} tekur nákvæmlega meginmálið sem þú myndir senda í run og skilar verði þess inntaks: nákvæmu verði, nema fyrir líkan rukkað eftir notkun, þar sem það er það mesta sem keyrslan getur kostað. Það þarf engan lykil og kostar ekkert:

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

Með lykli skilar tilboðið einnig balance_credits og balance_usd (API-stöðunni þinni), affordable og key_budget_remaining. Bættu við ?currency=rub til að fá rub-upphæð.

Verðhlutir#

Öll verð í API hafa sama snið:

• 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" } — auk rub, rub_display og from_rub í Rússlandi eða með ?currency=rub;
• requests: cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 } (API-inneign; metered-beiðni bætir við mode, held, typical og settled, sjá Rukkað eftir notkun);
• account: GET https://api.doitong.com/v1/account skilar credits (API-stöðunni), balance: { "credits", "usd" } og storage (verði geymslu fyrir skrár, notkun og mánaðarlegu mati).

Endurgreiðslur#

• Ógild beiðni (hvaða 4xx sem er áður en keyrsla hefst) er aldrei rukkuð.
• Beiðni sem endar failed (þar með talin timeout) er endurgreidd að fullu á API-stöðuna, sjálfkrafa.
• Beiðni sem þú aflýsir áður en hún hefst er endurgreidd að fullu. Þegar líkanið er byrjað að mynda er aflýsing aðeins beiðni: ef líkanið lýkur er niðurstaðan afhent og rukkað.
• metered-beiðni sem tekst fær til baka þann hluta hámarksins sem hún notaði ekki.

Beiðnishlutinn sýnir allt: cost.credits, cost.charged og cost.refunded.

Geymsla skráa#

Úttaksskrár eru geymdar í geymslu okkar. Þú velur í reikningnum eða fyrir hverja keyrslu (?storage=):

Geymsla til frambúðar er rukkuð einu sinni á dag af API-stöðunni: GB sem eru geymd × mánaðarverð ÷ fjöldi daga mánaðarins, sem bókhaldsfærslur af gerðinni storage. Brot úr API-inneign flytjast yfir á næsta dag, svo mánuðurinn leggst saman í nákvæmlega GB × 100 API-inneign (1 GB = 1024³ bæti; 10 GB sem eru geymd í mánuð kosta 1.000 API-inneign). Staðan fer aldrei undir núll: þegar hún getur ekki greitt er sá dagur ekki rukkaður, þú færð tölvupóst og hefur 30 daga til að gera áfyllingu áður en geymdar skrár verða tímabundnar og þeim er eytt 7 dögum síðar. Nánar: Skrár.

Núverandi verð#

Þetta eru líkönin sem við mælum með. Öll 1.496 líkönin og verð þeirra eru í líkönaskránni og í GET /models (ekki þarf lykil).

Áfylling#

Bættu fé við API-stöðuna á https://doitong.com/developers/dashboard#balance. Þegar staðan er of lág svarar keyrsla með 402 insufficient_credits og top_up_url. Hægt er einnig að setja sérfjárhagsramma í API-inneign á hvern API-lykil (sjá Auðkenning).