Ошибки и лимиты

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

{
  "error": "Описание ошибки"
}

HTTP коды

Код	Значение
400	Bad Request — неверные параметры запроса
401	Unauthorized — API ключ не передан или недействителен
403	Forbidden — нет прав для данной операции
404	Not Found — ресурс не найден
429	Too Many Requests — превышен лимит запросов
500	Internal Server Error — ошибка сервера

Rate limits

Эндпоинт	Лимит
POST /chat/message	Зависит от API ключа (по умолчанию 60 запросов/мин)
POST /chat/stream	Зависит от API ключа (по умолчанию 60 запросов/мин)
GET /chat/messages	60 запросов/мин

При превышении лимита возвращается 429:

{ "error": "Chat rate limit exceeded" }

Лимит конкретного ключа задаётся при его создании в настройках ассистента.

Частые ошибки

401 Authentication required

API ключ не передан или неверный. Проверьте заголовок:

X-API-Key: ak_your_api_key

403 Assistant is not active

Ассистент отключён. Включите его в настройках личного кабинета.

429 Chat rate limit exceeded

Слишком много запросов. Подождите 60 секунд или увеличьте лимит ключа.