Решение проблем

Типичные ошибки при работе с платформой и способы их устранить.

Кому подходит

Администраторам и участникам при настройке организации и интеграции приложений.

Не удаётся войти в кабинет

Симптом: страница входа не принимает email/пароль или SSO не работает.

Решения:

проверьте правильность email и пароля;
при корпоративном входе убедитесь, что SSO настроен (раздел SSO в кабинете или Настройка SSO);
очистите cookies и попробуйте снова;
напишите в службу поддержки LLM Mart, если аккаунт заблокирован.

401 в API платформы

Симптом: {"error": "Требуется авторизация"}.

Решения:

получите новый токен через POST /api/auth/login;
проверьте заголовок Authorization: Bearer <token>;
не используйте API-ключ (sk-…) вместо токена сессии — это разные типы авторизации.

API-ключ не работает для запросов к модели

Симптом: 401 или 403 от API моделей.

Решения:

убедитесь, что используете секретный ключ (sk-…), а не токен кабинета;
проверьте, что ключ в статусе active;
проверьте, что для ключа/системы есть policy rules с доступом к нужной модели;
при утере секрета выпустите новый ключ.

API моделей не отвечает

Симптом: таймаут, ошибка соединения или долгое ожидание ответа от https://www.llmmart.ru/api/v1 (и других маршрутов API моделей).

Решения:

откройте статус — проверьте, не объявлен ли инцидент и не недоступен ли компонент «API моделей»;
убедитесь, что используете секретный ключ (sk-…), а не токен кабинета;
проверьте сеть, DNS и прокси на стороне клиента;
если на странице статуса всё зелёное — см. разделы ниже про 401/403, policy rules и лимиты.

Модель недоступна

Симптом: ошибка «model not allowed» или модель не в списке.

Решения:

включите модель в разделе Модели кабинета;
проверьте policy rules (модуль access) для ключа, системы, группы и организации;
проверьте статус API моделей: GET /api/organization/gateway/status.

Расходы не обновляются в кабинете

Симптом: раздел Биллинг показывает устаревшие данные.

Решения:

убедитесь, что недавние запросы шли через API моделей с вашим API-ключом;
запросите сводку: GET /api/organization/usage или сохраните снимок POST .../usage/snapshots;
подождите несколько секунд после запроса к модели;
если проблема сохраняется — напишите в службу поддержки LLM Mart.

Превышен бюджет

Симптом: запросы отклоняются, в кабинете виден лимит.

Решения:

увеличьте лимиты в policy rules (модуль budget) для нужного ключа, участника или организации;
проверьте разбивку расходов по ключам в разделе Биллинг;
отзовите неиспользуемые ключи.

Ошибка SSO / OIDC

Симптом: redirect loop или «провайдер не найден».

Решения:

проверьте настройки провайдера (issuer, client ID, redirect URI);
выполните discovery: POST /api/auth/oidc/providers/{id}/discover;
см. Настройка SSO.

Ошибка `route not supported` (404)

Симптом: {"error":{"message":"route not supported",…}}.

Причина: маршрут не входит в справочник API моделей (Assistants, Threads, Moderations, management API и др.). Карточка модели с идентификатором author/slug обслуживается как GET /models/{author}/{slug} — это не исключённый маршрут.

Решение: используйте поддерживаемые маршруты.

Realtime: `invalid_realtime_credential`

Симптом: 404 с code: invalid_realtime_credential при WebSocket upgrade.

Решения:

получите новый secret через POST /realtime/client_secrets;
передавайте API-ключ в Authorization, а client_secret — в query ?client_secret=…;
проверьте, что credential не истёк и не отозван.

См. Realtime API.

Нужна помощь

Если проблема не описана здесь — напишите в службу поддержки LLM Mart.