Gemini API key: как получить ключ и сделать первый запрос
Ключ 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
- Войдите в Google AI Studio (aistudio.google.com) с Google-аккаунтом.
- Нажмите Get API key, затем Create API key. AI Studio создаст ключ и привяжет его к проекту Google Cloud (новому или существующему).
- Скопируйте ключ и сохраните в переменной окружения
GEMINI_API_KEY. - Для платного использования включите биллинг в проекте 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 не включена оплата. Карту при создании ключа не спрашивают. Бесплатный ключ подходит, чтобы:
- пройти учебные примеры и проверить идею прототипа;
- сделать личного бота или скрипт с небольшой нагрузкой;
- сравнить модели Gemini с другими на своих задачах.
Для продукта с живыми пользователями бесплатного уровня обычно не хватает: при превышении лимита запросы просто завершаются ошибкой 429, автоматического перехода на оплату нет. Как правильно обрабатывать такие ошибки и повторять запросы, разобрано в уроке «Обработка ошибок». Если у вас уже есть код под OpenAI, ключ Gemini можно подключить через совместимый интерфейс, см. урок «Совместимость Gemini API с OpenAI».
Gemini API бесплатно: лимиты free tier в 2026 году
Лимиты бесплатного уровня считаются по трём показателям: запросы в минуту (RPM), входные токены в минуту (TPM) и запросы в день (RPD). Превышение любого из них даёт ошибку. Лимиты действуют на проект, а не на ключ: несколько ключей в одном проекте делят одну квоту. Дневной счётчик обнуляется в полночь по тихоокеанскому времени (это 10:00 или 11:00 по Москве, в зависимости от перехода США на летнее время).
Важно знать, как обстоят дела на октябрь 2026 года:
- Google больше не публикует общую таблицу лимитов. Свои фактические лимиты по каждой модели смотрите в Google AI Studio, в разделе rate limit вашего проекта. Google прямо оговаривает, что заявленные лимиты не гарантированы.
- Бесплатно доступны быстрые модели линеек Flash и Flash-Lite. Старшие Pro-модели и самые новые экспериментальные модели в основном доступны только на платном уровне.
- Порядок цифр. По сводкам разработчиков, для моделей Flash это единицы-десятки запросов в минуту; дневная квота у новых Flash может быть всего несколько десятков запросов, у Flash-Lite и более старых моделей — сотни и больше. Для preview-моделей лимиты обычно строже, чем для стабильных.
- Данные. На бесплатном уровне Google может использовать запросы и ответы для улучшения своих продуктов, на платном — нет. Персональные данные клиентов и коммерческую тайну через бесплатный ключ не отправляйте.
Список доступных вашему ключу моделей можно получить прямо из API, это показано в уроке «Список моделей». Когда бесплатного уровня станет мало, включите биллинг: оплата идёт за токены, а для фоновых задач есть более дешёвые режимы, см. урок «Уровни приоритетного и гибкого вывода». Экономить помогают:
- подсчёт токенов до отправки, урок «Всё о токенах: как считать и экономить»;
- кэширование длинного повторяющегося контекста, урок «Кэширование контекста»;
- пакетная обработка для задач без спешки, урок «Пакетная обработка запросов».
Что умеет Gemini API
| Задача | Урок на русском |
|---|---|
| Анализ файлов и документов | Загрузка файлов через File API |
| Поиск по своим файлам | File Search |
| Вызов ваших функций | Вызов функций из Python |
| Генерация изображений | Nano Banana |
| Разговор голосом в реальном времени | Live API |
| Генерация видео | Veo |
| Озвучка текста | Озвучка текста в Gemini |
Как хранить ключ
- Не вставляйте ключ в код, который попадает в Git, и в клиентский JavaScript.
- Ограничьте ключ в Google Cloud: только нужные API, при возможности только ваши серверы.
- Утёкший ключ отзывайте сразу и создавайте новый.
Gemini API в России
Россия не входит в официальный список стран, где доступны Google AI Studio и Gemini API (список на странице available regions обновлён Google в 2026 году, Россия в нём по-прежнему отсутствует). На практике это означает:
- AI Studio и API отклоняют запросы из России, получить и использовать ключ из российского региона нельзя;
- платный уровень недоступен с российскими картами: биллинг Google Cloud их не принимает;
- условия использования Google запрещают пользоваться сервисом из неподдерживаемых регионов, и аккаунт с нарушениями могут ограничить.
Инструкций по обходу ограничений мы не даём. Если вы работаете в России, честные варианты такие: использовать Gemini API в рамках компании или проекта, зарегистрированного и работающего в поддерживаемой стране, либо выбрать модели, доступные в России официально (например, GigaChat или YandexGPT), либо открытые модели семейства Gemma, которые Google выкладывает для запуска на своём оборудовании. Изучать сам Gemini API ограничения не мешают: курсы Gemini API Cookbook на AI University переведены на русский и открываются без VPN, а подходы (вызов функций, кэширование, работа с файлами) переносятся на другие платформы.
Где изучить Gemini API на русском
- Gemini API: быстрый старт — 69 коротких уроков от ключа до Live API и генерации видео.
- Gemini API: примеры использования — 80 готовых сценариев: анализ видео, агенты, работа с документами.
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; первые уроки открыты бесплатно.
