Ceník

Každý model stojí přesně tolik, kolik za něj účtuje jeho tvůrce, v amerických dolarech. Platíte ze svého zůstatku API, který se počítá v API kreditech: 1 000 kreditů API = 1 $. Zůstatek API je samostatný a oddělený od kreditů aplikací Doitong. Neexistují žádné tarify, minima ani poplatky za model: volání stojí svou cenu, která se odečte ze zůstatku API, jakmile je požadavek přijat.

V Rusku (doitong.ru, api.doitong.ru nebo ?currency=rub) se ceny zobrazují také v rublech: cena v USD × kurz USD/RUB × 1,3.

Jednotky#

Každý model má jednu fakturační jednotku uvedenou na své stránce a v GET https://api.doitong.ru/v1/models/{model_id}:

Cena = množství × počet API kreditů za jednotku, zaokrouhleno nahoru na celé API kredity (0,001 $), nikdy méně než 1. Velmi levné jednotky mohou mít zlomkovou cenu za jednotku (0.4 API kreditu za sekundu); zaokrouhluje se pouze celková cena volání.

Některé modely účtují různé sazby podle vstupu: video se zvukem stojí více než bez zvuku, 4K více než 1K atd. Tato pravidla jsou uvedena na stránce každého modelu. Parametr, který vynecháte, se považuje za výchozí hodnotu, takže cena zobrazená pro vstup je cena, kterou zaplatíte.

Přesné, měřené, odhadované ceny a ceny podle využití#

Každá cena má mode:

• exact: cena se vypočítá ze vstupu (sekundy, obrázky, megapixely, znaky, kroky nebo jedna pevná cena za video či volání).
• measured: cena vychází ze souborů, které odešlete: délky vstupního videa nebo zvuku, velikosti vstupního obrázku, snímkové frekvence nebo počtu snímků videa. Upscaling, synchronizace rtů, převod videa na video, přepis a zvukové nástroje se účtují tímto způsobem. Před spuštěním API načte délku, rozlišení a snímkovou frekvenci souboru (totéž provede cenová nabídka), takže nabídka přesně odpovídá ceně spuštění. Stránka modelu uvádí, za co platíte ("Cena za sekundu vašeho vstupního videa") a kalkulačka používá hodnoty vašeho souboru. Soubor, který nelze přečíst, se odmítne s unmeasurable_input a nic se neúčtuje.
• estimate: vlastní cena modelu závisí na něčem, co vstup nedokáže předem určit (tokenech, výpočetním čase). Takový model účtuje pevnou odhadovanou cenu za spuštění (za výstupní obrázek, pokud má počet obrázků), stanovenou z průměrné ceny skutečných spuštění tohoto modelu. Cenu stále znáte před spuštěním: nabídka je částka, kterou zaplatíte.
• metered: model se účtuje podle skutečného využití, které zná pouze samotné spuštění: tokenů, které jazykový nebo obrazový model přečte a zapíše, sekund řeči vygenerovaných hlasovým modelem nebo času zpracování modelu. Viz Účtování podle využití níže.

Stránky modelů uvádějí „Cena za spuštění“, „Cena za sekundu vašeho vstupního videa“ (a podobně), „Odhadovaná cena za spuštění“ nebo „Účtováno podle využití“; GET https://api.doitong.ru/v1/models?mode=measured, ?mode=estimate a ?mode=metered je vypisují.

Účtování podle využití#

Model metered má cenu podle využití ("$0.01 za 1000 tokenů", "$0.002 za sekundu vygenerovaného zvuku", "$0.00111 za sekundu času zpracování") a maximum za spuštění: nejvyšší částku, kterou může spuštění stát, podle toho, co uvádí váš požadavek (max_tokens, délka textu, rozlišení, počet výstupů) a zveřejněných limitů modelu. Nikdy nezávisí na obsahu souboru za URL. U modelu účtovaného podle času zpracování nebo délky hlasové relace je maximum nejdelší doba, po kterou může požadavek běžet (15 minut pro obrázky, 30 pro zvuk, 60 pro video), takže je výrazně vyšší než typická cena. Vstup, jehož maximum by překročilo limit modelu za spuštění (velmi dlouhý text), se odmítne s 422 invalid_input:

1. Nabídka vrátí toto maximum jako credits (s hold a typical, tedy obvyklým spuštěním). Když spuštění začne, maximum se odečte ze zůstatku API a právě tuto částku musí pokrýt zůstatek i rozpočet vašeho klíče.
2. Po úspěšném dokončení se požadavek vyúčtuje podle využití, které model nahlásí: využití × cena podle využití, zaokrouhleno nahoru na celé API kredity. Zbytek maxima se automaticky refunduje, jednou jako řádek refund ve zůstatku API.
3. Spuštění nikdy nestojí více než jeho maximum, ani kdyby jeho využití bylo vyšší. Neúspěšné nebo zrušené spuštění se jako vždy refunduje v plné výši.

Většina spuštění stojí výrazně méně než maximum; stránka modelu u vstupu nástroje zobrazuje „Až $X za spuštění“ a typické spuštění („od“ v katalogu). U několika modelů účtovaných podle času zpracování je využitím čas zpracování modelu (označený 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"
}

Po spuštění cost požadavku ukazuje, co bylo zadrženo a kolik činilo využití:

{
  "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 je cena spuštění. settled.status je pending v okamžiku mezi výsledkem a vyúčtováním a no_usage ve vzácném případě, kdy model nenahlásil žádné využití (pak maximum zůstává cenou).

Nabídka před spuštěním#

POST https://api.doitong.ru/v1/quote/{model_id} přijímá přesně tělo, které byste poslali do run, a vrací cenu tohoto vstupu: přesnou cenu, s výjimkou modelu účtovaného podle využití, u kterého jde o nejvyšší možnou cenu spuštění. Nevyžaduje klíč a nic nestojí:

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

S klíčem nabídka vrací také balance_credits a balance_usd (váš zůstatek API), affordable a key_budget_remaining. Pro částku v rub přidejte ?currency=rub.

Objekty cen#

Každá cena v API má stejný tvar:

• 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" } — v Rusku nebo s ?currency=rub navíc rub, rub_display a from_rub;
• requests: cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 } (API kredity; požadavek metered navíc obsahuje mode, held, typical a settled, viz Účtování podle využití);
• account: GET https://api.doitong.ru/v1/account vrací credits (zůstatek API), balance: { "credits", "usd" } a storage (cenu úložiště souborů, využití a měsíční odhad).

Refundace#

• Neplatný požadavek (jakýkoli 4xx před zahájením spuštění) se nikdy neúčtuje.
• Požadavek, který skončí stavem failed (včetně timeout), se automaticky v plné výši refunduje do zůstatku API.
• Požadavek, který zrušíte před jeho zahájením, se refunduje v plné výši. Jakmile model začne generovat, zrušení je pouze požadavek: pokud model dokončí práci, výsledek se doručí a naúčtuje.
• Úspěšný požadavek metered získá zpět část svého maxima, kterou nevyužil.

Objekt požadavku zobrazuje vše: cost.credits, cost.charged a cost.refunded.

Úložiště souborů#

Výstupní soubory uchováváme v našem úložišti. Zvolíte ho v účtu nebo pro jednotlivé spuštění (?storage=):

Za trvalé úložiště se ze zůstatku API účtuje jednou denně: uchovávané GB × měsíční cena ÷ počet dní v měsíci, jako řádky účetní knihy druhu storage. Zlomky API kreditu se přenášejí do dalšího dne, takže za měsíc se přesně nasčítají na GB × 100 API kreditů (1 GB = 1024³ bajtů; 10 GB uchovávaných měsíc stojí 1 000 API kreditů). Zůstatek nikdy neklesne pod nulu: když nelze zaplatit, daný den se nic neúčtuje, dostanete e-mail a máte 30 dní na dobití, než se uchovávané soubory změní na dočasné a 7 dní poté se smažou. Podrobnosti: Soubory.

Aktuální ceny#

Toto jsou doporučené modely. Všech 1 496 modelů a jejich ceny jsou v katalogu modelů a v GET /models (klíč není potřeba).

Dobití#

Přidejte peníze do zůstatku API na adrese https://doitong.ru/developers/dashboard#balance. Když je zůstatek příliš nízký, spuštění odpoví 402 insufficient_credits s top_up_url. Každý API klíč lze také omezit vlastním rozpočtem v API kreditech (viz Autentizace).