"API key not valid. Please pass a valid API key." — Gemini'nin pek yardımcı olmayan cümlesi. Anahtar genellikle GEÇERLİDİR; sorun çevresindedir: referrer kısıtlaması, Generative Language API'nin etkinleştirilmemiş olması veya AI Studio anahtarının Vertex uç noktasına gönderilmesi. Aşağıdaki listeyi sırayla uygulayın.
Hata
{
"error": {
"code": 400,
"message": "API key not valid. Please pass a valid API key.",
"status": "INVALID_ARGUMENT",
"details": [{ "reason": "API_KEY_INVALID" }]
}
}Nedenler ve çözümler özeti
| Neden | Çözüm |
|---|---|
| Sunucu çağrılarını engelleyen anahtar kısıtlamaları (HTTP referrer / IP) | Google Cloud Console → Credentials bölümünde referrer kısıtlamalı bir anahtar sunucu taraflı istekleri reddeder. Kısıtlamasız bir anahtar kullanın veya API'ye göre kısıtlayın. |
| Generative Language API projede etkin değil | AI Studio tarzı anahtarlar için "Generative Language API"yi etkinleştirin. |
| AI Studio anahtarı ile Vertex AI uç noktası uyuşmazlığı | AIza… anahtarları generativelanguage.googleapis.com'u çağırır; Vertex ise farklı bir ana bilgisayarda OAuth/hizmet hesaplarını kullanır. Bunları birbirine karıştırmayın. |
| Desteklenmeyen bölge | AI Studio anahtarları her ülkede çalışmaz; kullanılabilirliği kontrol edin veya bir ağ geçidi üzerinden yönlendirin. |
| Ortam değişkeni bağlantısı (tırnaklar/boşluklar/yanlış değişken adı) | Başarısız olan işlem içinde print(repr(key)) çalıştırın; değişkeni temiz biçimde yeniden dışa aktarın. |
Anahtarı yalıtılmış olarak test edin
REST uç noktasına karşı tek bir curl isteği, anahtarın kendisinin düzgün olup olmadığını gösterir:
curl -s "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent?key=$GEMINI_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"contents":[{"parts":[{"text":"ping"}]}]}' | head -c 400Kısıtlamaları ve etkin API'leri kontrol edin
Cloud Console → APIs & Services → Credentials: anahtarı açın. Application restrictions değeri "HTTP referrers" ise sunucu çağrıları 400 döner — None veya IP tabanlı seçeneğe geçin. Ardından Generative Language API'nin aynı projede etkin olduğunu doğrulayın.
Her durumda tek anahtara ihtiyacınız varsa
Gemini + Claude + GPT anahtarlarıyla uğraşıyorsanız OpenAI uyumlu bir ağ geçidi bunları tek kimlik bilgisinde birleştirir — aynı kod, tek bir base_url, Google Cloud projesi gerekmez.
Kunavo üzerinden çağrı yapıyorsanız
Kunavo, Gemini 2.5 Flash ve Pro'yu Claude ve GPT ile aynı OpenAI uyumlu uç noktanın ve sk-kn anahtarının arkasında sunar — Google Cloud projesi yok, hata ayıklanacak anahtar kısıtlamaları yok ve AI Studio anahtarlarının sunulmadığı bölgelerde de çalışır. Oranlar Google'ın liste fiyatının oldukça altındadır ve kurulum, herhangi bir OpenAI SDK'sında üç alandan ibarettir.
Sık sorulan sorular
Gemini anahtarım yerelde çalışıyor ama üretimde başarısız oluyor — neden?
Genellikle referrer/IP kısıtlamaları (üretim IP'lerine izin verilmemesi), üretimde farklı bir env dosyası veya üretim projesinde Generative Language API'nin etkin olmamasıdır. Ortamlar arasındaki anahtarın repr değerini ve proje kimliğini karşılaştırın.
Gemini API ücretsiz mi?
AI Studio, dakika başına katı kotalara sahip ücretsiz bir katman sunar; üretim trafiği için faturalandırmanın etkinleştirilmesi gerekir (veya bir ağ geçidi kullanılmalıdır). Anahtar hataları yerine kota hataları alıyorsanız RESOURCE_EXHAUSTED kılavuzumuza bakın.
İlgili kılavuzlar
Hata anlamlarına ilişkin daha fazla bilgi hata referansı bölümünde; anahtar almak kayıt ve kimlik doğrulama kılavuzu üzerinden bir dakika sürer.