Коды ошибок

Gateway возвращает ошибки в формате, близком к OpenAI: JSON с полем error.message (и иногда type / code).

401 Unauthorized

Причина: неверный, просроченный или отозванный API-ключ.

Что делать:

1. Проверьте заголовок Authorization: Bearer ...
2. Создайте новый ключ в API-ключи
3. Убедитесь, что ключ не обрезан при копировании

402 Payment Required / insufficient quota

Причина: недостаточно баланса или исчерпана квота ключа.

Что делать:

1. Пополните баланс
2. Проверьте лимиты ключа в кабинете
3. Смотрите расход в логах использования

404 / model not found

Причина: модель не существует или недоступна вашей группе / ключу.

Что делать:

1. Сверьте имя с GET /v1/models
2. Откройте pricing
3. Проверьте whitelist моделей на ключе

429 Too Many Requests

Причина: rate limit (ключ, пользователь или система).

Что делать: уменьшите частоту запросов, добавьте backoff / retry с задержкой.

500 / 502 / 503

Причина: ошибка upstream-провайдера или временная недоступность канала.

Что делать: повторите запрос позже; при повторении — поддержка.

400 Bad Request

Причина: невалидный JSON или неподдерживаемые поля.

Что делать: проверьте тело запроса, обязательные поля model и messages для chat.