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

Bir Gemini API anahtarı, Google'ın Gemini modellerine yaptığınız çağrıları doğrulayan kimlik bilgisidir: her istek anahtarı Authorization üst bilgisinde taşır ve kullanım token başına ölçülüp ücretlendirilir. Çalışan bir anahtar edinmenin iki yolu vardır: yalnızca Gemini'ye özel bir anahtar veren resmi Google AI Studio veya tek bir OpenAI uyumlu anahtarla Gemini, Claude, GPT ve görüntü, video ve ses modellerine erişmenizi sağlayan Kunavo; Google Cloud projesi gerekmez. Bu kılavuz, her iki yoldan anahtar edinmeyi ve ilk çağrıyı yapmayı gösterir.

1. seçenek — Google AI Studio (resmi)

Çağıracağınız tek model Gemini ise doğru yol budur.

1. Google hesabınızla aistudio.google.com adresinde oturum açın.
2. Get API key → Create API key seçeneğini açın. Anahtar şu biçimdedir: AIza....
3. Ücretsiz katman sınırlıdır ve prototipler için uygundur. Üretim hacmi için anahtarın etkin bir faturalandırma hesabı bulunan bir Google Cloud projesine bağlanması gerekir.

Claude, görüntü veya video da kullanıyorsanız bu yol, her sağlayıcı için ayrı bir anahtar, SDK ve fatura yönetmenizi gerektirir.

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

Kunavo, Gemini'yi OpenAI uyumlu bir API'nin arkasında sunar. Tek bir sk-kn- anahtarı Gemini'yi ve diğer tüm modelleri çağırır; ücretlendirme Stripe üzerinden tek bir cüzdandan yapılır ve hiçbir Google Cloud projesi gerekmez. Gemini, Google'ın resmi liste fiyatından yaklaşık 70% daha ucuzdur — örneğin Flash, 1 milyon giriş token'ı başına $0,09, çıkış token'ı başına 1 milyon için $0,75 tutar. Kullanım başına ödeme minimum 10 $ yüklemeyle başlar ve bakiye hiçbir zaman geçerliliğini yitirmez.

1. kunavo.com'a kaydolun.
2. 10 $ yükleyin — kullanım başına ödeme, bakiye hiçbir zaman geçerliliğini yitirmez.
3. /app/keys adresinde anahtar oluşturun. Anahtar sk-kn- ile başlar ve yalnızca bir kez gösterilir; anahtarı 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'ı kullanın.

Hızlı başlangıç

Resmi OpenAI SDK'sını kullanmaya devam edin. 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",  # dòng duy nhất thay đổi
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Giải thích RAG trong hai câu."}],
)
print(resp.choices[0].message.content)

Anahtar güvenliği

• Anahtarı istemci tarafında asla açığa çıkarmayın. Tarayıcı ve mobil paketler herkese açıktır — her zaman kendi sunucunuz üzerinden proxy kullanın. Anahtarı, sürümlenen kodun dışında bir ortam değişkeninde saklayın.
• Proje veya ortam başına bir anahtar kullanın; böylece bir sızıntı diğerlerini devre dışı bırakmadan iptal edilebilir.
• Düzenli olarak anahtar rotasyonu yapın. Kunavo aynı anda birden fazla etkin anahtara izin verir; böylece rotasyon ani bir kesinti değil, sorunsuz bir geçiş olur.
• Kontrol panelinde anahtar başına harcama sınırı belirleyin ve anahtar bazında ayrıştırılmış beklenmedik trafiği tespit etmek için /app/usage değerini izleyin.

Sık sorulan sorular