Nano Banana ile mimari görsel üretimi: API, prompt ve düzenleme rehberi

Bu rehberde ne öğreneceksiniz?

Bu rehber, Nano Banana’nın Gemini API üzerinden mimari görsel üretimi ve referans görsel düzenlemesinde nasıl kullanılabileceğini anlatıyor. Amaç, modeli bir BIM ya da 3D modelleme yazılımı gibi ele almak değil; tasarım fikrini görselleştirmek, atmosfer alternatifleri araştırmak ve mevcut bir görsel üzerinde metinle değişiklik istemek.

Örnekler, konut iç mekânı ve mimari konsept çalışmaları için özgün olarak hazırlandı. Promptlar, görselde bulunması istenen mekânı, malzemeleri, ışığı ve kompozisyonu tarif ediyor. Üretilen sonuçların teknik çizim, ölçülendirilmiş model veya uygulama projesinin yerine geçmediğini baştan hesaba katın.

Gereksinimler ve model seçimi

Kaynak belgeler, Gemini API erişimi ve API üzerinden etkileşim oluşturma akışını gösteriyor. Python örneğinde google paketinden genai istemcisi kullanılıyor; ayrıca REST örneği API anahtarını x-goog-api-key başlığında iletiyor. Belgeler, gerekli SDK sürümünü, fiyatı veya API erişim koşullarını bu içerikte belirtmiyor. Bunları uygulamaya başlamadan önce güncel API belgelerinden kontrol edin.

Google’ın model listesinde Nano Banana ailesinin farklı seçenekleri bulunuyor. Belgelerde yeni projeler için Nano Banana 2.1 öneriliyor; model kimliği gemini-nano-banana-2.1. Nano Banana 2, gemini-3.1-flash-image kimliğiyle listeleniyor. Nano Banana 2 Lite, hız ve maliyetin öncelikli olduğu işler için sunuluyor; kaynak, bu modelin birden çok referans girdisi veya ardışık çok turlu düzenleme için optimize edilmediğini belirtiyor. En karmaşık görsel görevler için Nano Banana Pro, gemini-3-pro-image kimliğiyle tanımlanıyor.

Eski Imagen modelleri Gemini API’de kapatılmış durumda. Google’ın geçiş notu, Imagen adları yerine Nano Banana modellerinin kullanılmasını ve görsel üretimi için generate_images yerine generate_content yöntemine geçilmesini söylüyor. Nano Banana belgelerindeki yeni API örneği ise interactions.create akışını gösteriyor. Bu nedenle eski kodu doğrudan çalıştırmak yerine seçilen modelin güncel dokümantasyonundaki yöntemi izleyin.

Adım adım görsel üretimi

1. İşin amacını belirleyin. İlk denemede tek bir çıktı türüne odaklanın: örneğin bir iç mekân konsept karesi. Mekân tipini, bakış açısını, gün ışığını ve temel malzeme karakterini prompta yazın. İlk denemede fazla sayıda alternatif isteğini aynı metne doldurmak yerine, sonucu gördükten sonra yeni bir düzenleme talebi oluşturun.

2. Modeli ve API akışını seçin. Belgelerde gösterilen Python örneğinde istemci genai.Client() ile oluşturuluyor, ardından interactions.create çağrısına model kimliği ve metin girdisi veriliyor. Üretilen görsel verisi interaction.output_image.data alanından alınıp Base64 çözümlemesiyle dosyaya yazılıyor. Aşağıdaki örnek, belgelenen yapıyı kullanır; çalıştırmadan önce API erişiminin ve Python istemcisinin ortamda hazır olduğundan emin olun.

from google import genai
import base64

client = genai.Client()
prompt = "Create a photorealistic architectural visualization of a compact contemporary apartment living room, viewed from the entrance. Pale oak cabinetry, warm off-white plaster walls, soft overcast daylight, restrained furniture, realistic material textures, no people."

interaction = client.interactions.create(
    model="gemini-nano-banana-2.1",
    input=prompt,
)

with open("ic-mekan-konsept.png", "wb") as image_file:
    image_file.write(base64.b64decode(interaction.output_image.data))

Bu örnek, tek bir metin girdisiyle görsel üretme yaklaşımını gösterir. Prompt İngilizce yazılmıştır; mimari tarifte mekân, görünüş, malzeme ve ışık tercihlerini açıkça sıralar. Üretilen dosyayı tasarım kararının doğrulanmış kaydı değil, konsept incelemesine yardımcı bir görsel olarak değerlendirin.

1. İlk promptu kontrollü biçimde kurun. Aşağıdaki metni konsept görseli için kullanabilir, proje tanımınıza göre oda işlevini ve malzeme tercihlerini değiştirebilirsiniz.

Create a photorealistic architectural visualization of a small contemporary library reading room, eye-level wide view from the entrance. Built-in pale oak bookshelves, a long communal table, matte mineral plaster walls, soft north-facing daylight, calm neutral palette, believable architectural proportions, no people, no text.

Prompt, bir okuma mekânı için görüş yönünü, donatıları, malzeme karakterini ve ışığı tarif eder. İlk sonuca göre tek bir öğeyi değiştirerek yeni bir varyasyon isteyin; örneğin ışık yönü ya da duvar kaplaması. Böylece hangi tarifin görseli değiştirdiğini daha rahat değerlendirebilirsiniz.

1. Referans görseli metinle düzenleyin. Belgeler, görsel girdiyle birlikte metin göndermeyi ve görselin üzerine ekleme, çıkarma, stil ya da renk düzenlemesi istemeyi destekleyen bir akış sunuyor. Bir görsel yüklemeden önce kullanım haklarının bulunduğunu doğrulayın. Aşağıdaki prompt, var olan bir oda görselinin atmosferini değiştirmeyi hedefler; bunu API isteğinde düzenlenecek görselle birlikte metin girdisi olarak iletin.

Using the provided interior reference image, keep the room layout and camera viewpoint recognizable. Change the lighting to soft late-afternoon daylight and make the wall finish warm lime plaster. Preserve the existing furniture arrangement; do not add people or text.

Bu tarifte mevcut düzenin korunması isteniyor; yine de sonucu referans görselle karşılaştırıp geometri ve donatıların değişip değişmediğini kontrol edin. Modelin istenen her ayrıntıyı aynen koruyacağı garanti edilmediğinden, bu yöntem teknik revizyon ya da ölçülü model güncellemesi olarak görülmemeli.

1. Sonucu yeni bir turla iyileştirin. Nano Banana belgeleri görsellerle konuşmalı ve ardışık düzenleme kullanımını anlatıyor; modeller arasındaki çok turlu düzenleme uygunluğu aynı değil. Nano Banana 2 Lite bu tür ardışık düzenlemeler için optimize edilmiş olarak tanımlanmıyor. Bir çıktıyı adım adım geliştirmek gerekiyorsa model seçimini bu farkı göz önünde bulundurarak yapın.

In the current interior image, reduce the visual prominence of the ceiling lights and make the daylight feel softer. Keep the room composition, furniture positions, and material palette otherwise unchanged.

Bu prompt, kompozisyonu baştan tarif etmek yerine tek bir görsel niteliğe odaklanır. Çıktıda değişmeyen unsurları da kontrol edin; talepte açıkça belirtilen kısıtların korunup korunmadığını yalnızca görsele bakarak değerlendirin.

Sık karşılaşılan hatalar

• Eski Imagen akışını kullanmak: Google, Imagen modellerinin Gemini API’de kapatıldığını bildiriyor. Eski model adları veya eski üretim yöntemi yerine güncel Nano Banana belgelerine göre ilerleyin.

• Her şeyi tek promptta istemek: Birbirinden bağımsız çok sayıda değişiklik sonucu yorumlamayı zorlaştırabilir. Önce ana mekân fikrini oluşturun, sonra ışık veya malzeme gibi bir değişkeni ayrı bir düzenleme turunda ele alın.

• Referans görselin haklarını göz ardı etmek: Google, yüklenen görsellerin kullanım haklarının kullanıcıda olması gerektiğini açıkça hatırlatıyor. Proje görseli, fotoğraf veya başka bir referans kullanmadan önce bu konuyu doğrulayın.

• Konsept çıktısını teknik belge sanmak: Kaynaklar, görsel üretimi ve düzenleme akışını anlatıyor; ölçülü mimari model veya uygulama projesi üretildiğini söylemiyor. Tasarım ve teknik kararlar için gerekli doğrulamayı ilgili proje araçlarında yapın.

Mimarlık ve iç mimarlık iş akışında nasıl değerlendirilir?

Mimarlar, iç mimarlar ve görselleştirme ekipleri Nano Banana’yı erken fikir araştırması, atmosfer seçenekleri ve mevcut görsel üzerinde yaratıcı düzenleme denemeleri için değerlendirebilir. API üzerinden metinle üretim ve görsel girdisiyle düzenleme, bu tür görsel denemeleri mevcut iş akışına bağlamaya imkân verir. Ancak kaynaklar belirli bir 3D yazılımıyla eklenti, dosya alışverişi veya doğrudan uyumluluk belirtmiyor.

Ofis kullanımında model seçimi, API maliyeti ve çıktıların proje doğruluğu ayrıca değerlendirilmelidir; belgelerde fiyat bilgisi verilmediği için maliyet varsayımı yapmak doğru olmaz. Kaynaklarda donanım gereksinimi de açıklanmıyor. Tasarım kararlarını etkileyen bir görsel kullanıldığında, görseli referans tasarımla karşılaştırın ve önemli mekânsal ayrıntıları ayrıca doğrulayın.

Sonraki adımlar

Önce tek bir metin girdisiyle konsept üretin; ardından aynı görsel üzerinde ışık ya da malzeme gibi bir özelliği değiştiren düzenleme talebi deneyin. Ekip içinde kullanılacaksa kullanılan model kimliğini ve promptu çalışma notlarında saklayın. Gerçek kişi veya kuruma ait görselleri yüklerken kullanım hakkını kontrol edin; API yöntemi ve model seçenekleri değişebileceğinden uygulama öncesinde güncel belgeleri yeniden inceleyin.

Kaynak ve lisans

Google AI for Developers’ın Imagen geçiş notu ve Nano Banana görsel üretimi rehberi CC BY 4.0 lisanslıdır. Bu eğitim, söz konusu belgelerdeki API ve model bilgileri Türkçeye uyarlanarak ve mimari kullanım için yeni örnek promptlarla hazırlanmıştır.