docs
Pénzügyek

Zárolás és terhelés

Markdown

Hogyan számol az Ailoot: zárolás a kérés előtt, egy terhelés utána, és egyenleg, amely soha nem lesz negatív.

Röviden

  • Zárolás — az új szöveges kérés elküldése előtt az Ailoot a bemenet és egy tipikus válasz becsült költségét zárolja a kérés elfogadott feltételei szerint. Kép-, videó- és hangkimenet esetén továbbra is az eredmény teljes költségét zárolja.
  • Terhelés — egyszer, a tényleges használat alapján, a következő adatokból: usage. A zárolás fennmaradó része azonnal felszabadul.
  • Ha még a minimális zároláshoz sincs elegendő pénz — a kérést nem küldjük el a modellnek, Ön érthető szöveggel ellátott 402-es hibát kap. Nem történik terhelés.
Teljes útmutató

Röviden

  • Ár — dollárban, 1 millió bemeneti és kimeneti tokenre (vagy egységenként: kép, videómásodperc, karakterek). Az egyes modellek árai a katalógusban találhatók.
  • Zárolás — az új szöveges kérés elküldése előtt az Ailoot a bemenet és egy tipikus válasz becsült költségét zárolja a kérés elfogadott feltételei szerint. Kép-, videó- és hangkimenet esetén továbbra is az eredmény teljes költségét zárolja.
  • Elutasítás helyett alacsonyabb korlát — ha a kiszámított zárolandó összeget nem fedezi a rendelkezésre álló egyenleg vagy a kulcs kerete, a válaszkorlát csak olyan konkrét modell és metódus esetén csökkenthető, amelyek valóban betartják ezt a korlátot, és csak a fedezett szintig, az alkalmazandó minimum alá nem csökkentve. Az érintett modelleket alább ismertetjük.
  • Terhelés — egyszer, a tényleges használat alapján, a következő adatokból: usage. A zárolás fennmaradó része azonnal felszabadul.
  • Ha a válasz drágább a zárolt összegnél — a különbözet a más zárolások által nem foglalt szabad egyenlegből kerül levonásra. A terhelés soha nem haladja meg az egyenlegét: az egyenleg nem lesz negatív.
  • Ha még a minimális zároláshoz sincs elegendő pénz — a kérést nem küldjük el a modellnek, Ön érthető szöveggel ellátott 402-es hibát kap. Nem történik terhelés.
  • Az eredmény nélküli hiba nem díjköteles. Ha megszakadt a kapcsolat, az újbóli elküldés előtt ellenőrizze a kérést a Request ID alapján a fiók előzményeiben.

A zárolás kiszámítása

  • Bemenet esetén a zárolandó összeget a kérés méretének és a támogatott mellékleteknek a becslése alapján számítjuk ki, nem a már ismert tényleges felhasználásból. Az új szöveges kéréseknél a törzset és a mellékleteket a típusuknak megfelelően becsüljük meg. A „4 token bájtonként, de legalább 4096 token” számítás a korábban elfogadott, régi verziójú zárolásokra vonatkozik, nem az új szöveges zárolásokat írja le. Ha a melléklet hivatkozásként szerepel (fileData) vagy beépített eszközök vannak bekapcsolva, a támogatott szöveges kéréseknél a mellékleteket és az eszközök használatát külön becslés veszi figyelembe; pusztán a jelenlétük nem jelenti a teljes bemeneti ablakra történő zárolást. A korábbi zárolások elfogadott feltételei megmaradnak, médiakimenet esetén pedig a teljes eredmény költségét vesszük alapul.
  • Kimenet esetén az új szöveges kérés zárolásához a tipikus válaszhossz és az elfogadott feltételek alapján készül becslés. A kért korlát a következő paraméterrel adható meg: max_tokens (max_output_tokens Responses esetén). A kért korlát nem egyezik meg automatikusan a zárolandó összeg kiszámításához használt tokenszámmal, és nem garantálja a tényleges válaszhosszt olyan modellnél, amelynek hosszkorlátozása nem megbízható. A 4096-os alapérték csak a vonatkozó útvonalakra érvényes; a pontos szabály a modelltől és a metódustól függ.
  • Ár — a kérés ezen feltételeit figyelembe vevő új szöveges zárolásoknál a normál vagy prioritásos módot és a becsült bemenettel elérhető ársávokat vesszük figyelembe. A kiválasztott feltételeken belül a számítás továbbra is konzervatív; a flex mód nem csökkenti a zárolandó összeget. Prioritásos kérésnél a zárolás a legdrágább alkalmazandó módot is figyelembe veheti, beleértve a priority, flex vagy fast módot. A korábban, e feltételek nélkül elfogadott zárolások megtartják az eredeti, maximális díjakkal végzett számítást.
  • A korlát csökkentése — ha a kiszámított zárolandó összeg nem fér bele a rendelkezésre álló keretbe, és az adott modell és metódus lehetővé teszi a válasz korlátozását: a rendelkezésre álló pénznek fedeznie kell a becsült bemenetet és a minimális kimeneti mennyiséget. A csökkentett korlát nem lehet 256 tokennél alacsonyabb (Anthropic formátumú gondolkodás esetén 1025 tokennél). A modell már a csökkentett korlátot kapja.

Számítási példa

Modell claude-sonnet-5-5: bemenet $2, kimenet $10 1 millió tokenért. Ön 20 000 tokent küldött el, a modell 1 200 tokennel válaszolt.

LépésSzámításÖsszeg
Tényleges bemenet20 000 × $2 / 1 000 000$0.0400
Tényleges válasz1 200 × $10 / 1 000 000$0.0120
Terhelt összegegyszeri terhelés a tényleges használat alapján$0.0520

A bemutatott számtani példában a tényleges költség $0.0520. A feltüntetett terhelés azt feltételezi, hogy az elfogadott zárolt összeg és a rendelkezésre álló szabad egyenleg fedezi ezt a költséget. A zárolandó összeget itt nem számítjuk ki: új szöveges kérésnél azt külön, a bemenet és a tipikus válasz becslése alapján határozzuk meg, ezért lehet nagyobb vagy kisebb a tényleges költségnél. A fel nem használt zárolt összeg felszabadul; a terhelés korlátját az alábbi képlet mutatja.

Tényleges terhelés = min(teljes tényleges költség, elfogadott foglalás + szabad nem lefoglalt egyenleg). A többi nyitott zárolás védett marad; ezért a teljes egyenleg nem feltétlenül lesz nulla. Az egyenleg nem válik negatívvá. Ha a tényleges költség meghaladja az elfogadott zárolt összeg és a szabad, nem zárolt egyenleg együttesét, a fedezetlen különbözet az Ailoot vesztesége marad: nem válik az Ön tartozásává, és később sem követeljük Öntől.

A kliens kapcsolatának megszakadása

A kapcsolat bezárása, az alkalmazás időtúllépése vagy a már elkészült válasz olvasásának elutasítása nem szakítja meg automatikusan a kérést: a modell elkészült válasza egyszer díjköteles. Ha az eredményt az Ailoot hibájából nem kézbesítjük, a pénzt visszatérítjük. Ha megszakadt a kapcsolat, az újbóli elküldés előtt ellenőrizze a kérést a Request ID alapján a fiók előzményeiben.

Miért szükséges néha nagyobb egyenleg?

  • Az új szöveges kéréseknél a válaszra zárolandó összeg a tipikus válaszhossz alapján számítódik, figyelembe véve a megadott max_tokens értéket és az adott modell feltételeit. Ez a zárolandó összeg becslése, nem garancia a válasz tényleges hosszára vagy költségére.
  • Azoknál a modelleknél, amelyeknél a tényleges válaszhossz nem korlátozható megbízhatóan, a zárolandó összeg becslése nem jelent hosszkorlátot. Új szöveges kéréseknél ezt a becslést nem váltja fel automatikusan a leghosszabb válasz költsége. A korábban elfogadott zárolások eredeti feltételei megmaradnak.
  • A bemeneti képek becsült költsége növeli a zárolt összeget.
  • Az ügynökök (Claude Code, Codex CLI, Cline) minden lépésben nagy kontextust küldenek: egy lépés több tíz centet is zárolhat. Tartson legalább néhány dollárt az egyenlegén.
  • Tipp: ésszerű értéket adjon meg a következőhöz: max_tokens — ez csökkenti a zárolt összeget azoknál a modelleknél, amelyek válaszhossza korlátozható.

Promptok gyorsítótárazása

A gyorsítótárazást támogató modelleknél külön ára van a gyorsítótárba írásnak és a belőle olvasásnak. Az olvasás általában többször olcsóbb a normál bemenetnél. Az árak a katalógus modelladatlapján láthatók.

402-es hiba

Ha a szabad egyenleg még a minimális zárolást sem fedezi, az Ailoot nem küldi el a kérést, és 402-es választ ad ezzel a kóddal: insufficient_balance. Ha a kulcs teljes költési kerete kimerült, a kód: api_key_quota_exhausted. Ha a fiókon vitatott fizetésből származó tartozás van, a kód: payment_disputed: az új kérések a tartozás rendezéséig szünetelnek.

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

Hol láthatók a költségek?

A kérések és terhelések előzményei a fiókban érhetők el itt: ailoot.ai. Minden kérésnél látható a modell, a tokenek és az összeg.

Maradt kérdése? Küldje el a Request ID-t és a probléma leírását — segítünk tisztázni.Írjon a támogatásnak