Gemini API key из России в 2026: 3 шага без VPN и карты

Ключ разработчика и обычный доступ к Gemini - разные вещи

Под запросом «gemini api key» прячутся две разные задачи, и половина мучений начинается с того, что человек решает не свою. Если нужно открыть окно чата и писать нейросети руками - ключ не нужен вообще, там хватает обычного входа. Ключ нужен, когда с Gemini должен говорить не ты, а твоя программа: бот, сайт, таблица или окно Claude Code, то есть код, который работает без человека за клавиатурой

Сами клики по панели ключей Google я разбирал отдельно, кнопка за кнопкой: Google AI Studio: получить ключ для Gemini за 3 шага. Здесь эти клики не повторяю. Здесь разбираю то, что тот разбор оставляет одной строкой: из России ровно эти же клики упираются в невидимую стену, и её можно честно обойти без VPN

Если ключ у тебя уже ЕСТЬ и он просто перестал отвечать - это третья задача и третья статья. Gemini не работает: 6 причин и что делать в России разбирает диагностику по каждому экрану ошибки отдельно, включая разницу между обычным сайтом и ключом разработчика

Тебе точно нужен ключ, а не просто чат?

Пять частых задач и честный ответ, что из них решает чат руками, а что - только ключ и код

Задача из левой колонки - дальше можно не читать. Задача из правой - вот три надписи, к которым ты придёшь через несколько минут, я выписал их с живой страницы раздела ключей 21.09.2026: заголовок блока «Ключи API», поле «Базовый URL» со значением https://openai.bothub.chat/v1 и кнопка «Добавить ключ». Вся статья про то, чем заполнить эти три места

Что значит «региона нет в списке»: официальный факт и дата проверки

У ключей Gemini и у Google AI Studio есть свой перечень стран, и он короче перечня для обычного сайта. Я выгрузил его 21.09.2026 прямо со страницы Google «Доступные регионы» и прошёл целиком, а не глазами по диагонали: 230 стран и территорий. России и Беларуси там нет

Важная деталь, которую легко упустить: это НЕ значит, что страницы Google из России не открываются. И панель ключей, и сама страница со списком стран у меня открылись с первого раза, без VPN и без единой ошибки. Стена стоит не на входе на сайт, а дальше: на действии «выдать ключ» и на действии «принять запрос по этому ключу»

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

Что реально происходит, когда жмёшь «Создать ключ» из России

Экран у этой стены один и тот же везде, менялась только формулировка: и в панели ключей, и в ответе на запрос твоей программы Google показывает фразу «место, откуда пришёл запрос, не поддерживается для этого сервиса», в оригинале «User location is not supported for the API use». Это не мой перевод для новичка, а дословная строка с экрана, которую разработчики видят годами: десятки одинаковых сообщений лежат на официальном форуме Google для разработчиков, свежие обсуждения - за 2026 год

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

## Что отвечает каждый сервис на неверный ключ, мой прогон

Шлюз BotHub, запрос без ключа:
{"status":"error","error":{"code":"UNAUTHORIZED","message":""}}

Google, ключ в запросе неверный:
    "message": "API key not valid. Please pass a valid API key.",
    "status": "INVALID_ARGUMENT",

Google, ключа в запросе нет вовсе:
    "status": "PERMISSION_DENIED"

проб в прогоне: десять, все с одной машины, без VPN

Читается это так. UNAUTHORIZED у шлюза - строку он не узнал. «API key not valid» у Google - ключ дошёл, но он неверный. PERMISSION_DENIED - ключа в запросе нет вовсе. Ни один из трёх ответов не говорит про регион: стена по региону включается позже, уже на настоящем ключе, и отличить её от опечатки в строке можно только по тексту

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

Рабочий способ получить ключ Gemini без VPN

Сервисы, которые решают вопрос региона у себя, а тебе отдают одну строку доступа, называются шлюзами или агрегаторами нейросетей. Три таких сервиса я сравнивал отдельно по оплате и бесплатному лимиту: Агрегатор нейросетей: 3 сервиса и как платить одной картой. Здесь беру ОДИН конкретный - BotHub, потому что из трёх разобранных только он прямо на своей странице пишет про рубли и карту МИР

Честно про разницу: строка, которую выдаёт BotHub, НЕ тот же самый ключ, что выдаёт панель Google. Это ключ шлюза. Твой код обращается не напрямую к Google, а к адресу BotHub, а тот уже договаривается с Google на своей стороне и присылает готовый ответ модели Gemini. Для кода разницы почти нет, строка подставляется туда же, где обычно просят Gemini API key. По сути же это два ключа от двух разных сервисов, и путать их не стоит

Как получить рабочий ключ: 3 шага

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

Шаг 1. Зарегистрируйся на BotHub и получи бесплатный старт

По документации площадки первый шаг - завести аккаунт по почте на bothub.chat, банковская карта для этого не требуется. Сразу после регистрации появляется бесплатный тариф Free со стартовым балансом. Это даёт аккаунт, из которого дальше выпускается сама строка доступа. Проверить, что шаг сделан, просто: в кабинете видно ненулевое число Caps, у гостя без входа на том же экране стоит «Осталось Caps: 0 CAPS»

Шаг 2. Выпусти API-ключ в разделе для разработчиков

Перейди в раздел для разработчиков на bothub.chat, нажми кнопку создания ключа и сразу сохрани полученную строку в надёжном месте. Официальная инструкция называет это так, дословно: «Перейдите в раздел BotHub для разработчиков», «Нажмите кнопку Создать ключ». В ответ появляется длинная строка, и второй раз целиком её уже не покажут. Это даёт саму строку, которую дальше можно вставлять туда же, где раньше просили Gemini API key

Сам раздел спрятан в профиле, на главной его нет: прямой адрес bothub.chat/profile/for-developers, страницу я открыл 21.09.2026 и выписал подписи дословно. В кабинете это левое меню профиля, шесть пунктов сверху вниз: «Настройки», «Планы и модели», «Для разработчиков», «Для организаций», «Все инструменты», «Тех. поддержка» - нужен третий. Попал ты куда надо или нет, видно по трём надписям на самой странице: «Ключи API», рядом поле «Базовый URL» со значением https://openai.bothub.chat/v1, ниже таблица «Транзакции» со столбцами «Дата», «Поставщик», «Сумма», «Тип», «Статус», «Ключ». Деталь, на которой легко застрять: в документации кнопка названа «Создать ключ», а на живой странице раздела она подписана «Добавить ключ» - это одна и та же кнопка

Куда положить строку сразу, вместо общего совета не показывать её посторонним. Заведи рядом с файлом своей программы отдельный файл bothub-key.txt и вложи строку туда целиком, одной строчкой, без кавычек и пробелов по краям. В программе вместо самого ключа тогда стоит чтение этого файла: open('bothub-key.txt').read().strip(). Проверить, что строка оттуда читается, можно не выходя из своей же программы: допиши первой строкой print(len(open('bothub-key.txt').read().strip())) и запусти как обычно. У моего тестового ключа длиной 40 знаков на экране появилось 40 - файл найден и прочитан, сам ключ при этом на экран не попал

Шаг 3. Подставь ключ и адрес шлюза в свой код

Подставь полученную строку и адрес шлюза openai.bothub.chat/v1 вместо ключа Gemini в свою программу, модель gemini-3.7-flash. Дальше два пути, и оба проходятся не сходя с этой страницы: руками в коде или словами через помощника

Путь руками. Меняются РОВНО две строки, и лежат они рядом - там, где программа создаёт подключение. Вот код из примера самой документации BotHub (вариант «Языковые модели», вкладка Python, снята 21.09.2026), а две строки в нём - моя правка, не документации: ключ я читаю из файла, и модель стоит наша, gemini-3.7-flash, вместо примерной claude-opus-5:

from openai import OpenAI
client = OpenAI(
    api_key=open('bothub-key.txt').read().strip(),
    base_url='https://openai.bothub.chat/v1')
completion = client.chat.completions.create(
    model='gemini-3.7-flash',
    messages=[{'role': 'user', 'content': 'Привет! Расскажи о себе в трех словах.'}])
print(completion.choices[0].message.content)

Первая строка из двух - api_key: в документации там стоит заглушка 'ВАШ_API_КЛЮЧ_BOTHUB', здесь я читаю её из файла bothub-key.txt - это моё решение, не документации. Вторая - base_url: адрес шлюза https://openai.bothub.chat/v1 вместо адреса Google, эта строка и в документации, и здесь совпадает дословно. Если адрес Google прописан у тебя в нескольких местах, заменить нужно каждое: на оставшийся старый адрес прилетит «API key not valid»

В ответ приходит сама реплика модели текстом, её печатает последняя строка примера. В примере документации ответ выглядит так - фраза «ИИ-помощник от Anthropic.», а рядом служебный блок usage с числами "total_tokens": 48 и "cost": 0.00372, то есть сколько слов ушло и сколько это стоило. Про Anthropic там потому, что в примере площадки стоит другая модель; с gemini-3.7-flash в том же поле придёт ответ Gemini. Провал выглядит совсем иначе: программа падает трейсбеком на полтора десятка строк, и последняя из них - openai.AuthenticationError: Error code: 401 - {'status': 'error', 'error': {'code': 'UNAUTHORIZED', 'message': ''}}, ровно её я получил своим прогоном этой же программы на заведомо неверном ключе, слово UNAUTHORIZED внутри неё и есть признак отказа

Путь словами. Те же две строки можно не печатать самому: попроси Claude Code (не поставил - вот отдельный гайд установки) подставить полученный ключ и адрес https://openai.bothub.chat/v1 вместо ключа Gemini, модель - gemini-3.7-flash. Помощник сам находит в коде место, где ждут ключ Gemini, меняет адрес и строку и показывает, что именно поменял. Результат тот же, разница только в том, правишь ты файл сам или диктуешь словами

Если задача шире одного теста - например, каждый день забирать данные и прогонять их через Gemini по расписанию - такую сборку тоже проще собирать словами, а не руками: для регулярных сценариев без единой ручной команды есть визуальный конструктор автоматизаций n8n

Какие модели Gemini на самом деле лежат у шлюза

Обещание «у нас есть Gemini» проверяется не отзывом на главной, а машинным перечнем моделей. У BotHub он открыт: один адрес отдаёт полный каталог того, что шлюз реально умеет запускать. Я забрал его 21.09.2026 и посчитал

## Каталог моделей шлюза, машинный ответ

всего моделей в ответе: 1481
из них с «gemini» в имени: 52
самая свежая линейка в том же ответе: gemini-3.8-flash

Полторы тысячи моделей в каталоге, из них 52 с «gemini» в имени, замер 21.09.2026. Та модель, которую я называю в примерах, gemini-3.7-flash, в ответе есть, и рядом лежит более свежая линейка gemini-3.8-flash. Это и есть ответ на вопрос «а точно ли там настоящий Gemini, а не что-то похожее по названию»: перечень машинный, его отдаёт сам сервис, и он открыт без ключа

Разбор самой модели, её сильных мест и ограничений - отдельно: Gemini 3.7 Flash: что умеет новая модель. Для первого подключения хватит знания, что имя модели пишется строкой и его легко перепутать: на опечатку в имени шлюз отвечает ровно тем же, что и на неверный ключ, и на вид они неразличимы

Бесплатный лимит и когда он заканчивается

Бесплатный тариф BotHub называется Free, карта для него не нужна вообще: на 21.09.2026 он даёт 30 000 Caps. Caps - внутренняя валюта площадки, ими списывается любая генерация любой модели, а не рубли напрямую за каждую отдельно

Сколько это в работе, площадка пишет сама на той же карточке: «Хватит, чтобы перевести 10-15 коротких статей, создать 1-2 статьи по 1 500-2 000 слов и получить базовую аналитику без сложных настроек». Для пробного подключения Gemini к одному боту или одной своей программе - с запасом. Отдельная строка с того же экрана: «Срок действия пакетов (кроме тарифа Enterprise) не ограничен, токены не сгорают», то есть купленный объём не превращается в тыкву через месяц, как обычная подписка

Если нужен именно прямой ключ Google, а не шлюз - у него тоже есть бесплатный уровень без карты, но пользоваться им из России, как разобрано выше, честно можно только теоретически. Полный разбор бесплатных лимитов НАТИВНОГО ключа - в гайде Google AI Studio: получить ключ для Gemini за 3 шага. А если Gemini не единственное, что тебе нужно, рядом лежит подборка бесплатных нейросетей без карты

Платный ярус: сколько стоит, если бесплатного не хватит

Если бесплатных 30 000 Caps не хватило, у BotHub четыре ступени с фиксированной ценой. Пятая карточка, Enterprise, цены на экране не имеет, вместо неё стоит «Давайте обсудим!». Все числа ниже я снял с живой страницы 21.09.2026 при включённом тумблере «Оплата в рублях»

Условия оплаты на том же экране написаны одной строкой: «МИР / российский банк - рубли. Иностранная карта - USD». То есть российская карта здесь не обходной манёвр, а штатный способ, и VPN для оплаты не нужен

Для сравнения прямая цена самого Google. На платном уровне Gemini 3.7 Flash стоит 0,75 доллара за миллион токенов на входе и 3,75 доллара на выходе, и рядом отдельной строкой стоит срок этой цены: до 31 декабря 2026 года. Заплатить её напрямую из России без иностранной карты не получится, и это ровно та стена, из-за которой статья написана

Если платить нужно за модель посерьёзнее лёгкой Flash - для прикидки бюджета у меня собрана отдельная таблица цен по десятку сервисов: двенадцать ценников нейросетей в рублях. Если же вопрос не в модели, а в самой оплате - как провести платёж из России, разобрано в гайде как оплатить нейросети, если карта не проходит

Как проверить, что ключ работает

Проверка ключа - это тот же кусок кода из шага 3, запущенный как есть, либо тот же разговор с помощником словами

Руками: запусти программу из шага 3 без изменений, вопрос в ней уже вписан. Словами: попроси помощника взять твой ключ BotHub и отправить им один короткий вопрос модели gemini-3.7-flash, а результат показать прямо в разговоре. Признак успеха в обоих случаях один - на экране короткая реплика самой модели, а не служебная строка. Это даёт уверенность, что дело дошло до твоего проекта, а не осталось на середине настройки

Если вместо ответа пришла ошибка, сверь её текст с моим прогоном выше: там программа падает трейсбеком, а последняя строка называет причину прямо в коде ошибки. UNAUTHORIZED внутри openai.AuthenticationError: Error code: 401 - шлюз не принял строку: либо ключ скопирован не целиком, либо в имени модели опечатка. «API key not valid» - запрос ушёл напрямую в Google, а не в шлюз, то есть в коде остался старый адрес. PERMISSION_DENIED - ключа в запросе нет вовсе, помощник не сохранил его туда, откуда программа его читает

Разница между этими тремя ответами важнее, чем кажется. Она сразу говорит, куда именно улетел твой запрос, и снимает половину вечера, который обычно уходит на угадывание вслепую

Как хранить ключ, чтобы он не утёк

Площадка говорит об этом одной строкой в своей же инструкции: «Сохраните токен в надежном месте. Не публикуйте его в открытом доступе». Дальше полезнее не общие правила, а три конкретных места, куда идти

Первое - тот же раздел «BotHub для разработчиков», где ключ выпускался. По описанию из документации он отвечает сразу за две вещи: «Управление API-ключами и просмотр статистики использования». То есть отозвать засветившуюся строку и выпустить новую ты идёшь туда же, откуда брал первую, и уходит на это столько же секунд. Старая строка после отзыва не годится ни на что

Второе - расход по каждому запросу, а не общая сумма в конце месяца. Шлюз кладёт списание прямо в ответ служебным полем caps: в примере самой документации это выглядит как «"caps": 45000» рядом с ответом модели. Отсюда и признак чужого доступа: запросов ты не делал, а Caps убывают, или в статистике виден всплеск в те часы, когда твой код спал

Третье - отличать утечку от своей же ошибки в пути к файлу. Программа, которая ищет строку не там, где та лежит, печатает не отказ по ключу, а имя файла: FileNotFoundError: [Errno 2] No such file or directory: 'bothub-key.txt' - это мой прогон, папка без файла. Отказ по ключу выглядит иначе - трейсбеком openai.AuthenticationError со словом UNAUTHORIZED внутри, и только оно значит, что до шлюза дошла негодная строка

Частые ошибки и что каждая означает

Форма, в которой приходит код из левого столбца, зависит от пути. На программе из шага 3 UNAUTHORIZED не приходит отдельной строкой - он лежит внутри трейсбека, в самом хвосте строки openai.AuthenticationError: Error code: 401 - {'status': 'error', 'error': {'code': 'UNAUTHORIZED', ...}}. На прямом запросе curl-ом, минуя саму программу, тот же код приходит короткой строкой ответа сервера вроде {"error":{"message":"UNAUTHORIZED"}}

Отдельная деталь про фразу «место не поддерживается для этого сервиса»: если она появилась не при прямом обращении к Google, а уже ПОСЛЕ подключения через шлюз - почти наверняка в коде осталась старая ссылка на адрес Google. Стоит попросить помощника ещё раз проверить, везде ли подставлен новый адрес

Чего мой прогон не показал и где я мог промахнуться

Честная граница у этой статьи есть, и я её назову сам. Десять проб 21.09.2026 дали ровно три вида отказа и один успешный ответ машинного каталога. Отдельного ответа «слишком много запросов» прогон не дал ни разу, и специально ловить его я не стал: для этого нужно долбить чужой сервис всерьёз, а это уже не проверка, а нагрузка

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

И главное ограничение: аккаунта на BotHub я не заводил и кнопку выпуска ключа не нажимал. Страницу раздела я открыл 21.09.2026 и подписи с неё выписал дословно (меню профиля, блок «Ключи API», поле «Базовый URL», кнопка «Добавить ключ»), но что показывает эта страница человеку с деньгами на балансе и выпущенным ключом, я не видел. Три шага выше взяты с официальной страницы документации дословно и помечены как цитата, а не как мой клик. Руками я проверил другое: доступность страниц, перечень регионов Google, каталог моделей шлюза, сами отказы и чтение строки ключа из файла. Разделять эти вещи важнее, чем выглядеть человеком, который прошёл весь путь

Что ещё почитать про Gemini и доступ из России

• MCP: готовые помощники для Claude Code - когда задач для кода набирается много и нужен не один ключ
• Собрать своего Telegram-бота - если ключ нужен именно под бота, который отвечает другим людям
• Нейросеть на русском: из 14 сервисов ответили 2 - подборка русскоязычных альтернатив, если Gemini не обязателен
• Нейросети и инструменты: все разборы - полный список гайдов по инструментам на сайте

Источники

Все страницы открыты живым браузером 21.09.2026 с российского адреса, без VPN. Коды отказа сняты прямым запросом с той же машины в тот же день, десять проб

• Google: доступные регионы для Gemini и Google AI Studio - официальный перечень, 230 стран и территорий, России и Беларуси в нём нет, дата обновления страницы 2026-04-29
• Google Gemini: страница цен - цена Gemini 3.7 Flash на платном уровне и срок её действия до 31 декабря 2026 года
• Bothub: документация для разработчиков, быстрый старт - три шага от создания ключа до первого запроса и адрес шлюза openai.bothub.chat/v1
• Bothub: главная страница и тарифы - бесплатный уровень Free, четыре платные ступени в рублях, строка про карту МИР и срок действия пакетов
• Bothub: публичный список моделей - машинный каталог, 1481 модель, 52 с «gemini» в имени, включая gemini-3.7-flash
• Google AI Developers Forum: обсуждения ошибки региона - независимые сообщения разработчиков об ошибке «User location is not supported for the API use»
• Собственный прогон 21.09.2026: десять проб к шлюзу и к Google, три вида отказа и машинный каталог моделей, полные ответы сохранены в рабочих записях статьи

Памятка: рабочий ключ Gemini без VPN

Семь строк, которые закрывают весь путь от вопроса до рабочего кода

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

Читайте также

Gemini из России

Ключ для кода не нужен, нужен вход в чат: 6 шагов до первого ответа и 4 тарифа

Google AI Studio

Прямой ключ Google по кликам: как выглядит панель и где именно упираешься в регион

Агрегатор нейросетей

Сравнение трёх шлюзов по оплате и бесплатному лимиту, а не один BotHub