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

Шлюз возвращает стандартные HTTP-коды и тело ошибки в OpenAI-совместимом формате. Разберитесь, что означает код, и как повторить запрос безопасно.

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

JSON
{
  "error": {
    "message": "Описание проблемы",
    "type": "invalid_api_key",
    "code": "invalid_api_key"
  }
}

Справочник кодов

КодТипЧто проверять
401invalid_api_keyНеверный или отсутствующий ключ. Проверьте заголовок Authorization: Bearer … и значение ключа.
403insufficient_quota / access_deniedНедостаточно средств или доступ к модели запрещён. Пополните баланс и сверьтесь с каталогом.
404model_not_foundID модели не найден. Сверьте модель с актуальным списком.
429rate_limit_exceededПревышена частота запросов. Сделайте паузу и повторите с экспоненциальной задержкой.
5xx upstream / gatewayВременная ошибка шлюза или канала. Повторите запрос позже; устойчивый сбой — к поддержке.

Стратегия повторов

  • 429 и 5xx — повторите запрос с экспоненциальной задержкой (например 1с, 2с, 4с) и небольшим джиттером.
  • 401 / 403 / 404 — не повторяйте автоматически: исправьте ключ, баланс или ID модели.
  • Идемпотентность. Повторы безопасны для чтения; для платных генераций убедитесь, что повтор не создаёт вторую задачу без необходимости.