Gemini API с актуальными ценами в родном формате Google

1. Создайте ключ

   Зарегистрируйтесь, пополните баланс от $5 и создайте ключ на странице API-ключи. Ключам, которые работают без присмотра, задайте лимит расходов.

2. Направьте Gen AI SDK на Lovely Router

   Передайте https://lovelyrouter.com как базовый URL SDK. Ключ передаётся в x-goog-api-key, который отправляют SDK; ?key= и Authorization: Bearer тоже работают.

3. Вызовите generateContent

   generateContent, streamGenerateContent и countTokens работают так, как описано в документации Google.

   cURLPythonNode.js

   Shell

   curl "https://lovelyrouter.com/v1beta/models/gemini-3.1-pro:generateContent" \
     -H "x-goog-api-key: $LOVELY_API_KEY" \
     -H "content-type: application/json" \
     -d '{
       "contents": [{"role": "user", "parts": [{"text": "Explain DNS in two sentences."}]}]
     }'

Цены указаны в долларах США за миллион токенов из актуального каталога. Id соответствуют GET /v1/models, например gemini-3.1-pro и gemini-3-flash, а написания Google вроде gemini-3.1-pro-preview или models/gemini-3-flash указывают на ту же модель. GET /v1beta/models перечисляет все модели, доступные в этом формате, в собственном формате ответа Gemini. Модели Gemini обслуживаются в группе каналов gemini-value; маркетплейс моделей показывает текущую доступность, а статус — почасовую доступность по группам каналов.

Эти эндпоинты Gemini не поддерживаются: cachedContents (явное кеширование контекста), загрузка файлов, embedContent и batchEmbedContents, пакетный режим и Live API.

Модели Gemini также принимают OpenAI Chat Completions и Anthropic Messages — это удобно, если ваше приложение умеет только один из этих форматов. thinkingConfig и другие параметры, специфичные для Gemini, гарантированно работают только в родном формате.

Gemini CLI берёт эндпоинт и ключ из окружения:

export GOOGLE_GEMINI_BASE_URL=https://lovelyrouter.com
export GEMINI_API_KEY=$LOVELY_API_KEY
gemini -m gemini-3.1-pro

О других клиентах — в разделе «Интеграции», а в ИИ-агентах для программирования показан Gemini CLI рядом с Claude Code и Codex CLI на одном ключе.

Gemini сам кеширует повторяющиеся префиксы промптов, ничего отмечать не нужно. Кешированные токены видны в usageMetadata.cachedContentTokenCount и оплачиваются по цене чтения кеша, без платы за запись кеша.

Кеш помогает, только если следующая реплика попадает на канал, где он лежит. Lovely Router снимает отпечаток каждого разговора по системному промпту и первому сообщению пользователя и отправляет последующие реплики на тот же канал. Если ваше приложение переписывает или сжимает старую историю, отправляйте вместо этого стабильный заголовок x-session-id для каждого разговора. Метка времени в системной инструкции ломает и отпечаток, и собственный кеш Gemini, поэтому помещайте её в последнее сообщение пользователя. Подробности — в разделе «Кеширование промптов».

Сбои, которые иначе пришлось бы обрабатывать вам, шлюз сначала повторяет сам. Запрос, который сбоит на одном канале, повторяется на другом канале той же группы, до трёх попыток, а поток придерживается до первого токена, поэтому сбой до этого момента повторяется, а не доходит до вас. Остальное возвращается в формате ошибок Gemini: RESOURCE_EXHAUSTED для 429 и UNAVAILABLE для 502. Повторяйте такие запросы с увеличивающейся задержкой и учитывайте retry-after, если он есть. Некорректные запросы (400, 404, 413, 422) не повторяются, потому что в другом месте они завершатся так же.

Предпочитайте alt=sse. Без него streamGenerateContent возвращает один JSON-массив; с ним поток, который зависает на три минуты, завершается понятным событием ошибки DEADLINE_EXCEEDED, которое легко отследить. Полная таблица — в разделе «Лимиты запросов и переключение».

Gemini оплачивается за токены. Входные без кеша — это promptTokenCount минус cachedContentTokenCount; кешированные токены оплачиваются по цене чтения кеша; выходные — это candidatesTokenCount плюс thoughtsTokenCount по цене выходных токенов. Сейчас все группы каналов тарифицируются по прайс-цене, поэтому каждая модель Gemini стоит столько, сколько указано в прайс-листе Google. Сумма списывается с предоплаченного баланса в течение нескольких секунд после ответа.

Подписки и ежемесячной платы нет. Запросы, отклонённые до того, как дошли до модели, ничего не стоят, повторные попытки не оплачиваются, а отменённый поток оплачивается только за то, что успел выдать. На странице цен собраны все продукты.