Gemini API в OpenAI-совместимом формате
Gemini API можно вызывать через OpenAI SDK: укажите в base_url адрес https://api.relayswitch.io/v1, используйте API-ключ RelaySwitch и впишите ID модели Gemini в model. Цены на модели Gemini (сейчас их 21) читаются прямо из каталога, и аккаунт Google вам не нужен.
01Чем это отличается от Gemini API напрямую у Google
Работать с Gemini API напрямую значит иметь аккаунт Google, создать ключ в Google AI Studio и платить по правилам биллинга Google. Здесь эта часть заменена: вы пополняете баланс в RelaySwitch, используете ключ RelaySwitch, а запрос уходит на шлюз, который передает его в Gemini. Для вашего кода меняются только адрес и ключ; ID моделей остаются ID Gemini.
У Gemini свой формат запросов (generateContent), но большинство существующих инструментов и кода написаны под OpenAI Chat Completions. Сама Google предоставляет OpenAI-совместимый слой и отмечает в документации, что эта поддержка пока в статусе beta. Здесь тот же подход: каждый ID Gemini из таблицы цен можно вызывать в формате OpenAI, так что для переноса кода с OpenAI на Gemini достаточно поменять поле model.
02Первый запрос через curl
Сначала убедитесь через curl, что ключ и адрес верны. Ключ передается в заголовке Authorization: Bearer, а от обычного примера для OpenAI отличаются только Base URL, ключ и model.
curl https://api.relayswitch.io/v1/chat/completions \ -H "Authorization: Bearer sk-relay-..." \ -H "content-type: application/json" \ -d '{"model": "gemini-3.1-pro-preview", "messages": [{"role": "user", "content": "Reply with ok"}]}'03OpenAI SDK для Python
Base URL пишется с /v1, а SDK сам добавляет /chat/completions. Для стриминга укажите stream со значением true; ответ придет в виде server-sent events в том же формате, что у OpenAI. Число токенов в usage совпадает с тем, что записано в квитанции.
from openai import OpenAI client = OpenAI(base_url="https://api.relayswitch.io/v1", api_key="sk-relay-...")reply = client.chat.completions.create( model="gemini-3.1-pro-preview", messages=[{"role": "user", "content": "Reply with ok"}],)print(reply.choices[0].message.content)04Переход с OpenAI-совместимого эндпоинта Google
Код, написанный по документации Google для OpenAI-совместимого режима, уже использует OpenAI SDK, так что тело запроса менять не нужно. Специфичные для Gemini поля, которые в документации Google передаются через extra_body, на этой странице по одному не проверялись; если вы их используете, сначала проверьте на одном запросе и посмотрите, соответствует ли списание в квитанции ожиданиям.
Меняются только три вещи:
base_url: с адреса из документации Google на https://api.relayswitch.io/v1.api_key: с ключа Google AI Studio на ключ RelaySwitch, который начинается сsk-relay-.model: сверьте ID с таблицей цен на этой странице и используйте тот, что указан сейчас; на неверный ID приходит 404model_not_found.
05Нативный формат Gemini: generateContent
Программы, уже написанные под формат запросов Google, переписывать не нужно, если используемый ID Gemini обслуживает этот маршрут. Путь: /v1beta/models/{model}:generateContent, сразу после https://api.relayswitch.io, без /v1. Ключ передается в заголовке x-goog-api-key, а не в URL: ключ в query-параметре шлюз отклоняет. Тело запроса и ответа использует структуру Google: на входе contents, на выходе candidates.
Сообщения об ошибках следуют своему формату. В формате OpenAI код находится в error.code; в нативном формате ошибка выглядит как у Google, например 401 с error.status, равным UNAUTHENTICATED, когда ключ не передан. Оба формата работают с одним ключом, балансом и ценой. Таблица кодов ошибок по статусам есть на странице OpenAI API и полностью действует, когда Gemini вызывается в формате OpenAI.
06Актуальные цены на модели Gemini
В USD за миллион токенов, читаются из каталога в момент рендера страницы. Оплата идет по трем ценам: вход, кешированный вход и выход, и цена в таблице и есть цена, которая списывается с баланса.
Gemini часто используют для чтения длинных материалов: договора целиком, репозитория с кодом или стенограммы совещания. Стоимость такого запроса почти полностью приходится на вход, поэтому при выборе модели сначала смотрите на цену входа и длину контекста, а уже потом на цену выхода. Если по одному и тому же материалу задается много вопросов, повторяющаяся часть со второго запроса попадает в кеш и оплачивается по цене кешированного входа; квитанция учитывает эти токены отдельно.
| Модель | Разработчик | Вход | Выход | Контекст |
|---|---|---|---|---|
| Gemini 4 Argongemini-4-argon | $0.60 | $3.00 | 1,048,576 | |
| Gemini 3.8 Flashgemini-3.8-flash | $0.4925 | $2.25 | 1,048,576 | |
| Gemini 3.7 Flashgemini-3.7-flash | $0.4925 | $2.25 | 1,048,576 | |
| Gemini 3.5 Flash Litegemini-3.5-flash-lite | $0.225 | $1.875 | 1,048,576 | |
| Gemini 3.6 Flashgemini-3.6-flash | $0.4925 | $2.25 | 1,048,576 | |
| Gemini 3.5 Flashgemini-3.5-flash | $1.50 | $9.00 | 1,048,576 | |
| Gemini 3.1 Flash Lite Previewgemini-3.1-flash-lite-preview | $0.1875 | $1.125 | 1,048,576 | |
| Gemini 3.1 Pro Previewgemini-3.1-pro-preview | $1.20 | $7.20 | 1,048,576 | |
| Gemini 3.1 PRO Preview LOWgemini-3.1-pro-preview-low | $5.00 | $22.50 | 1,048,576 | |
| Gemini 3 Flash Previewgemini-3-flash-preview | $0.375 | $2.25 | 1,048,576 | |
| Gemini 2.5 Flashgemini-2.5-flash | $0.30 | $2.50 | 1,048,576 | |
| Gemini 2.5 Progemini-2.5-pro | $0.9375 | $7.50 | 1,048,576 | |
| Gemini 2.5 Flash Litegemini-2.5-flash-lite | $0.075 | $0.30 | ||
| Gemini 3 Pro Previewgemini-3-pro-preview | $5.00 | $22.50 | ||
| Gemini 3.1 Flash Litegemini-3.1-flash-lite | $0.15 | $0.90 | ||
| Gemini 3.1 PRO Preview Customtoolsgemini-3.1-pro-preview-customtools | $4.80 | $28.80 | 1,048,576 | |
| Gemini 4 Carbongemini-4-carbon | $2.3529 | $11.7647 | ||
| Gemini 4 Hydrogengemini-4-hydrogen | $0.5882 | $2.9412 | ||
| Gemini Flash Latestgemini-flash-latest | $1.80 | $9.00 | 1,048,576 | |
| Gemini Flash Lite Latestgemini-flash-lite-latest | $0.72 | $6.00 | 1,048,576 | |
| Gemini PRO Latestgemini-pro-latest | $4.80 | $28.80 | 1,048,576 |
USD за миллион токенов
07Выбор модели и подготовка к production
Модели со словом preview в названии являются предварительными версиями, которые Google позже заменит моделью с постоянным названием, поэтому ID в коде должен совпадать с тем, что указан в таблице в данный момент. Выбирать модель наугад не нужно: все ID Gemini доступны на одном ключе, так что отправьте каждой модели один и тот же промпт и сравните ответы и стоимость в квитанциях. Сравнение с GPT или Claude тоже сводится к замене model.
Для production создайте отдельный ключ, задайте ему бюджет в долларах и дневной лимит расходов и ограничьте его белым списком моделей до выбранных ID Gemini. Программам, которые читают длинные документы, такие лимиты нужнее всего: один ошибочный запрос, отправивший целый каталог файлов, может содержать сотни тысяч входных токенов. Для неудачных запросов читайте заголовок retry-after перед повтором. Как создать ключ и задать ему лимиты, описано на странице Claude API ключ.
Частые вопросы
- Как использовать Gemini API здесь?
- Поменяйте в коде две вещи: base_url на https://api.relayswitch.io/v1 и api_key на ключ RelaySwitch, который начинается с sk-relay-. Затем впишите ID модели Gemini в model и вызывайте через Chat Completions с помощью OpenAI SDK. Аккаунт открывается по email, баланс пополняется картой или криптовалютой от $10.
- Нужен ли аккаунт Google или API-ключ из Google AI Studio?
- Нет. Для Gemini API от Google нужен аккаунт Google, чтобы создать ключ в AI Studio. Здесь аккаунт открывается в RelaySwitch по одному email, ключ создается в консоли RelaySwitch, и тот же ключ вызывает другие модели каталога.
- OpenAI SDK или нативный формат Gemini?
- Для новых программ используйте OpenAI SDK: достаточно заменить base_url, а переход на модель другого разработчика меняет только поле model. Программы, уже написанные под generateContent, могут отправлять запросы на маршрут /v1beta/models/{model}:generateContent с ключом в заголовке x-goog-api-key. Оба формата работают с одним ключом, балансом и ценой.
- Gemini API бесплатный?
- У Gemini API от Google есть free tier с лимитами частоты для части моделей; какие модели в него входят, указано на странице цен Google. Здесь free tier нет: каждый запрос списывается за токены с предоплаченного баланса, минимальное пополнение $10, баланс не сгорает.
- Как цены на Gemini API здесь соотносятся с официальными ценами Google?
- Цена каждой модели читается из каталога в момент рендера страницы, и цена в таблице и есть цена, которая списывается с баланса. Официальная цена, опубликованная Google, показана рядом на странице каждой модели, так что их можно сравнить напрямую.
- Как убедиться, что отвечает именно Gemini?
- Каждая модель раз в сутки получает один и тот же тестовый промпт, и ответ сравнивается с предыдущими результатами; результаты открыты по адресу https://api.relayswitch.io/v1/proof без API-ключа. У каждого запроса также есть подписанная квитанция (GET https://api.relayswitch.io/v1/requests/:id/receipt), где записаны ID модели, оплаченные токены и стоимость.
Замените base_url, затем model
Base URL https://api.relayswitch.io/v1, модели Gemini оплачиваются за токены по ценам каталога, а ежедневная проверка открыта для всех.