dokumentácia
Financie

Rezervácia a účtovanie

Markdown

Ako Ailoot počíta peniaze: rezervácia pred požiadavkou, jedno zaúčtovanie po nej a zostatok, ktorý nikdy neklesne pod nulu.

Stručne

  • Rezervácia – pred odoslaním novej textovej požiadavky Ailoot rezervuje odhadovanú cenu vstupu a typickej odpovede podľa prijatých podmienok požiadavky. Pri obrázkoch, videu a zvuku na výstupe sa naďalej rezervuje plná cena výsledku.
  • Zaúčtovanie – jednorazové, podľa skutočnej spotreby z usage. Zvyšok rezervácie sa okamžite uvoľní.
  • Ak prostriedky nestačia ani na minimálnu rezerváciu – požiadavka sa neodošle modelu a dostanete chybu 402 so zrozumiteľným textom. Nič sa nezaúčtuje.
Úplný sprievodca

Stručne

  • Cena – v dolároch za 1 milión vstupných a výstupných tokenov (alebo za jednotku: obrázok, sekundu videa, znaky). Ceny každého modelu nájdete v katalógu.
  • Rezervácia – pred odoslaním novej textovej požiadavky Ailoot rezervuje odhadovanú cenu vstupu a typickej odpovede podľa prijatých podmienok požiadavky. Pri obrázkoch, videu a zvuku na výstupe sa naďalej rezervuje plná cena výsledku.
  • Nižší limit namiesto odmietnutia – ak sa vypočítaná rezervácia nezmestí do dostupného zostatku alebo limitu kľúča, limit odpovede možno znížiť iba pri konkrétnom modeli a metóde, ktoré ho dodržiavajú, a len na objem, ktorý možno zaplatiť, nie však pod príslušné minimum. Pri ktorých modeloch to funguje – nižšie.
  • Zaúčtovanie – jednorazové, podľa skutočnej spotreby z usage. Zvyšok rezervácie sa okamžite uvoľní.
  • Ak je odpoveď drahšia než rezervácia – rozdiel sa odpočíta z voľného zostatku, ktorý nie je viazaný inými rezerváciami. Zaúčtovaná suma nikdy neprekročí váš zostatok: zostatok neklesne pod nulu.
  • Ak prostriedky nestačia ani na minimálnu rezerváciu – požiadavka sa neodošle modelu a dostanete chybu 402 so zrozumiteľným textom. Nič sa nezaúčtuje.
  • Zlyhanie bez výsledku sa neúčtuje. Ak sa spojenie prerušilo, pred opätovným odoslaním overte požiadavku podľa Request ID v histórii účtu.

Ako sa počíta rezervácia

  • Vstup sa rezervuje podľa odhadu veľkosti požiadavky a podporovaných príloh, nie podľa už známej skutočnej spotreby. Pri nových textových požiadavkách sa telo požiadavky a prílohy odhadujú podľa svojho typu. Výpočet „4 tokeny na bajt, najmenej však 4096 tokenov“ sa týka predtým prijatých rezervácií starej verzie a neopisuje nové textové rezervácie. Ak je príloha odovzdaná odkazom (fileData) alebo sú zapnuté vstavané nástroje, pri podporovaných textových požiadavkách sa prílohy a práca nástrojov odhadujú samostatne; samotná ich prítomnosť neznamená rezerváciu celého vstupného okna. Pre staršie rezervácie zostávajú v platnosti prijaté podmienky a pri médiách na výstupe sa naďalej počíta cena celého výsledku.
  • Výstup sa pri rezervácii novej textovej požiadavky odhaduje podľa typickej dĺžky odpovede a prijatých podmienok. Požadovaný limit sa nastavuje cez max_tokens (max_output_tokens v Responses). Požadovaný limit sa automaticky nerovná počtu tokenov, z ktorého sa vypočítala rezervácia, a pri modeli bez spoľahlivého obmedzenia nezaručuje skutočnú dĺžku odpovede. Východisková hodnota 4096 sa používa iba pri príslušných trasách; konkrétne pravidlo závisí od modelu a metódy.
  • Cena sa pri nových textových rezerváciách počíta s prihliadnutím na podmienky danej požiadavky: štandardný alebo prioritný režim a cenové pásma, ktoré môže dosiahnuť odhadovaný vstup. V rámci zvolených podmienok zostáva výpočet konzervatívny; režim flex rezerváciu neznižuje. Pri prioritnej požiadavke môže rezervácia zohľadniť najdrahší použiteľný režim vrátane priority, flex alebo fast. Predtým prijaté rezervácie bez týchto podmienok si zachovávajú pôvodný výpočet podľa najvyšších sadzieb.
  • Zníženie limitu – keď sa vypočítaná rezervácia nezmestí do dostupných prostriedkov a konkrétny model aj metóda umožňujú obmedziť odpoveď: dostupné prostriedky musia stačiť na odhad vstupu a minimálny objem výstupu. Znížený limit neklesá pod 256 tokenov (1025 pri uvažovaní vo formáte Anthropic). Model dostane už znížený limit.

Príklad výpočtu

Model claude-sonnet-5-5: vstup $2, výstup $10 za 1 milión tokenov. Odoslali ste 20 000 tokenov, model odpovedal 1 200 tokenmi.

KrokVýpočetSuma
Skutočný vstup20 000 × $2 / 1 000 000$0.0400
Skutočná odpoveď1 200 × $10 / 1 000 000$0.0120
Zaúčtovanéjedno zaúčtovanie podľa skutočnej spotreby$0.0520

V uvedenom aritmetickom príklade je skutočná cena $0.0520. Zobrazený odpis predpokladá, že prijatá rezervácia a dostupný voľný zostatok túto cenu pokryjú. Výška rezervácie sa tu nepočíta: pri novej textovej požiadavke sa určuje samostatne podľa odhadu vstupu a typickej odpovede a môže byť vyššia alebo nižšia než skutočná cena. Nepoužitá rezervácia sa uvoľní; obmedzenie odpisu je uvedené v nasledujúcom vzorci.

Skutočne zaúčtovaná suma = min(celkové skutočné náklady, prijatá rezervácia + voľný nerezervovaný zostatok). Ostatné otvorené rezervácie zostávajú chránené, takže celkový zostatok nemusí klesnúť na nulu. Zostatok sa nestáva záporným. Ak skutočná cena presiahne súčet prijatej rezervácie a voľného nezarezervovaného zostatku, nepokrytý rozdiel zostáva stratou Ailoot: nestáva sa vaším dlhom a nebude sa od vás vymáhať neskôr.

Odpojenie klienta

Zatvorenie spojenia, časový limit vašej aplikácie alebo odmietnutie čítať už hotovú odpoveď automaticky nerušia požiadavku: hotová odpoveď modelu sa účtuje raz. Ak výsledok nebol doručený vinou Ailoot, peniaze sa vrátia. Ak sa spojenie prerušilo, pred opätovným odoslaním overte požiadavku podľa Request ID v histórii účtu.

Prečo je niekedy potrebný vyšší zostatok

  • Pri nových textových požiadavkách sa rezervácia na odpoveď počíta podľa typickej dĺžky s prihliadnutím na zadaný max_tokens a podmienky konkrétneho modelu. Ide o odhad rezervácie, nie o záruku skutočnej dĺžky ani ceny odpovede.
  • Pri modeloch bez spoľahlivého limitu skutočnej odpovede odhad rezervácie nepredstavuje obmedzenie dĺžky. Pri nových textových požiadavkách sa automaticky nenahrádza cenou najdlhšej odpovede. Predtým prijaté rezervácie si zachovávajú pôvodné podmienky.
  • Obrázky na vstupe zvyšujú rezerváciu o odhad ich ceny.
  • Agenti (Claude Code, Codex CLI, Cline) posielajú v každom kroku veľký kontext: jeden krok môže rezervovať desiatky centov. Nechajte si na účte aspoň niekoľko dolárov.
  • Tip: nastavujte primeraný max_tokens – znížite tým rezerváciu pri modeloch, ktorým možno obmedziť dĺžku odpovede.

Cache promptov

Modely s cache majú samostatné ceny za zápis do cache a čítanie z nej. Čítanie je zvyčajne niekoľkonásobne lacnejšie než bežný vstup. Ceny nájdete na karte modelu v katalógu.

Chyba 402

Ak voľný zostatok nestačí ani na minimálnu rezerváciu, Ailoot požiadavku neodošle a odpovie chybou 402 s kódom insufficient_balance. Ak je vyčerpaný celkový limit výdavkov kľúča, kód je api_key_quota_exhausted. Ak má účet dlh z napadnutej platby, kód je payment_disputed: nové požiadavky sú pozastavené až do jeho úhrady.

402 Payment Required
{
  "error": {
    "code": "insufficient_balance",
    "reason": "insufficient_balance",
    "type": "insufficient_quota",
    "param": null,
    "message": "Your balance is too low to start this request. … Request ID: 5c0e7a1d-….",
    "request_id": "5c0e7a1d-…"
  }
}

Kde si pozrieť výdavky

História požiadaviek a zaúčtovaní je v používateľskom účte na ailoot.ai. Pri každej požiadavke vidíte model, tokeny a sumu.

Máte ďalšie otázky? Pošlite Request ID a opis problému – pomôžeme vám ho vyriešiť.Napísať podpore