كيف تستخدم واجهة برمجة تطبيقات Nano Banana 2.1؟ التوليد والتحرير

TLDR Nano Banana 2.1 (gemini-nano-banana-2.1) هو نموذج التوليد الصوري عالي الكفاءة والتحرير الحواري المحدَّث ضمن عائلة Gemini. مبني على Gemini 3.6 Flash، ويقدّم جودة بصرية وواقعية محسّنة (1K/2K/4K)، ومعالجة لعيوب التبليط في نسب الأبعاد الشديدة، وأداء متفوّق في عرض النصوص وتخطيط الإنفوغراف، ودمج متعدد الصور (حتى 14 مرجعًا مع الحفاظ على الاتساق حتى 4 شخصيات و10 كائنات)، والارتكاز على Google Search/Image Search، ومستويات تفكير قابلة للضبط (حدّ أدنى/متوسط/مرتفع).

يتموضع كنظيرٍ عالي الكفاءة لـNano Banana Pro مع تقديم نحو نصف تكلفة الصورة مقارنة بسلفه Nano Banana 2 عند العديد من الدقات. يبدأ التسعير الرسمي بنحو 0.0336$ لكل صورة 1K (الفئة Standard). يمكنك الوصول إليه عبر Gemini API (يفضّل Interactions API)، أو Google AI Studio، أو المجمعات الموحّدة مثل CometAPI للحصول على مفتاح واحد متوافق مع OpenAI، وتكامل مبسّط، وأسعار تنافسية. تغطي هذه الدليل الإعداد، وأمثلة الشيفرة، والميزات المتقدمة، ومقارنات التسعير، وأفضل الممارسات، وتوصيات الإنتاج.

أهم النقاط

• Nano Banana 2.1 هو أحدث نموذج من Google لتوليد الصور عالي الكفاءة والتحرير الحواري، ويتموضع كنظيرٍ فعّال لـ Nano Banana Pro.
• تُظهر اختبارات Google أنه يسجل 1050 Elo في تفضيل النص إلى صورة بشكل عام (مقابل 990 لـ Nano Banana 2 و935 لـ Pro) مع مكاسب قوية في الاتساق والتحرير.
• يبدأ التسعير بنحو 0.0336$ لكل صورة قياسية 1K عبر Gemini API — أي حوالي نصف Nano Banana 2.
• يدعم حتى 14 صورة مرجعية، واتساق حتى 4 شخصيات + 10 كائنات، ونسب بانورامية بدون عيوب التبليط، والارتكاز الفوري على الويب/صور الويب.
• سيتم إيقاف Nano Banana 2 في 29 أكتوبر 2026؛ ابدأ بالترحيل قريبًا.
• للمطورين، توفر منصات مثل CometAPI نقطة نهاية موحّدة متوافقة مع OpenAI للوصول إلى Nano Banana 2.1 إلى جانب 500+ نموذجًا بمفتاح واحد وبأسعار تنافسية.

ما هو Nano Banana 2.1؟

Nano Banana 2.1 هو أحدث عضو من Google DeepMind ضمن سلسلة Gemini 3 للنماذج متعددة الوسائط أصلًا والمختصة بالاستدلال. يستند رسميًا إلى Gemini 3.6 Flash، ويتخصص في توليد الصور عالية الجودة من النص والتحرير الحواري للصور.

يقبل إدخالات نصوص وصور وفيديو وملفات PDF (نافذة سياق تصل إلى ~1M رمز في بعض الوثائق، أو 131,072 في مواصفات API) ويُنتج صورًا (حتى 4K) بالإضافة إلى نص. جميع الصور المولدة تحمل العلامة المائية SynthID من Google.

تصفه Google بأنه تحديث لـ Nano Banana 2 (Gemini 3.1 Flash Image) يحافظ على سرعة وتكلفة مستوى Flash مع تقديم تحسينات كبيرة في الجودة البصرية، والالتزام بالتوجيهات النصية، والاتساق متعدد الأدوار عبر المحادثات، وعرض النصوص. ويتم تقديمه صراحةً كـ"النظير الأكثر كفاءة" للنموذج الأعلى Nano Banana Pro (Gemini 3 Pro Image).

أداء Nano Banana 2.1 في الاختبارات المعيارية

نشرت Google نتائج تفضيل بشري (Elo) وتحقق من الحقائق داخلية بمقارنات جنبًا إلى جنب حتى أكتوبر 2026. لاحظ أن الاختبارات المستقلة من جهات خارجية كانت محدودة عند الإطلاق.

قدرات النص إلى صورة

قدرات التحرير

المصدر: Google DeepMind Nano Banana 2.1 Model Card.

يشير Elo الأعلى إلى تفضيل بشري أقوى. كما تُظهر درجة الموثوقية (الأعلى أفضل) قفزة كبيرة خصوصًا في الإنفوغراف الدقيقة. تضع هذه النتائج Nano Banana 2.1 كأقوى نموذج ضمن فئة Flash لدى Google حتى الآن، ومنافسًا (أو متفوقًا) على Pro في العديد من الجوانب العملية بكلفة وزمن أقل.

التسعير الرسمي واعتبارات التكلفة لـ Nano Banana 2.1 (بداية أكتوبر 2026)

تسعير Google المرجعي للفئة Standard (لكل صورة ناتجة، قبل احتساب رموز الإدخال/التفكير/النص الإضافي) تقريبًا:

تُسعَّر رموز الإدخال بحوالي 1.50$ لكل 1M؛ وإخراج النص + التفكير بحوالي 7.50$ لكل 1M وفق بعض التفصيلات. لا توجد فئة API مجانية لهذا النموذج. تعتمد التكلفة النهائية على طول التوجيه، وعدد الصور المرجعية، ومستوى التفكير، والدقة، وأي نص إضافي في المخرجات.

مقارنةً بـ Nano Banana 2، تأتي تكلفة كل صورة بنحو النصف عند الدقات المماثلة، ما يجعل التوليد الحجمي أكثر اقتصادية. يظل Nano Banana Pro أغلى بكثير عند الحاجة إلى أعلى مستوى من الدقة. تحقّق دائمًا من صفحة تسعير Gemini API المباشرة، إذ قد تتغير الأسعار وآليات احتساب الرموز.

على سبيل المثال، أضافت CometAPI دعمًا سريعًا لـ gemini-nano-banana-2.1 وتوفّر وصولًا موحدًا بأسعار تنافسية ومفتاح واحد عبر مئات النماذج.

كيفية الوصول إلى API الخاص بـ Nano Banana 2.1 وإعداده

معرّف النموذج: gemini-nano-banana-2.1

استخدم Interactions API الحديثة أو مسارات generateContent مع حزمة google-genai.

مع صور مرجعية ودقة/تفكير أعلى: قدّم الصور بترميز base64 ضمن قائمة الإدخال واضبط خيارات صيغة الاستجابة لنسبة الأبعاد وحجم الصورة (1K/2K/4K). فعّل أدوات Google Search للارتكاز عندما تكون الدقة الواقعية مهمة.

1. Google Gemini API الرسمي (مستحسن للتكافؤ الكامل في الميزات)

• أنشئ مشروعًا في Google AI Studio / Google Cloud مع تفعيل الفوترة.
• احصل على مفتاح API من Google AI Studio.
• ثبّت الحزمة الرسمية: pip install -U google-genai (Python) أو المكافئ لـ JavaScript/Node (@google/genai).
• الواجهة الحديثة المفضلة: Interactions API (client.interactions.create). تظل GenerateContent متاحة في بعض السياقات.
• نمط نقطة النهاية الأساسية: https://generativelanguage.googleapis.com/v1beta/interactions (أو مسارات generateContent الخاصة بالنموذج). المصادقة عبر ترويسة x-goog-api-key أو متغير البيئة في الحزمة GEMINI_API_KEY.

2. Google AI Studio

مثالي للنمذجة السريعة، واختبار التوجيهات، والمعاينة البصرية قبل كتابة الشيفرة. اختر النموذج وجرّب المراجع والدقات ومستويات التفكير.

3. المجمعات الموحّدة (توصية CometAPI)

توفّر CometAPI نقطة نهاية واحدة متوافقة مع OpenAI (https://api.cometapi.com/v1) ومفتاحًا واحدًا لأكثر من 500 نموذج، بما في ذلك سلسلة Gemini Nano Banana. تدعم التسعير بالدفع عند الاستخدام، ولوحات استخدام، وتوافقًا إسقاطيًا مع حزم SDK. يعد هذا ثمينًا إذا كنت تستخدم عدة مزوّدين أو ترغب في اختبار A/B لنماذج الصور دون إدارة بيانات اعتماد وفوترة متعددة. سجّل في CometAPI.com للحصول على أرصدة اختبار مجانية، وأنشئ مفتاحًا، ووجّه عميلك المتوافق مع OpenAI إلى عنوان CometAPI الأساسي. يظل معرّف النموذج gemini-nano-banana-2.1.

بالنسبة إلى CometAPI، بدّل عنوان الأساس والمفتاح مع الحفاظ على بنية عميل متوافق مع OpenAI أو Gemini. تستخدم CometAPI نمط نقطة نهاية GenerateContent للوصول إلى nano Banana 2.1.

مقارنة مسارات الوصول إلى Nano Banana 2.1 API

اختر المزوّد قبل نسخ الشيفرة. تقدّم Google سير عمل Interactions المباشر المستخدم في أمثلة Python أدناه. يوفّر Nano Banana 2.1 API في CometAPI مسار البوابة المستخدم في مثال cURL. قارن المصادقة وحقول الإدخال والتعامل مع الإخراج وحالة المحادثة كتكامل كامل؛ تنتمي المفاتيح إلى حسابات وأنظمة فوترة منفصلة.

تستخدم أمثلة Google أدناه Interactions API. وهي ليست طلبات لمسار generateContent في CometAPI. اتّبع نظرة عامة Interactions من Google لحالة التفاعل والتعامل مع الاستجابة. تم التحقق من الأمثلة مقابل مخططات الطلب المنشورة؛ لم تُجرَ أي طلبات موثّقة أو مفوترة لهذا الدليل.

توليد صورة وحفظها باستخدام Nano Banana 2.1 API

Google: التوليد باستخدام Python

ثبّت حزمة Google Gen AI لـ Python في بيئة المشروع حيث ستشغّل generate_image.py. يطلب الطلب الأول أدناه صورة PNG بدقة 2K مع تركيب 16:9 وعنوان محدّد. احفظ النتيجة وتحقق منها قبل إضافة التحرير أو صور مرجعية.

python -m pip install -U google-genai

احفظ الشيفرة التالية باسم generate_image.py. تتبع دليل توليد الصور من Google لإنشاء تفاعل، والتحقق من الصورة المعادة، وفك ترميز بياناتها وحفظ PNG. يحدد توجيه إعلان المنتج الموضوع والإضاءة والعنوان الدقيق بحيث يمكنك التحقق مما إذا كانت المخرجات تلبي الطلب.

import base64
import os
from pathlib import Path
from google import genai

MODEL = "gemini-nano-banana-2.1"
client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])
image_format = {
    "type": "image",
    "mime_type": "image/png",
    "aspect_ratio": "16:9",
    "image_size": "2K",
}

def save_image(result, filename):
    image = result.output_image
    if image is None or not image.data:
        raise RuntimeError("لم يتم إرجاع أي صورة؛ افحص الاستجابة قبل إعادة المحاولة")
    Path(filename).write_bytes(base64.b64decode(image.data))

interaction = client.interactions.create(
    model=MODEL,
    input=("أنشئ إعلان منتج لكوب قهوة خزفي أبيض. "
           "استخدم خلفية استوديو دافئة وإضاءة جانبية ناعمة. "
           "ضمّن فقط العنوان EXACT MORNING COFFEE."),
    response_format=image_format,
)
save_image(interaction, "mug-ad.png")
print("Saved mug-ad.png; interaction ID:", interaction.id)

python generate_image.py

يحفظ السكربت mug-ad.png ويطبع معرّف التفاعل. استخدم عمليات التحقق في الخطوة 3 قبل قبول الصورة أو متابعة التحرير.

CometAPI: التوليد باستخدام cURL

بعد ضبط COMETAPI_KEY في الخطوة 1، شغّل طلب Bash التالي باستخدام المسار الموثّق لـ CometAPI. سيحفظ الاستجابة JSON باسم comet-response.json؛ تستخرج الخطوة 3 الصورة المعادة وتحفظها.

curl --fail-with-body --silent --show-error \
  "https://api.cometapi.com/v1beta/models/gemini-nano-banana-2.1:generateContent" \
  -H "x-goog-api-key: $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{
    "contents": [{"parts": [{"text": "أنشئ صورة منتج استوديو لكوب خزفي أبيض."}]}],
    "generationConfig": {"responseModalities": ["TEXT", "IMAGE"]}
  }' \
  --output comet-response.json

التعامل مع الاستجابة

Google: تحقق من الصورة المحفوظة ومعرّف التفاعل

تتحقق save_image من output_image، وتفك ترميز بيانات الصورة وتحفظ mug-ad.png. افتح الملف وتحقق من الكوب والتركيب والعنوان الدقيق. احتفظ بمعرّف التفاعل للدور التحريري التالي. النجاح في HTTP وحده لا يضمن أن الصورة المطلوبة قد تمت إعادتها.

تعيد الخاصية المساعدة output_image آخر صورة مُولّدة. إذا كنت تحتاج عدة صور أو مزج نصوص ومرئيات، عالج خطوات التفاعل. افحص معلومات غياب الصورة أو الأمان قبل إعادة المحاولة.

CometAPI: استخراج الصورة وحفظها

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

إذا أعادت البوابة بنية candidates → content → parts الأصلية الموصوفة في مرجع generateContent من Google، فاحفظ الأجزاء الصورية المضمنة باستخدام هذا السكربت المستقل. يقبل حقول camelCase وsnake_case ويحافظ على صيغة الصورة المعادة:

import base64
import json
from pathlib import Path

payload = json.loads(Path("comet-response.json").read_text(encoding="utf-8"))
saved = 0
for candidate in payload.get("candidates", []):
    for part in candidate.get("content", {}).get("parts", []):
        if part.get("thought"):
            continue
        blob = part.get("inlineData") or part.get("inline_data")
        if not blob or not blob.get("data"):
            continue
        mime = blob.get("mimeType") or blob.get("mime_type")
        ext = {"image/png": "png", "image/jpeg": "jpg", "image/webp": "webp"}.get(mime)
        if ext:
            saved += 1
            Path(f"comet-image-{saved}.{ext}").write_bytes(base64.b64decode(blob["data"]))
if not saved:
    raise RuntimeError("لم يتم العثور على صورة مضمنة؛ افحص مخطط الاستجابة وتفاصيل الخطأ")
print(f"Saved {saved} image(s)")

احفظ المستخرج أعلاه باسم save_comet_image.py في نفس المجلد مع comet-response.json، ثم شغّله باستخدام Python. افتح كل ملف comet-image محفوظ وتحقق من محتواه. إذا لم يتم العثور على صورة مضمنة، افحص الاستجابة الفعلية وتفاصيل الخطأ قبل تعديل المُحلِّل أو إعادة المحاولة.

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

كيف تحرّر صورة باستخدام Nano Banana 2.1 API؟

تحرير صورة مولّدة باستخدام Nano Banana 2.1

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

edited = client.interactions.create(
    model=MODEL,
    previous_interaction_id=interaction.id,
    input=("غيّر فقط لون الكوب إلى أسود مطفأ. "
           "أبقِ العنوان والخلفية والإطار والإضاءة دون تغيير."),
    response_format=image_format,
)
save_image(edited, "mug-ad-edited.png")
print("Saved mug-ad-edited.png; interaction ID:", edited.id)

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

إرسال صورة مرجعية محلية إلى Nano Banana 2.1

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

reference = base64.b64encode(Path("product.png").read_bytes()).decode("ascii")
from_reference = client.interactions.create(
    model=MODEL,
    input=[
        {"type": "text", "text": "ضع هذا المنتج على خلفية استوديو نظيفة. احفظ شكله والملصق."},
        {"type": "image", "mime_type": "image/png", "data": reference},
    ],
    response_format=image_format,
)
save_image(from_reference, "product-studio.png")

التحكم في مخرجات الصور والمراجع في Nano Banana 2.1

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

الميزات المتقدمة

• مستويات التفكير: عيّنها إلى "حدّ أدنى" للسرعة، أو "متوسط" (الافتراضي) للتوازن، أو "مرتفع" للتركيبات المعقدة، والتخطيطات الغنية بالنصوص، أو الالتزام الدقيق متعدد الكائنات. يزيد التفكير الأعلى زمن الاستجابة وتكلفة الرموز لكنه يحسّن النتائج في التوجيهات الصعبة.
• الارتكاز على البحث: فعّل أدوات Google Search / Image Search بحيث يمكن للمخرجات الاستناد إلى مراجع واقعية أو آنية (الطقس، المنتجات، الأحداث، الأنواع الدقيقة، إلخ).
• إدخال الفيديو: مدعوم للسياق في التوليد (مثل استخراج الأسلوب أو المواضيع من مقاطع قصيرة).
• Batch API: متاح لأعمال الدُفعات ذات الحجم الكبير بأسعار مخفضة.
• الدقات والصيغ: 1K افتراضيًا؛ اطلب 2K أو 4K صراحةً. يكون الإخراج عادة PNG/JPEG وفق الإعداد.

احترم دائمًا سياسة الاستخدام المحظور للذكاء الاصطناعي التوليدي من Google وتأكد أن لديك حقوق أي صور مرجعية.

عائلة Nano Banana (بيانات تقريبية، أوائل أكتوبر 2026)

الخلاصة والتوصية

يُعد Nano Banana 2.1 أقوى نموذج لدى Google حتى الآن ضمن فئة التوليد والتحرير عاليي الكفاءة — ترقية عملية تحسّن الجودة البصرية، ودقة النصوص، والاتساق، وقوة التعامل مع نسب الأبعاد، مع الحفاظ على اقتصاديات مستوى Flash. بالنسبة لمعظم أعباء العمل الإنتاجية التي تحتاج صورًا موثوقة عالية الجودة مع التزام جيد بالتوجيه وقدرات تحرير، فهو الخيار الافتراضي الواضح ضمن عائلة Gemini في أكتوبر 2026.

لبدء الاستخدام اليوم:

1. جرّب في Google AI Studio.
2. اندمج عبر Gemini API الرسمي لأقصى قدر من التحكم.
3. أو سرّع التطوير وبسّط التشغيل متعدد النماذج باستخدام منصة CometAPI الموحدة والمتوافقة مع OpenAI — مفتاح واحد، تسعير تنافسي، وصول سريع إلى أحدث النماذج بما فيها gemini-nano-banana-2.1، وتحليلات جاهزة للإنتاج.

ابدأ التجربة اليوم عبر الـ API، ورحّل أي أعباء عمل متبقية على Nano Banana 2 قبل موعد الإيقاف في 29 أكتوبر. لم تكن أدوات الصور بالذكاء الاصطناعي عالية الجودة والمتسقة والاقتصادية أكثر إتاحةً مما هي عليه الآن.