Gemini 2.5 Pro Kullanımdan Kaldırılıyor: 1 Aralık Yönlendirmesi ve Çözümü

2 Aralık'ta gemini-2.5-pro ile yaptığınız bir istek hata vermeyecek; yalnızca farklı bir model tarafından yanıtlanacak. Google, gemini-2.5-pro ve gemini-2.5-flash modellerini 2 Kasım 2026'da kullanımdan kaldırdı. 1 Aralık 2026'dan itibaren Gemini Developer API, bu kimlikleri yeni ücretlendirme üzerinden sırasıyla gemini-3.8-flash ve gemini-3.5-flash-lite modellerine otomatik olarak yönlendirecek. Sorun şu: Bu yalnızca bir model değişikliği değil, seviye değişikliği anlamına geliyor ve bazı parametreler artık çalışmayacak. Bu nedenle eski model adını aralık ayına kadar korumak güvenli bir geçiş planı değil.

Google'ın 1 Aralık için açıkladığı değişiklik

Google, Gemini Developer API üzerindeki gemini-2.5-pro ve gemini-2.5-flash modellerini kullanımdan kaldırdı. Her iki model de Google AI Studio seçim ekranından çıkarıldı ve API erişimi artık yalnızca ilgili modeli geçmişte kullanmış geliştiricilerle sınırlı. 1 Aralık 2026'dan itibaren istekler çalışmaya devam edecek; ancak farklı modeller üzerinde yürütülecek ve farklı ücretlerle faturalandırılacak.

Google'ın Gemini API kullanım dışı bırakma sayfasında belirtilen eşleştirme şöyle:

Google, her iki kararlı kimlik için yönlendirme tarihini 1 Aralık 2026 olarak veriyor. Duyuru ise 2 Kasım 2026 tarihli değişiklik günlüğü kaydında yer alıyor. Google DeepMind çalışanı Patrick Loeber, gelişmiş entegrasyonların geçiş kılavuzunu incelemesi gerektiği uyarısıyla bu kaydı bir PSA paylaşımında bağlantıladı.

Bu duyuru yalnızca Gemini Developer API ve AI Studio için geçerli. Vertex AI, Gemini 2.5 için ayrı bir kullanımdan kaldırma takvimi izliyor; Google Cloud aynı model adları için Ekim 2026 tarihlerini listeliyor. Firebase AI Logic de desteklenen modelleri ayrı bir listede belgeliyor. Vertex kullanıcıları, 1 Aralık tarihinin her yerde geçerli olduğunu varsaymak yerine Cloud konsolunu kontrol etmeli.

Google, 18 Eylül'de 2.5'in "kullanımdan kaldırılmadığını" söylemiş, ardından 2 Kasım'da modeli kullanımdan kaldırmıştı. Bu nedenle 1 Aralık tarihini kesin kabul etmek gerekiyor. Bu değişiklik için değişiklik günlüğü geçmişine bakabilirsiniz.

Yönlendirilen isteklerin aralık ve ocak ayındaki maliyeti

Gemini 2.5 Pro trafiği aralık ayında ucuzluyor, ancak ocak ayında girdi maliyeti yükseliyor. Gemini 2.5 Flash metin trafiğinin fiyatı geçişten sonra aynı kalırken ses girdisi ciddi biçimde ucuzluyor. Aşağıdaki tüm rakamlar, Google'ın Gemini API fiyatlandırma sayfasından alınan ve 3 Kasım 2026'da kaydedilen, ücretli katman için 1 milyon token başına liste fiyatlarıdır. Modeller özelinde daha fazla bilgi için Gemini 3.8 Flash fiyatlandırması ve Gemini 3.5 Flash-Lite incelemelerine bakabilirsiniz.

Gemini 3.8 Flash'ta istem uzunluğuna göre farklı fiyat bandı bulunmuyor. Bu nedenle 200 bin token üzerindeki uzun bağlamlı iş yükleri en büyük düşüşü görüyor. 300 bin token girdi ve 4 bin token çıktı içeren uzun doküman istemi, Gemini 2.5 Pro'da $2.50/$15.00 oranlarıyla yaklaşık $0.81; Gemini 3.8 Flash'ın aralık fiyatlarıyla ($0.75/$3.75) yaklaşık $0.24; ocak fiyatlarıyla ($1.50/$7.50) ise yaklaşık $0.48 tutuyor. Ocak ayında eski faturaya yaklaşan tek senaryo, kısa istemlerle yapılan ve girdinin ağırlıkta olduğu sohbetler.

Flash geçişinde tablo daha basit:

Bağlam önbellekleme, toplu işlem ve öncelikli isteklerde de aynı model geçerli: metin ücretleri korunurken ses ücretleri düşüyor. Bütçe hesaplarında gözden kaçabilecek bir ayrıntı var: Düşünme token'ları çıktı olarak ücretlendiriliyor ve yeni modeller uzun görevlerde farklı sayıda düşünme token'ı üretebilir. Bu yüzden aynı çıktı token sayısını varsaymayın. Tahmininizi kesinleştirmeden önce gerçek trafikten alınan usage_metadata değerlerini karşılaştırın.

Aynı model adı çalışan kodu neden bozabiliyor?

Otomatik yönlendirme, HTTP 200 yanıtını korurken arka plandaki çalışma modelini değiştiriyor. Gemini 3.x, Gemini 2.5'in kabul ettiği bazı istek kurallarını uygulamıyor. Bu nedenle model adını hiç değiştirmeyen kodlar 1 Aralık'tan sonra hata vermeye veya fark ettirmeden farklı sonuçlar üretmeye başlayabilir.

Gemini 3.x, thinking_budget yerine thinking_level kullanıyor. Gemini 3.8 Flash low, medium ve high değerlerini kabul ediyor, minimal değerini reddediyor; Gemini 3.5 Flash-Lite ise varsayılan olarak minimal kullanıyor. Her iki alanı birden göndermek HTTP 400 döndürüyor. Üstelik iki yeni model için aynı minimal yapılandırmasını paylaşmak 3.8 Flash yolunu bozuyor. Google; veri çıkarma, yönlendirme ve sınıflandırma için minimal, alt aracılar, araç çağrıları, kod çalıştırma ve çok adımlı akıl yürütme için ise aracın erken sonlandırılmasını önlemek amacıyla medium veya high öneriyor.

Gemini 3 geçiş kılavuzuna göre örnekleme ve geçmiş yönetimi kontrolleri de değişiyor. temperature, top_p ve top_k şu anda Gemini 3.x üzerinde yok sayılıyor; gelecek nesillerde HTTP 400 döndürmeleri bekleniyor. candidate_count desteklenmiyor. Son boş olmayan turu model rolüne sahip olan ya da klasik prefilling yönteminde olduğu gibi Translation: ile biten istekler HTTP 400 döndürüyor. Google bunun yerine system_instruction ve yapılandırılmış çıktıları öneriyor.

Fonksiyon çağrılarında da doğrulama sıkılaştırılıyor. Gemini 3.x, thought_signature alanını doğruluyor ve her FunctionResponse nesnesinin eşleşen çağrı kimliğini ve adını taşımasını istiyor. İmzayı silmek ya da model turunu imza olmadan yeniden oluşturmak, temiz bir hata yerine boş STOP yanıtlarına veya MISSING_THOUGHT_SIGNATURE sonuçlarına yol açabiliyor. Bu nedenle regresyon testleri yalnızca istisna oluşmadığını değil, yanıt metnini de doğrulamalı.

Duyurudan sonraki saatlerde gerçek kullanıcılar da tam olarak bu soruna dikkat çekti:

Google, Gemini 2.5'in sonu için artık bir tarih verdi. Burada önemli olan ayrıntı kullanımdan kaldırılması değil, otomatik yönlendirme. ... Yani kodunuz 404 hatası vermeyecek. Sessizce farklı bir modelle yanıt üretmeye başlayacak. — @VarunChopr17597

Aracınız hâlâ gemini-2.5-flash çağırıyorsa 1 Aralık'ta Gemini 3.5 Flash-Lite üzerinde çalışmaya başlayacak ve varsayılan düşünme seviyesi minimal olacak. — @MarMarLabs

Kasım ayında geçiş için 7 adımlı kontrol listesi

En güvenli yöntem, kasım ayında model kimliklerini açıkça değiştirmek, parametreleri güncellemek ve ardından aralık ayında kullanılacak yeni modelle yan yana değerlendirme yapmaktır. Yönlendiriciyi geçiş planı olarak kullanmayın.

1. Her referansı ve önizleme takma adlarını bulun. Etkilenmeyen Lite modelini hariç tutarak kodda, yapılandırmalarda, değerlendirme araçlarında ve dokümantasyonda iki model kimliğini arayın:

grep -rnE 'gemini-2\.5-(pro|flash)([^-]|$)' .

1. Kimlikleri açıkça değiştirin. Bir aralık sabahını beklemek yerine bir dal üzerinde gemini-2.5-pro yerine gemini-3.8-flash, gemini-2.5-flash yerine gemini-3.5-flash-lite kullanın.
2. Düşünme yapılandırmasını düzeltin. thinking_budget yerine thinking_level kullanın, değeri modele göre belirleyin (3.8 Flash üzerinde çalışan aracılar için medium veya high; Flash-Lite iş yükleri için açıkça minimal, medium ya da high) ve minimal değerini 3.8 Flash ile paylaşmayın.
3. Eski parametreleri temizleyin. Testlere başlamadan önce temperature, top_p, top_k, candidate_count ve model rolüyle biten prefilling turlarını kaldırın.
4. SDK ve araç bağlantısını güncelleyin. Güncel bir SDK sürümüne geçin, thoughtSignature dahil tüm model turlarını koruyun, FunctionResponse nesnesini hem çağrı kimliği hem de adını içerecek şekilde oluşturun ve çok turlu araç çağrılarını uçtan uca yeniden test edin.
5. Yeni model üzerinde temel testleri tekrarlayın. Üretim istemlerinde kaliteyi, gecikmeyi, çıktı uzunluğunu ve usage_metadata token sayılarını karşılaştırın; bir Flash modelinin her görevde Pro modelinin üslubunu koruyacağını varsaymayın.
6. Maliyeti iki kez yeniden hesaplayın. Pro yönlendirmesi için aralık bütçesini $0.75/$3.75, ocak ve sonrası için $1.50/$7.50 üzerinden hazırlayın; Flash yönlendirmesinde ses ve önbellek kalemlerini yeniden kontrol edin.

Hâlihazırda Gemini 3.x veya gemini-2.5-flash-lite kullanan ekipler bu geçişi atlayabilir. Diğer herkes 6. adımı 30 Kasım'dan önce tamamlamalı. Çünkü 1 Aralık'ta yeşil görünen bir test paketi yalnızca yönlendiricinin yanıt verdiğini, davranışın korunduğunu değil, gösterebilir.

Aracı geliştiren ekipler, araç ağırlıklı iş yüklerinde düşünme seviyelerini belirlemeden önce Gemini 3.8 Flash aracı görevleri fiyatlandırma analizini de incelemeli.

Sık sorulan sorular

Gemini 2.5 Pro, 1 Aralık 2026'da tamamen kapatılacak mı?

Hayır. Google, Gemini Developer API için 1 Aralık 2026'yı yönlendirme tarihi olarak belirtiyor: gemini-2.5-pro istekleri hata döndürmek yerine gemini-3.8-flash modeline yönlendirilecek.

Yönlendirilen istekler eski fiyatlarla mı, yeni fiyatlarla mı ücretlendirilecek?

Yeni fiyatlarla. 1 Aralık'tan sonra gemini-2.5-pro olarak gönderilen bir istek Gemini 3.8 Flash ücretleriyle, gemini-2.5-flash isteği ise Gemini 3.5 Flash-Lite ücretleriyle faturalandırılacak.

Yönlendirme otomatikse kodu değiştirmem gerekiyor mu?

Evet. Gemini 3.x üzerinde düşünme yapılandırması, örnekleme parametreleri, prefilling turları ve fonksiyon çağrısı bağlantısı farklı çalışıyor. Değiştirilmemiş kodlar yok sayılan parametrelerle, HTTP 400 hatalarıyla veya sessizce değişen akıl yürütme davranışıyla karşılaşabilir.

1 Aralık tarihi Vertex AI için de geçerli mi?

Hayır. 1 Aralık tarihi Gemini Developer API için geçerli. Google Cloud, Vertex AI ve Enterprise Agent Platform üzerindeki Gemini 2.5 için ayrı Ekim 2026 kullanımdan kaldırma tarihleri açıklıyor.

Gemini 2.5 Flash-Lite etkileniyor mu?

Hayır. Google, gemini-2.5-flash-lite modelinin kullanımdan kaldırılmadığını ve yeni bir duyuruya kadar kullanılabilir kalacağını belirtiyor.

Her iş yükü için hangi yeni model seçilmeli?

Önce göreve uygun modeli seçin, ardından değerlendirme yapın. Flash modelinin eski Pro modeline eşdeğer olduğunu varsaymayın.

30 Kasım'dan önce yapmanız gereken

Bu hafta iki model kimliğini değiştirin, düşünme ve araç bağlantısını düzeltin, Gemini 2.5 hâlâ yanıt verirken yeni modeller üzerinde güncel bir temel test sonucu oluşturun. Aralık ayındaki yönlendirme sistemi çalışır durumda tutabilir; ancak davranışı ve faturayı kontrol altında tutmanın yolu kasım ayında geçiş yapmaktan geçiyor.