Gemini API anahtarı nasıl alınır — Google AI Studio ve Kunavo

Gemini API anahtarı, Google'ın Gemini modellerine yapılan çağrıları doğrulayan bir bearer kimlik bilgisidir. Anahtar almanın iki yolu vardır — Google AI Studio'dan resmi anahtar almak veya Kunavo'da Gemini, Claude, GPT, görüntü ve videoyu tek bir OpenAI uyumlu anahtarla çağırmak (Google Cloud projesi gerekmez). Bu rehber iki yolu karşılaştırır ve üretimde hemen çağrı yapmaya başlamanın en hızlı yolunu gösterir.

Yöntem 1 — Google AI Studio (resmi)

Yalnızca Gemini çağrısı yapmayı planlıyorsanız anahtarı doğrudan Google'dan almak uygundur.

1. aistudio.google.com adresine gidip Google hesabınızla giriş yapın.
2. Get API key → Create API key seçenekleriyle anahtar oluşturun. Anahtar AIza... biçimindedir.
3. Prototipleme için ücretsiz katman istek sınırlarına sahiptir ve ilk geliştirme için uygundur.
4. Üretim hacmini işlemek için anahtarı faturalandırması etkin bir Google Cloud faturalandırma hesabına bağlamanız gerekir.

İleride çağıracağınız tek model Gemini olacaksa bu yol uygundur. Ancak Claude veya görüntü/video modellerini de kullanacaksanız her sağlayıcı için ayrı anahtar, SDK ve fatura yönetmeniz gerekir.

Yöntem 2 — Kunavo (üretim için önerilir)

Kunavo, Gemini'yi OpenAI uyumlu bir uç noktanın arkasında sunar. Tek bir sk-kn- anahtarıyla tüm modelleri çağırıp tek bir Stripe bakiyesiyle ödeme yaparsınız; bu nedenle Google Cloud projesi gerekmez. Gemini, Google'ın liste fiyatından yaklaşık 70% daha ucuzdur; bakiye süresizdir ve minimum 10 $ yükleme ile kullandıkça ödersiniz.

1. Kayıt — kunavo.com'da hesap oluşturun.
2. 10 $ yükleme — kullandıkça ödersiniz ve bakiye süresizdir.
3. Anahtar oluşturma — /app/keys adresinde anahtar oluşturun. Anahtar sk-kn- ile başlar ve yalnızca bir kez gösterilir; bu nedenle ortam değişkenine kaydedin.
4. Çağrı — OpenAI SDK'sının base_url değerini https://api.kunavo.com/v1 olarak ayarlayıp Gemini slug'ını çağırın.

Hızlı başlangıç

Resmi OpenAI SDK'sını olduğu gibi kullanın. Yalnızca base_url ve model adını değiştirmeniz yeterlidir — başka hiçbir değişiklik gerekmez.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # 바뀌는 건 이 줄뿐입니다
)

# 모델 슬러그만 바꾸면 Claude, GPT 등 다른 모델도 같은 키로 호출됩니다
resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "두 문장으로 자기소개를 해줘."}],
)
print(resp.choices[0].message.content)

Anahtarları güvenle yönetme

• Ortam değişkenlerini kullanın. Anahtarı kod içine sabitlemeyin; KUNAVO_API_KEY gibi bir ortam değişkeninde saklayın. Tarayıcı ve mobil paketler herkese açık olduğundan anahtarı asla istemciye açmayın ve her zaman kendi sunucunuz üzerinden proxy'leyin.
• Düzenli olarak yenileyin. Kunavo birden fazla etkin anahtara izin verir; böylece yenilemeyi ani bir geçiş yerine temiz bir örtüşme olarak yapabilirsiniz. Üç ayda bir yenileme önerilir.
• Anahtar başına harcama sınırı belirleyin. Kontrol panelinde her anahtar için harcama sınırı belirleyin ve /app/usage bölümünde anahtar bazında kullanımı izleyin. Böylece bir anahtar sızsa bile diğer anahtarları etkilemeden iptal edebilirsiniz.

Sık sorulan sorular