dokumentace
Finance

Rezervace a stržení částky

Markdown

Jak 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_tokens v 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ů.

KrokVýpočetČástka
Skutečný vstup20 000 × $2 / 1 000 000$0.0400
Skutečná odpověď1 200 × $10 / 1 000 000$0.0120
Strženojedno 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_tokens a 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í.

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 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.

Máte další dotazy? Pošlete Request ID a popis – pomůžeme situaci objasnit.Napsat podpoře