كيفية استخدام Nano Banana Pro/Nano Banana 2 API — دليل تفصيلي للمطورين

إذا بحثت عن “Nano Banana Pro API”، فإن أول ما قد يثير الحيرة هو الاسم. اسم المنتج هو Nano Banana Pro. أما اسم واجهة برمجة التطبيقات (API) التي تستخدمها فعليًّا في الكود فهو جيميني 3 -3-برو-صورة. وبمجرد توضيح ذلك، تصبح بقية عملية الإعداد أقل غموضًا بكثير.

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

إذا كان فريقك لا يزال يعمل على صياغة المطالبات بدلاً من إطلاق التطبيق،, مساحة العمل «Nano Banana Pro» من GlobalGPT وهو مكان عملي لمقارنة النتائج قبل أن يقوم المطور بربط واجهة برمجة التطبيقات (API) الرسمية. إنه اختصار مبتكر لسير العمل، ولا يُعد بديلاً عن وحدة تحكم واجهة برمجة التطبيقات (API) من Google، أو نظام الفوترة، أو السجلات، أو أدوات التحكم الخاصة بالمؤسسات.

إجابة سريعة

لاستخدام Nano Banana Pro عبر واجهة برمجة التطبيقات (API)، قم بإنشاء مشروع في Google AI Studio أو Google Cloud، وقم بإنشاء مفتاح API لـ Gemini، وقم بتثبيت Google Gen AI SDK، ثم قم باستدعاء جيميني 3 -3-برو-صورة. ابدأ بطلب واحد لتحويل النص العادي إلى صورة. إذا كنت لا تزال تتحقق من حق الوصول قبل إنشاء واجهة برمجة التطبيقات (API)، فإن دليل تفصيلي للإصدار التجريبي المجاني من Gemini 3 Pro يُعد كتابًا مفيدًا يُنصح بقراءته.

ما هي واجهة برمجة التطبيقات (API) لـ Nano Banana Pro في الواقع؟

Nano Banana Pro هو نموذج جوجل المتميز لتوليد الصور الأصلي ضمن عائلة صور Gemini. وفي وثائق المطورين، تطلق جوجل عليه اسم صورة Gemini 3 Pro. ولهذا السبب تبدو السلسلة النموذجية مختلفة عن الاسم التسويقي.

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

Nano Banana Pro مقابل Nano Banana 2

لا يتعلق الاختيار بقدر كبير بالاسم الذي يبدو أحدث، بل يتعلق أكثر بالمرحلة التي وصلت إليها في العمل. يُستخدم «Pro» للتمرير الدقيق، بينما يُستخدم «Nano Banana 2» لدورة المسودة غير المنظمة؛ فإذا كان هذا المسار الأسرع هو ما تحتاجه، فاقرأ دليل الإصدار التجريبي المجاني لـ Nano Banana 2 قبل أن تصمم سير العمل بأكمله استنادًا إلى Pro.

إعداد واجهة برمجة التطبيقات (API) باستخدام نقاط الدخول الفعلية

بالنسبة للنماذج الأولية، يُعد «Google AI Studio» عادةً الطريق الأسرع. أما بالنسبة لتطبيقات الشركات، فاستخدم إعدادات «Google Cloud» التي يثق بها فريقك بالفعل، خاصةً إذا كنت بحاجة إلى الفوترة المشتركة، أو التحكم في الوصول، أو تسجيل الأحداث، أو حوكمة «Vertex AI». وإذا كان قرار الوصول يتعلق فعليًّا بمستويات خطط «Google»، فقارن بين المزايا والعيوب في دليل المقارنة بين Google AI Plus و Pro قبل اعتبار إعداد واجهة برمجة التطبيقات (API) المشكلة الوحيدة.

تعد الوثائق العامة أفضل نقطة انطلاق. فهي تتيح لك التأكد من أنك في صفحة إنشاء الصورة Nano Banana، والتحقق مما إذا كانت الصفحة تستخدم مسار واجهة برمجة التطبيقات (API) الموصى به لـ Interactions، والانتقال من هناك إلى نقاط الدخول الخاصة بمفتاح واجهة برمجة التطبيقات (API) أو AI Studio.

1. قم بإنشاء أو فتح مشروع في Google AI Studio أو Google Cloud.
2. قم بإنشاء مفتاح API من نوع Gemini.
3. قم بتخزين المفتاح كمتغير بيئة من جانب الخادم.
4. قم بتثبيت Google Gen AI SDK في مشروع الخلفية الخاص بك.
5. قم بإجراء اختبار واحد بدقة منخفضة قبل إضافة الصور المرجعية أو الميزات الموجهة للمستخدم.

صفحة مفتاح واجهة برمجة التطبيقات (API) متاحة للجمهور أيضًا، لكن إنشاء المفتاح أو الاطلاع عليه يعتمد على حسابك في Google وأذونات المشروع. النقطة الأساسية: تجنب استخدام هذا المفتاح في جافا سكريبت الخاص بالواجهة الأمامية. يجب أن يقوم المتصفح أو التطبيق المحمول بالاتصال بخادمك الخلفي، ويجب أن يقوم خادمك الخلفي بالاتصال بـ Gemini.

بعد تسجيل الدخول، يتم توجيه رابط AI Studio المباشر إلى Playground مع نانو بانانا برو تم اختياره بصفته جيميني 3 -3-برو-صورة. وفي هذا التقرير، أشار «AI Studio» أيضًا إلى عقبة عملية تتعلق بالوصول: حيث يتطلب «Nano Banana Pro» اشتراكًا في خطة Google AI أو مفتاح API قبل أن يتمكن «Playground» من تشغيله.

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

تصدير GEMINI_API_KEY="YOUR_API_KEY"

إنشاء الصورة الأولى

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

from google import genai
from google.genai import types
import os

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])

response = client.models.generate_content(
    model="gemini-3-pro-image",
    contents=(
 "قم بإنشاء نموذج أولي نظيف لكوب سفر من الفولاذ المقاوم للصدأ "
 "على مكتب أبيض. أضف الملصق القابل للقراءة: MORNING LAB."
    ),
    config=types.GenerateContentConfig(
 response_modalities=["TEXT", "IMAGE"]
    ),
)

for part in response.candidates[0].content.parts:
    if part.text:
 print(part.text)
    elif part.inline_data:
 with open("nano-banana-pro-output.png", "wb") as f:
 f.write(part.inline_data.data)

تطلب هذه المهمة نموذجًا أوليًّا بسيطًا للمنتج مع نص يمكن قراءته بوضوح. وهذا يمنحك مؤشرًا سريعًا على ثلاثة عناصر مهمة في العمل الفعلي: واقعية الكائن، والتكوين، وقدرة النموذج على إظهار النص القصير بوضوح. لتعديل المهمة دون المساس بالمواصفات، جرب نفس المهمة في مساحة العمل «Nano Banana Pro» من GlobalGPT أولاً.

تحرير الصور مع الإشارات المرجعية

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

إذا لم تكن مطورًا، فاقرأ هذه الكتلة باعتبارها مثالاً على سير العمل وليس كشيء يتعين عليك تنفيذه. اسم الملف product-reference.png وهذا يعني ببساطة “صورة منتجك الحالية”. إذا كانت مهمتك الرئيسية هي مقارنة نماذج الصور، فإن النطاق الأوسع اختبار البدائل لـ Gemini 3 Pro يمكن أن يساعدك في تحديد ما إذا كانت النسخة «Pro» تستحق العناء الإضافي الذي يتطلبه إعدادها.

from google import genai
from google.genai import types
from PIL import Image
import os

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])
reference = Image.open("product-reference.png")

response = client.models.generate_content(
    model="gemini-3-pro-image",
    contents=[
 reference,
 (
 "حافظ على شكل الكوب ومقبضه وموضع الشعار دون تغيير. "
            "غيّر الخلفية إلى سطح مطبخ فاتح، وأضف ضوء الصباح الدافئ، "
 "واحفظ جميع النصوص واضحة وقابلة للقراءة."
 ),
    ],
    config=types.GenerateContentConfig(response_modalities=["TEXT", "IMAGE"]),
)

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

التسعير ومراقبة التكاليف

استخدم صفحة الأسعار الخاصة بـ«جوجل» كمصدر موثوق قبل نشر أرقام الميزانية الثابتة. وفقًا لما تم التحقق منه في 21 يوليو 2026، تدرج «جوجل» خدمة «Nano Banana Pro» ضمن فئة «Gemini 3 Pro Image»، وتفصل تكلفة النص/التفكير عن تكلفة إنتاج الصور.

تكاليف إخراج الصور عبر واجهة برمجة التطبيقات (API)، تم التحقق منها في 21 يوليو 2026

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

ملاحظات الإنتاج

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

• الاحتفاظ بالمفاتيح على جانب الخادم: لا تقم بإرسال مفتاح واجهة برمجة التطبيقات (API) الخاص بـ Gemini عبر متصفح أو تطبيق جوال.
• تسجيل ما يكفي من البيانات لتصحيح الأخطاء: معرّف النموذج، وتجزئة المطالبة، وحجم المخرجات، وزمن الاستجابة، ومعرّف المستخدم، وحالة النتيجة.
• تحديد الحصص: تحديد عدد الصور لكل مستخدم ومساحة عمل وفترة الفوترة.
• أعد المحاولة بحذر: أعد محاولة معالجة حالات الفشل المؤقتة، ولكن لا تقم بإعادة محاولة معالجة أخطاء السياسة أو الحصص في حلقة متكررة.
• تحديد قواعد التخزين: اعرف المدة التي تحتفظ فيها بالصور التي تم إنشاؤها والمراجع التي تم تحميلها.
• اكتب رسائل خطأ مفيدة: أخبر المستخدم ما إذا كانت المشكلة تتعلق بالوصول، أو بتنسيق الملف، أو بالحصة المخصصة، أو بسياسة المطالبة.

أين يمكن استخدام GlobalGPT

يُفضل استخدام GlobalGPT قبل أو أثناء عملية إنشاء واجهة برمجة التطبيقات (API). يمكن للمصمم مقارنة Nano Banana Pro مع نانو بانانا 2, ، و«GPT Image» و«Flux» ونماذج الصور الأخرى في مساحة عمل واحدة، ثم تسليم نمط المطالبة الفائز إلى المطور.

بالنسبة لمفاتيح واجهة برمجة التطبيقات (API) الرسمية، أو الفوترة، أو السجلات، أو الوصول المؤسسي، أو توجيه Vertex AI، استمر في استخدام منصة مطوري Google. ولإجراء مقارنة أسرع بين العناصر الإبداعية وتقليل عدد علامات التبويب أثناء تطوير المطالبات،, مساحة عمل مولد الصور في GlobalGPT يمكن أن يجعل الأعمال المبكرة أقل تعقيدًا.

الأسئلة الشائعة

هل واجهة برمجة التطبيقات (API) لـ Nano Banana Pro هي نفسها المستخدمة في Gemini 3 Pro Image؟

بالنسبة لأعمال المطورين، نعم. تصف «Google» جهاز Nano Banana Pro بأنه «Gemini 3 Pro Image»، ومعرّف طراز واجهة برمجة التطبيقات (API) هو جيميني 3 -3-برو-صورة.

هل يجب أن أستخدم Nano Banana Pro أم Nano Banana 2؟

استخدم Nano Banana Pro للصور النهائية التي تتطلب تحكماً أكثر دقة، أو نصاً واضحاً، أو مراجع، أو اتساقاً مع العلامة التجارية. استخدم Nano Banana 2 لإنشاء مسودات أسرع وتكرارات أقل تكلفة.

هل يمكنني استدعاء Nano Banana Pro مباشرةً من جافا سكريبت في الواجهة الأمامية؟

لا. احتفظ بمفتاح واجهة برمجة التطبيقات (API) على جانب الخادم، وقم بتوجيه الطلبات عبر نظامك الخلفي، وقم بتطبيق حصص المستخدمين قبل إرسال الطلبات إلى واجهة برمجة التطبيقات Gemini.

هل تحل GlobalGPT محل واجهة برمجة التطبيقات (API) الرسمية من Google؟

يُعد «No. GlobalGPT» أداة مفيدة لإجراء الاختبارات السريعة والمقارنة الإبداعية بين نماذج متعددة، لكن مفاتيح واجهة برمجة التطبيقات (API) الرسمية، والفوترة، وسجلات الأداء، وعناصر التحكم المؤسسية، كلها تندرج ضمن منصة المطورين التابعة لـ Google.

كيف يمكنني تقدير تكاليف واجهة برمجة التطبيقات (API) لـ Nano Banana Pro؟

استخدم صفحة التسعير الحالية لواجهة برمجة التطبيقات (API) Gemini من Google وقم بإجراء تقدير التكلفة حسب النموذج ودقة الإخراج وحجم الصور. ومن الأساليب الشائعة للتحكم في التكاليف البدء في إنشاء المسودات باستخدام النموذج الأقل تكلفة أولاً، ثم استخدام Nano Banana Pro للأصول النهائية المختارة.