Интеграции инструментов17 июля 2026 г.Flatkey Team

Как получить ключ Google Gemini API (2026): создать, проверить и защитить для продакшена

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

Как получить ключ Google Gemini API (2026): создать, проверить и защитить для продакшена

Чтобы получить ключ Google Gemini API, войдите в Google AI Studio с аккаунтом Google, примите условия использования, откройте страницу ключей API и нажмите «Создать ключ API»; для новых пользователей проект Google Cloud по умолчанию и ключ создаются автоматически. Создание ключа бесплатно, а у нескольких моделей Gemini, включая Gemini 3.8 Flash и Gemini 3.5 Flash-Lite, есть бесплатный уровень. С 28 мая 2026 года каждый новый ключ, созданный в AI Studio, — это «ключ авторизации», привязанный к сервисному аккаунту. При этом Gemini API отклоняет старые ключи без ограничений, поэтому ключ, работавший в прошлом году, может потребовать замены (документация Google по ключам API, проверено 27 октября 2026 года).

Это руководство для независимых разработчиков и небольших команд, которым нужно за несколько минут получить рабочий ключ Gemini и обеспечить его безопасность в продакшене. Здесь разобраны порядок действий, новые типы ключей, бесплатный уровень, первый запрос через curl, Python и Node.js, самые частые ошибки и чек-лист перед запуском. Если вы сравниваете стоимость, полная таблица тарифов есть в нашем руководстве по ценам Gemini API.

Как получить ключ Gemini API: пошаговая инструкция

Откройте Google AI Studio. Перейдите на aistudio.google.com/apikey и войдите с аккаунтом Google, который будет владельцем проекта или будет использоваться для оплаты.
Примите условия. Если вы новый пользователь, после принятия условий использования AI Studio создаст проект Google Cloud по умолчанию и ключ API. Позже проект можно переименовать в разделе проектов.
Выберите или импортируйте проект. Если вы уже пользуетесь Google Cloud, AI Studio не создаёт проект по умолчанию. Откройте «Панель управления → Проекты → Импортировать проекты» и выберите нужный проект Cloud.
Создайте ключ. На странице ключей API нажмите «Создать ключ API» и выберите проект. По умолчанию новые ключи создаются как ключи авторизации.
Сразу скопируйте и сохраните ключ. Поместите его в переменную окружения или хранилище секретов, а не в файл в репозитории.
Задайте ограничения. Если ключ будет использоваться только для вызовов Gemini, оставьте ограничение на Gemini API (Generative Language API). Если запросы будут поступать с серверов с постоянными адресами, добавьте ограничения по IP в консоли Google Cloud.
Проверьте ключ одним из запросов ниже.

Инструкция основана на статье «Использование ключей Gemini API» на сайте Google AI for Developers, последнее обновление — 27 октября 2026 года.

Где потом найти свой ключ Google API?

В Google AI Studio откройте «Панель управления → Ключи API». AI Studio показывает до 100 ключей и 50 проектов; в списке отображаются только ключи без ограничений или с ограничением на Gemini API. Ключи, ограниченные другими Google API, доступны только на странице учётных данных в консоли Google Cloud. Если проекта нет в списке, сначала импортируйте его.

Стандартные ключи и ключи авторизации: что изменилось в 2026 году

Google переводит Gemini API со стандартных ключей API на ключи авторизации (auth). Согласно официальной документации от 27 октября 2026 года:

	Стандартный ключ API	Ключ авторизации
К чему привязан	К проекту Google Cloud для оплаты и учёта квот	К сервисному аккаунту Google Cloud
Идентифицирует вызывающую сторону	Нет	Да, запросы выполняются от имени привязанного сервисного аккаунта
Область действия по умолчанию	Зависит от заданных вами ограничений	По умолчанию ограничен Gemini API
Действия при утечке ключа	Вручную	Оперативная блокировка использования ключей, утечку которых обнаруживает Google
Когда создавался в AI Studio	До 28 мая 2026 года	С 28 мая 2026 года
Работает ли сейчас?	Только при наличии явно заданных ограничений	Да

Что это означает на практике:

Стандартные ключи без ограничений отклоняются. Если у старого ключа нет ограничений по API, запросы к Gemini завершаются ошибкой. Исправьте это в AI Studio: наведите указатель на предупреждение у ключа и выберите «Ограничить только Gemini API». Для этого требуется разрешение apikeys.keys.update.
Неактивные ключи без ограничений блокируются. С 7 мая 2026 года у ключей без ограничений, которые долго не использовались, отображается метка «Заблокирован». Создайте новый ключ и переведите приложение на него.
Новый префикс ключей. Разработчики сообщают, что новые ключи авторизации больше не начинаются с привычного префикса AIza (пример описания). Если сторонний инструмент проверяет ключи по префиксу, он может отклонить действительный новый ключ. Обновите инструмент вместо возврата к стандартному ключу.
Разрешения на создание ключей. Если при нажатии кнопки создания появляется сообщение о недостаточных правах, администратор Cloud должен выдать вам роль, включающую, среди прочего, разрешения apikeys.keys.create, serviceusage.services.enable, iam.serviceAccounts.create и iam.serviceAccountApiKeyBindings.create. Без доступа администратора можно создать новый проект, не входящий в организацию.

Задайте ключ в переменной окружения

Клиентские библиотеки Google автоматически считывают GEMINI_API_KEY или GOOGLE_API_KEY. Если заданы обе переменные, приоритет у GOOGLE_API_KEY — это частая причина того, что новый ключ не используется.

# macOS / Linux (add to ~/.zshrc or ~/.bashrc, then open a new terminal)
export GEMINI_API_KEY="paste-your-key-here"

# Make sure an old key is not overriding it
unset GOOGLE_API_KEY

В Windows добавьте GEMINI_API_KEY в разделе «Свойства системы → Переменные среды» и откройте новый терминал.

Проверьте ключ Gemini API

curl (Interactions API)

В актуальном кратком руководстве Google используется эндпоинт Interactions, а ключ передаётся в заголовке x-goog-api-key:

curl "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -d '{
    "model": "gemini-3.8-flash",
    "input": "Reply with the single word: ok"
  }'

Ответ в формате JSON с текстом результата означает, что ключ, проект и доступ к модели работают. Ошибка 403 обычно означает, что ключ ограничен другими API или заблокирован; 429 — что вы достигли лимита запросов (см. ниже).

Python (google-genai SDK)

# pip install google-genai
from google import genai

client = genai.Client()  # reads GEMINI_API_KEY from the environment

interaction = client.interactions.create(
    model="gemini-3.8-flash",
    input="Explain what an API key is in one sentence.",
)
print(interaction.output_text)

Node.js (@google/genai)

// npm install @google/genai
import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });

const interaction = await ai.interactions.create({
  model: "gemini-3.8-flash",
  input: "Explain what an API key is in one sentence.",
});
console.log(interaction.output_text);

Используйте тот же ключ с OpenAI SDK

У Gemini также есть эндпоинт, совместимый с OpenAI. Это удобно для инструментов, которые принимают только базовый URL OpenAI, например для многих агентов программирования и чат-приложений:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["GEMINI_API_KEY"],
    base_url="https://generativelanguage.googleapis.com/v1beta/openai/",
)
resp = client.chat.completions.create(
    model="gemini-3.8-flash",
    messages=[{"role": "user", "content": "Say ok"}],
)
print(resp.choices[0].message.content)

Настройку отдельных инструментов через единый шлюз см. в статье «Gemini API через маршрутизатор, совместимый с OpenAI».

Бесплатен ли ключ Gemini API?

Сам ключ бесплатен, как и ограниченный бесплатный уровень использования. На странице цен Google (проверено 27 октября 2026 года) описаны три плана: Free, Paid и Enterprise. Бесплатный уровень предоставляет бесплатные входные и выходные токены для некоторых моделей, но отправленный на бесплатном уровне контент используется для улучшения продуктов Google. На платном уровне он для этого не используется. Не отправляйте данные клиентов с ключом бесплатного уровня.

Модель	Бесплатный уровень	Цена за входные / выходные токены, за 1M токенов (Standard)
Gemini 4 Argon	Недоступен	$2.00 / $10.00 до 30 ноября 2026 года включительно; $4.00 / $20.00 с 1 декабря 2026 года
Gemini 3.8 Flash	Да	$0.75 / $3.75 до 31 декабря 2026 года включительно; $1.50 / $7.50 с 1 января 2027 года
Gemini 3.5 Flash-Lite	Да	$0.30 / $2.50
Gemini 3.1 Flash-Lite	Да	$0.25 / $1.50 (текст, изображения, видео)

Источник: «Цены Gemini Developer API», 27 октября 2026 года. Учтите запланированное повышение цен: если приложение будет работать после указанных дат, закладывайте в бюджет более высокие тарифы.

Как пользоваться Gemini API бесплатно

Создайте ключ в AI Studio без подключения оплаты. Проект останется на уровне Free.
Используйте модель с бесплатным уровнем, например gemini-3.8-flash или gemini-3.5-flash-lite. Gemini 4 Argon доступна только платно.
Не превышайте лимиты бесплатного уровня, указанные в AI Studio. Лимиты действуют на проект, а не на ключ, поэтому создание дополнительных ключей в одном проекте не увеличивает квоту.
Используйте только тестовые или общедоступные данные, поскольку контент бесплатного уровня может использоваться для улучшения продуктов Google.

Лимиты запросов и уровни доступа

Лимиты Gemini измеряются в запросах в минуту (RPM), входных токенах в минуту (TPM) и запросах в день (RPD). Превышение любого из них приводит к ошибке, а счётчик RPD сбрасывается в полночь по тихоокеанскому времени (лимиты запросов, 27 октября 2026 года). Google также применяет ограничения по расходам в скользящем окне длительностью 10 минут; при их превышении возвращается 429 RESOURCE_EXHAUSTED.

Уровень	Условия перехода	Лимит расходов уровня
Free	Активный проект или бесплатный пробный период	Неприменимо
Tier 1	Подключить активный платёжный аккаунт	$250
Tier 2	Оплачено $100 + прошло 3 дня с первого успешного платежа	$2,000
Tier 3	Оплачено $1,000 + прошло 30 дней с первого успешного платежа	От $20,000 до $100,000+

Источник: «Лимиты запросов Gemini API», 27 октября 2026 года. Точные лимиты для каждой модели проверяйте в AI Studio; Google предупреждает, что указанные лимиты не гарантируются.

Что можно сделать с вашим ключом API?

Любой, у кого есть ваш ключ Gemini, может отправлять запросы за счёт вашего проекта и расходовать вашу квоту. В документации Google есть предупреждение: утечка ключа может привести к «неожиданным списаниям» и доступу к закрытым данным проекта. С ключом авторизации злоумышленник действует от имени привязанного сервисного аккаунта и получает доступ ко всему, что доступно этому аккаунту (рекомендации Google Cloud по работе с ключами API). Поэтому разрешения сервисного аккаунта должны быть минимальными.

Если вы подозреваете утечку ключа:

Создайте новый ключ в AI Studio.
Обновите ключ в развёрнутом приложении и убедитесь, что он работает.
Отключите старый ключ в консоли Cloud. Не удаляйте его до ввода нового в работу, иначе приложение станет недоступным.
Проверьте расходы и использование API в консоли Cloud на наличие неизвестного трафика. На странице использования AI Studio трафик, который не удалось сопоставить с именованным ключом, объединяется в группу «(неизвестные ключи)».

Устранение неполадок: почему ключ Gemini API не работает

Симптом	Вероятная причина	Решение
`403` или «Недействительный ключ API» при использовании старого ключа	Стандартный ключ без ограничений теперь отклоняется	Ограничьте ключ только Gemini API или создайте новый ключ авторизации
У ключа в AI Studio отображается метка «Заблокирован»	Неактивный ключ без ограничений, заблокированный в рамках правил, действующих с 7 мая 2026 года	Создайте новый ключ и обновите приложение
Код игнорирует новый ключ	Также задана переменная `GOOGLE_API_KEY`, у которой выше приоритет	Удалите эту переменную или задайте в ней новый ключ
Сторонний инструмент сообщает о неверном формате ключа	Инструмент ожидает старый префикс	Обновите инструмент или направляйте запросы через шлюз, совместимый с OpenAI
«У вас нет разрешения на создание ключа»	Не хватает разрешений IAM в проекте Cloud	Обратитесь к администратору или используйте проект вне организации
`429 RESOURCE_EXHAUSTED`	Лимит RPM, TPM, RPD или расходов	Повторите запрос с увеличивающейся задержкой, уменьшите размер запроса или перейдите на более высокий уровень
Модель не найдена или недоступна	Модель не входит в бесплатный уровень (например, Gemini 4 Argon)	Подключите оплату или выберите модель с бесплатным уровнем

Подходы к обработке ошибок разных провайдеров разобраны в нашей классификации ошибок LLM-шлюзов.

Чек-лист подготовки ключа Gemini API к продакшену

То, что ключ работает в ноутбуке, ещё не означает готовность к работе с пользователями. Перед запуском:

Храните ключ на сервере. Никогда не включайте его в веб-приложение или мобильное приложение; Google предупреждает, что ключи можно извлечь из клиентского кода. Разместите небольшой серверный прокси между клиентом и Gemini.
Отдельный ключ для каждой среды и каждого приложения. Разделяйте ключи разработки, тестовой среды и продакшена, чтобы можно было отозвать один, не нарушив работу остальных. Давайте им понятные имена.
Храните ключ в хранилище секретов. Для продакшена Google рекомендует Secret Manager. Загружайте ключ во время выполнения.
Задайте ограничения по API и, где возможно, по IP. Ключ авторизации по умолчанию ограничен Gemini; добавьте ограничения по IP для серверов с постоянными адресами.
Минимизируйте права сервисного аккаунта. Не назначайте привязанному сервисному аккаунту широкие роли, которые ему не нужны.
Включите уведомления о расходах в консоли Google Cloud, чтобы узнать о скачке потребления раньше, чем придёт счёт.
Фиксируйте ID моделей. Используйте в конфигурации точные ID, например gemini-3.8-flash, и учитывайте изменения цен с 1 декабря 2026 года и 1 января 2027 года.
Используйте платный уровень для пользовательских данных. Контент бесплатного уровня может использоваться для улучшения продуктов Google.
Продумайте обработку лимитов запросов. Добавьте экспоненциальное увеличение задержки между повторами при 429 и определите поведение при достижении лимита: постановка в очередь, переход на менее крупную модель или переключение на резервный сервис.
Проверяйте репозитории на утечки ключей. Включите сканирование секретов GitHub и защиту при отправке изменений.
Регулярно меняйте ключи. Создайте новый ключ, разверните приложение с ним, проверьте работу, затем отключите старый.

Для более глубокой проверки воспользуйтесь нашим чек-листом готовности Gemini API к продакшену и руководством по безопасному управлению ключами API.

Когда один ключ Flatkey удобнее ключа Gemini

Если приложение также обращается к Claude, GPT, DeepSeek или Qwen, управление отдельными ключами, платёжными аккаунтами и уровнями лимитов для каждого провайдера добавляет работы. Flatkey предоставляет единый ключ, совместимый с OpenAI, и базовый URL (https://router.flatkey.ai/v1) для Gemini и других моделей, а также журналы использования по каждому ключу (документация Flatkey). Объективно оценивайте разницу в цене: она зависит от модели. На 27 октября 2026 года на страницах моделей Flatkey были указаны следующие цены:

Модель	Прайс Google (Standard)	Flatkey
Gemini 4 Argon	$2.00 / $10.00	$1.60 / $8.00
Gemini 3.5 Flash-Lite	$0.30 / $2.50	$0.24 / $2.00
Gemini 3.8 Flash	$0.75 / $3.75 (акция до 31 декабря 2026 года включительно)	$1.20 / $6.00

Для Gemini 3.8 Flash акционная цена Google ниже цены Flatkey до 31 декабря 2026 года включительно, поэтому до этой даты приложению, использующему только Flash, дешевле обращаться к Google напрямую. Flatkey выгоднее рассматривать для Argon, Flash-Lite или приложений с несколькими провайдерами.

from openai import OpenAI
import os

client = OpenAI(api_key=os.environ["FLATKEY_API_KEY"], base_url="https://router.flatkey.ai/v1")
resp = client.chat.completions.create(
    model="gemini-4-argon",
    messages=[{"role": "user", "content": "Summarize this stack trace in one line."}],
)
print(resp.choices[0].message.content)

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

Как получить ключ Google Gemini API?

Войдите на aistudio.google.com/apikey, примите условия, выберите или импортируйте проект Google Cloud и нажмите «Создать ключ API». Для новых пользователей проект по умолчанию и ключ создаются автоматически. Ключ отображается на странице ключей API в AI Studio.

Бесплатен ли ключ Gemini API?

Да. Создание ключа бесплатно, а у таких моделей, как Gemini 3.8 Flash и Gemini 3.5 Flash-Lite, есть бесплатный уровень с лимитами запросов. Контент бесплатного уровня может использоваться для улучшения продуктов Google, а Gemini 4 Argon бесплатно недоступна.

Как пользоваться Gemini API бесплатно?

Создайте ключ без подключения оплаты, обращайтесь к модели с бесплатным уровнем, например gemini-3.8-flash, и не превышайте лимиты, указанные в AI Studio. Лимиты действуют на проект, поэтому дополнительные ключи в том же проекте не увеличивают квоту.

Где найти свой ключ Google API?

В Google AI Studio, в разделе «Панель управления → Ключи API». Ключи, ограниченные другими Google API, кроме Gemini, отображаются только на странице учётных данных в консоли Google Cloud.

Что можно сделать с моим ключом API?

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

Почему мой старый ключ Gemini API перестал работать?

С 2026 года Gemini API отклоняет стандартные ключи без ограничений, а с 7 мая 2026 года блокирует ключи без ограничений, которые долго не использовались. Ограничьте ключ Gemini API или создайте новый ключ авторизации.

Можно ли использовать ключ Gemini API с OpenAI SDK?

Да. Задайте базовый URL https://generativelanguage.googleapis.com/v1beta/openai/ и передайте ключ Gemini в качестве ключа API.

Итог

Получить ключ Gemini в AI Studio можно за две минуты; для его защиты потребуется чуть больше усилий. Используйте ключ авторизации, храните его на сервере в хранилище секретов, задайте ограничения, настройте уведомления о расходах, используйте платный уровень для реальных пользовательских данных и следите за запланированными изменениями цен. Если вы работаете с несколькими провайдерами, один ключ шлюза может заменить набор отдельных ключей. Сравните модели в каталоге моделей Flatkey и обратитесь к руководству по маршрутизации между Gemini и Claude, чтобы понять, когда направлять трафик каждой из них.