Gemini API: free_tier_requests limit 0 на платном тарифе — что проверить и исправить

При ошибке 429 RESOURCE_EXHAUSTED с free_tier_requests и limit: 0 сначала проверьте, какой ключ использует отказавшее приложение и к какому проекту он относится. Затем откройте этот же проект в AI Studio, устраните незавершённую настройку оплаты и проверьте действующий лимит нужной модели. Если ключ, проект, оплата и положительная квота совпадают, а API продолжает применять нулевой Free Tier, остановите автоматические повторы и передайте это расхождение поддержке.

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

Порядок ниже относится к Gemini Developer API. Если приложение отправляет запросы через Vertex AI или сторонний шлюз, сначала определите фактическую конечную точку и способ аутентификации: настройки AI Studio могут не управлять этим запросом. Сведения об оплате и моделях сверены с документацией на 5 октября 2026 года; реальные платные вызовы при подготовке руководства не выполнялись.

Сначала сопоставьте ошибку с конкретным запросом

Сохраните исходное тело ошибки до смены ключей и платёжных настроек. Вместе с ним нужны время и часовой пояс, точный ID модели, адрес API, версия SDK и место запуска: терминал, IDE, сервер, контейнер или фоновое задание. Так вы сможете сравнить ответ API с показателями того же проекта за тот же интервал.

Ищите в ответе указание limit: 0, метрику с free_tier_requests или free_tier_input_token_count, название квоты и модель. Это сведения о том ограничении, по которому отклонён запрос. Они ещё не объясняют, почему к нему применили бесплатную квоту: в приложении может оказаться другой ключ, оплата может быть не завершена, а панель и сервер — показывать разные состояния.

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

Например, в сообщении пользователя от 6 марта 2026 года об отказе gemini-2.0-flash указаны нулевые лимиты запросов и входных токенов. В блоке google.rpc.QuotaFailure есть quotaMetric, quotaId и quotaDimensions, а рядом — RetryInfo с задержкой 3s. Это пример конкретного ответа из пользовательского обращения, а не универсальная JSON-схема и не подтверждённая причина вашего сбоя.

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

Проверьте ключ внутри процесса, который получает 429

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

1. Найдите, откуда клиент берёт ключ: из явно переданного параметра, переменной окружения, конфигурации провайдера или хранилища секретов. Если используется обёртка, проверьте её настройки и адрес API.
2. В AI Studio → API keys сопоставьте используемый ключ с проектом. Ориентируйтесь на ID проекта, а не только на похожее название. Не публикуйте значение ключа и не добавляйте его в диагностический журнал.
3. Проверьте наличие обеих переменных — GEMINI_API_KEY и GOOGLE_API_KEY. При автоматическом выборе официальными клиентскими библиотеками вторая имеет приоритет, если заданы обе. Явно переданный ключ и настройки сторонней обёртки нужно разбирать отдельно. Официальное руководство по ключам.
4. Если источник оказался неверным, исправьте конфигурацию именно отказавшего процесса и перезапустите его, чтобы загрузились новые значения. Для постоянных переменных Windows документация отдельно требует открыть новую сессию терминала. Проверьте также способ запуска IDE и сервера.

Следующий локальный фрагмент показывает только наличие переменных. Он не выводит секреты, не обращается к Google и не определяет проект ключа. Запускайте его в том окружении, где работает приложение; вывод из другого терминала не подтверждает окружение уже запущенного сервера.

import os

for variable_name in ("GEMINI_API_KEY", "GOOGLE_API_KEY"):
    print(f"{variable_name}: {'задана' if os.getenv(variable_name) else 'не задана'}")

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

Если нужного проекта нет в списке AI Studio, это ещё не означает, что он не существует в Google Cloud: по документации Gemini API о ключах AI Studio не показывает автоматически все проекты. Владелец может проверить существующий проект и импортировать его через Projects. Создание нового проекта ради обхода ограничения не является исправлением текущего доступа.

Что исправлять в Billing Tier и Status

Откройте Projects в AI Studio и выберите проект найденного ключа. Затем проверьте его платёжный аккаунт на странице Billing. Наличие потребительской подписки Gemini само по себе не подтверждает настройку оплаты проекта Developer API: проверять нужно связь проекта с Cloud Billing и назначенный ему платёжный план.

Смысл действий в столбцах Billing Tier и Status описан в руководстве Google по биллингу:

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

Если требуется предоплата

Следуйте плану, назначенному вашему аккаунту. Документация предусматривает Prepay, выбор между планами для подходящих аккаунтов и переходный Postpay; не следует считать, что у всех одинаковый процесс. Для описанной настройки Prepay указан минимальный платёж 5 USD или эквивалент в другой валюте. Условие восстановления — подтверждённая покупка кредитов и доступный баланс, а не только списание в банковском приложении. Настройка биллинга.

При нулевом балансе Prepay Google документирует остановку ключей всех связанных проектов с HTTP 402 Payment Required. Проекты при этом автоматически не переводятся на Free Tier. Пополнение баланса устраняет подтверждённую проблему предоплаты, но само по себе не доказывает причину отдельной ошибки free_tier_requests limit: 0. Что происходит при исчерпании Prepay.

Если вы начали переход на Prepay и закрыли окно после подтверждения, проверьте, завершён ли процесс. Google описывает состояние, при котором незавершённая настройка останавливает связанные проекты; автоматического возврата при отмене нет. Действие — закончить настройку либо обратиться в Cloud Billing Support для разбора состояния аккаунта. Бесконечный цикл «отключить оплату — включить снова» здесь не нужен. FAQ по биллингу.

Если деньги на балансе есть, а запросы остановились

Проверьте предупреждения об аккаунте и расходах. Положительный Prepay не отменяет месячный предел расходов и не защищает от приостановки Cloud Billing из-за неоплаченных счетов за другие сервисы Google Cloud. Месячный предел платёжного аккаунта учитывает расходы всех связанных проектов с включённым Gemini API; проектные ограничения расходов проверяются отдельно. Ограничения расходов и состояния оплаты.

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

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

Текст работает, а изображения получают limit 0

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

По состоянию на 5 октября 2026 года в официальных таблицах для gemini-3.1-flash-image, gemini-3.1-flash-lite-image и gemini-3-pro-image вход и выход на Free Tier отмечены как недоступные. Если запрос изображения фактически идёт из бесплатного проекта, уменьшение частоты не создаст бесплатный доступ. Нужно исправить выбор оплаченного проекта и проверить доступную ему квоту. Gemini 3.1 Flash Image, Flash Lite Image, Pro Image.

Откройте действующие лимиты в AI Studio для проекта ключа и найдите точную модель из ошибки. Сравните её название, уровень проекта и ограничение соответствующего режима: RPM, входные TPM, RPD, а для генерации изображений — применяемые модельные лимиты. Google указывает, что значения зависят от модели и текущего состояния проекта; опубликованная ёмкость не гарантирована. Не подставляйте старую таблицу «Tier 1 = 150–300 RPM и безлимит в сутки». Текущие правила лимитов.

Отдельно проверьте, поддерживается ли используемый ID. Для gemini-2.5-flash-image официальная страница указывает отключение 2 октября 2026 года и переход на 3.1 Flash Image или Flash Lite Image. На дату обновления этого руководства срок уже прошёл: старую модель не следует брать для контрольной проверки восстановления. Это документированный график, а не результат нашего вызова и не доказательство причины конкретного 429. Предупреждение о модели.

Если проект платный, конфигурация совпадает и нужная модель имеет доступную квоту, сохраните расхождение для поддержки. В обращении от 7 сентября 2026 года пользователь описал именно такой симптом: Tier 1 / Postpay в AI Studio, работающий текст и free_tier_requests limit: 0 для gemini-3.1-flash-lite-image. В ответе от 9 сентября попросили данные проекта для расследования. В этой теме нет опубликованного подтверждения общей причины или гарантированного исправления. Она подтверждает существование сообщения о сбое, а не универсальный «баг Google с февраля».

Когда ожидание поможет, а когда пора остановить повторы

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

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

Даже если ответ содержит RetryInfo, сначала учитывайте допустимый лимит. Рекомендованная задержка не отменяет ноль. Для временных ошибок используйте экспоненциальную задержку с небольшим случайным разбросом и пределом числа попыток; проверьте уже включённые повторы SDK, чтобы не добавить поверх них бесконечный внешний цикл. 503 UNAVAILABLE может быть временным отказом сервиса, но смена 429 на 503 ещё не означает успешную генерацию или подтверждённую платную квоту. Правила повторов Google.

Как проверить восстановление и продолжить работу

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

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

После успешной операции возвращайте рабочую нагрузку постепенно, с ограничением параллелизма. Следите за квотой и использованием того же проекта в AI Studio Usage. Если малая операция проходит, а параллельная нагрузка упирается в ненулевой лимит, задача уже изменилась: теперь нужно распределять нагрузку по реальной квоте, а не исправлять Free Tier с лимитом 0.

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

Переход на другой API требует собственной проверки модели, аутентификации, формата ответа, стоимости и обработки данных. Он не исправляет квоту исходного Google-проекта. Поэтому обещать, что Vertex AI или сторонний шлюз мгновенно снимет именно этот отказ, оснований нет.

Что передать поддержке при расхождении панели и API

Соберите компактное описание, позволяющее сопоставить два состояния:

• ID проекта и его платёжный статус, без значения API-ключа;
• точный ID модели, конечную точку и версию API/SDK;
• время отказа с часовым поясом и место запуска приложения;
• полное тело ошибки без секретов и пользовательских данных;
• снимок действующей квоты той же модели и проекта за соответствующий интервал;
• подтверждённые действия и их результат: исправление источника ключа, завершение оплаты, перезапуск процесса;
• дату подтверждения платежа, если проблема появилась при активации или переходе плана.

При незавершённом платёжном процессе или проблеме статуса аккаунта используйте официальный маршрут Cloud Billing Support. При техническом расхождении квоты можно обратиться на форум Gemini API, как предлагает руководство по устранению неполадок. Project ID передавайте через проверенный подходящий канал, если он нужен для расследования; сам ключ не отправляйте. Доступность технического обращения зависит от прав и условий поддержки аккаунта, поэтому роль владельца проекта не стоит считать гарантией доступа ко всем видам поддержки.

Часто задаваемые вопросы

Нужно ли создавать новый API-ключ после включения оплаты?

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

Я оплатил Gemini. Почему API всё ещё показывает бесплатный тариф?

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

Нужно ли ждать полуночи при limit 0?

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

Положительный баланс означает, что любая модель должна работать?

Нет. Баланс, состояние Cloud Billing, месячные ограничения расходов и квота конкретной модели — отдельные проверки. Для изображения необходимо подтвердить именно модель генерации изображения и её доступную квоту. Google прямо описывает остановку доступа при положительном Prepay из-за лимита или статуса аккаунта. FAQ по оплате.