docs
Қаражат

Резерв және есептен шығару

Markdown

Ailoot қаражатты қалай есептейді: сұрау алдында резерв, одан кейін бір рет есептен шығару және ешқашан теріс болмайтын баланс.

Қысқаша

  • Резерв — жаңа мәтіндік сұрауды жіберер алдында Ailoot қабылданған сұрау шарттарына сай кіріс пен әдеттегі жауаптың бағаланған құнын резервтейді. Шығыстағы суреттер, бейне және дыбыс үшін нәтиже құнының толық резерві сақталады.
  • Есептен шығару — бір рет, мына деректегі нақты шығын бойынша: usage. Резервтің қалдығы бірден қайтарылады.
  • Ең аз резервке де қаражат жетпесе — сұрау модельге жіберілмейді, сіз түсінікті мәтіні бар 402 қатесін аласыз. Ештеңе есептен шығарылмайды.
Толық нұсқаулық

Қысқаша

  • Баға — кіріс пен шығыстың 1 млн токені үшін доллармен (немесе бірлік үшін: сурет, бейне секунды, таңбалар). Әр модельдің бағасы мына жерде: каталогта.
  • Резерв — жаңа мәтіндік сұрауды жіберер алдында Ailoot қабылданған сұрау шарттарына сай кіріс пен әдеттегі жауаптың бағаланған құнын резервтейді. Шығыстағы суреттер, бейне және дыбыс үшін нәтиже құнының толық резерві сақталады.
  • Бас тартудың орнына төменірек лимит — есептелген резерв бос балансқа немесе кілт лимитіне сыймаса, жауап лимитін оны сақтайтын нақты модель мен әдісте ғана, әрі қолданылатын ең аз мөлшерден төмен түспейтін, төлеуге болатын көлемге дейін ғана азайтуға болады. Бұл қай модельдерде жұмыс істейтіні — төменде.
  • Есептен шығару — бір рет, мына деректегі нақты шығын бойынша: usage. Резервтің қалдығы бірден қайтарылады.
  • Жауап резервтен қымбат болса — айырмасы басқа резервтерге бөлінбеген бос баланстан алынады. Есептен шығару балансыңыздан ешқашан аспайды: баланс теріс болмайды.
  • Ең аз резервке де қаражат жетпесе — сұрау модельге жіберілмейді, сіз түсінікті мәтіні бар 402 қатесін аласыз. Ештеңе есептен шығарылмайды.
  • Нәтижесіз ақауға ақы алынбайды. Байланыс үзілсе, сұрауды қайта жібермес бұрын оны жеке кабинет тарихынан Request ID бойынша тексеріңіз.

Резерв қалай есептеледі

  • Кіріс сұрау мен қолдау көрсетілетін тіркемелердің мөлшерін бағалау негізінде резервтеледі, бұрыннан белгілі нақты шығын бойынша емес. Жаңа мәтіндік сұраулар үшін сұрау денесі мен тіркемелер түріне қарай бағаланады. «Байтқа 4 токен, бірақ кемінде 4096 токен» есебі бұрын қабылданған ескі нұсқадағы резервтерге қатысты және жаңа мәтіндік резервтерді сипаттамайды. Тіркеме сілтемемен берілсе (fileData) немесе кіріктірілген құралдар қосылса, қолдау көрсетілетін мәтіндік сұрауларда тіркемелер мен құралдар жұмысының бөлек бағалауы ескеріледі; олардың болуының өзі бүкіл кіріс терезесіне резерв жасауды білдірмейді. Бұрынғы резервтердің қабылданған шарттары сақталады, ал шығыстағы медиа үшін толық нәтиже құны есептеледі.
  • Шығыс жаңа мәтіндік сұраудың резерві үшін әдеттегі жауап ұзындығы мен қабылданған шарттар бойынша бағаланады. Сұралған лимит мына параметр арқылы беріледі max_tokens (max_output_tokens Responses форматында). Сұралған лимит резерв есептелген токен санына автоматты түрде тең болмайды және сенімді шектеуі жоқ модельде жауаптың нақты ұзындығына кепілдік бермейді. Бастапқы 4096 мәні тек тиісті маршруттарға қолданылады; нақты қағида модель мен әдіске байланысты.
  • Баға жаңа мәтіндік резервтер үшін осы сұраудың мына шарттарына негізделеді: стандартты немесе басымдық берілген режим және кіріс бағалауына қарай қолжетімді баға сатылары. Таңдалған шарттар аясында есептеу сақтықпен жүргізіледі; flex режимі резервті азайтпайды. Басымдық берілген сұрау үшін резерв ең қымбат қолданылатын режимді, соның ішінде priority, flex немесе fast режимдерін ескеруі мүмкін. Бұл шарттарсыз бұрын қабылданған резервтер ең жоғары мөлшерлемелер бойынша бастапқы есептеуін сақтайды.
  • Лимитті азайту — есептелген резерв сыймай, нақты модель мен әдіс жауапты шектеуге мүмкіндік бергенде: қолжетімді қаражат кірістің бағаланған құны мен шығыстың ең аз көлеміне жетуі тиіс. Азайтылған лимит 256 токеннен төмен түспейді (1025 — Anthropic форматында пайымдау қолданылғанда). Модельге азайтылған лимит беріледі.

Есептеу мысалы

Модель claude-sonnet-5-5: кіріс үшін $2, шығыс үшін $10 — 1 млн токенге. Сіз 20 000 токен жібердіңіз, модель 1 200 токенмен жауап берді.

ҚадамЕсептеуСома
Нақты кіріс20 000 × $2 / 1 000 000$0.0400
Нақты жауап1 200 × $10 / 1 000 000$0.0120
Есептен шығарылдынақты шығын бойынша бір рет есептен шығару$0.0520

Келтірілген арифметикалық мысалда нақты құн $0.0520 құрайды. Көрсетілген есептен шығару қабылданған резерв пен қолжетімді бос баланс осы құнды жабады деген шартқа сүйенеді. Мұнда резерв мөлшері есептелмейді: жаңа мәтіндік сұрау үшін ол кіріс пен әдеттегі жауап бағалауына қарай бөлек айқындалады және нақты құннан жоғары да, төмен де болуы мүмкін. Резервтің пайдаланылмаған бөлігі босатылады; есептен шығару шегі төмендегі формулада берілген.

Нақты есептен шығару = min(толық нақты құн, қабылданған резерв + бос резервтелмеген баланс). Басқа ашық резервтер қорғалған күйінде қалады; сондықтан жалпы баланс нөлге тең болмауы да мүмкін. Баланс теріс мәнге түспейді. Егер нақты құн қабылданған резерв пен бос, резервтелмеген баланстың қосындысынан асып кетсе, жабылмаған айырма Ailoot-тың залалы болып қалады: ол сіздің берешегіңізге айналмайды және кейін өндіріп алынбайды.

Клиенттің ажырауы

Қосылымды жабу, қолданбаңыздың күту уақытының бітуі немесе дайын жауапты оқудан бас тарту сұрауды автоматты түрде болдырмайды: модельдің дайын жауабына бір рет ақы алынады. Нәтиже Ailoot кінәсінен жеткізілмесе, қаражат қайтарылады. Байланыс үзілсе, сұрауды қайта жібермес бұрын оны жеке кабинет тарихынан Request ID бойынша тексеріңіз.

Кейде неге көбірек баланс қажет

  • Жаңа мәтіндік сұраулар үшін жауап резервін әдеттегі ұзындыққа қарай есептегенде берілген max_tokens және нақты модельдің шарттары ескеріледі. Бұл — резерв бағалауы; ол жауаптың нақты ұзындығына немесе құнына кепілдік бермейді.
  • Жауаптың нақты ұзындығын сенімді шектеу мүмкін емес модельдерде резерв бағалауы ұзындық шектеуі болып саналмайды. Жаңа мәтіндік сұрауларда ол автоматты түрде ең ұзын жауаптың құнымен алмастырылмайды. Бұрын қабылданған резервтер бастапқы шарттарын сақтайды.
  • Кірістегі суреттердің бағаланған құны резервке қосылады.
  • Агенттер (Claude Code, Codex CLI, Cline) әр қадамда үлкен контекст жібереді: бір қадам бірнеше ондаған центті резервтеуі мүмкін. Баланста кемінде бірнеше доллар ұстаңыз.
  • Кеңес: орынды мәнін беріңіз: max_tokens — бұл жауап ұзындығын шектеуге болатын модельдерде резервті азайтады.

Промпт кэші

Кэштеуі бар модельдерде кэшке жазу мен кэштен оқудың бағалары бөлек. Оқу әдетте кәдімгі кірістен бірнеше есе арзан. Бағалар каталогтағы модель карточкасында көрінеді.

402 қатесі

Бос баланс ең аз резервке де жетпесе, Ailoot сұрауды жібермейді және 402 кодымен, мына қате кодымен жауап береді: insufficient_balance. Кілттің жалпы шығын лимиті біткен болса — мына код: api_key_quota_exhausted. Аккаунтта дауланған төлем бойынша қарыз болса — мына код: payment_disputed: жаңа сұраулар қарыз өтелгенше тоқтатылады.

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

Шығындарды қайдан көруге болады

Сұраулар мен есептен шығару тарихы — жеке кабинетте, мына сайтта: ailoot.ai. Әр сұрау үшін модель, токендер және сома көрінеді.

Сұрақтарыңыз қалды ма? Request ID мен сипаттаманы жіберіңіз — мәселені анықтауға көмектесеміз.Қолдау қызметіне жазу