Rezervacija in bremenitev

• Cena – v dolarjih za 1 milijon vhodnih in izhodnih žetonov (ali na enoto: sliko, sekundo videa, znake). Cene posameznih modelov najdete v katalogu.
• Rezervacija – pred pošiljanjem nove besedilne zahteve Ailoot rezervira sredstva glede na oceno vhoda in tipičnega odgovora v skladu s sprejetimi pogoji zahteve. Pri slikah, videu in zvoku na izhodu ostaja rezerviran celotni strošek rezultata.
• Nižja omejitev namesto zavrnitve – če izračunana rezervacija presega razpoložljivo stanje ali omejitev ključa, se omejitev odgovora lahko zniža samo pri točno določenem modelu in metodi, ki jo upoštevata, in le do obsega, ki ga razpoložljiva sredstva pokrijejo, ne pa pod veljavni minimum. Pri katerih modelih to deluje, je navedeno spodaj.
• Bremenitev – enkratna, glede na dejansko porabo iz usage. Preostanek rezervacije se takoj sprosti.
• Če je odgovor dražji od rezervacije – razlika se pokrije iz prostih sredstev, ki niso zajeta v drugih rezervacijah. Bremenitev nikoli ne preseže vašega stanja: stanje ne postane negativno.
• Če sredstev ni dovolj niti za najmanjšo rezervacijo – zahteva se ne pošlje modelu, prejmete napako 402 z razumljivim besedilom. Nič se ne bremeni.
• Napaka brez rezultata se ne obračuna. Če se povezava prekine, pred ponovno pošiljko preverite zahtevo po Request ID v zgodovini nadzorne plošče.

• Vhod se rezervira glede na oceno velikosti zahteve in podprtih prilog, ne glede na že znano dejansko porabo. Pri novih besedilnih zahtevah se glede na vrsto oceni telo zahteve in priloge. Izračun »4 žetoni na bajt, vendar najmanj 4096 žetonov« se nanaša na predhodno sprejete rezervacije stare različice in ne opisuje novih besedilnih rezervacij. Če je priloga podana s povezavo (fileData) ali so omogočena vgrajena orodja, se pri podprtih besedilnih zahtevah upoštevajo ločene ocene prilog in delovanja orodij; že sama njihova prisotnost ne pomeni rezervacije celotnega vhodnega okna. Za prejšnje rezervacije ostajajo v veljavi sprejeti pogoji, za medije na izhodu pa izračun celotnega rezultata.
• Izhod se za rezervacijo nove besedilne zahteve oceni glede na tipično dolžino odgovora in sprejete pogoje. Zahtevana omejitev se nastavi s parametrom max_tokens (max_output_tokens pri Responses). Zahtevana omejitev ni samodejno enaka številu žetonov, na podlagi katerega se izračuna rezervacija, in pri modelu brez zanesljive omejitve ne zagotavlja dejanske dolžine odgovora. Začetna vrednost 4096 velja le za ustrezne poti; natančno pravilo je odvisno od modela in metode.
• Cena pri novih besedilnih rezervacijah upošteva pogoje dane zahteve: standardni ali prednostni način ter cenovne stopnje, dosegljive glede na oceno vhoda. Znotraj izbranih pogojev ostaja izračun konservativen; način flex ne zmanjša rezervacije. Pri prednostni zahtevi lahko rezervacija upošteva najdražji veljavni način, vključno s priority, flex ali fast. Predhodno sprejete rezervacije brez teh pogojev ohranijo prvotni izračun po najvišjih cenah.
• Znižanje omejitve – kadar izračunana rezervacija presega razpoložljiva sredstva, točno določeni model in metoda pa omogočata omejitev odgovora: sredstva morajo zadoščati za oceno vhoda in najmanjši obseg izhoda. Znižana omejitev ne pade pod 256 žetonov (1025 – z razmišljanjem v formatu Anthropic). Model prejme že znižano omejitev.

Model claude-sonnet-5-5: vhod $2, izhod $10 za 1 milijon žetonov. Poslali ste 20 000 žetonov, model pa je odgovoril z 1 200 žetoni.

V navedenem računskem primeru je dejanski strošek $0.0520. Prikazana bremenitev predpostavlja, da sprejeta rezervacija in razpoložljiva prosta sredstva pokrijejo ta strošek. Znesek rezervacije tu ni izračunan: za novo besedilno zahtevo se določi posebej na podlagi ocene vhoda in tipičnega odgovora ter je lahko višji ali nižji od dejanskega stroška. Neporabljena rezervacija se sprosti; omejitev bremenitve je navedena v spodnji formuli.

Dejanska bremenitev = min(celotni dejanski strošek, sprejeta rezervacija + prosto nerezervirano stanje). Druge odprte rezervacije ostanejo zaščitene; zato skupno stanje ne bo nujno ničelno. Stanje ne postane negativno. Če dejanski strošek preseže sprejeto rezervacijo in prosta nerezervirana sredstva, nepokrita razlika ostane izguba Ailoot: ne postane vaš dolg in se pozneje ne izterja.

Zaprtje povezave, časovna omejitev vaše aplikacije ali zavrnitev branja že pripravljenega odgovora ne prekličejo zahteve samodejno: pripravljen odgovor modela se obračuna enkrat. Če rezultat ni dostavljen po krivdi Ailoot, se sredstva vrnejo. Če se povezava prekine, pred ponovno pošiljko preverite zahtevo po Request ID v zgodovini nadzorne plošče.

• Pri novih besedilnih zahtevah se rezervacija za odgovor izračuna glede na njegovo tipično dolžino, ob upoštevanju nastavitve max_tokens in pogojev točno določenega modela. To je ocena rezervacije, ne jamstvo za dejansko dolžino ali strošek odgovora.
• Pri modelih brez zanesljive omejitve dejanske dolžine odgovora ocena rezervacije ne pomeni omejitve dolžine. Pri novih besedilnih zahtevah se ta ocena ne nadomesti samodejno s stroškom najdaljšega odgovora. Predhodno sprejete rezervacije ohranijo svoje prvotne pogoje.
• Slike na vhodu k rezervaciji dodajo oceno svojih stroškov.
• Agenti (Claude Code, Codex CLI, Cline) pri vsakem koraku pošljejo velik kontekst: posamezen korak lahko rezervira več deset centov. Na računu imejte vsaj nekaj dolarjev.
• Nasvet: nastavite razumen max_tokens – to zmanjša rezervacijo pri modelih, pri katerih je dolžino odgovora mogoče omejiti.

Modeli s predpomnjenjem imajo ločene cene za zapisovanje v predpomnilnik in branje iz njega. Branje je običajno večkrat cenejše od običajnega vhoda. Cene so prikazane na kartici modela v katalogu.

Če prostih sredstev ni dovolj niti za najmanjšo rezervacijo, Ailoot zahteve ne pošlje in odgovori s 402 ter kodo insufficient_balance. Če je izčrpana skupna omejitev porabe ključa – koda api_key_quota_exhausted. Če ima račun dolg zaradi izpodbijanega plačila – koda payment_disputed: nove zahteve so začasno ustavljene do njegove poravnave.

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

Zgodovina zahtev in bremenitev je na nadzorni plošči na ailoot.ai. Pri vsaki zahtevi so prikazani model, žetoni in znesek.