Короткий ответ на 22 июля 2026 года: Россия не указана в текущем официальном списке доступных регионов Gemini API и Google AI Studio. Если вы фактически находитесь в России, остановитесь на этом шаге: не покупайте баланс и не меняйте регион, платёжный профиль или аккаунт ради обхода ограничения. Язык интерфейса, российская выдача Google и карта зарубежного банка не меняют условия доступности сервиса.
Если вы русскоязычный разработчик, который законно работает из поддерживаемого региона, не пытайтесь определить оплату по API key. Ключ относится к проекту; проект связан с Cloud Billing account; уже этот аккаунт задаёт план Prepay или Postpay, историю платежей, usage tier и общий лимит. Фактические значения вашего аккаунта находятся в авторизованных разделах Billing, Projects, Spend, Usage и Rate Limits Google AI Studio.
“Правило остановки: региона нет в официальном списке — не переходите к платёжным шагам. Регион поддерживается, но в AI Studio не виден проект или платёжный аккаунт — сначала восстановите право просмотра; не пополняйте случайный аккаунт.
Карточка состояния за 60 секунд
Откройте Google AI Studio и Cloud Billing в одной авторизованной сессии. Запишите шесть строк — они полезнее даты регистрации и любой статьи о «новой политике».
| Поле | Где смотреть | Что записать |
|---|---|---|
| Проект | AI Studio → Projects | Название и project ID, к которому относится рабочий ключ |
| Платёжный аккаунт | AI Studio → Billing / Projects | Точный связанный Cloud Billing account и его статус |
| Уровень | AI Studio → Billing или Rate Limits | Free, Tier 1, Tier 2 или Tier 3, показанный для проекта |
| План оплаты | AI Studio → Billing | Prepay или Postpay; не выводите план из Tier |
| Состояние денег | Billing / Spend | Для Prepay — доступный баланс и auto-reload; для Postpay — состояние способа оплаты и цикл списания |
| Активные ограничения | Spend / Rate Limits | Лимит проекта, общий cap аккаунта и текущие модельные лимиты — отдельными строками |
Карточка предотвращает три типичные ошибки. Несколько API keys не создают отдельные квоты; все они наследуют один проект. Несколько проектов могут расходовать общий cap одного billing account. А Cloud Billing account с обычным постоплатным циклом Google Cloud всё равно может иметь отдельный Prepay-контур именно для Gemini API. Поэтому название «Cloud Billing» ещё не доказывает Postpay для Gemini.
План оплаты и usage tier — разные оси
План оплаты отвечает на вопрос, когда появляются деньги:
- Prepay: сначала покупаются кредиты, затем usage списывается с баланса. Новым пользователям Google по умолчанию назначает этот план, но переходные и account-specific состояния возможны.
- Postpay: usage попадает в Cloud Billing и оплачивается по месячному циклу или при достижении платёжного порога.
Usage tier отвечает на другой вопрос: какие лимиты и общий месячный cap наследует проект от связанного billing account. Согласно текущей официальной документации по оплате Gemini API, квалификация выглядит так:
| Уровень | Условие квалификации аккаунта | Общий месячный cap billing account |
|---|---|---|
| Free | Активный проект или free trial | Платных расходов нет |
| Tier 1 | Связан активный billing account | $250 |
| Tier 2 | Оплачено от $100 и прошло не менее 3 дней после первого успешного платежа | $2 000 |
| Tier 3 | Оплачено от $1 000 и прошло не менее 30 дней после первого успешного платежа | $20 000–$100 000 |
Суммы и сроки в этой таблице проверены 22 июля 2026 года и могут измениться. Для Tier 2 и Tier 3 считается накопленный расход Google Cloud на уровне связанного billing account, а не только токены Gemini и не расход одного проекта. Повышение обычно происходит автоматически после выполнения обоих условий; отображение может задержаться примерно на 10 минут, а повышенная квота не гарантируется доступностью мощностей.
Tier 3 не означает автоматический Postpay. Google описывает его как возможную eligibility, но ручное переключение сейчас временно отключено. Если ваш экран показывает Prepay, план остаётся Prepay независимо от Tier. Если экран когда-либо предложит переход на Postpay, сначала прочитайте актуальные последствия: обратное переключение того же billing account может быть недоступно.
Нужны цены конкретной модели, контекста, кэша, batch или медиа? Они принадлежат отдельному справочнику по ценам Gemini API. Здесь цена токена намеренно не используется для определения плана или Tier.
Что происходит в Prepay
В Prepay платный вызов начинается не с выставления счёта, а с положительного баланса. На дату проверки официальная страница показывает покупку от $10 в местном эквиваленте, верхнюю границу $5 000, срок действия кредитов 12 месяцев и optional auto-reload. Точные доступные суммы, валюта, налоги и способ оплаты определяет ваш экран checkout — публичная долларовая граница не обещает конкретный российский или местный платёжный маршрут.
При балансе 0 останавливаются API keys во всех проектах, связанных с этим billing account. Проекты не возвращаются автоматически на Free. Если платный режим больше не нужен, проверьте явное отключение billing для проекта; если нужен, пополните правильный аккаунт из поддерживаемого региона. Не создавайте новый ключ: он унаследует ту же остановленную связь.
Auto-reload снижает риск случайной паузы, но его месячный предел ограничивает только автоматические пополнения. Ручные покупки в этот предел не входят. Кроме того, учёт расхода не мгновенный: задержка около 10 минут может дать небольшой отрицательный остаток, а длинная batch- или agent-задача может завершать уже начатую работу.
Промокредиты Google Cloud — не универсальная замена баланса. Для eligible credits сначала нужен положительный Prepay balance; при нуле их расход тоже прекращается. Welcome credit на $300 для аккаунтов, открытых после 2 марта 2026 года, не применяется к Gemini API и AI Studio. Проверяйте тип и правила конкретного кредита, а не только его видимость в Cloud Console.
Что происходит в Postpay
Postpay не требует заранее поддерживать кредитный баланс: платный usage передаётся в Cloud Billing и списывается по циклу или threshold. Но отсутствие prepaid balance не означает отсутствие причин остановки. Просроченный платёж, отклонённая или истёкшая карта либо неактивный общий billing account могут приостановить Gemini API. По официальному billing guide, проблема оплаты других сервисов Google Cloud способна затронуть Gemini даже при оставшихся Prepay credits.
Project spend cap — отдельный контроль проекта
AI Studio может показывать экспериментальный project spend cap, но функция имеет ограниченную, account-specific доступность и не должна привязываться только к Prepay или Postpay без подтверждения в текущем UI. Cap управляет одним проектом, требует подходящих IAM-прав и может сработать с задержкой примерно 10 минут. Это защитная граница, но не обещание нулевого перерасхода.
При переносе проекта на другой billing account сохранённое значение project cap может остаться, а накопленный счётчик проекта для нового цикла начинается заново; одновременно проект наследует plan, Tier и общий cap нового аккаунта. Перед настройкой проверьте, доступен ли этот control именно для выбранного проекта и аккаунта в авторизованном AI Studio.
Шесть ограничителей, которые нельзя называть одним «бюджетом»
| Механизм | Уровень | Что делает | Чего не гарантирует |
|---|---|---|---|
| Prepay balance | Billing account для Gemini API | Оплачивает usage до исчерпания | Мгновенный учёт и автоматический возврат на Free |
| Auto-reload monthly limit | Пополнение Prepay | Ограничивает сумму автоматических покупок | Не включает ручные покупки и не равен usage cap |
| Billing-account monthly cap | Общий Tier | Суммирует Gemini usage связанных проектов; при достижении ставит их на паузу до нового цикла | Отдельный бюджет каждого проекта |
| Project spend cap | Один проект; ограниченная account-specific доступность | Экспериментально ограничивает месячный расход проекта | Нулевой overshoot и доступность для каждого аккаунта |
| Cloud Billing budget | Выбранная область Cloud | Отслеживает расход и отправляет threshold alerts | Автоматическую остановку API |
| Spend-rate limit | Один проект | Ограничивает скорость денежного расхода в скользящем окне | Месячный контроль стоимости |
Документация Cloud Billing Budgets прямо предупреждает: budget не ставит жёсткий предел usage. Программные уведомления позволяют построить автоматизацию, но они могут запаздывать или дублироваться. Отключение billing как автоматическая реакция способно остановить сервисы и повлиять на ресурсы, поэтому сначала тестируйте такой сценарий вне production и проектируйте восстановление.
Spend-rate — это отдельный rate limit. Сейчас Google публикует для скользящего 10-минутного окна $10 в Tier 1 и $200 в Tier 2/3. Его достижение возвращает 429 RESOURCE_EXHAUSTED; это не означает нулевой баланс или месячный cap. Актуальное значение и модельные RPM/TPM/RPD проверяйте в AI Studio. Разбор 429 и стратегии повторов вынесены в руководство по лимитам Gemini API.
Матрица: почему запросы остановились
| Наблюдение | Что проверить первым | Безопасное следующее действие |
|---|---|---|
| Вы физически в неподдерживаемом регионе | Официальный список регионов | Остановиться; не обходить ограничение и не покупать credits |
| AI Studio не показывает billing account | Project ID, права IAM, связь проекта | Восстановить доступ к правильному проекту; не пополнять другой аккаунт наугад |
| Prepay balance равен 0 | Billing account и все связанные проекты | Пополнить допустимым способом либо осознанно отключить paid billing, если доступно |
| Cloud credit виден, но Gemini не работает | Eligibility кредита и положительный Prepay balance | Прочитать правила кредита; не считать его универсальными деньгами Gemini |
| Postpay показывает failed/overdue payment | Payment Overview и статус billing account | Исправить платёжную проблему у владельца аккаунта |
Приходит 429 RESOURCE_EXHAUSTED, баланс положительный | Active Rate Limits, RPM/TPM/RPD и spend-rate | Снизить нагрузку или следовать rate-limit диагностике; не покупать credits вслепую |
| Достигнут project spend cap | Spend конкретного проекта и задержка метеринга | Дождаться цикла или изменить cap с учётом риска; проверить причину всплеска |
| Достигнут общий cap Tier | Совокупный расход всех связанных проектов | Планировать до первого дня нового цикла либо проверять eligibility более высокого Tier |
| Сработал budget alert, запросы продолжаются | Порог и область Cloud Budget | Это ожидаемо: принять решение вручную или использовать протестированную автоматизацию |
Ошибки 400 FAILED_PRECONDITION, 403 PERMISSION_DENIED, 500, 503 и 504 имеют другие причины и не должны автоматически называться проблемой Tier. Даже неуспешные 400/500 могут учитываться в квоте, хотя токены за них не списываются. Сопоставляйте код ошибки с текущим статусом проекта.
Практическая настройка без ложного «жёсткого лимита»
Для production-проекта используйте несколько независимых сигналов:
- Запишите владельца billing account и канал исправления failed payment.
- Для Prepay задайте auto-reload только после расчёта допустимой суммы автоматических покупок; отдельно контролируйте ручные покупки.
- Если AI Studio показывает эту функцию для выбранного проекта, установите project spend cap независимо от предположений о plan, оставив резерв на задержку метеринга.
- Настройте Cloud Budget как раннее предупреждение, а не как stop-механизм.
- Отслеживайте usage на стороне приложения: project ID, model, tokens, retries, статус ответа и собственный безопасный порог.
- Тестируйте поведение при остановке: очередь, повтор, пользовательское сообщение и восстановление после пополнения или нового цикла.
Данные в AI Studio синхронизируются с разной скоростью: баланс обычно обновляется за минуты, изменение Tier — примерно до 10 минут, а детальная разбивка стоимости может отставать до 24 часов. Не делайте второй платёж или резкое повышение cap только потому, что один график ещё не догнал другой.
Итоговый маршрут
Сначала регион. Затем карточка API key → проект → billing account. После этого выбирайте ветку по полю, которое реально показано в AI Studio:
- Free: проверьте, хватает ли бесплатной доступности и лимитов; детали — в руководстве по бесплатному уровню Gemini API.
- Paid + Prepay: проверьте баланс, auto-reload и eligibility credits; только затем Tier и rate limits.
- Paid + Postpay: проверьте payment health и общий cap Tier.
- Project spend cap доступен в текущем UI: проверьте его отдельно на уровне проекта при любом назначенном plan.
- Billing исправен, но 429: диагностируйте активный project/model limit, а не оплату.
Статья фиксирует публичные правила на 22 июля 2026 года. Ваш авторизованный экран остаётся источником истины для назначенного плана, валюты, налогов, способа оплаты, текущих лимитов и доступности функций.
