Árak

Minden modell pontosan annyiba kerül, amennyit a készítője kér érte, amerikai dollárban. A fizetés a API-egyenlegből történik, amelyet API-kreditben tartunk nyilván: 1000 API-jóváírás = 1 $. Az API-egyenleg különálló egyenleg, nem azonos a Doitong alkalmazások kreditjeivel. Nincsenek csomagok, minimumok vagy modellenkénti díjak: egy hívás az árába kerül, amelyet a kérés elfogadásakor levonunk az API-egyenlegből.

Oroszországban (doitong.ru, api.doitong.ru vagy ?currency=rub) az árakat rubelben is megjelenítjük: USD-ár × USD/RUB-árfolyam × 1,3.

Egységek#

Minden modellnek egy számlázási egysége van, amely az oldalán és a GET https://api.doitong.ru/v1/models/{model_id} válaszában látható:

Ár = mennyiség × egységenkénti API-kredit, felfelé kerekítve egész API-kreditre (0,001 $), de legalább 1-re. A nagyon olcsó egységek egységenként tört árat is tartalmazhatnak (0.4 API-kredit másodpercenként); csak a teljes hívás ára kerekítődik.

Egyes modellek a bemenettől függően eltérő díjat számítanak fel: a hanggal készült videó drágább a hang nélkülinél, a 4K drágább az 1K-nál, és így tovább. Ezek a szabályok minden modelloldalon fel vannak sorolva. A kihagyott paraméter alapértelmezett értéknek számít, ezért a bemenethez megjelenített ár az az ár, amelyet fizetnie kell.

Pontos, mért, becsült és használatalapú árak#

Minden árhoz tartozik egy mode:

• exact: az ár a bemenetből számítható ki (másodpercek, képek, megapixelek, karakterek, lépések, illetve videónként vagy hívásonként egy átalányár).
• measured: az ár az elküldött fájlokat követi: a bemeneti videó vagy hang hossza, a bemeneti kép mérete, illetve a videó képkockasebessége vagy képkockáinak száma. A felskálázók, a lip sync, a videóból videó, az átírási és a hangkezelő eszközök így vannak árazva. A futtatás előtt az API beolvassa a fájl hosszát, felbontását és képkockasebességét, ezért az árajánlat pontosan azt az árat mutatja, amelyet a futtatás felszámít. A modelloldal megadja, miért fizet („Price per másodperc of your input videó”), a kalkulátor pedig a fájl adatait használja. A nem olvasható fájlt unmeasurable_input hibával elutasítjuk, és nem számítunk fel díjat.
• estimate: a modell saját költsége valamitől függ, amit a bemenet előre nem árul el (tokenek, számítási idő). Az ilyen modell futtatásonként rögzített becsült árat számít fel (képszám esetén kimeneti képenként), amelyet a modell valós futtatásainak átlagos költségéből határozunk meg. A futtatás előtt így is ismeri az árat: az árajánlat az az összeg, amelyet fizet.
• metered: a modell tényleges használat alapján számlázott, amelyet csak maga a futtatás ismer: a nyelvi vagy látásmodell által beolvasott és létrehozott tokenek, a hangmodell által létrehozott beszéd másodpercei vagy a modell feldolgozási ideje. Lásd alább: Használat alapján számlázva.

A modelloldalak a „Price per run”, „Price per másodperc of your input videó” és hasonló, „Estimated price per run” vagy „Charged by usage” szövegeket használják; a GET https://api.doitong.ru/v1/models?mode=measured, ?mode=estimate és ?mode=metered ezek alapján listáz.

Használat alapján számlázva#

A metered modell használati ára például „$0.01 per 1000 tokens”, „$0.002 per second of generated audio” vagy „$0.00111 per second of processing time”, és futtatásonkénti maximuma is van: ez a legmagasabb összeg, amibe a futtatás kerülhet a kérés adatai (max_tokens, a szöveg hossza, a felbontás, a kimenetek száma) és a modell közzétett korlátai alapján. Soha nem függ az URL mögötti fájl tartalmától. A feldolgozási idő vagy hangmunkamenet hossza alapján számlázott modellnél a maximum a kérés maximális futási ideje (képnél 15 perc, hangnál 30, videónál 60), ezért jóval magasabb lehet egy szokásos futtatásnál. Ha a bemenet maximuma meghaladná a modell futtatásonkénti korlátját, a bemenetet 422 invalid_input hibával elutasítjuk:

1. Az árajánlat ezt a maximumot credits értékként adja vissza (hold és typical értékekkel, amelyek egy szokásos futtatást jelölnek). A futtatás kezdetekor a maximumot levonjuk az API-egyenlegből, ezért ezt kell fedeznie az egyenlegnek és a kulcs keretének.
2. Sikeres futtatáskor a kérés elszámolása a modell által jelentett használathoz igazodik: használat × használati ár, egész API-kreditre felfelé kerekítve. A maximum fennmaradó részét automatikusan, egyszer visszatérítjük az API-egyenleg egy refund soraként.
3. Egy futtatás soha nem kerülhet többe a maximumnál, még akkor sem, ha a használat alapján többe kerülne. A sikertelen vagy megszakított futtatást szokás szerint teljes egészében visszatérítjük.

A legtöbb futtatás jóval kevesebbe kerül a maximumnál; a modelloldal a készítő bemenetéhez és a szokásos futtatáshoz az „Up to $X per run” értéket mutatja („from” a katalógusban). A feldolgozási idő alapján számlázott néhány modellnél a használat a modell feldolgozási ideje (approximate jelöléssel).

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

A futtatás után a kérés cost értéke mutatja a zárolt összeget és a használat szerinti összeget:

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

A charged − refunded érték a futtatás költsége. A settled.status a találat és az elszámolás közötti időre pending, abban a ritka esetben pedig, amikor a modell egyáltalán nem jelent használatot, no_usage (ilyenkor a maximum marad az ár).

Árajánlat a futtatás előtt#

A POST https://api.doitong.ru/v1/quote/{model_id} pontosan azt a törzset fogadja, amelyet a run végpontra küldene, és visszaadja a bemenet árát: a pontos árat, kivéve a használat alapján számlázott modellt, amelynél azt a maximumot, amibe a futtatás kerülhet. Nem igényel kulcsot, és díjmentes:

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

Kulccsal az árajánlat a balance_credits és balance_usd értékeket (az API-egyenleget), az affordable és a key_budget_remaining értéket is visszaadja. A rub összeghez adja hozzá a ?currency=rub paramétert.

Árobjektumok#

Az API minden ára azonos felépítésű:

• modellek: 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" } — Oroszországban vagy ?currency=rub esetén a rub, a rub_display és a from_rub mezővel kiegészítve;
• kérések: cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 } (API-kredit; egy metered kéréshez a mode, held, typical és settled is hozzáadódik, lásd: Használat alapján számlázva);
• fiók: a GET https://api.doitong.ru/v1/account a credits értéket (az API-egyenleget), a balance: { "credits", "usd" } és a storage értéket (a fájltárhely árát, használatát és havi becslését) adja vissza.

Visszatérítések#

• Az érvénytelen kérésért (bármely 4xx, mielőtt a futtatás elindulna) soha nem számítunk fel díjat.
• A failed állapotban végződő kérést (a timeout esetén is) automatikusan teljes egészében visszatérítjük az API-egyenlegre.
• Az indulás előtt megszakított kérést teljes egészében visszatérítjük. Miután a modell generálni kezdett, a megszakítás csak kérés: ha a modell befejezi a munkát, az eredményt kézbesítjük és felszámítjuk a díjat.
• A sikeres metered kérés visszakapja a maximum fel nem használt részét.

A kérésobjektum mindezt megjeleníti: cost.credits, cost.charged és cost.refunded.

Fájltárhely#

A kimeneti fájlokat a tárhelyünkön tároljuk. A fiókban vagy futtatásonként választhat (?storage=):

A végleges tárhely díját naponta egyszer vonjuk le az API-egyenlegből: a tárolt GB × havi ár ÷ a hónap napjainak száma, storage típusú főkönyvi sorokként. Az API-kredit tört részeit a következő napra visszük át, ezért egy hónap pontosan GB × 100 API-kreditet tesz ki (1 GB = 1024³ bájt; 10 GB egy hónapos tárolása 1000 API-kredit). Az egyenleg soha nem megy nulla alá: ha nem tud fizetni, arra a napra nem számítunk fel díjat, e-mailt küldünk, és 30 napja van feltölteni az egyenleget, mielőtt a megőrzött fájlok ideiglenessé válnak, majd 7 nappal később törlődnek. Részletek: Fájlok.

Aktuális árak#

Ezek a kiemelt modellek. Mind a(z) 1496 modell és azok ára megtalálható a modellkatalógusban és a GET /models végponton (nem szükséges kulcs).

Feltöltés#

Töltsön fel pénzt az API-egyenlegre itt: https://doitong.ru/developers/dashboard#balance. Ha az egyenleg túl alacsony, a futtatás 402 insufficient_credits hibával és top_up_url értékkel tér vissza. Minden API-kulcshoz saját, API-kreditben megadott keret is beállítható (lásd: Hitelesítés).