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

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

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

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

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

Как получить API key Gemini в Google AI Studio

  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 key free: что даёт бесплатный ключ

Отдельного «бесплатного ключа» у Gemini нет: любой ключ из Google AI Studio работает на бесплатном уровне (free tier), пока в его проекте Google Cloud не включена оплата. Карту при создании ключа не спрашивают. Бесплатный ключ подходит, чтобы:

Для продукта с живыми пользователями бесплатного уровня обычно не хватает: при превышении лимита запросы просто завершаются ошибкой 429, автоматического перехода на оплату нет. Как правильно обрабатывать такие ошибки и повторять запросы, разобрано в уроке «Обработка ошибок». Если у вас уже есть код под OpenAI, ключ Gemini можно подключить через совместимый интерфейс, см. урок «Совместимость Gemini API с OpenAI».

Gemini API бесплатно: лимиты free tier в 2026 году

Лимиты бесплатного уровня считаются по трём показателям: запросы в минуту (RPM), входные токены в минуту (TPM) и запросы в день (RPD). Превышение любого из них даёт ошибку. Лимиты действуют на проект, а не на ключ: несколько ключей в одном проекте делят одну квоту. Дневной счётчик обнуляется в полночь по тихоокеанскому времени (это 10:00 или 11:00 по Москве, в зависимости от перехода США на летнее время).

Важно знать, как обстоят дела на октябрь 2026 года:

Список доступных вашему ключу моделей можно получить прямо из API, это показано в уроке «Список моделей». Когда бесплатного уровня станет мало, включите биллинг: оплата идёт за токены, а для фоновых задач есть более дешёвые режимы, см. урок «Уровни приоритетного и гибкого вывода». Экономить помогают:

Что умеет Gemini API

ЗадачаУрок на русском
Анализ файлов и документовЗагрузка файлов через File API
Поиск по своим файламFile Search
Вызов ваших функцийВызов функций из Python
Генерация изображенийNano Banana
Разговор голосом в реальном времениLive API
Генерация видеоVeo
Озвучка текстаОзвучка текста в Gemini

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

Gemini API в России

Россия не входит в официальный список стран, где доступны Google AI Studio и Gemini API (список на странице available regions обновлён Google в 2026 году, Россия в нём по-прежнему отсутствует). На практике это означает:

Инструкций по обходу ограничений мы не даём. Если вы работаете в России, честные варианты такие: использовать Gemini API в рамках компании или проекта, зарегистрированного и работающего в поддерживаемой стране, либо выбрать модели, доступные в России официально (например, GigaChat или YandexGPT), либо открытые модели семейства Gemma, которые Google выкладывает для запуска на своём оборудовании. Изучать сам Gemini API ограничения не мешают: курсы Gemini API Cookbook на AI University переведены на русский и открываются без VPN, а подходы (вызов функций, кэширование, работа с файлами) переносятся на другие платформы.

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

Gemini API Cookbook на русском

Официальные примеры Google, переведённые на русский. Первые уроки бесплатно, без VPN.

Открыть курс

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

Где взять API ключ Gemini?

В Google AI Studio (aistudio.google.com): Get API key, затем Create API key. Нужен Google-аккаунт.

Gemini API бесплатный?

Есть бесплатный уровень с ограничением числа запросов в минуту и в день. Для больших объёмов включают оплату в Google Cloud.

Работает ли Gemini API в России?

Официально нет: Google AI Studio недоступен для пользователей из России. Нужен аккаунт и оплата в поддерживаемой стране.

Какие лимиты у бесплатного Gemini API?

Лимиты считаются по запросам в минуту, токенам в минуту и запросам в день, отдельно для каждой модели и проекта. Google не публикует единую таблицу: актуальные цифры для вашего проекта видны в Google AI Studio. Бесплатно доступны модели Flash и Flash-Lite, Pro-модели в основном только на платном уровне.

Нужна ли карта, чтобы получить бесплатный ключ Gemini API?

Нет. Ключ из Google AI Studio работает на бесплатном уровне без привязки карты. Карта нужна только для включения платного уровня в Google Cloud.

Как бесплатно изучить Gemini API на русском?

На AI University переведены официальные курсы Google Gemini API Cookbook; первые уроки открыты бесплатно.

Владислав Попов

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