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

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

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

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

المتطلبات

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

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

خطوة بخطوة: إنشاء صورة معمارية من نص

1. حدّد الغرض من النتيجة. اختر ما تريد أن تصوّره، مثل مساحة داخلية سكنية، أو مكان عام، أو مفهوم مبنى صغير. يساعد التركيز في المحاولة الأولى على مكان واحد وغرض بصري واحد على متابعة عناصر المطالبة.

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

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.

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

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

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

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.

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

تعديل صورة مرجعية باستخدام نص

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

يمكنك استخدام المثال التالي كمطالبة للتعديل مع صورة داخلية تملك حق استخدامها:

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.

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

أخطاء شائعة والخطوات التالية

• وصف غير محدد للمكان: الاكتفاء بعبارة «مساحة داخلية عصرية» لا يوضح الوظيفة والأجواء المطلوبة. حدّد نوع الغرفة والعناصر التي ينبغي إبرازها في الصورة والتأطير بوضوح.

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

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

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

في المحاولات التالية، أعدّ عدة مطالبات منفصلة للمكان نفسه، وغيّر وصف الإضاءة أو المواد أو التأطير وحده. وعند استرداد بيانات الصورة من استجابة API، اتبع الحقل output_image وخطوة فك ترميز base64 الواردين في المثال الرسمي. راجع وثائق فهم الصور وإنشاء الصور الرسمية لمعرفة المزيد عن الصور المدخلة الإضافية وأنواع MIME المدعومة والاستخدام المفصل لـ API.

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

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

استند هذا المحتوى إلى أدلة Google الخاصة بإنشاء الصور في Gemini API والانتقال من Imagen. وكلا المصدرين مرخص بموجب CC BY 4.0؛ وقد تم تكييف المحتوى إلى التركية وإعادة تنظيمه باستخدام مطالبات أصلية لسير العمل في العمارة والتصميم الداخلي. أما الأمثلة البرمجية المصدرية، فالترخيص المشار إليه لها هو Apache 2.0.