Nano Banana 2.1 ile mimari görsel üretimi: API rehberi ve istemler

Bu rehberde ne öğreneceksiniz?

Bu rehber, Gemini API üzerinden mimari ve iç mekân odaklı görsel üretmek isteyenler için temel bir başlangıç akışı sunuyor. Metinden yeni bir konsept görseli istemeyi, bir referans görseli metinle birlikte kullanarak düzenleme talep etmeyi ve çıktıyı yanıttan almayı ele alacağız. Örnek istemler; mekânın işlevi, malzeme hissi, ışık ve kadraj gibi unsurları açıkça tarif edecek şekilde hazırlandı.

Bu yöntem, bir mimari projeyi uygulama çizimi ya da doğrulanmış tasarım belgesi yerine koymaz. Daha çok fikir geliştirme, atmosfer arama ve görsel alternatifleri değerlendirme aşamalarında kullanılabilecek bir API iş akışıdır. Sonucu proje kararlarında kullanmadan önce görselin tasarım niyetine ve eldeki referanslara uygunluğu ayrıca incelenmelidir.

Gereksinimler

Google’ın Gemini API dokümanında Nano Banana 2.1 için kullanılan model adı gemini-nano-banana-2.1. Kaynaktaki Python örneği google.genai istemcisini kullanıyor; görsel üretimi için Gemini API erişimi, bir API anahtarı ve Python ortamında bu istemciyle çalışabilecek bir kurulum gerekiyor. Kaynak, gerekli API erişiminin nasıl alınacağına veya istemcinin kurulum komutuna ilişkin ayrıntı vermediği için burada belirli bir kurulum yolu ya da paket sürümü belirtilmiyor.

Görsel düzenleme için ayrıca üzerinde çalışmaya yetkili olunan bir referans görsel hazırlanmalı. Google, yüklenen görseller için gerekli hakların gözetilmesini ve hizmetin yasaklı kullanım politikasına uyulmasını hatırlatıyor. Referans dosyasının biçimi ve birden fazla görselin gönderilmesine ilişkin ayrıntılar, API’nin görsel anlama dokümanına yönlendiriliyor; burada bu konuda ek bir uyumluluk varsayımı yapılmamalı.

Adım adım: metinden mimari görsel üretin

1. Çıktının amacını belirleyin. Bir konut iç mekânı, kamusal alan ya da küçük bir yapı konsepti gibi görselin neyi anlatmasını istediğinizi seçin. İlk denemede tek bir mekâna ve tek bir görsel amacına odaklanmak, istemdeki unsurları takip etmeyi kolaylaştırır.

2. Mekânı ve atmosferi tarif edin. İstemde işlevi, öne çıkmasını istediğiniz malzeme ve ışık hissini, ayrıca kadrajı belirtin. Aşağıdaki metin, iç mekân konsept görseli için özgün bir başlangıç örneğidir:

Create an architectural concept image of a quiet reading room in a small urban library. Show a long oak reading table, built-in bookshelves, pale stone flooring, and soft daylight entering from a tall side window. Use a calm, restrained material palette and a human-eye-level wide interior view. Focus on spatial atmosphere and clear circulation.

İstemdeki ayrıntılar, görselde aranacak tasarım niyetini açıklıyor. Bu metin bir API parametresi değil, modele verilen doğal dilde bir talimattır. Sonuçtaki malzeme, ölçek ve mekânsal ilişkileri kontrol ederek sonraki denemede yalnızca değiştirmek istediğiniz unsurları daha belirgin tarif edin.

1. API isteğinde model ve istemi kullanın. Resmî Python örneğinde client = genai.Client() oluşturuluyor ve client.interactions.create çağrısına model adı ile metin girdi olarak veriliyor. Kendi uygulamanızda bu yapı için API erişiminin ve anahtarın çalışır durumda olması gerekir. Yanıttaki interaction.output_image.data alanı, örnekte base64 biçiminde çözümlenerek dosyaya yazılıyor. Kaynak örneği PNG dosya adı kullanıyor; bu, tüm olası çıktı biçimlerine dair genel bir garanti olarak değerlendirilmemeli.

2. İstemleri karşılaştırılabilir tutun. Aynı mekânı farklı atmosferlerle araştırırken ana tasarım tarifini sabit bırakıp ışık ya da malzeme vurgusunu değiştirin. Örneğin aşağıdaki istem, aynı tür çalışma alanında daha yumuşak bir gün ışığı ve daha sakin bir atmosfer arar:

Create an architectural visualization of a compact home office in a renovated apartment. Include a simple timber desk, built-in storage, a reading chair, and a large window. Emphasize soft overcast daylight, muted natural materials, and an uncluttered composition. Show the complete room from a human-eye-level interior viewpoint.

Bu örnekte mobilya ve mekân tarifi, atmosfer ve kadrajla birlikte veriliyor. Birden fazla özelliği aynı anda değiştirirseniz hangi ifadenin sonucu etkilediğini ayırt etmek zorlaşabilir; bu nedenle denemeleri küçük adımlarla yürütmek daha yararlı bir karşılaştırma sağlar.

Referans görseli metinle düzenleme

Gemini API dokümanı, bir görselin metin istemiyle birlikte gönderilerek öğe ekleme, çıkarma veya değiştirme gibi düzenleme taleplerinde kullanılabileceğini açıklıyor. İstek girdisi metin ve görsel içeriğini birlikte taşıyor. Mimari çalışma için bu, mevcut bir konsept karesinde belirli bir atmosfer veya malzeme yönünü araştırmak üzere kullanılabilir; ancak kaynak, ölçüleri ya da geometrik doğruluğu koruyacağına dair bir garanti sunmuyor.

Aşağıdaki örneği, üzerinde kullanım hakkı bulunan bir iç mekân görseliyle birlikte düzenleme istemi olarak kullanabilirsiniz:

Using the provided interior image as a reference, explore a warmer material direction for the room. Keep the overall spatial layout and camera viewpoint recognizable. Shift the atmosphere toward soft late-afternoon daylight, with warmer timber accents and a calm, understated interior mood.

İstemde referansın hangi yönlerinin korunmasının, hangilerinin araştırılmasının istendiği belirtiliyor. Çıktıyı özgün görselle yan yana inceleyin; özellikle kadrajın, mekân ilişkilerinin ve talep edilen değişikliklerin ne ölçüde karşılandığını kontrol edin. Hassas bir proje kararında, görsel üretim sonucunu ölçülü veya doğrulanmış bir tasarım verisi gibi kabul etmeyin.

Sık yapılan hatalar ve sonraki adımlar

• Belirsiz mekân tarifi: Yalnızca “modern bir iç mekân” demek, istenen işlevi ve atmosferi tanımlamaz. Oda türünü, görselde öne çıkacak unsurları ve kadrajı açıkça belirtin.

• Tek istemde çok fazla hedef: Bir denemede bütün malzemeleri, ışığı ve kompozisyonu değiştirmek karşılaştırmayı güçleştirir. Önce temel mekân tarifini kurun, sonra bir değişken üzerinde çalışın.

• Referansın haklarını göz ardı etmek: Google, yüklenen görsellerin kullanım haklarına dikkat edilmesini istiyor. Düzenleme sürecinde yalnızca kullanma yetkisi bulunan görselleri gönderin.

• Çıktıyı proje doğrulaması saymak: Kaynaklar görsel üretim ve düzenleme akışını anlatıyor; teknik uygunluk, ölçü doğruluğu veya uygulama çizimi doğruluğu vaat etmiyor. Çıktıyı konsept araştırması çerçevesinde değerlendirin.

Sonraki denemelerde aynı mekân için birkaç ayrı istem hazırlayıp yalnızca ışık, malzeme ya da kadraj tarifini değiştirin. API yanıtındaki görsel verisini alırken resmî örnekteki output_image alanını ve base64 çözümleme adımını izleyin. Daha fazla girdi görseli, desteklenen MIME türleri ve ayrıntılı API kullanımı için resmî görsel anlama ve görsel üretimi dokümanlarına başvurun.

Mimarlık ve iç mimarlık iş akışlarında bu yaklaşım, özellikle erken aşama atmosfer arayışında ve mevcut bir görsel üzerinde alternatifleri tartışırken değerlendirilebilir. Render ya da modelleme yazılımına aktarılacak veriler, lisans koşulları ve donanım gereksinimleri hakkında verilen kaynaklarda yeterli bilgi yoktur; bu nedenle bunlara ilişkin bir uyumluluk veya maliyet varsayımı yapılmamalıdır.

Kaynak ve lisans

Google’ın Gemini API görsel üretimi ve Imagen geçiş rehberleri temel alınmıştır. Her iki kaynak da CC BY 4.0 lisanslıdır; içerik Türkçeye uyarlanmış ve mimarlık ile iç mekân iş akışlarına yönelik özgün istemlerle yeniden düzenlenmiştir. Kaynak kod örnekleri için belirtilen lisans Apache 2.0’dır.