Ошибка OpenAI API quota exceeded: как проверить баланс и лимиты

При ошибке You exceeded your current quota, please check your plan and billing details сначала сохраните тело ответа и прочитайте error.code. Если закончились предоплаченные средства, нужно пополнить баланс организации. Если достигнут жёсткий лимит расходов, нужно проверить именно этот лимит. Если исчерпан разрешённый OpenAI месячный объём использования, понадобится его повышение. Повторы с задержкой не устраняют ни одну из этих причин.

Общий тип insufficient_quota и статус HTTP 429 не позволяют выбрать одно исправление для всех случаев. В актуальном справочнике ошибок OpenAI причины оплаты разделены на четыре кода. Ниже — как проверить их в нужной организации и проекте, в том числе после оплаты или при положительном балансе. Правила сверены 6 октября 2026 года; реальные платежи и вызовы API для этой инструкции не выполнялись.

Найдите конкретную причину в ответе API

Смотрите на исходный JSON, а не только на короткое сообщение интерфейса. В нём важны error.code, error.type и error.message. Название Python-исключения RateLimitError также не доказывает, что поможет пауза: библиотека использует его для ответов 429, включая ошибки оплаты. Это различие описано в официальном справочнике.

У этих ошибок error.type может по-прежнему быть insufficient_quota. Поэтому обработчик, который проверяет только тип, теряет различие между балансом и тремя ограничениями. Таблица относится к прямому OpenAI API и опирается на коды ошибок, а не на состояние какого-либо конкретного аккаунта.

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

{
  "error": {
    "type": "insufficient_quota",
    "code": "project_spend_limit_exceeded"
  }
}

Если интерфейс показывает только старое сообщение quota exceeded, код отсутствует или неизвестен, причина ещё не установлена. Получите полный ответ из журнала интеграции и сопоставьте его с балансом, организацией, проектом и настройками ограничений. Не делайте вывод «денег нет» по одному статусу 429.

Когда ответ явно указывает на частоту запросов или токенов либо содержит slow_down, переходите к разбору RPM, TPM и повторов OpenAI API. Это другая ветка: там важны темп отправки и Retry-After, а не покупка дополнительных кредитов.

Сверьте организацию и проект до изменения оплаты

Проверяйте организацию, которой принадлежит ключ приложения. Если в браузере выбрана другая организация, её положительный баланс не объясняет состояние неудачного запроса. Аналогично общий запас средств не отменяет ограничение конкретного проекта.

1. Уточните адрес сервера API, endpoint и модель, которые использует приложение. Для прямого OpenAI API адрес сервера — https://api.openai.com/v1; совместимый адрес посредника может означать отдельные правила оплаты.
2. Сверьте выбранные организацию и проект в настройках Platform с конфигурацией неработающего приложения. Проверяйте источник ключа на сервере, не публикуя сам секрет.
3. Сохраните доступный openai-organization из заголовков ответа и x-request-id. Они помогают сопоставить запрос и передать его идентификатор поддержке.
4. Откройте баланс и ограничения именно для найденной организации и проекта.

API Overview описывает заголовки OpenAI-Organization и OpenAI-Project для явного выбора при нескольких организациях или использовании старого пользовательского ключа. Они не дают ключу проекта права на произвольную чужую организацию. Не добавляйте их наугад ради устранения квоты.

Для Zapier, Make, n8n и других интеграций сначала выясните, чей ключ используется. Если это ваш ключ OpenAI, проверяйте соответствующую организацию Platform. Если запрос оплачивает сервис из собственного аккаунта, потребуется его журнал и проверка его лимита. Сам JSON в формате OpenAI не доказывает, что ошибку вернул прямой API. Переход к другому поставщику создаёт другой способ оплаты, но не исправляет исходный аккаунт.

Закончились средства или ошибка осталась после оплаты

При credit_balance_exhausted откройте API Billing нужной организации. Операции с оплатой должен выполнять человек с соответствующими правами; официальный раздел API Billing доступен владельцу организации. Если вы видите только настройки проекта, попросите владельца проверить баланс и покупку средств.

При необходимости пополните баланс через Buy credits или Add to credit balance, подтвердите покупку и дождитесь зачисления. По правилам предоплаты OpenAI, обновление баланса после покупки может занять несколько минут. Это не гарантия восстановления ровно через пять или пятнадцать минут.

Если оплата уже прошла, проверьте последовательно:

• Где зачислены средства. Организация в истории покупки должна совпадать с организацией запроса.
• Обновился ли доступный баланс. Подтверждение платежа и отражённые в консоли кредиты — разные признаки. Пока баланс не обновился, не создавайте серию одинаковых покупок.
• Был ли отрицательный остаток. По правилам предоплаты следующий платёж сначала покрывает задолженность. При условном балансе −3 USD покупка на 10 USD оставит 7 USD до новых расходов.
• Какой код возвращается теперь. После зачисления может проявиться другое ограничение. Повторный project_spend_limit_exceeded требует проверки проекта, а не ещё одной покупки.

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

При включённом автопополнении отдельно проверьте, состоялась ли автоматическая покупка. Её месячный предел ограничивает покупку новых кредитов, а не расход уже имеющихся; ручные покупки в этот предел не входят. Проверка порога, сохранённых настроек и отклонённого платежа подробно разобрана в статье «Автопополнение OpenAI API не работает».

Баланс положительный: проверьте действующие месячные лимиты

Положительный баланс показывает наличие средств, но не разрешение потратить любую сумму. Кроме него существуют установленные вами лимиты расходов и отдельный месячный предел использования, назначенный OpenAI. У каждого — своё исправление.

Лимит расходов организации или проекта

В Organization limits откройте Spend → Edit spend limit. Для проекта выберите его в настройках Platform, откройте Limits и тот же раздел Spend. Сверьте Monthly spend limit, текущий расход и переключатель Enforce a hard limit.

Уведомление о расходах само по себе не останавливает API. Прерывание запросов происходит при включённом жёстком ограничении. Согласно руководству по spend limits, предупреждения продолжают действовать и после его включения. Не считайте любое письмо о бюджете доказательством блокировки.

Лимит организации охватывает все её проекты; лимит проекта — только запросы, оплачиваемые этим проектом. Если достигнут общий предел организации, увеличение бюджета проекта не отменит его. При исчерпании только проектного лимита другие проекты могут продолжать работать, пока не достигнуты их собственные или общий предел.

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

Изменения и срабатывание ограничения не мгновенны: расход может немного превысить заданную сумму, пока состояние распространяется. OpenAI не обещает жёсткую остановку точно на последнем центе. Порядок настройки, область действия и месячный сброс описаны в официальном руководстве.

Месячный предел, разрешённый OpenAI

При organization_usage_limit_exceeded проверяйте утверждённый лимит организации в Limits. Это отдельный предел, связанный с уровнем использования API, а не сумма на предоплаченном балансе и не переключатель Enforce a hard limit.

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

Как подтвердить, что запросы восстановились

После зачисления средств или применения изменения лимита выполните один небольшой запрос с теми же ключом, организацией, проектом, адресом API, endpoint и моделью, на которых возникла ошибка. Это реальное использование API по обычным условиям оплаты; выполняйте его только с разрешением на соответствующие расходы.

Успех — ожидаемый ответ модели на этом запросе. Платёжная квитанция, сохранённый бюджет и успешный GET /v1/models по отдельности этого не доказывают: список доступных моделей не проверяет восстановление оплачиваемого вызова.

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

Если ошибка повторилась, сохраните новый код. При той же причине снова проверьте соответствующий показатель и применённое изменение; при другом коде перейдите к новой ветке. Если отдельный запрос работает, а приложение — нет, сравните адрес API, организацию, проект и источник ключа в обоих запусках. Рабочий локальный запрос не доказывает, что сервер использует ту же конфигурацию.

При неясном результате передайте поддержке OpenAI время и часовой пояс, модель, endpoint, HTTP-статус, error.code, error.type, сообщение, x-request-id, организацию и проект, состояние баланса и лимита, время последнего изменения. Удалите API-ключ, платёжные реквизиты и личные данные из вложений. Идентификатор запроса и безопасное журналирование описаны в API Overview.

Частые вопросы

Почему quota exceeded появляется при первом запросе с новым ключом?

Создание ключа не пополняет баланс и не снимает ограничения организации или проекта. Прочитайте error.code и проверьте именно их. Новый ключ в том же проекте не создаёт дополнительную квоту; сам факт отсутствия предыдущих вызовов этим ключом не означает, что у всей организации есть доступный лимит.

Подписка ChatGPT Plus или Pro оплачивает OpenAI API?

Нет. ChatGPT и API Platform используют раздельную оплату. Квитанция за подписку не подтверждает наличие API-кредитов: проверять и настраивать оплату API нужно в Platform. Это прямо объясняет справка OpenAI о двух системах оплаты.

Поможет ли подождать до следующего месяца?

Достигнутый месячный жёсткий лимит расходов сбрасывается в новом месячном цикле, но пустой предоплаченный баланс от этого не пополнится. Сначала различите причину по коду. Условия сброса установленных лимитов приведены в руководстве по spend limits.

Нужно ли менять ключ, если после пополнения ошибка осталась?

Сначала проверьте зачисление, организацию, проект и новый код ошибки. Замена ключа внутри того же проекта не меняет его баланс и лимиты. Если приложение использует ключ другого проекта, нужно исправить конфигурацию с учётом прав доступа; при ошибке авторизации или утечке ключа требуется отдельное действие, а не лечение квоты.

Положительный баланс есть, но модель недоступна — это тоже insufficient_quota?

Не обязательно. Баланс не гарантирует доступ к любой модели или операции. Ошибки авторизации, прав доступа и параметров нужно разбирать по их собственному статусу и сообщению; нельзя считать их исчерпанием квоты только потому, что вызов не прошёл. Разделение ошибок дано в справочнике OpenAI.