docs
Кабинет
API кабинета

API кабинета

Markdown

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

Полное руководство

Адреса и авторизация

  • Кабинет: https://ailoot.ai (вход по логину, токен кабинета)
  • API моделей: https://api.ailoot.ai (ключ sk-…)
ЧтоАдресАвторизация
API кабинетаhttps://ailoot.ai/api/v1Authorization: Bearer $TOKEN — токен кабинета после входа
API моделейhttps://api.ailoot.ai/v1Ключ sk-… из раздела «API-ключи»; см. Ключи и адрес API

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

Чтение своего профиля
curl --fail-with-body "https://ailoot.ai/api/v1/user/profile" \
  -H "Authorization: Bearer $TOKEN"

Формат ответа и ошибки

Ответ содержит code, message и data. В ошибке могут присутствовать reason и metadata. Пагинация в data содержит items, total, page, page_size и pages. Формат отдельных методов указан в их описании.

Структура ответа со страницами
{
  "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 могут закрыть отдельный запрос.

Как читать справочник

  • Каждая запись содержит HTTP-метод, полный путь, доступ, параметры, поля тела и ответ.
  • Идентификаторы берите из предыдущего ответа: KEY_ID — из GET /api/v1/keys, ID запроса — из GET /api/v1/usage.
  • Поля объектов и их типы — на страницах «Схемы данных».
  • Шаблоны показывают имена и типы полей. PLACEHOLDER и TOKEN — маркеры, настоящих данных здесь нет.
  • Пополнение баланса — в разделе «Тарифы» кабинета: как пополнить.

Баланс и frozen_balance

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

Ключи и лимиты

GET /api/v1/keys возвращает ваши ключи. Поля quota и quota_used — лимит трат ключа и уже потраченная часть; ip_whitelist, ip_blacklist, status и expires_at управляют применением ключа; rate_limit_5h, rate_limit_1d и rate_limit_7d — лимиты трат за окна.

Список и собственный ключ
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"

Расходы и безопасность

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

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

Остались вопросы? Пришлите Request ID и описание — поможем разобраться.Написать в поддержку
ВойтиРегистрацияКабинет
Тарифы