Gemini API’de Imagen’den Nano Banana’ya geçiş: adım adım rehber

Bu rehberde ne öğreneceksiniz?

Google’ın Gemini API belgelerine göre Imagen modelleri kapatıldı ve artık API üzerinden kullanılamıyor. Bu nedenle Imagen’e bağlı bir görüntü üretme entegrasyonunu taşırken üç noktayı birlikte ele almak gerekiyor: model adı, çağrı yöntemi ve dönen yanıtın işlenmesi. Bu rehber, mevcut entegrasyonda bu değişiklikleri nasıl kontrol edebileceğinizi anlatıyor.

Anlatım, API’yi kullanan uygulama ve iş akışlarına yönelik bir geçiş kontrol listesidir. Kaynak belgede belirli bir programlama dili için kurulum komutları, paket sürümü veya tam bir kod örneği yer almıyor. Bu yüzden burada örnek kod ya da kaynakta bulunmayan arayüz adımları verilmiyor.

Gereksinimler ve geçiş öncesi hazırlık

Geçiş, Gemini API üzerinden görsel üretimi yapan Imagen bağlantılarını kapsıyor. Kaynakta bir hesap türü, ücret, kota ya da donanım gereksinimi açıklanmıyor. Uygulamaya başlamadan önce projenin mevcut API çağrılarını ve görsel yanıtı kullanan bölümlerini belirlemek yeterli bir ilk adımdır.

Kod tabanında, ayar dosyalarında veya istek şablonlarında Imagen model adlarının kullanıldığı yerleri listeleyin. Ardından görsel üretim çağrısının hangi yöntemle yapıldığını ve API yanıtının hangi bölümde uygulama tarafından tüketildiğini not edin. Bu kontrol, değişikliğin yalnızca istek gönderme aşamasında kalmayabileceğini; yanıtı işleyen kısımda da düzenleme gerekebileceğini gösterir.

Adım adım Nano Banana’ya geçiş

1. Mevcut model adını belirleyin. Imagen’i kullanan istek noktalarını bulun ve uygulamanın hangi model adıyla çağrı yaptığını kontrol edin. Google, Imagen model adları yerine gemini-2.5-flash-image kullanılmasını veya gemini-3.1-flash-image gibi Nano Banana 2 modellerine geçilmesini öneriyor. Hangi seçeneğin kullanılacağına karar verirken entegrasyonun model seçimini yaptığı yeri güncelleyin; aynı ayarı kullanan birden fazla istek olup olmadığını da kontrol edin.

2. Çağrı yöntemini değiştirin. Google’ın geçiş notunda Imagen için kullanılan client.models.generate_images yöntemi yerine client.models.generate_content kullanılması belirtiliyor. Bu değişikliği model adı güncellemesinden ayrı bir kontrol olarak ele alın. Yeni model adı ayarlansa bile uygulama eski yöntemi çağırıyorsa geçiş tamamlanmış sayılmaz.

3. Yanıt işleme bölümünü gözden geçirin. Nano Banana’nın yanıtı, önceki kullanımda beklenebilecek özel bir görsel yanıt nesnesi biçiminde değil; görüntü verisi içeren içerik parçaları olarak döner. Uygulamanızın API yanıtını aldığı noktada hangi yapıyı okuduğunu inceleyin. Görsel verisinin uygulamanın devamındaki işlem adımlarına nasıl aktarıldığını da takip edin.

4. Uygulamanın kendi akışında doğrulayın. Model adı ve çağrı yöntemi değiştirildikten sonra bir görsel üretme isteğiyle akışı uçtan uca kontrol edin. Yalnızca isteğin gönderilmesini değil, yanıt içindeki görüntü verisinin uygulamanın beklediği sonraki adıma ulaşıp ulaşmadığını da sınayın. Google’ın bu geçiş notu belirli bir test senaryosu veya beklenen çıktı örneği vermediğinden, kontrolün kapsamı uygulamanın kullanımına göre belirlenmelidir.

5. Eski kullanımları ve dokümantasyonu temizleyin. Kodda ya da ekip içi teknik notlarda Imagen model adları ve eski yanıt biçimine ilişkin açıklamalar kalmış olabilir. Bunları güncellemek, sonraki bakım çalışmalarında kapatılmış bir model veya artık kullanılmayan yöntem üzerinden yeni bağlantı kurulması riskini azaltır. Bu adım API’nin yeni bir özelliği değil, geçiş sürecini anlaşılır tutmaya yönelik bir bakım önerisidir.

Sık karşılaşılan hatalar

Yalnızca model adını değiştirmek: Google’ın geçiş açıklaması model adıyla birlikte yöntemin ve yanıt işleme biçiminin de ele alınmasını gerektiriyor. Üç kontrolün tamamlanması, entegrasyonun yeni kullanıma göre değerlendirilebilmesi için önemlidir.

Eski yanıt yapısını beklemek: Nano Banana görüntü verisini içerik parçaları içinde döndürdüğünden, uygulamanın önceki bir görsel yanıt nesnesine göre yazılmış bölümü bu veriyi beklenen biçimde bulamayabilir. Yanıtı tüketen bileşeni geçiş planına dahil edin.

Kaynakta belirtilmeyen gereksinimleri varsaymak: Geçiş notu, belirli bir dil veya paket sürümü, ücret, kota ya da hesap koşulu bildirmiyor. Bu ayrıntıları kesin gereksinim gibi sunmak yerine, uygulamaya almadan önce ilgili güncel Gemini API belgelerinden doğrulayın.

Testi isteğin gönderilmesiyle sınırlamak: İstek gönderiminin başarılı olması, yanıt içindeki görsel verisinin uygulamanın sonraki adımlarında doğru kullanıldığını tek başına göstermez. Yanıt işleme bölümünü de test kapsamına alın.

Mimarlık, iç mekân tasarımı ve archviz iş akışlarına etkisi

Gemini API üzerinden görsel üretimini konsept çalışmaları, iç mekân alternatifleri veya başka bir görsel üretim adımında kullanan ekipler için bu değişiklik, mevcut entegrasyonun güncellenmesi anlamına geliyor. Imagen’e bağlı bir otomasyon varsa model adı, çağrı yöntemi ve yanıtı kullanan bölüm birlikte ele alınmalı. Üretilen görsel verisini proje akışında başka bir adıma aktaran uygulamalarda da bu aktarımın yeni yanıt biçimiyle uyumu kontrol edilmeli.

Kaynakta yerel donanım gereksinimi belirtilmediğinden, bu geçiş için belirli bir iş istasyonu veya GPU ihtiyacı çıkarmak mümkün değil. Fiyat ve kullanım koşulları da açıklanmıyor. Ofislerin ve görselleştirme ekiplerinin geçiş öncesinde API kullanım koşullarını ayrıca incelemesi; mevcut otomasyonun model, yöntem ve yanıt değişikliklerini test etmesi yerinde olur.

Sonraki adımlar

Önce Imagen’e bağlı çağrıları envanterleyin. Sonra Google’ın önerdiği model adlarından birini ve yeni çağrı yöntemini değerlendirin; son olarak görüntü verisini içeren yanıt parçalarının uygulamanızda nasıl işlendiğini doğrulayın. Daha ayrıntılı örnekler için Google, görüntü üretme kılavuzuna yönlendiriyor. Bu rehberde açıklanmayan uygulama ayrıntıları için güncel resmi belgelere başvurun.

Kaynak ve lisans

Bu rehber, Google’ın Gemini API’de Imagen’i kullanma ve Nano Banana’ya geçiş hakkındaki resmi İngilizce kılavuzundan uyarlanmıştır. Kaynak, aksi belirtilmediği sürece CC BY 4.0 lisansı altındadır. Metin Türkçeye uyarlanmış; kaynakta yer almayan kod örnekleri eklenmemiştir.