Главная / Руководства / Gemini CLI с собственной конечной точкой и бесплатными моделями

Gemini CLI с собственной конечной точкой и бесплатными моделями

Gemini CLI это агент для программирования с открытым исходным кодом от Google, который работает в терминале. Он может отправлять свои запросы на собственный базовый URL. Это руководство направляет Gemini CLI на FreeLLMAPI, который обслуживает нативный API Gemini по адресу /v1beta. Ваши запросы затем уходят в ваш пул бесплатных провайдеров, который может включать бесплатные ключи API Gemini.

Код, названия моделей и метки живого каталога показаны на английском языке.

Изменение бесплатного тарифа Gemini CLI в 2026 году

Сначала прочитайте это. Google изменил бесплатное использование Gemini CLI в 2026 году. На странице квот Gemini CLI сказано: «Пользователи бесплатного тарифа и Google One: Gemini CLI был заменен на Antigravity CLI 18 июня 2026 года.»

В объявлении Google сказано, что Gemini CLI остается доступным через платные ключи API Gemini и для корпоративных клиентов.

  • Вход через Google на бесплатном тарифе: для личных аккаунтов Gemini CLI больше не работает.
  • Ключ API Gemini с собственным базовым URL: справочник по настройке Gemini CLI по-прежнему описывает GOOGLE_GEMINI_BASE_URL. С этой переменной Gemini CLI отправляет свои запросы на URL, который вы задали, а не в Google.
  • Бесплатные ключи API Gemini: Google AI Studio по-прежнему предлагает бесплатный тариф для API Gemini. FreeLLMAPI может использовать эти ключи вместе с ключами других провайдеров.

Это руководство использует второй способ. FreeLLMAPI отвечает на запросы и отправляет каждый из них на бесплатную модель из вашего пула.

Шаг 1: Установите FreeLLMAPI и Gemini CLI

Установка обоих

curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @google/gemini-cli

Откройте http://localhost:3001. Добавьте как минимум два ключа бесплатных провайдеров на странице Keys. Хороший первый ключ это бесплатный ключ Google AI Studio. Скопируйте свой единый ключ на этой же странице.

Шаг 2: Направьте Gemini CLI на шлюз

Задайте две переменные окружения и запустите Gemini CLI. Базовый URL это адрес сервера без /v1beta. Gemini CLI добавляет путь API сам.

macOS или Linux

export GOOGLE_GEMINI_BASE_URL=http://localhost:3001
export GEMINI_API_KEY=<unified-key>
gemini

Windows PowerShell

$env:GOOGLE_GEMINI_BASE_URL="http://localhost:3001"
$env:GEMINI_API_KEY="<unified-key>"
gemini

Когда Gemini CLI запросит способ аутентификации, выберите Use Gemini API key. Чтобы сохранить выбор, задайте его в ~/.gemini/settings.json:

~/.gemini/settings.json

{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
Важно: используйте GEMINI_API_KEY. В одной из задач Gemini CLI сообщается, что версия 0.44.x выдает ошибку «Invalid auth method selected», если GOOGLE_API_KEY используется вместе с GOOGLE_GEMINI_BASE_URL. Если задана GOOGLE_API_KEY, удалите ее командой unset GOOGLE_API_KEY.

Шаг 3: Сопоставьте имена моделей Gemini с бесплатными моделями

Gemini CLI запрашивает имена моделей Gemini, например gemini-2.5-flash. FreeLLMAPI не отправляет эти имена в Google напрямую. Он разрешает их через карту семейств Gemini на вкладке Keys, Agents. Сопоставьте каждое семейство (Pro, Flash и Flash-Lite) с Auto или с закрепленной моделью из каталога.

  • С Auto маршрутизатор выбирает бесплатную модель для каждого запроса. Когда один провайдер возвращает ошибку 429, он пробует следующего.
  • ID моделей из каталога тоже работают как имена моделей. Запустите Gemini CLI командой gemini -m <catalog-id> или задайте GEMINI_MODEL.
  • Gemini CLI это агент с инструментами. Сопоставляйте семейства с моделями, которые поддерживают вызов инструментов и имеют большое окно контекста.

Первая таблица показывает бесплатные модели Gemini из каталога на сегодня. Вторая таблица показывает другие бесплатные модели, которые можно сопоставить с семейством Gemini.

Бесплатные модели API Gemini с вызовом инструментов (Google AI Studio)
МодельБесплатно вКонтекстБесплатные лимиты (лучшее предложение)ИнструментыЗрение
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaДаДа
Gemini Flash (latest alias)Google AI Studio-10 запр./мин
20 запр./день
250,000 токенов/мин
~3M
ДаДа
Gemini 3.7 FlashGoogle AI Studio1M10 запр./мин
20 запр./день
250,000 токенов/мин
~3M
ДаДа
Gemini 3.6 FlashGoogle AI Studio1M10 запр./мин
20 запр./день
250,000 токенов/мин
~3M
ДаДа
Gemini 3.5 FlashGoogle AI Studio1M10 запр./мин
20 запр./день
250,000 токенов/мин
~3M
ДаДа
Gemini 3.8 LiveGoogle AI Studio-10 запр./мин
20 запр./день
250,000 токенов/мин
~3M
ДаДа
Gemini 3.8 Live Extended ThinkingGoogle AI Studio-10 запр./мин
20 запр./день
250,000 токенов/мин
~3M
ДаДа
Gemini 3.5 Flash LiteGoogle AI Studio1M15 запр./мин
20 запр./день
250,000 токенов/мин
~3M
ДаДа

Показано 8 из 14 подходящих бесплатных моделей. Смотреть все модели.

Актуальные данные из каталога FreeLLMAPI (версия 2026.11.19, проверено 2026-11-19). Бесплатные лимиты часто меняются. Каталог проверяется каждый день.

Другие бесплатные модели для Gemini CLI: вызов инструментов и контекст 128K и больше
МодельБесплатно вКонтекстБесплатные лимиты (лучшее предложение)ИнструментыЗрение
GLM 5.3UnoRouter1M1 запр./мин
1 req/min per model
ДаНет
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 запр./мин
40 RPM
ДаДа
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceДаНет
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditДаДа
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditДаДа
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 запр./мин
50 запр./день
50 req/day account-wide (1,000 after a $10 purchase)
ДаДа
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 запр./мин
50 запр./день
Shared rate limit
ДаНет
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 запр./мин
250 запр./день
70,000 токенов/мин
~6M
ДаДа

Показано 8 из 104 подходящих бесплатных моделей. Смотреть все модели.

Актуальные данные из каталога FreeLLMAPI (версия 2026.11.19, проверено 2026-11-19). Бесплатные лимиты часто меняются. Каталог проверяется каждый день.

Лимиты бесплатного тарифа Gemini

На странице лимитов запросов Google сказано, что лимиты действуют для проекта, а не для ключа API. Больше ключей в одном проекте не дают больше квоты. Google также сообщает, что лимиты не гарантированы, и что текущие лимиты можно увидеть в Google AI Studio. У моделей в режиме предварительного просмотра лимиты ниже.

Бесплатный ключ Gemini Flash разрешает мало запросов в день. Одна задача Gemini CLI может отправить много запросов. Добавьте ключи других провайдеров, чтобы маршрутизатор мог продолжать работу, когда квота Gemini закончится. Нативный интерфейс поддерживает generateContent, streamGenerateContent с ?alt=sse, countTokens и список моделей.

FreeLLMAPI принимает ключ в заголовке x-goog-api-key, как токен Bearer или в параметре запроса Gemini ?key=. Предпочитайте заголовок, потому что ключ в URL может попасть в историю оболочки и журналы прокси.

Устранение неполадок

ПроблемаПричинаРешение
Gemini CLI открывает вход в GoogleТип аутентификации не задан как Gemini API keyВыберите Use Gemini API key или задайте security.auth.selectedType
«Invalid auth method selected»GOOGLE_API_KEY используется с собственным базовым URLИспользуйте GEMINI_API_KEY и удалите GOOGLE_API_KEY
Запросы уходят в Google, а не на шлюзGOOGLE_GEMINI_BASE_URL не задана в этой оболочкеЭкспортируйте переменную, затем запустите gemini снова
404 при вызовах моделейБазовый URL содержит /v1betaИспользуйте только адрес http://localhost:3001
Вызовы инструментов не работаютСемейство Gemini сопоставлено с моделью со слабым вызовом инструментовСопоставьте семейство с моделью из таблиц выше
«All models rate-limited after N attempts»Все ключи достигли лимитаДобавьте ключи от большего числа провайдеров или дождитесь окончания пауз
Используйте каждую из этих моделей через один ключ. FreeLLMAPI это маршрутизатор с открытым исходным кодом, который работает на вашем сервере. Он объединяет все эти бесплатные тарифы за одной конечной точкой, совместимой с OpenAI, и переключается на другой провайдер, когда достигнут лимит запросов. Открыть каталог или перейти.

Часто задаваемые вопросы

Gemini CLI все еще бесплатен?

Google прекратил бесплатное использование Gemini CLI со входом через Google для пользователей бесплатного тарифа и Google One 18 июня 2026 года. CLI по-прежнему поддерживает собственный базовый URL, поэтому он может работать на бесплатном шлюзе, например FreeLLMAPI.

Как использовать Gemini CLI с собственной конечной точкой?

Задайте GOOGLE_GEMINI_BASE_URL равным адресу конечной точки, а GEMINI_API_KEY равным ее ключу, затем выберите Use Gemini API key. Конечная точка должна поддерживать нативный API Gemini по адресу /v1beta.

Может ли Gemini CLI использовать модели, которые не относятся к Gemini?

Да, через FreeLLMAPI. Шлюз сопоставляет имена семейств Gemini Pro, Flash и Flash-Lite с Auto или с любой моделью из каталога, например с моделью Qwen или GLM.

Каковы лимиты бесплатного тарифа API Gemini?

Google задает лимиты для проекта, а не для ключа, и показывает текущие значения в Google AI Studio. Таблица на этой странице показывает сегодняшние бесплатные модели Gemini и их лимиты из каталога FreeLLMAPI.

Почему я получаю «Invalid auth method selected»?

В одной из задач Gemini CLI сообщается об этой ошибке в версии 0.44.x, если GOOGLE_API_KEY используется вместе с GOOGLE_GEMINI_BASE_URL. Используйте GEMINI_API_KEY и выполните unset GOOGLE_API_KEY.

Похожие руководства

Источники

Все руководства · Смотреть все бесплатные модели