कस्टम endpoint और मुफ़्त मॉडलों के साथ Gemini CLI
Gemini CLI Google का open-source coding agent है, जो terminal में चलता है। यह अपने अनुरोध एक कस्टम base URL पर भेज सकता है। यह गाइड Gemini CLI को FreeLLMAPI की ओर इंगित करती है, जो /v1beta पर मूल Gemini API देता है। फिर आपके अनुरोध मुफ़्त providers के आपके pool में जाते हैं, जिनमें मुफ़्त Gemini API keys भी शामिल हो सकती हैं।
कोड, मॉडल नाम और लाइव कैटलॉग लेबल अंग्रेज़ी में दिखाए गए हैं।
Gemini CLI के मुफ़्त टियर में 2026 का बदलाव
पहले यह पढ़ें। Google ने 2026 में Gemini CLI के मुफ़्त उपयोग को बदला है। Gemini CLI का quota पेज कहता है: “Unpaid tier और Google One उपयोगकर्ता: Gemini CLI को 18 जून 2026 को Antigravity CLI से बदल दिया गया।”
Google की घोषणा कहती है कि Gemini CLI भुगतान वाली Gemini API keys और enterprise ग्राहकों के लिए उपलब्ध रहता है।
- मुफ़्त टियर पर Google login: अब उपभोक्ता खातों के लिए Gemini CLI द्वारा समर्थित नहीं है।
- कस्टम base URL वाली Gemini API key: Gemini CLI के configuration संदर्भ में अब भी
GOOGLE_GEMINI_BASE_URLदर्ज है। इस variable के साथ, Gemini CLI अपने अनुरोध Google के बजाय आपके सेट किए URL पर भेजता है। - मुफ़्त Gemini API keys: Google AI Studio अब भी Gemini API के लिए मुफ़्त टियर सूचीबद्ध करता है। FreeLLMAPI इन keys का उपयोग दूसरे providers की keys के साथ कर सकता है।
यह गाइड दूसरी विधि इस्तेमाल करती है। FreeLLMAPI अनुरोधों का उत्तर देता है और हर अनुरोध को आपके pool के एक मुफ़्त मॉडल पर भेजता है।
चरण 1: FreeLLMAPI और Gemini CLI इंस्टॉल करें
दोनों इंस्टॉल करें
curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @google/gemini-clihttp://localhost:3001 खोलें। Keys पेज पर कम से कम दो मुफ़्त provider keys जोड़ें। मुफ़्त Google AI Studio key एक अच्छी पहली key है। उसी पेज से अपनी एकीकृत key कॉपी करें।
चरण 2: Gemini CLI को gateway की ओर इंगित करें
दो environment variables सेट करें और Gemini CLI शुरू करें। base URL सर्वर का origin है, /v1beta के बिना। API path Gemini CLI खुद जोड़ता है।
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 authentication method पूछे, तो Use Gemini API key चुनें। इस चुनाव को सेव करने के लिए, इसे ~/.gemini/settings.json में सेट करें:
~/.gemini/settings.json
{
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
}
}GEMINI_API_KEY इस्तेमाल करें। Gemini CLI की एक issue रिपोर्ट करती है कि जब GOOGLE_API_KEY को GOOGLE_GEMINI_BASE_URL के साथ इस्तेमाल किया जाता है, तो संस्करण 0.44.x "Invalid auth method selected" के साथ विफल होता है। अगर GOOGLE_API_KEY सेट है, तो उसे unset GOOGLE_API_KEY से हटाएँ।चरण 3: Gemini मॉडल नामों को मुफ़्त मॉडलों से मैप करें
Gemini CLI Gemini मॉडल नाम माँगता है, उदाहरण के लिए gemini-2.5-flash। FreeLLMAPI ये नाम सीधे Google को नहीं भेजता। यह उन्हें Keys, Agents टैब पर Gemini family map के ज़रिए हल करता है। हर family (Pro, Flash और Flash-Lite) को Auto पर, या किसी निश्चित catalog मॉडल पर मैप करें।
- Auto के साथ, राउटर हर अनुरोध के लिए एक मुफ़्त मॉडल चुनता है। जब एक provider 429 त्रुटि भेजता है, तो यह अगले को आज़माता है।
- catalog IDs भी मॉडल नामों के रूप में काम करते हैं। Gemini CLI को
gemini -m <catalog-id>के साथ शुरू करें, याGEMINI_MODELसेट करें। - Gemini CLI tools वाला एक agent है। families को ऐसे मॉडलों पर मैप करें जिनमें tool calling हो और बड़ा context window हो।
पहली तालिका आज catalog के मुफ़्त Gemini मॉडल दिखाती है। दूसरी तालिका अन्य मुफ़्त मॉडल दिखाती है, जिन्हें आप किसी Gemini family पर मैप कर सकते हैं।
| मॉडल | मुफ़्त उपलब्ध | कॉन्टेक्स्ट | मुफ़्त सीमाएँ (सबसे अच्छा विकल्प) | टूल | विज़न |
|---|---|---|---|---|---|
| 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 | हाँ | हाँ |
14 मिलते-जुलते मुफ़्त मॉडल में से 8 दिखाए जा रहे हैं। सभी मॉडल देखें.
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 | हाँ | हाँ |
104 मिलते-जुलते मुफ़्त मॉडल में से 8 दिखाए जा रहे हैं। सभी मॉडल देखें.
FreeLLMAPI कैटलॉग से लाइव डेटा (संस्करण 2026.11.19, जाँच 2026-11-19)। मुफ़्त सीमाएँ अक्सर बदलती हैं। कैटलॉग की हर दिन जाँच होती है।
Gemini मुफ़्त टियर की सीमाएँ
Google का rate limit पेज कहता है कि सीमाएँ प्रोजेक्ट के अनुसार लागू होती हैं, API key के अनुसार नहीं। एक प्रोजेक्ट में अधिक keys से अधिक quota नहीं मिलता। Google यह भी कहता है कि सीमाएँ गारंटीकृत नहीं हैं, और आप अपनी मौजूदा सीमाएँ Google AI Studio में देख सकते हैं। Preview मॉडलों की सीमाएँ कम होती हैं।
एक मुफ़्त Gemini Flash key एक दिन में कुछ ही अनुरोध देती है। Gemini CLI का एक कार्य कई अनुरोध भेज सकता है। अन्य providers की keys जोड़ें, ताकि Gemini quota रुकने पर राउटर काम जारी रख सके। मूल surface generateContent, streamGenerateContent (?alt=sse के साथ), countTokens और models सूची को सपोर्ट करता है।
FreeLLMAPI key को x-goog-api-key header में, Bearer token के रूप में, या Gemini के ?key= query parameter में स्वीकार करता है। header को प्राथमिकता दें, क्योंकि URL में key shell history और proxy logs में लीक हो सकती है।
समस्या निवारण
| समस्या | कारण | समाधान |
|---|---|---|
| Gemini CLI Google login खोलता है | auth type Gemini API key पर सेट नहीं है | Use Gemini API key चुनें, या security.auth.selectedType सेट करें |
| "Invalid auth method selected" | कस्टम base URL के साथ GOOGLE_API_KEY इस्तेमाल हो रही है | GEMINI_API_KEY इस्तेमाल करें और GOOGLE_API_KEY को unset करें |
| अनुरोध gateway पर नहीं, Google पर जा रहे हैं | इस shell में GOOGLE_GEMINI_BASE_URL सेट नहीं है | variable export करें, फिर gemini दोबारा शुरू करें |
मॉडल कॉल पर 404 | base URL में /v1beta है | केवल origin http://localhost:3001 इस्तेमाल करें |
| Tool calls विफल होते हैं | Gemini family एक ऐसे मॉडल पर मैप है जिसमें tool calling कमज़ोर है | family को ऊपर की तालिकाओं के किसी मॉडल पर मैप करें |
| "N प्रयासों के बाद सभी मॉडल rate-limited" | सभी keys अपनी सीमा पर हैं | अधिक providers की keys जोड़ें, या cooldowns तक प्रतीक्षा करें |
अक्सर पूछे जाने वाले प्रश्न
क्या Gemini CLI अब भी मुफ़्त है?
Google ने 18 जून 2026 को unpaid और Google One उपयोगकर्ताओं के लिए Google login के साथ मुफ़्त Gemini CLI उपयोग समाप्त कर दिया। CLI अब भी कस्टम base URL सपोर्ट करता है, इसलिए यह FreeLLMAPI जैसे मुफ़्त gateway पर चल सकता है।
कस्टम endpoint के साथ Gemini CLI कैसे इस्तेमाल करूँ?
GOOGLE_GEMINI_BASE_URL को endpoint के origin पर, और GEMINI_API_KEY को उसकी key पर सेट करें, फिर Use Gemini API key चुनें। endpoint को /v1beta पर मूल Gemini API बोलना होगा।
क्या Gemini CLI ऐसे मॉडल इस्तेमाल कर सकता है जो Gemini नहीं हैं?
हाँ, FreeLLMAPI के ज़रिए। gateway Gemini Pro, Flash और Flash-Lite family नामों को Auto पर, या किसी भी catalog मॉडल पर मैप करता है, उदाहरण के लिए Qwen या GLM मॉडल।
Gemini API मुफ़्त टियर की सीमाएँ क्या हैं?
Google सीमाएँ प्रोजेक्ट के अनुसार तय करता है, key के अनुसार नहीं, और मौजूदा मान Google AI Studio में दिखाता है। इस पेज की तालिका FreeLLMAPI catalog से आज के मुफ़्त Gemini मॉडल और उनकी सीमाएँ दिखाती है।
मुझे 'Invalid auth method selected' क्यों मिलता है?
Gemini CLI की एक issue रिपोर्ट करती है कि संस्करण 0.44.x में जब GOOGLE_API_KEY को GOOGLE_GEMINI_BASE_URL के साथ इस्तेमाल किया जाता है, तो यह त्रुटि आती है। GEMINI_API_KEY इस्तेमाल करें और GOOGLE_API_KEY को unset करें।
संबंधित गाइड
- free gemini api
- Gemini API का quota खत्म (429 RESOURCE_EXHAUSTED)
- Claude Code मुफ़्त में कैसे उपयोग करें
- मुफ़्त मॉडलों के साथ Codex CLI इस्तेमाल करें
- कोडिंग के लिए सबसे अच्छे मुफ़्त model APIs
स्रोत
- 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)