Gemini 2.5 geçişi: 1 Aralık API yönlendirmesinden önce doğrulama

1. İki tarih, iki farklı hedef

2 Kasım 2026 tarihli Gemini API sürüm notlarına göre Gemini 2.5 Pro ve 2.5 Flash kullanımdan kaldırılma sürecinde ve Google AI Studio'da artık seçilemiyor. API değişikliği 1 Aralık için duyuruldu: gemini-2.5-pro istekleri gemini-3.8-flash'e, gemini-2.5-flash istekleri gemini-3.5-flash-lite'a yönlendirilecek. Ücretlendirme hedef modelin tarifesine göre yapılacak.

4 Kasım'daki incelememiz itibarıyla bu eski modellere API erişimi, onları geçmişte etkin biçimde kullanmış kişilerle sınırlı. Ayrı bir model olan gemini-2.5-flash-lite bu kaldırma kapsamında değil. Eski isimle bugün yanıt alınması, son tarihten sonra davranışın korunacağını göstermez. İncelenen duyuru kesin geçiş saatini veya saat dilimini belirtmiyor.

Bu açıklamalar Gemini Developer API ve AI Studio için geçerli. Gemini tüketici uygulaması, abonelik hakları veya her Vertex AI dağıtımı için aynı takvimi belirlemiyor. Bir hedef seçmeden önce her geçiş işine kullanılan hizmet yüzeyini ve proje sorumlusunu yazın.

Google: 2 Kasım Gemini API sürüm notları · Google: kaldırma, erişim ve yönlendirme takvimi

2. Model adını değiştirmeden önce sözleşmenin envanterini çıkarın

Uygulama yapılandırmasını, arka plan çalışanlarını, not defterlerini, toplu işleri ve kendi ağ geçidinizdeki takma adları araştırın. Bir ortam değişkeni pro derken geçit veya görev çalıştırıcısı farklı bir modele çözümleyebilir. Yapılandırılan modeli ve yanıtta sunulan model kimliğini kaydedin; yalnızca HTTP 200 almak, amaçlanan yolun gerçekten denendiğini göstermez.

Model geçişiyle uç nokta geçişini ayırın. Google, GenerateContent'i desteklemeye devam ediyor; yeni projeler için Interactions öneriliyor. Modeli, SDK'yı, uç noktayı, istemi ve araç protokolünü aynı sürümde değiştirmek başarısız tekrarın nedenini bulmayı zorlaştırır. Önce yeniden üretilebilir bir temel sürüm oluşturun, sonra değişkenleri tek tek değiştirin.

• Her giriş için uç nokta, model kimliği, SDK sürümü, istem sürümü, araç şeması özeti ve varsayılan istek ayarlarını kaydedin.
• Durumu kimin tuttuğunu belirleyin: SDK geçmişi, uygulamanın sakladığı içerik parçaları, depolanan Interactions veya durumsuz adım tekrarı.
• Salt okunur işleri mesaj gönderen, kayıt değiştiren ya da ücret doğuran eylemlerden ayırın; tekrar testlerinde etkileri taklit edin.
• İş sorumlusu, kabul ölçütü ve onaylı veri kümesi belirleyin. Müşteri kimlik bilgilerini veya anonimleştirilmemiş konuşmaları geçiş deposuna kopyalamayın.

Google: Interactions durumu, tur ayarları ve saklama · Google: API anahtarları, projeler ve kimlik bilgileri

3. Eski varsayımları uyumluluk matrisiyle değiştirin

Güncel kılavuzlar yalnızca model değişimini değil, istek değişikliklerini de açıklıyor. Bazı eski örnekleme parametreleri belgelenen nesilde yok sayılıyor; ilerideki nesillerde hataya dönüşebilir. Bu, ilgili her isteğin bugün hata verdiği anlamına gelmez. Parametreleri bilinçli olarak kaldırın ve eskiden onlara bağlı davranışı ayrıca doğrulayın.

Bu matris önerilen bir uygulama incelemesidir. Geçerli bir istek ilk kapıdır; eşdeğer iş sonucu, aynı akıl yürütme çabası veya daha az toplam harcama kanıtı değildir. Ortak bir sarmalayıcı değişikliği eski varsayımı sessizce geri getirmesin diye her kaldırılan varsayım için olumsuz bir test örneği saklayın.

Google: Gemini 3.8 Flash geçiş listesi · Google: Gemini 3.6 ve 3.5 Flash-Lite API değişiklikleri

4. Düşünme çabasını açıkça seçin, ardından karşılaştırın

Gemini 3.8 Flash low, medium ve high düzeylerini kabul ediyor; varsayılan medium, minimal ise desteklenmiyor. Flash-Lite ayarını her modele taşımayın. Yönlendirici, bütün modellere aynı ayarı eklemek yerine model ile düzeyin oluşturduğu çifti doğrulamalı.

Aşağıdaki Interactions REST gövdesi, sentetik ve salt okunur bir durum için çalıştırılmamış örnektir. Sunucuda tutulan API anahtarıyla POST https://generativelanguage.googleapis.com/v1beta/interactions adresine gönderilebilir. Bir üretim ayarı ya da ölçüm sonucu değil, istek biçimini gösterir. store=false arka plan çalışmasıyla uyumsuzdur ve daha sonra previous_interaction_id ile devam etmeyi engeller; sağlayıcının bütün saklama süreçleri için sıfır tutma garantisi değildir.

Çabayı yükseltmeden önce aynı kabul örneklerinde low ile medium'u karşılaştırın. Çıktı sınırı, zaman aşımı ve araç çağrısı bütçesi ayrı denetimlerdir. Çok kısa çıktı sınırı teslim edilecek sonucu kesebilir; düşünme düzeyi seçiminin yerine kullanılmamalıdır.

{
  "model": "gemini-3.8-flash",
  "store": false,
  "input": "Sentetik test: [7, 3, 7] içindeki yinelenen kimlikleri listele. Harici araç çağırma.",
  "generation_config": {
    "thinking_level": "low"
  }
}

Google: Gemini 3.8 Flash geçiş listesi · Google: Interactions durumu, tur ayarları ve saklama · Google: 3 Kasım iş maliyeti yönlendirme deneyi

5. İmzaları gerçek bir araç döngüsünde koruyun

Düşünce imzası, içeriği okunamayan protokol durumudur. Bir yanıt, uygulanacak talimat veya akıl yürütmenin okunabilir dökümü değildir. GenerateContent'te içerik parçalarına eklenebilir; Interactions'ta ilgili durum thought adımlarında ve belirli yerleşik araç adımlarında taşınır. Geçmişi yalnızca görünen metinden oluşturmak, sonraki turun ihtiyaç duyabileceği bilgiyi siler.

Depolanan Interactions için previous_interaction_id, bu durumu sunucunun yönetmesini sağlar. Durumsuz tekrarda dönen thought adımlarını ve ilgili yerleşik araç imzalarını değiştirmeden yeniden gönderin. İki gösterimi ayırın; evrensel bir imza alanı icat etmeyin, opak değeri çevirmeyin, özetlemeyin veya yeniden üretmeyin.

• En azından kullanıcı isteği, modelin araç çağrısı, araç sonucu ve son yanıtı tekrar edin; tek turlu selamlaşma sürekliliği sınamaz.
• Akışlı ve akışsız yanıtları ayrı test edin. İmza deltası dahil tamamlanmış protokol olaylarını koruyun; metnin gelmesi turun bittiğini kanıtlamaz.
• Kaybolan thought adımı, kesilmiş imza ve bilinmeyen alanları atan serileştirici için olumsuz örnekler ekleyin. Her API'de aynı HTTP kodunu varsaymak yerine gerçek hatayı veya yanlış devamı kaydedin.

Google: düşünme, imzalar ve akış durumu

6. Araç sonuçlarını eşleyin ve yinelenen etkileri durdurun

Interactions protokolünde function_result, ilgili çağrıyı call_id ve işlev adıyla belirtir. Bağdaştırıcınız her çağrıya, başarısızlık dahil, tam bir eşleşen sonuç döndürmeli. Paralel sonuçları yalnızca dizi sırasına göre bağlamayın: aynı isimli iki işlev farklı argümanlarla çağrılmış olabilir.

Protokolün doğru eşleşmesi iş düzeyinde idempotans sağlamaz. Yazma başarılı olup ağ onayı kaybolursa bütün ajan turunu tekrar etmek eylemi yineleyebilir. Ayrı bir iş operasyonu anahtarı ve etki kaydı tutun; modelin çağrı kimliği kalıcı işlem kimliği değildir. Geçiş tekrarında yazmaları, niyeti kaydeden ve kopyayı reddeden bir sahte araçla değiştirin.

Interactions'ta geçmiş zincirlense bile tools, system_instruction ve generation_config yalnızca geçerli etkileşime uygulanır. Gereken politika ve ayarı her turda yeniden verin. Konuşmanın korunması, önceki araç izinlerinin veya düşünme ayarının devralındığını göstermez.

Google: işlev çağrıları ve sonuç eşleme · Google: Interactions durumu, tur ayarları ve saklama

7. Çıktı sözleşmesini ve her veri türünü doğrulayın

Yapılandırılmış çıktı biçimi sınırlar, değerin doğruluğunu garanti etmez. Kimlikleri, tarihleri, aritmetiği, izinli enum değerlerini ve iş ilişkilerini istemcide denetleyin. Belgelenen JSON Schema alt kümesi bütün kısıtları zorlamaz; uzunluk veya benzersizlik kontrollerinin tamamını kısıtlı çözümlemeye bırakmayın.

Her iki hedefin belgeleri metin, görüntü, video, ses ve PDF girdisi ile metin çıktısı listeliyor. Ses okuyabilmek konuşma üretmek, görüntü okuyabilmek resim üretmek değildir. Live, konuşma sentezi veya görüntü üretimi uç noktaları, bu metin modeli değişimini kopyalamak yerine kendilerine özgü inceleme gerektirir.

• Belge testinde bilinen sayfa ve yanıt anahtarı kullanın; yalnızca akıcı metin değil, değer ve kanıt konumu isteyin.
• Grafik örneğine belirsiz eksen veya birim ekleyin; tahmini sayı yerine açık belirsizlik yanıtını kabul edin.
• JSON çıkarmada eksik veri, yinelenen kimlik ve fazla alanları deneyin; hem serileştirmeyi hem alan kurallarını denetleyin.
• Araç medya döndürüyorsa doğru içerik türü ve yükün korunduğunu doğrulayın; yalnızca dosya adı veya metin açıklaması yeterli değildir.

Google: yapılandırılmış çıktı ve şema sınırları · Google: Gemini 3.8 Flash yetenekleri · Google: Gemini 3.5 Flash-Lite yetenekleri

8. İnandırıcı yanıtı reddedebilen tekrar testleri kurun

Sabit araç sonuçlarıyla sentetik veya onaylı anonimleştirilmiş örnekler kullanın. İstem ayarında hiç kullanılmayan ayrı bir test kümesi ayırın. Her örneğin beklenen sonucunu ve önemini yazın. Kanıtlı yanıtı, doğru reddi ve güvenli devri ayrı sonuçlar olarak değerlendirin; her tamamlanan yanıtı başarılı iş saymayın.

Aşağıdaki matris özgün test tasarımıdır, çalıştırılmış test raporu değildir. Aday sonuçları görmeden önce yayın eşiklerini belirleyin. Kolay çıkarım örnekleri mükerrer ödemeyi, kimlik sızıntısını veya çok adımlı araç hatasını gizlemesin diye sonuçları iş akışına ve hatanın ciddiyetine göre ayırın.

Google: düşünme, imzalar ve akış durumu · Google: işlev çağrıları ve sonuç eşleme · Google: yapılandırılmış çıktı ve şema sınırları

9. Başarısız denemeleri kabul edilen işin maliyetine katın

Google'ın 3 Kasım mühendislik yazısı başarılı iş başına maliyetle yönlendirmeyi inceliyor. Elli istemden oluşan, her ayar için tek kez çalıştırılan ve sınırlı puanlanan deney, sağlayıcının yayımladığı bir örnektir; bizim ölçümümüz, bağımsız bir sıralama veya üretim garantisi değildir. Yararlı fikir, yalnızca token fiyatını değil bütün işi karşılaştırmaktır.

Kendi değerlendirme döneminizde model, yönlendirici, tekrarlar, harici araçlar ve ayrıca ölçülen altyapının gerçek ücretlerini toplayın. Bağımsız kabul ölçütünü geçen iş sayısına bölün. Hiçbiri geçmezse 'kabul edilen iş yok' ve harcanan tutarı bildirin; sıfıra bölmeyin veya başarısız denemeleri silmeyin. Fatura toplamına dahil düşünme tokenlarını yeniden eklemeyin.

Girdi, çıktı, düşünme ve önbellek metriklerini mutabakatı yapılmış ücretin yanında tanı bilgisi olarak saklayın. Geçici tanıtım fiyatını kalıcı saymadan mevcut ve duyurulmuş gelecek dönemleri karşılaştırın. Gecikme dağılımı, tekrarlar, etkiler ve insan devrini de raporlayın; düşük ortalama fatura sürekli elle düzeltme ihtiyacını gizleyebilir.

kabul_edilen_is_maliyeti = mutabakatli_toplam_maliyet / kabul_edilen_isler

# Uygulamanın önerilen değerlendirme kaydı; Gemini API alanları değil
case_id, model, endpoint, sdk_version, prompt_digest
thinking_level, state_mode, tool_schema_digest
accepted, failure_category, latency_ms, retry_count
reconciled_cost, rate_date, cache_condition, intended_effects

Google: Gemini Developer API fiyatları · Google: 3 Kasım iş maliyeti yönlendirme deneyi

10. Yönlendiriciyi ancak basit temeli geçtiğinde ekleyin

Önce birkaç sabit politika karşılaştırın: uygun işlerin tamamında Flash-Lite, 3.8 Flash low ve 3.8 Flash medium. Aynı kalite koşullarını ve test kümesini koruyun. Desteklenen bu birleşimler arasında seçim yapan yönlendiriciyi sonra deneyin. Aksi halde karmaşık çözüm, yalnızca kötü ayarlanmış bir temel karşısında ekonomik görünebilir.

Yönlendirici kolay gibi belirsiz etiketlerden çok, sıralı araç kanıtı gerekip gerekmediği veya yazma yapılıp yapılmadığı gibi gözlenebilir özellikleri ayırmalı. Belirsiz veya sonuçları ağır işleri doğrulanmış yola ya da insan incelemesine gönderin. İstem uzunluğu tek başına karmaşıklık ölçütü değildir: kısa durum simülasyonu uzun bir doğrudan çıkarmadan daha fazla akıl yürütme gerektirebilir.

Sıcak ve soğuk bağlamı ayrı değerlendirin, model değişimini açıklayan metaveriyi tutun. Yönlendirme bağlamın yeniden kullanımını ve durum koşullarını değiştirebilir. Oturum ortasında geçişi sınayın; yeni bir isteğin başarısı sürekliliği kanıtlamaz. Sonraki model, konuşmada zaten bulunan çıktı türlerini girdi olarak desteklemeli.

• Kuralları sürümleyin, geliştirme kümesinde ayarlayın ve ayrılmış testten önce dondurun.
• Yönlendirici ücretini, yükseltme tekrarlarını ve ucuz yolda harcanmış işi aynı iş kaydına dahil edin.
• Yükseltme zinciri sınırlı olsun ve son devir noktası bulunsun; birbirine sürekli yeniden dene diyen iki ajan kurtarma değildir.
• Yönlendiriciyi ancak önceden belirlenen kabul düzeyini koruyor ve gereken işletim metriğini iyileştiriyorsa kullanın. Tasarruf yüzdesi varsayılmıyor.

Google: Interactions durumu, tur ayarları ve saklama · Google: 3 Kasım iş maliyeti yönlendirme deneyi

11. 1 Aralık'tan sonra da çalışan bir yedek yol hazırlayın

Önce salt okunur işleri tekrar edin, ardından gerçek etkileri kapalı gölge karşılaştırmalar yapın. Gölge yol aynı e-postayı, kayıt değişikliğini veya ücreti tekrarlamamalı. İlgili kabul kümesi geçildikten sonra sınırlı bir grubu yeni ayara taşıyın; kullanılan yolu ve hata sınıfını gözlenebilir kılın.

Duyurulan yönlendirmeden sonra ayarı gemini-2.5-pro veya gemini-2.5-flash'e çevirmek eski modeli geri getirmez. Gerçek yedek, gerekli örneklerden geçmiş ve halen desteklenen açık bir yapılandırma ya da onaylı insan kuyruğudur. Eski bağdaştırıcıyı yararlı ve destekli olduğu sürece tutun; kodun saklanması sağlayıcı erişiminin saklanması değildir.

• Tekrarlanan etki, bozuk kanıt bağlantısı, sürekli geçersiz istek ve bütçe aşımı için durdurma koşulları koyun.
• Yedeği aynı veri sınırları ve araç izinleriyle test edin; kurtarma yolu erişimi sessizce genişletmemeli.
• Belgesiz bir geçiş saatine veya uzatmaya güvenmek yerine son tarihten önce bitirin.

Google: 2 Kasım Gemini API sürüm notları · Google: kaldırma, erişim ve yönlendirme takvimi

12. Başka bir mühendisin tekrarlayabileceği kayıt bırakın

Kaynak inceleme tarihi, etkilenen yollar, tam hedef ayarları, örnek özetleri, puanlama kuralları, hatalı örnekler ve yedek sorumlusu kayıtta bulunsun. Ölçülen sonuçları planlanan kontrollerden ayırın. Bu yazının belgeleri 4 Kasım 2026'da incelendi; istek, matris ve yayın akışı çalıştırılmamış örneklerdir. Hesap uygunluğu, kota, gecikme veya tasarruf doğrulanmadı.

Aşağıdaki görev taslağını yetkili olduğunuz projede kullanın. Somut çıktılar ister ve canlı yan etkilerden önce durur. Kurum başka bir veri yolunu onaylamadıysa üretim konuşmalarını sentetik örneklerle değiştirin. Uygulama sırasında resmi kaynaklara yeniden bakın; takvimler ve desteklenen alanlar değişebilir.

Gemini 2.5 geçişini ücretli API çağırmadan ve üretimi değiştirmeden incele.
1. Model kimliği, uç nokta, SDK, istem ve araç bağdaştırıcılarını çıkar.
2. Her yolu açık bir desteklenen hedefe ve düşünme düzeyine eşle.
3. Önceden doldurulmuş model turlarını, kaldırılan parametreleri ve atılan durumu belirle.
4. Sıralı/paralel araçlar, kesik akış ve yinelenen etkiler için sentetik örnek öner.
5. Kabul matrisi, maliyet kaydı ve yedek doğrulama planı üret.
Kodda doğrulananı, tarihli resmi belgeyi, çıkarımı ve bilinmeyeni ayrı işaretle.

Google: 2 Kasım Gemini API sürüm notları · Google: Gemini 3.8 Flash geçiş listesi · Google: Gemini 3.6 ve 3.5 Flash-Lite API değişiklikleri · Google: API anahtarları, projeler ve kimlik bilgileri