Gemini API anahtarı, bir uygulamanın Google’ın modellerini abonelik yerine sizin hesabınızla kullanmasını sağlar. Oluşturması yaklaşık iki dakika sürer ve bir Google hesabından başka bir şey gerekmez.
Anahtarı oluşturun
- Google AI Studio sayfasını açın ve oturum açın.
- İlk ziyaretinizse Hizmet Şartları’nı kabul edin. Yeni kullanıcılar için AI Studio varsayılan bir Google Cloud projesi ve ilk API anahtarını kendisi oluşturur.
- Anahtar oluşmadıysa API Keys sayfasını açıp Create API key düğmesine tıklayın.
- Anahtarı kopyalayın ve güvenli bir yerde saklayın. Ona bir parola gibi davranın.
Zaten Google Cloud kullanıyorsanız AI Studio sizin için proje oluşturmaz. Dashboard → Projects bölümünde Import projects ile projenizi seçip Import ile içe aktarın; ardından API Keys sayfasındaki Create API key çalışır.
Düğme pasifse ve “You do not have permission to create a key in this project” yazıyorsa proje, anahtar oluşturmayı kısıtlayan bir kuruluşa aittir. Yöneticinizden izin isteyin ya da kuruluşa bağlı olmayan yeni bir proje oluşturun.
Eski bir anahtar çalışmayı bırakırsa
Google 2026’da anahtar türlerini değiştirdi. 28 Mayıs 2026’dan beri AI Studio’da oluşturulan anahtarlar, Google’ın auth key adını verdiği yeni türdendir ve Gemini API artık kısıtlaması olmayan standart anahtarları reddediyor. Uzun süre kullanılmamış kısıtlamasız anahtarlar da Blocked olarak görünür.
Daha önce oluşturduğunuz bir anahtar birden hata vermeye başlarsa AI Studio’da açın, Add restrictions → Restrict to Gemini API only → Restrict key adımlarını izleyin. Ya da yeni bir anahtar oluşturun.
Hangi modeller ücretsiz?
Google ücretsiz katmanda şu modelleri ücretsiz olarak listeliyor:
| Model | Ücretsiz katman | Görüntü kabul eder |
|---|---|---|
| Gemini 3.1 Flash-Lite | Evet | Evet |
| Gemini 3.5 Flash-Lite | Evet | Evet |
| Gemini 3.6 Flash | Evet | Evet |
| Gemini 3.8 Flash | Evet | Evet |
| Gemini 3.1 Pro (önizleme) | Hayır | Evet |
| Gemini 4 Argon | Hayır | Evet |
Ekim 2026’da çıkan Gemini 4 Argon yalnızca ücretli. Aynı anahtarla en yeni ücretsiz modeli istiyorsanız Gemini 3.8 Flash’ı kullanın. Fiyatı için Gemini 4 Argon API’si ücretsiz mi? yazısına bakın.
Bir fark daha: ücretsiz katmanda Google, istemlerinizi ve yanıtları ürünlerini geliştirmek için kullanabilir; ücretli katmanda kullanmaz. Özel bir şey göndermeden önce bunu aklınızda tutun.
Ücretsiz katman neyi sınırlıyor?
Google herkes için geçerli tek bir sayı yayımlamıyor. Bilmeniz gereken üç şey var:
- Limitler üç ayrı ölçüyle sayılır: dakikadaki istek, dakikadaki giriş tokenı ve günlük istek. Herhangi birini aşarsanız sıfırlanana kadar hata alırsınız.
- Limitler anahtara değil projeye aittir. Aynı projede ikinci bir anahtar oluşturmak hakkınızı ikiye katlamaz.
- Günlük sayaç Pasifik saatiyle gece yarısı sıfırlanır.
Kendi sayılarınızı AI Studio’da model model görebilirsiniz. Uzun bir iş için bir modele güvenmeden önce oraya bakın: hafif Flash-Lite modelleri genellikle büyük modellerden daha fazla isteğe izin verir.
Hangi modeli seçmeli?
Gündelik sorular için 3.5 modellerinin en hızlısı ve en ekonomiği olan Gemini 3.5 Flash-Lite ile başlayın. Yanıt daha fazla akıl yürütme gerektirdiğinde Gemini 3.6 Flash veya Gemini 3.8 Flash’a geçin. Hepsi görüntü kabul eder; grafik ve şemalar da çalışır.
Anahtarı güvende tutun
- Anahtarı sohbet mesajlarına, ekran görüntülerine, herkese açık depolara veya paylaşılan notlara yapıştırmayın.
- Restrict to Gemini API only kısıtlamasını açık tutun; böylece sızan bir anahtar başka Google hizmetlerinde kullanılamaz.
- Anahtar sızarsa yenisini oluşturun, ona geçin, sonra eskisini devre dışı bırakın.
Sık sorulanlar
Gemini API ücretsiz mi? Evet; yukarıdaki tablodaki Flash ve Flash-Lite modelleri için, AI Studio’nun projeniz için gösterdiği limitler içinde. Gemini 4 Argon ve Gemini 3.1 Pro ücretsiz katmanda değil.
Anahtarım neden “Blocked” görünüyor? Büyük ihtimalle eski ve kısıtlamasız bir anahtar. Gemini API kısıtlamasını ekleyin ya da yeni bir anahtar oluşturun.
Anahtarı LuciQA’da kullanma
LuciQA, ekranınızdaki içerikle ilgili soruları seçtiğiniz sağlayıcıyla yanıtlayan ücretsiz bir masaüstü uygulamasıdır. Ayarlar’ı açın, Google Gemini’yi seçin, anahtarı yapıştırın, bir model seçip kaydedin. Anahtarınız işletim sisteminin güvenli deposunda saklanır ve istekler bilgisayarınızdan doğrudan Google’a gider.
Aynı adımlar ve güncel model listesi Gemini kurulum rehberinde; ücretsiz katmanı olan diğer sağlayıcılar ücretsiz yapay zekâ API’leri karşılaştırmasında.