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 выполните отдельную настройку:
Зарегистрируйтесь в Relay и подтвердите почту.
Создайте ключ в разделе «API-ключи», сохраните секрет при показе.
Откройте каталог моделей Google и выберите модель для своей задачи.
Укажите в приложении OpenAI Chat Completions, базовый адрес Relay и свой ключ.
Отправьте один короткий запрос, затем проверьте запись в истории запросов.
Если приложению нужен выбор провайдера, ищите настройку OpenAI-compatible или Custom provider. Поля и порядок настройки сверяйте с руководством клиента вашей версии. Список интеграций поможет выбрать подходящий клиент без подмены ключей разных сервисов.
Как вызвать Gemini через OpenAI SDK
Пример рассчитан на Python с установленным пакетом openai. Он использует модель gemini-3.8-flash, которая есть в каталоге Relay и поддерживает Chat Completions. Для настройки другой модели замените только её идентификатор, затем повторите проверку.
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_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 может обращаться к разрешённым ему моделям. Отдельный ключ полезен для приложения или окружения, когда нужен отдельный лимит и отзыв доступа.