En yeni Gemini modellerini kullanma

Bu sayfa 3.5 Flash

Gemini 3.6 Flash (gemini-3.6-flash) ve Gemini 3.5 Flash-Lite (gemini-3.5-flash-lite) genel kullanıma sunuldu ve üretimde kullanılmaya hazır.

• Gemini 3.6 Flash: Karmaşık görevlerde ve çok formatlı görevlerde daha güçlü performans sunarken 3.5 Flash'e kıyasla daha düşük bir fiyatla jeton kullanımını azaltır.
• Gemini 3.5 Flash-Lite: 3.5 ailesindeki en hızlı ve en düşük maliyetli modeldir. Yüksek işleme hızıyla yürütme için önceki Flash-Lite nesillerinden daha iyi performans gösterir.

Bu kılavuzda, her modeldeki yenilikler, kodunuzu etkileyen API değişiklikleri ve nasıl geçiş yapacağınız açıklanmaktadır.

Yeni modeller

Her iki model de 1 milyon parçalık bağlam penceresini, 64 bin maksimum çıkış parçası sayısını, düşünme özelliğini ve Bilgisayar Kullanımı da dahil olmak üzere yerleşik araçların tamamını destekler.

Tam özellikler için model sayfalarına bakın:

• Gemini 3.6 Flash model sayfası
• Gemini 3.5 Flash-Lite model sayfası

Ayrıntılı fiyatlandırma bilgileri için fiyatlandırma sayfasına bakın.

Hızlı başlangıç kılavuzu

from google import genai

client = genai.Client()

response = client.models.generate_content(
    model="gemini-3.6-flash",
    contents="Write a three.js script that renders an interactive 3D robot.",
)

print(response.text)

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({});

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-3.6-flash",
    contents: "Write a three.js script that renders an interactive 3D robot.",
  });
  console.log(response.text);
}

main();

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.6-flash:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [{
      "parts": [{"text": "Write a three.js script that renders an interactive 3D robot."}]
    }]
  }'

Gemini 3.6 Flash'teki yenilikler

• Token ve dönüş azaltma: Çok adımlı iş akışlarını Gemini 3.5'e kıyasla daha az muhakeme adımı, sohbet dönüşü ve araç çağrısıyla tamamlar. Ayrıca yürütme döngüsünün sarmal olmasını da azaltır.
• Gelişmiş kod oluşturma: Daha az istenmeyen düzenleme ve daha az hata ayıklama döngüsüyle üretime hazır, daha yüksek kaliteli kodlar üretir.
• Daha iyi talimat takibi: Teşhis görevleri sırasında istenmeyen dosya değişikliklerini azaltır.
• Güçlü çok formatlı ve uzamsal akıl yürütme: Grafik yorumlama, görsel plan dönüştürme ve çok öğeli web düzeni oluşturma konusunda daha iyi performans.
• Önceden programatik inceleme: Değişiklik yapmadan önce teşhis kodu komut dosyalarını Gemini 3.5 Flash'e kıyasla daha sık çalıştırmayı tercih eder. Bu, karmaşık görevlerde doğruluğu artırır ancak basit ön uç çalışmalarında ek keşif adımları ekleyebilir.
• Bilgisayar Kullanımı desteği: Ajanlı kullanıcı arayüzü otomasyonu için yerel araç olarak desteklenir.
• Kullanıcı arayüzü stil tercihi: İşlevsel kod oluşturma konusunda daha iyi olsa da insan değerlendiriciler görsel düzen ve stil için önceki modelleri tercih etti. Açık tasarım kuralları belirleyerek bu durumu önleyebilirsiniz.
• Varsayılan düşünme çabası (orta): Gemini 3.5 Flash ile aynı medium varsayılan düşünme düzeyini kullanır.
• Daha düşük fiyatlandırma: Daha düşük çıkış jetonu maliyetleri (3.5 Flash için 9,00 ABD doları/1 milyon jeton yerine 7,50 ABD doları/1 milyon jeton). Giriş jetonları 1,50 ABD doları/1 milyon olarak kalır.

Gemini 3.5 Flash-Lite'taki yenilikler

• Daha düşük görev yürütme gecikmesi: Yüksek hacimli veri ayrıştırma ve doküman çıkarma için 3.5 ailesindeki en yüksek işleme hızı.
• Gelişmiş akıl yürütme ve çok formatlı performans: HLE (%18,0'a karşı %11,0) gibi akıl yürütme görevlerinde ve CharXIV (%74,5'e karşı %63,7) gibi çok formatlı karşılaştırmalarda daha yüksek puanlar alarak Gemini 2.5 Flash'ten sorunsuz bir şekilde geçiş yapın.
• Alt aracı düzenleme ve araç güvenilirliği: Kod yürütme, arama ve MCP iş akışlarında araç yürütme güvenilirliğini artırır. Bağımsız planlama ve karmaşık alt aracı görevleri için düşünme düzeyini artırın.
• Gelişmiş belge anlama: Belge ayrıştırma ve yapılandırılmış veri çıkarma işlemlerinde doğruluğu artırır. Belgenin karmaşıklığına bağlı olarak hem minimum hem de yüksek düşünme seviyelerini deneyin.
• Etkileşimli web kodlama ve tablo verisi işleme: Basit kod yürütme yoluyla planlama yaparak ön uç JavaScript ve tablo verisi işlemede güçlü bir performans gösterir.
• Chatbot ve karakter kalıcılığı: Gemini 3.1 Flash-Lite'a kıyasla çok aşamalı etkileşim talimatlarını daha iyi takip etme ve karakter tutarlılığı.
• Bilgisayar Kullanımı desteği: Ajanlı kullanıcı arayüzü otomasyonu için yerel araç olarak desteklenir.

Doğru Flash veya Flash-Lite modelini seçme

İş yükleriniz için doğru modeli ve taşıma yolunu seçmek üzere bu tabloyu kullanın.

Her iki modelde de desteği sonlandırılan örnekleme parametrelerinin (temperature, top_p, top_k) ve önceden doldurulmuş model dönüşlerinin kaldırılması gerekir. Ayrıntılar için API değişiklikleri başlıklı makaleyi inceleyin.

Antigravity aracısı güncellendi

Gemini 3.6 Flash, performansının iyileştirilmesi sayesinde artık Gemini Yönetilen Ajanlar'daki Antigravity ajanı destekleyen yeni varsayılan model. Bu durum, API'de yeni bir alan ayarlanarak değiştirilebilir.

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    agent="antigravity-preview-05-2026",
    input="Read Hacker News, summarize the top 10 stories, and save the results as a PDF.",
    environment="remote",
)

print(interaction.output_text)

import { GoogleGenAI } from "@google/genai";

const client = new GoogleGenAI({});

const interaction = await client.interactions.create({
    agent: "antigravity-preview-05-2026",
    input: "Read Hacker News, summarize the top 10 stories, and save the results as a PDF.",
    environment: "remote",
}, { timeout: 300000 });

console.log(interaction.output_text);

curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "Content-Type: application/json" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-d '{
    "agent": "antigravity-preview-05-2026",
    "input": "Read Hacker News, summarize the top 10 stories, and save the results as a PDF.",
    "environment": "remote"
}'

API değişiklikleri ve parametre güncellemeleri

Gemini 3.6 Flash ve Gemini 3.5 Flash-Lite'tan itibaren, aşağıdaki API değişiklikleri bu modeller ve gelecekteki tüm Gemini model sürümleri için geçerli olacaktır.

• Örnekleme parametresinin desteği sonlandırıldı: temperature, top_p ve top_k parametrelerinin desteği sonlandırıldı. API bu parametreleri yok sayar ve gelecekteki model oluşturma işlemlerinde hata döndürür.
• Önceden doldurulmuş model dönüşü doğrulama: Model dönüşlerinin önceden doldurulması artık desteklenmiyor. İstekteki son boş olmayan dönüş bir model dönüşüyse API, 400 hatası döndürür.

Aşağıda, her API değişikliğiyle ilgili ayrıntılı açıklamalar ve kod örnekleri verilmiştir.

1. Örnekleme parametresinin desteğinin sonlandırılması (temperature, top_p, top_k)

temperature, top_p ve top_k kullanımdan kaldırıldı ve yoksayılıyor. Gelecekteki model nesillerinde bu parametrelerin sağlanması HTTP 400 hatası döndürür. Bu parametreleri tüm isteklerden kaldırın.

# ⚠️ Remove these parameters (deprecated)
generation_config = {
     "temperature": 0.7,
     "top_p": 0.9,
     "top_k": 40,
}

Belirleyiciliği artırmak için belirli kullanım alanınıza yönelik açık kurallar içeren bir sistem talimatı tanımlayın.

2. Önceden doldurulmuş model dönüşü doğrulama

Boş olmayan bir model rolüyle biten API isteklerine izin verilmez ve HTTP 400 hatası döndürülür.

⚠️ Kullanılmasın

Eski generateContent veya ham REST yüklerinde, model rolü dönüşüyle bitenler artık yasaklanmıştır:

/* ❌ DO NOT: End payload contents with a 'model' role turn */
{
  "contents": [
    {"role": "user", "parts": [{"text": "Translate 'Hello world' to Spanish."}]},
    {"role": "model", "parts": [{"text": "Translation:"}]}  /* ❌ Returns error */
  ]
}

✅ Önerilen taşıma

Uygulamanız daha önce girişleri bastırmak veya JSON biçimlendirmesini zorlamak için bir model dönüşünü önceden dolduruyorsa bunun yerine system_instruction veya Yapılandırılmış çıkışlar'ı kullanın.

# ✅ RECOMMENDED: Use system_instruction to specify output format
response = client.models.generate_content(
    model="gemini-3.6-flash",
    contents="Translate 'Hello world' to Spanish.",
    config={"system_instruction": "Output only the translation without introductory text."},
)

Taşıma kontrol listesi

gemini-3.6-flash'e geçiş yapma

• Model Kimliğini Güncelle: Hedef model dizesini gemini-3.6-flash olarak değiştirin.
• Desteği sonlandırılan örnekleme parametrelerini kaldırma:
  • Üretim yapılandırmalarından temperature, top_p ve top_k öğelerini kaldırın.
  • thinking_budget öğesini, "medium" veya "high" olarak ayarlanmış dize numaralandırması thinking_level ile değiştirin.
  • candidate_count adlı ülkeyi kaldırın (Gemini 3.x'te desteklenmez).
• Hamle doğrulama kurallarını zorunlu kılma:
  • Önceden doldurulmuş model dönüşlerini kaldırın.
  • Son kullanıcı dönüşünün boş olmayan metin içerdiğinden emin olun.
• İşlev çağrısını denetleme:
  • Tüm FunctionResponse nesnelerinin call_id ve name içerdiğinden emin olun.
  • Çok formatlı öğeleri yanıt yükünün içine yerleştirin.
  • Satır içi talimatları \\n\\n kullanarak biçimlendirin.
  • Araç öncesi metinle ilgili Malformed_Function_Call hataları görüyorsanız Araç öncesi metin koşulları için geçici çözümler başlıklı makaleyi inceleyin.
• Temel Gemini 3.x gereksinimleri: SDK güncellemeleri ve düşünce imzası koruması için Gemini 3.5'e Geçiş Yapılacaklar Listesi'ne bakın.

gemini-3.5-flash-lite'a geçiş

• Model Kimliğini Güncelle: Hedef model dizesini gemini-3.5-flash-lite olarak değiştirin.
• Düşünme çabası seviyesini yapılandırma:
  • Yüksek hacimli çıkarma, yönlendirme veya sınıflandırma için: Maksimum işleme hızı elde etmek üzere thinking_level değerini "minimal" (varsayılan) olarak bırakın.
  • Araç çağrıları, kod yürütme veya çok adımlı akıl yürütme içeren bağımsız alt aracılar için: Erken araç sonlandırmasını önlemek üzere thinking_level değerini "medium" veya "high" olarak ayarlayın.
• Kullanımdan kaldırılan parametreleri kaldırın ve işlev çağrısını doğrulayın: 3.6 Flash ile aynı kuralları uygulayın.
• Temel Gemini 3.x şartları: Gemini 3.5 Geçiş Kontrol Listesi'ne bakın.

Sonraki adımlar

• Modellere Genel Bakış sayfasındaki API spesifikasyonlarını inceleyin.
• Etkileşimler API Kılavuzu'nda çoklu aracı düzenlemesini keşfedin.
• Google AI Studio'da istemleri test edin ve iyileştirin.