Source: https://ailoot.ai/docs/kk/cabinet/
Canonical: https://ailoot.ai/docs/kk/cabinet/
Language: kk

[Жеке кабинет API-і](https://ailoot.ai/docs/kk/) 

# Жеке кабинет API-і

[Markdown](https://ailoot.ai/docs/kk/cabinet/index.md)

Жеке кабинет әдістері: кіру, профиль, кілттер және шығындар тарихы.

Бұл ailoot.ai жеке кабинетінің API-і: кіру, профиль, кілттер және шығындар тарихы. Модель сұраулары басқа мекенжайға жіберіледі — `https://api.ailoot.ai` мына кілтпен: `sk-…`. Әдістерге қол жеткізу аккаунтыңыздың құқықтары мен қосылған функцияларға байланысты.

## [](https://ailoot.ai/docs/kk/cabinet/#adresa-i-avtorizatsiya)Мекенжайлар және авторизация

- Жеке кабинет: https://ailoot.ai (логинмен кіру, жеке кабинет токені)
- Модельдер API-і: https://api.ailoot.ai (sk-… кілті)

| Не | Мекенжай | Авторизация |
| --- | --- | --- |
| Жеке кабинет API-і | `https://ailoot.ai/api/v1` | `Authorization: Bearer $TOKEN` — кіргеннен кейінгі жеке кабинет токені |
| Модельдер API-і | `https://api.ailoot.ai/v1` | Кілт `sk-…` «API кілттері» бөлімінен; қараңыз: [Кілттер және API мекенжайы](https://ailoot.ai/docs/kk/keys/) |

Кілт `sk-…` жеке кабинет токенін алмастырмайды, ал жеке кабинет токені модельдер API-іне қол жеткізуді ашпайды. Толық жол әр әдісте көрсетілген.

Өз профиліңізді оқу

```bash
curl --fail-with-body "https://ailoot.ai/api/v1/user/profile" \
  -H "Authorization: Bearer $TOKEN"
```

## [](https://ailoot.ai/docs/kk/cabinet/#format-otveta-i-oshibki)Жауап форматы және қателер

Жауапта code, message және data бар. Қатеде reason және metadata болуы мүмкін. data ішіндегі беттеуде items, total, page, page\_size және pages бар. Жеке әдістердің форматы олардың сипаттамаларында көрсетілген.

Беттері бар жауап құрылымы

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "items": [],
    "total": 0,
    "page": 1,
    "page_size": 20,
    "pages": 1
  }
}
```

Жеке кабинет токенінің жарамдылық мерзімі мен пайдаланушының белсенділігі тексеріледі; сеансқа байлау қосылса, IP мен браузер де тексеріледі. TOKEN\_EXPIRED, TOKEN\_REVOKED, USER\_INACTIVE, INVALID\_TOKEN және FORBIDDEN кодтары сеанс пен құқықтар мәселелерін ажыратады. Жиілік лимиті мен қосымша 2FA растауы жеке сұрауға тыйым салуы мүмкін.

## [](https://ailoot.ai/docs/kk/cabinet/#kak-chitat-spravochnik)Анықтамалықты қалай оқу керек

- Әр жазбада HTTP әдісі, толық жол, қол жеткізу, параметрлер, дене өрістері және жауап бар.
- Идентификаторларды алдыңғы жауаптан алыңыз: KEY\_ID — GET /api/v1/keys жауабынан, сұрау ID-і — GET /api/v1/usage жауабынан.
- Нысан өрістері мен олардың түрлері «Деректер схемалары» беттерінде берілген.
- Үлгілер өріс атаулары мен түрлерін көрсетеді. PLACEHOLDER және TOKEN — маркерлер, мұнда нақты деректер жоқ.
- Балансты толықтыру — жеке кабинеттің «Тарифтер» бөлімінде: [қалай толықтыруға болады](https://ailoot.ai/docs/kk/billing/topup/).

## [](https://ailoot.ai/docs/kk/cabinet/#balans-i-frozen-balance)Баланс және frozen\_balance

Профильде balance және frozen\_balance бар. frozen\_balance — аяқталмаған сұрауларға резервтелген сома. Екі өрісті де тарихпен бірге тексеріңіз.

## [](https://ailoot.ai/docs/kk/cabinet/#klyuchi-i-limity)Кілттер және лимиттер

GET /api/v1/keys кілттеріңізді қайтарады. Мына өрістер: `quota` және `quota_used` — кілттің шығын лимиті және жұмсалған бөлігі; `ip_whitelist`, `ip_blacklist`, `status` және `expires_at` кілттің қолданылуын басқарады; `rate_limit_5h`, `rate_limit_1d` және `rate_limit_7d` — уақыт аралықтарындағы шығын лимиттері.

Тізім және өз кілтіңіз

```bash
curl --fail-with-body "https://ailoot.ai/api/v1/keys" \
  -H "Authorization: Bearer $TOKEN"

# KEY_ID — тізім жауабындағы өз кілтіңіздің id мәні
curl --fail-with-body "https://ailoot.ai/api/v1/keys/$KEY_ID" \
  -H "Authorization: Bearer $TOKEN"
```

## [](https://ailoot.ai/docs/kk/cabinet/#rashody-i-bezopasnost)Шығындар және қауіпсіздік

Тарих пен dashboard ішінде actual\_cost — нақты есептен шығару; total\_cost — стандартты бағамен құны көрсетіледі. Күн, модель, кілт және сұрау түрі бойынша сүзгілер әдісте көрсетілген. Құпиясөзді, TOTP мен passkey өзгерту үшін тиісті әдістерде сипатталған растаулар қажет.

Бұл бөлімде: `39` әдіс.

Сұрақтарыңыз қалды ма? Request ID мен сипаттаманы жіберіңіз — мәселені анықтауға көмектесеміз.[Қолдау қызметіне жазу](mailto:support@ailoot.ai)

## Ailoot · Компания және оның жобалар портфелі





Ailoot жинақталған жұмыс тәжірибесіне, кең клиенттік базаға, тұрақты қызметке және KPI көрсеткіштерін үздіксіз бақылауға сүйенеді.





Компания және оның жобалар портфелі: миллиондаған клиент; ай сайынғы сату көлемі миллиардтармен есептеледі.





Ailoot осы тәжірибені клиенттердің өнімдерінде, агенттерінде, қолданбаларында және автоматтандыруларында жасанды интеллект мүмкіндіктеріне API арқылы қол жеткізуді қамтамасыз етуге пайдаланады.