> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tungo.kz/llms.txt
> Use this file to discover all available pages before exploring further.

# Платформа балансы және шығын

> Платформа балансын қалай толтыруға болады, кілттер бойынша шығынды қайдан көруге болады және шығысты шектермен қалай шектеуге болады.

ЖИ-бухгалтерге кілтпен жіберілген сұраулар мен автоматтандырулар платформа балансынан төленеді. Сіз оны картадан алдын ала толтырасыз, ал кейін одан модельді әр шақырудың бағасы алынады. Баланс бос болғанда ақылы сұраулар ол толтырылғанша бас тарту алады.

Платформа балансы жазылымнан бөлек. Оған жазылым керек емес, ал тариф лимиттері кілтпен жіберілген сұрауларға қолданылмайды. Кері бағытта да солай: платформа ақшасы кабинеттегі чатқа жұмсалмайды.

## Балансты толтыру

Балансты ұйымның иесі немесе әкімшісі толтырады: **Платформа → Баланс және төлем**, **Толтыру** батырмасы. Сома ұйымның негізгі картасынан бірден алынады. Мұндағы карталар жазылымға арналған карталармен бірдей. Карта әлі жоқ болса, алдымен осы беттегі **Картаны байлау** батырмасын басыңыз. Соманың бір реттік және тәуліктік шектері сома өрісінің астында жазылған.

API кілтімен балансты толтыруға болмайды, мұны тек кабинеттегі адам жасайды. Ал балансты кілтпен оқуға болады:

```sh theme={null}
curl "$TUNGO_API/v1/workspaces/$WS/platform/account" -H "x-api-key: $TUNGO_KEY"
```

Жауаптағы `balance_tiyn` — тиынмен берілген баланс, 1 ₸ = 100 тиын. `blocked_reason` өрісі сұраулардың қазір неге өтпейтінін айтады: `balance` — баланс таусылды, `cap` — айлық шекке жетті, `disabled` — платформа өшірілген.

Балансты қолмен қадағаламау үшін сол беттегі «Автотолтыру» мүмкіндігін қосыңыз. Сіз төменгі шекті, толтыру сомасын және айлық шекті бересіз. Баланс төменгі шектен түскенде сома ұйым картасынан өзі алынады.

> [!WARNING]
>
> Сақтау сәтінде баланс төменгі шектен әлдеқашан төмен болса, автотолтыру картадан ақшаны бірден алады. Экран бұл туралы ескертеді және сіз **Сақтау және алу** батырмасын басқанға дейін соманы көрсетеді.

## Сұрау қанша тұрады

Баға токендер бойынша есептеледі: модельге жіберілгеннің бәрі және оның жауап бергенінің бәрі. Әр модельдің 1 млн токенге өз бағасы бар. Қолданыстағы бағаларды ашық мекенжай береді, оған кілт керек емес:

```sh theme={null}
curl "$TUNGO_API/v1/usage-rates"
```

`input_per_mtok_tiyn` және `output_per_mtok_tiyn` өрістері — кірістегі және шығыстағы 1 млн токеннің тиынмен берілген бағасы. Сол бағалар «Модель бағалары» бөлімінде де көрсетілген.

ЖИ-бухгалтердің бір жауабы — әдетте модельді бірнеше рет шақыру, сондықтан нақты бағаны алдын ала айту мүмкін емес. Жоғарғы бағалауды тегін есептеу сұрауы береді: [Алғашқы сұрауды жіберу](https://docs.tungo.kz/kk/platform/first-request.md) бетін қараңыз. Нақты баға жауапта келеді: `usage.cost_tiyn` өрісі, ал оқиғалар ағынында — `done` оқиғасындағы `cost_tiyn`.

Оқу сұраулары ақша тұрмайды: компаниялар тізімі, құжаттар, шығын, 1С күйі. Тек модельді шақырулар ақылы.

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

«Шығын» бөлімінде әр кілттің бір айда қанша жұмсағаны көрінеді: сұраулар, токендер және сома. Кестені CSV түрінде жүктеп алуға болады. «Сұраулар журналы» бөлімінде кілттер бойынша барлық сұрау жауап кодымен бірге тізілген. Сұраудың ішінде не болғанын журнал сақтамайды. Толтырулар мен алынған сомаларды ретімен «Баланс және төлем» бетіндегі «Баланс тарихы» көрсетеді.

Сол мәліметтер API арқылы да қолжетімді:

* `GET /v1/api-key/usage` — сұрау жасалған кілттің шығыны.
* `GET /v1/workspaces/{ws}/platform/usage` — ұйымның күндер, кілттер, модельдер және компаниялар бойынша шығыны.
* `GET /v1/workspaces/{ws}/platform/ledger` — баланс қозғалыстары.
* `GET /v1/workspaces/{ws}/platform/requests` — кілттер бойынша сұраулар журналы.

Параметрлерсіз шығын Алматы уақыты бойынша ағымдағы айдың басынан есептеледі. Барлық компанияға арналған кілт бүкіл ұйымның шығынын көреді. Компаниялардың бір бөлігіне арналған кілт тек өз шығынын және журналдағы өз жолдарын көреді.

## Шығын шектері

Шек — Алматы уақыты бойынша күнтізбелік айдағы шығыстың жоғарғы шегі. Шек екеу, және олар бір мезгілде қолданылады.

Ұйымның шегі «Баланс және төлем» бетінде, «Айлық шығын шегі» өрісінде беріледі. Ол барлық кілт пен автоматтандыруға ортақ. Шығыс оған жеткенде ақылы сұраулар келесі айдың басына дейін `platform_cap_reached` кодымен 402 алады.

Кілттің шегі кілтті шығарған кезде немесе кейін «Өзгерту» арқылы беріледі, ол да «Айлық шығын шегі» өрісінде. Ол бір кілтті шектейді. Шекке жеткенде `key_cap_reached` кодымен 402 келеді. Осы бас тарту шектің қалдығы модельді бір рет шақырудың бағалауынан аз болғанда сәл ертерек те келеді: осылай кілт өз шегінен шықпайды.

Екі жағдайда да қатеде `resets_at` өрісі бар — шектің өзі қашан нөлденетіні. Ертерек жалғастыру үшін шекті көтеріңіз. Бос өріс «шексіз» дегенді білдіреді.

Сол бетте «Платформа қосулы» ауыстырғышы бар. Оны өшірсеңіз, кілттер бойынша барлық шақыру мен автоматтандырулар `platform_disabled` кодымен бірден тоқтайды. Қайта қосуды сол жерде жасауға болады.

## Баланс бос болғанда

Ақылы сұрау `platform_balance_exhausted` кодымен 402 алады, модель шақырылмайды. Баланс толтырылғанша мұндай сұрауды қайталаудан пайда жоқ. Бір ғана ерекше жағдай бар: автотолтыру қосулы болса, ол дәл осы сәтте іске қосылады, сондықтан сұрауды сәл кейінірек қайталаған жөн.

Баланс шамалы минусқа кетуі мүмкін. Шақырудың бағасы тек модель жауабынан кейін белгілі болады, сондықтан соңғы шақыру кейде қалдықтан қымбат тұрады. Минус бір шақырудың бағасынан аспайды және келесі толтырумен жабылады.

Ақша туралы вебхуктар арқылы алдын ала біліп отыруға болады: `platform.balance_low` оқиғасы баланс төменгі шектен түскенде келеді, `platform.balance_exhausted` — ол таусылғанда, `platform.cap_threshold_reached` — айлық шығыс ұйымның шегіне жақындағанда.

## Әрі қарай

* [Қателер мен шектеулер](https://docs.tungo.kz/kk/platform/errors-and-limits.md): ақшаға байланысты барлық бас тарту және олармен не істеу керек.
* [Оқиғаларды алу (вебхуктар)](https://docs.tungo.kz/kk/platform/webhooks.md): баланс туралы оқиғаларға жазылу.
* [Картаны байлау, ауыстыру немесе жою](https://docs.tungo.kz/kk/billing/card.md): толтырулар қай картадан алынады.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.