Gemini API anahtarı alma — Google AI Studio ve Kunavo ile adım adım

Bir Gemini API anahtarı, Google'ın Gemini modellerine yaptığınız çağrıları doğrulayan bir bearer kimlik bilgisidir. Anahtarı almanın iki yolu vardır: doğrudan Google AI Studio'dan (resmi yol) ya da Kunavo üzerinden — Gemini, Claude, GPT ve görsel/video için tek bir OpenAI-uyumlu anahtar, üstelik Google Cloud projesi kurmadan. Bu rehber her iki yolu da adım adım gösterir ve Gemini'yi dakikalar içinde çağırmanızı sağlar.

Seçenek 1 — Google AI Studio (resmi)

Yalnızca Gemini'yi kullanacaksanız doğrudan Google'dan bir anahtar alabilirsiniz:

1. aistudio.google.com adresine bir Google hesabıyla giriş yapın.
2. Get API key → Create API key yolunu izleyin. Anahtarlar AIza... ile başlar.
3. Prototipleme için hız sınırlı, sınırlı bir ücretsiz katman vardır.
4. Üretim hacmi için anahtarı, faturalandırması etkin bir Google Cloud projesine bağlamanız gerekir.

Bu, Gemini'nin çağıracağınız tek model olduğu durumlarda doğru yoldur. Ayrıca Claude, görsel veya video modellerini de kullanıyorsanız, sağlayıcı başına ayrı bir anahtar, SDK ve fatura yönetmek zorunda kalırsınız.

Seçenek 2 — Kunavo (üretim için önerilir)

Kunavo, Gemini'yi OpenAI-uyumlu bir API arkasında sunar. Tek bir sk-kunavo- anahtarı Gemini'ye ve diğer her modele (OpenAI-uyumlu uç nokta üzerinden) ulaşır — Google Cloud projesi yoktur. Gemini, Google listesinin yaklaşık %70 altında fiyatlandırılır, tek bir Stripe bakiyesi her şeyi kapsar ve $5'tan kullandıkça öde modeliyle başlarsınız.

1. Bir Kunavo hesabı oluşturup $5 yükleyin — kullandıkça öde, bakiye asla sona ermez.
2. /app/keys sayfasında bir anahtar oluşturun. Anahtar yalnızca bir kez gösterilir; bir ortam değişkeninde saklayın.
3. OpenAI SDK'sını https://api.kunavo.com/v1 adresine yönlendirin ve bir Gemini slug'ı çağırın.
4. Çağırın — model alanını gemini-2-5-flash gibi bir değerle gönderin, hepsi bu.

Hızlı başlangıç

Resmi OpenAI SDK'sını korursunuz. Yalnızca base_url ve model adını değiştirin — başka hiçbir şeyi değil:

import os
from openai import OpenAI

# Resmi OpenAI SDK'sını koruyun; yalnızca base_url ve model değişir.
client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # değişen tek satır
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Merhaba Gemini, kendini bir cümleyle tanıt."}],
)
print(resp.choices[0].message.content)

Anahtarını güvende tut

• Anahtarı asla istemci tarafında açığa çıkarma. Tarayıcı ve mobil paketler herkese açıktır — her zaman kendi sunucunuz üzerinden proxy'leyin. Anahtarları .env dosyalarında ve ortam değişkenlerinde tutun, asla kaynak koduna gömmeyin.
• Proje veya ortam başına ayrı anahtar kullanın ki bir sızıntı, diğer her şeyi devre dışı bırakmadan iptal edilebilsin.
• Düzenli rotasyon yapın. Kunavo aynı anda birden çok canlı anahtara izin verir; böylece rotasyon, sert bir kesinti yerine temiz bir geçiş örtüşmesi olur.
• Anahtar başına harcama limitleri belirleyin. Pano üzerinden her anahtar için limit koyup beklenmedik trafiği /app/usage sayfasında anahtar bazında izleyin.

SSS

Gemini API ücretsiz mi?

Google AI Studio, düşük hız sınırlarıyla prototipleme için uygun bir ücretsiz katman anahtarı verir; üretim trafiği ücretli faturalandırmaya geçer. Kunavo'da ise $5 minimum yükleme ile kullandıkça öde modeli geçerlidir, ayrı bir Google Cloud faturalandırma hesabı gerekmez ve bakiye asla sona ermez.

Google Cloud hesabı olmadan Gemini anahtarı alabilir miyim?

Evet. Kunavo, Gemini'yi OpenAI-uyumlu bir API arkasında sunduğundan bir Google Cloud projesi veya faturalandırma hesabı kurmanıza gerek yoktur. Kaydolun, bir sk-kunavo- anahtarı oluşturun ve gemini-2-5-flash gibi bir modeli çağırın.

Gemini anahtarı ile Kunavo anahtarı arasındaki fark nedir?

Bir Google anahtarı yalnızca Gemini'yi çağırır ve Google Cloud hesabı üzerinden faturalandırılır. Bir Kunavo anahtarı ise Gemini ile birlikte Claude, GPT ve görsel/video modellerini tek bir OpenAI-uyumlu API üzerinden çağırır ve tek bir Stripe bakiyesinden faturalandırılır.

Hangi Gemini modeliyle başlamalıyım?

Günlük sohbet, çıkarım ve özetleme için gemini-2-5-flash ile başlayın — hızlı ve son derece ucuzdur. Daha zor akıl yürütme, görsel ve uzun bağlam analizi için gemini-2-5-pro'ya geçin. Model bazlı oranlar ve örnek maliyet hesapları için Gemini API fiyatlandırma rehberine bakın.