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>
geminiWindows 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.
| Модель | Бесплатно в | Контекст | Бесплатные лимиты (лучшее предложение) | Инструменты | Зрение |
|---|---|---|---|---|---|
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Да | Да |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 запр./мин 20 запр./день 250,000 токенов/мин ~3M | Да | Да |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 запр./мин 20 запр./день 250,000 токенов/мин ~3M | Да | Да |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 запр./мин 20 запр./день 250,000 токенов/мин ~3M | Да | Да |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 запр./мин 20 запр./день 250,000 токенов/мин ~3M | Да | Да |
| Gemini 3.8 Live | Google AI Studio | - | 10 запр./мин 20 запр./день 250,000 токенов/мин ~3M | Да | Да |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 запр./мин 20 запр./день 250,000 токенов/мин ~3M | Да | Да |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 запр./мин 20 запр./день 250,000 токенов/мин ~3M | Да | Да |
Показано 8 из 14 подходящих бесплатных моделей. Смотреть все модели.
Актуальные данные из каталога FreeLLMAPI (версия 2026.11.19, проверено 2026-11-19). Бесплатные лимиты часто меняются. Каталог проверяется каждый день.
| Модель | Бесплатно в | Контекст | Бесплатные лимиты (лучшее предложение) | Инструменты | Зрение |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 запр./мин 1 req/min per model | Да | Нет |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 запр./мин 40 RPM | Да | Да |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Да | Нет |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Да | Да |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Да | Да |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 запр./мин 50 запр./день 50 req/day account-wide (1,000 after a $10 purchase) | Да | Да |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 запр./мин 50 запр./день Shared rate limit | Да | Нет |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 запр./мин 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» | Все ключи достигли лимита | Добавьте ключи от большего числа провайдеров или дождитесь окончания пауз |
Часто задаваемые вопросы
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.
Похожие руководства
- free gemini api
- Превышена квота Gemini API (429 RESOURCE_EXHAUSTED)
- Как бесплатно пользоваться Claude Code
- Codex CLI с бесплатными моделями
- Лучшие бесплатные API моделей для кода
Источники
- Gemini CLI docs: configuration reference (проверено 20 November 2026)
- Gemini CLI docs: authentication (проверено 20 November 2026)
- Gemini CLI docs: quota and pricing (проверено 20 November 2026)
- Google Developers Blog: transitioning Gemini CLI to Antigravity CLI (проверено 20 November 2026)
- Gemini CLI issue 27550: auth with a custom base URL (проверено 20 November 2026)
- Google AI Studio: rate limits (проверено 20 November 2026)
- FreeLLMAPI docs: native Gemini API (проверено 20 November 2026)