Под «прокси» для AI Studio понимают три разные вещи. Здесь они разобраны, и сказано, что проверить при сообщении о регионе.
| Пункт | Что это | Как задать | Меняет ли решение Google? |
|---|---|---|---|
| Сетевой прокси для сайта AI Studio | Браузер или система отправляют трафик через прокси | Настройки прокси в системе или браузере | Нет: проверки региона и аккаунта те же |
| Сетевой прокси для вызовов API из кода | SDK или curl подключаются к API через прокси | HTTPS_PROXY и NO_PROXY или аргументы клиента SDK | Нет: тот же API, те же условия |
| Base URL (шлюз) | SDK обращается к вашему адресу, который пересылает запросы в API | base_url в HTTP-параметрах SDK | Нет: шлюз всё равно должен передать заголовок с ключом |
| Серверный прокси для ключей | Ваш сервер хранит ключ для браузерных и мобильных приложений | Не сетевой прокси, а устройство приложения | К местоположению отношения не имеет |
Источник: документация Google AI Studio (API-ключи) и README Google Gen AI Python SDK, прочитано 14 ноября 2026.
На странице Google о доступных регионах перечислены страны и территории, где доступны Gemini API и AI Studio. Посетитель вне списка может увидеть, что регион не поддерживается, а для Colab ограничение определяется регионом, в котором работает экземпляр Colab. В условиях сказано: доступ к сервисам разрешён только в доступном регионе, а пользователю должно быть 18 лет.
Прокси не делает регион доступным: он только меняет сетевой адрес, с которого уходит запрос. Его уместно использовать, если этого требует ваша сеть, либо если вы работаете в стране из списка и хотите стабильный выход, совпадающий со страной аккаунта. Не используйте его, чтобы попасть туда, где Google сервис не предоставляет: это нарушает условия и может поставить под угрозу аккаунт.
# 1) Test the proxy login outside Python (HTTP port)
curl -x "http://LOGIN:PASSWORD@HOST:2222" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
"https://generativelanguage.googleapis.com/v1beta/models"
# 2) Same proxy for the SDK: set it before the program starts
export HTTPS_PROXY="http://LOGIN:PASSWORD@HOST:2222"
export NO_PROXY="localhost,127.0.0.1"
python app.pyТолько пример: подставьте LOGIN, PASSWORD и HOST из «Мои активы» и свой ключ. На машине, где писалась страница, реальных запросов к Google не делалось.
# pip install google-genai
from google import genai
from google.genai import types
# base_url: only if you run your own gateway in front of the API
# client_args / async_client_args: passed to the HTTP client (shape taken from the SDK README)
http_options = types.HttpOptions(
client_args={"proxy": "http://LOGIN:PASSWORD@HOST:2222"},
async_client_args={"proxy": "http://LOGIN:PASSWORD@HOST:2222"},
)
client = genai.Client(http_options=http_options) # key from GEMINI_API_KEY
print(client.models.generate_content(model="MODEL_NAME", contents="Say hi").text)Форма client_args взята из README Google Gen AI SDK (там она показана для SOCKS5); сверьте со своей версией. Подставьте значения и имя модели.
Параметр base_url в SDK направляет запросы на выбранный вами адрес, например шлюз API. Это не сетевой прокси, и он не делает регион доступным. REST-вызовы идут на хост generativelanguage.googleapis.com и несут ключ в заголовке x-goog-api-key, поэтому шлюз обязан пересылать этот заголовок.
Если вам нужно лишь, чтобы трафик выходил с определённого IP, base URL не нужен: хватит HTTPS_PROXY или аргументов клиента.
Проверьте Есть ли ваша страна в официальном списке доступных регионов, и совершеннолетен ли владелец аккаунта?
Решение Сверьтесь со списком; в Colab учитывается регион экземпляра Colab. Если вашей страны в списке нет, сервис вам не предоставляется.
Когда остановиться Не меняйте прокси без конца: решает Google, а не сеть.
Проверьте Проверен ли проект и подключён ли биллинг?
Решение Пройдите проверку проекта или подключите биллинг, как сказано на странице устранения неполадок. Новый ключ в том же проекте не поможет: право определяется по проекту.
Проверьте Не выполнено ли условие, например биллинг?
Решение Проверьте статус биллинга проекта. В документации сказано не повторять ошибки 400, 402 и 403.
Проверьте Верны ли host, port и логин, проходит ли curl через тот же прокси?
Решение Выполните curl-проверку выше, затем см. руководство по авторизации на прокси.
Если вы работаете в стране, где Gemini доступен, и хотите один постоянный адрес, совпадающий со страной аккаунта, подойдёт статический ISP IP: он не меняется в течение аренды, $0,50 за 1 сутки или $7,99 за 30 суток (около $0,27 в сутки). Для HTTPS_PROXY и SDK выбирайте HTTP; у proxy.proxy302.com порт HTTP — 2222, SOCKS5 — 3333.
Бесплатного теста нет; минимальная покупка — один IP на одни сутки. Прокси не меняет правила Google по регионам и право аккаунта на доступ.
Сверьте свою страну с официальным списком доступных регионов и убедитесь, что аккаунт подходит.
Купите статический ISP IP в стране, где вы реально работаете, и скопируйте host, port, username и password из «Мои активы».
Проверьте логин командой curl, затем задайте HTTPS_PROXY (или аргументы клиента) до запуска программы.
Вызовите API один раз и убедитесь, что он отвечает; при 403 читайте сообщение, а не подозревайте сеть.
Ожидаемый результат Нормальный ответ или понятное сообщение 4xx о проекте.
Для сайта задайте прокси в системе или браузере. Для вызовов API задайте HTTPS_PROXY до запуска программы или передайте proxy в аргументах клиента SDK.
Параметр base_url в SDK указывает на выбранный вами адрес, например собственный шлюз. Сам API находится на generativelanguage.googleapis.com.
Нет. Доступность зависит от официального списка регионов, вашего аккаунта и условий; прокси меняет только сетевой адрес.
403 часто связан с проектом: проверка, право на бесплатный уровень или биллинг. Право определяется по проекту Google Cloud, новый ключ ничего не меняет.
Google указывает, что ограничения по региону в Colab определяются регионом экземпляра Colab.
Как настроить прокси для веб-приложения Gemini, Google AI Studio и Gemini API и разобраться с типичными ошибками. Прокси не меняет условий Google.
Работает ли Gemini, зависит от отдельных списков стран для веб-приложения и API, региона аккаунта, страны платёжного профиля, типа и возраста аккаунта и сетевого адреса, с которого идёт запрос. Кто решает по каждому пункту и порядок проверки.
Прокси для Gemini — это ISP для Gemini: выделенный нативный IP, 8 PTC за 30 дней, в стране из обоих списков Google — приложения Gemini и AI Studio.
Посмотреть параметры и ценуОтвет HTTP 407 приходит от прокси-сервера, а не от сайта, который вы пытаетесь открыть.
Фиксированные статические ISP-прокси: IP резидентного уровня, неизменный весь срок. Для аккаунтов в соцсетях, магазинов и AI-сервисов. HTTP и SOCKS5.
Посмотреть параметры и ценуОфициальная документация · Проверено:
Прочитано 14 ноября 2026: Gemini API и Google AI Studio доступны в перечисленных странах и территориях, в списке есть Великобритания и Швейцария; посетитель из страны вне списка может увидеть сообщение, что регион может не поддерживаться; для Colab ограничения определяются регионом экземпляра Colab.
Официальная документация · Проверено:
Прочитано 14 ноября 2026: для использования API нужно быть старше 18 лет; доступ к сервисам разрешён только в доступном регионе; при передаче API-клиентов пользователям в Европейской экономической зоне можно использовать только платные сервисы.
Официальная документация · Проверено:
Прочитано 14 ноября 2026: ключ читается из GEMINI_API_KEY или GOOGLE_API_KEY (при обеих приоритет у GOOGLE_API_KEY); REST-запросы передают ключ в заголовке x-goog-api-key на generativelanguage.googleapis.com; для клиентских приложений страница советует серверный прокси, чтобы ключ оставался на вашем сервере.
Официальная документация · Проверено:
Прочитано 14 ноября 2026: 403 PERMISSION_DENIED может означать, что проекту нужна проверка (FREE_TIER_VERIFICATION_REQUIRED), проект не подходит для бесплатного уровня (право определяется по проекту Google Cloud, а не по ключу или местоположению), есть непогашенный баланс или ключ помечен как утёкший.
Официальная документация · Проверено:
Прочитано 14 ноября 2026: failed_precondition (400) — не выполнено условие, например биллинг; permission_denied (403) — у ключа нет прав или проект ограничен; ошибки 400, 402 и 403 не повторять.
Официальная документация · Проверено:
Прочитано 14 ноября 2026: в HttpOptions параметр base_url направляет запросы на собственный адрес, например шлюз API; client_args и async_client_args передаются HTTP-клиенту, для SOCKS5 показан ключ proxy; SDK читает HTTPS_PROXY из окружения (пример: http://username:password@proxy_uri:port).
Наблюдение за продуктом · Проверено:
Таблица фактов о продуктах сайта (сверено 10 ноября 2026): протоколы и порты, цены в US$ (1 PTC = US$1), сроки аренды, лимиты количества, бесплатного теста нет.
Создайте аккаунт, пополните баланс и выберите ротируемый резидентный, статический ISP или дата-центр IP — настроить его в браузере можно за несколько минут.
