DEV Community

Cover image for Gemini 3.6 Flash API nasıl kullanılır?
Tobias Hoffmann
Tobias Hoffmann

Posted on • Originally published at apidog.com

Gemini 3.6 Flash API nasıl kullanılır?

Google'ın Gemini API'si üzerinden gemini-3.6-flash model kimliğiyle Gemini 3.6 Flash'ı çağırabilirsiniz. Google, 21 Temmuz 2026'da Flash yenilemesini yayınladı ve 3.6 Flash bir işgücü katmanıdır: 3.5 Flash'tan daha ucuzdur, 1M token bağlam penceresi sunar ve metin, resim, video, ses ile PDF girdilerini destekler. Bu rehberde API anahtarı oluşturacak, curl ve Python ile ilk isteğinizi gönderecek, temel parametreleri yapılandıracak ve çağrınızı izlemek için bir regresyon testi kuracaksınız.

Apidog'u bugün deneyin

Gemini 3.6 Flash API

Başlamadan önce ihtiyacınız olanlar

Başlamak için üç şeye ihtiyacınız var:

  • Google hesabı: API anahtarı oluşturmak için kullanılır.
  • Gemini API anahtarı: Google AI Studio üzerinden oluşturulur.
  • HTTP istemcisi: Terminal için curl, uygulama kodu için Python veya görsel test akışları için Apidog kullanabilirsiniz.

Başlangıçta faturalandırma kurmanız gerekmez. AI Studio üzerinden ücretsiz katmanla test yapabilirsiniz; ancak bu katman istek hızı ve günlük kullanım açısından sınırlıdır.

Bir Gemini API anahtarı edinin

Google AI Studio'ya gidin ve Google hesabınızla oturum açın.

  1. API anahtarını al seçeneğine tıklayın.
  2. API anahtarı oluştur seçeneğini seçin.
  3. Oluşturulan anahtarı kopyalayın ve güvenli bir yerde saklayın.

API anahtarını şifre gibi ele alın. Anahtara erişen biri hesabınız üzerinden istek gönderebilir ve harcama oluşturabilir.

Google AI Studio API anahtarı oluşturma ekranı

Anahtarı istemci tarafı koduna yazmayın veya Git deposuna eklemeyin. Bunun yerine ortam değişkeni olarak tanımlayın:

export GEMINI_API_KEY="your_key_here"
Enter fullscreen mode Exit fullscreen mode

Resmî Python SDK'sı bu değişkeni otomatik olarak okuyabilir. Güncel kurulum ayrıntıları için Google Gemini API belgelerine bakın.

İlk API çağrınızı yapın

Gemini REST API'de generateContent metoduna bir POST isteği gönderirsiniz.

curl ile istek gönderin 

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.6-flash:generateContent" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "Explain how APIs work"
          }
        ]
      }
    ]
  }'
Enter fullscreen mode Exit fullscreen mode

Buradaki önemli noktalar:

  • API anahtarını x-goog-api-key başlığında gönderin.
  • İstek gövdesinde contents dizisini kullanın.
  • Her contents öğesi, bir parts dizisi içerir.
  • Basit metin istemleri için parts içinde text alanı kullanın.

Bu yapı, daha sonra aynı isteğe metinle birlikte görsel, ses, video veya PDF eklemenizi sağlar.

Python SDK ile istek gönderin

Önce SDK'yı yükleyin:

pip install google-genai
Enter fullscreen mode Exit fullscreen mode

Ardından aşağıdaki kodu çalıştırın:

from google import genai

client = genai.Client()  # GEMINI_API_KEY ortam değişkenini okur

resp = client.models.generate_content(
    model="gemini-3.6-flash",
    contents="Explain how APIs work",
)

print(resp.text)
Enter fullscreen mode Exit fullscreen mode

genai.Client() ortamdan GEMINI_API_KEY değerini alır. Böylece API anahtarını kaynak koduna koymanız gerekmez.

Ham JSON yanıtında üretilen metin genellikle şu yolda bulunur:

candidates[0].content.parts[0].text
Enter fullscreen mode Exit fullscreen mode

Bu alanı bilmek, ileride API testlerinde yanıt doğrulaması eklerken işinizi kolaylaştırır.

Bilmeye değer önemli parametreler

Temel istek çalıştıktan sonra, davranışı kontrol etmek için aşağıdaki ayarları kullanabilirsiniz.

Sistem talimatı

Sistem talimatı, kullanıcı isteminden ayrı olarak tüm konuşmaya uygulanacak kuralları tanımlar.

Örnek kullanım alanları:

  • “Yalnızca JSON olarak yanıt ver.”
  • “Kısa ve doğrudan bir kod inceleyicisi gibi davran.”
  • “Her yanıtı Türkçe üret.”

Sistem talimatları, biçim ve tonu her kullanıcı mesajına tekrar yazmaktan daha tutarlı şekilde yönlendirir.

Maksimum çıktı tokenları

Üretilecek yanıtın uzunluğunu sınırlamak için maksimum çıktı tokenı ayarlayın.

Gemini 3.6 Flash, 64 bin adede kadar çıktı tokenı üretebilir. Daha uzun üretimler için limiti yükseltebilir; maliyet ve gecikmeyi sınırlamak için düşürebilirsiniz.

Çok modlu girdiler

Model aynı çağrıda şunları işleyebilir:

  • Metin
  • Görsel
  • Video
  • Ses
  • PDF

Bu girdileri parts dizisine metninizin yanında ekleyebilirsiniz. Modelin çıktısı yalnızca metindir; yani farklı türlerdeki girdilerden açıklama, özet veya analiz üretmek için kullanabilirsiniz.

1M tokenlık bağlam penceresi; uzun PDF'ler, video transkriptleri ve büyük metin koleksiyonları için alan sağlar.

Düşünme ve muhakeme

Gemini 3.6 Flash, karmaşık istemlerde yanıt üretmeden önce muhakeme yapabilir. Bu, çok adımlı görevlerde sonuç kalitesini artırabilir.

Ancak düşünme tokenları çıktı fiyatlandırmasına dahildir. Yoğun muhakeme gerektiren istemler, ekranda görünen yanıt kısa olsa bile daha yüksek maliyet oluşturabilir.

Tüm parametreler ve güncel alan adları için Gemini API belgelerini kullanın. Alan adlarını tahmin etmek yerine resmî şemayı referans alın.

Fiyatlandırma ve ücretsiz katman

Gemini 3.6 Flash fiyatlandırması:

  • 1M girdi tokenı başına: 1,50 ABD doları
  • 1M çıktı tokenı başına: 7,50 ABD doları

Bu çıktı fiyatı, 3.5 Flash'ın 1M çıktı tokenı için ücretlendirdiği 9,00 ABD dolarından daha düşüktür. Ayrıca 3.6 Flash'ın aynı görevlerde yaklaşık %17 daha az çıktı tokenı üretme eğilimi, toplam maliyeti azaltabilir.

Önemli nokta: Çıktı fiyatı düşünme tokenlarını da içerir. Bu nedenle yoğun muhakeme gerektiren bir istemin maliyeti, görünür yanıtın uzunluğuna bakarak tahmin ettiğinizden yüksek olabilir.

Ayrıntılı maliyet hesaplamaları için Gemini 3.6 Flash fiyatlandırma kılavuzuna bakın.

Ücretsiz katman AI Studio üzerinden kullanılabilir, ancak hız sınırlıdır:

  • Dakika başına sınırlı istek
  • Gün başına sınırlı istek
  • Ücretsiz katman verilerinin Google ürünlerini geliştirmek için kullanılabilmesi

Bu katman prototipleme, öğrenme ve entegrasyon testleri için uygundur. Üretim trafiğinde faturalandırmayı etkinleştirmeniz gerekir.

Ücretsiz katmanın nasıl kullanılacağını görmek için Gemini 3.6 Flash'ı ücretsiz kullanma rehberini inceleyin. Faturalandırmayı etkinleştirdiğinizde aynı API anahtarı çalışmaya devam eder; kod değişikliği gerekmez.

Gemini API'yi Apidog'da test edin ve hata ayıklayın

curl isteği, çağrının bir kez çalıştığını doğrular. Ancak anahtarın geçersiz hâle gelmesi, yanıt şemasının değişmesi veya bir dağıtımın isteği bozması gibi sorunları sürekli izlemek için tekrarlanabilir testlere ihtiyacınız vardır.

Bu noktada Apidog ile kaydedilmiş API testleri oluşturabilirsiniz.

1. İsteği oluşturun

Yeni bir POST isteği ekleyin:

https://generativelanguage.googleapis.com/v1beta/models/gemini-3.6-flash:generateContent
Enter fullscreen mode Exit fullscreen mode

İstek gövdesine daha önce kullandığınız JSON içeriğini ekleyin:

{
  "contents": [
    {
      "parts": [
        {
          "text": "Explain how APIs work"
        }
      ]
    }
  ]
}
Enter fullscreen mode Exit fullscreen mode

2. Anahtarı ortam değişkeninde saklayın

Apidog ortamınıza aşağıdaki değişkeni ekleyin:

GEMINI_API_KEY
Enter fullscreen mode Exit fullscreen mode

Ardından x-goog-api-key başlığında bu değeri kullanın:

{{GEMINI_API_KEY}}
Enter fullscreen mode Exit fullscreen mode

Bu yaklaşım sayesinde:

  • Anahtar paylaşılmış istek tanımının dışında kalır.
  • Geliştirme, staging ve production ortamları için farklı anahtarlar kullanabilirsiniz.
  • İstek gövdesini veya başlık şablonunu değiştirmeden ortam geçişi yapabilirsiniz.

3. Yanıt doğrulamaları ekleyin

Başarılı bir yanıtı yalnızca HTTP durum koduyla doğrulamayın. Şunları kontrol edin:

  • Durum kodu 200 olmalı.
  • candidates[0].content.parts[0].text alanı bulunmalı.
  • Bu alan boş olmamalı.

Bu kontroller, API'nin sadece bir JSON döndürdüğünü değil, beklediğiniz üretimi yaptığını doğrular.

4. Testi kaydedin ve zamanlayın

İsteği bir koleksiyona kaydedin ve regresyon testi olarak zamanlayın.

Testi zamanlanmış görev olarak veya CI sürecinizde çalıştırabilirsiniz. Böylece kullanıcılarınız sorun yaşamadan önce Gemini entegrasyonundaki hataları yakalayabilirsiniz.

Apidog'u indirin ve bu akışı birkaç dakika içinde kurun. Apidog modeli çalıştırmaz; uygulamanızın Gemini API'den beklediği yanıtı almaya devam ettiğini doğrular.

Sık karşılaşılan hatalar ve çözümleri

401 Yetkilendirilmemiş: geçersiz anahtar

Anahtar yanlış, iptal edilmiş veya istek başlığında eksik olabilir.

Kontrol listesi:

  • x-goog-api-key başlığını gönderdiğinizden emin olun.
  • AI Studio'dan kopyaladığınız anahtarın tamamını kullanın.
  • Ortam değişkeninin doğru çözümlendiğini doğrulayın.
  • Anahtarın başında veya sonunda boşluk olmadığını kontrol edin.
  • Apidog'da {{GEMINI_API_KEY}} ifadesinin gerçek değerle değiştirildiğini kontrol edin.

429 Çok Fazla İstek: oran sınırı

Ücretsiz katmanın dakika başına veya gün başına istek sınırına ulaşmış olabilirsiniz.

Çözüm seçenekleri:

  • İstek hızını azaltın.
  • Exponential backoff ile yeniden deneme ekleyin.
  • Sık çalışan testleri seyrekleştirin.
  • Daha yüksek limit için faturalandırmayı etkinleştirin.

404 Bulunamadı: model bulunamadı

Bu hata çoğunlukla model kimliğindeki yazım hatasından kaynaklanır.

Doğru model kimliği:

gemini-3.6-flash
Enter fullscreen mode Exit fullscreen mode

Yanlış örnekler:

gemini-3.5-flash
gemini-flash-3.6
Enter fullscreen mode Exit fullscreen mode

Ayrıca gemini-3.5-flash-lite farklı bir modeldir. Model kimliklerini karıştırmayın.

Sıkça Sorulan Sorular

Gemini 3.6 Flash için tam model kimliği nedir?

Model kimliği:

gemini-3.6-flash
Enter fullscreen mode Exit fullscreen mode

Bu değeri SDK'da model parametresinde ve REST URL'sinde :generateContent ifadesinden önce kullanın.

Gemini 3.6 Flash API'si ücretsiz mi?

AI Studio aracılığıyla hız sınırlı ücretsiz katman sunulur. Bu katman prototipleme ve öğrenme için uygundur. Üretim trafiği için faturalandırmayı etkinleştirmeniz gerekir.

Ayrıntılar için ücretsiz kullanım rehberine bakın.

Modele ne gönderebilirim?

1M tokenlık bağlam penceresi dahilinde şunları gönderebilirsiniz:

  • Metin
  • Görsel
  • Video
  • Ses
  • PDF

Model çıktısı yalnızca metindir.

Faturam neden görünen yanıtlardan daha yüksek geldi?

1M token başına 7,50 ABD doları olan çıktı fiyatı, modelin düşünme tokenlarını da içerir. Yoğun muhakeme gerektiren istemler, ekranda gördüğünüz yanıtın uzunluğundan daha yüksek maliyet oluşturabilir.

Bu, eski Gemini 3.5 Flash API'siyle aynı mı?

Çağrı şekli aynıdır. Daha önce Gemini 3.5 API'sini kullandıysanız, model kimliğini değiştirmeniz yeterlidir.

Gemini 3.6 Flash, çıktı fiyatını düşürür ve aynı iş için daha az çıktı tokenı kullanma eğilimindedir.

Aynı anahtarı curl, Python ve Apidog'da kullanabilir miyim?

Evet. AI Studio'dan aldığınız tek bir API anahtarı curl, Python ve Apidog ile çalışır.

Anahtarı her araçta doğrudan yazmak yerine ortam değişkeni olarak saklayın. Böylece anahtarı tek bir yerden değiştirebilir veya iptal edebilirsiniz.

Bundan sonra nereye gitmeli?

Artık şunlara sahipsiniz:

  • Gemini API anahtarı
  • curl ile çalışan ilk çağrı
  • Python SDK entegrasyonu
  • Temel parametre bilgisi
  • İzlenebilir regresyon testi akışı

Ücretsiz katmanla başlayın, API anahtarını ortam değişkeninde saklayın ve gelişmiş yapılandırmalar için resmî Gemini API belgelerine başvurun.

Gemini çağrısı uygulamanızın kritik bir parçası hâline geldiğinde, sessiz API değişikliklerini kullanıcılarınıza ulaşmadan yakalamak için çağrıyı bir Apidog testiyle izleyin.

Top comments (0)