Ключ Gemini API я получил в третий раз за год. Первые два раза забыл, куда сохранил, третий записал в менеджер паролей и наклеил стикер на монитор. Стикер не нужен, а вот последовательность действий стоит запомнить. Google AI Studio прячет кнопку создания ключа не глубоко, но новички всё равно теряются: то проект не тот, то биллинг не подключён, то ключ создан, а запрос возвращает 403.
Запрос «gemini api key как получить» гуглится тысячу раз в день, а ответ умещается в пять шагов. Ниже эти шаги, плюс грабли, на которые я наступал, и способы их обойти. Если вам нужен не ключ, а результат, в конце есть короткий путь.
Ключ живёт в Google AI Studio, а не в облачной консоли
Многие лезут в Google Cloud Console, создают сервисный аккаунт, прикручивают роли и застревают на биллинге. Для Gemini API это лишнее. Быстрый путь лежит через AI Studio: там ключ создаётся в два клика и сразу привязан к проекту. Cloud Console нужен, если вы управляете десятком ключей или хотите тонкие права доступа. Для первого знакомства с моделью хватит студии.
Google AI Studio служит веб-песочницей, где можно погонять промпты и тут же забрать ключ. Интерфейс меняется, но логика одна: слева меню, справа рабочая область, вверху кнопка Get API key.
Пять кликов, которые занимают меньше времени, чем чтение этого абзаца
Открываете aistudio.google.com. Логинитесь тем же аккаунтом, что и в Gmail. Если аккаунта нет, создаёте: без него ключ не выдадут, обойти шаг нельзя.
В левом меню или на главной странице ищете кнопку Get API key. В некоторых версиях интерфейса она подписана как «Get API key in Google AI Studio». Нажимаете.
Дальше система предложит создать ключ в новом проекте или выбрать существующий. Название проекта можно оставить по умолчанию, но лучше дать осмысленное: через месяц вы не вспомните, что такое project-742913.
Жмёте Create API key. Ключ появляется в списке. Копируете его сразу: повторно посмотреть значение нельзя, только создать новый. Не баг, а базовая гигиена.
Всё. Пять кликов, тридцать секунд. Если у вас ушло больше, вы, скорее всего, попали в Cloud Console или у аккаунта нет прав.
Новый проект почти всегда лучше старого
Когда AI Studio спрашивает, куда привязать ключ, выбор между новым и существующим проектом кажется косметическим. На практике новый проект даёт чистый лимит запросов и отдельную статистику. Старый проект тащит за собой квоты, которые вы уже потратили на эксперименты.
Если вы делаете бота для себя, создавайте новый проект под каждый эксперимент. Кончились бесплатные запросы, удалили проект, создали следующий. Грубо, но работает. Для продакшена так делать нельзя: там нужен один проект с включённым биллингом и мониторингом.
Ещё нюанс: ключ привязан к проекту, а не к аккаунту. Один аккаунт может держать десяток проектов и десяток ключей. AI Studio показывает только ключи без ограничений или с ограничениями для Gemini API. Если нужен ключ с правами на другие сервисы Google, идти придётся в Cloud Console.
Ключ кладём в переменные среды, а не в код
Самая частая ошибка новичка: вставить ключ прямо в скрипт и закоммитить в GitHub. Через час приходит письмо от сканера секретов, через день ключ отзывают. Не потому что Google злой, а потому что боты сканируют публичные репозитории быстрее, чем вы успеваете дописать README.
Правильный путь: переменные среды. Клиентские библиотеки Gemini API сами ищут переменную GEMINI_API_KEY или GOOGLE_API_KEY. Если заданы обе, приоритет у GOOGLE_API_KEY. Запомните это, чтобы потом не ловить странные ошибки, когда ключ вроде бы есть, а запрос уходит не туда.
В коде на Python клиент создаётся без аргументов, библиотека подхватывает переменную. В Node.js аналогично. Если переменной нет, клиент упадёт с понятной ошибкой, и вы сразу поймёте, что забыли экспортировать. На Reddit новички часто признаются, что забыли перезапустить терминал после экспорта - и ключ не подхватывается.
Linux, macOS и Windows: три способа задать переменную
На Linux и macOS в bash открываете ~/.bashrc, добавляете строку export GEMINI_API_KEY=ваш_ключ, сохраняете, выполняете source ~/.bashrc. В zsh файл называется ~/.zshrc, команда та же. Проверка простая: echo $GEMINI_API_KEY в новом терминале.
На Windows через PowerShell: setx GEMINI_API_KEY ваш_ключ. После этого перезапускаете терминал. В cmd команда другая: set GEMINI_API_KEY=ваш_ключ, но она действует только в текущей сессии. Для постоянного хранения лучше setx.
Есть третий путь: файл .env в корне проекта и библиотека вроде python-dotenv. Удобно для локальной разработки, но .env нужно сразу добавить в .gitignore. Я видел проекты, где .env лежал в репозитории вместе с ключами от трёх сервисов. Не повторяйте.
В продакшене переменные задаются через панель хостинга или секреты CI. GitHub Actions, Vercel, Railway, любой облачный провайдер умеет хранить секреты. Ключ в коде остаётся только в туториалах, и то не в лучших.
Пять причин, по которым ключ молчит
Первая: ключ создан в проекте, где не включён Gemini API. В AI Studio это происходит автоматически, в Cloud Console нужно включать вручную. Проверьте список API в проекте.
Вторая: вы копируете ключ с пробелом или переносом строки. Глазами это не видно, а сервер возвращает 400. Перекопируйте через кнопку копирования, не выделением мышью.
Третья: ключ отозван. Google отзывает ключи, которые попали в публичный доступ. Если вы закоммитили его, даже на пять минут, считайте, что ключа нет.
Четвёртая: исчерпан бесплатный лимит. Gemini API даёт щедрую квоту на старте, но она не бесконечная. Ошибка 429 значит, что вы упёрлись в rate limit. Ждать или подключать биллинг.
Пятая: модель, которую вы вызываете, недоступна в вашем регионе или требует платного tier. Список моделей и их доступность меняются, сверяйтесь с документацией. Иногда ключ рабочий, а конкретная модель возвращает 404.
Проверка ключа через curl занимает одну команду
Самый быстрый способ проверить ключ: curl. Запрос к эндпоинту models с заголовком x-goog-api-key. Если в ответе список моделей, ключ живой. Если 403, ключ не тот или API не включён. Я делаю так перед тем, как лезть в код: минута, а экономит полчаса отладки.
Ключ можно ограничить по IP или HTTP-реферреру. В AI Studio это не всегда очевидно, но в Cloud Console настройки есть. Для серверных приложений ограничение по IP полезно. Для клиентских бесполезно, ключ всё равно утечёт.
Ротация ключей: заведите привычку менять ключ раз в несколько месяцев или при уходе сотрудника. В AI Studio удаление старого ключа занимает секунду. Новый создаётся там же.
Ключ и OAuth путают, хотя это разные вещи
В документации рядом с API key висят OAuth 2.0 и сервисные аккаунты. Новичок думает, что без этого нельзя. Можно. Ключ служит аутентификацией приложения, а не пользователя. Для большинства сценариев с генерацией текста хватает ключа.
Сервисный аккаунт нужен, если вы работаете с Google Cloud ресурсами: BigQuery, Cloud Storage, Vertex AI. Для Gemini через AI Studio он не обязателен. Если вы в корпоративной среде, где политика запрещает ключи, тогда да, придётся идти через сервисный аккаунт и OAuth.
Ещё путаница с проектами. Ключ от одного проекта не работает в другом. Если вы создали ключ в проекте A, а запрос шлёте с квотами проекта B, получите ошибку. Проверяйте, какой проект выбран в AI Studio.
Если Google AI Studio не открывается, ключ не получить
AI Studio может не открываться из России. Ошибка не в ключе, а в сетевой доступности. Если интерфейс не грузится, ключ вы не получите, сколько бы раз ни обновляли страницу. Тогда либо VPN, либо альтернатива вроде 3GPT.
Я не сторонник танцев с бубном вокруг доступа. Если задача срочная, а студия лежит, проще взять сервис, который уже решил вопрос с доступом и оплатой. Об этом ниже.
Цена Gemini API зависит от модели, а не от количества запросов
Бесплатный tier есть, но он для экспериментов. Платные цены зависят от модели и объёма токенов. На момент написания младшие модели стоят копейки, флагманы ощутимее. Считайте бюджет на токены, а не на запросы: длинный промпт сжигает квоту быстрее, чем десять коротких.
Кэширование контекста и батчинг снижают счёт. Если гоняете один и тот же системный промпт, посмотрите в сторону контекстного кэша. Для пакетных задач есть batch API. Магии нет, но экономия заметная.
Я советую включать биллинг сразу, как только проект выходит за пределы ноутбука. Не потому что вы потратите много, а потому что без биллинга запросы просто отваливаются в самый неподходящий момент. Пара долларов на старте снимает головную боль.
Один ключ на команду плохая идея
Один ключ на всех плохая идея. Утечка одного ключа роняет весь проект. Заведите отдельные ключи под сервисы: бот, сайт, аналитика. В AI Studio можно создать несколько ключей в одном проекте. Удаление одного не ломает остальные.
Ведите таблицу: ключ, проект, владелец, дата создания, где используется. Скучно, но через полгода вы скажете себе спасибо. Я видел команды, где ключи хранились в заметках и передавались в чате. Кончилось тем, что один ключ утёк и его отозвали в разгар демо.
Для команд есть ещё один слой: прокси перед API. Он прячет ключ от клиентов и считает расход по каждому пользователю. Настраивается за вечер, если у вас есть бэкенд. Для маленькой команды хватит и отдельных ключей с лимитами.
Первый запрос: что писать в коде
На Python ставите google-generativeai, импортируете, создаёте клиента. Если переменная среды задана, клиент подхватит ключ сам. Дальше вызываете generate_content с текстом промпта. Ответ приходит объектом, из которого нужно вытащить текст. В документации есть примеры под каждую модель, копируйте оттуда, не из статей двухлетней давности.
На Node.js ставите @google/generative-ai, создаёте клиента с ключом из process.env.GEMINI_API_KEY. Синтаксис отличается, логика та же. Если ответ пустой, проверьте, не забыли ли вы обработать промис. Асинхронность ловит новичков чаще, чем ключи.
Не пишите ключ в коде даже в комментарии. Я видел строку // TODO: убрать ключ перед коммитом. Ключ убирают не перед коммитом, а сразу. Комментарии тоже попадают в историю git.
Ошибки 400, 403, 429: что значит каждая
400 значит, что запрос кривой: не тот формат, лишний пробел в ключе, неправильное имя модели. Проверьте тело запроса и заголовки. Чаще всего виновата копипаста.
403 значит, что ключ не имеет прав или API не включён в проекте. Проверьте, тот ли проект выбран, включён ли Gemini API, не отозван ли ключ. Если вы в России и используете VPN, 403 может приходить из-за региона. Смотрите текст ошибки, там обычно написано, что именно не так.
429 значит, что вы превысили лимит запросов. Подождите или подключите биллинг. Не пытайтесь обойти лимит созданием новых ключей в том же проекте: квота считается на проект, а не на ключ. Новый проект даст новую квоту, но это костыль, а не решение.
Ключ для тестов и ключ для продакшена
Держите два ключа: один для локальных экспериментов, второй для продакшена. Тестовый можно ограничить по IP и квоте, чтобы случайный цикл не сжёг бюджет. Продакшен-ключ храните в секретах хостинга и меняйте при подозрении на утечку.
Не используйте продакшен-ключ на ноутбуке. Однажды я запустил скрипт с боевым ключом и забыл про лимит. Через час пришло письмо о превышении квоты. С тех пор тестовый и боевой ключи у меня разделены, и это спасает нервы.
Ключ не нужен, когда нужен результат
Возиться с ключами, переменными среды и зарубежными картами утомляет, особенно если вы в России. Карты не проходят, биллинг не подключается, а модель нужна сегодня. Я держу под рукой сервис, который закрывает этот сценарий.
3GPT от 3SELLER это ИИ роутер с доступом из России к флагманским моделям. Chat GPT 6 Astra, Claude Fable 5, Claude Fable 5.1, Claude Opus 5.5, Chat GPT 5.5, Chat GPT 6.1 Sol, Nano Banana для изображений, генерация видео. Всё в одном окне, без иностранных карт.
Цена входа 149 рублей. Пополнить баланс можно российской картой, через СБП или криптой. Для тех, кто хочет просто попробовать модель и не разбираться с API, так быстрее, чем пять шагов в AI Studio.
Отдельная фишка: готовые ИИ агенты под задачи. Выбираете агента, начинаете общение, модель меняете прямо в чате. Не нужно писать код, не нужно получать ключ, не нужно думать о лимитах. Для бизнес-задач вроде продающих текстов, сайтов или обработки изображений экономит вечер.
Получить доступ ко всем флагманским моделям нейросетей из России можно на официальном сайте 3GPT: https://3seller.com/3gpt.
После ключа начинается обычная инженерия
Первый запрос занимает две минуты. Ставите библиотеку, задаёте переменную, пишете пять строк кода. Если ответ пришёл, дальше идёт обычная инженерия: обработка ошибок, ретраи, логирование, лимиты.
Не храните ключ в коде. Не публикуйте его в скриншотах. Не передавайте коллегам в мессенджере. Звучит как очевидность, но именно на очевидностях люди и попадаются.
Если задача не про код, а про результат, не тратьте вечер на API. Возьмите готовый сервис, сделайте работу и вернитесь к ключам, когда появится реальная необходимость. Иногда самый быстрый путь не самый техничный.