أصدرت جوجل للتو Nano Banana Pro، الاسم الرمزي الرسمي لـ Gemini 3 Pro Image، وهو نموذج متعدد الوسائط متطور يتفوق في توليد النصوص إلى صور، وتحرير الصور، والتحكم المتقدم في التركيب. يمكن للمطورين الآن الوصول إلى هذه الأداة القوية برمجيًا عبر واجهة برمجة تطبيقات Gemini. غالبًا ما تحدد تفاصيل الإعدادات الصغيرة ما إذا كان تكاملك سينجح أو يفشل بسرعة.
يرشدك هذا الدليل خلال كل خطوة للوصول إلى واجهة برمجة تطبيقات Nano Banana Pro واستخدامها بفعالية.
ما هو Nano Banana Pro ولماذا تستخدم واجهة برمجته؟
بنت Google DeepMind Nano Banana Pro على أساس Gemini 3 Pro. إنه يقدم مخرجات صور بجودة استوديو لم تستطع النماذج السابقة أن تضاهيها. أولاً، يقوم بعرض النصوص داخل الصور بدقة استثنائية — تخيل شعارات مقروءة، أو لافتات متعددة اللغات، أو خطوطًا مزخرفة تتوافق تمامًا مع المشهد. ثانيًا، يدعم ما يصل إلى 14 صورة إدخال للمزج مع الحفاظ على الاتساق عبر ما يصل إلى خمسة مواضيع. بالإضافة إلى ذلك، يتحكم المطورون في زوايا الكاميرا، والإضاءة، وعمق المجال، وتدرج الألوان، وحتى الدقة حتى 4K.
علاوة على ذلك، يرتكز النموذج على بيانات بحث Google في الوقت الفعلي عند تمكين الميزة. وهذا يضمن الدقة الواقعية للمخططات أو الرسوم البيانية أو النماذج الأولية للمنتجات. كل مخرج يحمل علامة مائية SynthID لتتبع الأصل.
يمكنك الوصول إلى Nano Banana Pro عبر واجهة برمجة تطبيقات Gemini القياسية، ولكنك تختار المعرف المحدد للنموذج (gemini-3-pro-image-preview أو خليفته المستقر). يحافظ هذا النهج على توافق التعليمات البرمجية الخاصة بك مع متغيرات Gemini الأخرى مع إطلاق إمكانيات صور على مستوى احترافي.
خطوة بخطوة: الحصول على مفتاح واجهة برمجة تطبيقات Gemini الخاص بك
اتبع هذه الإجراءات للحصول على بيانات الاعتماد:
انتقل إلى Google AI Studio وسجل الدخول باستخدام حسابك على Google.
انقر على زر "الحصول على مفتاح API" في الشريط الجانبي الأيسر.
أنشئ مفتاحًا جديدًا أو استخدم مفتاحًا موجودًا.
بدلاً من ذلك، في Vertex AI:
- افتح لوحة تحكم Vertex AI Studio.
- اختر "الذكاء الاصطناعي التوليدي" ← "حديقة النماذج".
- ابحث عن Nano Banana Pro (المدرج باسم Gemini 3 Pro Image).
- انقر على "تمكين واجهة برمجة التطبيقات" وأنشئ بيانات الاعتماد.
خزّن المفتاح بأمان في متغيرات البيئة. لا تقم أبدًا بتضمينه مباشرة في ملفات المصدر.
استدعاء واجهة برمجة تطبيقات Nano Banana Pro من Google AI Studio (بدء سريع)
غالبًا ما تبدأ في Google AI Studio لإجراء التجارب السريعة. أولاً، قم بزيارة ai.studio/banana-pro. اختر "Nano Banana Pro" من القائمة المنسدلة للنماذج.
ثم، انتقل إلى علامة التبويب "API" لعرض أمثلة curl المعبأة تلقائيًا بمفتاحك.
فيما يلي طلب curl أساسي:
curl https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-image-preview:generateContent \
-H 'Content-Type: application/json' \
-H "x-goog-api-key: YOUR_API_KEY" \
-d '{
"contents": [{
"role": "user",
"parts": [{
"text": "Generate a 4K photorealistic image of a yellow banana floating in space with Earth in the background, add text overlay: \"Nano Banana Pro\""
}]
}],
"generationConfig": {
"responseModal": "IMAGE"
}
}'
تبقى نقطة النهاية هذه كما هي بالنسبة لنماذج Gemini الأخرى — فقط يتغير اسم النموذج.
استخدم حزمة تطوير البرامج (SDK) الرسمية لـ Python لـ Nano Banana Pro
يفضل معظم المطورين مكتبة عميل Python لأنها تتعامل مع عمليات إعادة المحاولة والتدفق وأنواع MIME تلقائيًا. قم بتثبيتها أولاً:
pip install -U google-generativeai
قم بتكوين المكتبة وإنشاء صورة:
import google.generativeai as genai
genai.configure(api_key="YOUR_API_KEY")
model = genai.GenerativeModel('models/gemini-3-pro-image-preview')
response = model.generate_content(
"A futuristic cityscape at golden hour with flying cars and the text 'Welcome to 2042' on a billboard, 4K resolution",
generation_config=genai.types.GenerationConfig(
response_mime_type="image/png"
)
)
response.candidates[0].content.parts[0].inline_data.data # base64 image
احفظ المخرج على النحو التالي:
with open("output.png", "wb") as f:
f.write(response.candidates[0].content.parts[0].inline_data.data)
تقوم حزمة SDK بتجريد التفاصيل منخفضة المستوى، بحيث تركز على هندسة المطالبات.
التعامل مع تحرير الصور ومدخلات الصور المتعددة
يتألق Nano Banana Pro في مهام التحرير. قم بتحميل الصور كجزء من المطالبة. على سبيل المثال:
import PIL.Image
img = PIL.Image.open("reference.jpg")
response = model.generate_content(
[img, "Edit this photo: change daytime to dramatic sunset, add bokeh effect, keep the subject unchanged"]
)
يمكنك دمج صور ونصوص متعددة بسلاسة. يحافظ النموذج على اتساق الموضوع عبر المراجع.
الميزات المتقدمة: التأسيس، إعدادات الأمان، والتحكم
لتمكين تثبيت البحث في Google لإدخال حقائق في الوقت الفعلي:
"systemInstruction": {
"parts": [{"text": "Use search grounding for factual elements"}]
}
ضبط إعدادات الأمان لحظر أو السماح بفئات:
model = genai.GenerativeModel(
'models/gemini-3-pro-image-preview',
safety_settings=[
{"category": "HARM_CATEGORY_DANGEROUS_CONTENT", "threshold": "BLOCK_NONE"}
]
)
تحديد نسبة العرض إلى الارتفاع والجودة:
generation_config=genai.types.GenerationConfig(
candidate_count=1,
temperature=0.7,
extra_params={
"aspect_ratio": "16:9",
"quality": "highest"
}
)
اختبار وتصحيح أخطاء استدعاءات واجهة برمجة تطبيقات Nano Banana Pro باستخدام Apidog
أوامر curl اليدوية تعمل للاختبارات الفردية، لكن Apidog يحوّل سير عملك. قم باستيراد مواصفات Gemini OpenAPI الرسمية إلى Apidog، وسيقوم بإنشاء جميع نقاط النهاية تلقائيًا، بما في ذلك متغيرات Nano Banana Pro.
إليك كيف تستفيد:
- تصور مخططات JSON لطلبات generateContent.
- حفظ البيئات (مفاتيح التطوير/التجهيز/الإنتاج).
- تسلسل الطلبات وتأكيد الاستجابات.
- محاكاة واجهة برمجة التطبيقات محليًا للتطوير دون اتصال بالإنترنت.
- إنشاء كود العميل في أكثر من 20 لغة فورًا.
على سبيل المثال، قم بإنشاء طلب جديد في Apidog، الصق نقطة نهاية Gemini، أضف مفتاح API الخاص بك كرأس، وأرسل حمولات معقدة متعددة الأجزاء مع صور مرفوعة في ثوانٍ. يتحقق Apidog من الحقول المطلوبة قبل حتى أن تضغط على "إرسال"، مما يمنع أخطاء 400 الشائعة.
أفادت العديد من الفرق أن دورات التكرار أسرع بنسبة 50-70% بعد التحول إلى Apidog لاختبار واجهة برمجة تطبيقات Gemini.
نشر Nano Banana Pro على Vertex AI للإنتاج
يتوسع مستخدمو المؤسسات مع Vertex AI. أنشئ نقطة نهاية مخصصة:
- اذهب إلى Vertex AI ← Model Garden.
- انشر "Gemini 3 Pro Image (Nano Banana Pro)".
- قم بتكوين نوع الجهاز والتحجيم التلقائي.
- استدع نقطة نهاية التنبؤ باستخدام Vertex SDK.
يوفر هذا المسار نقاط نهاية خاصة وتسجيلًا وتكاملًا للمراقبة مع Cloud Operations.
التسعير، حدود المعدل، وأفضل الممارسات
تكلفة Nano Banana Pro أعلى من تكلفة النماذج الأخف بسبب متطلبات الحوسبة العالية. تحقق من أحدث الأسعار على صفحة تسعير Gemini API لأنها تتعدل أثناء مرحلة المعاينة.
طبق تراجعًا أسيًا لعمليات إعادة المحاولة. قم بتخزين المطالبات الشائعة مؤقتًا كلما أمكن ذلك. علاوة على ذلك، قم بتجميع الطلبات غير المرتبطة فقط إذا سمحت حالة الاستخدام الخاصة بك بذلك — لا يدعم إنشاء الصور التجميع الحقيقي بعد.
دائما قم بتضمين مطالبات واضحة ومنظمة. ارجع إلى دليل المطالبات الرسمي لـ Nano Banana Pro لزيادة الجودة.
استكشاف المشكلات الشائعة وإصلاحها
ستواجه أخطاء "النموذج غير موجود" إذا استخدمت معرفًا خاطئًا. تأكد من استهداف gemini-3-pro-image-preview خلال مرحلة المعاينة المدفوعة.
بالنسبة لأخطاء المصادقة، أعد إنشاء مفتاحك وتأكد من عدم وجود مسافات زائدة. إذا ظهرت الصور بعلامة مائية بشكل غير متوقع، تذكر أن بعض المستويات فقط تزيل البريق المرئي.
عندما تبدو المخرجات خاضعة للرقابة، اضبط عتبات الأمان بشكل صريح.
الخاتمة
أنت الآن تمتلك كل المعرفة للوصول إلى واجهة برمجة تطبيقات Nano Banana Pro ودمجها بفعالية. ابدأ بـ Google AI Studio للحصول على نتائج فورية، ثم انتقل إلى Python SDK للبرمجة النصية، واستفد من Apidog لتبسيط الاختبار وتصحيح الأخطاء.
يفتح الجمع بين إمكانيات Gemini 3 Pro Image تحت راية Nano Banana Pro آفاقًا جديدة للتصميم الآلي، وأصول التسويق الشخصية، وأدوات تصور البيانات. طبق هذه الخطوات، جرب بجرأة، وشاهد تطبيقاتك تنتج مرئيات تنافس الاستوديوهات الاحترافية.
قم بتنزيل Apidog اليوم وسرّع تطوير Nano Banana Pro الخاص بك — سيصبح الفارق في الإنتاجية واضحًا بعد جلستك الأولى.