Google Gemini 3 API Kullanımı: Yapay Zeka Rehberi

Eğer 2025'teki yapay zeka gelişmelerine dikkat ediyorsanız, muhtemelen Google Gemini 3 etrafındaki büyük heyecanı duymuşsunuzdur. Bu, GPT-5 ile rekabet etmek (ve bazen onu geride bırakmak) üzere tasarlanmış yeni nesil çok modlu bir yapay zeka modelidir. İster bir yazılım mühendisi, ister bir startup kurucusu, ister bir yapay zeka meraklısı, ister sadece Gemini 3'ün neler yapabileceğini merak eden biri olun, Google Gemini 3 API ile nasıl çalışılacağını öğrenmek, çok daha akıllı ve dinamik uygulamalar geliştirmenizin kapılarını açar.

Ama dürüst olalım; Google'ın dokümantasyonu, yeni başlayanlar için biraz karmaşık olabilir. Bu yüzden bu rehberde her şeyi açık, samimi ve başlangıç dostu bir şekilde açıklayacağız.

💡

Gemini 3 REST API uç noktalarını test etmek için kolay, görsel ve kodsuz bir yol istiyorsanız Apidog'u kullanın. Apidog'u ücretsiz olarak indirebilirsiniz ve bu araç, tüm bir komut dosyası yazmadan API çağrılarını tasarlamanıza, hata ayıklamanıza ve test etmenize olanak tanır. Bu rehber REST API örnekleri içerdiğinden, denemeler yaparken Apidog'u son derece kullanışlı bulacaksınız.

button

Şimdi, Google'ın en gelişmiş yapay zeka modelinin gücünü açığa çıkaralım!

Google Gemini 3 Nedir?

Google Gemini 3, Google'ın çok modlu yapay zeka ailesindeki en son modeldir. Önceki modellerin aksine, Gemini 3 şunlar için optimize edilmiştir:

akıl yürütme ve problem çözme
çok modlu girdi/çıktı (metin, resim, ses, video gömmeleri)
araç kullanımı ve ajanik iş akışları
düşük gecikmeli uç noktalarla hızlı çıkarım
görevinize bağlı olarak dinamik model değiştirme

Ancak en büyük özellik şudur:

Gemini 3 iki ana “düşünme modu” sunar:

thinking_level parametresi, modelin bir yanıt üretmeden önceki dahili akıl yürütme sürecinin maksimum derinliğini kontrol eder. Gemini 3, bu seviyeleri katı token garantileri yerine düşünme için göreceli izinler olarak ele alır. Eğer thinking_level belirtilmezse, Gemini 3 Pro varsayılan olarak high değerini kullanır.

Yüksek/Dinamik Düşünme: Akıl yürütme derinliğini en üst düzeye çıkarır. Model, ilk tokene ulaşmak için önemli ölçüde daha uzun sürebilir, ancak çıktı daha dikkatli bir şekilde akıl yürütülmüş olacaktır.
Düşük Düşünme: Gecikmeyi ve maliyeti en aza indirir. Basit talimatları takip etme, sohbet veya yüksek iş hacimli uygulamalar için en iyisidir.

Birçok yeni başlayan bunu henüz bilmiyor, ancak doğru modu seçmek çıktı kalitesini büyük ölçüde iyileştirir ve maliyetlerinizi kontrol etmenize yardımcı olur.

API kullanarak bir modu nasıl seçeceğimize yakında değineceğiz.

Neden Bir Kullanıcı Arayüzü Aracı Yerine Gemini 3 API Kullanmalı?

Elbette, Gemini'yi Google AI Studio içinde kullanabilirsiniz. Ancak şunları yapmak isterseniz:

uygulamalar geliştirmek
görevleri otomatikleştirmek
modeli iş akışlarına entegre etmek
sohbet botları oluşturmak
verileri işlemek
ajanları eğitmek
çok modlu görevleri yürütmek

Gemini 3 API'ye ihtiyacınız olacaktır.

Bu rehber REST API'ye odaklanmaktadır çünkü:

yeni başlayanlar için daha kolaydır
istemci kütüphanelerine gerek yoktur
Apidog veya Postman'de hızlıca test edebilirsiniz
herhangi bir arka uç ortamında çalışır

Gemini 3 API Nasıl Çalışır (Basit Bir Bakış)

Gemini gelişmiş yeteneklere sahip olsa da, API'nin kendisi oldukça basittir.

Şuraya bir POST isteği gönderirsiniz…

<https://generativelanguage.googleapis.com/v1beta/models/{MODEL_ID}:generateContent?key=YOUR_API_KEY>

Şunun gibi JSON dahil edersiniz:

metin istemi
mesaj listesi (isteğe bağlı)
model ayarları
güvenlik ayarları

Şunları alırsınız…

model çıktı metni
akıl yürütme yapısı (Yüksek/Dinamik düşünme için)
alıntılar
meta veriler
çok modlu nesneler (uygulanabilirse)

Bu yapıyı anladığınızda, diğer her şey daha kolay hale gelir.

Başlarken: Gemini API ile İlk Adımlarınız

Adım 1: API Anahtarınızı Alın

API anahtarınızı, Google'a "Evet, Gemini'yi kullanmama izin var" diyen özel bir parola gibi düşünün. İşte nasıl alacağınız:

Google AI Studio'ya gidin
Google hesabınızla oturum açın
Sol kenar çubuğunda "API Anahtarı Oluştur"a tıklayın
Anahtarınıza bir ad verin ve oluşturun
Bu anahtarı güvenli bir yere kopyalayıp saklayın! Bir daha göremeyeceksiniz.

Önemli: API anahtarınızı asla paylaşmayın veya genel kod depolarına yüklemeyin. Onu parolanız gibi değerlendirin.

Adım 2: Yaklaşımınızı Seçin

Gemini ile iki ana yolla etkileşim kurabilirsiniz:

REST API: Evrensel yaklaşım. HTTP istekleri yapabilen herhangi bir programlama diliyle çalışır. Bu yönteme odaklanacağız.
Resmi SDK'lar: Google, sizin için HTTP detaylarını ele alan Python, Node.js ve diğer diller için uygun kütüphaneler sağlar.

Temel bilgilere odaklandığımız için REST API yaklaşımını kullanacağız; her yerde çalışır ve arka planda ne olup bittiğini anlamanıza yardımcı olur.

Gemini'nin Düşünme Modlarını Anlamak

Gemini'nin en güçlü özelliklerinden biri, farklı "düşünme modlarında" çalışma yeteneğidir. Bu sadece pazarlama değil; modelin isteklerinizi işleme şeklini temelden değiştirir.

Düşük Düşünme (Hız Canavarı)

Ne zaman kullanılır: Basit görevler, hızlı yanıtlar ve hız ile maliyet optimizasyonu yaparken.

Hız: Çok hızlı yanıtlar
Maliyet: Daha uygun fiyatlı
Kullanım Durumları: Basit Soru-Cevap, metin sınıflandırma, temel özetleme, doğrudan çeviriler

Örneğin:

gemini-3-flash
gemini-3-mini

Düşük Düşünme modunu, size anında cevaplar veren bilgili bir arkadaşınızla hızlı bir sohbet etmek gibi düşünebilirsiniz.

Yüksek/Dinamik Düşünme (Düşünceli Analist)

Ne zaman kullanılır: Karmaşık akıl yürütme, çok adımlı problemler ve derin analiz gerektiren görevler için.

Hız: Daha yavaş (yanıt vermeden önce daha fazla "düşünür")
Maliyet: Daha pahalı
Kullanım Durumları: Karmaşık matematik problemleri, mantıksal akıl yürütme, kod hata ayıklama, yaratıcı yazma, stratejik planlama

Yüksek/Dinamik Düşünme, size iyi gerekçelendirilmiş bir yanıt vermeden önce tüm açılardan düşünmek için zaman ayıran bir uzmana danışmak gibidir.

Örneğin:

gemini-3-pro
gemini-3-pro-thinking

Bu modeller daha derin akıl yürütme, daha uzun dikkat pencereleri ve daha iyi planlama yetenekleri sunar.

Güzelliği şu ki, özel ihtiyaçlarınıza bağlı olarak hem Yüksek/Dinamik Düşünme hem de Düşük Düşünme modellerini seçebilirsiniz. Çoğu basit uygulama için Düşük Düşünme mükemmeldir. Daha derin akıl yürütmeye ihtiyacınız olduğunda Yüksek Düşünme'ye geçin.

Genel bir kural olarak:

Görev Türü	Model Modu
Araştırma	Yüksek/Dinamik Düşünme
Matematik/Mantık	Yüksek/Dinamik Düşünme
Kod Üretimi	Yüksek/Dinamik Düşünme
Müşteri sohbeti	Düşük Düşünme
Temel metin üretimi	Düşük Düşünme
UI yardımcıları	Düşük Düşünme
Gerçek zamanlı uygulamalar	Düşük Düşünme

Her modeli REST API'de nasıl seçeceğinizi size göstereceğiz.

İlk Gemini 3 REST API Çağrınızı Oluşturun

Mümkün olan en basit örnekle başlayalım.

Uç Nokta

POST <https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro:generateContent?key=YOUR_API_KEY>

İstek Gövdesi Örneği (JSON)

{
  "contents": [
    { "role": "user",
      "parts": [{ "text": "Uçaklar nasıl uçar, açıklayın." }]
    }
  ]
}

Örnek Curl Komutu

curl -X POST \\
  -H "Content-Type: application/json" \\
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [{ "text": "Uçaklar nasıl uçar, açıklayın." }]
      }
    ]
  }' \\
"<https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro:generateContent?key=YOUR_API_KEY>"

Yüksek/Dinamik Düşünme Modunu Kullanma

Akıl yürütme modunu etkinleştirmek için, gemini-3-pro-thinking gibi bunu destekleyen bir model kullanmalısınız.

REST API Örneği

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-preview:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [{
      "parts": [{"text": "Bu çoklu iş parçacıklı C++ kod parçasındaki yarış durumunu bulun: [kod burada]"}]
    }]
  }'

Yüksek/Dinamik Düşünme modunu kullanırken genellikle şunları alırsınız:

düşünce zinciri yapıları (istenmedikçe gizli)
daha tutarlı yanıtlar
daha yavaş yanıt süreleri
daha yüksek çıkarım maliyetleri

Bu modu yalnızca uzun formlu akıl yürütme veya kod planlama gibi gerçekten önemli olduğu durumlarda kullanmanızı öneririm.

Düşük Düşünme Modunu Kullanma

Düşük Düşünme modelleri hız için optimize edilmiştir ve şunlar için mükemmeldir:

otomatik tamamlama
kısa mesajlar
UI yanıtları
küçük asistanlar
chatbot yan özellikleri

“Flash” Kullanarak REST API Örneği

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-preview:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [{
      "parts": [{"text": "Yapay zeka nasıl çalışır?"}]
    }],
    "generationConfig": {
        thinkingConfig: {
          thinkingLevel: "low"
      }
    }
  }'

Düşük Düşünme modelleri çok daha az maliyetlidir ve neredeyse anında yanıtlar döndürür.

Çok Modlu Girişleri İşleme (Görseller, PDF'ler, Ses, Video)

Gemini 3, media_resolution parametresi aracılığıyla çok modlu görüntü işleme üzerinde ayrıntılı kontrol sunar. Daha yüksek çözünürlükler, modelin ince metni okuma veya küçük ayrıntıları tanımlama yeteneğini geliştirir ancak token kullanımını ve gecikmeyi artırır. media_resolution parametresi, giriş görüntüsü veya video karesi başına ayrılan maksimum token sayısını belirler.

Çözünürlüğü, her bir medya bölümü için ayrı ayrı veya global olarak (generation_config aracılığıyla) media_resolution_low, media_resolution_medium veya media_resolution_high olarak ayarlayabilirsiniz. Belirtilmezse, model medya türüne göre optimal varsayılanları kullanır.

Gemini 3, şunlar arasında çok modlu gömmeleri destekler:

görseller
ses
video kareleri
belgeler

Bir görsel yükleme örneği (base64):

curl "https://generativelanguage.googleapis.com/v1alpha/models/gemini-3-pro-preview:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [{
      "parts": [
        { "text": "Bu resimde ne var?" },
        {
          "inlineData": {
            "mimeType": "image/jpeg",
            "data": "..."
          },
          "mediaResolution": {
            "level": "media_resolution_high"
          }
        }
      ]
    }]
  }'

Apidog ile Test ve Hata Ayıklama

curl komutları hızlı testler için harika olsa da, gerçek bir uygulama geliştirirken hantallaşırlar. İşte bu noktada Apidog devreye girer.

Apidog ile şunları yapabilirsiniz:

API Yapılandırmanızı Kaydedin: Gemini uç noktanızı ve API anahtarınızı bir kez ayarlayın, ardından tüm testlerinizde yeniden kullanın.
İstek Şablonları Oluşturun: Farklı türdeki istemleri (konuşma başlatıcılar, analiz istekleri, yaratıcı yazım) şablon olarak kaydedin.
Düşünme Modlarını Yan Yana Test Edin: Yanıtları ve performansı karşılaştırmak için Düşük ve Yüksek Düşünme modları arasında kolayca geçiş yapın.
Konuşma Geçmişini Yönetin: Birden fazla istek arasında konuşma bağlamını korumak için Apidog'un ortam değişkenlerini kullanın.
Testleri Otomatikleştirin: Gemini entegrasyonunuzun doğru çalıştığını doğrulayan test paketleri oluşturun.

button

İşte Apidog'da bir Gemini isteğini nasıl kurabileceğinize dair bir örnek:

Şuraya yeni bir POST isteği oluşturun: https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash:generateContent?key={{api_key}}
Gerçek API anahtarınızla bir ortam değişkeni api_key ayarlayın
Gövdede JSON kullanın:

{
  "contents": [{
    "parts": [{
      "text": "{{prompt}}"
    }]
  }],
  "generationConfig": {
    "temperature": 0.7,
    "maxOutputTokens": 800
  }
}

4. Gemini'ye sormak istediğiniz herhangi bir şeyle başka bir ortam değişkeni prompt ayarlayın

Bu yaklaşım, denemeyi çok daha hızlı ve daha düzenli hale getirir.

Gemini API için En İyi Uygulamalar

1. Hataları Zarifçe Yönetin

API çağrıları birçok nedenden dolayı başarısız olabilir. Her zaman yanıt durumunu kontrol edin ve hataları uygun şekilde ele alın. Aşağıdaki tablo, karşılaşabileceğiniz yaygın arka uç hata kodlarını, nedenlerinin açıklamaları ve sorun giderme adımlarıyla birlikte listeler:

2. Maliyetlerinizi Yönetin

Gemini API kullanımı ölçülendirilir ve ücretlidir (ücretsiz katman limitleri sonrasında). Şu ipuçlarını aklınızda bulundurun:

Denemeler için ücretsiz katmanla başlayın
Basit görevler için mümkün olduğunda Düşük Düşünme modunu kullanın
Makul maxOutputTokens limitleri belirleyin
Google AI Studio'da kullanımınızı izleyin

Tokenlar z gibi tek karakterler veya kedi gibi tam kelimeler olabilir. Uzun kelimeler birkaç tokene ayrılır. Model tarafından kullanılan tüm token kümesine sözlük denir ve metni tokenlara ayırma işlemine tokenizasyon denir.

Faturalandırma etkinleştirildiğinde, Gemini API çağrısının maliyeti kısmen girdi ve çıktı token sayısına göre belirlenir, bu nedenle tokenları nasıl sayacağınızı bilmek faydalı olabilir.

3. Daha İyi İstemler Oluşturun

Çıktınızın kalitesi, girdinize büyük ölçüde bağlıdır. İşte bazı istem mühendisliği ipuçları:

Şunun yerine: "Köpekler hakkında yaz"

Şunu deneyin: "Kurtarma köpeklerini sahiplenmenin faydaları hakkında, potansiyel evcil hayvan sahipleri için samimi ve teşvik edici bir tonla yazılmış 200 kelimelik eğitici bir blog yazısı yazın."

Şunun yerine: "Bu kodu düzelt"

Şunu deneyin: "Faktöriyel hesaplaması yapması gereken ancak girdi 5 için yanlış sonuçlar döndüren bu Python fonksiyonunu lütfen hata ayıklayın. Neyin yanlış olduğunu açıklayın ve düzeltilmiş kodu sağlayın."

4. Doğru Modeli Seçin

Google, her biri farklı güçlü yönlere sahip çeşitli Gemini modelleri sunar. Model parametrelerinizin aşağıdaki değerler içinde olduğunu doğrulayın:

gemini-1.5-flash ile başlayın ve yalnızca daha fazla akıl yürütme yeteneğine ihtiyacınız varsa yükseltin. Parametre değerlerini kontrol etmenin yanı sıra, doğru API sürümünü (örn. /v1 veya /v1beta) ve ihtiyacınız olan özellikleri destekleyen modeli kullandığınızdan emin olun. Örneğin, bir özellik Beta sürümündeyse, yalnızca /v1beta API sürümünde kullanılabilir olacaktır.

Sonuç: Yapay Zeka Yolculuğunuz Başlıyor

Artık Google Gemini API ile geliştirmeye başlamak için ihtiyacınız olan her şeye sahipsiniz. Bir API anahtarını nasıl alacağınızı, temel istekleri nasıl yapacağınızı, farklı düşünme modlarını nasıl anlayacağınızı ve hatta bazı gelişmiş örnekleri bile gördünüz.

Yapay zeka API'leriyle çalışmanın yinelemeli bir süreç olduğunu unutmayın. Pratikle istemleri oluşturmada ve doğru ayarları seçmede daha iyi olacaksınız. Denemekten korkmayın, inşa edebileceklerinizin tam potansiyelini bu şekilde keşfedeceksiniz.

En önemli sonraki adım, denemelere başlamaktır. Bu rehberdeki örnekleri alın, değiştirin, bozun ve ne olduğunu görün. Öğrenmenin en iyi yolu yapmaktır.

Yeni başlayanlar için, REST API test aracınız olarak Apidog'u kullanmanızı şiddetle tavsiye ederim. Size yardımcı olur:

isteklerde hata ayıklama
ortam değişkenlerini depolama
koleksiyonları çalıştırma
model çıktılarını hızlıca karşılaştırma
API test senaryolarınızı ekip arkadaşlarınızla paylaşma

Ve ücretsiz olduğu için hiçbir dezavantajı yoktur.

button