Özel uç noktalı Gemini CLI ve ücretsiz modeller
Gemini CLI, Google'ın terminal için açık kaynaklı kodlama ajanıdır. İsteklerini özel bir temel URL'ye gönderebilir. Bu rehber Gemini CLI'yi FreeLLMAPI'ye yönlendirir. FreeLLMAPI, yerel Gemini API'sini /v1beta üzerinden sunar. İstekleriniz ardından, ücretsiz Gemini API anahtarlarını da içerebilen ücretsiz sağlayıcı havuzunuza gider.
Kod, model adları ve canlı katalog etiketleri İngilizce gösterilir.
Gemini CLI ücretsiz katmanındaki 2026 değişikliği
Önce bunu okuyun. Google, 2026'da Gemini CLI'nin ücretsiz kullanımını değiştirdi. Gemini CLI kota sayfası şunu söyler: "Ücretli olmayan katman ve Google One kullanıcıları: Gemini CLI, 18 Haziran 2026'da Antigravity CLI ile değiştirildi."
Google'ın duyurusuna göre Gemini CLI, ücretli Gemini API anahtarları ve kurumsal müşteriler için kullanılabilir olmaya devam eder.
- Ücretsiz katmanda Google girişi: tüketici hesapları için artık Gemini CLI tarafından sunulmuyor.
- Özel temel URL'li Gemini API anahtarı: Gemini CLI yapılandırma başvurusu hâlâ
GOOGLE_GEMINI_BASE_URLdeğişkenini belgeler. Bu değişkenle Gemini CLI, isteklerini Google'a değil, sizin ayarladığınız URL'ye gönderir. - Ücretsiz Gemini API anahtarları: Google AI Studio, Gemini API için hâlâ ücretsiz bir katman listeler. FreeLLMAPI, bu anahtarları diğer sağlayıcıların anahtarlarıyla birlikte kullanabilir.
Bu rehber ikinci yöntemi kullanır. FreeLLMAPI istekleri yanıtlar ve her birini havuzunuzdaki ücretsiz bir modele gönderir.
1. adım: FreeLLMAPI ve Gemini CLI'yi kurun
İkisini de kurun
curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @google/gemini-clihttp://localhost:3001 adresini açın. Keys sayfasına en az iki ücretsiz sağlayıcı anahtarı ekleyin. Ücretsiz bir Google AI Studio anahtarı iyi bir ilk anahtardır. Birleşik anahtarınızı aynı sayfadan kopyalayın.
2. adım: Gemini CLI'yi ağ geçidine yönlendirin
İki ortam değişkenini ayarlayın ve Gemini CLI'yi başlatın. Temel URL, /v1beta olmadan sunucu kökenidir. Gemini CLI API yolunu kendisi ekler.
macOS veya 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 bir kimlik doğrulama yöntemi sorduğunda Use Gemini API key seçeneğini seçin. Seçimi kaydetmek için ~/.gemini/settings.json dosyasında ayarlayın:
~/.gemini/settings.json
{
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
}
}GEMINI_API_KEY kullanın. Bir Gemini CLI sorununa göre sürüm 0.44.x, GOOGLE_API_KEY, GOOGLE_GEMINI_BASE_URL ile birlikte kullanıldığında "Invalid auth method selected" hatasıyla başarısız olur. GOOGLE_API_KEY ayarlıysa unset GOOGLE_API_KEY ile kaldırın.3. adım: Gemini model adlarını ücretsiz modellerle eşleyin
Gemini CLI, örneğin gemini-2.5-flash gibi Gemini model adları ister. FreeLLMAPI bu adları doğrudan Google'a göndermez. Bunları Keys, Agents sekmesindeki Gemini aile eşlemesi üzerinden çözer. Her aileyi (Pro, Flash ve Flash-Lite) Auto seçeneğine veya sabitlenmiş bir katalog modeline eşleyin.
- Auto ile yönlendirici her istek için ücretsiz bir model seçer. Bir sağlayıcı 429 hatası gönderdiğinde sonrakini dener.
- Katalog kimlikleri model adı olarak da çalışır. Gemini CLI'yi
gemini -m <catalog-id>ile başlatın veyaGEMINI_MODELayarlayın. - Gemini CLI, araçları olan bir ajandır. Aileleri, araç çağrısı ve geniş bir bağlam penceresi olan modellere eşleyin.
İlk tablo, bugün katalogdaki ücretsiz Gemini modellerini gösterir. İkinci tablo, bir Gemini ailesine eşleyebileceğiniz diğer ücretsiz modelleri gösterir.
| Model | Ücretsiz olduğu yer | Bağlam | Ücretsiz limitler (en iyi teklif) | Araçlar | Görsel girdi |
|---|---|---|---|---|---|
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Evet | Evet |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Evet | Evet |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Evet | Evet |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Evet | Evet |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Evet | Evet |
| Gemini 3.8 Live | Google AI Studio | - | 10 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Evet | Evet |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Evet | Evet |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Evet | Evet |
14 eşleşen ücretsiz modelden 8 tanesi gösteriliyor. Tüm modelleri gör.
Canlı veriler FreeLLMAPI kataloğundan alınır (sürüm 2026.11.19, 2026-11-19 tarihinde kontrol edildi). Ücretsiz limitler sık değişir. Katalog her gün kontrol edilir.
| Model | Ücretsiz olduğu yer | Bağlam | Ücretsiz limitler (en iyi teklif) | Araçlar | Görsel girdi |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 istek/dk 1 req/min per model | Evet | Hayır |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 istek/dk 40 RPM | Evet | Evet |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Evet | Hayır |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Evet | Evet |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Evet | Evet |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 istek/dk 50 istek/gün 50 req/day account-wide (1,000 after a $10 purchase) | Evet | Evet |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 istek/dk 50 istek/gün Shared rate limit | Evet | Hayır |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 istek/dk 250 istek/gün 70,000 jeton/dk ~6M | Evet | Evet |
104 eşleşen ücretsiz modelden 8 tanesi gösteriliyor. Tüm modelleri gör.
Canlı veriler FreeLLMAPI kataloğundan alınır (sürüm 2026.11.19, 2026-11-19 tarihinde kontrol edildi). Ücretsiz limitler sık değişir. Katalog her gün kontrol edilir.
Gemini ücretsiz katman limitleri
Google'ın hız limiti sayfası, limitlerin API anahtarı başına değil, proje başına uygulandığını belirtir. Bir projede daha fazla anahtar, daha fazla kota vermez. Google ayrıca limitlerin garanti edilmediğini ve geçerli limitlerinizi Google AI Studio'da görebileceğinizi söyler. Önizleme modellerinin limitleri daha düşüktür.
Ücretsiz bir Gemini Flash anahtarı günde az istek verir. Tek bir Gemini CLI görevi çok sayıda istek gönderebilir. Gemini kotası durduğunda yönlendiricinin devam edebilmesi için diğer sağlayıcılardan anahtarlar ekleyin. Yerel yüzey generateContent, streamGenerateContent ile ?alt=sse, countTokens ve model listesini destekler.
FreeLLMAPI anahtarı x-goog-api-key başlığında, Bearer token olarak veya Gemini'nin ?key= sorgu parametresinde kabul eder. Başlığı tercih edin, çünkü URL'deki bir anahtar kabuk geçmişine ve proxy günlüklerine sızabilir.
Sorun giderme
| Sorun | Neden | Çözüm |
|---|---|---|
| Gemini CLI bir Google girişi açar | Kimlik doğrulama türü Gemini API anahtarı olarak ayarlı değil | Use Gemini API key seçin veya security.auth.selectedType ayarlayın |
| "Invalid auth method selected" | GOOGLE_API_KEY, özel bir temel URL ile kullanılıyor | GEMINI_API_KEY kullanın ve GOOGLE_API_KEY değerini kaldırın |
| İstekler ağ geçidine değil, Google'a gidiyor | GOOGLE_GEMINI_BASE_URL bu kabukta ayarlı değil | Değişkeni dışa aktarın, sonra gemini komutunu yeniden başlatın |
Model çağrılarında 404 | Temel URL /v1beta içeriyor | Yalnızca http://localhost:3001 kökenini kullanın |
| Araç çağrıları başarısız oluyor | Gemini ailesi, araç çağrısı zayıf bir modele eşlenmiş | Aileyi yukarıdaki tablolardan bir modele eşleyin |
| "N denemeden sonra tüm modeller hız limitine takıldı" | Tüm anahtarlar limitinde | Daha fazla sağlayıcıdan anahtar ekleyin veya bekleme sürelerinin dolmasını bekleyin |
Sık sorulan sorular
Gemini CLI hâlâ ücretsiz mi?
Google, ücretli olmayan ve Google One kullanıcıları için Google girişiyle ücretsiz Gemini CLI kullanımını 18 Haziran 2026'da sonlandırdı. CLI yine de özel bir temel URL'yi destekler, bu yüzden FreeLLMAPI gibi ücretsiz bir ağ geçidi üzerinde çalışabilir.
Gemini CLI'yi özel bir uç noktayla nasıl kullanırım?
GOOGLE_GEMINI_BASE_URL değerini uç nokta kökenine, GEMINI_API_KEY değerini de anahtarına ayarlayın. Sonra Use Gemini API key seçeneğini seçin. Uç nokta, /v1beta üzerinde yerel Gemini API'sini kullanmalıdır.
Gemini CLI, Gemini olmayan modelleri kullanabilir mi?
Evet, FreeLLMAPI üzerinden. Ağ geçidi Gemini Pro, Flash ve Flash-Lite aile adlarını Auto'ya veya herhangi bir katalog modeline eşler. Örneğin bir Qwen veya GLM modeline.
Gemini API ücretsiz katman limitleri nedir?
Google limitleri anahtar başına değil, proje başına belirler ve geçerli değerleri Google AI Studio'da gösterir. Bu sayfadaki tablo, bugünkü ücretsiz Gemini modellerini ve limitlerini FreeLLMAPI kataloğundan gösterir.
Neden 'Invalid auth method selected' hatasını alıyorum?
Bir Gemini CLI sorununa göre bu hata, GOOGLE_API_KEY, GOOGLE_GEMINI_BASE_URL ile kullanıldığında sürüm 0.44.x'te oluşur. GEMINI_API_KEY kullanın ve GOOGLE_API_KEY değerini kaldırın.
İlgili rehberler
- free gemini api
- Gemini API kotası aşıldı (429 RESOURCE_EXHAUSTED)
- Claude Code'u ücretsiz nasıl kullanırsınız
- Codex CLI'ı ücretsiz modellerle kullanın
- En iyi ücretsiz kodlama model API'leri
Kaynaklar
- Gemini CLI docs: configuration reference (20 November 2026 tarihinde kontrol edildi)
- Gemini CLI docs: authentication (20 November 2026 tarihinde kontrol edildi)
- Gemini CLI docs: quota and pricing (20 November 2026 tarihinde kontrol edildi)
- Google Developers Blog: transitioning Gemini CLI to Antigravity CLI (20 November 2026 tarihinde kontrol edildi)
- Gemini CLI issue 27550: auth with a custom base URL (20 November 2026 tarihinde kontrol edildi)
- Google AI Studio: rate limits (20 November 2026 tarihinde kontrol edildi)
- FreeLLMAPI docs: native Gemini API (20 November 2026 tarihinde kontrol edildi)