Gemini API Anahtarınızı Uygulamada Kullanın, Kod Yazmadan

Gemini API, Gemini uygulamasından nasıl ayrılır

Google, Gemini’yi iki biçimde sunuyor. Ücretsiz planı ve ücretli Google AI planları olan Gemini uygulaması bireysel bir ürün. Gemini API ise geliştirici ürünü: bir API anahtarı oluşturursunuz ve yazılım, kendi anahtarınızı kabul eden bir sohbet uygulaması da dahil, sizin adınıza Gemini modellerine istek gönderir.

API, Google AI Studio’da yönetilir ve bir Google Cloud projesine dayanır. Google’ın belgeleri, her Gemini API anahtarının bir Google Cloud projesine bağlı olduğunu; faturalandırmanın, iş birliği yapanların ve izinlerin bu projede yönetildiğini belirtiyor. Hız sınırları anahtara değil, projeye göre uygulanır. Ücretli API kullanımı, o projeye bir Cloud faturalandırma hesabı bağlanarak açılır. Bu yüzden bireysel bir Google AI planının API isteklerini karşıladığını varsaymayın.

1. adım: Gemini API anahtarı oluşturun

Anahtar oluşturmak bir dakika sürer ve ücretsiz plan için kredi kartı gerekmez. AI Studio’da yeniyseniz, hizmet şartlarını kabul ettikten sonra sizin için varsayılan bir Google Cloud projesi ve bir API anahtarı oluşturur.

• aistudio.google.com/apikey adresine gidip Google hesabınızla giriş yapın.
• Sorulursa hizmet şartlarını kabul edin; yeni kullanıcılara otomatik olarak varsayılan bir proje ve anahtar verilir.
• Bir API anahtarı oluşturun ya da oluşturulmuş olanı kopyalayın ve hangi projeye ait olduğuna dikkat edin.
• Anahtarı bir parola yöneticisi gibi güvenli bir yerde saklayın. Gemini anahtarları genellikle "AIza" ile başlar.

2. adım: Ücretsiz ve ücretli plan arasında karar verin

Gemini’de en önemli karar bu; çünkü iki plan yalnızca fiyatta değil, başka yönlerden de ayrılıyor. Fiyat sayfası her model için ücretsiz planın "Free of charge" (ücretsiz) mi yoksa "Not available" (yok) mu olduğunu listeler ve içeriğinizin her planda nasıl ele alındığını da belirtir.

Google’ın fiyat sayfası, ücretsiz planda içeriğin ürünlerini geliştirmek için kullanıldığını, ücretli planda ise kullanılmadığını söylüyor. Kişisel ya da gizli bir şey yapıştıracaksanız, kullanımınız ücretsiz sınırlara sığsa bile faturalandırmayı bağlamak için bu fark yeterli bir sebep.

Hız sınırları da farklı. Faturalandırması olmayan bir proje ücretsiz plandadır. Etkin bir faturalandırma hesabı bağlamak onu Tier 1’e taşır, daha yüksek kademelere ise zaman içindeki toplam harcamayla çıkılır. Sınırlar modele göre değişir; Google, bunların AI Studio’da gösterildiğini ve kademeniz değiştikçe kendiliğinden güncellendiğini belirtiyor.

Ücretli planda Gemini ne kadar tutar

Tabloda Google’ın 28 Eylül 2026 itibarıyla üç güncel model için yayımladığı, 200.000 token’a kadar olan istemlere ait ücretli plan fiyatları ve 2.000 giriş, 600 çıkış token’lık tipik bir sohbet mesajının tahmini maliyeti var. Gemini 3.8 Flash’ın fiyatının tarihe bağlı olduğuna dikkat edin: Google, 31 Aralık 2026’ya kadar giriş için $0,75, çıkış için $3,75; 1 Ocak 2027’den itibaren giriş için $1,50, çıkış için $7,50 listeliyor.

Gemini 3.8 Flash için hesap şöyle: 2.000 × $0,75 / 1.000.000 + 600 × $3,75 / 1.000.000 = $0,00375, yani yarım sentin altı. Önceki turlar giriş olarak yeniden gönderildiği için uzun konuşmalar mesaj başına daha pahalıdır. Kesin tutar Google’ın faturasıdır.

3. adım: Anahtarı Oriveo’ya ekleyin

Oriveo; iPhone, Android ve webde kendi anahtarlarınızla çalışan, çok modelli bir sohbet uygulaması. Google Gemini, 15 resmi sağlayıcısından biri ve doğrudan sağlayıcılar arasında. Aşağıdaki adımlar uygulamadaki menü adlarına göre yazıldı.

Devam ettiğinizde Oriveo, Google’dan anahtarın erişebildiği modelleri isteyerek anahtarı doğrular, sonra bu listeyi eşitler. Google’ın reddettiği bir anahtar hemen bildirilir; böylece sohbete başlamadan düzeltebilirsiniz.

4. adım: Model seçin ve sohbet edin

Bağlantı kurulunca Gemini modelleri model seçicide görünür. Flash modeller hızlı ve ucuz; günlük sohbetlerin çoğuna yeter. Pro modeller daha zor akıl yürütme ve uzun analizler için. Anahtarınız ücretsiz plandaysa fiyat sayfasında ücretsiz işaretli modellere bağlı kalın. Yalnızca ücretli modeller, faturalandırma yokken hata verir.

Konuşmanın ortasında başka bir modele, bağladığınız başka bir sağlayıcının modeline bile geçebilir ve aynı konuşmadan devam edebilirsiniz. Her mesajın yanında Google’ın yayımladığı fiyattan tahmini bir maliyet görünür. Ücretsiz planda, ücretsiz modellerin gerçek maliyetinin sıfır olduğunu, asıl sınırın hız sınırı olduğunu unutmayın.

Sık karşılaşılan hatalar ve anlamları

Gemini hataları genellikle nedeni gösterecek kadar açıktır.

• "API key not valid": Anahtar eksik kopyalanmış, silinmiş ya da kısıtlanmış. AI Studio’dan yeniden kopyalayın ya da yenisini oluşturun.
• Hız sınırı ya da kaynak tükendi: O model için projenizin dakikalık ya da günlük sınırına ulaştınız. Bekleyin, model değiştirin ya da daha yüksek sınırlar için faturalandırmayı bağlayın.
• Model planınızda yok: Bazı modeller yalnızca ücretli. Projeye faturalandırma bağlayın ya da ücretsiz bir model seçin.
• Birkaç anahtar birlikte sınıra takılıyor: Sınırlar proje başınadır; aynı projedeki anahtarlar onları paylaşır.

Anahtarınızı güvende tutmak

Faturalandırma bağlandığında bir Gemini anahtarı para harcayabilir, ondan önce de ücretsiz kotanızı tüketebilir. Oriveo sağlayıcı anahtarlarını hesap kaydı olarak değil, cihazınızda ya da tarayıcınızda tutar. iPhone ve Android uygulamaları istekleri doğrudan Google’a gönderir. Web uygulaması ise anahtarı ve BYOK sohbet içeriğini saklamayan, gerçek zamanlı bir aktarma uç noktası kullanır. Oriveo, Google’ın fiyatlarına pay eklemez.

Sohbet uygulamanız için ayrı bir proje ya da anahtar kullanın, kullanımı AI Studio’da ve Cloud konsolunda izleyin, ifşa olmuş her anahtarı silin.