Gemini API anahtarı — nasıl alınır ve OpenAI SDK ile kullanılır

Gemini API anahtarı, Google’ın Gemini modellerine yaptığınız çağrıları doğrular: her istek anahtarı Authorization üst bilgisinde taşır ve platform kullanımı bunun üzerinden ölçüp ücretlendirir. Gemini API anahtarı almanın iki yolu vardır — doğrudan Google AI Studio üzerinden (resmî yol) veya Kunavo üzerinden: Google Cloud projesi olmadan Gemini’nin yanı sıra Claude, GPT ve görüntü/video modellerine ulaşan OpenAI uyumlu bir anahtar.

Seçenek 1 — Google AI Studio (resmî)

Şimdiye kadar çağıracağınız tek model Gemini olacaksa anahtarı doğrudan Google’dan alın:

1. aistudio.google.com adresini açın ve bir Google hesabıyla giriş yapın.
2. Get API key → Create API key yoluna gidin. Anahtarlar AIza… ile başlar ve yalnızca bir kez görüntülenir.
3. Ücretsiz katmanın hız limiti vardır ve prototip oluşturmak için uygundur. Production için anahtarı bir Google Cloud faturalandırma hesabına bağlayın.

Yalnızca Gemini’ye ihtiyacınız olduğu sürece doğru yol budur. Claude, GPT veya görüntü ve video modellerini de kullanmaya başladığınızda her sağlayıcı için bir anahtar, SDK ve fatura yönetirsiniz.

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

Kunavo, Gemini’yi OpenAI uyumlu bir API’nin arkasına yerleştirir. Tek bir sk-kn- anahtarıyla aynı uç noktadaki tüm modellere erişilir — Google Cloud projesi gerekmez; Gemini’nin fiyatı Google’ın liste fiyatından yaklaşık %70 daha düşüktür (1 milyon token başına $0,09 / $0,75). Tek bir Stripe bakiyesiyle, $10 tutarında yüklemeden başlayarak kullandıkça ödeme yapılır. Bakiye Gemini, Claude, GPT, görüntü ve videonun tamamını kapsar ve hiçbir zaman sona ermez.

1. Kayıt olun. kunavo.com üzerinden bir Kunavo hesabı oluşturun.
2. $10 yükleyin. Minimum $10 yüklemeyle kullandıkça ödeyin; bakiyenin süresi hiçbir zaman dolmaz.
3. Anahtarı oluşturun. /app/keys içinde bir anahtar oluşturun. sk-kn- ile başlar ve yalnızca bir kez görüntülenir — bir ortam değişkeninde saklayın.
4. Çağrı yapın. OpenAI SDK’sını https://api.kunavo.com/v1 adresine yönlendirin ve bir Gemini slug’ı çağırın.

Hızlı başlangıç

Resmî OpenAI SDK’sını koruyun. Yalnızca base_url ve model adını değiştirmeniz yeterlidir — başka hiçbir şey değişmez.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # la seule ligne qui change
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Résume l'intrigue de Dune en deux phrases."}],
)
print(resp.choices[0].message.content)

Aynı yaklaşım Node.js ve curl için de geçerlidir; model bazında fiyatlar ve ayrıntılı örnekler Gemini API fiyatlandırma kılavuzunda bulunur.

Anahtarı güvende tutma

• Kaynak kodu yerine ortam değişkenleri. Anahtarı hiçbir zaman depoya commit etmeyin; bir ortam değişkeninden okuyun. Anahtarı asla tarayıcı veya mobil paketinde açığa çıkarmayın — her zaman kendi sunucunuz üzerinden geçin.
• Proje veya ortam başına bir anahtar. Sızdırılan bir anahtar böylece başka hiçbir şeyi bozmadan iptal edilebilir.
• Düzenli rotasyon. Kunavo birden fazla etkin anahtara izin verir; bu nedenle rotasyon ani bir kesinti değil, sorunsuz bir örtüşme sürecidir.
• Anahtar başına harcama limitleri. Kontrol panelinde anahtar bazında limitler belirleyin ve /app/usage içinde anahtar bazındaki beklenmeyen trafiği izleyin.

Sık sorulan sorular