Если вызов OpenAI API возвращает "You exceeded your current quota" или type insufficient_quota, не начинайте с усиления повторов. В большинстве рабочих случаев это не обычный rate limit, а проблема доступной квоты: у активной организации, проекта, месячного бюджета, предоплаченного баланса, платежного состояния или маршрута модели нет ресурса для этого запроса.
Безопасный первый экран такой: открыть Billing и Limits в OpenAI Platform, проверить организацию и проект, к которым относится ключ, посмотреть предоплаченный баланс, месячный бюджет, approved usage limit, платежи и доступ к модели, а затем выполнить один минимальный запрос в том же проекте. Только после этого имеет смысл переходить к RPM, TPM, concurrency, заголовкам и backoff.
На 29 апреля 2026 года официальное руководство OpenAI по rate limits оставляет точные текущие лимиты в странице Platform Limits, а production best practices описывает billing limits и approved usage limits как элементы управления аккаунтом. Поэтому надежный рабочий порядок не фиксирует вечные цифры, а дает проверки, которые можно выполнить во время инцидента.
Короткий ответ
| Вопрос | Ответ |
|---|---|
| Что обычно означает ошибка? | Текущий API-маршрут не имеет доступной квоты, баланса, бюджета, платежного допуска, проекта или модели. |
| Это то же самое, что rate limit? | Нет. insufficient_quota относится к квоте и биллингу; RPM и TPM относятся к пропускной способности. |
| Что проверить первым? | Platform Billing, Limits, месячный бюджет, организацию, проект, ключ и доступ к модели. |
| Поможет ли ChatGPT Plus или Pro? | Нет автоматически. Подписка ChatGPT не пополняет Platform API. |
| Нужно ли менять ключ? | Нет. Новый ключ в том же проекте не создает новую квоту. |
| Когда читать rate-limit headers? | После того как квота доступна или когда ошибка явно указывает на request/token pressure. |
Сначала найдите владельца ошибки
Главное различие - доступность против пропускной способности. Проблема пропускной способности означает, что маршрут разрешен, но запросов, токенов или параллельности слишком много. Проблема доступности квоты означает, что маршрут сейчас не имеет баланса, бюджета, платежного допуска, проекта или доступа к модели.
Если тело ошибки содержит insufficient_quota или фразу "You exceeded your current quota, please check your plan and billing details", backoff может сделать приложение тише, но не создаст квоту. Более агрессивные повторы только запутают логи и отвлекут от состояния аккаунта.
Когда доказательства указывают на RPM, TPM, remaining headers, reset window, burst traffic или concurrency, используйте соседнюю страницу OpenAI API rate limits. Оставайтесь здесь, если доказательства указывают на billing details, trial, prepaid credits, месячный бюджет, организацию, проект или доступ к модели.
Официальные документы поддерживают такой порядок. Rate-limits guide направляет в Limits page за текущими лимитами и к response headers за request/token окнами. Production best practices описывает billing limits и approved usage limits как контроль аккаунта. Надежный рабочий текст должен показывать, где проверять состояние, а не копировать устаревающую таблицу лимитов.
Пять проверок по порядку
| Проверка | Что подтвердить | Зачем |
|---|---|---|
| Биллинг | Platform billing включен, платежи здоровы. | API оплачивается через Platform, а не только подпиской ChatGPT. |
| Предоплаченный баланс | Баланс есть, не истек и привязан к активному аккаунту. | Корректный код не поможет без доступного баланса. |
| Месячный бюджет | Проект или аккаунт не уперся в self-imposed cap или approved spend ceiling. | Команда может пополнить баланс, но оставить низкий budget cap. |
| Организация и проект | Ключ относится к той же организации и проекту, которые вы проверяете. | Проверка неправильной организации делает исправный аккаунт похожим на сломанный. |
| Модель | Запрошенная модель доступна этому проекту и tier. | Баланс не гарантирует доступ ко всем маршрутам модели. |
Не объединяйте эти пункты в фразу "с биллингом все нормально". Валидная карта может существовать без предоплаченного баланса. Баланс может быть, но месячный бюджет уже достигнут. Организация может быть оплачена, но приложение использует ключ другого проекта. Дешевая модель может работать, а более ограниченная модель - нет.
После проверки панели сделайте минимальный запрос тем же ключом, той же организацией, тем же проектом, тем же семейством endpoint и той же моделью. Если он проходит, ищите drift в переменных окружения, wrapper-конфигурации или deployment secrets. Если он снова возвращает insufficient_quota, владелец остается в квоте аккаунта или доступе к маршруту.
Лестница восстановления
Исправляйте ветку в том же порядке, в каком диагностировали ее.
- Подтвердите правильную организацию и проект OpenAI Platform.
- Откройте Billing и проверьте баланс, payment method, credits и invoice health.
- Откройте Limits и проверьте approved usage limit, месячный бюджет, доступность модели и project scope.
- Если вы только что добавили prepaid credits, дайте изменению время на propagation.
- Выполните минимальный запрос в том же проекте до перезапуска очередей или production workers.
- Только потом настраивайте RPM, TPM, concurrency, token budget и response-header backoff.
Эта последовательность намеренно скучная. Она предотвращает две дорогие ошибки: пополнение неправильного аккаунта и написание retry-логики для проблемы состояния аккаунта. Точные суммы пополнения, сроки действия credits и usage tiers нужно проверять в актуальных OpenAI Billing и Help Center во время инцидента.
Если новый ключ или trial-state вызывают сомнения, используйте OpenAI API key free trial. Если непонятна организация или project scope, отдельно проверьте organization/project настройки до изменения кода.
Wrapper и интеграции
Zapier, Make, n8n, внутренние gateway и OpenAI-compatible providers могут показать OpenAI-style quota message, хотя владелец биллинга не очевиден. Главный вопрос: чей credential фактически отправляется в OpenAI.
Если интеграция использует ваш OpenAI API key, сначала диагностируйте ваш Platform account. Если интеграция использует managed provider account, сначала диагностируйте wrapper plan, connector quota или workspace budget. Если доступны оба режима, выполните прямой минимальный запрос к OpenAI Platform вашим ключом и сравните результат с wrapper path.
Не предполагайте, что local script, production worker, CI и user-facing app используют один бюджет. В production может быть другой проект, старый ключ, другая организация или gateway с собственным cap. Прямой API-тест ценен потому, что убирает wrapper и показывает, доступна ли Platform quota вообще.
Стоп-правила
Когда тело ошибки указывает на quota или billing, прекратите эти действия:
- не меняйте ключи внутри того же непрофинансированного проекта;
- не увеличивайте retries, чтобы "пробить" ошибку квоты;
- не покупайте ChatGPT subscription с ожиданием, что Platform API пополнится автоматически;
- не используйте публичную таблицу квот как доказательство состояния вашего аккаунта;
- не просите higher rate limits до подтверждения usable spend.
Делайте это вместо этого: сохраните exact error body, timestamp, organization, project, key source, endpoint, model и dashboard state; запишите результат минимального прямого запроса; сравните wrapper path и direct Platform path; отметьте недавнее действие в биллинге и время ожидания propagation; эскалируйте с пакетом фактов.
Пакет доказательств
Для support или limit increase нужны exact error text, error type, HTTP status, model, endpoint family, project, organization, timestamp with timezone, Billing page state, Limits page state, последние payment или credit changes и результат minimal same-project retest.
Если цель - больше throughput после того как аккаунт уже usable, пакет другой: requests per minute, tokens per minute, concurrency, queue size, reset headers и то, как вы уже снизили burst или token output. Это ветка rate-limit, а не quota.
Часто задаваемые вопросы
Почему ошибка появляется сразу после создания API key?
Ключ является credential. Он не доказывает, что проект имеет billing, credits, budget или доступ к модели. Проверяйте ту же организацию и проект, где создан ключ.
Пополнение credits исправляет ошибку сразу?
Обычно нужно немного подождать и перепроверить тот же проект. Если ошибка сохраняется, убедитесь, что credits находятся на аккаунте и проекте, которые реально использует ключ.
insufficient_quota и too many requests одинаковы?
Нет. Too many requests - ветка пропускной способности. insufficient_quota - ветка доступности квоты. HTTP status может быть похожим, но исправление разное.
Почему dashboard показывает запас, а приложение падает?
Приложение может использовать другую organization, project, key, wrapper account, model route или environment variable. Сравните минимальный прямой запрос с application path.
Когда просить higher limit?
Только после подтверждения usable quota и доказательства, что владелец - throughput или approved usage ceiling. Payment, balance, monthly budget и project scope исправляются раньше.