Nano Banana ilə memarlıq vizualları: API, prompt və redaktə bələdçisi

Bu bələdçidə nə öyrənəcəksiniz?

Bu bələdçi Nano Banana-dan Gemini API vasitəsilə memarlıq vizualları yaratmaq və istinad şəkillərini redaktə etmək üçün necə istifadə oluna biləcəyini izah edir. Məqsəd modeli BIM və ya 3D modelləşdirmə proqramı kimi nəzərdən keçirmək deyil; dizayn ideyasını vizuallaşdırmaq, atmosfer variantlarını araşdırmaq və mövcud şəkil üzərində mətnlə dəyişiklik istəməkdir.

Nümunələr yaşayış interyerləri və memarlıq konsept işləri üçün xüsusi hazırlanıb. Promptlarda vizualda olması istənən məkan, materiallar, işıq və kompozisiya təsvir olunur. Yaradılan nəticələrin texniki çertyojları, ölçüləndirilmiş modeli və ya icra layihəsini əvəz etmədiyini əvvəldən nəzərə alın.

Tələblər və model seçimi

Mənbə sənədlərdə Gemini API-yə giriş və API vasitəsilə sorğu yaratmaq axını göstərilir. Python nümunəsində google paketinin genai müştərisindən istifadə olunur; REST nümunəsində isə API açarı x-goog-api-key başlığında ötürülür. Sənədlərdə bu məzmun üçün tələb olunan SDK versiyası, qiymət və ya API-yə giriş şərtləri göstərilmir. Tətbiqə başlamazdan əvvəl bunları aktual API sənədlərindən yoxlayın.

Google-ın model siyahısında Nano Banana ailəsinin müxtəlif seçimləri var. Sənədlərdə yeni layihələr üçün Nano Banana 2.1 tövsiyə edilir; model identifikatoru gemini-nano-banana-2.1-dir. Nano Banana 2 gemini-3.1-flash-image identifikatoru ilə siyahıda göstərilir. Nano Banana 2 Lite sürət və qiymətin prioritet olduğu işlər üçün təqdim olunur; mənbədə bu modelin bir neçə istinad daxiletməsi və ya ardıcıl, çoxmərhələli redaktə üçün optimallaşdırılmadığı bildirilir. Ən mürəkkəb vizual tapşırıqlar üçün Nano Banana Pro gemini-3-pro-image identifikatoru ilə göstərilir.

Köhnə Imagen modelləri Gemini API-də dayandırılıb. Google-ın keçidlə bağlı qeydi Imagen adları əvəzinə Nano Banana modellərindən istifadə etməyi və vizual yaratmaq üçün generate_images əvəzinə generate_content metoduna keçməyi tövsiyə edir. Nano Banana sənədlərindəki yeni API nümunəsi isə interactions.create axınını göstərir. Buna görə köhnə kodu birbaşa işə salmaq əvəzinə seçdiyiniz modelin aktual sənədlərindəki üsula əməl edin.

Addım-addım vizual yaratmaq

1. İşin məqsədini müəyyənləşdirin. İlk cəhddə bir nəticə növünə fokuslanın: məsələn, interyer konsept kadrına. Məkanın tipini, baxış bucağını, gün işığını və əsas material xarakterini promptda qeyd edin. İlk cəhddə çoxsaylı alternativ istəklərini eyni mətnə yığmaq əvəzinə, nəticəni gördükdən sonra yeni redaktə sorğusu göndərin.

2. Modeli və API axınını seçin. Sənədlərdəki Python nümunəsində müştəri genai.Client() ilə yaradılır, sonra interactions.create çağırışına model identifikatoru və mətn daxiletməsi ötürülür. Yaradılan vizualın məlumatı interaction.output_image.data sahəsindən alınır, Base64 dekodlaşdırması ilə fayla yazılır. Aşağıdakı nümunə sənədlərdə göstərilən quruluşdan istifadə edir; işə salmazdan əvvəl API-yə girişin və Python müştərisinin mühitdə hazır olduğuna əmin 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 nümunədə tək mətn daxiletməsi ilə vizual yaratma yanaşması göstərilir. Prompt ingiliscə yazılıb; memarlıq təsvirində məkan, görünüş, material və işıq seçimləri aydın şəkildə sadalanır. Yaradılan faylı dizayn qərarının təsdiqlənmiş qeydi kimi deyil, konseptin nəzərdən keçirilməsinə kömək edən vizual kimi qəbul edin.

1. İlk promptu nəzarətli şəkildə hazırlayın. Aşağıdakı mətni konsept vizualı yaratmaq üçün istifadə edə, layihənizin təsvirinə uyğun olaraq otağın təyinatını və material seçimlərini dəyişə bilərsiniz.

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.

Promptda oxu məkanı üçün baxış istiqaməti, avadanlıq, material xarakteri və işıq təsvir olunur. İlk nəticəyə əsasən hər dəfə yalnız bir elementi dəyişdirərək yeni variant istəyin; məsələn, işığın istiqamətini və ya divar örtüyünü. Beləliklə, hansı təsvirin vizualı dəyişdirdiyini daha rahat qiymətləndirə bilərsiniz.

1. İstinad şəklini mətnlə redaktə edin. Sənədlərdə vizual daxiletməsi ilə birlikdə mətn göndərmək və şəklə əlavə, silmə, üslub və ya rəng dəyişikliyi istəmək üçün axın təqdim olunur. Şəkil yükləməzdən əvvəl ondan istifadə hüququnuz olduğunu təsdiqləyin. Aşağıdakı prompt mövcud otaq şəklinin atmosferini dəyişməyi hədəfləyir; onu redaktə olunacaq şəkillə birlikdə API sorğusuna mətn daxiletməsi kimi göndərin.

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 təsvirdə mövcud planın qorunması istənir; buna baxmayaraq, nəticəni istinad şəkli ilə müqayisə edərək həndəsənin və avadanlığın dəyişib-dəyişmədiyini yoxlayın. Modelin tələb olunan hər detalı olduğu kimi qoruyacağına zəmanət olmadığından, bu üsula texniki düzəliş və ya ölçülü model yeniləməsi kimi baxmaq olmaz.

1. Nəticəni yeni mərhələdə təkmilləşdirin. Nano Banana sənədlərində şəkillərlə dialoq və ardıcıl redaktə imkanları təsvir olunur; bu imkanların modellər üzrə uyğunluğu eyni deyil. Nano Banana 2 Lite bu cür ardıcıl redaktələr üçün optimallaşdırılmayıb. Nəticəni mərhələli şəkildə təkmilləşdirmək lazımdırsa, model seçərkən bu fərqi nəzərə alı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 kompozisiyanı yenidən təsvir etmək əvəzinə, yalnız bir vizual xüsusiyyətə fokuslanır. Nəticədə dəyişməməli olan elementləri də yoxlayın; sorğuda açıq şəkildə göstərilən məhdudiyyətlərin qorunub-qorunmadığını yalnız vizuala baxaraq qiymətləndirin.

Tez-tez rast gəlinən səhvlər

• Köhnə Imagen axınından istifadə etmək: Google Imagen modellərinin Gemini API-də dayandırıldığını bildirir. Köhnə model adları və ya əvvəlki yaratma metodu əvəzinə aktual Nano Banana sənədlərinə əsaslanın.

• Hər şeyi bir promptda istəmək: Bir-birindən asılı olmayan çoxsaylı dəyişikliklər nəticəni şərh etməyi çətinləşdirə bilər. Əvvəl əsas məkan ideyasını yaradın, sonra işıq və ya material kimi bir dəyişəni ayrıca redaktə mərhələsində nəzərdən keçirin.

• İstinad şəklindən istifadə hüquqlarını nəzərə almamaq: Google yüklənən şəkillərdən istifadə hüququnun istifadəçidə olmasını açıq şəkildə xatırladır. Layihə vizualı, fotoşəkil və ya başqa istinad materialından istifadə etməzdən əvvəl bu məsələni yoxlayın.

• Konsept nəticəsini texniki sənəd hesab etmək: Mənbələr vizual yaratma və redaktə axınlarını izah edir; ölçülü memarlıq modelinin və ya icra layihəsinin hazırlandığını bildirmir. Dizayn və texniki qərarlar üçün tələb olunan yoxlamaları müvafiq layihə alətlərində aparın.

Memarlıq və interyer dizaynı iş axınında necə qiymətləndirilməlidir?

Memarlar, interyer dizaynerləri və vizuallaşdırma komandaları Nano Banana-nı ilkin ideya araşdırması, atmosfer variantları və mövcud vizual üzərində yaradıcı redaktə sınaqları üçün nəzərdən keçirə bilərlər. API vasitəsilə mətnlə vizual yaratmaq və şəkil daxiletməsi ilə redaktə etmək bu cür vizual sınaqları mövcud iş axınına daxil etməyə imkan verir. Bununla belə, mənbələr konkret 3D proqramı ilə plagin, fayl mübadiləsi və ya birbaşa uyğunluq barədə məlumat vermir.

Ofisdə istifadəyə qərar verərkən model seçimi, API xərci və nəticələrin layihəyə uyğunluğu ayrıca qiymətləndirilməlidir; sənədlərdə qiymət məlumatı verilmədiyindən, xərc barədə fərziyyə yürütmək düzgün olmaz. Mənbələrdə aparat tələbləri də açıqlanmır. Dizayn qərarlarına təsir edən vizualdan istifadə etdikdə onu istinad dizaynı ilə müqayisə edin və məkanla bağlı vacib detalları ayrıca yoxlayın.

Növbəti addımlar

Əvvəlcə bir mətn daxiletməsi ilə konsept yaradın; sonra eyni vizualda işıq və ya material kimi bir xüsusiyyəti dəyişdirən redaktə sorğusunu sınayın. Komanda daxilində istifadə olunacaqsa, istifadə edilən model identifikatorunu və promptu iş qeydlərində saxlayın. Real şəxsə və ya quruma aid şəkilləri yükləyərkən istifadə hüquqlarını yoxlayın; API metodu və model seçimləri dəyişə biləcəyindən, tətbiqdən əvvəl aktual sənədləri yenidən nəzərdən keçirin.

Mənbə və lisenziya

Google AI for Developers-in Imagen-dən keçidlə bağlı qeydi və Nano Banana ilə vizual yaratma bələdçisi CC BY 4.0 lisenziyalıdır. Bu təlim həmin sənədlərdəki API və model məlumatlarının Azərbaycan dilinə uyğunlaşdırılması və memarlıq istifadəsi üçün yeni prompt nümunələri əsasında hazırlanıb.