Как получить API Gemini из России в 2026: AI Studio, Vertex AI или шлюз
Получить 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, и обходить её советами про чужие аккаунты я здесь не буду. Команде, которая юридически и фактически работает из страны списка, это самый прямой вариант. Остальным честнее сразу смотреть на два других маршрута.
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 резервирует на балансе оценку стоимости, после ответа списывает подтверждённую сумму и возвращает неиспользованный остаток резерва.
Три карточки для одной задачи
Возьмём простой сценарий команды: нужно получить от 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, для этой статьи запрос не запускался, поэтому вывод модели в нём не показан. Ключ лежит в переменной окружения, в коде его нет.
Основатель Provod Александр Нестеров советует при проверке шлюза сверять содержание и форму ответа, а код 200 считать только пропуском к этой проверке. Мне этот подход нравится своей скучностью: вы заранее знаете, какую строку должны получить, и сравниваете две строки.
Смотрите на четыре вещи подряд. Текст в choices[0].message.content должен совпасть с GEMINI-OK-2026. Поле finish_reason со значением stop говорит, что модель закончила сама, а length означает, что ответ упёрся в max_tokens. Поле model показывает, какая модель отвечала. В usage видны токены, а описание учёта добавляет туда фактическое списание в рублях. Когда всё сошлось, маршрут живой, и можно переходить к настоящей задаче.
Для 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 и на каком из трёх регионов споткнулись? Расскажите в комментариях.