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

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

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

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

المتطلبات: النموذج والوصول والملفات

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

لإعداد سير العمل التوضيحي باستخدام Python، تحتاج إلى بيئة Python تستخدم Google Gen AI SDK. لا تحدد الوثائق المصدرية الحد الأدنى لإصدار SDK أو أمر التثبيت، لذلك لا نوصي هنا بإصدار أو أمر بعينه. ويُظهر المثال الوارد في الوثائق أن من يفضلون مسار REST يستخدمون مفتاح API باسم GEMINI_API_KEY في الطلب. ولا توضح هذه المصادر شروط الوصول إلى الحساب أو رسوم الاستخدام؛ لذا تحقّق من شروط API الحالية قبل بدء المشروع.

يستخدم مثال تعديل صورة موجودة ملف PNG ونوع MIME هو image/png. لذلك، فإن إعداد الصورة المراد تعديلها بصيغة PNG وتحديث مسار الملف بما يتوافق مع بيئة العمل الخاصة بك يُعدّان نقطة بداية واضحة للتجربة الأولى.

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

1. حدّد هدف المشهد وحدوده

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

Create a photorealistic architectural visualization of a compact courtyard house in a coastal climate. Show a quiet eye-level view from the garden toward the entrance. Use pale limestone, warm timber screens, native planting, soft overcast daylight, realistic material textures, and a calm restrained palette. Keep the building proportions plausible and the composition uncluttered. No people, signage, or decorative text.

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

2. أنشئ الصورة عبر استدعاء API

يستخدم مثال Python التالي مسار interactions.create الوارد في الوثائق. يرسل نص المطالبة إلى النموذج ويحفظ بيانات الصورة الناتجة في ملف. تذكّر أن بيانات الناتج تُستخرج عبر interaction.output_image وتُفك من Base64.

from google import genai
import base64

client = genai.Client()
prompt = "Create a photorealistic architectural visualization of a compact courtyard house in a coastal climate. Show a quiet eye-level view from the garden toward the entrance. Use pale limestone, warm timber screens, native planting, soft overcast daylight, realistic material textures, and a calm restrained palette. Keep the building proportions plausible and the composition uncluttered. No people, signage, or decorative text."

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

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

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

3. اطلب تعديل صورة موجودة

في مسار العمل الثاني، يُرسل إلى النموذج كل من نص التعليمات ومدخل الصورة. وتعرض الوثائق مثالاً تُقرأ فيه الصورة من ملف وتُحوّل إلى Base64، ثم تُضاف إلى الطلب بنوع image/png. توجّه التعليمات التالية النموذج إلى تغيير الإحساس بالمواد في صورة داخلية موجودة:

Edit the provided interior image. Keep the room layout, camera position, windows, and furniture placement unchanged. Change the floor to light oak, make the wall finish a warm off-white plaster, and soften the daylight while preserving the original overall composition.

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

4. حسّن النتيجة بخطوات صغيرة

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

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

أخطاء شائعة

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

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

• تجاهل حقوق الصورة المصدر: تذكّر الوثائق بضرورة امتلاك الحقوق اللازمة للصور التي ترفعها. تحقّق من حقوق الاستخدام قبل إرسال الصورة إلى API.

• الخلط بين اختيار النموذج ومعلومات الدقة: رغم أن المصدر يذكر دعم Nano Banana 2.1 لدقات 1K و2K و4K، فإنه لا يشرح هنا مَعلمة لاختيارها في الاستدعاء. لا تخمّن أسماء إعدادات غير واردة في الوثائق.

• اعتبار الناتج قراراً تقنياً نهائياً: هذا المسار مخصص لإنشاء الصور وتعديلها. ولا تُقدّم أبعاد المشروع أو تفاصيل التنفيذ على أنها بيانات تقنية معتمدة.

الخطوات التالية في سير عمل العمارة والتصوّر

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

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

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

أُعدّ هذا الدليل بالاستناد إلى وثيقتي Google Gemini API «Nano Banana image generation» و«Prompt design strategies». وكلا المصدرين مرخّص بموجب CC BY 4.0. أما أمثلة المطالبات المعمارية فهي أصلية أُعدّت لهذا الدليل؛ ولم تُنسخ المطالبات النموذجية الواردة في المصادر.