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

Gemini API Key: где получить ключ и как подключить Relay

Gemini API Key: где получить ключ и как подключить Relay

Gemini API Key для прямого обращения к Google получают у Google. Для вызова моделей Gemini через Relay нужен ключ Relay и OpenAI-совместимый адрес https://relay-llm.ru/v1. Это разные ключи. Relay не выдаёт Google Gemini API Key и не предоставляет вход в Google AI Studio. Если ваше приложение поддерживает Chat Completions и смену адреса API, его можно подключить по инструкции ниже.

Коротко

  • Сначала определите, какой API использует клиент: нативный Gemini или OpenAI Chat Completions.

  • Для Relay задайте его ключ, адрес с /v1 и идентификатор из каталога.

  • Нативные методы Gemini в Relay не поддерживаются.

Как получить Gemini API Key для нужного клиента

Проверьте настройки приложения до создания ключа. Поле с названием «Gemini API key» само по себе ничего не говорит о совместимости. Если приложение всегда обращается к Google и не позволяет выбрать другой протокол, ключ Relay в таком поле не поможет.

Для прямого Google API используйте инструкцию Google. Для Relay выполните отдельную настройку:

  1. Зарегистрируйтесь в Relay и подтвердите почту.

  2. Создайте ключ в разделе «API-ключи», сохраните секрет при показе.

  3. Откройте каталог моделей Google и выберите модель для своей задачи.

  4. Укажите в приложении OpenAI Chat Completions, базовый адрес Relay и свой ключ.

  5. Отправьте один короткий запрос, затем проверьте запись в истории запросов.

Если приложению нужен выбор провайдера, ищите настройку OpenAI-compatible или Custom provider. Поля и порядок настройки сверяйте с руководством клиента вашей версии. Список интеграций поможет выбрать подходящий клиент без подмены ключей разных сервисов.

Как вызвать Gemini через OpenAI SDK

Пример рассчитан на Python с установленным пакетом openai. Он использует модель gemini-3.8-flash, которая есть в каталоге Relay и поддерживает Chat Completions. Для настройки другой модели замените только её идентификатор, затем повторите проверку.

python
from openai import OpenAI

client = OpenAI(
    api_key="sk-demo-not-a-real-key",
    base_url="https://relay-llm.ru/v1",
    max_retries=0,
)
response = client.chat.completions.create(
    model="gemini-3.8-flash",
    messages=[
        {"role": "user", "content": "Объясни HTTP одним предложением."}
    ],
)
print(response.choices[0].message.content)
print(response.usage)

Здесь стоит нерабочий демонстрационный ключ. В серверном приложении импортируйте os и передайте api_key=os.environ["RELAY_API_KEY"]. Задайте переменную средствами своей платформы, не записывайте секрет в исходный код. Пример не требует ключа Google AI Studio.

Gemini 3.8 Flash0,20 $ за 1 млн входных токенов

Сохраните код в gemini_check.py и запустите python3 gemini_check.py. Успешный ответ подтверждает этот короткий текстовый сценарий. Он не доказывает поддержку всех возможностей нативного Gemini API: изображения, инструменты и другие параметры проверяйте отдельно по документации совместимости.

Почему запрос уходит по неправильному адресу

Смена только ключа не меняет получателя запроса. Если в программе остался адрес Google, новый секрет Relay отправится другому сервису. Перед запуском проверьте базовый адрес в настройках и код, который создаёт клиента.

Для OpenAI SDK нужен https://relay-llm.ru/v1. Путь /chat/completions библиотека добавляет сама. Вызов нативного метода Gemini, например пути с generateContent, не станет совместимым после замены домена: такого маршрута в Relay нет. Перепишите вызов под Chat Completions или используйте другой клиент.

Не переносите весь набор параметров из Google SDK в OpenAI SDK. У библиотек разные методы и названия полей. Сначала получите ответ с одним сообщением, после этого добавляйте потоковую выдачу или инструменты по одному. Так ошибка нового параметра не смешается с ошибкой подключения.

Как разобрать отказ и проверить расход

При 401 проверьте наличие секрета в процессе и состояние ключа. При 404 различайте неизвестную модель и неизвестный путь. Идентификатор из примера Google может отсутствовать в Relay, даже если название семейства совпадает. Скопируйте точное значение из каталога.

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

Стоимость завершённого запроса смотрите в его записи в кабинете, а ставки моделей на странице цен. Там же и в кабинете проверяйте способы и условия пополнения. Сохраняйте x-request-id для поддержки; полный ключ в обращение не прикладывайте.

Где получить Gemini API Key для Google AI Studio?

У Google. Relay создаёт собственный ключ для своего API, которым нельзя войти в Google AI Studio.

Можно ли вызвать Relay через нативный Google SDK?

Эта инструкция использует OpenAI SDK. Нативные методы Gemini шлюз не поддерживает; одной смены адреса в Google SDK недостаточно.

Почему после смены модели запрос перестал работать?

Проверьте идентификатор и параметры. У новой модели могут отличаться поддерживаемые возможности; вернитесь к короткому запросу без дополнительных полей.

Нужен ли отдельный ключ для каждой модели Gemini?

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

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

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

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