Gemini CLI yenye kituo maalum na modeli za bure
Gemini CLI ni wakala wa usimbaji wa chanzo huria wa Google kwa terminal. Inaweza kutuma maombi yake kwenye base URL maalum. Mwongozo huu unaelekeza Gemini CLI kwenye FreeLLMAPI, ambayo inahudumia API asilia ya Gemini kwenye /v1beta. Maombi yako kisha yanaenda kwenye kundi lako la watoa huduma wa bure, ambalo linaweza kujumuisha funguo za bure za Gemini API.
Msimbo, majina ya modeli na lebo za katalogi ya moja kwa moja zinaonyeshwa kwa Kiingereza.
Mabadiliko ya 2026 kwenye ngazi ya bure ya Gemini CLI
Soma hili kwanza. Google ilibadilisha matumizi ya bure ya Gemini CLI mwaka wa 2026. Ukurasa wa mgao wa Gemini CLI unasema: "Watumiaji wa ngazi isiyolipiwa na watumiaji wa Google One: Gemini CLI ilibadilishwa na Antigravity CLI tarehe 18 Juni 2026."
Tangazo la Google linasema kwamba Gemini CLI inaendelea kupatikana kupitia funguo za Gemini API zinazolipiwa na kwa wateja wa biashara.
- Kuingia kwa Google kwenye ngazi ya bure: Gemini CLI haihudumii tena akaunti za watumiaji binafsi.
- Ufunguo wa Gemini API wenye base URL maalum: marejeo ya usanidi wa Gemini CLI bado yanaeleza
GOOGLE_GEMINI_BASE_URL. Kwa kigezo hiki, Gemini CLI inatuma maombi yake kwenye URL unayoweka, si kwa Google. - Funguo za bure za Gemini API: Google AI Studio bado inaorodhesha ngazi ya bure ya Gemini API. FreeLLMAPI inaweza kutumia funguo hizo, pamoja na funguo kutoka kwa watoa huduma wengine.
Mwongozo huu unatumia njia ya pili. FreeLLMAPI inajibu maombi na kutuma kila moja kwenye modeli ya bure kwenye kundi lako.
Hatua ya 1: Sakinisha FreeLLMAPI na Gemini CLI
Sakinisha zote mbili
curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @google/gemini-cliFungua http://localhost:3001. Ongeza angalau funguo mbili za bure za watoa huduma kwenye ukurasa wa Keys. Ufunguo wa bure wa Google AI Studio ni ufunguo mzuri wa kwanza. Nakili ufunguo wako wa pamoja kutoka ukurasa uleule.
Hatua ya 2: Elekeza Gemini CLI kwenye lango
Weka vigezo viwili vya mazingira kisha uanzishe Gemini CLI. Base URL ni anwani ya seva pekee, bila /v1beta. Gemini CLI yenyewe inaongeza njia ya API.
macOS au 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>"
geminiGemini CLI ikiomba njia ya uthibitishaji, chagua Use Gemini API key. Ili kuhifadhi chaguo hilo, liweke kwenye ~/.gemini/settings.json:
~/.gemini/settings.json
{
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
}
}GEMINI_API_KEY. Ripoti moja ya Gemini CLI inasema kwamba toleo 0.44.x linashindwa na "Invalid auth method selected" wakati GOOGLE_API_KEY inatumika pamoja na GOOGLE_GEMINI_BASE_URL. Ikiwa GOOGLE_API_KEY imewekwa, iondoe kwa unset GOOGLE_API_KEY.Hatua ya 3: Panga majina ya modeli za Gemini kwa modeli za bure
Gemini CLI inaomba majina ya modeli za Gemini, kwa mfano gemini-2.5-flash. FreeLLMAPI haituma majina haya moja kwa moja kwa Google. Inayatatua kupitia ramani ya familia za Gemini kwenye kichupo cha Keys, Agents. Pangia kila familia (Pro, Flash na Flash-Lite) Auto au modeli iliyobandikwa kutoka katalogi.
- Kwa Auto, kipanga njia kinachagua modeli ya bure kwa kila ombi. Mtoa huduma mmoja anapotuma hitilafu 429, kinajaribu anayefuata.
- Model ID za katalogi pia zinafanya kazi kama majina ya modeli. Anzisha Gemini CLI kwa
gemini -m <catalog-id>, au wekaGEMINI_MODEL. - Gemini CLI ni wakala mwenye zana. Pangia familia modeli zenye wito wa zana na dirisha kubwa la muktadha.
Jedwali la kwanza linaonyesha modeli za bure za Gemini kwenye katalogi leo. Jedwali la pili linaonyesha modeli nyingine za bure unazoweza kupangia familia ya Gemini.
| Modeli | Bure kwenye | Muktadha | Vikomo vya bure (ofa bora) | Zana | Uoni |
|---|---|---|---|---|---|
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Ndiyo | Ndiyo |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 maombi/dakika 20 maombi/siku 250,000 tokeni/dakika ~3M | Ndiyo | Ndiyo |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 maombi/dakika 20 maombi/siku 250,000 tokeni/dakika ~3M | Ndiyo | Ndiyo |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 maombi/dakika 20 maombi/siku 250,000 tokeni/dakika ~3M | Ndiyo | Ndiyo |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 maombi/dakika 20 maombi/siku 250,000 tokeni/dakika ~3M | Ndiyo | Ndiyo |
| Gemini 3.8 Live | Google AI Studio | - | 10 maombi/dakika 20 maombi/siku 250,000 tokeni/dakika ~3M | Ndiyo | Ndiyo |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 maombi/dakika 20 maombi/siku 250,000 tokeni/dakika ~3M | Ndiyo | Ndiyo |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 maombi/dakika 20 maombi/siku 250,000 tokeni/dakika ~3M | Ndiyo | Ndiyo |
Inaonyesha 8 kati ya 14 modeli za bure zinazolingana. Tazama modeli zote.
Data ya moja kwa moja kutoka katalogi ya FreeLLMAPI (toleo 2026.11.19, imekaguliwa 2026-11-19). Vikomo vya bure hubadilika mara kwa mara. Katalogi hukaguliwa kila siku.
| Modeli | Bure kwenye | Muktadha | Vikomo vya bure (ofa bora) | Zana | Uoni |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 maombi/dakika 1 req/min per model | Ndiyo | Hapana |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 maombi/dakika 40 RPM | Ndiyo | Ndiyo |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Ndiyo | Hapana |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Ndiyo | Ndiyo |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Ndiyo | Ndiyo |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 maombi/dakika 50 maombi/siku 50 req/day account-wide (1,000 after a $10 purchase) | Ndiyo | Ndiyo |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 maombi/dakika 50 maombi/siku Shared rate limit | Ndiyo | Hapana |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 maombi/dakika 250 maombi/siku 70,000 tokeni/dakika ~6M | Ndiyo | Ndiyo |
Inaonyesha 8 kati ya 104 modeli za bure zinazolingana. Tazama modeli zote.
Data ya moja kwa moja kutoka katalogi ya FreeLLMAPI (toleo 2026.11.19, imekaguliwa 2026-11-19). Vikomo vya bure hubadilika mara kwa mara. Katalogi hukaguliwa kila siku.
Vikomo vya ngazi ya bure ya Gemini
Ukurasa wa vikomo vya kiwango wa Google unasema kwamba vikomo vinatumika kwa kila mradi, si kwa kila ufunguo wa API. Funguo nyingi kwenye mradi mmoja hazitoi mgao zaidi. Google pia inasema kwamba vikomo havihakikishwi, na kwamba unaweza kuona vikomo vyako vya sasa kwenye Google AI Studio. Modeli za onyesho zina vikomo vya chini.
Ufunguo wa bure wa Gemini Flash unaruhusu maombi machache kwa siku. Kazi moja ya Gemini CLI inaweza kutuma maombi mengi. Ongeza funguo kutoka watoa huduma wengine, ili kipanga njia kiendelee wakati mgao wa Gemini unapoishia. Kiolesura asilia kinaunga mkono generateContent, streamGenerateContent yenye ?alt=sse, countTokens na orodha ya modeli.
FreeLLMAPI inakubali ufunguo kwenye kichwa cha x-goog-api-key, kama tokeni ya Bearer, au kwenye kigezo cha swali cha Gemini cha ?key=. Pendelea kichwa, kwa sababu ufunguo kwenye URL unaweza kuvuja kwenye historia ya shell na kumbukumbu za proksi.
Utatuzi wa matatizo
| Tatizo | Chanzo | Suluhisho |
|---|---|---|
| Gemini CLI inafungua kuingia kwa Google | Aina ya uthibitishaji haijawekwa kuwa Gemini API key | Chagua Use Gemini API key, au weka security.auth.selectedType |
| Hitilafu: "Invalid auth method selected" | GOOGLE_API_KEY inatumika pamoja na base URL maalum | Tumia GEMINI_API_KEY na uondoe GOOGLE_API_KEY |
| Maombi yanaenda kwa Google, si kwenye lango | GOOGLE_GEMINI_BASE_URL haijawekwa kwenye shell hii | Weka kigezo kwa export, kisha uanzishe gemini tena |
404 kwenye wito wa modeli | Base URL inajumuisha /v1beta | Tumia anwani http://localhost:3001 pekee |
| Wito wa zana unashindwa | Familia ya Gemini inaelekezwa kwenye modeli yenye wito dhaifu wa zana | Pangia familia modeli kutoka kwenye majedwali hapo juu |
| Hitilafu: "All models rate-limited after N attempts" | Funguo zote zimefikia kikomo chake | Ongeza funguo kutoka watoa huduma zaidi, au subiri muda wa kupumzika |
Maswali yanayoulizwa mara kwa mara
Je, Gemini CLI bado ni ya bure?
Google ilimaliza matumizi ya bure ya Gemini CLI kwa kuingia kwa Google kwa watumiaji wasiolipa na watumiaji wa Google One mnamo tarehe 18 Juni 2026. CLI bado inaunga mkono base URL maalum, kwa hivyo inaweza kuendeshwa kwenye lango la bure kama FreeLLMAPI.
Ninatumiaje Gemini CLI na kituo maalum?
Weka GOOGLE_GEMINI_BASE_URL kuwa anwani ya kituo na GEMINI_API_KEY kuwa ufunguo wake, kisha chagua Use Gemini API key. Kituo lazima kizungumze API asilia ya Gemini kwenye /v1beta.
Je, Gemini CLI inaweza kutumia modeli ambazo si za Gemini?
Ndiyo, kupitia FreeLLMAPI. Lango linaweka majina ya familia ya Gemini Pro, Flash na Flash-Lite kuwa Auto au modeli yoyote ya katalogi, kwa mfano modeli ya Qwen au GLM.
Vikomo vya ngazi ya bure ya Gemini API ni vipi?
Google inaweka vikomo kwa kila mradi, si kwa kila ufunguo, na inaonyesha thamani za sasa kwenye Google AI Studio. Jedwali la ukurasa huu linaonyesha modeli za bure za Gemini za leo na vikomo vyake kutoka katalogi ya FreeLLMAPI.
Kwa nini ninapata 'Invalid auth method selected'?
Ripoti moja ya Gemini CLI inaeleza hitilafu hii kwenye toleo 0.44.x wakati GOOGLE_API_KEY inatumika pamoja na GOOGLE_GEMINI_BASE_URL. Tumia GEMINI_API_KEY na uondoe GOOGLE_API_KEY.
Miongozo inayohusiana
- free gemini api
- Kikomo cha Gemini API kimezidi (429 RESOURCE_EXHAUSTED)
- Jinsi ya kutumia Claude Code bila malipo
- Tumia Codex CLI na modeli bure
- API bora za bure za modeli za msimbo
Vyanzo
- Gemini CLI docs: configuration reference (imekaguliwa 20 November 2026)
- Gemini CLI docs: authentication (imekaguliwa 20 November 2026)
- Gemini CLI docs: quota and pricing (imekaguliwa 20 November 2026)
- Google Developers Blog: transitioning Gemini CLI to Antigravity CLI (imekaguliwa 20 November 2026)
- Gemini CLI issue 27550: auth with a custom base URL (imekaguliwa 20 November 2026)
- Google AI Studio: rate limits (imekaguliwa 20 November 2026)
- FreeLLMAPI docs: native Gemini API (imekaguliwa 20 November 2026)