Source: https://ailoot.ai/docs/kk/how-it-works/ Canonical: https://ailoot.ai/docs/kk/how-it-works/ Language: kk [Бастау](https://ailoot.ai/docs/kk/) # Бұл қалай жұмыс істейді [Markdown](https://ailoot.ai/docs/kk/how-it-works/index.md) Бағдарламаңыз бен модель арасында сұрауға не болады. Сұрауды Ailoot API-іне OpenAI, Anthropic немесе Google-ге тікелей жібергендей жібересіз. Ailoot кілт пен балансты тексереді, сұрауды модельге береді, жауапты сол форматта қайтарады және нақты шығын бойынша қаражатты есептен шығарады. 01СұрауКлиентіңіз api.ailoot.ai мекенжайына sk-… кілтімен сұрау жібереді 02Тексеру және резервКілт, лимиттер, баланс. Жауап дайындалғанша сома резервтеледі. 03МодельМодель жауап береді, жауап сіздің форматыңызда қайтарылады. 04Есептен шығаруНақты токендер бойынша бір рет есептен шығару; резервтің қалдығы босатылады. ## [](https://ailoot.ai/docs/kk/how-it-works/#formats)Бір кілт — үш формат Форматты модель емес, сұрау жолы анықтайды. Бір Claude моделін OpenAI Chat, OpenAI Responses немесе Anthropic Messages арқылы шақыруға болады — жауап шақырған жолдың форматында келеді. | Формат | Жол | Оны кім қолданады | | --- | --- | --- | | OpenAI Chat Completions | `/v1/chat/completions` | OpenAI SDK, чаттар мен редакторлардың көбі, n8n, LangChain | | OpenAI Responses | `/v1/responses` | Codex CLI, OpenAI Agents SDK, SDK-ның жаңа нұсқалары | | Anthropic Messages | `/v1/messages` | Claude Code, Anthropic SDK, Zed, Cline | | Gemini | `/v1beta/models/{model}:generateContent` | Gemini CLI, Google GenAI SDK | ## [](https://ailoot.ai/docs/kk/how-it-works/#money)Қаражат: резерв және бір рет есептен шығару - Жаңа мәтіндік сұрауды жіберер алдында Ailoot кіріс пен әдеттегі жауаптың бағаланған құнын резервтейді; есептеу кезінде лимит (`max_tokens`) және нақты модельдің шарттары ескеріледі. Резерв бос балансқа немесе кілт лимитіне сыймаса, жіберілетін лимитті оны шынымен сақтайтын модель мен әдісте ғана азайтуға болады; ол 256 токеннен және жауаптың белгіленген ең аз мөлшерінен төмен түспейді. Шығыстағы суреттер, бейне және дыбыс үшін нәтиже құнының толық резерві сақталады. - Жауаптан кейін — нақты шығын бойынша бір рет есептен шығару. Пайдаланылмаған резерв балансқа бірден қайтарылады. - Жауап резервтен қымбат болса, айырмасы бос баланстан алынады. Баланс ешқашан теріс болмайды. - Ең аз резервке де қаражат жетпесе, сұрау жіберілмейді: түсінікті 402 қатесін аласыз, ештеңе есептен шығарылмайды. - Нәтижесіз аяқталған қатеге ақы алынбайды. Толық мәлімет пен есептеу мысалы — мына бетте: [Резерв және есептен шығару](https://ailoot.ai/docs/kk/billing/reserve/). ## [](https://ailoot.ai/docs/kk/how-it-works/#errors)Request ID бар қателер Әр жауап сұрау идентификаторын алады: мына тақырыпта: `X-Request-ID` және қате мәтінінде. Қателер шақырған форматтың JSON түрінде келеді, сондықтан SDK оларды дұрыс таниды. Бірдеңе дұрыс болмаса, Request ID-ді мына қызметке жіберіңіз: [қолдау қызметіне](https://ailoot.ai/docs/kk/support/) — сонда сұрауды бір минутта табамыз. 401 Unauthorized ```json { "code": "API_KEY_REQUIRED", "error": { "code": "invalid_api_key", "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer \". Request ID: 3b28d3de-5b02-4d07-9f3c-4b9a7d0e68d6.", "param": null, "reason": "invalid_api_key", "request_id": "3b28d3de-5b02-4d07-9f3c-4b9a7d0e68d6", "type": "invalid_request_error" }, "message": "No API key was sent with the request. Nothing was charged. …" } ``` ## [](https://ailoot.ai/docs/kk/how-it-works/#streaming)Ағын және күту уақыты Ағындық жауаптар (`stream: true`) Server-Sent Events түрінде келеді. Ailoot ақылы мәтіндік жауапты құны есептелгеннен кейін береді. Сондықтан мына параметрмен: `stream: true` формат ағындық (SSE) болып қалады, бірақ мәтін жеке сөздермен біртіндеп емес, модель аяқтағанда бір блокпен келеді. Жауап шамамен 15 секундтан ұзақ дайындалса, Chat Completions, Responses және Messages ағындарында алдымен мына қызметтік жолдар келеді: `: ping` (шамамен әр 10 секунд сайын), содан кейін мына жол: `: ailoot-charged-usd …` есептен шығарылған сомамен және деректердің өзімен келеді. SDK мұндай жолдарды өткізіп жібереді. Gemini форматында қызметтік жолдар жоқ: мына жауап: `:streamGenerateContent` есептеуден кейін толық келеді. Пайымдайтын модельдерге клиенттің күту уақытын жеткілікті қорымен орнатыңыз: бірнеше минут — қалыпты жағдай. ## [](https://ailoot.ai/docs/kk/how-it-works/#headers)Жауап тақырыптары `X-Request-ID` әр жауапта келеді. Қалған тақырыптарды Ailoot ақылы мәтіндік жауаптарға қосады: | Тақырып | Ішіндегі мәлімет | | --- | --- | | `X-Request-ID` | Сұрау идентификаторы — оны қолдау қызметі сұрайды | | `X-Ailoot-Charged-USD` | Осы сұрау үшін доллармен есептен шығарылған сома | | `X-Ailoot-Output-Tokens` | Жауаптың қанша токеніне ақы төленді | | `X-Ailoot-Max-Tokens-Capped` | Толық резервке баланс жетпегендіктен азайтылған жауап лимиті | | `X-Ailoot-Notice-Code`, `X-Ailoot-Notice` | Жауап ұзындық лимитінде тоқтаса, түсіндірме | Ағын қызметтік жолдармен басталып кеткен болса, бұл мәліметтер тақырыппен емес, деректер алдындағы түсініктеме жолымен келеді. ## [](https://ailoot.ai/docs/kk/how-it-works/#cache)Промпт кэші Модель кэштеуді қолдаса, қайта жіберілген ұзын префикс (жүйелік нұсқау, құжаттар) арзанырақ болуы мүмкін. Кэшті оқу және жазу бағалары мына жердегі модель карточкасында көрсетілген: [каталогта](https://ailoot.ai/models/kk/). Кэшке түсуін модель әзірлеушісі анықтайды, Ailoot бұған кепілдік бермейді. Сұрақтарыңыз қалды ма? Request ID мен сипаттаманы жіберіңіз — мәселені анықтауға көмектесеміз.[Қолдау қызметіне жазу](mailto:support@ailoot.ai) ## Ailoot · Компания және оның жобалар портфелі Ailoot жинақталған жұмыс тәжірибесіне, кең клиенттік базаға, тұрақты қызметке және KPI көрсеткіштерін үздіксіз бақылауға сүйенеді. Компания және оның жобалар портфелі: миллиондаған клиент; ай сайынғы сату көлемі миллиардтармен есептеледі. Ailoot осы тәжірибені клиенттердің өнімдерінде, агенттерінде, қолданбаларында және автоматтандыруларында жасанды интеллект мүмкіндіктеріне API арқылы қол жеткізуді қамтамасыз етуге пайдаланады.