होम / गाइड / कस्टम endpoint और मुफ़्त मॉडलों के साथ Gemini CLI

कस्टम 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-cli

http://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>
gemini

Windows 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 पर मैप कर सकते हैं।

tool calling वाले मुफ़्त Gemini API मॉडल (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
हाँहाँ

14 मिलते-जुलते मुफ़्त मॉडल में से 8 दिखाए जा रहे हैं। सभी मॉडल देखें.

FreeLLMAPI कैटलॉग से लाइव डेटा (संस्करण 2026.11.19, जाँच 2026-11-19)। मुफ़्त सीमाएँ अक्सर बदलती हैं। कैटलॉग की हर दिन जाँच होती है।

Gemini CLI के लिए अन्य मुफ़्त मॉडल: tool calling और 128K+ context
मॉडलमुफ़्त उपलब्धकॉन्टेक्स्टमुफ़्त सीमाएँ (सबसे अच्छा विकल्प)टूलविज़न
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
हाँहाँ

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 दोबारा शुरू करें
मॉडल कॉल पर 404base URL में /v1beta हैकेवल origin http://localhost:3001 इस्तेमाल करें
Tool calls विफल होते हैंGemini family एक ऐसे मॉडल पर मैप है जिसमें tool calling कमज़ोर हैfamily को ऊपर की तालिकाओं के किसी मॉडल पर मैप करें
"N प्रयासों के बाद सभी मॉडल rate-limited"सभी keys अपनी सीमा पर हैंअधिक providers की keys जोड़ें, या cooldowns तक प्रतीक्षा करें
इनमें से हर एक का उपयोग एक ही कुंजी से करें। FreeLLMAPI एक ओपन-सोर्स, सेल्फ़-होस्टेड राउटर है। यह इन सभी मुफ़्त टियर को एक OpenAI-संगत एंडपॉइंट के पीछे रखता है। जब कोई एक सीमा पर पहुँचता है, तो यह अगले प्रदाता पर स्विच कर देता है। कैटलॉग देखें या शुरू करें.

अक्सर पूछे जाने वाले प्रश्न

क्या 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 करें।

संबंधित गाइड

स्रोत

सभी गाइड · सभी मुफ़्त मॉडल देखें