Ключ Gemini API создаётся в Google AI Studio за минуту: на aistudio.google.com/apikey нажмите Create API key. Но России нет в списке регионов, где Gemini API работает, поэтому официально получить ключ Google отсюда нельзя. Модели Gemini при этом доступны через шлюз Claudexia с обычным 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 советует импортировать проект Cloud кнопкой Import projects в разделе Projects и создать ключ уже на странице API Keys.
Для Python есть пакет google-genai (pip install -U google-genai), для JavaScript @google/genai. Правила обращения с ключом 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 через Claudexia: модели, цены и вызов
В каталоге Claudexia на 29 октября 2026 три текстовые модели Google. Цены в долларах за миллион токенов, прайс Claudexia на 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. В каталоге Claudexia Argon на 29 октября нет. И второе: сравнивайте цены на своём объёме, потому что у Google цена 3.8 Flash до 31 декабря 2026 одна, а с 1 января вдвое выше.
Вызов идёт через OpenAI-совместимый эндпоинт https://api.claudexia.tech/v1. Аккаунт Google не нужен:
from openai import OpenAI
client = OpenAI(
base_url="https://api.claudexia.tech/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 https://api.claudexia.tech/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.claudexia.tech/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 млн выхода. Цены Claudexia из таблицы выше, кэш не учитываем:
| Модель | Вход | Выход | Итого в месяц |
|---|---|---|---|
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 или Claudexia
| Ситуация | Что выбрать |
|---|---|
| Страна в списке Google, нужен бесплатный прототип | Ключ AI Studio и Gemini 3.8 Flash, помня, что данные бесплатного уровня идут на улучшение продуктов |
| Нужны функции нативного API Google | Прямой ключ Google, если страна поддерживается |
| Россия, нужен Gemini в скрипте или сервисе | Ключ Claudexia и gemini-3.8-flash или gemini-3.1-pro |
| Один код для Gemini, Claude и GPT | Один ключ Claudexia, смена только model, см. сравнение Claude и Gemini |
| Генерация картинок Google | nano-banana-pro и другие в Claudexia, разбор в статье Nano Banana бесплатно |
Если вы сравниваете шлюзы и прямые API целиком, к выбору поможет материал про агрегаторы нейросетей.
FAQ
Как получить API-ключ Gemini?
Откройте Google AI Studio по адресу aistudio.google.com/apikey, нажмите Create API key и сохраните значение в переменную GEMINI_API_KEY. Из России Google такой доступ не поддерживает, альтернатива: ключ Claudexia и 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 можно вызвать через шлюз Claudexia без аккаунта Google.
Где взять API Gemini и можно ли его купить?
Официально ключ создаётся бесплатно в AI Studio, платят только за токены после включения биллинга. Покупать готовые ключи у перепродавцов не стоит: это чужой ключ, который можно отозвать. Вместо него берите собственный ключ у шлюза.
Какие модели Gemini есть в Claudexia?
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. В Claudexia меняются только base_url на https://api.claudexia.tech/v1 и ключ на sk_cdx_....