Gemini API: как получить ключ и подключить

Данные на 21.10.2026, 10:07 МСК · цены в ₽ за 1M токенов

Ключ Gemini API (джемини апи) выдаёт Google AI Studio или российский API-шлюз. Во втором случае запросы идут на адрес шлюза в OpenAI-совместимом формате, а оплата в рублях.

Цены ниже сняты с каталога на 21.10.2026, 10:07 МСК, пересчёт по курсу ЦБ 82,8879 ₽/$.

Где взять ключ Gemini API (Google AI Studio и шлюз)

У Google ключ создаётся в Google AI Studio. Запросы идут на https://generativelanguage.googleapis.com/v1beta/ в формате Google, а для OpenAI SDK у Google есть отдельный адрес https://generativelanguage.googleapis.com/v1beta/openai/ (документация).

Через шлюз ключ и оплата свои. По каталогу Gemini 3.1 Pro есть с ценой у 15 шлюзов из 17, Gemini 3.8 Flash у 14. Сравнение условий, аптайм и способы оплаты в каталоге шлюзов, как выбирать, в гайде по выбору шлюза.

Какие модели Gemini есть по API

В нашем каталоге пять моделей Google: Gemini 4 Argon, Gemini 3.1 Pro, Gemini 3.8 Flash, Gemini 3.5 Flash-Lite и Gemini 2.5 Pro. Полный список моделей всех вендоров на странице модели.

По цене они делятся так. Gemini 4 Argon и 3.1 Pro старшие, у них старший тариф в линейке. Gemini 3.8 Flash примерно в 2,7 раза дешевле на ввод. Flash-Lite самая дешёвая на ввод, её берут на массовые запросы. Gemini 2.5 Pro прошлое поколение Pro. Сравнений по качеству на сайте нет, тут смотрим на свои тесты.

У двух моделей промо-цены. Gemini 4 Argon по $2 / $10 до 30.11.2026, с 01.12 тариф $4 / $20. Gemini 3.8 Flash по $0.75 / $3.75 до 31.12.2026, с 01.01.2027 тариф $1.50 / $7.50.

Цены в рублях за 1M токенов

Минимальный ввод во всех строках у Tokvian. Несколько шлюзов по Gemini 3.1 Pro и 3.8 Flash:

У Gemini вывод дороже ввода в 5–8,3 раза, так что на генерации длинных ответов счёт растёт в основном за счёт вывода.

Первый запрос: формат Google и OpenAI-совместимый через шлюз

Формат Google. Метод generateContent, ключ AI Studio в заголовке x-goog-api-key:

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.8-flash:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "content-type: application/json" \
  -d '{"contents":[{"parts":[{"text":"ping"}]}]}'

OpenAI-совместимый формат через шлюз. Попробовать самому можно с одним ключом: AIShlyuz — один ключ ко всем моделям. Ключ вида sk-ais-… выпускается на aishlyuz.ru/register, адрес https://aishlyuz.ru/v1, ключ Google для него не нужен. Сейчас баланс начисляем по запросу в t.me/aishlyuz, картой пока не пополняем.

Шаг 1. Проверить, какие id есть на ключе:

curl https://aishlyuz.ru/v1/models \
  -H "Authorization: Bearer sk-ais-…"

Шаг 2. Запрос через curl:

curl https://aishlyuz.ru/v1/chat/completions \
  -H "Authorization: Bearer sk-ais-…" \
  -H "content-type: application/json" \
  -d '{"model":"gemini-3-8-flash","messages":[{"role":"user","content":"ping"}]}'

Шаг 3. Python и OpenAI SDK:

from openai import OpenAI

client = OpenAI(base_url="https://aishlyuz.ru/v1", api_key="sk-ais-…")

resp = client.chat.completions.create(
    model="gemini-3-1-pro",
    messages=[{"role": "user", "content": "Найди баг в этом диффе"}],
)
print(resp.choices[0].message.content)

Обратите внимание на id: у Google это gemini-3.8-flash с точками, у нас gemini-3-8-flash с дефисами. У других шлюзов свои id, например у Polza AI google/gemini-3.8-flash. Всегда берите id из списка моделей конкретного адреса. Подробнее про схему: один API-ключ для всех нейросетей, как подключить.

Gemini в Cursor, Claude Code, Cline

Cursor. Settings → Models → API Keys, ключ в поле OpenAI API Key, включаем Override OpenAI Base URL и ставим адрес шлюза. Модель Gemini добавляем по id из /v1/models. Подробно в Cursor со своим API-ключом.

Claude Code. Через наш адрес Claude Code работает только с моделями claude-*, Gemini туда не подключаем. Что ставить в Claude Code и Cursor из России, в разборе нейросети для Cursor и Claude Code.

По Cline данных на сайте нет, этот пункт пропускаем. Совместимость шлюзов с Cursor, Claude Code и Codex есть в таблице каталога шлюзов.

Длинный контекст и кеширование: что посчитать заранее

Официальные цены Gemini 3.1 Pro и 2.5 Pro в таблице даны для запросов до 200K токенов. Если агент гоняет больше, проверьте тариф выше этого порога в прайсе Google и прикиньте месяц в калькуляторе.

Кеш сильно снижает ввод. По официальному прайсу кеш-хит у Gemini 4 Argon $0.1 вместо $2 (−95%), у 3.1 Pro $0.2 вместо $2, у 3.8 Flash $0.075 вместо $0.75, у 3.5 Flash-Lite $0.03 вместо $0.3 (−90%). Какие шлюзы публикуют цену кеша, в статье про кеш промптов.

Ошибки подключения

Коды ответа нашего адреса:

• 401: ключ неверный или отозван.
• 402: на балансе нет денег, запрос к модели не уходит.
• 404: такой модели нет, сверяем id с /v1/models.

Частая причина 404 с Gemini это id с точками вместо дефисов или наоборот. Остальное в типичных ошибках подключения. GPT по API из России разобран здесь, DeepSeek на странице DeepSeek API.

Частые вопросы