Обработка ошибок

Ошибки возвращаются в формате, совместимом с OpenAI:

{
  "error": {
    "message": "Insufficient balance",
    "type": "insufficient_balance",
    "code": "insufficient_balance"
  }
}

Коды

HTTP	type	Когда возникает
400	invalid_request_error	Неверные параметры или неподдерживаемая модель
401	authentication_error	Нет или неверный ключ
402	insufficient_balance	Недостаточно средств на балансе
403	model_not_allowed	Модель не разрешена для этого ключа
404	model_not_found	Модели нет в каталоге
409	idempotency_conflict	Повторный платёж с тем же Idempotency-Key
413	payload_too_large	Запрос больше 10 MB
422	unprocessable_entity	Payload не прошёл валидацию
429	rate_limit_exceeded	Превышен RPM/TPM ключа или общий лимит
500	internal_server_error	Внутренняя ошибка платформы
502	upstream_error	Модель временно недоступна, fallback не помог
503	service_unavailable	Временная недоступность сервиса
504	upstream_timeout	Модель не ответила за отведённое время

Что делать

• 401 / 402 — проверьте ключ и баланс в кабинете; после пополнения доступ восстанавливается автоматически.
• 429 — подождите Retry-After и используйте экспоненциальный backoff.
• 502 / 504 — повторите запрос; кратковременные сбои на стороне моделей бывают.
• 5xx подряд — напишите в поддержку и укажите x-llmgw-request-id из заголовков ответа.

Идемпотентность

Для платежей передавайте Idempotency-Key (UUID), чтобы повтор не списал деньги дважды.

Журнал ошибок

Каждая ошибка связана с request_id в заголовке x-llmgw-request-id. Он хранится 30 дней — указывайте его в обращениях.