Ошибки

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

Шлюз возвращает ошибки в диалекте той API-поверхности, к которой обращался вызывающий.

Конверт ошибки OpenAI-совместимого API

{
  "error": {
    "message": "Invalid API key.",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

Конверт ошибки Anthropic-совместимого API

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Invalid API key."
  }
}

Распространённые ошибки

HTTP-статус	Причина	Решение
401 Unauthorized	Неверный или отсутствующий API-ключ	Проверьте, что передаёте корректный ключ sk-ru-… через Authorization: Bearer или x-api-key.
402 Payment Required	Недостаточный баланс	Пополните баланс в консоли → Billing.
400 Bad Request	Неизвестный ID модели или некорректный запрос	Сверьте ID модели с GET /v1/models. Проверьте поля тела запроса.
429 Too Many Requests	Превышен лимит запросов	Снизьте частоту запросов; используйте экспоненциальную задержку.
502 Bad Gateway	Ошибка вышестоящего провайдера	Временная ошибка от провайдера LLM. Повторите с задержкой.
503 Service Unavailable	Шлюз перегружен или провайдер недоступен	Повторите с задержкой.

Заметка

Ошибки всегда возвращаются с соответствующим HTTP-статусом и JSON-телом в диалекте вызывающего. При использовании SDK (OpenAI или Anthropic) ошибка будет выброшена как нативное исключение.

Повтор запросов при ошибках

Для ошибок 502 и 503 используйте экспоненциальную задержку с джиттером. Для ошибки 402 пополните баланс перед повтором — запросы будут отклоняться, пока баланс не станет положительным.