Головна / Посібники / 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 сказано: "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>
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.

Схожі посібники

Джерела

Усі посібники · Переглянути всі безкоштовні моделі