Dokümantasyon

Dokümantasyon

Gemini API anahtarı

OpenAI uyumlu bir uç nokta üzerinden Gemini Pro ve Flash modellerini çağırmak için Gemini API anahtarının nasıl alınacağı — Google AI Studio'ya doğrudan bağlanma yöntemi ve ayrıca Claude, GPT-Image, Veo ve Suno'ya erişen tek anahtarlı Kunavo yöntemi.

Gemini API anahtarı, Google'ın Gemini modellerine yapılan çağrıları doğrular. Anahtarı doğrudan Google AI Studio'dan alabilir veya Gemini'ye, diğer tüm işlemleriniz için kullandığınız aynı OpenAI uyumlu API üzerinden erişen tek bir sk-kn- anahtarı kullanabilirsiniz.

Kısaca — Kaydolun, /app/keys adresinde bir anahtar oluşturun, base_url=https://api.kunavo.com/v1 değerini ayarlayın ve ardından model="gemini-2-5-flash" çağrısı yapın. Google Cloud projesi gerekmez; aynı anahtar Claude, GPT-Image ve Veo için de çalışır.

Gemini API anahtarı nedir?

Gemini API anahtarı, Google'ın Gemini ailesine yönelik istekleri yetkilendiren bir bearer kimlik bilgisidir. Her istekte anahtar bir Authorization başlığında gönderilir; platform kullanımı bu anahtar üzerinden ölçer ve token başına ücret alır. Kunavo'da bugün bu, OpenAI uyumlu uç nokta üzerinden çağrılan gemini-3-1-pro ve gemini-2-5-flash anlamına gelir.

Kullanılabilir bir anahtar edinmenin iki yolu vardır; tercih, yalnızca Gemini'yi mi yoksa Gemini'yi diğer öncü modellerle birlikte mi kullanmak istediğinize bağlıdır.

Seçenek A — doğrudan Google AI Studio'dan alınan anahtar

  1. aistudio.google.com adresine gidin ve Google hesabınızla oturum açın.
  2. Get API key → Create API key seçeneğini açın. Anahtarlar AIza... biçimindedir.
  3. Üretim hacmi için anahtarı faturalandırması etkinleştirilmiş bir Google Cloud projesine bağlayın.

Gemini'yi kullanacağınız tek model olarak düşünüyorsanız doğru seçenek budur. Claude'u ya da görsel veya video modellerini de kullanıyorsanız her sağlayıcı için ayrı bir anahtar, SDK ve fatura yönetmeniz gerekir.

Seçenek B — Gemini ve diğer her şey için tek Kunavo anahtarı

Kunavo, bağımsız ve OpenAI uyumlu bir AI API ağ geçididir: Tek bir API anahtarı ve kullandıkça öde bakiyesiyle Claude, GPT ve görüntü, video ve ses modellerine, sağlayıcı başına hesap gerekmeksizin erişebilirsiniz.

Kunavo, Gemini'yi OpenAI uyumlu bir API üzerinden sunar. Tek bir sk-kn- anahtarı Gemini'ye ve diğer tüm modellere erişim sağlar; faturalandırma Stripe üzerinden tek bir bakiye ile yapılır.

Google AI Studio anahtarıKunavo anahtarı
ModellerYalnızca GeminiGemini + Claude, GPT-Image, Veo, Suno
Uç noktaGoogle GenAI APIhttps://api.kunavo.com/v1
FaturalandırmaGoogle Cloud hesabıTek Stripe cüzdanı
Başlamak için gereken en düşük tutarÜcretsiz katman (hız sınırlı)$10 bakiye yükleme; süresi dolmaz
Anahtar biçimiAIza...sk-kn-...
  1. Bir Kunavo hesabı oluşturup $10 bakiye yükleyin — kullandıkça ödeyin, bakiyenin süresi dolmaz.
  2. /app/keys adresinde bir anahtar oluşturun. Anahtar yalnızca bir kez gösterilir; bir ortam değişkeninde saklayın.
  3. OpenAI SDK'sını https://api.kunavo.com/v1 adresine yönlendirin ve bir Gemini kısa adıyla çağrı yapın.

Gemini'yi Python ile çağırın

Resmi OpenAI SDK'sını kullanmaya devam edin. base_url değerini ve model adını değiştirin — başka hiçbir şeyi değiştirmeniz gerekmez.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # the only line that changes
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Summarize the plot of Dune in two sentences."}],
)
print(resp.choices[0].message.content)

Gemini'yi Node.js ile çağırın

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.KUNAVO_API_KEY,
  baseURL: "https://api.kunavo.com/v1",
});

const resp = await client.chat.completions.create({
  model: "gemini-2-5-flash",
  messages: [{ role: "user", content: "Summarize the plot of Dune in two sentences." }],
});
console.log(resp.choices[0].message.content);
OpenAI SDK'sı Node.js'te baseURL, Python'da base_url kullanır. Her ikisi de aynı uç noktaya yönelir.

Ya da curl ile çağırın

curl https://api.kunavo.com/v1/chat/completions \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2-5-flash",
    "messages": [{"role": "user", "content": "Hello, Gemini"}]
  }'

Hangi Gemini modelini kullanmalı?

  • gemini-2-5-flash — sohbet, bilgi çıkarma ve özetleme için hızlı ve son derece ucuz varsayılan seçenek.
  • gemini-3-1-pro — daha güçlü akıl yürütme, görüntü işleme ve uzun bağlam analizi.
Model başına ücretler ve örnek maliyet hesapları için Gemini API fiyatlandırma kılavuzuna ve fiyatlandırma sayfasına bakın.

Güvenlik kontrol listesi

  • Bir anahtarı asla istemci tarafında açığa çıkarmayın. Tarayıcı ve mobil paketler herkese açıktır — her zaman kendi sunucunuz üzerinden proxy kullanın.
  • Her proje veya ortam için ayrı bir anahtar kullanın; böylece bir anahtar sızarsa diğerlerini devre dışı bırakmadan o anahtarı iptal edebilirsiniz.
  • Üç ayda bir yenileyin. Kunavo aynı anda birden fazla etkin anahtara izin verir; bu nedenle yenileme, kesintisiz bir geçiş sağlar.
  • Anahtara göre ayrıntılandırılmış beklenmedik trafik için /app/usage sayfasını izleyin.

SSS

Gemini API anahtarı ücretsiz mi?

Google AI Studio, prototip oluşturmaya uygun, düşük hız sınırlarına sahip ücretsiz katman anahtarı verir. Üretim trafiği için ücretli faturalandırmaya geçilir. Kunavo'da kullanıma göre ödeme yapılır; en düşük bakiye yükleme tutarı $10'dır, ayrıca Google Cloud faturalandırma hesabı gerekmez ve bakiyenizin süresi dolmaz.

Gemini'yi OpenAI SDK ile kullanabilir miyim?

Evet. Kunavo, Gemini'yi OpenAI uyumlu /v1/chat/completions uç noktası üzerinden sunar. Böylece resmi OpenAI SDK'sını kullanmaya devam edip yalnızca base_url değerini https://api.kunavo.com/v1 olarak değiştirir ve model adını gemini-2-5-flash gibi bir Gemini kısa adına ayarlarsınız.

Google Gemini API anahtarı ile Kunavo API anahtarı arasındaki fark nedir?

Google anahtarı yalnızca Gemini'yi çağırır ve Google Cloud hesabınız üzerinden ücretlendirilir. Kunavo anahtarı, tek bir OpenAI uyumlu API üzerinden Gemini, Claude, GPT-Image, Veo ve Suno'yu çağırır; faturalandırma Stripe üzerinden tek seferde yapılır.

Hangi Gemini modeliyle başlamalıyım?

Günlük sohbet, bilgi çıkarma ve özetleme için gemini-2-5-flash ile başlayın; hızlı ve son derece ucuzdur. Daha zor akıl yürütme, görüntü işleme ve uzun bağlam analizi için gemini-3-1-pro modeline geçin.

Sonraki adımlar