К содержимому
Блог

Gemini API в России: ключ Relay и первый запрос

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. Ключ в примере вымышленный. Для локальной проверки замените его своим секретом; рабочий сервис должен получать секрет из защищённого серверного окружения.

python
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-модель?

Скопируйте её идентификатор из каталога и проверьте протокол. Похожее имя не гарантирует тот же формат запроса.

Создать аккаунт

Модели из статьи

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.