Я люблю, когда всё работает с первого раза. С Gemini API так не получилось: сначала не находил кнопку Create API key, потом не понимал, зачем нужен какой-то ключ, а когда нашёл, ещё час разбирался, как его вставить в код. Чтобы вы не повторяли мои грабли, я собрал полную инструкцию: как получить апи ключ Гемини, куда его положить и как сделать первый запрос. А ближе к концу объясню, что делать, если вы живёте в России и у вас нет зарубежной карты для оплаты.
Сразу скажу: ничего сложного. Весь процесс занимает двадцать минут, если следовать по шагам. Поехали.
Что такое API ключ Gemini и зачем он вам нужен
API ключ - это строка вида AIza... которая идентифицирует ваш запрос к моделям Google. Без него любой запрос к Gemini API вернёт ошибку 400 или 403. Он привязан к вашему аккаунту Google и к проекту в облаке. По сути это пропуск: вы показываете ключ, сервис понимает, что вы не бот, и разрешает доступ к конкретным моделям.
Ключ можно получать в двух местах: в Google AI Studio (быстрый способ, без карты) и в Google Cloud Console (полный контроль над сервисными аккаунтами, IP-ограничениями и т.д.). Для разработчиков чаще всего достаточно AI Studio, там всё устроено максимально просто.
Получаем апи ключ Гемини через Google AI Studio
Шаг 1. Заходим на сайт Google AI Studio. Если у вас нет аккаунта Google, создайте его. Это бесплатно и займёт минуту. Для регистрации понадобится телефон, но можно и без него, если добавить резервную почту.
Шаг 2. В интерфейсе AI Studio нажимаем на кнопку Get API key. Она находится в правом верхнем углу. Если вы никогда не пользовались сервисом, вас попросят выбрать проект или автоматически создать новый. Соглашайтесь, это нормально.
Шаг 3. Откроется панель Create API key. В поле Name введите любое имя, например chatbot или my-project. Нажмите Create key. Через секунду вы увидите длинную строку, которая начинается с AIza. Скопируйте её и сохраните в надёжном месте. Лучше в менеджере паролей.
Готово. Ключ получен. Он сразу активен и может использоваться в запросах. Обратите внимание: в AI Studio ключ показывается на экране после создания, и потом его можно посмотреть в списке ключей. Но копировать сразу всё же надёжнее.
Если вы хотите управлять ключами централизованно, создайте ключ через Cloud Console. Там можно привязать ключ к сервисному аккаунту и настроить ограничения по IP. Но для тестов достаточно AI Studio.
Как безопасно хранить ключ: настраиваем переменные окружения
Вставлять ключ прямо в код - плохая идея. Если вы случайно закоммитите файл на GitHub, ключ утечёт. Правильный способ - переменная окружения. Клиентские библиотеки Gemini API автоматически читают переменные GEMINI_API_KEY и GOOGLE_API_KEY. Настроим их для разных систем.
Для Linux и macOS (Bash). Откройте терминал и проверьте, есть ли файл ~/.bashrc:
ls ~/.bashrcЕсли нет, создайте его:
touch ~/.bashrcТеперь откройте файл в текстовом редакторе и добавьте в конец строку:
export GEMINI_API_KEY=ваш_ключ_сюдаСохраните файл и примените изменения:
source ~/.bashrcДля macOS с Zsh путь тот же, только файл называется .zshrc:
echo 'export GEMINI_API_KEY=ваш_ключ_сюда' >> ~/.zshrc
source ~/.zshrcДля Windows нажмите Win+R, введите sysdm.cpl, перейдите на вкладку Дополнительно, затем Переменные среды. В разделе Системные переменные нажмите Создать, введите имя GEMINI_API_KEY и значение ключа. Перезапустите терминал.
После настройки ключ будет доступен в любом скрипте без явного указания. Это защищает от случайной утечки и упрощает перенос между средами.
Первый запрос к Gemini: убеждаемся, что всё работает
Теперь проверим ключ. Самый простой способ - отправить запрос через Python. Убедитесь, что установлена библиотека google-genai:
pip install google-genaiЗатем выполните код:
from google import genai
client = genai.Client() # ключ автоматически берётся из GEMINI_API_KEY
response = client.models.generate_content(
model="gemini-3.6-flash",
contents="Объясни, чем API отличается от SDK, в трёх предложениях"
)
print(response.text)Если в ответе появится текст - ключ рабочий, регион не блокирован. Если возникает ошибка 403 или 400, проверьте, правильно ли записана переменная окружения, и убедитесь, что не осталось лишних пробелов.
Тот же запрос можно сделать через curl:
curl -X POST "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.6-flash:generateContent" \
-H "x-goog-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contents": [{"parts": [{"text": "Привет, расскажи о себе"}]}]}'Ответ придёт в формате JSON. Это удобно для быстрой проверки вне кода.
Какие модели Gemini доступны по ключу
Стандартный ключ из AI Studio даёт доступ к бесплатным моделям. Среди них есть лёгкая gemini-3.6-flash, которая отлично подходит для задач с высокими требованиями к скорости, и более мощные модели для сложных рассуждений. Их названия меняются часто, поэтому сверяйтесь с документацией. На момент написания статьи актуальны модели серии gemini-3.x, но Google постоянно добавляет новые.
Важный нюанс: бесплатные модели имеют жёсткие лимиты запросов в минуту и в день. Для прототипа хватит, а для продвинутого бота уже нет. Чтобы повысить лимиты, нужно включить биллинг. Вот тут большинство пользователей из России встаёт в ступор.
Лимиты, биллинг и почему оплата из России превращается в квест
Когда вы включаете биллинг в Google Cloud, вас просят привязать карту. Российские карты не работают. Можно использовать зарубежную карту, но её нужно где-то получить, а ещё подтвердить адрес и привязать к зарубежному IP. Я пробовал платить через агрегаторы, которые принимают рубли. Работает, но с комиссией и задержками. При этом ключ остаётся привязанным к Google, и его могут заблокировать при следующей проверке.
Некоторые уходят в Cloud Console и создают ключи через сервисные аккаунты, пытаясь обойти блокировки. Это работает, но требует глубоких настроек и риска потерять доступ. На Reddit разработчики предупреждают, что такие манипуляции часто приводят к бану аккаунта. В итоге бесплатный тариф даёт слишком мало, а платный - требует того, чего у большинства нет.
Типичные ошибки при работе с Gemini API ключом
Ошибка 404 model not found - значит, вы используете имя модели, которой нет в вашем тарифном плане. Проверьте актуальные названия в документации.Google.
Ошибка 403 permission denied - ключ привязан к другому проекту или не имеет доступа к модели. Загляните в настройки ключа и убедитесь, что проект совпадает.
Ошибка 429 rate limit exceeded - вы упёрлись в лимит бесплатного тарифа. Подождите или включите биллинг. Ошибка 400 invalid argument - неверно собран запрос, проверьте структуру JSON.
Часто эти ошибки возникают из-за того, что ключ скопирован с пробелом или переменная окружения не перезагружена. Перезапустите терминал или выполните source ~/.bashrc.
Альтернатива для разработчиков из России: 3GPT от 3SELLER
Где-то после третьего часа попыток оплатить Gemini я нашёл сервис, который решил проблему кардинально. 3GPT - это ИИ роутер, который даёт доступ ко всем флагманским моделям нейросетей из России. Внутри можно переключаться между Gemini, ChatGPT и Claude без отдельных ключей и иностранных карт.
Вы платите 149 рублей в месяц (или пополняете баланс) и получаете доступ сразу к последним версиям. Среди них Chat GPT 6 Astra, Claude Fable 5, Claude Opus 5.5, GPT 6.1 Sol, плюс модели для генерации изображений и видео. Работает из России, оплата российской картой, СБП или криптой.
Интерфейс выглядит так:
Кроме обычного чата, у 3GPT есть каталог готовых ИИ-агентов под конкретные задачи. Выбираете агента и общаетесь с ним, а модель можно менять прямо в диалоге. Это удобно, когда нужно быстро протестировать, какая из флагманских моделей лучше справляется с вашей задачей.
Если вы устали от танцев с картами и хотите просто работать, зайдите на официальный сайт 3GPT: https://3seller.com/3gpt. Каталог агентов находится на https://3seller.com/ai/agents.
Что я делаю сейчас: ключ для тестов, 3GPT для работы
Честно говоря, апи ключ Гемини всё ещё лежит у меня в переменных окружения. Иногда я гоняю на нём маленькие запросы, пока не упрусь в лимит. Для всех серьёзных задач использую 3GPT: там и модели новее, и цена ниже, чем беготня с агрегаторами.
Мой совет: получите ключ, чтобы разобраться в процессе, но не привязывайтесь к одному провайдеру. ИИ развивается так быстро, что сегодня лучшей может быть Gemini, завтра - Claude, а послезавтра - вообще новая модель. Иметь один доступ ко всем сразу - это огромная экономия времени.
Если статья вам помогла, загляните на сайт 3GPT и попробуйте бесплатный тариф. А если уже работали с Gemini API, расскажите в комментариях, как вы решили проблему с оплатой. Мне правда интересно.