البدء مع Nano Banana Pro API

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

إذا كنت تريد النظرة العامة الرسمية، والعروض التوضيحية، وسياق المنتج لـ Nano Banana 2، فابدأ بـ مركز Nano Banana 2.

ما هي Nano Banana Pro API؟

تمنحك Nano Banana Pro API واجهة REST بسيطة لإنشاء صور عالية الجودة. ترسل مطالبة ومراجع اختيارية، وتتلقى مخرجات صور يمكنك تخزينها وتقديمها في تطبيقك. وهي مصممة للفرق التي تحتاج إلى نتائج متسقة، وسير عمل قابل للتكرار، وأنماط تكامل يمكن التنبؤ بها.

متى تستخدم Nano Banana Pro API

استخدم Nano Banana Pro API عندما تريد مرئيات سريعة عند الطلب دون بناء خط أنابيب نموذج داخلي:

• محتوى تسويقي للإعلانات والصفحات المقصودة
• صور المنتجات للكتالوجات وقوائم التجارة الإلكترونية
• مسودات إبداعية للمفاهيم المبكرة ولوحات المزاج

القدرات الأساسية

تم بناء واجهة برمجة التطبيقات حول بعض نقاط القوة الأساسية التي تهم في الإنتاج:

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

البدء السريع لـ Nano Banana Pro API

1. الحصول على الوصول

أنشئ حسابًا في لوحة تحكم EvoLink، ثم قم بإنشاء مفتاح API لمشروعك. احتفظ بالمفتاح في مخزن أسرار آمن ولا تعرضه أبدًا في الكود من جانب العميل.

2. قم بطلبك الأول

إليك مثال cURL بسيط. استبدل العناصر النائبة بقيمك الفعلية.

curl -X POST "API_BASE/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_NAME",
    "prompt": "A beautiful sunset over mountains, digital art style",
    "size": "ASPECT_RATIO",
    "quality": "RESOLUTION_TIER"
  }'

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

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

{
  "created": 1737014400,
  "data": [
    {
      "url": "IMAGE_URL"
    }
  ]
}

المعلمات الأساسية التي يجب أن تعرفها

هذه هي المعلمات التي ستستخدمها كثيرًا عند استدعاء Nano Banana Pro API:

• model: استخدم النموذج الممكن لحسابك. اختر فئة فعالة من حيث التكلفة للمسودات وفئة متميزة للأصول النهائية.
• prompt: نص التعليمات الخاص بك. كن صريحًا بشأن الموضوع والأسلوب والمزاج.
• size: نسبة العرض إلى الارتفاع أو إعداد الحجم المسبق الذي يناسب موضعك (مربع، عمودي، أو أفقي).
• quality: مستوى الدقة الذي تحتاجه للمخرجات النهائية.
• image_urls: صور مرجعية اختيارية إذا كنت تريد الحفاظ على اتساق الموضوع أو الأسلوب.

الوظائف غير المتزامنة وعناوين URL للصور

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

دليل المطالبات (Prompt Playbook)

أسرع طريقة لتحسين النتائج هي استخدام هيكل مطالبات واضح. صيغة بسيطة تعمل بشكل جيد:

الموضوع + السياق + الأسلوب + الإضاءة + التكوين + الجودة

إليك المزيد من نصائح المطالبات العملية:

1. كن محددًا - سمِّ الموضوع وصف التفاصيل الرئيسية.
2. حدد الأسلوب - واقعي، ألوان مائية، سينمائي، تحريري.
3. تحكم في التكوين - لقطة قريبة، لقطة واسعة، من أعلى إلى أسفل، أو متمركز.

أمثلة للمطالبات

مراقبة الجودة والتكرار

تعامل مع الإنشاء كدورة تصميم سريعة. ابدأ بمطالبة واسعة، ثم كرر:

• أضف أو أزل التفاصيل بناءً على المخرجات الأولى.
• ثبت الأسلوب قبل تحسين الموضوع.
• احفظ أفضل المطالبات حتى يتمكن فريقك من إعادة استخدامها لاحقًا.
• استخدم الصور المرجعية عندما يكون الاتساق مهمًا عبر سلسلة.

قائمة التحقق للإنتاج

استخدم قائمة التحقق هذه قبل شحن Nano Banana Pro API في سير عملك:

• تم تخزين مفتاح API في مخزن أسرار آمن من جانب الخادم
• تم توثيق المطالبات الأساسية لحالات الاستخدام الرئيسية الخاصة بك
• تم حفظ صور المخرجات في التخزين الدائم

ملخص

تُعد Nano Banana Pro API طريقة موثوقة لإنشاء مرئيات عالية الجودة بواجهة REST نظيفة. ابدأ بمطالبات واضحة، وكرر بسرعة، ووثق أفضل نتائجك. بالنسبة للفرق التي تشحن بسرعة، فإن هذا يحافظ على تدفق المخرجات الإبداعية دون أدوات ثقيلة.