الانتقال من Imagen إلى Nano Banana في Gemini API: دليل خطوة بخطوة

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

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

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

المتطلبات والتحضير قبل الانتقال

يشمل الانتقال روابط Imagen التي تُستخدم لتوليد الصور عبر Gemini API. ولا يوضح المصدر متطلبات نوع الحساب أو الرسوم أو الحصة أو الأجهزة. وتتمثل خطوة أولى مناسبة قبل بدء التطبيق في تحديد استدعاءات API الحالية والأجزاء التي تستخدم استجابة الصور.

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

الانتقال إلى Nano Banana خطوة بخطوة

1. حدّد اسم النموذج الحالي. اعثر على مواضع الطلبات التي تستخدم Imagen، وتحقق من اسم النموذج الذي يستدعيه التطبيق. توصي Google باستخدام gemini-2.5-flash-image بدلًا من أسماء نماذج Imagen، أو الانتقال إلى نماذج Nano Banana 2 مثل gemini-3.1-flash-image. عند اختيار النموذج، حدّث الموضع الذي يحدد النموذج في التكامل، وتحقق أيضًا مما إذا كانت هناك طلبات أخرى تستخدم الإعداد نفسه.

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

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

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

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

أخطاء شائعة

تغيير اسم النموذج وحده: يتطلب شرح الانتقال من Google النظر في الطريقة وصيغة معالجة الاستجابة إلى جانب اسم النموذج. ومن المهم إتمام نقاط التحقق الثلاث حتى يمكن تقييم التكامل وفقًا لطريقة الاستخدام الجديدة.

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

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

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

تأثير ذلك في سير عمل العمارة والتصميم الداخلي والتصور المعماري

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

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

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

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

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

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