Gemini API anahtarı nasıl alınır

Adım adım Google'dan anahtar alma

1. aistudio.google.com/apikey adresinden Google AI Studio'yu açın ve bir Google hesabıyla oturum açın.
2. API anahtarı oluştur'a tıklayın. Her anahtar bir Google Cloud projesine bağlıdır. Yeni kullanıcılar için varsayılan bir proje oluşturulur; zaten Google Cloud kullanıyorsanız bir proje seçin veya oluşturun.
3. Anahtarı kopyalayın ve güvenli bir yerde saklayın. 28 Mayıs 2026'dan itibaren yeni anahtarlar kimlik doğrulama anahtarı olarak oluşturulur: bir hizmet hesabına bağlanır ve baştan yalnızca Gemini API ile sınırlandırılır.
4. Ortam değişkeni olarak ayarlayın. Google SDK'ları GEMINI_API_KEY veya GOOGLE_API_KEY değişkenini okur; ikisi de ayarlıysa GOOGLE_API_KEY önceliklidir.

Eski bir anahtarınız mı var? Gemini API, kısıtlanmamış standart anahtarları reddeder. AI Studio'da anahtarın Kısıtlanmamış etiketinin üzerine gelin, Kısıtlama ekle seçeneğini seçin ve anahtarı yalnızca Gemini API ile sınırlandırın.

Anahtarı test edin

Gemini, OpenAI biçimindeki isteklere de yanıt verir; bu sayede hızlıca test edebilirsiniz. Yerel API isteklerinde ise anahtar x-goog-api-key başlığında gönderilir.

export GEMINI_API_KEY="your-key"
curl https://generativelanguage.googleapis.com/v1beta/openai/chat/completions \
  -H "Authorization: Bearer $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gemini-3.8-flash",
       "messages": [{"role": "user", "content": "Say hello"}]}'

Ücretsiz kademe ve karşılığında verdikleriniz

Yeni bir anahtar, kart gerektirmeden ücretsiz kademede çalışır. Bu kademe; Flash ve Flash-Lite modellerini, Gemini 2.5 Pro'yu, metinden konuşmaya ve Live modellerini ve embeddings'i kapsar. Hız limitleri ücretli kademelere göre daha düşüktür. Gemini 4 Argon, Gemini 3.1 Pro ve görsel modelleri için faturalandırmanın etkin olması gerekir.

Karşılığında şunu kabul edersiniz: Google, ücretsiz kademede gönderdiğiniz verileri ve aldığınız yanıtları ürünlerini geliştirmek için kullanır; insan incelemeciler de bunları okuyabilir. Ücretli kademede bunu yapmaz. Ücretsiz anahtarla kişisel veya gizli veri göndermeyin.

Faturalandırmayı etkinleştirin

AI Studio'da projenin Faturalandırmayı ayarla seçeneğini seçin, bir Cloud faturalandırma hesabı bağlayın ve en az $5 ön ödeme yapın. Ödediğiniz tutar arttıkça harcama üst limitleri yükselir:

Ardından her istek token başına ücretlendirilir. 1M token başına liste fiyatları:

Google AI Pro veya Ultra API'yi kapsıyor mu?

Hayır. Google AI planının avantajları yalnızca AI Studio web sitesinde geçerlidir; Gemini API'ye anahtarla yapılan çağrılar Google Cloud üzerinden ayrıca ücretlendirilir.

Anahtarınızı güvende tutun

• Anahtarı sunucuda tutun. Bir web sayfasındaki veya uygulamadaki anahtar kopyalanıp faturalandırma hesabınızdan harcama yapmak için kullanılabilir.
• Her anahtarı yalnızca Gemini API ile kullanılacak şekilde kısıtlayın ve her uygulama için ayrı bir proje kullanın.
• Ücretli kullanım hesabınıza faturalandırıldığı için Google Cloud faturalandırma ayarlarında bir bütçe uyarısı oluşturun.

Başka bir yol: Claude ve GPT ile aynı anahtarda Gemini

Zurelay'de Gemini, OpenAI uyumlu bir anahtarla erişebileceğiniz modellerden biridir; ücretler ön ödemeli bakiyenizden düşülür, Cloud faturalandırma hesabı gerekmez (Gemini 3.8 Flash için Google'ın liste fiyatından %71 daha düşük):

from openai import OpenAI
client = OpenAI(base_url="https://api.zurelay.com/v1", api_key="YOUR_ZURELAY_KEY")
reply = client.chat.completions.create(
    model="gemini-3.8-flash",
    messages=[{"role": "user", "content": "Say hello"}],
)
print(reply.choices[0].message.content)

Zurelay'de ücretsiz katman yoktur; bakiye yükleme tutarı $10'dan başlar. Ücretsiz katman ihtiyacınızı karşılıyorsa Google'ın kendi anahtarıyla başlamak daha ucuzdur. Tüm modeller için Gemini API fiyatlandırmasına bakın.

Adımlar, ücretsiz katman ve faturalandırma bilgileri, 28 Ekim 2026 tarihinde Google'ın API anahtarı, pricing, istek limitleri, terms ve Google AI planları sayfalarından alınmıştır.