Google AI Studio в России: когда поможет API Relay
Google AI Studio в России и вызов модели Gemini через Relay решают разные задачи. Если нужен сам сайт Studio, ключ Relay не откроет его и не изменит правила доступа Google. Если нужно получать ответы модели из своего приложения, можно выбрать Gemini в каталоге Relay и отправлять запросы в формате Chat Completions.
Ниже показан перенос текстового задания в API. Он не воспроизводит интерфейс Studio, историю аккаунта или все параметры исходного запроса. Начните с текста, а дополнительные возможности переносите после проверки совместимости.
Коротко
Определите, нужен вам сайт Google или программный ответ модели.
Для API Relay используйте ключ Relay и поддерживаемый протокол.
Код с
generateContentпридётся изменить, а не перенаправить на другой хост.
Что делать, если нужен Google AI Studio в России
Сначала назовите действие, которое хотите выполнить: открыть сохранённый проект, вручную сравнить ответы или встроить генерацию в приложение. Для первых двух задач может требоваться именно продукт Google. Актуальные условия доступа и руководство по работе с ним проверяйте у Google.
API Relay подходит третьей задаче: сервер отправляет сообщение и получает ответ выбранной модели. Приложение само показывает результат пользователю, хранит историю и решает, когда отправлять следующий запрос. Наличие API-доступа не создаёт рабочее пространство Studio.
Запросы «Google AI Studio: как пользоваться в России» и «Google AI Studio: как запустить в России» нельзя честно закрыть обещанием, что один ключ заменяет сайт. Здесь рассматривается конкретная альтернатива для разработчика, которому нужен программный вызов Gemini.
Как перенести текстовое задание из Studio
Скопируйте свою инструкцию и пользовательский вопрос. Сохраните порядок сообщений, если от него зависит смысл. Не переносите секреты, персональные данные и файлы, которые не нужны задаче. Модель в новом запросе увидит только отправленный контекст, а не содержимое вашего аккаунта.
Найдите в каталоге gemini-3.7-flash и проверьте протокол openai_chat. Имя модели в Studio и идентификатор Relay могут различаться. Для другой модели скопируйте её запись целиком и сверьте поддерживаемые возможности.
Отдельно выпишите настройки исходного запроса: поток, инструменты, изображения, ограничения ответа. Не переносите поля Google SDK механически. Для каждого параметра найдите соответствие в Chat Completions, а если соответствия нет, сначала проверьте упрощённый текстовый вариант.
Как выполнить запрос без интерфейса Studio
Создайте ключ в кабинете Relay. В команде ниже он демонстрационный, поэтому без замены на рабочий секрет авторизация не пройдёт. Не сохраняйте настоящий ключ в общем скрипте или истории команд на чужом компьютере.
curl -sS -i https://relay-llm.ru/v1/chat/completions \
-H "Authorization: Bearer $RELAY_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"model":"gemini-3.7-flash","messages":[{"role":"user","content":"Объясни JSON на примере списка задач."}]}'Флаг -i показывает заголовки вместе с телом ответа. Проверьте HTTP-статус и сохраните x-request-id для диагностики. При успехе текст находится в choices[0].message.content. Если будете разбирать ответ программой, уберите -i или сохраняйте заголовки отдельно, чтобы не смешивать их с JSON.
Путь generateContent у Relay отсутствует. Если ваш код собирает такой URL, перепишите вызов под Chat Completions или возьмите библиотеку с поддерживаемым протоколом. Ключ Google и ключ Relay не взаимозаменяемы.
Как проверить, что перенос сохранил смысл
Сравните ответы на одном и том же входе. Проверьте, не потерялись ли инструкция о формате, ограничения задачи и нужный фрагмент истории. Если модель стала отвечать иначе, сначала сравните отправленные сообщения, затем параметры и идентификатор модели.
Для извлечения фактов подготовьте проверяемый пример: текст с известной датой и вопрос о ней. Для редактирования дайте короткий абзац и явный запрет менять числа. Такой тест покажет ошибку переноса быстрее, чем субъективное сравнение длинных свободных ответов.
Сохраните исходное задание, результат и решение о пригодности. Не обещайте пользователям приложения полное совпадение с ответом в Studio: даже при похожих названиях моделей настройки и способ формирования контекста могут различаться.
Как разобраться с оплатой и отказами
Условия пополнения проверяйте на странице цен и в кабинете. Платёж в Relay не пополняет баланс Google и не оплачивает стороннюю подписку. Для пилота задайте отдельному ключу предел расходов и проверьте фактическое списание в истории запросов.
401 требует проверки ключа, 404 проверки пути и модели. При 402 прочитайте причину: доступный баланс и лимит ключа проверяются отдельно. При 400 уберите перенесённые поля и повторите минимальное сообщение из примера, затем возвращайте параметры по одному.
Как использовать Google AI Studio в России с ключом Relay?
Ключ Relay не подключает сайт Studio. Он подходит приложению, которое вызывает API Relay в поддерживаемом формате.
Можно ли перенести сохранённые диалоги автоматически?
Этот пример ничего не импортирует из аккаунта Google. Нужные сообщения приложение передаёт явно в массиве messages.
Сработает ли пример с generateContent?
Нет. Relay не принимает этот маршрут. Используйте Chat Completions и соответствующую структуру запроса.
Платёж Relay оплачивает использование Google AI Studio?
Нет. Баланс Relay относится к запросам через Relay; условия Google проверяются отдельно.