Кто я

GEThttps://api.souz.ai/v1/auth/me

Текущий участник: id участника (не аккаунта), почта и/или username Telegram, имя, картинка, роль, собственный лимит трат с расходом и остатком (spend_limit) и аккаунт (id, название и номер). С ключом управления — его держатель: та же роль и тот же лимит, что в кабинете. Ответ не кешируется (Cache-Control: private, no-store).

Авторизация

ManagementKey

Ключ управления из кабинета souz.ai (выдают владелец и администратор аккаунта — себе или участнику). Даёт ровно то, что его держатель видит и может в кабинете: баланс, историю операций и запросов, расходы, обычные ключи, настройки аккаунта — с той же ролью, лимитами и цифрами. Модели не запускает. Обычный API-ключ здесь не подходит: 403 forbidden с detail[].reason: requires_management_key.

ClientSession

Сессия кабинета souz.ai в браузере — те же ручки, что у ключа управления.

Ответы

200OK

application/json

Схема MeResponse

accountAccountRefобязательно

avatar_urlstring | nullобязательно

Картинка участника — адрес в кабинете (?v= меняется вместе с картинкой) — или null.

Пример: "/v1/members/mem_1a2b3c4d5e6f7890/avatar?v=1758300000"

emailstringобязательно

Почта участника; пустая строка — участник приглашён только по username Telegram. telegram_username — username Telegram (строчными, без @) или пустая строка; хотя бы одно из двух есть.

Пример: "dev@example.com"

idstringобязательно

Пример: "mem_1a2b3c4d5e6f7890"

namestringобязательно

Имя; пустая строка, пока участник не вошёл через провайдера входа и не задал имя в профиле.

Пример: "Dev User"

rolestringобязательно

Роль участника в аккаунте: owner, admin, developer или viewer.

Значения: owner, admin, developer, viewer

Пример: "owner"

spend_limitSpendLimitEntry | nullобязательно

Собственный лимит трат участника — с расходом и остатком в текущем окне; null — лимита нет (владелец, администратор, наблюдатель, разработчик без лимита).

telegram_usernamestringобязательно

Пример: "durov"

401Нет ключа или ключ недействителен.

application/json

Error

403Нельзя: у ключа не тот вид (модели запускает API-ключ, аккаунт — ключ управления), у роли

Нельзя: у ключа не тот вид (модели запускает API-ключ, аккаунт — ключ управления), у роли участника нет права или подпись ссылки на файл не сходится. detail[].reason говорит, что именно: requires_api_key, requires_management_key, cabinet_only (только в кабинете), insufficient_role (в allowed — роли, которым можно), not_key_author (секрет ключа открывает только тот, кто его создал).

application/json

Error

429Слишком часто — повторите через `Retry-After` секунд. Запуск моделей, задачи и файлы результатов частотой не ограничены (их ограничивают баланс и лимиты трат); здесь 429 — на поток запросов с ключом, который сервер не знает, с одного адреса, и на потоки сверх 1000 одновременных на аккаунт (события задачи, чат с `stream: true`). Пределы — раздел «Лимиты» руководства.

application/json

Error

Бесплатно, со своим ключом

Запрос

curl -X GET 'https://api.souz.ai/v1/auth/me' \
  -H "Authorization: Bearer $SOUZ_MANAGEMENT_KEY"

import os
import requests

response = requests.get(
    "https://api.souz.ai/v1/auth/me",
    headers={"Authorization": f"Bearer {os.environ['SOUZ_MANAGEMENT_KEY']}"},
)
print(response.json())

const response = await fetch("https://api.souz.ai/v1/auth/me", {
  method: "GET",
  headers: { Authorization: `Bearer ${process.env.SOUZ_MANAGEMENT_KEY}` },
});
console.log(await response.json());

Ответ

{
  "error": {
    "code": "forbidden",
    "detail": [
      {
        "reason": "requires_api_key"
      }
    ],
    "message": "this endpoint takes an API key; a management key manages the account only",
    "type": "permission_error"
  }
}