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

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

Seçenek 1 — Google AI Studio (resmi)

Yalnızca Gemini'yi çağıracaksanız doğru yol budur.

1. Bir Google hesabıyla aistudio.google.com adresine giriş yapın.
2. Get API key → Create API key seçeneklerini açın. Anahtarlar AIza... biçimindedir.
3. Ücretsiz katman sınırlıdır ve prototipler için uygundur. Üretim hacmi için anahtarı, etkinleştirilmiş faturalandırma hesabı bulunan bir Google Cloud projesine bağlamanız gerekir.

Claude, görüntü veya video da kullanıyorsanız bu yol, her sağlayıcı için ayrı bir anahtarı, SDK'yı ve faturayı yönetmenize neden olur.

Seçenek 2 — 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; Stripe aracılığıyla ücretlendirilen tek bir cüzdanınız olur ve Google Cloud projesi gerekmez. Gemini, Google'ın liste fiyatından yaklaşık 70% daha ucuzdur — örneğin Flash, 1 milyon giriş tokenı için $0,09, 1 milyon çıkış tokenı için $0,75 tutar. En az $10 bakiye yüklemeyle başlayan kullandıkça öde modelidir ve bakiyenin süresi hiçbir zaman dolmaz.

1. kunavo.com adresinde kaydolun.
2. $10 yatırın — kullandıkça öde; bakiye hiçbir zaman sona ermez.
3. /app/keys üzerinde bir anahtar oluşturun. Anahtar sk-kn- ile başlar ve yalnızca bir kez gösterilir; onu bir ortam değişkeninde saklayın.
4. Çağrı yapın: OpenAI SDK'sını https://api.kunavo.com/v1 adresini gösterecek şekilde yapılandırın 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 — başka hiçbir şeyi değil:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # a única linha que muda
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Explique RAG em duas frases."}],
)
print(resp.choices[0].message.content)

Anahtar güvenliği

• Anahtarı istemci tarafında asla açığa çıkarmayın. Tarayıcı ve mobil bundle'lar herkese açıktır — her zaman kendi sunucunuz üzerinden proxy kullanın. Anahtarı, sürüm denetimindeki kodun dışında, ortam değişkenlerinde saklayın.
• Proje veya ortam başına bir anahtar kullanın; böylece bir sızıntı olduğunda geri kalanını durdurmadan anahtarı iptal edebilirsiniz.
• 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.
• Dashboard'da anahtar başına harcama sınırları belirleyin ve anahtara göre ayrıntılı şekilde gösterilen /app/usage değerini izleyerek beklenmeyen trafiği yakalayın.

Sık sorulan sorular