Nyumbani / Miongozo / Gemini CLI yenye kituo maalum na modeli za bure

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-cli

Fungua 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>
gemini

Windows PowerShell

$env:GOOGLE_GEMINI_BASE_URL="http://localhost:3001"
$env:GEMINI_API_KEY="<unified-key>"
gemini

Gemini 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"
    }
  }
}
Muhimu: tumia 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 weka GEMINI_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 za bure za Gemini API zenye wito wa zana (Google AI Studio)
ModeliBure kwenyeMuktadhaVikomo vya bure (ofa bora)ZanaUoni
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaNdiyoNdiyo
Gemini Flash (latest alias)Google AI Studio-10 maombi/dakika
20 maombi/siku
250,000 tokeni/dakika
~3M
NdiyoNdiyo
Gemini 3.7 FlashGoogle AI Studio1M10 maombi/dakika
20 maombi/siku
250,000 tokeni/dakika
~3M
NdiyoNdiyo
Gemini 3.6 FlashGoogle AI Studio1M10 maombi/dakika
20 maombi/siku
250,000 tokeni/dakika
~3M
NdiyoNdiyo
Gemini 3.5 FlashGoogle AI Studio1M10 maombi/dakika
20 maombi/siku
250,000 tokeni/dakika
~3M
NdiyoNdiyo
Gemini 3.8 LiveGoogle AI Studio-10 maombi/dakika
20 maombi/siku
250,000 tokeni/dakika
~3M
NdiyoNdiyo
Gemini 3.8 Live Extended ThinkingGoogle AI Studio-10 maombi/dakika
20 maombi/siku
250,000 tokeni/dakika
~3M
NdiyoNdiyo
Gemini 3.5 Flash LiteGoogle AI Studio1M15 maombi/dakika
20 maombi/siku
250,000 tokeni/dakika
~3M
NdiyoNdiyo

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 nyingine za bure za Gemini CLI: wito wa zana na muktadha wa 128K au zaidi
ModeliBure kwenyeMuktadhaVikomo vya bure (ofa bora)ZanaUoni
GLM 5.3UnoRouter1M1 maombi/dakika
1 req/min per model
NdiyoHapana
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 maombi/dakika
40 RPM
NdiyoNdiyo
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceNdiyoHapana
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditNdiyoNdiyo
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditNdiyoNdiyo
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 maombi/dakika
50 maombi/siku
50 req/day account-wide (1,000 after a $10 purchase)
NdiyoNdiyo
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 maombi/dakika
50 maombi/siku
Shared rate limit
NdiyoHapana
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 maombi/dakika
250 maombi/siku
70,000 tokeni/dakika
~6M
NdiyoNdiyo

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

TatizoChanzoSuluhisho
Gemini CLI inafungua kuingia kwa GoogleAina ya uthibitishaji haijawekwa kuwa Gemini API keyChagua Use Gemini API key, au weka security.auth.selectedType
Hitilafu: "Invalid auth method selected"GOOGLE_API_KEY inatumika pamoja na base URL maalumTumia GEMINI_API_KEY na uondoe GOOGLE_API_KEY
Maombi yanaenda kwa Google, si kwenye langoGOOGLE_GEMINI_BASE_URL haijawekwa kwenye shell hiiWeka kigezo kwa export, kisha uanzishe gemini tena
404 kwenye wito wa modeliBase URL inajumuisha /v1betaTumia anwani http://localhost:3001 pekee
Wito wa zana unashindwaFamilia ya Gemini inaelekezwa kwenye modeli yenye wito dhaifu wa zanaPangia familia modeli kutoka kwenye majedwali hapo juu
Hitilafu: "All models rate-limited after N attempts"Funguo zote zimefikia kikomo chakeOngeza funguo kutoka watoa huduma zaidi, au subiri muda wa kupumzika
Tumia kila moja ya hizi kwa ufunguo mmoja. FreeLLMAPI ni kipanga njia huria, unachoendesha mwenyewe. Kinaweka tabaka hizi zote za bure nyuma ya kituo kimoja cha OpenAI kinachooana, na kinahamia kwenye nyingine pale kikomo kinapofikiwa. Vinjari katalogi au anza sasa.

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

Vyanzo

Miongozo yote · Tazama modeli zote za bure