3 خطوات لربط Nano Banana 2 بـ ComfyUI – دليل كامل لتبديل نموذج Gemini لتوليد الصور

تُعدّ الاستفادة من نموذج Gemini لتوليد الصور في ComfyUI مطلبًا للعديد من المبدعين. ستوضح هذه المقالة كيفية ربط Nano Banana 2 بـ ComfyUI في 3 خطوات، لتحقيق سير عمل مثل تحويل النص إلى صورة وتحويل صورة إلى صورة، مع دعم التبديل بنقرة واحدة بين نماذج NB2 وNB Pro وسلسلة NB الكاملة.

القيمة الأساسية: بعد قراءة هذه المقالة، ستتعلم كيفية تهيئة واجهة برمجة تطبيقات Gemini لتوليد الصور في ComfyUI، وتتقن تقنيات تبديل النماذج، وتبني سير عمل توليد صور بالذكاء الاصطناعي بسرعة.

النقاط الأساسية لربط Nano Banana 2 بـ ComfyUI

Nano Banana 2 (gemini-3.1-flash-image-preview) هو أحدث نموذج لتوليد الصور من Google، ويمكن ربطه بسهولة عبر العقد المخصصة في ComfyUI.

شرح مفصل لنقاط ربط Nano Banana 2 بـ ComfyUI

يكمن جوهر ربط Nano Banana 2 بـ ComfyUI في: اختيار المكون الإضافي الصحيح + تهيئة API الصحيحة. على عكس استدعاء واجهة برمجة تطبيقات Google الرسمية مباشرة، من خلال الواجهة الموحدة لـ APIYI (apiyi.com)، يمكنك استخدام جميع نماذج Gemini لتوليد الصور بسلاسة في ComfyUI، دون الحاجة إلى التعامل مع تعقيدات الشبكة والمصادقة.

حل الربط هو في الأساس نفس حل Nano Banana Pro تمامًا، والفرق الوحيد هو اسم النموذج. إذا كنت قد قمت بتهيئة NB Pro من قبل، فما عليك سوى تغيير اسم النموذج إلى gemini-3.1-flash-image-preview.

لماذا تختار ربط Nano Banana 2 عبر ComfyUI؟

مقارنةً بالاستدعاء المباشر لواجهة برمجة التطبيقات أو الأدوات الأخرى، يوفر ربط ComfyUI المزايا الفريدة التالية:

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

مقارنة بين جميع نماذج سلسلة Nano Banana 2

قبل دمجها مع ComfyUI، دعنا نتعرف على جميع نماذج توليد الصور من Gemini التي توفرها APIYI:

نسب العرض إلى الارتفاع المدعومة في Nano Banana 2

يدعم Nano Banana 2 أربعة عشر نسبة عرض إلى ارتفاع مختلفة، وهي الأكثر بين النماذج الثلاثة. يمكنك اختيارها من معلمة aspect_ratio في عقدة ComfyUI:

🎯 نصيحة للاختيار: يحقق Nano Banana 2 أفضل توازن بين جودة الصورة والسرعة، ويوصى به كنموذج مفضل للاستخدام اليومي في ComfyUI. من خلال APIYI apiyi.com، يمكنك الحصول على واجهة API موحدة لجميع نماذج السلسلة، مما يسهل التبديل بينها في أي وقت.

خيارات حلول إضافة Nano Banana 2 ComfyUI

تتوفر حاليًا عدة خيارات لإضافات ComfyUI التي تدعم توليد الصور باستخدام Gemini، ونوصي بالحلين التاليين:

الحل أ: إضافة ComfyUI-IF_Gemini (موصى به)

ComfyUI-IF_Gemini هي عقدة Gemini ComfyUI الأكثر نضجًا حاليًا، وتدعم بشكل أساسي تكوين base_url، مما يجعلها مناسبة جدًا للاتصال عبر APIYI.

المزايا:

• تدعم بشكل أساسي base_url مخصصًا، ويمكن ملء عنوان واجهة APIYI مباشرة.
• تدعم سير عمل متعددة مثل تحويل النص إلى صورة، وتحويل صورة إلى صورة، والمحادثات متعددة الأدوار.
• صيانة نشطة، استجابة سريعة لملاحظات المجتمع، وتحديثات مستمرة للميزات.
• تستخدم متغيرات البيئة لتكوين مفتاح API، مما يتجنب الترميز الثابت ويوفر الأمان والراحة.
• تدعم تعيين معلمات متقدمة مثل temperature و aspect_ratio.

مستودع GitHub: github.com/if-ai/ComfyUI-IF_Gemini

الفئة المستهدفة: المستخدمون الذين يحتاجون إلى استخدام عميق لوظيفة توليد صور Gemini، والذين يرغبون في تخصيص المزيد من المعلمات وإنشاء سير عمل معقدة.

الحل ب: comfyui-gemini-nodes (وضع التوافق مع OpenAI)

تم تطوير comfyui-gemini-nodes بواسطة jqy-yo، ويدعم الاتصال عبر وضع التوافق مع OpenAI، وهو مناسب للمستخدمين الذين لديهم خبرة سابقة في واجهة OpenAI.

المزايا:

• واجهة متوافقة مع OpenAI، مما يعني عدم وجود تكلفة تعلم للمستخدمين ذوي الخبرة في OpenAI.
• يدعم تخصيص ثلاثة معلمات: base_url + api_key + model.
• تنفيذ خفيف الوزن، يعتمد على عدد قليل من التبعيات، مما يقلل من احتمالية تعارض البيئة.
• يتم ملء المعلمات مباشرة في واجهة العقدة، مما يوفر تجربة مرئية ومباشرة.

مستودع GitHub: github.com/jqy-yo/comfyui-gemini-nodes

الفئة المستهدفة: المبتدئون في ComfyUI الذين يرغبون في البدء بسرعة والتحقق من النتائج، والمطورون الذين لديهم خبرة سابقة في استخدام واجهة OpenAI.

مقارنة حلول إضافة Nano Banana 2 ComfyUI

💡 نصيحة فنية: إذا كنت مبتدئًا في ComfyUI، فننصحك بالبدء بالحل ب؛ أما إذا كنت بحاجة إلى ميزات أكثر ثراءً، فنوصي بالحل أ. يمكن لكلا الحلين الاتصال بسلسلة نماذج Gemini الكاملة عبر واجهة APIYI الموحدة apiyi.com.

Nano Banana 2 ComfyUI البدء السريع

تكوين تثبيت الحل أ: ComfyUI-IF_Gemini

الخطوة 1: تثبيت الإضافة

# انتقل إلى دليل العقد المخصصة لـ ComfyUI
cd ComfyUI/custom_nodes

# استنساخ مستودع الإضافة
git clone https://github.com/if-ai/ComfyUI-IF_Gemini.git

# تثبيت التبعيات
cd ComfyUI-IF_Gemini
pip install -r requirements.txt

الخطوة 2: تكوين API (خطوة أساسية)

في الدليل الجذر لـ ComfyUI، أنشئ أو عدّل ملف .env:

# تكوين واجهة APIYI الموحدة
GEMINI_BASE_URL=https://vip.apiyi.com/v1
GEMINI_API_KEY=your_apiyi_api_key_here

🚀 بدء سريع: يمكنك الحصول على مفتاح API الخاص بك بالتسجيل عبر APIYI apiyi.com، والذي يدعم الاستدعاء الموحد لسلسلة نماذج توليد صور Gemini الكاملة.

الخطوة 3: اختيار نموذج لتوليد الصور

بعد إعادة تشغيل ComfyUI، ابحث عن عقدة IF_Gemini في لوحة العقد، وقم بتعيين معلمات النموذج:

model: gemini-3.1-flash-image-preview

لتغيير النماذج الأخرى، ما عليك سوى تعديل هذه المعلمة:

# Nano Banana 2 - جودة احترافية، أسرع سرعة
model: gemini-3.1-flash-image-preview

# Nano Banana Pro - أعلى جودة
model: gemini-3-pro-image-preview

# Nano Banana - خيار القيمة مقابل السعر
model: gemini-2.5-flash-image

تكوين تثبيت الحل ب: comfyui-gemini-nodes

الخطوة 1: تثبيت الإضافة

cd ComfyUI/custom_nodes
git clone https://github.com/jqy-yo/comfyui-gemini-nodes.git
cd comfyui-gemini-nodes
pip install -r requirements.txt

الخطوة 2: تكوين API في العقدة

أعد تشغيل ComfyUI، وبعد إضافة عقدة Gemini، قم بالتكوين في خصائص العقدة:

base_url: https://vip.apiyi.com/v1
api_key: your_apiyi_api_key_here
model: gemini-3.1-flash-image-preview

الخطوة 3: تشغيل سير العمل

قم بتوصيل عقدة إدخال نص الموجه (Prompt)، ثم انقر فوق Queue Prompt لتوليد الصورة.

أمثلة كود كاملة لـ Nano Banana 2 ComfyUI

مثال مبسط لاستدعاء بايثون

إذا كنت ترغب في التحقق من اتصال API خارج ComfyUI أولاً، يمكنك استخدام الكود التالي للاختبار:

import openai

client = openai.OpenAI(
    api_key="your_apiyi_api_key",
    base_url="https://vip.apiyi.com/v1"  # واجهة APIYI الموحدة
)

response = client.chat.completions.create(
    model="gemini-3.1-flash-image-preview",
    messages=[
        {
            "role": "user",
            "content": "Generate a beautiful sunset landscape painting"
        }
    ]
)

print(response.choices[0].message.content)

{
  "nodes": [
    {
      "type": "IF_GeminiGenerateImage",
      "properties": {
        "model": "gemini-3.1-flash-image-preview",
        "prompt": "A beautiful sunset over mountains, oil painting style",
        "aspect_ratio": "16:9",
        "temperature": 0.8
      }
    }
  ],
  "env": {
    "GEMINI_BASE_URL": "https://vip.apiyi.com/v1",
    "GEMINI_API_KEY": "your_apiyi_api_key"
  }
}

نصيحة: احصل على رصيد اختبار مجاني عبر APIYI apiyi.com للتحقق من اتصال API قبل إعداد سير عمل معقد.

أنواع سير عمل Nano Banana 2 ComfyUI

سير عمل تحويل النص إلى صورة (Text-to-Image)

هو سير العمل الأساسي والأكثر استخدامًا، حيث تقوم بإدخال وصف نصي لتوليد صورة:

[موجه نصي] → [عقدة Gemini] → [معاينة/حفظ الصورة]

اقتراحات المعلمات:

• النموذج: gemini-3.1-flash-image-preview
• نسبة العرض إلى الارتفاع: اختر واحدة من 14 نوعًا حسب الحاجة (1:1، 16:9، 9:16، 4:3، 3:4، إلخ.)
• درجة الحرارة (temperature): 0.7-0.9 (كلما زادت، زادت الإبداعية؛ وكلما انخفضت، زاد الاستقرار)

نصائح لكتابة الموجهات:

• عادةً ما تكون الموجهات الإنجليزية أفضل أداءً.
• ترتيب الوصف المقترح: الموضوع → البيئة → الأسلوب → الإضاءة → التفاصيل
• مثال: "A cute cat sitting on a windowsill, soft morning light, watercolor style, detailed fur texture"

سير عمل تحويل صورة إلى صورة (Image-to-Image)

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

[تحميل الصورة] + [موجه التعديل] → [عقدة Gemini] → [الصورة بعد التعديل]

أوامر التعديل الشائعة:

• "غيّر الخلفية إلى سماء ليلية مرصعة بالنجوم."
• "أضف قبعة للشخصية."
• "حوّل الصورة إلى نمط ألوان مائية."
• "أزل العلامة المائية النصية من الصورة."
• "غيّر المشهد النهاري إلى غروب الشمس."

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

سير عمل نقل الأسلوب (Style Transfer)

تطبيق أسلوب صورة واحدة على صورة أخرى، لتحقيق تركيبات إبداعية:

[صورة مرجعية للأسلوب] + [صورة المحتوى] + [موجه] → [عقدة Gemini] → [الصورة ذات الأسلوب المطبق]

سيناريوهات نقل الأسلوب الشائعة:

• تحويل الصور إلى أنماط فنية مثل الرسم الزيتي، الألوان المائية، الرسم التخطيطي، إلخ.
• تحويل صور المنتجات إلى أسلوب بصري لعلامة تجارية معينة.
• تحويل الصور العادية إلى نمط أنمي أو رسوم توضيحية.

سير عمل المحادثة متعددة الأدوار (Multi-turn)

تدعم Nano Banana 2 توليد الصور وتعديلها بنمط المحادثة متعددة الأدوار، وهي قدرة فريدة لا تتوفر في نماذج Stable Diffusion التقليدية:

الدور الأول: [موجه: ارسم قطة] → [توليد صورة قطة]
الدور الثاني: [صورة الدور السابق + موجه: أضف وشاحًا أحمر للقطة] → [الصورة بعد التعديل]
الدور الثالث: [صورة الدور السابق + موجه: غيّر الخلفية إلى مشهد ثلجي] → [الصورة النهائية]

الميزة: تحسين الصورة تدريجيًا من خلال تكرارات متعددة، مما يجعل التأثير أكثر قابلية للتحكم مقارنةً بموجه معقد لمرة واحدة.

إعدادات سير عمل Nano Banana 2 ComfyUI الموصى بها

💰 تحسين التكلفة: للإنشاء اليومي، يوصى باستخدام Nano Banana 2، حيث يكلف استدعاء APIYI apiyi.com $0.03 فقط لكل مرة، مما يوازن بين جودة الصورة والتكلفة. في سيناريوهات التوليد الدفعي، يمكن التبديل إلى Nano Banana ($0.025/مرة) لتقليل التكلفة بشكل أكبر.

نصائح تبديل نماذج Nano Banana 2 في ComfyUI

الطريقة الأساسية للتبديل بنقرة واحدة

يتم استدعاء جميع نماذج السلسلة عبر واجهة APIYI الموحدة apiyi.com، ولتبديل النموذج، ما عليك سوى تعديل معلمة واحدة:

# الطريقة: قم بتغيير معلمة النموذج فقط، والباقي يبقى كما هو

# Nano Banana 2 - الخيار اليومي المفضل
model = "gemini-3.1-flash-image-preview"

# Nano Banana Pro - لمن يبحث عن جودة صورة قصوى
model = "gemini-3-pro-image-preview"

# Nano Banana - لمن يبحث عن أفضل قيمة
model = "gemini-2.5-flash-image"

في عقدة ComfyUI، ما عليك سوى تبديل اسم النموذج المقابل في القائمة المنسدلة للنموذج أو مربع النص. لا يلزم تغيير base_url ومفتاح API على الإطلاق.

سير عمل قرار تبديل النموذج

اختر النموذج بناءً على متطلباتك الإبداعية:

هل تحتاج إلى أعلى جودة صورة؟ ← NB Pro (gemini-3-pro-image-preview)
     ↓ لا
هل تحتاج إلى 4K + سرعة عالية؟ ← NB2 (gemini-3.1-flash-image-preview)
     ↓ لا
هل تبحث عن أقل تكلفة؟ ← NB (gemini-2.5-flash-image)

مكونات إضافية أخرى لـ Nano Banana 2 ComfyUI

بالإضافة إلى الحلين الموصى بهما، هناك مكونات إضافية أخرى ذات صلة متاحة في المجتمع للرجوع إليها:

ملاحظة: لا تدعم عقدة الشراكة الرسمية لـ ComfyUI (Partner Node) دمج واجهات API الخارجية. إذا كنت بحاجة إلى استخدامها عبر APIYI، يرجى اختيار الحل A أو الحل B. يختلف دعم base_url للمكونات الإضافية الأخرى من المجتمع باختلاف الإصدارات، يرجى مراجعة وثائق مستودع GitHub المقابل قبل الاستخدام.

اعتبارات تثبيت مكونات Nano Banana 2 ComfyUI الإضافية

عند تثبيت العقد المخصصة لـ ComfyUI، يرجى الانتباه إلى المشكلات الشائعة التالية:

1. بيئة Python: تأكد من استخدام بيئة Python المرفقة مع ComfyUI لتثبيت التبعيات، لتجنب الخلط بين Python النظام و Python الخاص بـ ComfyUI.
2. تعارض التبعيات: إذا قمت بتثبيت عدة مكونات إضافية ذات صلة بـ Gemini، فقد يحدث تعارض في إصدارات التبعيات. يُنصح بالاحتفاظ بمكون إضافي واحد فقط.
3. تحديث المكونات الإضافية: قم بتحديث رمز المكون الإضافي بانتظام باستخدام git pull للحصول على أحدث الميزات والإصلاحات.
4. استكشاف الأخطاء وإصلاحها من خلال السجلات: عند مواجهة مشكلات، تحقق من مخرجات وحدة تحكم ComfyUI، حيث عادةً ما تحتوي على رسائل خطأ واضحة.

# تحديث المكون الإضافي إلى أحدث إصدار
cd ComfyUI/custom_nodes/ComfyUI-IF_Gemini
git pull
pip install -r requirements.txt

أسئلة متكررة

ملخص دمج Nano Banana 2 مع ComfyUI

خطوات دمج Nano Banana 2 مع ComfyUI بسيطة للغاية: تثبيت المكون الإضافي ← تهيئة API ← اختيار النموذج.

مراجعة النقاط الرئيسية

الاستنتاجات الرئيسية

1. اختر المكون الإضافي المناسب: نوصي بـ ComfyUI-IF_Gemini (وظائف غنية) أو comfyui-gemini-nodes (سهل البدء).
2. تهيئة واجهة APIYI الموحدة: اضبط base_url على https://vip.apiyi.com/v1، وبتكوين واحد يمكنك استخدام جميع النماذج.
3. تبديل النماذج بمرونة: NB2 ($0.03)، NB Pro ($0.05)، NB ($0.025)، ما عليك سوى تعديل معلمة النموذج (model parameter).
4. سير عمل متعدد: تحويل النص إلى صورة، تحويل صورة إلى صورة، نقل الأسلوب، محادثات متعددة الأدوار، لتلبية احتياجات الإبداع المختلفة.
5. ميزات حصرية: وظيفة Grounding للبحث عن الصور الفريدة في NB2، تفتح المزيد من الإمكانيات للإبداع.

نوصي بالحصول بسرعة على مفتاح API عبر APIYI apiyi.com، وفي غضون 5 دقائق يمكنك تجربة جودة Pro والسرعة الفائقة في توليد الصور باستخدام Nano Banana 2 في ComfyUI. واجهة موحدة لجميع النماذج، مع إمكانية التبديل حسب الحاجة في أي وقت.

المؤلف: فريق APIYI | للتواصل التقني: APIYI apiyi.com

تستند هذه المقالة إلى أحدث إصدار من ComfyUI واختبارات فعلية على منصة APIYI. في حال وجود تحديثات للمكونات الإضافية، يرجى الرجوع إلى وثائق مستودع GitHub الخاص بها.