Перейти к основному содержанию
Все ошибки возвращаются в едином формате:
{
  "error": {
    "message": "описание ошибки",
    "type": "тип_ошибки"
  }
}

HTTP-коды

КодТипПричина
400invalid_request_errorНеверный запрос: отсутствует обязательное поле, неподдерживаемый параметр
401auth_errorОтсутствует или неверный API-ключ
402billing_errorНедостаточно средств на балансе
404invalid_request_errorМодель не найдена или недоступна
429rate_limit_errorПревышен лимит запросов
500internal_errorВнутренняя ошибка сервера
502provider_errorВсе провайдеры для модели недоступны

Примеры

{
  "error": {
    "message": "invalid api key",
    "type": "auth_error"
  }
}
{
  "error": {
    "message": "insufficient balance",
    "type": "billing_error"
  }
}
{
  "error": {
    "message": "model not found: gpt-999",
    "type": "invalid_request_error"
  }
}
{
  "error": {
    "message": "rate limit exceeded",
    "type": "rate_limit_error"
  }
}

Особенности

  • 4xx от провайдера не вызывают fallover — запрос считается невалидным
  • 5xx от провайдера → автоматический переход к следующему провайдеру
  • Если все провайдеры недоступны — возвращается 502