API key Google AI Studio, который вы получаете одним кликом в интерфейсе для экспериментов с промптами, и ключ, который должен лежать в коде вашего продукта, технически один и тот же объект. Но живут они по разным правилам. В интерфейсе лимиты щадящие, а ошибка просто перезапускает запрос вручную. В продукте та же ошибка роняет фичу у реальных пользователей, а счёт за токены приходит не вам лично, а бизнесу.
Разработчику, который встраивает Gemini в свой сервис, нужен не «доступ к нейросети», а управляемый ресурс: ключ с понятными лимитами, привязанный биллинг, политика хранения секрета и план действий на случай утечки. Разница с историей про бесплатный доступ для обычного пользователя примерно такая же, как между личной картой и корпоративным счётом с лимитами на операции. Если вы впервые настраиваете такой доступ, разумно сразу закладывать контроль над расходами и безопасностью ключа в архитектуру продукта, а не добавлять его постфактум.
Дальше: как получить API-ключ Google AI Studio, какие тарифы и лимиты у него есть, как подключить биллинг, где обычно спотыкаются при интеграции и как хранить ключ так, чтобы он не оказался в публичном репозитории.
Как получить API key Google AI Studio
Ключ создаётся на сайте ai.google.dev через кнопку Get API key в интерфейсе Google AI Studio. Для разработчика процесс занимает несколько минут, но каждый шаг имеет последствия для того, как ключ будет вести себя в проде.
- Войдите в Google AI Studio под аккаунтом Google, который будет владеть проектом и биллингом, а не личным аккаунтом, который может позже понадобиться для других целей.
- Нажмите Get API key и выберите существующий проект Google Cloud или создайте новый специально под продукт.
- Скопируйте сгенерированную строку ключа и сразу положите её в менеджер секретов, а не в заметки или чат.
- Откройте настройки ключа и ограничьте его одним API и источником запросов, прежде чем ставить в код.
После создания ключа стоит сразу открыть раздел лимитов в интерфейсе AI Studio и посмотреть, какие модели доступны проекту: набор моделей и их ограничения отличаются между проектами и тарифами, и эта проверка на старте экономит время при интеграции.
Если вы уже читали про бесплатный доступ к Google AI Studio через интерфейс, разница начинается именно здесь: ключ для продукта с первого дня привязан к проекту Google Cloud, а не существует сам по себе ради личных экспериментов.
Проект Google Cloud и привязка биллинга
Проект в Google Cloud, это контейнер, к которому привязывается и ключ, и платёжный аккаунт. Пока биллинг не подключён, вы работаете на бесплатном тарифе с ограниченным доступом к моделям. Как только подключаете оплату, проект наследует условия биллинг-аккаунта.
Настройка биллинга состоит из нескольких шагов: переход на страницу API-ключей или проектов, нажатие Set up billing, выбор или создание платёжного аккаунта, выбор режима Prepay или Postpay. Для Prepay требуется минимальное пополнение 5 долларов. Нужен действующий способ оплаты, привязанный к поддерживаемой стране. Режим Postpay требует дополнительной проверки аккаунта и истории использования, поэтому для новых проектов обычно проще стартовать с Prepay и перейти на Postpay позже, когда накопится история трат.
Для аккаунтов из России это часто первая практическая преграда: прямой способ оплаты через российский банк недоступен, и привязку биллинга обычно решают через юрлицо, зарегистрированное в поддерживаемой стране, или через карту другого банка, подключённую к такому юрлицу. Это организационный, а не технический вопрос, и закрыть его стоит заранее, до того как бесплатный тариф начнёт ограничивать продукт на живом трафике.
Бесплатный и платный тариф: в чём разница на практике
Разница не только в лимитах. Она в том, как Google обращается с содержимым ваших запросов.
| Параметр | Free tier | Paid tier |
|---|---|---|
| Доступ к моделям | ограниченный набор | полный каталог моделей |
| Использование контента | используется для улучшения продуктов Google | не используется для улучшения продуктов Google |
| Лимиты запросов | минимальные | растут вместе с тратами |
| Нужен способ оплаты | нет | да |
Для продукта, который работает с чужими или коммерческими данными, пункт про использование контента часто решающий: на бесплатном тарифе ваши запросы и ответы могут использоваться Google для улучшения сервисов, на платном, нет. Если продукт строится вокруг ответов по собственным документам компании, прежде чем выбирать тариф, стоит посмотреть, как это устроено, например в материале о том, что такое RAG простыми словами: там видна прямая связь между моделью и источником данных, с которым работает ключ.
На практике большинство продуктовых команд подключают платный тариф ещё до первого релиза, даже при небольшой нагрузке: сам факт платного режима меняет правила обработки данных, а не только размер лимитов.
Лимиты запросов: RPM, TPM и RPD
Gemini API считает нагрузку по трём параметрам одновременно: RPM, то есть запросов в минуту, TPM, токенов на входе в минуту, и RPD, запросов в сутки. Превышение любого из них возвращает ошибку, даже если остальные два в норме.
Конкретные цифры RPM и TPM зависят от модели и смотрятся в интерфейсе AI Studio в разделе лимитов, но логика перехода между тарифными уровнями одна для всех:
| Уровень | Условие перехода | Лимит трат за 10 минут |
|---|---|---|
| Free | биллинг не подключён | не применяется |
| Tier 1 | подключена оплата | 10 долларов |
| Tier 2 | потрачено от 100 долларов за 3 дня | 50 долларов |
| Tier 3 | потрачено от 1000 долларов за 30 дней | 200 долларов |
Переход с Free на Tier 1 происходит мгновенно в момент подключения биллинга. Последующие повышения уровня обрабатываются в течение примерно 10 минут после того, как трата достигла порога. Суточные квоты RPD сбрасываются в полночь по тихоокеанскому времени, это важно учитывать, если у вашего продукта пиковая нагрузка приходится на российское утро.
Код продукта должен воспринимать превышение лимита как штатную ситуацию, а не как сбой: правильная реакция, это повторить запрос с увеличивающейся задержкой, а не сразу показать пользователю ошибку.
Текущий уровень тарифа и то, сколько осталось до следующего порога, видно в разделе биллинга проекта: это удобный ориентир, если продукт растёт быстро и лимиты нужно отслеживать, а не узнавать о них по факту ошибки.
Как безопасно хранить ключ в проекте
Ключ, вставленный прямо в код, рано или поздно попадает в git-историю, лог сборки или скриншот в чате поддержки. Стандартные правила хранения просты, но именно их чаще всего пропускают в спешке:
- Храните ключ в переменных окружения, например GEMINI_API_KEY или GOOGLE_API_KEY, а не в исходном коде.
- Никогда не коммитьте ключ в систему контроля версий вроде Git, даже в приватный репозиторий.
- Для продакшена используйте менеджер секретов, например Google Cloud Secret Manager, а не файл .env на сервере.
- Не встраивайте ключ напрямую в веб или мобильное приложение: клиентский код легко извлечь из бинарника или сетевого трафика.
- Проверяйте, кто из команды имеет доступ к хранилищу секретов, и убирайте доступ у тех, кому он больше не нужен.
Последний пункт обычно и становится причиной утечек: ключ, зашитый во фронтенд, виден любому, кто откроет инструменты разработчика в браузере. Для клиентских сценариев запросы к модели нужно проксировать через свой backend, а не дергать Gemini API напрямую из приложения пользователя.
Ключи стоит менять по графику, а не только после инцидента: регулярная ротация ограничивает отрезок времени, в течение которого скомпрометированный ключ может использоваться кем-то посторонним.
Как ограничить ключ и снизить риск утечки
Даже аккуратно спрятанный ключ стоит ограничить на уровне самого ключа, это снижает ущерб, если секрет всё же утечёт.
В Google AI Studio ключи по умолчанию создаются без ограничений, и это стоит исправить сразу после генерации: на странице API Keys найдите ключ с меткой Unrestricted, откройте Add restrictions и выберите Restrict to Gemini API only. Через Google Cloud Console можно пойти дальше и задать ограничения по источнику запроса: конкретным IP-адресам, доменам или мобильным приложениям, которым разрешено использовать этот ключ.
Если ключ всё же скомпрометирован, порядок действий такой: сгенерировать новый ключ, обновить его в приложении, отключить старый ключ и проверить логи использования в Google Cloud Console на предмет аномальных трат. Чем быстрее отключён старый ключ, тем меньше счёт за чужой трафик.
Помимо ограничений самого ключа, полезно регулярно смотреть раздел использования API в Google Cloud Console: неожиданный скачок запросов часто заметен раньше, чем придёт счёт за месяц.
Типичные ошибки при интеграции ключа в продукт
Большинство проблем с Gemini API в продакшене повторяются из проекта в проект:
- Ключ без ограничений лежит в публичном репозитории или в мобильном приложении.
- Один общий ключ используется и для тестовой среды, и для продакшена, из-за чего лимиты и расходы смешиваются.
- Код не обрабатывает ошибку превышения лимита и падает вместо повторного запроса с задержкой.
- Биллинг подключают только после того, как бесплатный тариф начал останавливать продукт на живом трафике.
- Для задач, где модели нужны собственные данные компании, ключ встраивают без retrieval-слоя, и модель отвечает по общим знаниям, а не по документам бизнеса.
- Ограничения ключа настраивают один раз при создании и не пересматривают, когда продукт меняет архитектуру или добавляет новые клиентские приложения.
Большая часть этих ошибок не требует сложных решений: они устраняются процессом, чек-листом перед релизом и привычкой пересматривать настройки ключа при каждом значимом изменении продукта.
Если нагрузка или требования к приватности данных делают облачный API неудобным, стоит отдельно оценить вариант с собственной инфраструктурой, об этом подробно в статье про запуск локальных LLM на своём железе.
Частые вопросы
Нужна ли банковская карта для получения API-ключа Google AI Studio?
Для самого создания ключа и работы на бесплатном тарифе карта не требуется: ключ генерируется в интерфейсе AI Studio вместе с проектом Google Cloud. Способ оплаты нужен только при подключении биллинга для перехода на платный тариф, когда вы настраиваете Prepay или Postpay через страницу Set up billing.
Какой минимальный платёж при подключении биллинга?
При выборе режима Prepay минимальное пополнение составляет 5 долларов. Это разовый порог для старта, дальше счёт списывается по фактическому использованию токенов и моделей, выбранных в продукте.
Когда сбрасываются суточные лимиты запросов?
Квоты RPD, то есть запросов в сутки, сбрасываются в полночь по тихоокеанскому времени. Для команд в российских часовых поясах это означает, что суточный лимит обновляется днём или вечером по местному времени, а не в полночь по Москве.
Чем платный тариф отличается от бесплатного кроме лимитов?
Главное отличие в правилах использования данных: на бесплатном тарифе содержимое запросов может использоваться Google для улучшения продуктов, на платном, нет. Для продукта с коммерческими или персональными данными пользователей это часто важнее, чем сама величина лимита.
Можно ли ограничить ключ только для Gemini API?
Да. В настройках ключа в Google AI Studio есть опция Restrict to Gemini API only, которая запрещает использовать этот ключ для других сервисов Google. Дополнительно через Google Cloud Console можно ограничить ключ по IP-адресам или конкретным приложениям.
С чего начать
Если вы делаете MVP или личный прототип, начните с минимума: создайте ключ в Google AI Studio, сразу ограничьте его Gemini API, положите в переменные окружения и только потом пишите интеграцию.
- Создайте отдельный проект Google Cloud под продукт, не используйте личный аккаунт вперемешку с рабочим.
- Сгенерируйте ключ, ограничьте его по API и источнику запроса до того, как он попадёт в код.
- Настройте биллинг заранее, если ожидаете нагрузку выше бесплатного тарифа, а не в момент, когда лимит уже остановил продукт.
- Заведите отдельные ключи для тестовой среды и продакшена с разными ограничениями.
- Подпишитесь на уведомления о тратах в Google Cloud Console, чтобы не пропустить момент перехода между тарифными уровнями.
Если разбираться со всем этим самостоятельно не хочется, от выбора модели и лимитов до биллинга, безопасного хранения ключа и retrieval-слоя под ваши данные, этим занимаются команды, которые делают заказную разработку с интеграцией нейросетей под конкретный продукт.
