Gemini API anahtarı alma — Google AI Studio ve Kunavo ile iki yöntem

Gemini API anahtarı, Google'ın Gemini modellerine yapılan çağrıları doğrulayan bir bearer kimlik bilgisidir. Bunu elde etmenin iki yolu vardır — Google AI Studio'dan (resmî) almak veya tek bir Kunavo OpenAI uyumlu anahtarıyla Gemini, Claude, GPT ve görüntü/video modellerine topluca ulaşmak (Google Cloud projesi gerekmez). Bu kılavuzda her iki yöntemin adımlarını ve üretimde hangisinin seçilmesi gerektiğini açıklıyoruz.

Yöntem 1 — Google AI Studio (resmî)

Yalnızca Gemini kullanacaksanız anahtarı doğrudan Google'dan almak en doğru yoldur.

1. aistudio.google.com adresinde Google hesabınızla oturum açın.
2. API anahtarı al → API anahtarı oluştur seçeneğini açın. Anahtar AIza... gibi bir biçimdedir.
3. Prototipler için hız sınırları olan ücretsiz katmanı kullanabilirsiniz. Üretim hacminde anahtarı, faturalandırması etkinleştirilmiş bir Google Cloud projesine bağlamanız gerekir.

Çağıracağınız model yalnızca Gemini ise doğru yol budur. Ancak Claude veya görüntü/video modellerini de kullanacaksanız her sağlayıcı için ayrı anahtarları, SDK'ları ve faturaları yönetmeniz gerekir.

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

Kunavo, Gemini'yi OpenAI uyumlu bir API'nin arkasında sunar. Tek bir sk-kn- anahtarıyla Gemini'ye ve diğer tüm modellere ulaşabilirsiniz; Google Cloud projesi gerekmez ve ödemeler Stripe'taki tek bir bakiyede birleştirilir. Gemini, Google'ın liste fiyatından yaklaşık %70 daha ucuzdur ve 10 dolardan başlayan kullandıkça öde modeliyle kullanmaya başlayabilirsiniz.

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

Her iki yöntemin hangisinin daha iyi olduğu Gemini API anahtarı belgelerindeki karşılaştırma tablosunda da görülebilir. Fiyat ayrıntıları için Gemini API fiyatlandırma kılavuzuna bakın.

Hızlı başlangıç

Resmî OpenAI SDK'sını aynen kullanın. Yalnızca base_url ve model adını değiştirin.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # 変更するのはこの 1 行だけ
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",  # Gemini モデルのスラッグを指定
    messages=[{"role": "user", "content": "Gemini を一文で説明して。"}],
)
print(resp.choices[0].message.content)

Anahtarları güvenli yönetme

• Ortam değişkenlerini kullanın. Anahtarı doğrudan koda yazmayın; KUNAVO_API_KEY gibi bir ortam değişkeninden okuyun. Tarayıcı ve mobil paketler herkese açık olduğundan anahtarı istemci tarafına açığa çıkarmayın; her zaman kendi sunucunuz üzerinden proxy kullanın.
• Düzenli olarak yenileyin. Kunavo aynı anda birden fazla etkin anahtara izin verdiğinden, yenileme sert bir geçiş yerine temiz bir örtüşmeyle yapılabilir. Üç ayda bir yenileme iyi bir ölçüttür.
• Her anahtar için sınır belirleyin. Gösterge panelinde anahtar başına sınırlar belirleyin; proje ve ortam başına ayrı anahtarlar kullanırsanız bir sızıntı olduğunda tüm sistemi durdurmadan yalnızca ilgili anahtarı iptal edebilirsiniz. /app/usage üzerinden anahtar bazındaki trafiği izleyin.

Sık sorulan sorular