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

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

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

Nano Banana هو الاسم الذي يُطلق على قدرات Google لإنشاء الصور وتحريرها عبر المحادثة ضمن Gemini. وتعرّف وثائق Gemini API الإصدار Nano Banana 2.1 بأنه النموذج الحالي لإنشاء الصور وتحريرها، مع التركيز على الكفاءة العالية. معرّف النموذج هو gemini-nano-banana-2.1. ووفقًا للشركة، يتضمن هذا الإصدار تحسينات مقارنة بالإصدار السابق Nano Banana 2 في جودة الصور، والالتزام بـ prompt، والاتساق عبر الجولات المتعددة، وإنشاء النصوص.

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

لتطبيق المثال، ستحتاج إلى إمكانية الوصول إلى Gemini API، وبيئة Python، وإعداد عمل يستخدم مكتبة Google المسماة google.genai. يجب أن يعمل عميل API باستخدام بيانات اعتماد صالحة؛ ولا تحدد الوثائق المرجعية نظام تشغيل أو عتاد حاسوب أو إصدارًا معينًا للمكتبة. لذلك لا نقدّم هنا أمر تثبيت محددًا أو رقم إصدار.

عند اختيار النموذج، استخدم المعرّف الموصى به في الدليل الحالي: gemini-nano-banana-2.1. وتذكر الوثائق دعم دقات 1K و2K و4K، مع كون 1K هي الدقة الافتراضية. كما تشير إلى تحسينات لإخراج 2K و4K بنسب أبعاد عريضة وبانورامية. لكن مثال API لا يعرض معاملًا لتحديد الدقة، لذا لا يفترض الكود أدناه وجود إعداد كهذا.

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

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

1. حدّد الغرض من الصورة

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

2. أعدّ prompt الأول

المثال أدناه prompt أصلي صُمم لساحة منزل معاصر. يصف الأسلوب البصري والتكوين، ولا يدّعي الالتزام بمعيار معماري محدد.

Create a photorealistic architectural concept image of a compact contemporary courtyard house, viewed from the garden at eye level. Show a shaded timber terrace, pale mineral plaster walls, large sliding glass doors, a small reflecting pool, and restrained native planting. Soft overcast daylight, calm material palette, realistic proportions, clear spatial depth, no people, no signage.

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

3. أرسل الطلب عبر Python

احفظ نص prompt في ملف باسم prompt.txt. يقرأ المثال أدناه الملف، ويرسله إلى Nano Banana 2.1، ثم يحفظ بيانات الصورة الواردة في الاستجابة باسم generated_image.png. ويتبع هذا الاستخدام البنية الأساسية لمثال Python الوارد في الوثائق.

from google import genai
import base64

client = genai.Client()

with open("prompt.txt", "r", encoding="utf-8") as prompt_file:
    prompt = prompt_file.read()

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

with open("generated_image.png", "wb") as image_file:
    image_file.write(base64.b64decode(interaction.output_image.data))

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

4. قارن النتيجة بهدف التصميم

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

5. جرّب تصميمًا داخليًا منفصلًا

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

Create a photorealistic interior design concept for a quiet reading lounge in a small urban apartment. Show a built-in oak bookcase, a low linen sofa, a compact reading chair beside a tall window, warm neutral finishes, and soft indirect daylight. Frame the room from the entrance so the seating layout and circulation are easy to read. Natural textures, balanced exposure, no people, no text.

يمكن استخدام هذا prompt لتوليد أفكار أولية عن توزيع الأثاث والأجواء. لا تتخذ قرارات بشأن الأبعاد أو سهولة الوصول أو قابلية التنفيذ قبل مقارنة الصورة الناتجة برسومات المشروع.

أخطاء شائعة

• تحميل prompt عددًا كبيرًا من الأهداف: قد تتداخل طلبات الأماكن والمواد وزوايا الكاميرا الكثيرة. اجعل الفكرة التصميمية الرئيسية واحدة في التجربة الأولى.

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

• مواصلة استخدام مسار Imagen القديم: تشير Google إلى أن نماذج Imagen لم تعد متاحة في Gemini API. قارن عمليات الدمج القديمة بالوثائق الجديدة.

• افتراض وجود إعداد للدقة: تشمل دقات الإخراج الموثّقة 1K و2K و4K، والدقة الافتراضية هي 1K. لكن مثال الكود المختصر هنا لا يتضمن معاملًا للدقة.

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

موقعه في سير عمل العمارة والتصوّر

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

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

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

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

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

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