Geliştirici Kaynakları

Gemini CLI

Gemini CLI’yi RunAPI’nin yerel Gemini API’siyle yapılandırın, istekleri doğrulayın ve önceki ayarlarınızı geri yükleyin.

Markdown'ı görüntüle

Genel Bakış

Gemini CLI bir terminal ajanıdır. Bu kılavuz model sağlayıcısını RunAPI’nin yerel Gemini API’sine değiştirir; MCP ile RunAPI araçları eklemek ayrı bir adımdır.

Başlamadan önce

Resmî kurulum kılavuzunu izleyin. Kimlik doğrulama kılavuzuyla özel bir standart API anahtarı oluşturun ve model kataloğundan Gemini yerel model kimliğini kopyalayın. Anahtarınızı asla commit etmeyin.

SHELL

npm install -g @google/gemini-cli

RunAPI'yi yapılandırın

Geçerli kabuğunuzda bu değişkenlerle başlayın. Temel URL, /v1beta içermeyen HTTPS API köküdür; SDK POST /v1beta/models/{model}:streamGenerateContent?alt=sse ekler. HTTP yalnızca localhost için kullanılabilir.

SHELL

export GOOGLE_GEMINI_BASE_URL=https://runapi.ai
export GEMINI_API_KEY=YOUR_RUNAPI_API_KEY
export GEMINI_MODEL=YOUR_RUNAPI_MODEL_ID

Kalıcı kullanım için aynı üç değişkeni depolarınızın dışında ~/.gemini/.env dosyasına kaydedin. chmod 600 ~/.gemini/.env ile erişimi kısıtlayın. Gemini CLI, geçerli dizinden üst dizinlere doğru .env arar, ardından ~/.gemini/.env ve ~/.env dosyalarını kontrol eder; çakışan dosyalara dikkat edin.

Diğer ayarları koruyarak bu iki ayarı ~/.gemini/settings.json dosyasına birleştirin. API anahtarıyla kimlik doğrulamak için gemini-api-key kullanın; önbellekteki Google oturumunu kullanmayın. Anahtar varsayılan olarak x-goog-api-key içinde gönderilir.

JSON

{
  "security": {
    "auth": {"selectedType": "gemini-api-key"}
  },
  "model": {"name": "YOUR_RUNAPI_MODEL_ID"}
}

Bir model seçin

Etkileşimli oturumda GEMINI_MODEL, --model YOUR_RUNAPI_MODEL_ID veya /model kullanın. auto, pro ve flash takma adlarından kaçının: RunAPI’de bulunmayan Google model kimliklerine çözümlenebilirler. İç seçim, sınıflandırma ve döngü algılama da flash veya flash-lite yardımcı modellerini isteyebilir; kullanılabilirliklerini ayrıca kontrol edin.

Doğrula

Bunu güvendiğiniz bir depoda çalıştırın. Etkileşimli oturumda /about veya /stats ile modeli kontrol edip RunAPI kullanım kayıtlarında eşleşen streamGenerateContent isteğini doğrulayın. Başarılı CLI yanıtı tek başına isteği hangi uç noktanın aldığını kanıtlamaz.

SHELL

gemini --version
gemini -p "Describe this repository in one sentence."

RunAPI araçlarını ekleyin

MCP araç ekler, model sağlayıcısı eklemez. Bu komut yerel sunucuyu kaydeder; ayrı kimlik doğrulama ve doğrulama adımları için Local MCP kılavuzunu izleyin.

SHELL

gemini mcp add runapi npx -y @runapi.ai/mcp

Sorun giderme

İstekler hâlâ Google’a gidiyorsa çakışan .env dosyalarını, security.auth.selectedType ayarını, önbellekteki oturumu ve Google/Vertex kimlik doğrulama ortam değişkenlerini kontrol edin. Invalid auth method selected görürseniz ayarlarda gateway yerine gemini-api-key seçip yeniden başlatın.

401 durumunda anahtarı ve varsa GEMINI_API_KEY_AUTH_MECHANISM geçersiz kılmasını kontrol edin; varsayılan olarak x-goog-api-key kullanılır. 404 için temel URL’den /v1beta bölümünü kaldırıp desteklenen Gemini yerel model kimliğini yeniden kopyalayın. Yardımcı model kullanılamıyorsa istenen tam kimliği kontrol edin; ana model seçimi tüm CLI özelliklerini garanti etmez.

RunAPI, countTokens veya embedContent sunmaz. countTokens başarısız olduğunda Gemini CLI yerel token tahminine dönebilir; tahminler kullanım kayıtlarından farklı olabilir. localhost dışında HTTPS kullanın ve sertifika doğrulamasını kapatmayın.

RunAPI'yi Kaldır

Üç değişkeni kabuğunuzdan ve kaydedilmiş .env dosyalarından kaldırın, önceki security.auth.selectedType ve model ayarını geri yükleyin ve özel anahtarı RunAPI’de iptal edin. Ayrı eklenen MCP sunucusunu yalnızca araçlarına artık ihtiyacınız yoksa kaldırın.

SHELL

unset GOOGLE_GEMINI_BASE_URL GEMINI_API_KEY GEMINI_MODEL

Sonraki adımlar

LLM API hızlı başlangıcı, Gemini generateContent, streamGenerateContent, model kataloğu veya Local MCP ile devam edin.