Gemini API Türkiye: Ücretsiz Kota, Fiyatlar ve TL ile Kullanım (2026)

Google'ın resmi Gemini dokümantasyonu API'nin nasıl çağrılacağını çok iyi anlatıyor; ancak Türkiye'deki bir geliştiricinin veya şirketin asıl merak ettiği ticari soruları es geçiyor: Ücretsiz kota gerçekte neye yetiyor ve bitince ne oluyor? Ödeme neden USD ve neden yalnızca kartla? Vertex AI ile AI Studio arasındaki fark ne, hangisi ne zaman gerekiyor? Bu rehber tam olarak bu boşluğu dolduruyor. Ücretsiz katmanın sınırlarını, Google'a doğrudan ödeme ile Onysoft AI Gateway üzerinden TL bakiye + kurumsal e-fatura seçeneğini ve 2026 Temmuz itibarıyla güncel kadro olan Gemini 3.6 Flash ile Gemini 3.1 Pro arasındaki seçimi adım adım ele alıyoruz. Üstelik Onysoft tarafında aynı sk-ony- anahtar, Gemini dahil 708+ model erişimi anlamına geliyor.

Gemini Ücretsiz Kotası: Neye Yetiyor, Bitince Ne Oluyor?

Google AI Studio'da bir Google hesabıyla dakikalar içinde ücretsiz API anahtarı alabilirsiniz; prototip aşaması için bu gerçekten cömert bir başlangıçtır. Ancak resmi dokümanın üzerinde durmadığı üç pratik sınır vardır. Birincisi, ücretsiz katman dakikalık ve günlük istek limitleriyle çalışır; limitler modele göre değişir ve Google bunları zaman zaman günceller. Prototipte fark etmezsiniz, fakat uygulamanız birkaç eşzamanlı kullanıcıya çıktığında limit aşımı hataları (HTTP 429) görmeye başlarsınız — üretim ortamı için kabul edilebilir bir durum değildir. İkincisi, ücretsiz katmanda gönderdiğiniz içerikler Google tarafından ürünlerini geliştirmek için kullanılabilir; müşteri verisi veya kurumsal doküman işleyen bir ekip için bu başlı başına bir eleme kriteridir. Üçüncüsü, kota bittiğinde resmi yol faturalandırmayı açmaktır; bu da uluslararası geçerli bir kart ve USD tahakkuk demektir. Kısacası ücretsiz kota bir deneme alanıdır, üretim planı değildir. Üretime geçerken önünüzde iki yol vardır: Google'a doğrudan ödeme veya aşağıda ele alacağımız TL tabanlı alternatif.

Google'a Ödeme (USD + Kart) ile Onysoft (TL + e-Fatura) Karşılaştırması

Faturalandırmayı Google tarafında açtığınızda Türkiye'deki ekiplerin yakından tanıdığı üç sürtünme başlar. Ödeme kartla yapılır ve Türkiye'de düzenlenmiş kartlar uluslararası ödemelerde zaman zaman reddedilir. Ücretler USD tahakkuk eder; kur hareket ettiğinde TL bütçe yapan bir ekibin ay sonu maliyetini öngörmesi zorlaşır. Google'dan gelen belge bir yurt dışı hizmet dökümüdür; Türkiye'deki e-fatura düzenine oturmadığı için muhasebe ekibi vergisel değerlendirme için ek süreç yürütür.

Onysoft AI Gateway bu üç sorunu tek katmanda çözer:

• TL bakiye: Bakiyenizi kart veya havale/EFT ile Türk Lirası olarak yüklersiniz; kullanım bakiyeden düşer, yabancı kart gerekmez.
• TCMB güncel kuru: Dönüşüm TCMB güncel kuru üzerinden şeffaf yapılır; sürpriz kur farkı yoktur.
• Kurumsal e-fatura: Tüm harcamalar Türkiye standartlarında e-fatura ile belgelenir.
• KVKK çerçevesi: Sözleşme muhatabınız Türkiye'de yerleşik bir şirkettir; veri işleme süreçleri KVKK çerçevesinde yürütülür.
• 7/24 Türkçe destek: Teknik sorularınıza kendi dilinizde, her saat yanıt alırsınız.

Fiyatlandırma kullandıkça öde modelidir; abonelik veya taahhüt yoktur. Gemini modellerinin güncel TL fiyatlarını /models/gemini sayfasında görebilir, kendi kullanım senaryonuzun yaklaşık maliyetini maliyet hesaplayıcı ile kıyaslayabilirsiniz.

Vertex AI mı, AI Studio mu, Onysoft mu?

Google, Gemini'ye erişim için iki resmi kapı sunar ve ikisi sık sık karıştırılır. AI Studio, geliştirici odaklı hızlı yoldur: tek API anahtarı, basit kurulum, bireysel kullanım için idealdir. Vertex AI ise Google Cloud'un kurumsal makine öğrenmesi platformudur: GCP projesi, IAM yetkilendirmesi, servis hesapları, bölge seçimi ve GCP faturalandırması gerektirir. Kurumsal denetim ve altyapı entegrasyonu sunar; karşılığında ciddi bir kurulum ve yönetim yükü getirir. Türkiye özelinde her iki yol da aynı noktada birleşir: ödeme USD'dir ve belge yurt dışı kaynaklıdır.

Onysoft üçüncü bir yol sunar: OpenAI-uyumlu tek uç nokta. Kodunuzda base_url olarak https://api.onysoft.com/v1, anahtar olarak sk-ony- önekli Onysoft anahtarınızı kullanırsınız; GCP projesi, IAM kurgusu veya Google SDK zorunluluğu yoktur. Aynı anahtar yalnızca Gemini'ye değil, Claude, GPT ve Grok dahil 708+ model erişimine açılır; model değiştirmek tek parametre değişikliğidir. Uç noktalar ve kimlik doğrulama ayrıntıları için API dokümantasyonu yeterlidir.

2026 Gemini Kadrosu: 3.6 Flash mi, 3.1 Pro mu?

2026 Temmuz itibarıyla Gemini ailesinin iki güncel amirali var ve seçim kriterleri nettir:

• Gemini 3.6 Flash (yeni): Ailenin hız ve maliyet odaklı üyesi. Sohbet botları, sınıflandırma, özetleme, yüksek hacimli üretim iş yükleri ve gecikmenin kritik olduğu senaryolar için ilk tercihtir. Yeni nesil Flash, önceki sürümlere göre kalite çıtasını belirgin yükseltirken hız avantajını korur; ayrıntılı inceleme için Gemini 3.6 Flash API rehberimize bakabilirsiniz.
• Gemini 3.1 Pro: 1M token bağlam penceresiyle ailenin muhakeme amirali. Uzun doküman analizi, çok adımlı akıl yürütme, karmaşık kod tabanları ve büyük bağlam gerektiren kurumsal senaryolar için doğru seçimdir.

Pratik kural şudur: iş yükünüzün büyük kısmını 3.6 Flash ile çalıştırın, yalnızca derin muhakeme veya devasa bağlam gerektiren istekleri 3.1 Pro'ya yönlendirin. Onysoft üzerinde ikisi de aynı anahtarla kullanılabildiği için bu yönlendirme kod tarafında tek satırlık bir model adı değişikliğidir. Her iki modelin özellikleri ve güncel TL fiyatları Gemini model kataloğunda listelenir; modelleri yan yana denemek için Playground hazırdır.

Python ve curl ile İlk Gemini İsteği

Onysoft OpenAI SDK uyumlu olduğu için Gemini'yi çağırmak alıştığınız kodun aynısıdır; yalnızca model parametresi değişir. Önce hesap açıp TL bakiye yükleyin ve panelden sk-ony- önekli anahtarınızı alın.

from openai import OpenAI

client = OpenAI(
    api_key="sk-ony-ANAHTARINIZ",
    base_url="https://api.onysoft.com/v1"
)

yanit = client.chat.completions.create(
    model="google/gemini-3.6-flash",
    messages=[{"role": "user", "content": "Türkiye'nin en kalabalık üç şehrini say."}]
)
print(yanit.choices[0].message.content)

Aynı istek curl ile:

curl https://api.onysoft.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-ony-ANAHTARINIZ" \
  -d '{
    "model": "google/gemini-3.6-flash",
    "messages": [{"role": "user", "content": "Merhaba Gemini!"}]
  }'

Streaming, function calling ve görsel girdi gibi özellikler OpenAI şemasıyla aynı şekilde çalışır. 1M bağlam gereken işlerde model adını google/gemini-3.1-pro yapmanız yeterlidir. Model kataloğunun tamamı ve güncel TL fiyatları için /models sayfasına göz atın.