Kısaca
- Gemini API’de yeni görsel üretimi için Nano Banana modelleri kullanılabiliyor; Imagen artık kullanılamıyor.
- Nano Banana 2.1, belgede yeni projeler için önerilen model olarak listeleniyor.
- Metin istemiyle görsel üretilebildiği gibi bir görsel ve metin birlikte verilerek düzenleme de yapılabiliyor.
- API örneklerinde çıktı, etkileşim yanıtındaki output_image alanından alınabiliyor.
Bu rehberde ne öğreneceksiniz?
Bu eğitim, Gemini API üzerinden Nano Banana ile mimari ve iç mekân odaklı görsel üretme akışını ele alıyor. Bir metin istemini sahne, malzeme, ışık ve kadraj gibi anlaşılır bileşenlere ayırmayı; mevcut bir görseli metinle düzenleme isteği göndermeyi ve üretilen görsel çıktısına erişmeyi öğreneceksiniz. Aşağıdaki örnek istemler, mimari tasarım süreçlerinde fikir geliştirme ve sunum eskizi oluşturma amacıyla bu rehber için yazıldı. Üretilen görselin proje ölçülerini, teknik çizimleri veya gerçek malzeme performansını doğruladığı varsayılmamalıdır.
İş akışının temelinde, sahneyi yazıyla tarif etmek ve modelden görsel bir çıktı istemek var. Düzenleme içinse kaynak görsel ile değişiklik talebi aynı isteğe eklenebiliyor. Her iki yöntemde de hedefin açık tarif edilmesi, sonuçları değerlendirirken neyin işe yarayıp yaramadığını görmeyi kolaylaştırır.
Gereksinimler: model, erişim ve görsel
Google’ın Gemini API belgelerinde Nano Banana, görsel üretimi ve görsel üzerinde konuşmalı düzenleme için kullanılan model ailesinin adı olarak geçiyor. Yeni projeler için önerilen seçenek Nano Banana 2.1; model kimliği gemini-nano-banana-2.1. Dokümanda ayrıca Nano Banana 2 Lite, Nano Banana 2, Nano Banana Pro ve önceki nesil Nano Banana da sıralanıyor. Modeller arasında seçim yaparken kaynakta belirtilen hız, maliyet verimliliği ve görsel işin karmaşıklığı gibi ayrımları göz önünde bulundurmak mümkün; ancak burada sayısal bir fiyat veya performans kıyaslaması yapılmıyor.
API ile çalışmak için Gemini API erişimi gerekir. Kaynağın REST örneğinde istek, x-goog-api-key başlığı üzerinden API anahtarıyla gönderiliyor. Dokümanda Python, JavaScript, Java, Go ve REST örnekleri bulunuyor. SDK kurulumu veya hesap oluşturma adımlarının ayrıntıları bu eğitim kaynağında yer almadığından, belirli bir kurulum yolu tarif edilmiyor.
Mevcut bir görseli düzenlemek için görsel dosyasını isteğe eklemeniz gerekir. Yüklemeden önce görselin kullanım haklarının kontrol edilmesi önem taşıyor: Google, kullanıcıların yükledikleri görseller için gerekli haklara sahip olması ve başkalarının haklarını ihlal eden içerik oluşturmaması gerektiğini hatırlatıyor.
Adım adım istem hazırlama
Sahneyi ve görsel hedefi belirleyin. Önce görüntünün neyi göstermesi gerektiğini netleştirin: örneğin bir konutun oturma alanı, bir kafe iç mekânı veya avlulu bir yapı. Ardından yüzeyleri, ışığı, atmosferi ve bakış noktasını tarifinize ekleyin. Birbiriyle ilgisiz birçok hedefi aynı isteme doldurmak yerine tek bir ana fikre odaklanın.
Metinden ilk taslağı üretin. Aşağıdaki örnek, çağdaş bir oturma alanı için özgün olarak hazırlandı. İstem, oda işlevinin yanı sıra malzeme, gün ışığı ve kamera yüksekliği gibi görsel kararları da tarif ediyor.
Create an architectural visualization of a calm contemporary living room with pale oak flooring, a limestone feature wall, linen seating and a large window facing a planted courtyard. Soft morning daylight, realistic material textures, eye-level wide interior view, restrained neutral palette, no people.İlk çıktıyı incelerken hangi tariflerin görüntüye yansıdığına bakın. Kompozisyon genel olarak doğru, ancak ışık veya malzeme etkisi istediğiniz gibi değilse sonraki denemede o unsuru daha açık anlatın. Böylece istemdeki hangi değişikliğin sonucu etkilediğini takip etmek kolaylaşır.
Dış mekân sahnesini farklı bir istemle deneyin. Bir yapı görselinde cepheyi tarif etmek tek başına yeterli olmayabilir; çevre, bakış yönü ve ışık da sahnenin anlatımını belirler. Bu örnek, küçük ölçekli bir konut fikri için yazılmıştır.
Create a photorealistic architectural visualization of a compact courtyard house with a simple plaster facade, timber shutters and a shaded outdoor dining area. Show the building from the garden at eye level, with soft late-afternoon light, mature planting and a quiet residential atmosphere.Burada yapının görünümü, bahçeden bakış ve günün ışık koşulları birlikte belirtiliyor. Böyle bir sonuç tasarım alternatiflerini tartışmak için görsel bir başlangıç sağlayabilir; uygulama projesindeki ölçü ve detayların doğruluğunu göstermez.
Var olan bir görsel üzerinde değişiklik isteyin. Gemini API dokümanı, metin talebinin yanında bir görsel de göndererek sahnede belirli dönüşümler yapmaya yönelik bir akış sunuyor. Örneğin mevcut görüntüdeki bir yüzeyin görünümünü, ışık hissini veya renk düzenini değiştirmek isteyebilirsiniz. Aşağıdaki istemde, değişmesi beklenen unsurlar kadar sabit kalması gerekenler de tarif ediliyor.
Edit the provided interior image by changing the wall finish to warm light limestone and adding soft indirect lighting along the ceiling edge. Keep the room layout, camera viewpoint, furniture positions and window openings unchanged.API isteğinde metin ve görsel birlikte iletilir. Kaynak, daha fazla görsel kullanımı, büyük yükler ve desteklenen görsel türleri için görsel anlama rehberine yönlendiriyor; bu nedenle burada dosya boyutu veya biçim sınırı belirtilmiyor. Çıktıyı incelerken, değişmesini istemediğiniz oda yerleşimi ve kamera bakışı gibi unsurların korunup korunmadığını ayrıca kontrol edin.
Görsel çıktıyı alın ve değerlendirin. Dokümandaki örneklerde üretilen görsel, etkileşim yanıtındaki
interaction.output_imagealanı üzerinden elde ediliyor. Görseli tasarım kararlarının doğrulanmış kaydı gibi değil, değerlendirilmesi gereken bir taslak olarak ele alın. İstemde belirtilen malzeme ve sahne özelliklerinin çıktıda nasıl göründüğünü kontrol edin; kritik proje kararlarını ilgili çizimler ve ürün bilgileriyle ayrıca doğrulayın.
Sık yapılan hatalar
Bir istemde çelişkili hedefler vermek: Birbirini tutmayan ışık, atmosfer veya malzeme tarifleri görsel hedefi belirsizleştirebilir. Önce ana sahneyi kurup sonra tek tek ayrıntı ekleyin.
Düzenleme sırasında korunacak unsurları atlamak: Yalnızca değişiklik talebini yazmak yerine, sabit kalmasını beklediğiniz kompozisyon veya yerleşim öğelerini de ifade edin.
Çıktıyı teknik doğrulama yerine kullanmak: Kaynak, üretilen görsellerin proje ölçülerini ya da gerçek ürün özelliklerini doğruladığını belirtmiyor. Görselleri fikir ve sunum çalışması olarak değerlendirin.
Görsel haklarını göz ardı etmek: Düzenleme için kullanılacak dosyanın kullanım haklarını önceden kontrol edin ve başkalarının haklarını ihlal eden taleplerden kaçının.
Kapatılmış Imagen akışını kullanmaya devam etmek: Google’ın geçiş dokümanına göre Imagen modelleri Gemini API’de artık kullanılmıyor. Eski entegrasyonlar için güncel görsel üretim yöntemine geçiş planlanmalı.
Mimarlık ve görselleştirme iş akışına etkisi
Mimarlar, iç mimarlar ve görselleştirme ekipleri bu yöntemi erken tasarım aşamasında atmosfer, malzeme birlikteliği veya sunum fikri araştırmak için değerlendirebilir. Mevcut bir görsel üzerinde metinle değişiklik talep edilebilmesi, bir taslak üzerinden alternatifleri konuşmaya elverişli bir çalışma biçimi sunuyor. Bununla birlikte kaynak, sonuçların proje geometrisine veya gerçek ürün özelliklerine uygunluğunu garanti etmiyor. Kritik kararlar proje belgeleri ve ilgili ürün bilgileri üzerinden ayrıca doğrulanmalı.
Ekipler işe başlamadan önce API erişimini, kullanılacak modeli ve görsel kullanım haklarını netleştirmeli. Belgeler farklı Nano Banana modellerini listeliyor; ancak burada belirli bir fiyat, donanım gereksinimi veya mimari yazılımlarla doğrudan entegrasyon bilgisi verilmiyor. Bu nedenle mevcut iş akışına ekleme kararı alınırken hizmetin erişim ve maliyet koşulları ayrıca incelenmeli. Bir görsel düzenleme akışında da başlangıç görselinin hakları ve sonuçta korunması gereken proje unsurları göz önünde bulundurulmalı.
Sonraki adımlar
İlk denemede tek bir sahne seçip kısa ve açık bir istem hazırlayın. Ardından sonucu inceleyerek yalnızca bir görsel özelliği değiştirin; böylece yeni tarifin etkisini karşılaştırabilirsiniz. Düzenleme için bir referans görsel eklediğinizde, değiştirilmesi istenen unsurları korunacak kompozisyon öğelerinden ayrı tarif edin.
Önceki Imagen tabanlı API akışlarını kullanan ekipler için Google’ın geçiş notu, eski model adlarıyla devam edilmemesini ve istek yönteminin de yenilenmesini söylüyor: görsel üretimi Nano Banana model adlarıyla yapılmalı; eski generate_images çağrısı yerine client.models.generate_content kullanılmalı. K1’de gemini-2.5-flash-image veya gemini-3.1-flash-image gibi seçenekler örnekleniyor. Güncel model seçenekleri ve istek biçimi için Gemini API’nin görsel üretim rehberi esas alınmalı.
Kaynak ve lisans
Google AI for Developers’ın “Nano Banana image generation” ve “Generate images using Imagen” rehberleri kullanıldı. Her iki kaynak da CC BY 4.0 lisanslıdır; içerik mimari ve iç mekân iş akışına uyarlanarak yeniden yazılmıştır. Örnek istemler bu rehber için özgün olarak hazırlanmıştır.
Sık sorulan sorular
Nano Banana 2.1 ile mimari görsel nasıl üretilir?
Gemini API’de `gemini-nano-banana-2.1` modeliyle metin istemi gönderilebilir. API örneklerinde oluşturulan görsel `interaction.output_image` alanından alınır.
Nano Banana mevcut bir iç mekân görselini düzenleyebilir mi?
Dokümana göre bir görsel ve metin istemi birlikte verilerek görüntüde değişiklik yapılabilir; örneğin yüzey, stil veya renk düzeni üzerinde çalışılabilir.
Imagen modelleri Gemini API’de hâlâ kullanılabiliyor mu?
Hayır. Google’ın rehberi Imagen modellerinin kapatıldığını ve Gemini API’de artık kullanılamadığını belirtiyor; geçiş için Nano Banana modelleri öneriliyor.
Kaynaklar
2 kaynakKaynak metinler yeniden yayımlanmaz; kısa alıntılar tırnak içinde verilir, geri kalanı özgün özet ve yorumdur.
Türkiye’deki ofisler ve öğrenciler için metinle görsel üretme ve mevcut taslak üzerinde düzenleme yapma, erken aşama sunum seçeneklerini konuşmayı kolaylaştırabilir. Özellikle atmosfer ve malzeme fikri araştırırken işe yarayabilir; ancak çıktı, ölçülü proje verisinin veya teknik doğrulamanın yerine konmamalı.
Uygulamaya geçmeden önce API erişimi ve model seçimiyle birlikte maliyet koşulları da kontrol edilmeli; kaynak belirli fiyat veya donanım gereksinimi vermiyor. Ekipler ayrıca referans görsellerin haklarını gözetmeli ve görsel sonuçların gerçek ürün ya da proje detaylarını doğruladığını varsaymamalı.




Yorumlar 0