ИИ и информация

Ошибка 429 у API ИИ: повторить запрос или проверить оплату

Как отличить временный лимит запросов от проблемы квоты или оплаты и остановить бесполезные повторы.

21 октября 2026 года OpenAI добавила управление уровнями обслуживания для проектов. Для недопустимого service_tier документирована ошибка 400 — это не временная ошибка 429. Если прежде работавшее задание остановилось, сначала прочитайте конкретный код: правила проекта, пропускная способность и оплата требуют разных действий.

Ответ 429 не всегда означает «повторите через минуту». В API OpenAI временное ограничение частоты и исчерпанная квота или баланс требуют разных действий. Сначала прочитайте тело ошибки и проверьте ограничения своего проекта.

Ограничьте повторы

При временном ограничении считайте корректное значение Retry-After минимальной паузой. Добавьте небольшой случайный разброс. Если заголовка нет, увеличивайте задержку между попытками экспоненциально, также со случайной добавкой. Учитывайте автоматические повторы SDK, чтобы два механизма не умножали число запросов.

Например, фоновому заданию можно выделить три попытки в пределах двух минут. Если сервер требует более долгого ожидания, отложите задание. Это пример настроек приложения, а не лимиты провайдера.

Проверьте результат

Запишите тип ошибки и идентификатор запроса, не сохраняя секреты. Повторы не пополняют баланс: при ошибке оплаты нужно разобраться с аккаунтом. После успешной попытки убедитесь, что нужная запись обработана ровно один раз, особенно если за обработкой следует отдельное действие.

Смотрите error.code, а не только общий тип insufficient_quota. Например, credit_balance_exhausted указывает на предоплаченный баланс, а project_spend_limit_exceeded — на обязательный предел расходов проекта. Повторы не исправляют ни одну из этих причин. До продолжения попросите администратора проверить соответствующую настройку; не увеличивайте бюджет автоматически.

Источники и подробности

  1. OpenAI — API changelog, 21 October 2026
  2. OpenAI — Error codes and service-tier restrictions
  3. OpenAI — Rate limits

Источники подтверждают технические объяснения. Примеры и предлагаемые проверки подготовлены для этой статьи.