إنشاء صور معمارية باستخدام Nano Banana: دليل API وprompt والتحرير

ما الذي ستتعلمه في هذا الدليل؟

يشرح هذا الدليل كيفية استخدام Nano Banana عبر Gemini API لإنشاء الصور المعمارية وتحرير الصور المرجعية. الهدف ليس التعامل مع النموذج كما لو كان برنامج BIM أو برنامجًا للنمذجة ثلاثية الأبعاد، بل تصوّر فكرة تصميمية، واستكشاف بدائل للأجواء، وطلب تعديلات نصية على صورة موجودة.

أُعدّت الأمثلة خصيصًا لتصميمات المساحات الداخلية السكنية وأعمال المفاهيم المعمارية. تصف مطالبات prompt المساحة والمواد والإضاءة والتكوين المطلوب ظهورها في الصورة. ضعوا في الحسبان منذ البداية أن النتائج المُنشأة لا تحل محل الرسومات التقنية أو النماذج ذات الأبعاد المحددة أو مشاريع التنفيذ.

المتطلبات واختيار النموذج

تعرض الوثائق المصدرية الوصول إلى Gemini API وسير عمل إنشاء التفاعلات عبر API. يستخدم مثال Python العميل genai من حزمة google؛ كما يرسل مثال REST مفتاح API في الترويسة x-goog-api-key. لا تحدد الوثائق في هذا المحتوى إصدار SDK المطلوب أو الأسعار أو شروط الوصول إلى API. تحقّقوا من هذه التفاصيل في وثائق API المحدّثة قبل بدء التطبيق.

تضم قائمة نماذج Google خيارات مختلفة من عائلة Nano Banana. توصي الوثائق بـ Nano Banana 2.1 للمشاريع الجديدة؛ ومعرّف النموذج هو gemini-nano-banana-2.1. ويُدرج Nano Banana 2 بالمعرّف gemini-3.1-flash-image. أما Nano Banana 2 Lite فيُقدَّم للأعمال التي تكون فيها السرعة والتكلفة أولوية؛ وتشير الوثيقة إلى أن هذا النموذج غير مُحسّن لاستخدام عدة مدخلات مرجعية أو للتحرير المتتابع متعدد الجولات. ولأعقد مهام الصور، يُعرَّف Nano Banana Pro بالمعرّف gemini-3-pro-image.

أُوقفت نماذج Imagen القديمة في Gemini API. وتوصي ملاحظة الانتقال من Google باستخدام نماذج Nano Banana بدلًا من أسماء Imagen، والانتقال من الطريقة generate_images إلى generate_content لإنشاء الصور. أما مثال API الجديد في وثائق Nano Banana فيعرض سير عمل interactions.create. لذلك، بدلًا من تشغيل الشيفرة القديمة مباشرة، اتبعوا الطريقة الواردة في الوثائق المحدّثة للنموذج الذي اخترتموه.

إنشاء الصور خطوة بخطوة

1. حدّدوا الغرض من العمل. ركّزوا في المحاولة الأولى على نوع واحد من المخرجات، مثل لقطة مفاهيمية لمساحة داخلية. اذكروا في prompt نوع المساحة وزاوية الرؤية وضوء النهار والطابع العام للمواد. وبدلًا من حشد طلبات كثيرة لبدائل متعددة في النص الأول، أنشئوا طلب تعديل جديدًا بعد الاطلاع على النتيجة.

2. اختاروا النموذج وسير عمل API. في مثال Python الوارد في الوثائق، يُنشأ العميل باستخدام genai.Client()، ثم تُمرَّر هوية النموذج والمدخل النصي إلى استدعاء interactions.create. وتُستخرج بيانات الصورة المُنشأة من الحقل interaction.output_image.data، ثم تُكتب في ملف بعد فك ترميز Base64. يستخدم المثال أدناه البنية الموثقة؛ تأكدوا قبل تشغيله من توفر صلاحية الوصول إلى API وعميل Python في البيئة.

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))

يوضح هذا المثال طريقة إنشاء صورة باستخدام مدخل نصي واحد. كُتب prompt باللغة الإنجليزية، وهو يسرد بوضوح المساحة والمظهر والمواد وخيارات الإضاءة. تعاملوا مع الملف الناتج بوصفه صورة تساعد في مراجعة المفهوم، لا سجلًا موثّقًا لقرار تصميمي.

1. صوغوا prompt الأول على نحو مضبوط. يمكن استخدام النص أدناه لإنشاء صورة مفاهيمية، مع تعديل وظيفة الغرفة والمواد وفقًا لمتطلبات المشروع.

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 اتجاه الرؤية والتجهيزات وطابع المواد والإضاءة في مساحة للقراءة. استنادًا إلى النتيجة الأولى، اطلبوا نسخة جديدة مع تغيير عنصر واحد فقط، مثل اتجاه الإضاءة أو كسوة الجدار. يساعد ذلك على تقييم أثر كل وصف في الصورة بسهولة أكبر.

1. حرّروا صورة مرجعية باستخدام النص. تعرض الوثائق سير عمل يتيح إرسال صورة مع نص، وطلب إضافة عناصر إلى الصورة أو حذفها، أو تعديل أسلوبها وألوانها. تحقّقوا من امتلاك حقوق الاستخدام قبل تحميل أي صورة. يستهدف prompt أدناه تغيير أجواء صورة غرفة موجودة؛ أرسلوه كمدخل نصي في طلب API مع الصورة المراد تحريرها.

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.

يطلب الوصف الحفاظ على التصميم الحالي؛ ومع ذلك، قارنوا النتيجة بالصورة المرجعية وتحققوا مما إذا كانت الهندسة والتجهيزات قد تغيرت. وبما أنه لا يوجد ضمان بأن يحافظ النموذج على كل التفاصيل المطلوبة كما هي، فلا ينبغي اعتبار هذه الطريقة مراجعة تقنية أو تحديثًا لنموذج ذي أبعاد محددة.

1. حسّنوا النتيجة بجولة جديدة. تشرح وثائق Nano Banana التفاعل مع الصور والتحرير المتتابع؛ لكن ملاءمة النماذج للتحرير متعدد الجولات تختلف من نموذج إلى آخر. ولا يُوصف Nano Banana 2 Lite بأنه مُحسّن لهذا النوع من التحرير المتتابع. إذا احتجتم إلى تطوير مخرج خطوة بخطوة، فاختاروا النموذج مع أخذ هذا الاختلاف في الحسبان.

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.

يركز هذا prompt على سمة بصرية واحدة بدلًا من إعادة وصف التكوين من البداية. افحصوا أيضًا العناصر التي يفترض ألا تتغير في المخرج، ولاحظوا في الصورة ما إذا كانت القيود المذكورة صراحة في الطلب قد حُفظت.

أخطاء شائعة

• استخدام سير عمل Imagen القديم: تفيد Google بأن نماذج Imagen أُوقفت في Gemini API. استخدموا وثائق Nano Banana المحدّثة بدلًا من أسماء النماذج القديمة أو طريقة الإنشاء السابقة.

• طلب كل شيء في prompt واحد: قد تجعل التغييرات الكثيرة وغير المرتبطة ببعضها تفسير النتيجة صعبًا. ابدأوا بتكوين الفكرة الأساسية للمساحة، ثم عالجوا متغيرًا مثل الإضاءة أو المواد في جولة تحرير منفصلة.

• تجاهل حقوق الصورة المرجعية: تذكّر Google بوضوح أن على المستخدم امتلاك حقوق استخدام الصور التي يحمّلها. تحقّقوا من ذلك قبل استخدام صورة مشروع أو صورة فوتوغرافية أو أي مرجع آخر.

• اعتبار المخرج المفاهيمي وثيقة تقنية: تشرح المصادر سير عمل إنشاء الصور وتحريرها، لكنها لا تقول إنه ينتج نموذجًا معماريًا مضبوط الأبعاد أو مشروعًا تنفيذيًا. أجروا التحققات اللازمة للتصميم والقرارات التقنية باستخدام أدوات المشروع المعنية.

كيف يمكن تقييمه ضمن سير عمل العمارة والتصميم الداخلي؟

يمكن للمعماريين ومصممي الديكور الداخلي وفرق التصوير المعماري تقييم Nano Banana لاستكشاف الأفكار في مراحلها المبكرة، وتجربة أجواء مختلفة، وإجراء تعديلات إبداعية على الصور الموجودة. ويتيح إنشاء الصور بالنص وتحريرها باستخدام مدخلات الصور عبر API ربط هذه التجارب البصرية بسير العمل القائم. لكن المصادر لا تذكر إضافةً إلى برنامج 3D محدد أو تبادل ملفات أو توافقًا مباشرًا.

ينبغي للمكاتب أيضًا تقييم اختيار النموذج وتكلفة API ومدى دقة المخرجات بالنسبة إلى المشروع؛ ولا يصح افتراض التكلفة، إذ لا تتضمن الوثائق معلومات عن الأسعار. كما لا توضّح المصادر متطلبات الأجهزة. وعند استخدام صورة تؤثر في قرارات التصميم، قارنوها بالتصميم المرجعي وتحققوا بصورة مستقلة من التفاصيل المكانية المهمة.

الخطوات التالية

ابدأوا بإنشاء مفهوم باستخدام مدخل نصي واحد، ثم جرّبوا طلب تعديل يغيّر سمة واحدة مثل الإضاءة أو المواد في الصورة نفسها. إذا كان الفريق سيستخدم الأداة، فاحتفظوا بمعرّف النموذج المستخدم وprompt ضمن ملاحظات العمل. تحقّقوا من حقوق الاستخدام عند تحميل صور تعود إلى أشخاص أو مؤسسات؛ ولأن طرق API وخيارات النماذج قد تتغير، راجعوا الوثائق المحدّثة مجددًا قبل التطبيق.

المصدر والترخيص

مرخّص بموجب CC BY 4.0 كل من ملاحظة الانتقال إلى Imagen ودليل إنشاء الصور باستخدام Nano Banana من Google AI for Developers. أُعدّ هذا الدليل بتكييف معلومات API والنماذج الواردة في تلك الوثائق إلى اللغة التركية، وإضافة أمثلة prompt جديدة للاستخدام المعماري.