Gemini CLI з власною кінцевою точкою та безкоштовними моделями
Gemini CLI це агент з відкритим кодом від Google для роботи в терміналі. Він може надсилати запити на власний базовий URL. Цей посібник спрямовує Gemini CLI на FreeLLMAPI, який обслуговує нативний API Gemini на /v1beta. Ваші запити потім ідуть до вашого пулу безкоштовних постачальників, який може містити безкоштовні ключі API Gemini.
Код, назви моделей і мітки живого каталогу показано англійською.
Зміна безкоштовного тарифу Gemini CLI у 2026 році
Спершу прочитайте це. Google змінив безкоштовне використання Gemini CLI у 2026 році. На сторінці квот Gemini CLI сказано: "Unpaid tier and Google One users: Gemini CLI was replaced by Antigravity CLI on June 18th, 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)