Gemini API в России: как получить ключ, чем оплатить и что значат ошибки

Ключ Gemini выдаётся в Google AI Studio и привязан к проекту Google Cloud. Из России ломаются оба шага. Разбираем ключи, оплату, регион и три главные ошибки.

Получить ключ Что делать

Коротко: Получить ключ Gemini API и оплатить его из России напрямую не выйдет. Ключ создаётся в Google AI Studio и привязан к проекту Google Cloud, а на 10.10.2026 России нет в списке регионов, где работает Gemini API, и российскую карту к проекту не привязать. Запрос с российского IP отвечает 400 User location is not supported. Рабочих пути два: зарубежный аккаунт с картой и сервером за границей или OpenAI-совместимый шлюз с оплатой в рублях, где меняются только base_url и имя модели.

/ Подробнее

Что важно знать

Как устроен ключ. Он передаётся заголовком x-goog-api-key или параметром key; без платёжного профиля в проекте действует бесплатный уровень с низкими лимитами. С 19 июня 2026 Google отклоняет «неограниченные» стандартные ключи, а с сентября 2026 стандартные ключи не принимаются совсем: старый ключ из кода отвечает 400 API key not valid, новые создаются сразу как auth-ключи.

Типичные ошибки три: API key not valid (400) — ключ неверный или старого типа; User location is not supported for the API use (400, FAILED_PRECONDITION) — запрос из неподдерживаемого региона; RESOURCE_EXHAUSTED (429) — исчерпан лимит запросов или квота проекта. У Gemini есть OpenAI-совместимый режим, поэтому те же модели доступны и через любой OpenAI-совместимый шлюз без правки кода.

/ На kosareva.cloud

Как оплатить Gemini API в рублях

Модели Gemini 3.8 Flash и Gemini 3.1 Pro по OpenAI-совместимому адресу: без AI Studio, проекта Google Cloud и зарубежной карты. Меняются base_url и имя модели.

Gemini 3.8 Flash: 81 ₽ вход, 405 ₽ выход за 1 млн токенов
Gemini 3.1 Pro: 216 ₽ вход, 1 296 ₽ выход за 1 млн токенов
Оплата: Карта РФ или СБП от 50 ₽, компаниям — по счёту
Доступ: Без VPN, запросы идут с российских IP

Получить ключ

from openai import OpenAI

client = OpenAI(
    api_key="ВАШ_API_КЛЮЧ",
    base_url="https://api.kosareva.cloud/v1",
)

response = client.chat.completions.create(
    model="gemini-3-8-flash",
    messages=[{"role": "user", "content": "Привет!"}],
    stream=True,
)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "ВАШ_API_КЛЮЧ",
  baseURL: "https://api.kosareva.cloud/v1",
});

const response = await client.chat.completions.create({
  model: "gemini-3-8-flash",
  messages: [{ role: "user", content: "Привет!" }],
  stream: true,
});

curl https://api.kosareva.cloud/v1/chat/completions \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-3-8-flash","messages":[{"role":"user","content":"Привет!"}],"stream":true}'

/ Почему

Откуда берётся ошибка

Ключ старого типа

стандартный ключ, созданный до лета 2026, с сентября отклоняется. Нужно создать auth-ключ в AI Studio.

Опечатка или чужой ключ

ключ Google Cloud от другого сервиса или ключ с пробелом в переменной окружения. Ответ тот же: API key not valid.

Регион

запрос с российского IP или проект с российским платёжным профилем. FAILED_PRECONDITION, User location is not supported.

Квота

бесплатный уровень или лимит проекта исчерпан. RESOURCE_EXHAUSTED с кодом 429, иногда ещё и сообщение о квоте на день.

Оплата

к проекту не привязана карта, а модель или объём требуют платного уровня. Российскую карту Google не принимает.

/ Таблица

Ошибки Gemini API: текст, причина, что делать

Текст ошибки	Причина	Что делать
400 API key not valid. Please pass a valid API key	Ключ с опечаткой, отозван, от другого сервиса или стандартного типа, который с сентября 2026 не принимается.	Создать новый auth-ключ в AI Studio, проверить переменную окружения, убрать пробелы и кавычки.
400 FAILED_PRECONDITION: User location is not supported for the API use	Регион запроса или платёжного профиля не поддерживается.	Другой ключ не поможет. Нужен адрес API в поддерживаемом регионе или шлюз.
429 RESOURCE_EXHAUSTED	Лимит запросов в минуту или квота проекта исчерпаны.	Повторить через паузу, сократить частоту, привязать оплату для повышения лимита.
403 PERMISSION_DENIED	У проекта или ключа нет доступа к API или модели.	Включить Generative Language API в проекте, проверить ограничения ключа.
404 NOT_FOUND: model not found	Неверное имя модели или версия недоступна в регионе.	Проверить имя в списке моделей, убрать лишние суффиксы.

Gemini возвращает ошибки в формате Google API: поле status (FAILED_PRECONDITION, RESOURCE_EXHAUSTED) и текстовое message. Ориентируйтесь на status.

/ Что делать

Порядок действий

Проверьте ключ одной командой

Если ответ 400 API key not valid, дело в ключе. Если FAILED_PRECONDITION, ключ в порядке, дело в регионе.

curl "https://generativelanguage.googleapis.com/v1beta/models" \
  -H "x-goog-api-key: $GEMINI_API_KEY"

Пересоздайте ключ как auth-ключ

В AI Studio создайте новый ключ: с сентября 2026 все новые ключи создаются в этом формате. Старые стандартные ключи удалите из кода, они уже не заработают.

Определитесь с регионом до кода

Если запрос идёт с российского IP или проект привязан к российскому профилю, API ответит User location is not supported. Ключ, VPN на минуту или новый проект это не чинят: нужен либо зарубежный аккаунт с картой, либо шлюз.

Используйте OpenAI-совместимый режим

У Gemini есть OpenAI-совместимая точка входа, поэтому код на OpenAI SDK работает с моделями Gemini без переписывания. Меняются base_url и имя модели.

from openai import OpenAI
client = OpenAI(
    base_url="https://api.kosareva.cloud/v1",
    api_key="ваш_ключ",
)
r = client.chat.completions.create(
    model="gemini-3-8-flash",
    messages=[{"role": "user", "content": "ping"}],
)
print(r.choices[0].message.content)

Обрабатывайте 429 повторами

RESOURCE_EXHAUSTED на бесплатном уровне приходит быстро. Пауза 1–2 секунды с удвоением, не больше пяти попыток; в SDK это max_retries.

/ По инструментам

Где это чинится в разных инструментах

Python и Node.js SDK Google

Ключ в GEMINI_API_KEY или GOOGLE_API_KEY; исключение содержит status и message, ловите по status.

OpenAI SDK, LangChain, LlamaIndex

Через OpenAI-совместимый режим или шлюз: base_url, ключ, имя модели. Ошибки приходят в формате OpenAI.

Cline, Continue, Open WebUI

Провайдер Gemini с полем ключа или OpenAI Compatible с base URL шлюза и моделью gemini-3-8-flash.

n8n и Make

Нода Google Gemini принимает ключ AI Studio; если она отвечает FAILED_PRECONDITION, сервер n8n стоит в неподдерживаемом регионе.

/ FAQ

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

Как получить gemini api ключ из России?

Ключ выдаётся в Google AI Studio, но на 10.10.2026 России нет в списке регионов Gemini API: вход в AI Studio и привязка карты из России ограничены. Даже с зарубежным аккаунтом запросы с российского IP отвечают User location is not supported.

Почему рабочий ключ вдруг отвечает API key not valid?

Скорее всего это стандартный ключ, созданный до лета 2026: с сентября 2026 Google принимает только auth-ключи. Создайте новый в AI Studio.

Работает ли Gemini API бесплатно?

Есть бесплатный уровень с низкими лимитами по запросам в минуту и в день, для прототипов. При превышении приходит RESOURCE_EXHAUSTED, для продакшена нужна оплата.

Что значит User location is not supported?

Запрос пришёл из региона, где Gemini API не работает, или проект привязан к российскому платёжному профилю. Ключ в порядке, новый ключ не поможет: нужен запрос из поддерживаемого региона или шлюз.

Можно ли оплатить Gemini API в рублях?

У Google нет: российскую карту к проекту не привязать. Через совместимый шлюз — да: у нас Gemini 3.8 Flash и Gemini 3.1 Pro, оплата картой РФ или через СБП от 50 ₽. Компаниям — по счёту от 1 000 ₽ с договором и актом, см. ИИ для бизнеса.

/ Дальше

Рядом в справочнике

Ключ, который работает из России

OpenAI-совместимый адрес, оплата в рублях, ключ сразу после регистрации. Пополнение картой от 50 ₽.

Получить ключ