Как получить ключи Gemini API для всех уровней: Free, Tier 1, Tier 2 и Tier 3 — полное руководство (2026)

Получить ключ Gemini API для бесплатного доступа несложно, но путь от Free до Tier 1, Tier 2 и Tier 3 включает конкретные требования к биллингу, которые вызывают затруднения у многих разработчиков. Бесплатный уровень даёт 15 запросов в минуту без кредитной карты. Tier 1 активируется сразу после подключения биллинга к проекту Google Cloud. Tier 2 требует реальных расходов на API в размере $250 — важно отметить, что бесплатные пробные кредиты Google Cloud не учитываются. Tier 3 требует $1000 расходов и нередко предполагает обращение к команде продаж Google для получения доступа к моделям с наивысшей пропускной способностью. В этом руководстве подробно рассмотрены все шаги для каждого уровня, актуальные ограничения запросов, точные пути обновления и раздел по настройке безопасности, который большинство руководств игнорирует.

Краткое содержание

• Бесплатный уровень: кредитная карта не нужна, 15 RPM / 1500 RPD для Gemini 2.0 Flash (проверено в марте 2026)
• Tier 1: подключите биллинг к проекту Google Cloud — ограничения сразу возрастут до 150–2000 RPM
• Tier 2: нужно реально потратить $250 на API (кредиты не считаются) + 30 дней активного биллинга
• Tier 3: нужно реально потратить $1000 — для некоторых моделей требуется обращение в Google Sales
• Безопасность: всегда устанавливайте ограничения по IP, HTTP Referer или сервисам API

Понимание четырёхуровневой системы прав Gemini API

Gemini API использует четырёхуровневую систему, определяющую ограничения запросов, доступные модели и доступ к расширенным функциям. Каждый уровень привязан к истории биллинга конкретного проекта Google Cloud, а не к личному аккаунту. Это важно понимать, поскольку многие разработчики ошибочно полагают, что бесплатные пробные кредиты Google Cloud ($300) засчитываются при обновлении уровня — это не так. Прогресс по уровням отслеживается отдельно на основе реальных списаний с платёжного метода.

Числовая характеристика уровней: бесплатный уровень даёт 15 запросов в минуту и 1500 запросов в день для Gemini 2.0 Flash (проверено по документации Google AI Studio, март 2026). После подключения биллинга вы сразу переходите на Tier 1: 150 RPM для Gemini 2.0 Flash и до 2000 RPM для некоторых вариантов Flash. Tier 2 активируется после $250 реальных расходов при условии, что биллинг активен не менее 30 дней. Tier 3 активируется после $1000 расходов и открывает наивысшие доступные квоты. Подробнее об ограничениях бесплатного уровня читайте в нашем руководстве по ограничениям бесплатного уровня Gemini API.

Четыре уровня также различаются по доступным моделям. Бесплатный уровень ограничивает доступ к части моделей Gemini и исключает некоторые экспериментальные или предварительные версии. Tier 1 открывает доступ ко всему производственному каталогу моделей. Tier 2 и Tier 3 увеличивают квоты для вычислительно интенсивных моделей — Gemini 2.0 Flash Thinking и Gemini 1.5 Pro, которые имеют более высокую стоимость токена. Если вы создаёте производственное приложение, для которого важны задержка и пропускная способность, понимание нужного уровня до начала разработки сэкономит много времени.

*«Без лимита RPD» означает отсутствие суточного ограничения; поминутные лимиты по-прежнему действуют.

Важная архитектурная деталь: ключ API привязан к конкретному проекту Google Cloud, и биллинговый аккаунт этого проекта определяет уровень. При наличии нескольких проектов каждый оценивается независимо. Проект с включённым биллингом и $300 расходов находится на Tier 2, тогда как другой проект в том же Google-аккаунте без расходов остаётся на Free. Это означает, что командные среды обычно нуждаются в выделенных проектах для каждой среды (разработка, тестирование, производство) с отдельным отслеживанием биллинга.

Как создать первый ключ Gemini API в Google AI Studio

Создание ключа Gemini API занимает менее пяти минут и требует только учётной записи Google. Весь процесс проходит через Google AI Studio — интерфейс Google для разработчиков Gemini API. Не нужно заходить в Google Cloud Console для получения первого ключа — это необходимо только для настройки ограничений безопасности или управления порогами биллинга.

Откройте Google AI Studio по адресу aistudio.google.com и войдите в Google-аккаунт. На главном экране AI Studio вы увидите последние подсказки и площадку для работы с моделями. На левой боковой панели в верхней части есть ссылка «Получить API-ключ» — нажмите на неё. Если панель не видна, поищите значок меню в верхнем левом углу или перейдите напрямую по адресу aistudio.google.com/apikey.

На странице API-ключей вы увидите ранее созданные ключи и проекты Google Cloud, к которым они принадлежат. Нажмите кнопку «Создать API-ключ» в правом верхнем углу. Появится диалог с просьбой выбрать проект Google Cloud. Если проект уже есть, выберите его из выпадающего списка. Если начинаете с нуля, выберите «Создать API-ключ в новом проекте» — Google автоматически создаст проект с именем наподобие «Мой первый проект».

После подтверждения Google сгенерирует ключ API и отобразит его в диалоге. Немедленно скопируйте ключ и сохраните его надёжно — после закрытия диалога Google больше никогда не покажет полный ключ. Если потеряете его, придётся удалить старый ключ и создать новый. Распространённые способы хранения: переменные среды (самый безопасный для локальной разработки), менеджер секретов (например, AWS Secrets Manager или HashiCorp Vault) для production-среды, либо файл .env, добавленный в .gitignore. Никогда не вшивайте ключ API в исходный код и не передавайте его в систему контроля версий.

После копирования ключа его можно сразу проверить с помощью простого запроса curl или Python SDK:

bash
curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key=YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{"contents": [{"parts": [{"text": "Привет"}]}]}'

Успешный ответ возвращает JSON-объект с ответом модели. Ошибка 400 API key not valid означает, что ключ скопирован не полностью — ключи API чувствительны к регистру и содержат буквы и цифры. Ошибка 429 RESOURCE_EXHAUSTED на этом этапе обычно означает, что квота бесплатного уровня уже исчерпана, что можно проверить на панели квот Google AI Studio.

Ваш новый ключ автоматически начинает работу на бесплатном уровне. Его можно сразу использовать для разработки, экспериментов и приложений, где достаточно 15 RPM. Для большинства индивидуальных разработчиков, создающих личные проекты или прототипы, бесплатный уровень справляется с умеренными нагрузками без каких-либо затрат.

Переход на Tier 1 — включите биллинг для мгновенного доступа

Tier 1 — первый платный уровень, и переход на него проще, чем ожидает большинство разработчиков. Единственное требование — включить биллинг в проекте Google Cloud, к которому привязан ключ API. Нет порога расходов, нет периода ожидания, нет процесса подачи заявки. Как только к проекту будет привязан действующий способ оплаты, ограничения запросов для ключа API сразу увеличатся.

Настройка биллинга происходит в Google Cloud Console, а не в AI Studio. Откройте console.cloud.google.com и убедитесь, что выбран нужный проект — переключатель проектов находится в верхней панели навигации. Перейдите в раздел «Биллинг» на левой боковой панели и нажмите «Связать платёжный аккаунт». Если платёжный аккаунт Google Cloud уже есть от других сервисов Google, можно привязать его. В противном случае система предложит создать новый аккаунт, введя данные кредитной карты или банковского счёта.

После привязки платёжного аккаунта вернитесь в AI Studio по адресу aistudio.google.com/apikey. Существующие ключи API не изменятся — тот же ключ теперь работает с квотами Tier 1. Убедиться в успешном обновлении можно, проверив страницу квот или запустив нагрузочный тест: если удаётся отправить более 15 запросов в минуту без ошибок 429, обновление прошло успешно.

Разница в стоимости между использованием Gemini на Free и Tier 1 — не в абонентской плате: Google списывает средства за потреблённые токены. Для Gemini 2.0 Flash входящие токены стоят $0,075 за миллион, исходящие — $0,30 за миллион (страница цен Google AI Studio, март 2026). При умеренном использовании ежемесячный счёт составит несколько долларов или меньше. Вы платите только за использование, базовой платы за активированный биллинг нет. Хорошей практикой является настройка оповещений о расходах в Google Cloud Console: перейдите в Биллинг > Бюджеты и оповещения и создайте оповещение на комфортном для вас пороге — например, $10 или $50.

Частый вопрос: засчитывается ли бесплатный пробный кредит Google Cloud как «включённый биллинг» для Tier 1? Ответ — да: если к проекту привязан платёжный аккаунт (даже если на нём ещё есть пробный кредит), ключ API работает на Tier 1. Это разграничение важно для Tier 2 и Tier 3, где пороги $250 и $1000 основаны на реальных списаниях с платёжного метода, а не на потреблении кредитов.

Включив биллинг и убедившись в получении Tier 1, стоит также изучить процесс запроса увеличения квот. В Google Cloud Console можно запросить квоты выше стандартных лимитов Tier 1 для конкретных моделей. Перейдите в APIs & Services > Quotas, отфильтруйте по «Generative Language API» и подайте заявку на увеличение нужных параметров квоты. Полное руководство по увеличению квот читайте в нашей статье как увеличить квоту Gemini API.

Достижение Tier 2 — требование накопленных расходов $250

Tier 2 — уровень, который удивляет разработчиков больше всего, поскольку путь к нему предполагает конкретную сумму реальных расходов на API, что не очень очевидно из документации Google. Для перехода на Tier 2 проект Google Cloud должен иметь накопленные реальные расходы на API в размере $250 или более, а платёжный аккаунт должен быть активен не менее 30 дней. Оба условия должны выполняться одновременно.

Самая важная оговорка касается того, что засчитывается в $250. Бесплатный пробный кредит Google Cloud ($300, начисляемый новым аккаунтам) не засчитывается. Промокредиты, кредиты по реферальным программам и любые другие виды бесплатных кредитов не учитываются. Только реальные расходы — суммы, списанные с вашего платёжного метода после исчерпания кредитов, — накапливаются для обновления уровня. Это различие вызывает значительную путаницу, поскольку с пробным кредитом $300 легко потратить сотни «долларов» в интерфейсе Cloud Console, не потратив реальных денег.

Расчёт реального пути к $250: при ценах Gemini 2.0 Flash ($0,075 за миллион входящих токенов, $0,30 за миллион исходящих) нужен значительный объём использования для накопления $250. Типичный чат-бот, обрабатывающий 1000 разговоров в день по 500 входящих и 200 исходящих токенов каждый, генерирует примерно $0,20 расходов в день — до $250 органически придётся ждать более трёх лет. Для большинства разработчиков практический путь к Tier 2 — либо реально высоконагруженный рабочий процесс, либо намеренное выполнение ресурсоёмких задач для ускорения расходов.

Некоторые разработчики используют Gemini 2.5 Pro или другие дорогостоящие модели для более быстрого достижения порога. Gemini 2.5 Pro стоит значительно дороже за токен, чем Flash, поэтому обработка больших объёмов текста через Pro-модели накапливает расходы намного быстрее. Однако это оправдано только при реальной необходимости в таких возможностях. Если Tier 2 нужен немедленно для production-деплоя, практичнее обратиться в Google Cloud Sales.

Требование 30 дней отсчитывается с момента первого включения биллинга в проекте, вне зависимости от расходов. Нельзя включить биллинг сегодня и ожидать получения Tier 2 завтра, даже если каким-то образом потратить $250 за один день. Оба условия — реальные расходы $250 И более 30 дней истории биллинга — должны выполняться одновременно. Google автоматически отслеживает пороги обновления уровней; никакого ручного процесса одобрения нет. Ограничения запросов обновляются автоматически после выполнения обоих условий.

Для разработчиков, которым нужна пропускная способность Tier 2 без выполнения требований по расходам, некоторые сторонние сервисы агрегации API предлагают доступ к моделям Gemini с более высокими лимитами запросов. Например, laozhang.ai агрегирует несколько AI-моделей, включая варианты Gemini, по конкурентной стоимости токена — без системы ограничений по уровням, что удобно для команд, которым нужна более высокая пропускная способность до органического достижения расходов Tier 2.

Tier 3 и корпоративный доступ

Tier 3 — наивысший самообслуживаемый уровень, доступный через стандартную систему биллинга Google Cloud. Требование — накопленные реальные расходы на API в размере $1000 в проекте Google Cloud, с той же оговоркой о незасчёте кредитов, что и для Tier 2. На Tier 3 вы получаете наивысшие стандартные квоты для всех моделей Gemini, включая самые вычислительно затратные.

Ограничения запросов Tier 3 зависят от конкретной модели. Для Gemini 2.0 Flash Tier 3 предоставляет 2000 RPM или выше. Для Gemini 1.5 Pro и Gemini 2.5 Pro Tier 3 открывает значительно более высокую пропускную способность по сравнению с Tier 2. Точные цифры меняются с обновлениями инфраструктуры Google, поэтому всегда проверяйте актуальные лимиты на странице квот Google Cloud Console, а не в статической документации.

Для нагрузок, превышающих даже квоты Tier 3, Google предлагает дополнительные запросы на увеличение квот сверх стандартных лимитов. Запросы подаются через систему Google Cloud Console с деловым обоснованием. Для очень высоконагруженных сценариев — приложений, обрабатывающих миллионы запросов в день — Google рекомендует обратиться в корпоративный отдел продаж. Корпоративные соглашения могут включать настраиваемые лимиты запросов, варианты выделенной инфраструктуры, гарантии SLA и переговоры по ценам, недоступные через стандартный путь биллинга.

Безопасность ключей API — настройка прав и ограничений

Настройка безопасности ключей Gemini API происходит в Google Cloud Console и является одним из наименее задокументированных аспектов работы с Gemini API. Ключ без ограничений может использоваться кем угодно, получившим к нему доступ, с любого IP-адреса, для вызова любого Google API, включённого в вашем проекте. Установка ограничений превращает универсальные учётные данные в узкоспециализированный токен, которым значительно сложнее злоупотребить.

Google Cloud Console предлагает три типа ограничений для ключей API, которые можно комбинировать. Откройте console.cloud.google.com, выберите проект, перейдите в APIs & Services > Credentials, щёлкните по ключу API, затем нажмите «Изменить API-ключ».

Ограничения по IP-адресу позволяют указать один или несколько IPv4- или IPv6-адресов или диапазонов CIDR, с которых ключ будет принимать запросы. Идеально для серверных приложений на известной инфраструктуре — если сервер приложений всегда делает вызовы Gemini API с фиксированного IP (распространено в облачных VM, кластерах Kubernetes со статическими исходящими IP или корпоративных сетях), можно ограничить ключ этим IP. Введите IP в стандартном формате или CIDR (например, 203.0.113.42 для одного IP или 10.0.0.0/24 для подсети). Запросы с IP, не входящих в список, получат ошибку 403 IP_ADDRESS_NOT_IN_WHITELIST.

Ограничения по HTTP Referer позволяют указать, каким доменам разрешено использовать ключ API. Предназначены для клиентского JavaScript-кода, вызывающего API напрямую из браузера. Укажите домен как https://yourdomain.com/* для всех страниц или https://yourdomain.com/specific-path/* для подмножества. Ограничение проверяет HTTP-заголовок Referer — это слабее, чем IP-ограничения, поскольку заголовок можно подделать, но оно всё же является значимым барьером против случайного злоупотребления.

Ограничения по API ограничивают, какие API Google может вызывать ключ. По умолчанию новый ключ может вызывать любой Google API, включённый в проекте. Если приложение использует только Gemini API, следует ограничить ключ конкретно «Generative Language API». Это означает, что даже в случае компрометации ключа злоумышленник не сможет использовать его для доступа к Google Maps, Google Drive или другим API. Для настройки в разделе «Ограничения API» выберите «Ограничить ключ», затем из списка выберите «Generative Language API».

Наиболее безопасная конфигурация объединяет все три типа ограничений: ограничение по IP-диапазону приложения, ограничение по домену Referer для веб-интерфейса и ограничение области API до Generative Language API. Для production-приложений такой трёхуровневый подход означает, что скомпрометированный ключ принесёт злоумышленнику минимальную пользу.

Регулярная ротация ключей API — также хорошая практика, особенно для долго работающих приложений. Создайте новый ограниченный ключ, обновите переменные среды приложения, убедитесь в работоспособности нового ключа в production, затем удалите старый. Весь процесс занимает около десяти минут и значительно сокращает временно́е окно риска в случае случайного раскрытия старого ключа.

Региональная доступность и географические ограничения

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

Для разработчиков в России и СНГ прямой доступ к Gemini API в целом доступен, но могут возникать задержки из-за маршрутизации через серверы в США. Стандартная конечная точка Gemini API размещена в США. Разработчики в Европе, Азии или России могут наблюдать задержки 300–800 мс для простых запросов, что приемлемо для асинхронной обработки, но заметно для приложений с интерактивным чатом в реальном времени.

Google Vertex AI — корпоративная AI-платформа Google — предлагает модели Gemini с настраиваемыми параметрами размещения данных (ЕС, США и т. д.) и нередко является правильным выбором для организаций со строгими требованиями к управлению данными. Версия Gemini в Vertex AI использует аутентификацию OAuth через сервисные аккаунты вместо ключей API, предполагает иную структуру ценообразования и другой подход к интеграции.

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

Решение типичных проблем

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

Биллинг отклонён / кредитная карта отклонена: если при попытке включить биллинг способ оплаты отклонён, убедитесь, что карта поддерживает международные платежи и платёжный адрес соответствует записям в банке. Google Cloud выставляет счета в долларах, у некоторых карт есть ограничения на международные транзакции. Во многих регионах Google Pay и PayPal принимаются как альтернативные способы оплаты. Если карта систематически отклоняется, помогает звонок в банк с просьбой добавить Google LLC в белый список.

Tier 1 не активируется после подключения биллинга: обновление уровня обычно вступает в силу в течение нескольких минут после привязки платёжного аккаунта. Если через 10–15 минут видны прежние лимиты, проверьте в Google Cloud Console, что платёжный аккаунт действительно привязан к нужному проекту. Перейдите в Консоль > Биллинг > Мои проекты и подтвердите, что целевой проект указан с активным биллингом. Также убедитесь, что ключ API связан с этим проектом (видно на странице API-ключей AI Studio рядом с каждым ключом).

Ошибки ограничения запросов (429 RESOURCE_EXHAUSTED): наиболее распространённая ошибка в разработке. На бесплатном уровне 429 означает превышение 15 RPM или 1500 RPD. На Tier 1 ошибки 429 обычно указывают на пиковый трафик, превышающий поминутный лимит. Стандартное решение — экспоненциальный откат: подождать 1 секунду, повторить попытку; при следующей неудаче ждать 2 секунды, затем 4, затем 8. Подробное руководство по исправлению ошибок 429 в Gemini API охватывает расширенные стратегии, включая очередь запросов и многоключевые конфигурации.

Ключ API возвращает ошибки 403 после добавления ограничений: если после добавления IP или Referer-ограничений появляются ошибки 403, наиболее распространённая причина — несоответствие между настроенным ограничением и фактическим источником запроса. Для IP-ограничений проверьте исходящий IP вашего приложения через сервис наподобие ifconfig.io — облачная инфраструктура часто имеет разные внутренние и внешние IP, и ваш предполагаемый IP может не совпадать с тем, что видит Google. Для Referer-ограничений убедитесь, что заголовок Referer приложения в точности совпадает с настроенным шаблоном, включая протокол (http или https) и завершающий знак подстановки.

Медленное обновление до Tier 2 или Tier 3: если вы полагаете, что превысили порог $250 или $1000, но не видите обновления уровня, сначала проверьте расходы в Google Cloud Console > Биллинг > Отчёты. Отфильтруйте по «Generative Language API» для просмотра только расходов на Gemini. Помните, что кредиты уменьшают эффективные расходы. Также убедитесь, что платёжный аккаунт активен более 30 дней. Обновления уровней автоматические, но могут занять до 24 часов после достижения порогов.

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

В: Можно ли использовать пробный кредит Google Cloud ($300) для достижения Tier 2?

Нет. Пробный кредит $300, который Google предоставляет новым аккаунтам Google Cloud, не засчитывается в пороги обновления уровней $250 или $1000. Google отслеживает право на уровень на основе реальных списаний с платёжного метода после исчерпания кредитов. Это одно из наиболее распространённых заблуждений о системе уровней Gemini API.

В: Если я создам новый ключ API, он начнёт работать на Free, даже если мой проект уже на Tier 2?

Нет. Ключи API наследуют уровень проекта, к которому принадлежат. Если проект соответствует Tier 2, любой ключ, созданный в этом проекте, — как новый, так и существующий — работает на Tier 2. Уровень является свойством проекта, а не отдельных ключей.

В: Можно ли иметь несколько ключей API в одном проекте? Они делят лимит запросов?

Да, лимиты запросов объединены на уровне проекта для всех ключей API. Если у проекта лимит 150 RPM для Gemini 2.0 Flash, и три ключа одновременно отправляют запросы, их суммарный объём не может превышать 150 RPM. Эта архитектура намеренная — она предотвращает обход ограничений уровня через увеличение числа ключей.

В: Сколько времени занимает активация Tier 2 или Tier 3 после превышения порога?

Система Google автоматически отслеживает пороги уровней и обычно обновляет уровень проекта в течение нескольких часов после достижения требуемых расходов. В отдельных случаях это может занять до 24 часов. Никакого ручного триггера или заявки не требуется. Можно следить за текущим уровнем, проверяя значения квот в Google Cloud Console > APIs & Services > Quotas > Generative Language API.

В: Есть ли способ проверить текущий уровень, не тестируя ограничения запросов?

Да. В Google Cloud Console перейдите в APIs & Services > Quotas и отфильтруйте по «Generative Language API». Показанные значения квот соответствуют текущему уровню. Например, если «Запросы на генерацию контента в минуту» для Gemini 2.0 Flash показывает 15 — вы на бесплатном уровне. Если показывает 150 или выше — на Tier 1 или выше.

Начало работы: следующие шаги

Понимание системы уровней Gemini API позволяет принимать взвешенные решения об архитектуре приложения и планировании расходов с самого начала. Бесплатный уровень реально полезен для обучения, прототипирования и приложений с небольшой нагрузкой — 15 RPM и 1500 запросов в сутки справляются с большим объёмом задач, чем многие ожидают. Tier 1 требует только платёжного аккаунта и обеспечивает 10-кратное увеличение лимитов при оплате по факту использования.

Для команд, планирующих production-деплой, практическая рекомендация — включить биллинг сразу же (ещё до появления значительного трафика), чтобы запустить 30-дневный отсчёт к праву на Tier 2. Настройте ключи API с соответствующими ограничениями с первого дня: IP-ограничения для серверных приложений, Referer-ограничения для любых фронтенд-компонентов и ограничение области API до Generative Language API для всех ключей. Эти практики занимают 10 минут на настройку и существенно снижают риски безопасности по мере роста приложения.

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