Инструкций «как получить ключ Gemini API» в рунете десятки, и почти в каждой лежит код, который у вас не запустится. Мы проверили пять первых статей из выдачи: в четырёх код написан на библиотеке, которую Google похоронил ещё 31 августа 2025 года, а модели там называются Gemini 1.5 и Gemini 2.0. Новичок копирует такой пример, получает ошибку импорта и решает, что дело в нём.
CheckroiПодборка курсов по Gemini19 курсов • 7 школСравните цены, школы, программу и найдите выгодные предложения по обучениюСравнить→
Здесь собрана рабочая версия на сентябрь 2026: где взять API-ключ, как за пять минут сделать первый запрос на Python на актуальном SDK, сколько это стоит после бесплатного тарифа и что делать, если вы открыли Google AI Studio и увидели отказ по региону.
Если вы ещё не разобрались, что вообще такое Gemini и чем модели Google отличаются между собой, начните с обзорной статьи «Что такое Google Gemini»: там про интерфейс, тарифы и линейку моделей без кода.
А если само слово «API» пока звучит как заклинание, есть базовый разбор «Что такое API простыми словами». Дальше по тексту мы считаем, что вы примерно понимаете: API — это способ обратиться к чужой программе из своего кода и получить ответ.
Статья пригодится не только программистам. Ключ к Gemini заводят аналитики, чтобы разбирать таблицы пачками, маркетологи, чтобы генерировать описания товаров, поддержка, чтобы сортировать обращения. Python нужен на уровне «умею запустить файл и прочитать ошибку».
Если хочется освоить работу с нейросетями системно, а не по обрывкам инструкций, загляните в нашу подборку курсов по нейросетям и искусственному интеллекту: там больше тысячи программ, от коротких интенсивов до годовых.
Что такое Gemini API и чем он отличается от приложения Gemini
Приложение Gemini — это чат в браузере или на телефоне, куда вы пишете вопрос руками. Gemini API — это тот же мозг, но с дверью для программ. Ваш скрипт отправляет текст на сервер Google, сервер возвращает ответ в машиночитаемом виде, и дальше вы делаете с этим ответом что угодно: складываете в базу, отправляете в Telegram, подставляете в отчёт.
Разница похожа на разницу между кассой в магазине и оптовым складом. В чат вы ходите сами и по одному вопросу за раз. Через API одна программа за ночь обработает десять тысяч запросов, пока вы спите.
API-ключ — это длинная строка символов, что-то вроде пароля, по которому Google понимает, чей это запрос и с чьего счёта списывать деньги. Ключ выдаётся мгновенно и бесплатно, а платить придётся только за объём выше бесплатных лимитов.
Главный практический смысл. Через API вы получаете доступ к тем же моделям, что и в приложении, но можете встроить их в свои процессы и не сидеть при этом в браузере.
Если вы уже пробовали похожее у других провайдеров, механика вас не удивит: у нас есть разборы OpenAI API, Claude API и YandexGPT API. Принцип везде один, отличаются названия библиотек и цены.
Что стоит проверить до того, как открывать AI Studio
Самый частый сценарий провала выглядит так: человек читает инструкцию, идёт на aistudio.google.com, жмёт «Get API key» и видит либо отказ, либо белую страницу. Инструкция при этом ни в чём не виновата, просто она написана для другой географии.
Gemini API доступен не везде. Google держит открытый список поддерживаемых стран и территорий, их больше двухсот. На сентябрь 2026 в этом списке нет России, Беларуси и Казахстана: между Румынией и Руандой в перечне пусто, между Барбадосом и Бельгией тоже. Проверить актуальность списка можно на странице ai.google.dev/gemini-api/docs/available-regions.
Что это означает практически. Ключ, выпущенный из неподдерживаемой страны, либо не создастся, либо создастся, но на первом же запросе вернёт ошибку с формулировкой User location is not supported for the API use и статусом FAILED_PRECONDITION. Разбор этой ошибки идёт ниже отдельным блоком, потому что она вылезает и у тех, кто находится во вполне разрешённой стране.
Так что порядок действий такой: сначала понимаете, из какой страны вы будете обращаться к API и какой платёжный контур у вас есть, и только потом идёте за ключом. Обратный порядок стоит вечера отладки кода, в котором нет ни одной ошибки.
Канал основателя Checkroi Вани Буявца3 700 человек читают мой Телеграм-канал про нейросетиСобрал промпты для Claude Code и ChatGPT, разборы ИИ-инструментов и лайфхаки по продвижению бизнеса в одном местеПрисоединитьсяКак получить ключ Gemini API за три шага
Ключ выдаёт Google AI Studio — бесплатная веб-песочница, где можно потыкать модель руками до того, как писать код. Никакой оплаты на этом этапе не требуется и карту привязывать не нужно.
Шаг 1: заходим в AI Studio под своим Google-аккаунтом
Адрес aistudio.google.com. Подойдёт любой личный аккаунт Google, отдельную регистрацию проходить не надо. При первом входе Studio попросит принять условия использования API.
Шаг 2: создаём ключ
В левом меню есть пункт Get API key (или «API keys» в зависимости от того, какую версию интерфейса вам показали). Дальше кнопка создания ключа: Studio предложит либо завести новый проект Google Cloud, либо привязать ключ к существующему. Если проектов у вас никогда не было, соглашайтесь на новый: он создастся автоматически и денег не стоит.
Через пару секунд вы увидите строку вида AIzaSy... длиной под сорок символов. Это и есть ключ. Скопируйте его сразу: Google показывает значение целиком только в момент создания, потом придётся создавать новый.
Шаг 3: убираем ключ из поля зрения
Ключ — это доступ к вашему счёту. Утёкший ключ означает, что чужие запросы будут оплачены с вашей карты, поэтому есть три правила, которые нарушают примерно все и потом жалеют.
- Не вписывать ключ прямо в код. Строка
api_key = "AIzaSy..."в файле — это ключ, который уедет в репозиторий при первом же коммите. - Не выкладывать в публичный репозиторий. Боты сканируют новые коммиты на GitHub за минуты, а не за дни.
- Не отдавать ключ во фронтенд. Всё, что попало в JavaScript на странице, видно любому посетителю через инструменты разработчика.
Правильное место для ключа — переменная окружения. Если сама идея обращения одной программы к другой пока звучит туманно, помогает базовый разбор «Что такое API простыми словами». Это именованное значение, которое живёт в настройках вашей операционной системы или сервера, а программа читает его при запуске. В коде остаётся только имя, само значение в файл не попадает.
CheckroiПодборка курсов по Python570 курсов • 46 школСравните цены, школы, программу и найдите выгодные предложения по обучениюСравнить→
Первый запрос на Python за пять минут
Здесь начинается часть, ради которой всё затевалось. Понадобится Python версии 3.9 или новее и терминал. Если запускать файлы Python вы пока не пробовали, у нас есть пошаговая инструкция «Как создать и запустить файл Python в VS Code».
Ставим библиотеку
Официальный пакет называется google-genai. Одна команда в терминале:
pip install -U google-genaiОбратите внимание на дефис и на слово genai, а не generativeai. Разница в одну морфему стоит рабочего кода, и почему это так — в следующем разделе.
Кладём ключ в переменную окружения
Библиотека сама ищет ключ в переменной с именем GEMINI_API_KEY. В macOS и Linux команда выглядит так:
export GEMINI_API_KEY="ваш_ключ_сюда"В Windows через PowerShell:
$env:GEMINI_API_KEY="ваш_ключ_сюда"Такая запись живёт до закрытия окна терминала. Чтобы значение сохранялось между запусками, его прописывают в файл настроек оболочки (~/.zshrc или ~/.bashrc) либо кладут в файл .env рядом с проектом и читают библиотекой python-dotenv. Файл .env обязательно добавляют в .gitignore, иначе смысл упражнения теряется.
Пишем первый скрипт
Создайте файл first_request.py и положите в него шесть строк:
from google import genai
client = genai.Client()
interaction = client.interactions.create(
model="gemini-3.7-flash",
input="Объясни, что такое API, одним абзацем для новичка"
)
print(interaction.output_text)Запускаете командой python first_request.py и через секунду-две получаете в терминале ответ модели. Всё, вы сделали первый запрос к Gemini API.
Разберём, что здесь происходит. genai.Client() создаёт клиента, который сам подтягивает ключ из переменной окружения. client.interactions.create() отправляет запрос: в model вы указываете, какая модель будет думать, в input кладётся сам текст запроса, его называют промптом. output_text — готовый текстовый ответ, уже вынутый из служебной обёртки.
Полезная привычка с первого дня. Меняйте только строку в
input, пока не почувствуете, как модель реагирует на формулировки. Разница между «напиши текст» и «напиши текст в три предложения для email-рассылки» больше, чем разница между моделями.
Если нужен запрос без Python
Проверить ключ можно и вовсе без установки библиотек, через curl — утилиту командной строки, которая умеет отправлять HTTP-запросы. Это удобно, когда вы хотите отделить проблему с ключом от проблемы с кодом:
curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.7-flash:generateContent" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H "Content-Type: application/json" \
-X POST \
-d '{"contents":[{"parts":[{"text":"Привет"}]}]}'В ответ придёт JSON — текстовый формат обмена данными, где ответ модели лежит внутри вложенной структуры. Если JSON пришёл, ключ рабочий, и дальше можно спокойно копать код.
Почему код из большинства инструкций больше не запустится
Это главная ловушка темы, и обойти её стоит подробно.
До 2025 года Python-библиотека для Gemini называлась google-generativeai, а импорт выглядел как import google.generativeai as genai. Именно эта строка стоит в четырёх статьях из пяти, которые сейчас в топе по запросу «gemini api ключ». Google объявил эту библиотеку устаревшей 31 августа 2025 года и перенёс её репозиторий в архив с явной пометкой deprecated.
Параллельно закрылась вторая дверь. Генеративная часть Vertex AI SDK (пакет google-cloud-aiplatform, через который к моделям Google ходили корпоративные команды) была полностью удалена 24 июня 2026 года. Версии Vertex AI SDK, вышедшие после этой даты, новые модели Gemini не поддерживают вообще.
Осталась одна общая библиотека для всего: google-genai. Она едина и для обычных ключей из AI Studio, и для корпоративного контура через Google Cloud, и для соседних моделей вроде Veo и Imagen.
| Что вы видите в инструкции | Статус | Что делать |
|---|---|---|
pip install google-generativeai |
Устарело с августа 2025 | Ставить google-genai |
import google.generativeai as genai |
Устарело | Писать from google import genai |
genai.configure(api_key=...) |
Устарело | Ключ читается из GEMINI_API_KEY |
google-cloud-aiplatform для генерации |
Удалено 24.06.2026 | Переходить на google-genai |
Модели gemini-pro, gemini-1.5-* |
Прошлые поколения | Брать gemini-3.7-flash |
Практический вывод для новичка. Открывая любую инструкцию по Gemini, первым делом смотрите на строку импорта. Увидели google.generativeai, значит статья написана до осени 2025 года либо переписана у того, кто писал тогда. Дальше можно не читать: цены, лимиты и названия моделей в ней будут такими же несвежими.
Какую модель выбрать новичку
В API доступно больше десятка моделей: текстовые, для картинок, для видео, для эмбеддингов. Для первых экспериментов важны три текстовые.
| Модель | Model ID | Для чего |
|---|---|---|
| Gemini 3.7 Flash | gemini-3.7-flash |
Самая свежая быстрая модель: код, многошаговые задачи, повседневная работа |
| Gemini 3.1 Pro | gemini-3.1-pro-preview |
Тяжёлые рассуждения и сложные задачи, стоит заметно дороже |
| Gemini 3.1 Flash-Lite | gemini-3.1-flash-lite |
Массовая обработка простых запросов по минимальной цене |
Если непонятно, что брать, берите gemini-3.7-flash. Это дефолт из официального быстрого старта Google, он справляется с подавляющим большинством задач и стоит в пять раз дешевле старшей модели. К Pro имеет смысл идти, когда вы упёрлись в качество на конкретной задаче и можете это качество измерить.
Model ID — это точное техническое имя, которое подставляется в поле model. Оно отличается от рекламного названия: человеку говорят «Gemini 3.7 Flash», а код требует gemini-3.7-flash. Ошибка в этой строке даёт ошибку 404, будто модели не существует.
Подробное сравнение линейки без кода мы собрали в статье «Какую модель Gemini выбрать».
CheckroiПодборка курсов по Нейросетям899 курсов • 62 школыСравните цены, школы, программу и найдите выгодные предложения по обучениюСравнить→
Канал основателя Checkroi Вани БуявцаЗабирайте промпты и обучение по нейросетям в моём Телеграм-каналеБольше 3 700 человек уже применяют Claude Code, ChatGPT и другие нейросети в работе, учёбе, бизнесе и жизниПерейти в каналСколько это стоит и где заканчивается бесплатный тариф
Бесплатный тариф существует, и на нём можно спокойно прожить всё обучение. Google даёт бесплатные входные и выходные токены с ограничениями по скорости, доступ к части моделей и работу в AI Studio.
Токен — это кусочек текста, на которые модель режет ваш запрос, и от их числа напрямую зависит счёт. Если интересно, как модель обрабатывает их внутри, есть разбор «Языковые модели простыми словами». Ориентир для русского языка: одно слово это примерно полтора-два токена. Платите вы и за то, что отправили, и за то, что получили в ответ.
Цены платного тарифа на сентябрь 2026 за миллион токенов:
| Модель | Вход | Выход |
|---|---|---|
| Gemini 3.7 Flash | $0,75 до 31.12.2026, дальше $1,50 | $3,75 до 31.12.2026, дальше $7,50 |
| Gemini 3.1 Pro | $2,00 (до 200К токенов в запросе) | $12,00 |
| Gemini 3.1 Flash-Lite | $0,25 | $1,50 |
На флагманской быстрой модели сейчас действует промо-период до 31 декабря 2026 года: вход и выход стоят вдвое дешевле обычного. С января цена вернётся к $1,50 и $7,50. Если планируете бюджет проекта на год вперёд, считайте по полной цене, чтобы в январе не пересматривать смету.
Отдельно есть Batch API — пакетная обработка, когда ответы нужны в течение суток, а не сию секунду. Скидка составляет 50 % к обычной цене. Механику мы разбирали на примере других провайдеров в статьях про Batch API в OpenAI и Batch API в Claude, у Google она устроена похоже.
Важный нюанс про приватность. На бесплатном тарифе Google использует ваш контент для улучшения своих продуктов, на платном не использует. Это прямо написано в прайс-листе. Пока вы учитесь на выдуманных примерах, разницы нет. Как только в промпты поедут данные клиентов, бесплатный тариф перестаёт быть вариантом.
Про лимиты бесплатного тарифа есть отдельная тонкость, о которой не пишут статьи-конкуренты. Раньше Google публиковал таблицу вида «15 запросов в минуту, 1500 в сутки», и эти цифры до сих пор кочуют по инструкциям. Сейчас документация конкретных чисел не приводит: сказано, что лимиты зависят от тарифа и модели и смотреть их надо в личном дашборде AI Studio на странице aistudio.google.com/rate-limit. Так что любая инструкция, где лимит назван цифрой, пересказывает прошлогоднее состояние.
Что делать, если запрос упал с ошибкой
Три ошибки закрывают почти все обращения новичков.
400 FAILED_PRECONDITION и location not supported
Полный текст: User location is not supported for the API use. Google определил, что запрос пришёл из страны, которой нет в списке поддерживаемых. Что важно знать: эта же ошибка приходит людям в разрешённых странах. Например, при запуске кода на сервере европейского хостинг-провайдера, у которого адрес числится за другой юрисдикцией, или когда у проекта не подключён биллинг. Проверять стоит три вещи по порядку: страну, откуда физически уходит запрос; подключён ли платёжный аккаунт к проекту; какую версию эндпоинта вы используете (v1 для стабильных возможностей, v1beta для предварительных).
429 и превышение квоты
Вы упёрлись в лимит запросов. На бесплатном тарифе это происходит быстро, если запустить цикл по списку без пауз. Лечится ожиданием, паузой между запросами в коде или переходом на платный тариф.
404 и модель не найдена
Почти всегда опечатка в Model ID либо старое имя модели из чужой инструкции. Сверьте строку с колонкой Model ID из таблицы выше.
Что делать, если вы в России
Скажем прямо: прямого легального маршрута «получил ключ на российский аккаунт и работаешь» у Google нет. Страны нет в списке поддерживаемых, и попытка обойти это подручными средствами нарушает условия использования сервиса, а заодно ломается в самый неподходящий момент. Разбирать такие схемы мы не будем.
Работающие варианты выглядят так:
- Юрлицо с зарубежным контуром. Компания с оформленным присутствием в поддерживаемой стране и корпоративным Google Cloud получает доступ штатно, через корпоративную платформу вместо ключей AI Studio.
- Работа из поддерживаемой страны. Разработчики, физически находящиеся, скажем, в Армении или Грузии, получают ключ обычным порядком.
- Российские модели вместо Gemini. Если задача рабочая, а не исследовательская, часто дешевле взять то, что работает без приключений: у нас есть разбор YandexGPT API с получением ключа и подсчётом токенов, а сравнение по качеству лежит в статье «Gemini или YandexGPT».
Отдельно про распространённый совет «возьмите ключ у посредника, который принимает рубли». Технически такие сервисы работают, но вы отдаёте свои промпты третьей стороне и остаётесь без гарантий доступа. Для учебных экспериментов это терпимо, для рабочих данных клиентов — нет.
Что Gemini API умеет кроме текста
Пока вы гоняете текстовые запросы, легко забыть, что модели Google мультимодальные: одна и та же модель принимает на вход не только буквы. Это заметно расширяет список задач, ради которых стоит заводить ключ.
Картинки на входе. Модели умеют смотреть на изображение и отвечать по нему: прочитать чек, описать скриншот, вытащить таблицу из фотографии документа. Для бухгалтерии и поддержки это чаще всего первая задача, которая окупает интеграцию.
Аудио и видео на входе. Можно отдать запись созвона и попросить конспект с решениями, отдать видео и получить расшифровку по таймкодам. Тарифицируется это тоже в токенах, просто пересчёт идёт от длительности.
Длинный контекст. Контекстное окно — это объём текста, который модель удерживает в голове за один запрос. У современных моделей Google счёт идёт на сотни тысяч и миллионы токенов, поэтому в один запрос помещается целый регламент или свод документации. Практический смысл: вместо того чтобы резать документ на куски и склеивать ответы, вы отдаёте его целиком и задаёте вопрос.
Эмбеддинги. Отдельное семейство моделей превращает текст в набор чисел, по которым удобно искать похожее по смыслу, а не по совпадению слов. Это фундамент поиска по своей базе знаний и рекомендаций.
С чего начинать расширение. Не пытайтесь на второй день собрать поиск по базе знаний. Возьмите одну повторяющуюся задачу, которая у вас уже есть в текстовом виде, доведите её до стабильного результата и только потом добавляйте картинки, аудио и остальное.
Отдельная привычка, которая экономит деньги с самого начала: считать токены до запуска цикла, а не после. Сто тысяч запросов по копейке — это уже ощутимая сумма, и увидеть её лучше в оценке, чем в счёте.
Чек-лист первого дня
Короткая проверка, по которой стоит пройтись, прежде чем считать, что у вас всё настроено.
- Ключ создан в AI Studio и скопирован целиком.
- Ключ лежит в переменной окружения
GEMINI_API_KEY, а не в теле скрипта. - Файл
.envдобавлен в.gitignore. - Установлен пакет
google-genai, а неgoogle-generativeai. - В коде стоит
from google import genai. - В поле
modelпрописан актуальный Model ID. - Скрипт вернул текст, а не трассировку ошибки.
- Вы знаете, где смотреть свои лимиты и расход.
Восемь пунктов закрывают примерно все причины, по которым первый запрос не проходит.
Где научиться работать с нейросетями системно
Первый запрос — это десять минут работы. Дальше начинается интересное: как собирать промпты, которые дают стабильный результат, как считать расход токенов, как встраивать модель в реальный процесс так, чтобы она не выдумывала факты. Это ремесло, и по обрывкам инструкций оно собирается медленно.
Мы сравнили программы по нейросетям от разных школ, от коротких интенсивов до годовых курсов с проектами в портфолио.
| Курс | Школа | Стоимость со скидкой | В рассрочку | Длительность | Обзор курса от Checkroi |
|---|---|---|---|---|---|
| Нейросети для изображений и видео Перейти на сайт курса |  Эдюсон | 47 504 ₽ | 3958 ₽/мес. | 2 месяца | Обзор курса |
| Нейросети для рабочих задач Перейти на сайт курса |  Skillbox | 31 290 ₽ | 2608 ₽/мес. | 1 месяц | Обзор курса |
| Нейросети. Практический курс Перейти на сайт курса | Skillbox | 74 900 ₽ | 6242 ₽/мес. | 3 месяца | Обзор курса |
| Нейросети для каждого: как решать рабочие задачи быстрее Перейти на сайт курса |  Нетология | 57 000 ₽ | 2763 ₽/мес. | 6 недель | Обзор курса |
| Продуктовый маркетолог + Нейросети для маркетинга Перейти на сайт курса | Нетология | 110 200 ₽ | 3875 ₽/мес. | 5 месяцев | Обзор курса |
| Нейросети для дизайнера Перейти на сайт курса | Skillbox | 84 272 ₽ | 3831 ₽/мес. | 4 месяца | Обзор курса |
| Нейросети для работы |  Skypro | 44 690 ₽ | 5477 ₽/мес. | 3 месяца | Обзор курса |
| Нейросети для каждого Перейти на сайт курса |  Академия Синергия | 39 900 ₽ | 3325 ₽/мес. | 3 месяца | Обзор курса |
| Нейросети для начинающих Перейти на сайт курса |  SF Education | 42 000 ₽ | 2333 ₽/мес. | 1 месяц | Обзор курса |
| Нейросети для маркетинга Перейти на сайт курса | Skillbox | 29 800 ₽ | 4967 ₽/мес. | 1 месяц | Обзор курса |
Больше программ — в полном каталоге курсов по нейросетям и искусственному интеллекту
Если интересна именно разработка, а не прикладное применение, посмотрите курсы по Python, а карту развития до уровня, на котором с моделями работают за деньги, мы разобрали в статье «Как стать AI-разработчиком».
