Как получить API Gemini из России в 2026: AI Studio, Vertex AI или шлюз

Как получить API Gemini из России в 2026: три маршрута к ключу
Как получить API Gemini из России в 2026: три маршрута к ключу

Получить API Gemini из России в 2026 году можно тремя маршрутами: через Google AI Studio, через облачную платформу Google (бывший Vertex AI) или через российский шлюз вроде Provod, и у каждого маршрута свой регион, свой ключ и своя точка, где всё может сломаться. России нет в официальном списке стран Gemini Developer API и AI Studio, а локации облачной платформы Google описывают совсем другую вещь, место обработки запроса.

Ниже разберу, какой регион к какому продукту относится, кто выдаёт ключ на каждом маршруте и как одним коротким запросом понять, что маршрут действительно работает.

Три разных «региона», которые легко перепутать

Когда разработчик читает «Gemini недоступен в вашем регионе», он обычно думает про один регион, хотя их минимум три.

Живут они в разных документах Google.

Первый регион касается вас как пользователя. Это список стран Gemini API и Google AI Studio: на 12.11.2026 России в нём нет, Беларуси тоже. Страница прямо пишет, что если вы попали на неё при попытке открыть AI Studio, ваш регион, скорее всего, не поддерживается, и тем, кого нет в списке, предлагает смотреть в сторону облачной платформы.

Второй регион касается денег. Платный уровень Gemini API, судя по описанию биллинга, включают привязкой платёжного аккаунта Google Cloud к проекту. При оформлении выбирают страну, вводят платёжные данные и вносят предоплату от 5 долларов. Причём запросы обслуживаются только при положительном балансе предоплаты. Проходит ли российский платёжный аккаунт, публичные источники не подтверждают, и сквозного теста с российским аккаунтом я не нашёл.

Третий регион касается железа. В документации по локациям облачной платформы Google регион означает, где исполняется запрос: в us-central1, в мультирегионе ЕС или где-то по всему миру через глобальный адрес. К тому, откуда вы сидите, этот регион прямого отношения не имеет.

Отсюда вся путаница. Человек выбирает в облаке europe-west1 и думает, что «сменил регион», а вопрос с доступностью аккаунта и оплатой как висел, так и висит.

AI Studio и Gemini Developer API: самый короткий путь, если вы в списке

Глазами разработчика AI Studio выглядит проще всего. По инструкции Google ключ создаётся на странице API Keys в AI Studio, и каждый ключ Gemini API привязан к проекту Google Cloud: новому пользователю проект и ключ создаются автоматически.

Дальше всё стандартно:

  • ключ кладут в переменную GEMINI_API_KEY или GOOGLE_API_KEY, официальные библиотеки подхватывают любую из них, а если заданы обе, побеждает GOOGLE_API_KEY;
  • в REST-запросе ключ передаётся заголовком x-goog-api-key;
  • базовый адрес https://generativelanguage.googleapis.com/v1beta.

Загвоздка в том, что весь этот маршрут стоит на первом регионе, пользовательском. Для аккаунта из России, которого нет в официальном списке, ответ даёт сама документация Google, и обходить её советами про чужие аккаунты я здесь не буду. Команде, которая юридически и фактически работает из страны списка, это самый прямой вариант. Остальным честнее сразу смотреть на два других маршрута.

Ключ Gemini API в AI Studio: какой регион проверяет Google
Ключ Gemini API в AI Studio: какой регион проверяет Google

Vertex AI, он же Gemini Enterprise Agent Platform: регион здесь про сервер

С апреля 2026 года Google развивает Vertex AI под новым именем Gemini Enterprise Agent Platform, поэтому в свежей документации вы встретите оба названия, а в старых статьях только первое. Для нашей задачи это одна и та же облачная платформа.

Здесь ключ выдаёт уже Google Cloud: доступ идёт через проект, сервисный аккаунт и права в облаке, а модель вызывается через эндпоинт выбранной локации. Документация описывает три типа адресов:

  • региональный, например us-central1-aiplatform.googleapis.com, когда запрос обрабатывается в одном регионе;
  • мультирегиональный, aiplatform.us.rep.googleapis.com или aiplatform.eu.rep.googleapis.com, когда обработка остаётся в границах США или ЕС;
  • глобальный, aiplatform.googleapis.com, когда Google сам раскидывает запросы по регионам ради доступности и меньшего числа ошибок 429.

Про глобальный адрес полезно запомнить две фразы из той же документации. Его не советуют, если у вас есть требования к месту обработки данных, и сами эндпоинты, по словам Google, не гарантируют ни хранения данных в регионе, ни обработки в нём. Добавлю от себя очевидное, но важное: глобальный эндпоинт ничего не говорит о том, примет ли Google Cloud ваш аккаунт, вашу карту и даст ли нужную модель в нужной локации. Это три отдельные проверки, и делать их надо по очереди.

Для команды из России облачная платформа выглядит так: маршрут мощный, с тонкой настройкой регионов и квот, но всё упирается в тот же вопрос аккаунта и оплаты Google Cloud, и публичного подтверждения, что он проходит, на 12.11.2026 нет.

Шлюз в рублях: где регион перестаёт быть вашей задачей

Третий маршрут устроен иначе. Вы не получаете ключ Google вовсе: ключ выдаёт платформа-посредник, она же принимает оплату и сама ходит к модели. Так устроены агрегаторы, например международный OpenRouter и ряд российских сервисов, и выбор между ними обычно сводится к каталогу, цене за токен и способу оплаты.

Разберу маршрут на примере Provod, потому что у него открытая документация. Ключ здесь принадлежит рабочему пространству Provod, и с Google-ключом у него нет ничего общего. Выпускают его на странице API Provod, хранить советуют на доверенном сервере, а при утечке отзывают и выпускают новый. Запрос уходит в OpenAI-совместимый формат Chat Completions на адрес https://api.provod.ai/v1, то есть подойдёт обычный клиент OpenAI с другим base_url.

В каталоге Provod на 12.11.2026 есть одиннадцать текстовых моделей Gemini, от gemini-2.5-flash-lite и gemini-2.5-pro до gemini-3.1-pro-preview и gemini-3.8-flash. Цены в рублях за миллион токенов входа и выхода опубликованы на странице тарифов и меняются, поэтому сверяйте их в день подключения.

Решающее слово здесь за ответом вашего пространства. Документация по выбору модели просит брать поле id из GET /v1/models и копировать его точно. Там же видно поле available: если оно false, рядом лежит причина, и для части моделей в личном пространстве это FIRST_TOP_UP_REQUIRED, то есть модель откроется после первого реального пополнения. Поэтому наличие модели и свежую ставку подтверждайте в своём кабинете, витрина сайта здесь только ориентир.

Оплата идёт с рублёвого баланса. По странице баланса физлицу кабинет предлагает карту и СБП, для ООО и ИП создаётся банковский счёт по реквизитам организации, а детали бизнес-оплаты вынесены отдельно. Перед каждым запросом Provod резервирует на балансе оценку стоимости, после ответа списывает подтверждённую сумму и возвращает неиспользованный остаток резерва.

API Gemini через шлюз в рублях: ключ пространства и каталог моделей
API Gemini через шлюз в рублях: ключ пространства и каталог моделей

Три карточки для одной задачи

Возьмём простой сценарий команды: нужно получить от Gemini один короткий ответ из своего бэкенда. Сведу все три маршрута в карточки с одинаковыми полями, чтобы сравнивать было удобно.

Gemini Developer API через AI Studio:

  • официальная доступность: России нет в списке стран на 12.11.2026;
  • кто выдаёт credential: Google, ключ в AI Studio, привязанный к проекту Google Cloud;
  • endpoint: generativelanguage.googleapis.com/v1beta, заголовок x-goog-api-key;
  • ID модели: из документации Gemini API;
  • что подтвердить перед запуском: что вы в списке стран, а платный уровень привязан к рабочему платёжному аккаунту с положительной предоплатой.

Облачная платформа Google (Vertex AI):

  • официальная доступность: локации описывают место обработки, доступность аккаунта из России публично не подтверждена;
  • кто выдаёт credential: Google Cloud, проект и сервисный аккаунт с правами;
  • endpoint: региональный, мультирегиональный или глобальный aiplatform.googleapis.com;
  • ID модели: из списка моделей конкретной локации;
  • что подтвердить перед запуском: аккаунт и биллинг Google Cloud, наличие модели именно в выбранной локации, требования к месту обработки данных.

Provod:

  • официальная доступность: Gemini есть в публичном каталоге, доступность для вашего пространства видна в поле available;
  • кто выдаёт credential: Provod, ключ рабочего пространства;
  • endpoint: https://api.provod.ai/v1/chat/completions;
  • ID модели: точное поле id из GET /v1/models;
  • что подтвердить перед запуском: баланс именно того пространства, где выпущен ключ, свежую ставку модели и ответ на тестовый запрос.

Критерий выбора у меня получился такой.

Когда ваша команда в стране из списка и платит Google напрямую, берите AI Studio для прототипа и облачную платформу для продакшена с требованиями к данным. При аккаунте, оплате или юрлице, привязанных к России, первым проверяйте шлюз с рублёвым балансом, потому что вопрос региона он снимает с вашей стороны и переносит на свою.

Тестовый запрос: что должно совпасть в ответе

Пример ниже документационный: он собран по опубликованному описанию Chat Completions в Provod, для этой статьи запрос не запускался, поэтому вывод модели в нём не показан. Ключ лежит в переменной окружения, в коде его нет.

import os from openai import OpenAI client = OpenAI( api_key=os.environ["PROVOD_API_KEY"], base_url="https://api.provod.ai/v1", ) resp = client.chat.completions.create( model="gemini-2.5-flash", # точный id берите из GET /v1/models messages=[{"role": "user", "content": "Ответь ровно одной строкой: GEMINI-OK-2026"}], max_tokens=20, ) print(resp.choices[0].message.content) print(resp.choices[0].finish_reason) print(resp.model) print(resp.usage)

Основатель Provod Александр Нестеров советует при проверке шлюза сверять содержание и форму ответа, а код 200 считать только пропуском к этой проверке. Мне этот подход нравится своей скучностью: вы заранее знаете, какую строку должны получить, и сравниваете две строки.

Смотрите на четыре вещи подряд. Текст в choices[0].message.content должен совпасть с GEMINI-OK-2026. Поле finish_reason со значением stop говорит, что модель закончила сама, а length означает, что ответ упёрся в max_tokens. Поле model показывает, какая модель отвечала. В usage видны токены, а описание учёта добавляет туда фактическое списание в рублях. Когда всё сошлось, маршрут живой, и можно переходить к настоящей задаче.

Проверка API Gemini из России: тестовая строка, модель и расход
Проверка API Gemini из России: тестовая строка, модель и расход

Для AI Studio и облачной платформы логика проверки та же, меняются только адрес, способ авторизации и формат тела запроса, так что тестовую строку можно оставить одной на все маршруты и сравнивать результаты честно.

Коротко о маршрутах к Gemini API

России нет в официальном списке стран Gemini Developer API и Google AI Studio на 12.11.2026, поэтому ключ через AI Studio для российского аккаунта официально не предусмотрен.

Регион в облачной платформе Google означает место обработки запроса, и выбор глобального эндпоинта не решает вопрос доступности аккаунта, оплаты или модели.

Vertex AI с апреля 2026 года развивается под именем Gemini Enterprise Agent Platform, адреса вида aiplatform.googleapis.com в документации остались.

Ключ Gemini API от Google и ключ рабочего пространства шлюза отличаются по владельцу, адресу, способу оплаты и месту, где видна доступность модели.

Чтобы получить API Gemini через шлюз, достаточно ключа пространства, рублёвого баланса и точного id модели из GET /v1/models.

Первый вызов считается успешным, когда совпали тестовая строка, finish_reason, модель и в usage видны токены и расход.

Когда ваш маршрут из России упирается в аккаунт или оплату, проще всего проверить его руками: выбрать модель Gemini в каталоге, выпустить ключ на странице API Provod, пополнить баланс на небольшую сумму и отправить ту самую тестовую строку.

Подробнее:

А вы через какой маршрут подключали Gemini и на каком из трёх регионов споткнулись? Расскажите в комментариях.

11