Gemini 3.8 Flash'tan Gemini 4 Hydrogen'e Geçiş Rehberi

Gemini 3.8 Flash'tan Gemini 4 Hydrogen'e geçmek için model adını gemini-4-hydrogen yaparsınız, sonra artık hata veren ya da farklı davranan beş şeyi düzeltirsiniz: minimal düşünme seviyesi, açık önbellek, örnekleme parametreleri, çıktı sınırı ve varsayılan düşünme seviyesi. Geri kalan adımlar araç çağrıları, konuşma durumu ve faturayla ilgili ince ayarlar.

Bu rehber Google'ın dokümanlarına dayanan bir derlemedir; geçişi kendi projemde çalıştırmadım, modeli de kendim denemedim. Adımlar AI Studio'daki "What's new in Gemini 4 Hydrogen" sayfasından, fiyatlar Gemini API fiyat sayfasından alındı; ikisini de 14 Kasım 2026'da kontrol ettim. Tam ve çalıştırılabilir kod örneği için Google'ın sayfasına bakın. Kaynaklar sonda. Modelin kendisi için Gemini 4 Hydrogen nedir, fiyat katmanları için Hydrogen ücretsiz mi, kimler kullanabilir, rakiplerle kıyas için Hydrogen, Sonnet 5.5 ve GPT-6.1 Terra karşılaştırması yazısına bakabilirsiniz.

Geçmek zorunda mısınız?

Hayır, bugün için zorunlu değil. Google, Gemini 3.8 Flash için bir emeklilik tarihi yayımlamadı. API sürüm notlarında gemini-3.8-flash için kullanımdan kaldırma ya da kapatma kaydı yok; hatta 1 Aralık 2026'dan itibaren gemini-2.5-pro isteklerinin yönlendirileceği hedef 3.8 Flash. Google'ın Hydrogen için kullandığı ifade "önerilen yükseltme".

Geçişi düşündüren iki şey var:

• Fiyat avantajı Ocak'ta bitiyor. 3.8 Flash 31 Aralık 2026'ya kadar milyon token başına 0,75 $ girdi ve 3,75 $ çıktı. 1 Ocak 2027'den itibaren 1,50 $ ve 7,50 $ oluyor, yani Hydrogen'in bugünkü fiyatı.
• Google'ın bildirdiği fark büyük. Duyuruya göre Hydrogen, Terminal-Bench 4.1'de %57 alıyor, 3.8 Flash %18,2; varsayılan high ayarında görevleri 2,5 kat hızlı bitiriyor. Artificial Analysis'in endeksinde high seviyesinde Hydrogen 51, 3.8 Flash 31. İlk iki sayı Google'ın kendi ölçümü.

Bu benim yorumum: sizi sıkıştıran bir tarih yok, ama Ocak'tan sonra 3.8 Flash'ta kalmanın fiyat gerekçesi kalmıyor. Aralık ayı, geçişi acele etmeden test etmek için uygun bir aralık.

Neler değişti?

Konu	Gemini 3.8 Flash	Gemini 4 Hydrogen
Model kimliği	gemini-3.8-flash	gemini-4-hydrogen
Pencere	Ayrı bütçeler: 1 milyon girdi, 64 bin çıktı	Tek pencere: 1.048.576 token; girdi, düşünme ve çıktı paylaşıyor
En uzun çıktı	64 bin token	Varsayılan 65.536; long decode ile 1.048.576'ya kadar
Varsayılan düşünme seviyesi	medium	high
Düşünme seviyeleri		low, medium, high, xhigh; minimal hata verir
Düşünme ayarı		Yalnızca thinking_level; thinking_budget 400 döndürür (DataCamp)
Önbellek	Kodunuzda açık önbellek olabilir (cached_content, caches.create)	Açık önbellek yok; örtük önbellek varsayılan olarak açık
Örnekleme parametreleri	Kodunuzda temperature, top_p, top_k olabilir	Kaldırılmalı: aralık içi değer yok sayılır, aralık dışı değer 400 döndürür
Standart fiyat (milyon token)	31 Aralık 2026'ya kadar 0,75 $ / 3,75 $; sonra 1,50 $ / 7,50 $	1,50 $ / 7,50 $

Boş bıraktığım hücreler, elimdeki kaynaklarda 3.8 Flash tarafı için açık bir ifade olmayan yerler.

Adım adım geçiş listesi

Google'ın geçiş notlarındaki sıra:

1. Model adını değiştirin. gemini-3.8-flash yerine gemini-4-hydrogen.
2. Çıktı sınırını gözden geçirin. 3.8 Flash'ta girdi ve çıktı ayrı bütçelerdi; Hydrogen'de tek bir 1 milyonluk pencere var. Koda gömülmüş düşük max_output_tokens sınırlarını kaldırın ya da 65.536'ya yükseltin.
3. Düşünme seviyesini bilinçli seçin. Varsayılan artık high (3.8 Flash'ta medium idi). xhigh eklendi; minimal hata döndürüyor. Google medium ve high seviyelerinin ikisini de denemeyi öneriyor. Hydrogen yalnızca thinking_level kabul ediyor; DataCamp'in dokümana dayanarak aktardığına göre thinking_budget 400 döndürüyor.
4. Açık önbelleği kaldırın. Açık önbellek desteklenmiyor: cached_content ve caches.create kullanımlarını silin. Örtük önbellek, en az 4.096 tokenlık istemlerde varsayılan olarak devrede ve önbellekli girdide %95 indirim sağlıyor.
5. Örnekleme parametrelerini silin. temperature, top_p ve top_k alanlarını kaldırın. Aralık içindeki değerler yok sayılıyor; aralık dışındaki değerler 400 döndürüyor.
6. Araçları yerel olarak tanımlayın. Hiç araç tanımlamadan modelden düz metin olarak JSON araç çağrısı yazmasını istemeyin; bu MALFORMED_FUNCTION_CALL döndürebiliyor. Araçları yerel olarak tanımlayın ya da yapılandırılmış çıktı kullanın.
7. Konuşma durumunu doğru taşıyın. Interactions API'de previous_interaction_id kullanın. Geçmişi generateContent ile kendiniz yönetiyorsanız önceki model turlarını ve düşünce imzalarını değiştirmeden geri gönderin; tek bir düşünce imzasını paralel functionCall parçalarına kopyalamayın.
8. Uzun çıktı için iki alanı birlikte verin. 65.536 tokendan uzun çıktı için hem background: true hem de 65.536'nın üzerinde bir max_output_tokens gerekiyor. Yalnızca arka plan açılır da max_output_tokens verilmezse sunucu 65.536'da duruyor.
9. Faturayı yeniden hesaplayın. Düşünme tokenları ve iç temellendirme talimatları dahil işlenen bütün tokenlar faturalanıyor. Varsayılan high, 3.8 Flash'ın medium varsayılanından daha fazla düşünme tokenı demek.

Google'ın dokümanında kullanılan alanlar aşağıdaki gibi: model kimliği ve düşünme seviyesi. Bu tam bir örnek değil, yalnızca istek ayarı parçası; içe aktarma satırları ve çağrının tamamı için Google'ın sayfasına bakın.

model="gemini-4-hydrogen"
generation_config={"thinking_level": "xhigh"}

Uzun çıktı (long decode) örneği Interactions API üzerinden arka planı açıyor ve çıktı sınırını yükseltiyor:

background=True
generation_config={"max_output_tokens": 262144, "thinking_level": "high"}

Hangi hatayı görürsünüz?

Neden	Sonuç
thinking_level için minimal göndermek	Hata
thinking_budget göndermek	400 (DataCamp, dokümana dayanarak)
Aralık dışı temperature, top_p ya da top_k	400
Aralık içi temperature, top_p ya da top_k	Hata yok; değer yok sayılır
Araç tanımlamadan düz metin JSON araç çağrısı istemek	MALFORMED_FUNCTION_CALL dönebilir
background: true var, max_output_tokens yok	Sunucu 65.536 tokenda durur
cached_content ya da caches.create kullanmak	Açık önbellek desteklenmiyor; dokümanlar kaldırmanızı söylüyor

Tablodaki en sinsi satır dördüncüsü: aralık içindeki bir temperature değeri hata vermiyor, yalnızca işe yaramıyor. Kodunuz çalışmaya devam eder ama ayarın etkisi kalmaz; bu yüzden alanı silmek, sessizce bırakmaktan daha temiz.

Maliyete etkisi

Üç ayrı etki var ve üçü de aynı yöne çalışmıyor.

Birim fiyat. 31 Aralık 2026'ya kadar Hydrogen, 3.8 Flash'ın iki katı. 100.000 token girdi ve 5.000 token çıktılı bir istek 3.8 Flash'ta 0,1 × 0,75 $ + 0,005 × 3,75 $ = 0,09375 $, Hydrogen'de 0,1 × 1,50 $ + 0,005 × 7,50 $ = 0,1875 $ tutar. 1 Ocak 2027'den itibaren aynı token sayısında iki model aynı fiyata gelir.

Düşünme tokenları. Token sayısı aynı kalmayabilir. Varsayılan seviye medium yerine high olduğu için model daha çok düşünme tokenı üretir ve bunlar çıktı fiyatından faturalanır. Artificial Analysis'in Hydrogen ölçümü, seviyenin faturaya etkisini gösteriyor (Intelligence Index v5.0.1):

Düşünme seviyesi	Endeks	Endeks görevi başına maliyet	Görev başına süre
low	27	0,29 $	1,3 dk
medium	41	0,80 $	3,7 dk
high (varsayılan)	51	1,87 $	7,8 dk
xhigh	54	3,16 $	14,1 dk

high seviyesi medium seviyesinin iki katından fazla tutuyor, karşılığında 10 puan getiriyor. Hiçbir şey belirtmeden geçerseniz en pahalı ikinci seviyede çalışırsınız.

Token tasarrufu iddiası. Google, erken ortak testlerinde 3.8 Flash'a göre %12 ila %23 daha az token harcandığını söylüyor (karmaşık grafikler, SQL, veri ağırlıklı iş akışları). Bu, o ortakların iş yükleri için bildirilen bir sonuç; sizin işiniz için bir garanti değil.

Önbellek tarafında bir kolaylık var: örtük önbellek kendiliğinden çalışıyor ve önbellekli girdi milyon token başına 0,075 $. Katmanların tamamı fiyat yazısında.

Argon ya da Carbon'dan geliyorsanız

Bu yönde geçiş çok daha kısa, çünkü istek şeması aynı: yalnızca model adını değiştirirsiniz. Bilmeniz gereken farklar:

• Hydrogen varsayılan olarak high seviyesinde çalışır ve xhigh destekler; Argon ile Carbon varsayılan olarak medium kullanır ve high seviyesinde durur.
• Akışsız (non-streaming) adımlarda Hydrogen 65.536 tokena izin verir; Argon ve Carbon'da REST üzerinde adım başına sınır 32.768.
• Konuşmanın ortasında model değiştirmek için previous_interaction_id kullanılır.

Fiyat farkı da bu yönde lehinize: Argon ve Carbon 30 Kasım 2026'ya kadar 2 $ / 10 $, 1 Aralık'tan itibaren 4 $ / 20 $; Hydrogen 1,50 $ / 7,50 $.

Üretime almadan önce test planı

Bu bölüm benim önerim; dokümanların verdiği bir sıra değil. Her madde yukarıdaki bir veriye dayanıyor.

1. Kendi değerlendirme setinizi kullanın. Ürününüzün gerçekten yaptığı işlerden küçük bir görev seti hazırlayın ve iki modeli aynı sette karşılaştırın. Başkasının benchmark'ı sizin işinizi ölçmez.
2. medium ve high seviyelerini yan yana deneyin. Google'ın önerisi de bu. Artificial Analysis'te aradaki fark 10 puan ve iki kattan fazla maliyet; sizin işinizde hangi tarafın ağır bastığını ancak ölçerek görürsünüz.
3. Retleri izleyin. Model kartına göre otomatik güvenlik karşılaştırmalarında gerekçesiz retler 3.8 Flash'a göre 5,57 yüzde puanı kötüleşti. Eski modelin cevapladığı zararsız isteklerin yenisinde geri çevrilip çevrilmediğine bakın.
4. Çıktı uzunluğunu izleyin. Artificial Analysis, Hydrogen'i "very verbose" diye niteliyor: xhigh seviyesinde endeks için 304 milyon çıktı tokenı harcamış, ortanca 77,3 milyon. Çıktı tokenı faturanın pahalı kalemi.
5. Hata tablosundaki durumları tek tek tetikleyin. Özellikle sessizce yok sayılan örnekleme parametreleri ve 65.536'da duran arka plan çıktıları, hata olarak görünmeyebilecek durumlardır.
6. Geri dönüş yolunu açık tutun. Model adını yapılandırmadan okuyun. 3.8 Flash için bir kapatma tarihi olmadığından, sorun çıkarsa eski modele dönmek mümkün.

Terminalde çalışan ajanlar kuruyorsanız bir not: bağımsız ölçümlerde Hydrogen bu iş türünde Claude Sonnet 5.5'in gerisinde. Sayılar karşılaştırma yazısında.

Sık Sorulan Sorular

Gemini 3.8 Flash kapanıyor mu?

Yayımlanmış bir emeklilik tarihi yok ve API sürüm notlarında kapatma kaydı bulunmuyor. Google, Hydrogen'i "önerilen yükseltme" olarak tanımlıyor.

Model adını değiştirmek yeterli mi?

Hayır. minimal düşünme seviyesi hata verir, açık önbellek desteklenmez, aralık dışı örnekleme parametreleri 400 döndürür ve varsayılan düşünme seviyesi medium yerine high olur.

Hydrogen'de temperature ayarlanabiliyor mu?

Hayır. Google temperature, top_p ve top_k alanlarının kaldırılmasını söylüyor; aralık içindeki değerler yok sayılıyor, aralık dışındakiler 400 döndürüyor.

Hydrogen, 3.8 Flash'tan pahalı mı?

31 Aralık 2026'ya kadar birim fiyatı iki katı (1,50 $ / 7,50 $'a karşı 0,75 $ / 3,75 $). 1 Ocak 2027'den itibaren birim fiyatlar eşit; ama varsayılan high seviyesi daha çok düşünme tokenı ürettiği için faturanız yine farklı çıkabilir.

Açık önbellek kullanıyordum, ne yapmalıyım?

cached_content ve caches.create kullanımlarını kaldırın. Hydrogen'de örtük önbellek en az 4.096 tokenlık istemlerde kendiliğinden çalışıyor ve önbellekli girdide %95 indirim veriyor.

65.536 tokendan uzun çıktı nasıl alınır?

Long decode ile: background: true ve 65.536'nın üzerinde bir max_output_tokens birlikte verilir. Üst sınır 1.048.576 token; max_output_tokens verilmezse sunucu 65.536'da durur.

Kaynak

• Google AI Studio, What's new in Gemini 4 Hydrogen (14 Kasım 2026'da kontrol ettim): geçiş adımları, hata davranışları, kod alanları, Argon ve Carbon'dan geçiş notları.
• Google AI Studio, Gemini 4 Hydrogen model sayfası: pencere, çıktı sınırı, düşünme seviyeleri, önbellek desteği.
• Google AI Studio, Gemini API fiyatlandırma (14 Kasım 2026'da kontrol ettim): Hydrogen, 3.8 Flash, Argon ve Carbon fiyatları ve tarihleri.
• Google AI Studio, Gemini API sürüm notları: 3.8 Flash için kapatma kaydı olmaması, gemini-2.5-pro yönlendirmesi.
• Google, Introducing Gemini 4 Hydrogen (12 Kasım 2026, 13 Kasım'da güncellendi): 3.8 Flash'a göre hız, Terminal-Bench 4.1 ve token tasarrufu iddiaları.
• Google DeepMind, Gemini 4 Hydrogen model kartı: gerekçesiz retlerdeki 5,57 yüzde puanlık değişim.
• Artificial Analysis, Gemini 4 Hydrogen ve model sıralaması: düşünme seviyesine göre endeks, maliyet ve süre; çıktı tokenı sayısı; 3.8 Flash'ın endeks puanı.
• DataCamp, Gemini 4 Hydrogen (Josef Waples, 13 Kasım 2026): thinking_budget alanının 400 döndürmesi.