كيفية استخدام واجهة برمجة تطبيقات Nano Banana 2

Nano Banana 2 — الاختصار الذي يستخدمه المجتمع لنموذج Google الأحدث لتوليد الصور ضمن عائلة Gemini — أعاد بسرعة تشكيل التوقعات بشأن التوليد والتحرير السريع وعالي الدقة للصور. أُطلق في أواخر فبراير 2026، هذا الإصدار “Flash Image” (Gemini 3.1 Flash Image / Nano Banana 2) يستهدف المطورين وفرق المنتج الذين يحتاجون إلى مخرجات احترافية مع معدل تمرير عالٍ وزمن استجابة منخفض. في هذه المقالة أجمع أحدث التقارير والوثائق لشرح ما هو Nano Banana 2، وكيف يؤدي في معايير القياس، وكيفية الوصول إليه واستدعائه (بما في ذلك عبر بوابات طرف ثالث مثل CometAPI)، وأنماط التوجيه والاستخدام العملية التي يمكنك اعتمادها في الإنتاج.

CometAPI يوفر واجهة واحدة بأسلوب HTTP تكشف العديد من النماذج (بما فيها نماذج الصور) تحت نقاط نهاية متسقة. هذا يمكن أن يبسط التبديل بين الموردين أو دمج المخرجات من عدة نماذج. Nano Banana 2 (Gemini 3.1 Image) متاح الآن على CometAPI.

ما هو Nano Banana 2؟

Nano Banana 2 (متوافق داخليًا مع Gemini 3.1 Flash Image) هو نموذج توليد صور مركز وفعال من Google يعطي الأولوية للسرعة وتكلفة أقل لكل صورة وقدرة أقوى على اتباع التعليمات للمهام الإبداعية والتحريرية. تم تصميمه ليكون إلى جانب إصدارات “Pro” عالية الدقة: Nano Banana 2 من أجل معدل تمرير عالٍ وNano Banana Pro (Gemini 3 Pro Image) من أجل مخرجات ممتازة بمستوى الأصول.

تم تصميمه لتقديم:

• الاستدلال السريع (يستهدف زمن استجابة منخفض جدًا بحيث يبدو توليد الصور والتحرير شبه فوري).
• جودة بصرية عالية تقترب من عائلة “Pro” ولكن بحوسبة/تكلفة أقل.
• اتباع تعليمات أفضل (تصيير أدق للمواضيع المطلوبة، النص داخل الصورة، والمشاهد متعددة الشخصيات).
• دعم واسع للدقة ونسب الأبعاد، من معاينات صغيرة سريعة وصولًا إلى خطوط أنابيب 2K/4K الأصلية للأصول النهائية.

ما الذي يجعل Nano Banana 2 مختلفًا عن Nano Banana الأصلي / Pro؟

• البنية/المحرك: مبني على حزمة الاستدلال Flash الخاصة بـ Gemini (Gemini 3.1 Flash Image)، لذا يستبدل بعض إعدادات الجودة القصوى مقابل تحسينات كبيرة في السرعة والتكلفة.
• حالات الاستخدام: مثالي للأتمتة واسعة النطاق (أصول التسويق، الصور المصغرة، واجهات المستخدم)، التحرير شبه الآني، والتدفقات حيث يهم زمن الاستجابة والتكلفة ولكنك لا تزال تحتاج إلى دقة موضوع بمستوى Pro.

أداء الاختبارات المعيارية لـ Nano Banana 2

اتساق عبر الفئات

Gemini 3.1 Flash Image يُظهر تحسنًا ملموسًا في كل فئة مُبلغ عنها مقارنةً بـ Gemini 2.5 Flash.

أقوى المكاسب

• الجودة البصرية
• التحرير التركيبي متعدد المدخلات
• متانة التحرير العامة

التموضع التنافسي

• يتصدر تفضيل GenAI-Bench الداخلي بشكل عام.
• يتفوق على GPT-Image 1.5 في المقاييس العامة والبصرية.
• تحسينات طفيفة ضيقة تشير إلى صقل معماري بدلًا من تحول جذري.

كيف يمكنني الوصول إلى Nano Banana 2؟

أين يتوفر

Nano Banana 2 يمكن الوصول إليه عبر أدوات Gemini من Google (تطبيق Gemini)، واجهة Gemini API (موثقة تحت وثائق مطوري AI من Google)، ويجري إظهاره عبر منتجات سحابية مؤسساتية مثل Vertex AI من أجل معاينة/تكاملات مؤسساتية. كما أعلن CometAPI دعمًا وواجهات تغليف لتسهيل التكامل.

كيفية استخدام واجهة Nano Banana 2 API (cometapi): ما الخيارات؟

يستخدم دليل CometAPI شكل generateContent بأسلوب Gemini ويعيد الصور كـ Base64 في candidates[0].content.parts[].inline_data.data. يجب عليك فك ترميز Base64 لحفظ الملف على جهة العميل. فقط تحتاج إلى استبدال https: //generativelanguage.googleapis.com بـ https://api.cometapi.com . تُوفر الصورة المُعادة عادةً كـ inline_data مشفرة بـ Base64. ستحتاج إلى فك ترميزها على جهة العميل وحفظها كملف. CometAPI يقدم خصومات تساعدك على استخدام واجهة Nano Banana 2 API.

يوفر CometAPI مغلف REST موحد ونقاط نهاية صريحة لنماذج Gemini — مثالي إذا كنت تفضل بيانات اعتماد واحدة وتريد تبديل المزودين دون تغيير شفرة تطبيقك. بالنسبة إلى Nano Banana 2، تتضمن صفحة CometAPI مقتطف curl مباشر لنقطة نهاية gemini-3.1-flash-image-preview:generateContent. أدناه مثال curl مُنقى استنادًا إلى وثائق CometAPI.

المتطلبات الأساسية لاستخدام Nano Banana 2 عبر CometAPI

حساب CometAPI ومفتاح API: أنشئ حسابًا على CometAPI واستخرج مفتاح وصول API (sk-…). هذا المفتاح هو ما ستستخدمه للمصادقة لجميع طلبات API إلى نقاط نهاية CometAPI.

لغات البرمجة وبيئات التشغيل:

• Node.js 18+ (لـ JavaScript/TypeScript)
• Python 3.10+
• (أو أي لغة يمكنها تنفيذ طلبات HTTP)

أدوات HTTP أو SDKs:

• لـ JavaScript: fetch، axios، أو العميل المتوافق مع OpenAI
• لـ Python: requests، httpx، أو عميل OpenAI
• هذه الأدوات تساعدك في إرسال استدعاءات API والتعامل مع الاستجابات.

نظرة سريعة على نمط الطلب

• عنوان الأساس: https://api.cometapi.com (قاعدة CometAPI).
• أسماء النماذج: gemini-3.1-flash-image-preview (Nano Banana 2 / gemini 3.1 Flash Image) أو gemini-2.5-flash-image بحسب التوفر.
• المصادقة: ترويسة Authorization: sk-xxxx — عادةً يستخدم CometAPI مفتاحًا بأسلوب sk-.
• الاستجابة: تُعاد الصور كـ Base64 تحت response.candidates[0].content.parts[].inline_data.data. فك الترميز واكتب إلى القرص.

سير عمل نموذجي (على مستوى عالٍ)

1. احصل على مفتاح API من CometAPI.
2. اختر معرف النموذج (مثلًا، gemini-3.1-flash-image أو ما شابه، بحسب التوفر).
3. أرسل طلب POST إلى نقطة توليد النموذج مع توجيهك (prompt).
4. تعامل مع بيانات الصورة المُعادة في تطبيقك (فك الترميز من base64، تقديمها كـ PNG، إلخ).
5. للتحرير الصوري، ضمّن بيانات الصورة الحالية وتعليمات التحرير في طلبك.

استخدام واجهة Gemini الرسمية (نص → صورة)

أدناه مثال قصير بـ Node.js يوضح كيفية استدعاء نقطة نهاية generateContent لـ gemini-3.1-flash-image-preview (يعكس المقتطفات الرسمية في الوثائق). استبدل YOUR_API_KEY ببيانات اعتمادك وأضف معالجة للأخطاء للإنتاج.

# احصل على مفتاح CometAPI من https://api.cometapi.com/console/token
# صدّره كالتالي: export COMETAPI_KEY="your-key-here"

mkdir -p ./output

curl -s "https://api.cometapi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent" \
  -H "Authorization: $COMETAPI_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "امرأة تتكئ على حاجز خشبي في مبنى صيني تقليدي. ترتدي تشيونغسام زرقاء بنقوش زهرية وردية وحمراء وتاجًا من الزهور الملوّنة، بما في ذلك الورود والليلك. أسلوب رسم واقعي، مع التركيز على التفاصيل الملمسية لنقوش الملابس والمباني الخشبية."
          }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["IMAGE"],
      "imageConfig": {
        "aspectRatio": "9:16"
      }
    }
  }' | python3 -c "
import sys, json, base64
data = json.load(sys.stdin)
parts = data['candidates'][0]['content']['parts']
for part in parts:
    if 'text' in part:
        print(part['text'])
    elif 'inlineData' in part:
        img = base64.b64decode(part['inlineData']['data'])
        with open('./output/gemini-3.1-flash-image-preview.png', 'wb') as f:
            f.write(img)
        print('تم حفظ الصورة في ./output/gemini-3.1-flash-image-preview.png')
"

يوفر CometAPI مجموعات SDK وأغلفة عملاء متوافقة مع OpenAI، لذا يمكن لبعض الفرق تبديل المزودين مع تغييرات طفيفة في الشفرة، ويتيح لك طلب مخرجات صور مشفرة Base64 أو عناوين URL مستضافة بحسب تهيئتك. تحقّق دائمًا من مخطط generateContent الرسمي لحقول الحمولة الدقيقة.

تدفق صورة→صورة (تحرير)

لتحرير صورة موجودة:

1. حوّل صورتك المصدر إلى Base64 (دون بادئة data:image/...;base64,).
2. أرسل POST ببيانات تشمل inline_data.data التي تحتوي على سلسلة Base64 تلك وتعليمات التحرير (مثلًا: “غيّر الخلفية إلى سماء الغسق، أزل العلامة المائية”).
3. ستتضمن الاستجابة مخرج Base64 جديدًا لفك ترميزه وحفظه.

curl 
--location 
--request POST 'https://api.cometapi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent' \ 
--header 'Authorization: ' \ 
--header 'Content-Type: application/json' \ 
--data-raw '{ "contents": 
[ { "role": "user", "parts": 
[ { "text": "امزج ثلاث صور لإخراج صورة عالية الدقة" }, { "inline_data": { "mime_type": "image/jpeg", "data": "<your_first_image_base64_data_here>" } }, { "inline_data": { "mime_type": "image/jpeg", "data": "<your_second_image_base64_data_here>" } }, { "inline_data": { "mime_type": "image/jpeg", "data": "<your_third_image_base64_data_here>" } } 
] } 
], "generationConfig": { "responseModalities": [ "TEXT", "IMAGE" 
] } }'

المعلمات الشائعة للضبط

• model: اختر gemini-3.1-flash-image-preview (Nano Banana 2) أو gemini-3-pro-image-preview (Pro).
• imageConfig.aspect_ratio وimageConfig.image_size (512، 1K، 2K، 4K) — تؤثر في التكلفة وزمن الاستجابة.
• responseModalities: ["Image"] أو ["Text","Image"] للتدفقات متعددة الوسائط.

كيف أصيغ التوجيهات لـ Nano Banana 2؟

هندسة التوجيه لنماذج الصور تمزج بين التركيب والأسلوب وتلميحات الكاميرا/الإضاءة وعبارات القيود. Nano Banana 2 مضبوطة لاتباع التعليمات بشكل موثوق، لذا وازن بين الإيجاز والوضوح.

بنية التوجيه (موصى بها)

1. الموضوع الأساسي: من/ما الموجود في الصورة.
2. الفعل أو الحالة: ما الذي يفعله الموضوع.
3. البيئة والمزاج: الإعداد، الإضاءة، الأجواء.
4. التوجيهات التقنية: عدسة الكاميرا، نسبة الأبعاد، الدقة، التركيب.
5. الأسلوب والمراجع: أسلوب فني، مراجع فنانين (انتبه لقواعد حقوق النشر)، الحقبة.
6. القيود: عدد الشخصيات/الأشياء، تجنب ألوان معينة، تضمين نص واضح.

مثال توجيه:

“صورة فوتورية لبانانا صفراء صغيرة على شكل صاروخ عتيق، موضوعة على طاولة ماهوغاني لامعة في استوديو مُضاء بالشمس. عدسة 50mm، عمق مجال ضحل، إضاءة ساعة ذهبية دافئة، تفاصيل عالية، بدون شعارات مرئية، 2048×1152.”

نصائح لتوجيهات التحرير (inpainting / الاستبدال)

• قدم القناع بوضوح وحدد المناطق التي ينبغي تغييرها.
• استخدم صياغة “حافظ على” للمناطق التي يجب إبقاؤها (مثلًا: “حافظ على ملامح وجه الموضوع، استبدل الخلفية فقط”).
• للنص داخل الصور، قدم النص المحدد بدقة، واذكر الخط/الأسلوب (مثلًا: “خط بسيط قابل للقراءة، محاذاة وسطية”). Nano Banana 2 يركز على تحسين عرض النص، لكن كن صريحًا.

قائمة تدقيق تصحيح التوجيه

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

ما هي العثرات الشائعة وكيف أتجنبها؟

عثرة: الاعتماد المفرط على توجيه واحد

تجنب توقع أن يتكفل توجيه واحد بالتشذيب، والتخطيط، والتحرير متعدد الخطوات. قسّم العمل إلى: توليد قاعدة → تحرير/استبدال → صقل نهائي. استخدم البذور والأقنعة للدقة.

عثرة: تجاهل المنشأ وحقوق النشر

لا تنشر على نطاق واسع بدون SynthID/C2PA أو غيرها من آليات المنشأ. العديد من المؤسسات تتطلب إمكانية تتبع المحتوى المنشأ بالذكاء الاصطناعي.

عثرة: مفاجآت الميزانية

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

أفضل الممارسات الموصى بها مع Nano Banana 2؟

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

هندسة التوجيه ومخرجات حتمية

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

ضبط التكلفة والأداء

• اختر وضع Flash/“Nano Banana 2” للحجم الكبير: إذا كنت تحتاج العديد من التكرارات السريعة، استخدم نماذج فئة Flash وأحجامًا أصغر (2K بدلًا من 4K) لتقليل التكلفة وزمن الاستجابة.
• اجمع الطلبات حيثما أمكن: بعض المزودين يسمحون بتجميع التوجيهات المتعددة — يقلل زمن الاستجابة الإجمالي لكل أصل مُولد في خطوط الإنتاج عالية التمرير. (راجع وثائق مزودك.)

السلامة والمنشأ والجوانب القانونية

• فعّل SynthID وبيانات C2PA الفوقية على الأصول المُولدة لدعم التدقيق والامتثال اللاحق (خصوصًا عند استخدام الصور في الإعلانات/العلاقات العامة). تؤكد Google وشركاؤها على SynthID كآلية المنشأ.
• مراجعة بشرية مضمّنة للمحتوى الحساس: طبقات السياسات المؤتمتة قوية لكنها غير مثالية — استخدم فحوصات يدوية للحملات العامة أو المحتوى الذي يتضمن شخصيات عامة.

ضمان الجودة

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

واجهات استخدام حساسة لزمن الاستجابة

• تجربة تقدمية: أعد مسودة منخفضة الدقة/سريعة أولًا، واستبدلها بتوليد عالي الدقة/Pro عند الجاهزية. هذا يبقي تطبيقك سريع الاستجابة (العديد من المزودين يقدمون نكهة “مسودة” أو Flash).

ملاحظات أخيرة وخطوات تالية

تم تصميم Nano Banana 2 لتغيير اقتصاديات تدفقات الإنتاج المعتمدة على الصور: زمن استجابة أدنى وتكلفة أقل لكل استدعاء يفتحان حالات استخدام مثل توليد أصول إعلانية عند الطلب، اختبار إبداعي سريع A/B، وأدوات تصميم تعاونية لحظية. النموذج مدمج بالفعل عبر أسطح Google الاستهلاكية والسحابية؛ للمطورين الراغبين في الإطلاق بسرعة، يوفر CometAPI مغلف سوق عملي يدعم نقاط نهاية صور Gemini بالإضافة إلى نماذج أخرى — خطوة عملية عندما تريد التجربة مع عدة محركات دون تغيير شفرة التطبيق.
يمكن للمطورين الوصول إلى Nano Banana 2 عبر CometAPI الآن. للبدء، استكشف قدرات النموذج في Playground وراجع دليل API للتعليمات التفصيلية. قبل الوصول، يرجى التأكد من تسجيل الدخول إلى CometAPI والحصول على مفتاح API. يقدم CometAPI سعرًا أقل بكثير من السعر الرسمي لمساعدتك على التكامل.

جاهز للبدء؟→ Sign up fo Nano Banana 2 today !

إذا كنت تريد المزيد من النصائح والأدلة والأخبار حول الذكاء الاصطناعي فاتبعنا على VK، X وDiscord!