Rezervace a stržení částky
MarkdownJak Ailoot účtuje: rezervace před požadavkem, jedno stržení po něm a zůstatek, který nikdy neklesne pod nulu.
Stručně
- Rezervace – před odesláním nového textového požadavku Ailoot rezervuje odhad nákladů na vstup a obvyklou odpověď podle přijatých podmínek požadavku. U obrázků, videa a zvuku na výstupu zůstává rezervována celá cena výsledku.
- Stržení částky – jedno, podle skutečné spotřeby z
usage. Zbytek rezervace se ihned vrátí. - Pokud prostředky nestačí ani na minimální rezervaci – požadavek se modelu neodešle, obdržíte chybu 402 se srozumitelným textem. Nic se nestrhne.
Úplný průvodce
Stručně
- Cena – v dolarech za 1 milion vstupních a výstupních tokenů (nebo za jednotku: obrázek, sekundu videa, znaky). Ceny jednotlivých modelů najdete v katalogu.
- Rezervace – před odesláním nového textového požadavku Ailoot rezervuje odhad nákladů na vstup a obvyklou odpověď podle přijatých podmínek požadavku. U obrázků, videa a zvuku na výstupu zůstává rezervována celá cena výsledku.
- Nižší limit místo odmítnutí – pokud se vypočtená rezervace nevejde do dostupného zůstatku nebo limitu klíče, lze limit odpovědi snížit pouze u konkrétního modelu a metody, které ho dodržují, a jen na zaplatitelný objem, který není nižší než příslušné minimum. Modely, u kterých to funguje, jsou uvedeny níže.
- Stržení částky – jedno, podle skutečné spotřeby z
usage. Zbytek rezervace se ihned vrátí. - Pokud je odpověď dražší než rezervace – rozdíl se strhne z volného zůstatku, který není blokován jinými rezervacemi. Stržená částka nikdy nepřesáhne váš zůstatek: zůstatek neklesne pod nulu.
- Pokud prostředky nestačí ani na minimální rezervaci – požadavek se modelu neodešle, obdržíte chybu 402 se srozumitelným textem. Nic se nestrhne.
- Selhání bez výsledku se neúčtuje. Pokud se spojení přerušilo, ověřte požadavek podle Request ID v historii uživatelského panelu, než jej znovu odešlete.
Jak se počítá rezervace
- Vstup se rezervuje podle odhadu velikosti požadavku a podporovaných příloh, nikoli podle již známé skutečné spotřeby. U nových textových požadavků se tělo požadavku a přílohy odhadují podle svého typu. Výpočet «4 tokeny na bajt, nejméně však 4096 tokenů» se týká dříve přijatých rezervací staré verze a nepopisuje nové textové rezervace. Pokud se příloha předává odkazem (
fileData) nebo jsou zapnuté vestavěné nástroje, u podporovaných textových požadavků se zohledňují samostatné odhady příloh a práce nástrojů; jejich samotná přítomnost neznamená rezervaci celého vstupního okna. Pro dřívější rezervace zůstávají v platnosti přijaté podmínky a u médií na výstupu se počítá cena celého výsledku. - Výstup – pro rezervaci nového textového požadavku se odhaduje podle obvyklé délky odpovědi a přijatých podmínek. Požadovaný limit se zadává prostřednictvím
max_tokens(max_output_tokensv Responses). Požadovaný limit se automaticky nerovná počtu tokenů použitému k výpočtu rezervace a u modelu bez spolehlivého omezení nezaručuje skutečnou délku odpovědi. Výchozí hodnota 4096 se používá pouze u příslušných tras; konkrétní pravidlo závisí na modelu a metodě. - Cena – při výpočtu nových textových rezervací se podle podmínek požadavku zohledňují standardní nebo prioritní režim a cenová pásma dosažitelná podle odhadu vstupu. V rámci zvolených podmínek zůstává výpočet konzervativní; režim flex rezervaci nesnižuje. U prioritního požadavku může rezervace zohlednit nejdražší použitelný režim, včetně priority, flex nebo fast. Dříve přijaté rezervace bez těchto podmínek si zachovávají původní výpočet podle nejvyšších sazeb.
- Snížení limitu – pokud se vypočtená rezervace nevejde do dostupných prostředků a konkrétní model i metoda umožňují omezit odpověď: prostředky musí pokrýt odhad vstupu a minimální objem výstupu. Snížený limit neklesá pod 256 tokenů (1025 při uvažování ve formátu Anthropic). Model dostává již snížený limit.
Příklad výpočtu
Model claude-sonnet-5-5: vstup $2, výstup $10 za 1 milion tokenů. Odeslali jste 20 000 tokenů, odpověď modelu obsahovala 1 200 tokenů.
| Krok | Výpočet | Částka |
|---|---|---|
| Skutečný vstup | 20 000 × $2 / 1 000 000 | $0.0400 |
| Skutečná odpověď | 1 200 × $10 / 1 000 000 | $0.0120 |
| Strženo | jedno stržení podle skutečné spotřeby | $0.0520 |
V uvedeném aritmetickém příkladu činí skutečné náklady $0.0520. Zobrazená stržená částka předpokládá, že tyto náklady pokryje přijatá rezervace spolu s dostupným volným zůstatkem. Výše rezervace se zde nepočítá: pro nový textový požadavek se stanovuje samostatně podle odhadu vstupu a obvyklé odpovědi a může být vyšší nebo nižší než skutečné náklady. Nevyužitá rezervace se uvolní; omezení stržené částky uvádí následující vzorec.
Skutečné stržení = min(celkové skutečné náklady, přijatá rezervace + volný nerezervovaný zůstatek). Ostatní otevřené rezervace zůstávají chráněné, takže celkový zůstatek nemusí klesnout na nulu. Zůstatek neklesá pod nulu. Pokud skutečné náklady převýší součet přijaté rezervace a volného nezarezervovaného zůstatku, nekrytý rozdíl zůstává ztrátou Ailoot: nestává se vaším dluhem a později se nevymáhá.
Odpojení klienta
Uzavření spojení, vypršení časového limitu vaší aplikace nebo odmítnutí přečíst již hotovou odpověď požadavek automaticky nezruší: hotová odpověď modelu se účtuje jednou. Pokud výsledek není doručen vinou Ailoot, prostředky se vrátí. Pokud se spojení přerušilo, ověřte požadavek podle Request ID v historii uživatelského panelu, než jej znovu odešlete.
Proč je někdy potřeba vyšší zůstatek
- U nových textových požadavků se rezervace na odpověď počítá podle její obvyklé délky, s přihlédnutím k zadané hodnotě parametru
max_tokensa k podmínkám konkrétního modelu. Jde o odhad rezervace, nikoli o záruku skutečné délky nebo ceny odpovědi. - U modelů bez spolehlivého omezení skutečné délky odpovědi se odhad rezervace nestává omezením délky. U nových textových požadavků se automaticky nenahrazuje cenou nejdelší možné odpovědi. Dříve přijaté rezervace si zachovávají původní podmínky.
- Vstupní obrázky přidávají k rezervaci odhad své ceny.
- Agenti (Claude Code, Codex CLI, Cline) posílají v každém kroku velký kontext: jeden krok může rezervovat desítky centů. Ponechte na zůstatku alespoň několik dolarů.
- Tip: nastavte rozumný
max_tokens– tím se u modelů, u kterých lze délku odpovědi omezit, sníží rezervace.
Mezipaměť promptů
Modely podporující mezipaměť mají samostatné ceny pro zápis do mezipaměti a čtení z ní. Čtení je obvykle několikanásobně levnější než běžný vstup. Ceny jsou uvedeny na kartě modelu v katalogu.
Chyba 402
Pokud volný zůstatek nestačí ani na minimální rezervaci, Ailoot požadavek neodešle a vrátí 402 s kódem insufficient_balance. Pokud je vyčerpán celkový výdajový limit klíče – kód api_key_quota_exhausted. Pokud má účet dluh v důsledku zpochybněné platby – kód payment_disputed: nové požadavky jsou pozastaveny do jeho uhrazení.
{
"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 sledovat náklady
Historie požadavků a stržených částek je v uživatelském panelu na ailoot.ai. U každého požadavku je vidět model, tokeny a částka.