Gemini API в России: ключ Relay и первый запрос
Gemini API в России можно вызвать через Relay в формате OpenAI Chat Completions. Создайте аккаунт Relay, выберите модель Gemini в каталоге, получите ключ и укажите базовый адрес https://relay-llm.ru/v1. Это отдельный API-доступ. Он не создаёт ключ Google, аккаунт Google AI Studio или подписку на сторонний продукт.
Порядок ниже подходит серверному приложению, которое может отправлять Chat Completions. Если ваш код использует Google SDK и generateContent, одной замены адреса недостаточно: Relay не принимает этот протокол.
Коротко
Gemini API key от Google и ключ Relay предназначены для разных API.
Модель
gemini-3.7-flashв каталоге принимаетopenai_chat.Сначала проверьте короткий запрос, затем переносите настройки приложения.
Как получить доступ к Gemini API в России через Relay
Откройте каталог и найдите нужную карточку. Проверьте полный идентификатор и протокол. В примере используется gemini-3.7-flash: не сокращайте его до gemini и не копируйте имя из интерфейса другого сервиса. Наличие семейства Gemini не означает поддержку каждого протокола Google.
Зарегистрируйтесь, подтвердите почту и создайте ключ на странице API-ключей. Секрет показывается один раз. Для приложения заведите отдельный ключ: так проще найти его запросы и отозвать доступ без перенастройки остальных клиентов.
Проверьте баланс и условия пополнения. Способы оплаты, комиссию и итоговую сумму смотрите на странице цен и в кабинете. Эта инструкция не обещает конкретный платёжный метод или фиксированный курс.
Чем Chat Completions отличается от generateContent
В Chat Completions текст диалога передаётся массивом messages, у сообщения есть role и content. Ответ читают из choices[0].message.content. Это формат примера ниже.
Клиент с generateContent использует другой маршрут и структуру запроса. Замена только хоста не превратит такой запрос в Chat Completions. Если библиотека жёстко привязана к протоколу Gemini, выберите совместимый клиент или измените код вызова и разбора ответа.
Не добавляйте в OpenAI SDK корневой адрес без /v1. И не направляйте SDK на полный путь /v1/chat/completions: базовый адрес и путь метода играют разные роли. Пример уже показывает нужное сочетание.
Как отправить первый запрос из Python
В среде должен быть доступен пакет openai. Ключ в примере вымышленный. Для локальной проверки замените его своим секретом; рабочий сервис должен получать секрет из защищённого серверного окружения.
from openai import OpenAI
client = OpenAI(
api_key="sk-demo-not-a-real-key",
base_url="https://relay-llm.ru/v1",
)
response = client.chat.completions.create(
model="gemini-3.7-flash",
messages=[{
"role": "user",
"content": "Объясни разницу между массивом JSON и объектом JSON.",
}],
)
print(response.choices[0].message.content)
print(response.usage)Сначала оставьте одно сообщение и обычный ответ без потока. Если такой вызов проходит, добавляйте историю диалога, инструменты или изображения по одному, каждый раз сверяясь с возможностями карточки модели и справочником Chat Completions.
Пример не переносит историю из AI Studio. Чтобы продолжить свой диалог, приложение должно само хранить сообщения и передавать нужный контекст в следующем запросе. Чем больше текста вы отправляете повторно, тем больше входных токенов обрабатывает модель.
Как проверить отказ вместо ответа
При 401 проверьте, что используете секрет Relay и отправляете запрос именно на адрес Relay. Ключ Google на этом маршруте не заменяет ключ Relay. Сверьте состояние ключа в кабинете, особенно после перевыпуска.
При 404 прочитайте код и сообщение. model_not_found требует проверки идентификатора; not_found с Unknown path указывает на путь. Например, запрос к generateContent нельзя исправить подбором другого имени Gemini.
При 402 различайте баланс и лимит ключа. Пополнение не снимает отдельный предел расходов ключа. При 429 уменьшите параллельность и следуйте Retry-After, если он пришёл. Сохраните статус, тело ошибки и x-request-id; перечень кодов есть в документации ошибок.
Как контролировать расход приложения
Задайте ключу дневной, месячный или общий лимит под ваш сценарий. Все ключи используют общий баланс аккаунта; отдельный ключ не создаёт отдельный кошелёк. В истории запросов можно проверить модель, ключ, токены и стоимость.
Для начала сравните расход короткого вопроса и запроса с реальным контекстом. Не оценивайте бюджет приложения по одному слову «привет»: рабочие инструкции и история диалога могут занимать большую часть входа. Учитывайте также повторы, которые делает ваш клиент.
Как получить Gemini API key в России через Relay?
В Relay создаётся ключ Relay для его API. Это не ключ Google AI Studio. Для вызова используйте адрес и формат из примера.
Работает ли Google SDK после замены base URL?
Если он отправляет generateContent, нет. Нужен клиент с поддерживаемым форматом, например Chat Completions.
Подключит ли ключ Relay сайт Google AI Studio?
Нет. Доступ к сайту и аккаунту Google решается отдельно.
Как выбрать другую Gemini-модель?
Скопируйте её идентификатор из каталога и проверьте протокол. Похожее имя не гарантирует тот же формат запроса.