Google AI Studio Nasıl Kullanılır? Gemini API Rehberi

Google’ın yapay zeka platformuna girişin en doğrudan yolu Google AI Studio. Kod yazmadan modeli test edebilir, API anahtarı alabilir, sistem talimatlarını deneyebilir ve ardından Python kodunuza entegre edebilirsiniz, hepsi tek bir arayüzden. Bu rehber, AI Studio’ya ilk kez giriş yapanlar için sıfırdan Python entegrasyonuna kadar adım adım ilerliyor.

Google AI Studio Nedir?

Google AI Studio, Gemini model ailesini tarayıcıdan test etmek ve Gemini API anahtarı almak için tasarlanmış ücretsiz geliştirici platformudur. Hesap oluşturmak için yalnızca bir Google hesabı gerekir; kredi kartı veya ücretli abonelik şartı yok.

Platform iki işlevi bir arada sunuyor: interaktif bir prompt mühendisliği ortamı ve API anahtarı yönetim paneli. Yeni bir API entegrasyonu kurmadan önce modelin nasıl davrandığını görmek istediğinizde burada deneyip ondan sonra koda geçebilirsiniz.

Gemini Ailesi ve AI Studio İlişkisi

Gemini, Google’ın geliştirdiği büyük dil modeli ailesidir. AI Studio bu ailenin farklı boyutlarına (Flash, Pro, Ultra) tek bir arayüzden erişim sunar. Her modelin hız, maliyet ve yetenek dengesi farklıdır. Küçük projelerde Flash yeterliyken, karmaşık çok adımlı görevlerde Pro daha tutarlı sonuçlar üretiyor.

Arayüz, modeller arası geçişi tek tıkla yapıyor: prompt’unuzu değiştirmeden aynı girişi farklı Gemini sürümleriyle test edebilirsiniz. Bu, hangi modelin projenize uygun olduğunu kararlaştırmak için özellikle işe yarıyor.

OpenAI Playground’dan Farkı

OpenAI Playground ile karşılaştırıldığında en belirgin fark ücretsiz kota boyutudur. Playground’da her API çağrısı token başına ücrete tabi. AI Studio’nun ücretsiz katmanı ise dakika başına belirli bir istek limitiyle çalışıyor: Gemini 2.0 Flash için dakikada 15 istek, günde 1.500 istek. Multimodal destek de daha bütünleşik: görsel, PDF ve ses girişi aynı arayüzde mevcut.

Hesap Oluşturma ve Giriş

Ön Koşullar

Başlamak için ihtiyacınız olanlar:

• Aktif bir Google hesabı (kişisel Gmail veya Workspace)
• Türkiye dahil desteklenen bir bölgede bulunmak
• Güncel bir tarayıcı: Chrome, Firefox veya Edge

Kurumsal Google Workspace hesaplarında yönetici politikaları AI Studio erişimini kısıtlamış olabilir. Bu durumda kişisel Gmail hesabıyla giriş yapmak daha doğrudan bir yol.

Arayüze İlk Bakış

aistudio.google.com adresinde Google hesabınızla oturum açtıktan sonra ana ekranda Create new prompt butonu sizi deney ortamına götürür; Get API key bağlantısı anahtarınızı oluşturduğunuz sayfaya açılır. Üst kısımdaki açılır menüden kullanmak istediğiniz Gemini modelini seçebilirsiniz.

Sol panel geçmiş oturumlarınızı listeler. Sağ panel temperature, top-p ve max output tokens gibi parametreleri gösterir.

Temel Araçlar: Prompt, Chat ve Stream

Tek Seferlik Prompt (Freeform)

Freeform modunda tek bir giriş yazıp tek bir yanıt alırsınız; önceki tur yoktur. Metin sınıflandırma, özetleme veya tek seferlik dönüşüm görevleri için en sade araç budur. Girişi metin olarak yazabileceğiniz gibi görsel, PDF veya ses dosyası da ekleyebilirsiniz; model her ikisini birlikte işler.

Çok Turlu Sohbet (Chat)

Chat modunda önceki turlar bağlamda kalır. Model yanıtlarına itiraz edebilir, ek soru sorabilir veya konuyu kaydırabilirsiniz. Gemini’nin geniş bağlam penceresi bu modda öne çıkar: Flash modeli 1 milyon token’a kadar bağlam taşıyabiliyor. Birden fazla tur gerektiren analizler veya iteratif kod geliştirme için Chat modu daha verimli.

Bir sohbet oturumunu kaydetmek için üst kısımdaki “Save” butonunu kullanabilirsiniz; kaydedilen oturumlar sol panelde görünür ve istediğiniz zaman devam edebilirsiniz.

Sistem Talimatı (System Instruction) Nasıl Yazılır?

Sistem talimatı, modele kim olduğunu ve nasıl davranması gerektiğini söyleyen arka plan mesajıdır. Kullanıcı mesajından önce işlenir ve tüm oturum boyunca aktif kalır. İyi bir sistem talimatı kısa ve net olmalı: rol, kısıtlamalar ve beklenen çıktı formatını birkaç cümleyle tanımlayabilirsiniz.

Sağ panelde “System instructions” alanını açın ve şu yapıyı deneyin:

Sen deneyimli bir Python geliştiricisisin. Tüm yanıtlarında kod örnekleri ver.
Açıklamalarını kısa tut, gerekmedikçe uzatma. Türkçe yaz.

Sistem talimatı olmayan oturumlarda model genel amaçlı davranır. Spesifik bir iş akışı için AI Studio kullanıyorsanız talimatı önceden tanımlamak yanıt kalitesini yükseltiyor.

Gemini API Anahtarı Alma

Sol panelde “Get API key” bağlantısını tıklayın. Açılan sayfada “Create API key” butonu yeni bir anahtar üretir. Anahtarı oluşturduktan hemen sonra kopyalayın; aynı ekranda tekrar gösterilmez (dilediğinizde silinip yeni biri oluşturulabilir).

Ücretsiz Kota Limitleri

2026 başı itibarıyla Gemini 2.0 Flash için ücretsiz kota:

Kaynak: Google AI Studio fiyatlandırma sayfası

Flash modeli için kota, öğrenme aşaması ve kişisel projeler için yeterli. Günde 1.500 istek aşılınca 429 hatası alırsınız; ücretli kata geçmek ya da beklemek gerekir. Farklı model ve sağlayıcıların token maliyetlerini yan yana görmek için API token maliyet hesaplama rehberimize bakabilirsiniz.

API Anahtarını Güvenli Saklama

API anahtarını kaynak kodunuza asla yazmayın. Ortam değişkeni kullanmak standart yöntem:

# .env dosyasına yazın (asla git'e commit etmeyin)
GOOGLE_API_KEY=AIzaSy...

# .gitignore'a ekleyin
echo ".env" >> .gitignore

Paylaşılan ortamlarda veya production deployment’ta Google Cloud Secret Manager daha güvenli. Yerel geliştirme için .env + python-dotenv kombinasyonu yeterli.

Python ile Gemini API Entegrasyonu

google-generativeai Kurulumu

Google’ın resmi Python kütüphanesi google-generativeai ile başlamak kolay:

pip install google-generativeai python-dotenv

2026 itibarıyla Google yeni projelerde google-genai adlı güncel SDK’ya geçişi öneriyor. Her ikisi de çalışır; yeni başlıyorsanız google-genai ile kurabilirsiniz:

pip install google-genai python-dotenv

Bu rehberdeki örnekler google-generativeai ile yazıldı çünkü dokümantasyondaki büyük çoğunluk hâlâ bu kütüphaneyi referans alıyor.

İlk API Çağrısı

import os
from dotenv import load_dotenv
import google.generativeai as genai

load_dotenv()

genai.configure(api_key=os.environ["GOOGLE_API_KEY"])

model = genai.GenerativeModel("gemini-2.0-flash")
response = model.generate_content("Python'da hızlı sıralama algoritmasını açıkla.")

print(response.text)

generate_content tek seferlik istek için en sade yöntem. Çıktı response.text ile doğrudan string olarak geliyor; ham JSON parse etmeye gerek yok.

Hata yönetimi eklemek için yanıt nesnesini kontrol edin:

if response.candidates:
    print(response.text)
else:
    print("Model yanıt üretemedi:", response.prompt_feedback)

Streaming ve Multimodal Kullanım

Uzun yanıtlarda kullanıcının ilk token’ı beklemesini azaltmak için streaming kullanın:

response = model.generate_content(
    "Python ile web scraping rehberi yaz.",
    stream=True
)

for chunk in response:
    print(chunk.text, end="", flush=True)

Görsel + metin girişi için PIL kütüphanesini kullanabilirsiniz:

import PIL.Image

image = PIL.Image.open("ekran_goruntusu.png")
model = genai.GenerativeModel("gemini-2.0-flash")

response = model.generate_content([
    image,
    "Bu görüntüdeki hata mesajını açıkla ve çözüm öner."
])

print(response.text)

Görsel dosyayı doğrudan generate_content listesine ekleyebilirsiniz; model metni ve görseli birlikte işler.

Multimodal Özellikler

Generatif yapay zeka modellerinin büyük kısmı yalnızca metin işler. Gemini’nin öne çıktığı alan, birden fazla girdi türünü aynı anda yorumlaması.

Görsel + Metin Girişi

AI Studio arayüzünde prompt kutusunun yanındaki ataş ikonuyla görsel yükleyebilirsiniz. Grafik analizi, UI hatası tespiti veya ürün fotoğrafı açıklaması gibi görevler için bu yöntem pratik; metin ve görsel aynı istek içinde işleniyor.

PNG, JPEG ve WebP formatları destekleniyor; maksimum dosya boyutu 20 MB. Birden fazla görsel de eklenebiliyor: aynı anda iki tasarım versiyonu yükleyip karşılaştırma isteyebilirsiniz.

PDF ve Doküman Analizi

Aynı yükleme mekanizmasıyla PDF de eklenebiliyor. Gemini dokümanı sayfa sayfa okuyup metin çıkarımı yapıyor, ardından üst katman yorum ekliyor. Uzun sözleşme veya teknik rapor özetleme için kullanışlı bir yöntem. Taranmış (görüntü tabanlı) PDF’lerde OCR kalitesi, metin tabanlı PDF’lere göre daha değişken.

Model Ayarları: Temperature, Top-P, Top-K

AI Studio’nun sağ panelinde üç parametre öne çıkar.

Temperature: 0’a yakın değerlerde model daha tutarlı ve tahmin edilebilir yanıtlar üretiyor; 1’e yaklaştıkça çeşitlilik artıyor. Kod üretimi için 0.2, yaratıcı metin için 0.8 başlangıç noktası olabilir.

Top-P: Model her adımda en olası token’ların kümülatif olasılığı bu eşiği geçene kadar seçim yapıyor. 0.9 değeri çoğu senaryo için dengeli.

Top-K: Her adımda değerlendirilen maksimum token sayısını kırpıyor. Düşük değerler yanıtı daraltır.

Ne Zaman Hangi Parametreyi Kullanmalı?

Kaynak: Google AI Studio Docs

Çoğu durumda yalnızca temperature’ı değiştirmek yeterli. Top-p ve top-k’yı varsayılanda bırakmak aşırı ince ayar gerektirmez.

Kullanım Senaryoları

İçerik Üretimi ve Özetleme

Uzun makaleleri maddeler halinde özetlemek, farklı tonlarda metin üretmek veya çok dilli içerik oluşturmak için Flash modeli yeterince hızlı ve ekonomik. Ücretsiz kotayla günde 1.500 istek yapılabildiğinden küçük ölçekli içerik otomasyonu için iyi bir başlangıç.

Kod Yazma ve Hata Ayıklama

Kod tamamlama, hata mesajı açıklaması ve refactoring önerilerinde Pro modeli daha güvenilir. Stack trace içeren hata mesajlarını doğrudan metin olarak yapıştırıp açıklama isteyebilirsiniz. Yapılandırılmış çıktı gerektiren projelerde JSON mode aktif edildiğinde model şema uyumlu yanıt üretiyor.

Veri Analizi

CSV veya JSON verisini doğrudan prompt’a yapıştırıp analiz, istatistik veya görselleştirme önerisi isteyebilirsiniz. Büyük veri setleri için kütüphane entegrasyonu daha verimli olsa da hızlı keşif aşamasında AI Studio yeterli.

Fiyatlandırma: Ücretsiz mi, Paralı mı?

Free Tier Sınırları (RPM/TPD)

Ücretsiz katman production ortamı için yetersiz. Dakikada 15 istek ve günde 1.500 istek kotası aşılınca 429 hatası alırsınız; ücretli kata geçmek ya da bir sonraki günü beklemek gerekir. Kişisel projeler ve öğrenme aşaması için bu kota genellikle yeterli.

Gemini 2.0 Pro ve Ultra için ücretsiz kota daha kısıtlı; production düzeyindeki uygulamalar için ücretli plan zorunlu.

Pay-as-you-go: Token Başına Maliyet

Ücretli katta Gemini 2.0 Flash, giriş tokeni başına $0.10/1M, çıkış $0.40/1M token (2026 Q2 fiyatları). Pro modeli giriş için $1.25/1M, çıkış $5.00/1M. Bu rakamları GPT-4o ve Claude Sonnet ile karşılaştırmak için API token maliyet hesaplama rehberimize bakın.

Kaynak: Google AI fiyatlandırma sayfası

Google AI Studio vs OpenAI Playground

Kaynak: Google AI Docs, OpenAI Docs (2026 Q2)

OpenAI Playground, GPT modeline alışkınsanız öğrenme eğrisi daha düz. AI Studio’nun avantajları: genişletilmiş ücretsiz kota, daha büyük bağlam penceresi ve daha zengin multimodal destek. Hangi platformu tercih edeceğiniz büyük ölçüde mevcut model deneyiminize ve projenizin maliyet gereksinimine bağlı.

Gemini’nin nasıl çalıştığını daha iyi anlamak istiyorsanız Prompt Engineering rehberimize bakabilirsiniz; orada sistem talimatı yazımını daha ayrıntılı ele aldık. Üretilen kodu yapılandırılmış JSON çıktısıyla kontrol altında tutmak için de Structured Outputs yazımız yol gösterici.