కస్టమ్ ఎండ్పాయింట్ మరియు ఉచిత మోడల్లతో Gemini CLI
Gemini CLI అనేది టెర్మినల్ కోసం Google యొక్క ఓపెన్-సోర్స్ కోడింగ్ ఏజెంట్. ఇది తన అభ్యర్థనలను కస్టమ్ బేస్ URLకు పంపగలదు. ఈ గైడ్ Gemini CLIని FreeLLMAPI వైపు చూపిస్తుంది, ఇది /v1beta పై నేటివ్ Gemini APIని సర్వ్ చేస్తుంది. మీ అభ్యర్థనలు అప్పుడు మీ ఉచిత ప్రొవైడర్ల పూల్కు వెళ్తాయి, ఇందులో ఉచిత Gemini API కీలు కూడా ఉండవచ్చు.
కోడ్, మోడల్ పేర్లు మరియు ప్రత్యక్ష కేటలాగ్ లేబుల్లు ఇంగ్లీషులోనే చూపబడతాయి.
Gemini CLI ఉచిత టియర్లో 2026 మార్పు
ముందుగా దీనిని చదవండి. Google 2026లో Gemini CLI యొక్క ఉచిత ఉపయోగాన్ని మార్చింది. Gemini CLI కోటా పేజీ ఇలా చెబుతుంది: "Unpaid tier and Google One users: Gemini CLI was replaced by Antigravity CLI on June 18th, 2026."
Google ప్రకటన ప్రకారం, Gemini CLI చెల్లింపు Gemini API కీల ద్వారా మరియు ఎంటర్ప్రైజ్ కస్టమర్ల కోసం అందుబాటులో ఉంటుంది.
- ఉచిత టియర్లో Google లాగిన్: ఇక వినియోగదారు ఖాతాల కోసం Gemini CLI ద్వారా సర్వ్ చేయబడదు.
- కస్టమ్ బేస్ URLతో Gemini API కీ: Gemini CLI కాన్ఫిగరేషన్ రిఫరెన్స్ ఇప్పటికీ
GOOGLE_GEMINI_BASE_URLను డాక్యుమెంట్ చేస్తుంది. ఈ వేరియబుల్తో, Gemini CLI తన అభ్యర్థనలను Google కు కాకుండా మీరు సెట్ చేసిన URLకు పంపుతుంది. - ఉచిత Gemini API కీలు: Google AI Studio ఇప్పటికీ Gemini API కోసం ఉచిత టియర్ను జాబితా చేస్తుంది. FreeLLMAPI ఆ కీలను, ఇతర ప్రొవైడర్ల కీలతో పాటు ఉపయోగించగలదు.
ఈ గైడ్ రెండవ పద్ధతిని ఉపయోగిస్తుంది. FreeLLMAPI అభ్యర్థనలకు సమాధానం ఇస్తుంది మరియు ప్రతిదాన్ని మీ పూల్లోని ఉచిత మోడల్కు పంపుతుంది.
దశ 1: FreeLLMAPI మరియు Gemini CLIని ఇన్స్టాల్ చేయండి
రెండింటినీ ఇన్స్టాల్ చేయండి
curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @google/gemini-clihttp://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>"
geminiGemini CLI ప్రామాణీకరణ పద్ధతిని అడిగినప్పుడు, Use Gemini API key ను ఎంచుకోండి. ఎంపికను సేవ్ చేయడానికి, దానిని ~/.gemini/settings.json లో సెట్ చేయండి:
~/.gemini/settings.json
{
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
}
}GEMINI_API_KEY ను ఉపయోగించండి. Gemini CLI ఇష్యూ ఒకటి నివేదిస్తుంది, 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 ఫ్యామిలీ మ్యాప్ ద్వారా పరిష్కరిస్తుంది. ప్రతి ఫ్యామిలీని (Pro, Flash మరియు Flash-Lite) Auto కు లేదా పిన్ చేసిన కేటలాగ్ మోడల్కు మ్యాప్ చేయండి.
- Auto తో, రూటర్ ప్రతి అభ్యర్థనకు ఉచిత మోడల్ను ఎంచుకుంటుంది. ఒక ప్రొవైడర్ 429 ఎర్రర్ పంపినప్పుడు, అది తదుపరి దానిని ప్రయత్నిస్తుంది.
- కేటలాగ్ IDలు మోడల్ పేర్లుగా కూడా పని చేస్తాయి.
gemini -m <catalog-id>తో Gemini CLIని ప్రారంభించండి, లేదా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 | అవును | అవును |
సరిపోలే 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 రేట్ లిమిట్ పేజీ ప్రకారం, పరిమితులు ఒక్కో API కీకి కాకుండా ఒక్కో ప్రాజెక్ట్కు వర్తిస్తాయి. ఒకే ప్రాజెక్ట్లో ఎక్కువ కీలు ఎక్కువ కోటా ఇవ్వవు. పరిమితులకు హామీ లేదని, మరియు మీ ప్రస్తుత పరిమితులను Google AI Studioలో చూడవచ్చని Google చెబుతుంది. ప్రివ్యూ మోడల్లకు తక్కువ పరిమితులు ఉంటాయి.
ఉచిత Gemini Flash కీ రోజుకు కొన్ని అభ్యర్థనలను మాత్రమే అనుమతిస్తుంది. ఒకే Gemini CLI పని అనేక అభ్యర్థనలను పంపగలదు. Gemini కోటా ఆగినప్పుడు రూటర్ కొనసాగగలిగేలా, ఇతర ప్రొవైడర్ల నుండి కీలను జోడించండి. నేటివ్ సర్ఫేస్ generateContent, streamGenerateContent ను ?alt=sse తో, countTokens మరియు మోడల్స్ జాబితాకు మద్దతు ఇస్తుంది.
FreeLLMAPI కీని x-goog-api-key హెడర్లో, Bearer టోకెన్గా లేదా Gemini యొక్క ?key= క్వెరీ పారామీటర్లో అంగీకరిస్తుంది. హెడర్ను ప్రాధాన్యత ఇవ్వండి, ఎందుకంటే URLలోని కీ షెల్ హిస్టరీ మరియు proxy లాగ్లలోకి లీక్ కావచ్చు.
సమస్య పరిష్కారం
| సమస్య | కారణం | పరిష్కారం |
|---|---|---|
| Gemini CLI Google లాగిన్ను తెరుస్తుంది | ప్రామాణీకరణ రకం Gemini API కీకి సెట్ చేయబడలేదు | Use Gemini API key ను ఎంచుకోండి, లేదా security.auth.selectedType ను సెట్ చేయండి |
| "Invalid auth method selected" | కస్టమ్ బేస్ URLతో GOOGLE_API_KEY ఉపయోగించబడుతుంది | GEMINI_API_KEY ఉపయోగించండి మరియు GOOGLE_API_KEY ను unset చేయండి |
| అభ్యర్థనలు గేట్వేకు కాకుండా Google కు వెళ్తాయి | ఈ షెల్లో GOOGLE_GEMINI_BASE_URL సెట్ చేయబడలేదు | వేరియబుల్ను export చేసి, ఆ తర్వాత gemini ను మళ్లీ ప్రారంభించండి |
మోడల్ కాల్స్పై 404 | బేస్ URLలో /v1beta ఉంది | http://localhost:3001 ఆరిజిన్ను మాత్రమే ఉపయోగించండి |
| టూల్ కాల్స్ విఫలమవుతాయి | Gemini ఫ్యామిలీ బలహీనమైన టూల్ కాలింగ్ ఉన్న మోడల్కు మ్యాప్ అవుతుంది | పైన ఉన్న పట్టికల నుండి మోడల్కు ఫ్యామిలీని మ్యాప్ చేయండి |
| "N ప్రయత్నాల తర్వాత అన్ని మోడల్లు రేట్-లిమిట్ చేయబడ్డాయి" | అన్ని కీలు వాటి పరిమితి వద్ద ఉన్నాయి | మరిన్ని ప్రొవైడర్ల నుండి కీలను జోడించండి, లేదా కూల్డౌన్ల కోసం వేచి ఉండండి |
తరచుగా అడిగే ప్రశ్నలు
Gemini CLI ఇంకా ఉచితమా?
Google 2026 జూన్ 18 నుండి చెల్లించని మరియు Google One వినియోగదారుల కోసం Google లాగిన్తో ఉచిత Gemini CLI ఉపయోగాన్ని ముగించింది. CLI ఇప్పటికీ కస్టమ్ బేస్ URLకు మద్దతు ఇస్తుంది, కాబట్టి అది FreeLLMAPI వంటి ఉచిత గేట్వేపై నడవగలదు.
కస్టమ్ ఎండ్పాయింట్తో Gemini CLIని ఎలా ఉపయోగించాలి?
GOOGLE_GEMINI_BASE_URL ను ఎండ్పాయింట్ ఆరిజిన్కు, మరియు GEMINI_API_KEY ను దాని కీకి సెట్ చేయండి, ఆ తర్వాత Use Gemini API key ను ఎంచుకోండి. ఎండ్పాయింట్ /v1beta పై నేటివ్ Gemini APIని మాట్లాడాలి.
Gemini CLI Gemini కాని మోడల్లను ఉపయోగించగలదా?
అవును, FreeLLMAPI ద్వారా. గేట్వే Gemini Pro, Flash మరియు Flash-Lite ఫ్యామిలీ పేర్లను Auto కు లేదా ఏ కేటలాగ్ మోడల్కైనా మ్యాప్ చేస్తుంది, ఉదాహరణకు Qwen లేదా GLM మోడల్.
Gemini API ఉచిత టియర్ పరిమితులు ఏమిటి?
Google పరిమితులను ప్రతి కీకి కాకుండా ప్రతి ప్రాజెక్ట్కు సెట్ చేస్తుంది, మరియు ప్రస్తుత విలువలను Google AI Studioలో చూపిస్తుంది. ఈ పేజీలోని పట్టిక FreeLLMAPI కేటలాగ్ నుండి నేటి ఉచిత Gemini మోడల్లను మరియు వాటి పరిమితులను చూపుతుంది.
నాకు 'Invalid auth method selected' ఎందుకు వస్తోంది?
GOOGLE_API_KEY ను GOOGLE_GEMINI_BASE_URL తో ఉపయోగించినప్పుడు, వెర్షన్ 0.44.x లో ఈ ఎర్రర్ వస్తుందని Gemini CLI ఇష్యూ ఒకటి నివేదిస్తుంది. GEMINI_API_KEY ను ఉపయోగించండి మరియు GOOGLE_API_KEY ను unset చేయండి.
సంబంధిత గైడ్లు
- 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 న తనిఖీ చేయబడింది)