curl-X POST 'https://pollo.ai/api/platform/v1/generation/google/nano-banana/image'\-H'Content-Type: application/json'\-H'x-api-key: YOUR_API_KEY'\-d'{ "input": { "prompt": "A photorealistic portrait of an astronaut relaxing on a tropical beach, golden hour lighting, 85mm lens", "aspectRatio": "1:1" }}'
يمكنك تضمين webhookUrl اختياريًا لتلقي رد اتصال عند نجاح المهمة أو فشلها.
حقل طلب اختياري
{"input":{"prompt":"A photorealistic portrait of an astronaut relaxing on a tropical beach, golden hour lighting, 85mm lens","aspectRatio":"1:1"},"webhookUrl":"https://example.com/webhooks/pollo"}
يكون Nano Banana مفيدًا عندما تحتاج مهام إنشاء الصور وتحريرها إلى نفس لغة المطالبة. يمكنه إنشاء صور جديدة، أو تعديل الصور المرفوعة، أو دمج عدة مدخلات في مخرج واحد.
باستخدام Nano Banana على Pollo API، يمكن للمطورين إضافة سير عمل تحويل النص إلى صورة، وتحويل الصورة إلى صورة، وتحويل عدة صور إلى صورة لأدوات المبدعين، وأنظمة التجارة، وتطبيقات التصميم، والأتمتة البصرية.
الميزات الرئيسية لـ Nano Banana API
التحرير باللغة الطبيعية
يقبل Nano Banana تعليمات تحرير مكتوبة بلغة عادية، لذلك يمكن للمستخدمين طلب تغييرات على العناصر، والخلفيات، والألوان، والإضاءة، والأسلوب، أو التكوين بدون أدوات الإخفاء.
اتساق الشخصيات
النموذج مناسب لسير العمل الذي يحتاج فيه نفس الشخص، أو التميمة، أو المنتج، أو العنصر إلى أن يبقى واضحًا ويمكن التعرف عليه عبر تعديلات الصور المرتبطة.
دمج عدة صور
يمكن لعدة صور إدخال أن توجه مخرجًا واحدًا، ما يجعله مفيدًا لدمج المواضيع، وإدراج العناصر، ومطابقة المراجع، أو بناء صور مركبة.
التوجيه بالنص والصورة
يمكن أن يبدأ Nano Banana من مطالبة، أو صورة مصدر، أو عدة صور مرجعية، حسب ما إذا كانت المهمة إنشاءً أو تحريرًا أو دمجًا.
التحسين البصري التكراري
يمكن أن تركز التعليمات على تغيير واحد في كل مرة، مما يساعد المستخدمين على ضبط صورة مُنشأة أو مرفوعة عبر خطوات أصغر وأسهل للمراجعة.
نقل الأسلوب وإعادة التنسيق
يمكن للنموذج تطبيق تغييرات أسلوبية مع استخدام صورة المصدر أو المراجع للحفاظ على تفاصيل مهمة للموضوع، أو التخطيط، أو العناصر.
حالات استخدام Nano Banana API
تنويعات مواد الشخصيات: أنشئ نفس الشخصية بملابس جديدة، ووضعيات، ومشاهد، أو مزاجات مختلفة مع الحفاظ على تفاصيل الهوية الأساسية قابلة للتعرف.
تعديلات صور المنتجات: غيّر الخلفيات، والعناصر المساندة، والإضاءة، أو سياق الاستخدام حول صورة منتج دون إعادة بناء المشهد الكامل يدويًا.
تركيبات متعددة المراجع: ادمج شخصًا، أو عنصرًا، أو غرفة، أو مرجع أسلوب في صورة واحدة متماسكة لمعاينات التصميم أو مسودات الحملات.
أدوات تحرير للمبدعين: اسمح للمستخدمين بتعديل الصور الشخصية، والصور المصغرة، والملصقات، والصور الرمزية، والمرئيات الاجتماعية بتعليمات كتابية عادية.
تبديل مشاهد التجارة الإلكترونية: ضع عنصرًا من الكتالوج في مطابخ، أو مكاتب، أو أرفف، أو مساحات خارجية، أو إعدادات أسلوب حياة لاختبار بصري سريع.
اللوحات القصصية وفن المفاهيم: أنشئ لقطات مشاهد متسقة، واستكشافات للعناصر، وتنوعات للبيئات، أو أوراق شخصيات للتخطيط الإبداعي المبكر.
تنويعات بصرية محلية: عدّل الخلفيات، وسياق التغليف، والتفاصيل الموسمية، أو أسلوب التخطيط مع إبقاء الموضوع الرئيسي ثابتًا.
سير عمل صور مؤتمت: ابنِ أنظمة دفعية تطبق تعديلات قابلة للتكرار أو دمج مراجع على مجموعات صور كبيرة.
كيفية استخدام Nano Banana API
احصل على مفتاح API: أنشئ حساب Pollo API وولّد مفتاح API الخاص بك من لوحة تحكم المطور.
اختر النموذج: استدعِ مسار Nano Banana على /generation/google/nano-banana/image.
أضف المدخلات: أرسل prompt و aspectRatio لتحويل النص إلى صورة، أو أضف images لتحرير الصور وسير عمل الصور المتعددة؛ واضبط resolution عند الحاجة.
أنشئ واسترجع: أرسل الطلب، واحفظ taskId المُعاد، ثم استرجع الصورة عندما تكتمل حالة المهمة.
أفضل ممارسات كتابة المطالبات لـ Nano Banana API
اكتب مطالبات Nano Banana كتعليمات تحرير أو تكوين موجزة. حدّد دور صورة المصدر، والتغيير المطلوب، والتفاصيل التي يجب الحفاظ عليها، والأسلوب البصري، واستخدام المخرج.
صيغة مطالبة بسيطة
المصدر أو الموضوع + التغيير المطلوب + التفاصيل المطلوب الحفاظ عليها + دور المرجع + الأسلوب أو الإضاءة + تنسيق المخرج
ما الذي يجب الانتباه إليه
التفاصيل المحفوظة: حدّد ما يجب ألا يتغير، مثل شكل الوجه، أو شعار المنتج، أو هندسة العنصر، أو لون الملابس، أو زاوية الكاميرا.
أدوار المراجع: وضّح مساهمة كل صورة، مثل هوية الشخصية، أو الخلفية، أو إدراج عنصر، أو لوحة الألوان، أو الوضعية، أو أسلوب الخامة.
تعديلات خطوة واحدة: اطلب تغييرًا رئيسيًا واحدًا لكل طلب عندما تكون الدقة مهمة، ثم كرر عبر تعديلات لاحقة.
نطاق التكوين: صف القص، والاتجاه، والتباعد، وتموضع الموضوع قبل إضافة تفاصيل أسلوبية أصغر.
الخامات والإضاءة: في تعديلات المنتجات أو الغرف، حدّد الأسطح، والظلال، والانعكاسات، واتجاه الضوء لتقليل التركيبات غير المتطابقة.
الحذر مع النص: اجعل أي نص داخل الصورة قصيرًا وسهل التحقق، خصوصًا للملصقات، أو اللوحات، أو نماذج التغليف.
أمثلة على المطالبات
تنويع زي شخصية
"استخدم مرجع الشخصية المرفوع. حافظ على نفس الوجه، وشكل الشعر، والنظارات، ونِسَب الجسم، لكن غيّر الزي إلى سترة ميدانية خضراء وحذاء مشي. ضع الشخصية بجانب كشك خريطة مسار تحت إضاءة صباحية ناعمة."
تركيب غرفة مع أثاث
"ادمج صور الكرسي بذراعين وغرفة المعيشة المرفوعة. ضع الكرسي قرب النافذة بمقياس واقعي، وطابق ظلال الغرفة وانعكاسات الأرضية، وحافظ على ملمس قماش الكرسي، وأزل أي أثاث إضافي يحجبه."
إعادة تنسيق لوحة قائمة طعام
"حرّر صورة لوحة قائمة المقهى إلى أسلوب سبورة أكثر نظافة. حافظ على نفس ترتيب العناصر والأسعار، وبسّط الإطار الزخرفي، وحسّن التباين، واجعل اللوحة تبدو مصوّرة في نفس موضع الحائط."
تعديل سياق التغليف
"استخدم صورة كيس الجرانولا المرفوعة. حافظ على شكل الكيس، وتخطيط الملصق، واسم النكهة بدون تغيير. انقله إلى سطح مطبخ مع الشوفان، وفواكه مجففة، ووعاء خزفي قريب، باستخدام ضوء نافذة طبيعي."
تصور مخطط تعليمي
"أنشئ تصورًا مربّعًا لفصل دراسي يوضّح كيف تنتقل مياه الأمطار من مزاريب السقف إلى برميل تخزين ثم إلى نباتات الحديقة. استخدم أجزاء بسيطة مع تسميات، وأسهم واضحة، وألوانًا ودية، ومسافات كافية ليسهل على الطلاب الصغار الفهم."
Nano Banana مقابل Nano Banana 2 مقابل Nano Banana Pro
الإمكانية
Nano Banana
Nano Banana 2
Nano Banana Pro
موضع النموذج
سير عمل Gemini 2.5 Flash قائم على الصور للإنشاء والتحرير
نموذج صور Nano Banana أحدث للأغراض العامة
إنتاج بصري أكثر تعقيدًا وسير عمل كثيف التعليمات
سير العمل الرئيسي
تحويل النص إلى صورة، وتحرير الصور، ودمج عدة صور
إنشاء صور أوسع ومعالجة مراجع
تكوين مفصل، ومواد حساسة للعلامة التجارية، ومطالبات معقدة
التعامل مع المراجع
مفيد لاتساق الموضوع والتعديلات الموجّهة بالصور
أنسب عندما تكون المراجع المتعددة والاتساق أساسيين
أنسب عندما تكون دقة المراجع والتحكم في التخطيط صارمين
أسلوب التكرار
تعديلات قصيرة ومباشرة وطلبات تركيب
تكرار إبداعي عام مع خيارات مخرجات أقوى
تعليمات أكثر تأنّيًا مع متطلبات بصرية أدق
تخطيط المخرجات
يعمل جيدًا مع تعديلات واضحة، ومواضيع ثابتة، وتركيبات بسيطة
مناسب لمهام إنشاء صور أكثر تنوعًا
مناسب للتخطيطات المتحكم بها، والمرئيات المحلية، وتوجيه المواد بدقة
أنظمة مرئية للعلامات التجارية، والحملات، والتحرير، والإنتاج
لماذا تختار Nano Banana API؟
Nano Banana خيار عملي عندما يحتاج المستخدمون إلى نموذج واحد للإنشاء، والتحرير، وتكوين الصور بالاعتماد على المراجع. وهو مفيد خصوصًا للأدوات البصرية المعتمدة على المطالبات.
من خلال Pollo API، يمكن للمطورين تشغيل Nano Banana إلى جانب أكثر من 300 نموذج صور وفيديو، مع واجهة API واحدة، ووثائق واضحة، وبنية تحتية قابلة للتوسع، ودعم بشري.
استخدم Nano Banana على Pollo API عندما يحتاج منتجك إلى تعديلات بلغة طبيعية، واتساق للموضوع، ودمج عدة صور، أو أتمتة صور قابلة للتكرار.
الأسئلة الشائعة حول Nano Banana API
ما هو Nano Banana؟
Nano Banana هو نموذج Gemini 2.5 Flash Image من Google لإنشاء الصور وتحريرها من نص، أو صور مرفوعة، أو مراجع صور متعددة.
ما المدخلات التي يدعمها Nano Banana API على Pollo API؟
يدعم Nano Banana API سير عمل تحويل النص إلى صورة، وتحويل الصورة إلى صورة، وتحويل عدة صور إلى صورة. يمكن للمطورين استخدام المطالبات، أو صورة مصدر، أو عدة صور مرجعية.
هل Nano Banana API مفيد لاتساق الشخصيات؟
نعم. يمكنه المساعدة في إبقاء الشخصية، أو المنتج، أو العنصر قابلًا للتعرف عبر تعديلات الصور المرتبطة عندما تحدد المطالبات بوضوح التفاصيل التي يجب أن تبقى دون تغيير.
هل يمكن لـ Nano Banana دمج عدة صور؟
نعم. يدعم Nano Banana سير عمل متعدد الصور، بحيث يمكن للمطورين بناء أدوات تدمج المواضيع، والعناصر، والغرف، والوضعيات، أو مراجع الأسلوب في مخرج واحد.
هل يدعم Nano Banana API مدخلات الفيديو أو الصوت؟
لا. Nano Banana هو نموذج لإنشاء الصور وتحريرها. ولسير عمل الفيديو، استخدم نموذج فيديو مثل Veo عبر Pollo API.
كيف يختلف Nano Banana عن Nano Banana Pro؟
Nano Banana أفضل للإنشاء المباشر، والتحرير، وتركيبات المراجع. أما Nano Banana Pro فهو أنسب للمطالبات الأكثر تعقيدًا، والتخطيطات الأكثر صرامة، والمواد ذات طابع إنتاجي.
