Ana sayfa / Rehberler / Özel uç noktalı Gemini CLI ve ücretsiz modeller

Ö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_URL değ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-cli

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

Windows PowerShell

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

Gemini 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"
    }
  }
}
Önemli: 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 veya GEMINI_MODEL ayarlayı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.

Araç çağrısı olan ücretsiz Gemini API modelleri (Google AI Studio)
ModelÜcretsiz olduğu yerBağlamÜcretsiz limitler (en iyi teklif)AraçlarGörsel girdi
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaEvetEvet
Gemini Flash (latest alias)Google AI Studio-10 istek/dk
20 istek/gün
250,000 jeton/dk
~3M
EvetEvet
Gemini 3.7 FlashGoogle AI Studio1M10 istek/dk
20 istek/gün
250,000 jeton/dk
~3M
EvetEvet
Gemini 3.6 FlashGoogle AI Studio1M10 istek/dk
20 istek/gün
250,000 jeton/dk
~3M
EvetEvet
Gemini 3.5 FlashGoogle AI Studio1M10 istek/dk
20 istek/gün
250,000 jeton/dk
~3M
EvetEvet
Gemini 3.8 LiveGoogle AI Studio-10 istek/dk
20 istek/gün
250,000 jeton/dk
~3M
EvetEvet
Gemini 3.8 Live Extended ThinkingGoogle AI Studio-10 istek/dk
20 istek/gün
250,000 jeton/dk
~3M
EvetEvet
Gemini 3.5 Flash LiteGoogle AI Studio1M15 istek/dk
20 istek/gün
250,000 jeton/dk
~3M
EvetEvet

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.

Gemini CLI için diğer ücretsiz modeller: araç çağrısı ve 128K+ bağlam
ModelÜcretsiz olduğu yerBağlamÜcretsiz limitler (en iyi teklif)AraçlarGörsel girdi
GLM 5.3UnoRouter1M1 istek/dk
1 req/min per model
EvetHayır
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 istek/dk
40 RPM
EvetEvet
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceEvetHayır
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditEvetEvet
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditEvetEvet
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 istek/dk
50 istek/gün
50 req/day account-wide (1,000 after a $10 purchase)
EvetEvet
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 istek/dk
50 istek/gün
Shared rate limit
EvetHayır
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 istek/dk
250 istek/gün
70,000 jeton/dk
~6M
EvetEvet

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

SorunNedenÇözüm
Gemini CLI bir Google girişi açarKimlik doğrulama türü Gemini API anahtarı olarak ayarlı değilUse 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ıyorGEMINI_API_KEY kullanın ve GOOGLE_API_KEY değerini kaldırın
İstekler ağ geçidine değil, Google'a gidiyorGOOGLE_GEMINI_BASE_URL bu kabukta ayarlı değilDeğişkeni dışa aktarın, sonra gemini komutunu yeniden başlatın
Model çağrılarında 404Temel URL /v1beta içeriyorYalnızca http://localhost:3001 kökenini kullanın
Araç çağrıları başarısız oluyorGemini 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 limitindeDaha fazla sağlayıcıdan anahtar ekleyin veya bekleme sürelerinin dolmasını bekleyin
Bunların hepsini tek bir anahtarla kullanın. FreeLLMAPI, açık kaynaklı ve kendi sunucunuzda çalışan bir yönlendiricidir. Tüm bu ücretsiz katmanları tek bir OpenAI uyumlu uç noktanın arkasında toplar ve bir sağlayıcı hız limitine takıldığında otomatik olarak başka birine geçer. Kataloğa göz atın veya canlı olarak incele.

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

Kaynaklar

Tüm rehberler · Tüm ücretsiz modelleri incele