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

[API кабинета](https://ailoot.ai/docs/ru/) 

# API кабинета

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

Методы личного кабинета: вход, профиль, ключи и история расходов.

Это API личного кабинета ailoot.ai: вход, профиль, ключи и история расходов. Запросы к моделям идут на другой адрес — `https://api.ailoot.ai` с ключом `sk-…`. Доступ к методам зависит от прав вашего аккаунта и включённых функций.

## [](https://ailoot.ai/docs/ru/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/ru/keys/) |

Ключ `sk-…` не заменяет токен кабинета, а токен кабинета не открывает API моделей. Полный путь указан у каждого метода.

Чтение своего профиля

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

## [](https://ailoot.ai/docs/ru/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/ru/cabinet/#kak-chitat-spravochnik)Как читать справочник

- Каждая запись содержит HTTP-метод, полный путь, доступ, параметры, поля тела и ответ.
- Идентификаторы берите из предыдущего ответа: KEY\_ID — из GET /api/v1/keys, ID запроса — из GET /api/v1/usage.
- Поля объектов и их типы — на страницах «Схемы данных».
- Шаблоны показывают имена и типы полей. PLACEHOLDER и TOKEN — маркеры, настоящих данных здесь нет.
- Пополнение баланса — в разделе «Тарифы» кабинета: [как пополнить](https://ailoot.ai/docs/ru/billing/topup/).

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

Профиль содержит balance и frozen\_balance. frozen\_balance — сумма, зарезервированная под незавершённые запросы. Проверяйте оба поля вместе с историей.

## [](https://ailoot.ai/docs/ru/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/ru/cabinet/#rashody-i-bezopasnost)Расходы и безопасность

История и dashboard показывают actual\_cost — фактическое списание; total\_cost — стоимость по стандартной цене. Фильтры даты, модели, ключа и типа запроса указаны у метода. Смена пароля, TOTP и passkey требуют подтверждений, описанных у соответствующих методов.

В этом разделе: `39` методов.

Остались вопросы? Пришлите Request ID и описание — поможем разобраться.[Написать в поддержку](mailto:support@ailoot.ai)

## Ailoot · Компания и портфель её проектов





Ailoot опирается на накопленный опыт работы, большую клиентскую базу, стабильный сервис и постоянный контроль KPI.





Компания и портфель её проектов: миллионы клиентов; продажи на миллиарды ежемесячно.





Этот опыт Ailoot использует для API-доступа к нейросетям в продуктах клиентов, агентах, приложениях и автоматизациях.