Gemini API key: как получить ключ и сделать первый запрос

Обновлено 29.09.2026 · Автор: Владислав Попов

Ключ Gemini API создают в Google AI Studio (aistudio.google.com) кнопкой Get API key: нужен только Google-аккаунт. У Gemini API есть бесплатный уровень с ограничением по числу запросов, для больших объёмов подключают оплату в Google Cloud. Официально Google AI Studio недоступен в России, это стоит учесть заранее.

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

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

1. Войдите в Google AI Studio (aistudio.google.com) с Google-аккаунтом.
2. Нажмите Get API key, затем Create API key. AI Studio создаст ключ и привяжет его к проекту Google Cloud (новому или существующему).
3. Скопируйте ключ и сохраните в переменной окружения GEMINI_API_KEY.
4. Для платного использования включите биллинг в проекте Google Cloud. Без него работает бесплатный уровень.

Настройка ключа и авторизации разобрана в бесплатном уроке «Как подключиться к API» курса Gemini API Cookbook. Если нужен вход от имени пользователя, а не по ключу, смотрите «Вход через OAuth».

Первый запрос на Python

from google import genai

client = genai.Client()  # ключ берётся из GEMINI_API_KEY
response = client.models.generate_content(
    model="gemini-2.5-flash",
    contents="Объясни, что такое API, в двух предложениях",
)
print(response.text)

Модели обновляются, актуальные названия есть в документации Google и в уроке «Первые шаги с моделями Gemini».

Бесплатный уровень и оплата

Бесплатный уровень Gemini API ограничивает число запросов в минуту и в день, лимиты зависят от модели и меняются, актуальные значения Google публикует на странице rate limits. На бесплатном уровне Google может использовать запросы для улучшения своих продуктов, поэтому конфиденциальные данные через него лучше не отправлять. На платном уровне оплата идёт за токены. Экономить помогают:

• подсчёт токенов до отправки, урок «Всё о токенах: как считать и экономить»;
• кэширование длинного повторяющегося контекста, урок «Кэширование контекста»;
• пакетная обработка для задач без спешки, урок «Пакетная обработка запросов».

Что умеет Gemini API

Как хранить ключ

• Не вставляйте ключ в код, который попадает в Git, и в клиентский JavaScript.
• Ограничьте ключ в Google Cloud: только нужные API, при возможности только ваши серверы.
• Утёкший ключ отзывайте сразу и создавайте новый.

Gemini API в России

Google AI Studio и Gemini API официально недоступны для пользователей из России: вход в AI Studio с российского IP и российские карты не работают. Для работы нужен аккаунт и оплата в поддерживаемой стране. Изучать возможности API это не мешает: Gemini API Cookbook на AI University переведён на русский и открывается без VPN.

Где изучить Gemini API на русском

• Gemini API: быстрый старт — 69 коротких уроков от ключа до Live API и генерации видео.
• Gemini API: примеры использования — 80 готовых сценариев: анализ видео, агенты, работа с документами.

Владислав Попов
PhD (University of York), основатель Стадики и AI University. Отбирает и переводит на русский официальные курсы Anthropic, OpenAI и Google.