Ключ Gemini API делается за минуту: откройте aistudio.google.com/apikey и нажмите Create API key. Загвоздка в регионе. России нет в списке стран, где работает Gemini API, так что официальный ключ Google отсюда оформить нельзя. Зато модели Gemini открыты через шлюз codexkey: обычный OpenAI-совместимый клиент, ключ sk_cdx_... и оплата в рублях.
Как создать API-ключ Gemini в Google AI Studio
Если вы живёте в поддерживаемой стране, путь короткий. По документации Google:
- Откройте
aistudio.google.com/apikey. - Нажмите Create API key. Ключи из AI Studio теперь по умолчанию имеют тип auth key.
- Сохраните значение в переменную
GEMINI_API_KEY. Работает иGOOGLE_API_KEY, но если заданы обе, приоритет у второй.
Первый запрос из быстрого старта:
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "gemini-3.8-flash",
"input": "Explain how AI works in a few words"
}'
Бывает, что ключ или проект не видны в списке. Тогда Google советует нажать Import projects в разделе Projects, а ключ создать уже на странице API Keys.
Клиентские библиотеки: google-genai для Python (pip install -U google-genai) и @google/genai для JavaScript. К самому ключу Google строг. Обращайтесь с ним как с паролем, не коммитьте в Git, не выносите в клиентский код и ограничьте его одним Gemini API: неограниченные стандартные ключи сервис уже отклоняет.
Gemini API бесплатно: квоты и цены на 29 октября 2026
Сначала про названия, потому что запрос «gemini flash api» ведёт сразу на несколько моделей. Страница моделей Google называет флагманом Gemini 4 Argon (gemini-4-argon) с контекстом в 1 млн токенов. Gemini 3.8 Flash (gemini-3.8-flash) подана как самая сильная Flash-модель: её предлагают для длинных задач по коду и для автономных агентов. Gemini 3.6 Flash осталась стабильной моделью прошлого поколения. Мы советуем начинать с Flash. Она дешевле, а нужен ли вам Pro, покажет прогон на ваших запросах.
Бесплатный уровень есть не у каждой модели. Ниже данные со страницы цен Gemini API, цены Google в долларах за миллион токенов:
| Модель | Бесплатный уровень | Платный тариф |
|---|---|---|
| Gemini 3.8 Flash | Да | Вход $0.75, выход $3.75 до 31 декабря 2026, затем $1.50 и $7.50 |
| Gemini 3.1 Pro | Нет | Вход $2.00, выход $12.00 при запросе до 200k токенов, $4.00 и $18.00 при большем |
| Nano Banana Pro (картинки) | Нет | $0.134 за картинку в 1K и 2K, $0.24 в 4K, см. обзор |
Что нужно знать про бесплатный уровень. Лимиты в запросах на минуту и на день Google на этой странице не называет: их показывает AI Studio, а сама компания оговаривается, что заявленные лимиты не гарантированы. Данные бесплатного уровня идут на улучшение продуктов Google, в графе платного уровня здесь стоит «нет». Клиентские данные и внутренний код туда лучше не отправлять.
Чтобы перейти на платный уровень, привяжите платёжный аккаунт и пополните баланс минимум на $5, правила описаны на странице биллинга. Дальше уровни растут вместе с накопленными тратами: второй открывается после $100 и трёх дней с первого платежа, третий после $1000 и 30 дней (раздел лимитов в документации).
Gemini API в России: почему ключ не выдают и чего не делать
Список регионов Gemini API и AI Studio Россию не включает (проверено 29 октября 2026). Официальный сервис работает только в перечисленных странах. Это ограничение по региону, а не сбой оплаты.
Чего мы делать не советуем:
- Покупать «готовые ключи Gemini» у перепродавцов. Ключ создаётся бесплатно, продавать там нечего, а чужой ключ отзовут в любой момент вместе с вашими данными.
- Подменять страну и платёжные данные. Аккаунт могут отправить на проверку, и доступ пропадёт посреди проекта.
- Выкладывать свой ключ в репозиторий или чат. Утёкший ключ Google советует заменить и отключить старый.
Если коротко, у вендора ваша страна не поддерживается, а к тем же моделям ведёт шлюз, который сам оплачивает вызовы и принимает рубли. Для Claude работает тот же принцип, подробности в статье Claude API в России.
Gemini через codexkey: модели, цены и вызов
В каталоге codexkey на 29 октября 2026 три текстовые модели Google. Цены в долларах за миллион токенов, это прайс codexkey на 29 октября 2026, свежие значения смотрите на странице моделей:
| ID | Контекст | Вход | Выход | Чтение кэша |
|---|---|---|---|---|
gemini-3.1-pro | 1000K | $0.24 | $1.44 | $0.04 |
gemini-3.7-flash | 1000K | $0.2 | $0.96 | $0.02 |
gemini-3.8-flash | 1000K | $0.2 | $0.96 | $0.02 |
Два уточнения. Первое: на странице моделей Google gemini-3.7-flash уже не упомянута, там перечислены 3.8 Flash и 3.6 Flash, а новым флагманом назван Gemini 4 Argon. В каталоге codexkey Argon на 29 октября нет. Второе: сравнивайте цены на своём объёме, потому что у Google цена 3.8 Flash действует в прежнем размере до 31 декабря 2026, а с 1 января становится вдвое выше.
Вызов идёт через OpenAI-совместимый эндпоинт https://api.codexkey.ru/v1. Аккаунт Google для этого не нужен:
from openai import OpenAI
client = OpenAI(
base_url="https://api.codexkey.ru/v1",
api_key="sk_cdx_ВАШ_КЛЮЧ",
)
response = client.chat.completions.create(
model="gemini-3.8-flash",
messages=[{"role": "user", "content": "Объясни разницу между Flash и Pro в трёх предложениях"}],
max_tokens=300,
)
print(response.choices[0].message.content)
Тот же запрос через curl:
curl https://api.codexkey.ru/v1/chat/completions \
-H "Authorization: Bearer sk_cdx_ВАШ_КЛЮЧ" \
-H "Content-Type: application/json" \
-d '{"model": "gemini-3.8-flash", "messages": [{"role": "user", "content": "Привет"}]}'
Список доступных ID возвращает GET https://api.codexkey.ru/v1/models. Эндпоинт принимает параметры model, messages, temperature, max_tokens и stream, детали в разделе совместимости с OpenAI. Функции, которые есть только в нативном API Google, без проверки через него не используйте: сначала сделайте тестовый запрос. Как выпустить ключ и пополнить баланс, написано в быстром старте.
Сколько стоит Gemini API: расчёт на примере
Формула: (токены на входе ÷ 1 000 000) × цена входа + (токены на выходе ÷ 1 000 000) × цена выхода. Допущения в примере наши, подставьте свои: 100 000 запросов в месяц, по 2 000 токенов на входе и 500 на выходе. Выходит 200 млн токенов входа и 50 млн выхода. Берём цены codexkey из таблицы выше, кэш не считаем:
| Модель | Вход | Выход | Итого в месяц |
|---|---|---|---|
gemini-3.8-flash | 200 × $0.2 = $40 | 50 × $0.96 = $48 | $88 |
gemini-3.1-pro | 200 × $0.24 = $48 | 50 × $1.44 = $72 | $120 |
Считали в долларах, а курс плавает, поэтому пересчитывать в рубли нужно на дату пополнения. Flash и Pro в этом сценарии расходятся ненамного, так что выбирайте по качеству ответа, а не по прайсу. Возьмите 30 реальных запросов, прогоните через обе модели и посчитайте, сколько ответов проходят вашу проверку. Потом разделите траты на число принятых ответов. Так видна настоящая цена результата.
Перед запуском в продакшен загляните в лимиты запросов шлюза: там понятно, сколько параллельных вызовов выдержит ваш ключ.
Какой путь выбрать: ключ Google или codexkey
| Ситуация | Что выбрать |
|---|---|
| Страна есть в списке Google, нужен бесплатный прототип | Ключ AI Studio и Gemini 3.8 Flash, помня, что данные бесплатного уровня идут на улучшение продуктов |
| Нужны функции нативного API Google | Прямой ключ Google, если ваша страна поддерживается |
| Россия, Gemini нужен в скрипте или сервисе | Ключ codexkey и gemini-3.8-flash или gemini-3.1-pro |
| Один код для Gemini, Claude и GPT | Один ключ codexkey, меняется только model, см. сравнение Claude и Gemini |
| Генерация картинок Google | nano-banana-pro и другие модели в codexkey, разбор в статье Nano Banana бесплатно |
Если сравниваете шлюзы и прямые API целиком, пригодится материал про агрегаторы нейросетей.
FAQ
Как получить API-ключ Gemini?
Зайдите в Google AI Studio на aistudio.google.com/apikey, нажмите Create API key и сохраните значение в GEMINI_API_KEY. Из России Google такой доступ не даёт. Запасной путь: ключ codexkey и OpenAI-совместимый вызов моделей Gemini.
Gemini API бесплатно: действительно ли?
Отчасти. У Gemini 3.8 Flash на 29 октября 2026 бесплатный уровень есть, но Google использует его данные для улучшения продуктов. У Gemini 3.1 Pro и у моделей картинок бесплатного уровня нет. Точные лимиты запросов Google показывает только в AI Studio.
Работает ли Gemini API в России?
Нет, России нет в списке регионов Gemini API и AI Studio. Нативный ключ Google из России использовать нельзя, а модели Gemini можно вызвать через шлюз codexkey без аккаунта Google.
Где взять API Gemini и можно ли его купить?
Официально ключ выдаётся бесплатно в AI Studio, платить нужно только за токены после включения биллинга. Готовые ключи у перепродавцов покупать не стоит: это чужой ключ, и его могут отозвать. Заведите собственный ключ у шлюза.
Какие модели Gemini есть в codexkey?
gemini-3.1-pro, gemini-3.7-flash и gemini-3.8-flash, у всех контекст 1000K. Актуальный список возвращает GET /v1/models. Нового флагмана Google, Gemini 4 Argon, в каталоге на 29 октября 2026 нет.
Чем Gemini Flash отличается от Pro в API?
Flash заточен под скорость и большие объёмы. Google описывает 3.8 Flash как самую сильную Flash-модель для длинных задач по коду и автономных агентов. Pro дороже, его берут для сложных рассуждений. Проверьте обе на своих примерах и посчитайте цену одного годного ответа.
Можно ли вызвать Gemini через OpenAI SDK?
Да. У Google есть собственный совместимый эндпоинт: в base_url указывают https://generativelanguage.googleapis.com/v1beta/openai/, в api_key кладут ключ Gemini, а в примерах Google фигурирует модель gemini-3.8-flash. Из России он закрыт по той же причине, что и остальное API. В codexkey меняются только base_url на https://api.codexkey.ru/v1 и ключ на sk_cdx_....