Nano Banana Pro API: الأسعار ومثال Python ونقطة النهاية

إذا كنت على وشك دمج Nano Banana Pro في تطبيق، فهناك ثلاثة أسئلة تظهر قبل كتابة أي كود: كم تكلّف الصورة الواحدة، وأي نقطة نهاية تستدعي، وكيف يبدو سكربت Python العامل؟ يجيب هذا المقال عن الأسئلة الثلاثة. الأرقام مأخوذة من صفحة الأسعار الرسمية لشركة Google، والطلبات جاهزة للصق في الطرفية، وتوضح جداول الميزانية ما تكلفه ألف صورة فعلًا بعد احتساب إعادة المحاولات. يصيّر Nano Banana Pro الصور بدقة 1K أو 2K أو 4K، ويقبل حتى 14 صورة مرجعية في كل طلب. الوصول إليه عبر API يستغرق نحو خمس عشرة دقيقة. أما إبقاء الفاتورة متوقعة فيحتاج تفكيرًا أكثر، ولهذا يتركّز معظم المقال هناك.

💡 الإجابة المختصرة: تسرد Google سعر $0.134 لكل صورة 1K أو 2K و**$0.24 لكل صورة 4K**. وضع الدفعات يخفض السعرين إلى النصف. ويُذكر أن Replicate وfal.ai يتقاضيان نحو $0.18 للصورة. تحقّق من الأسعار الحالية قبل أن تعتمد ميزانية، لأن المزوّدين يعدّلونها.

ما هي واجهة API فعلًا

اسم Nano Banana Pro هو الاسم العام. في وثائق Google للمطورين يُسمّى النموذج Gemini 3 Pro Image، والمعرّف الذي تمرره في أمثلة كود Gemini API هو gemini-3-pro-image-preview. تستضيف Replicate النموذج نفسه باسم google/nano-banana-pro. ثلاثة أسماء لعائلة نموذج واحدة، وهذا التباين يربك الجميع تقريبًا في أول يوم عمل.

تكتسب واجهة API قيمتها عندما تُنتَج الصور بواسطة برنامج بدلًا من شخص: متجر يصيّر صورة لنمط الحياة لكل منتج جديد، أو نشرة بريدية تحتاج إلى ترويسة كل صباح، أو تطبيق يتيح للمستخدمين إعادة تنسيق صورهم. أما لعدد قليل من الصور لمرة واحدة، فالمتصفح أسرع ولا يكلّف وقتًا هندسيًا.

نموذج واحد بأسماء متعددة

ما الذي يمكن أن يفعله طلب واحد

يمكن أن يجمع كل طلب بين هذه الضوابط:

• الدقة: إخراج بدقة 1K أو 2K أو 4K.
• الصور المرجعية: حتى 14 صورة تُرسل مع الأمر النصي لتوجيه الأسلوب أو الشخص أو التكوين.
• نسبة العرض إلى الارتفاع: إعدادات جاهزة مثل 1:1 و4:3 و3:2 و16:9 و9:16 و21:9.
• صيغة الإخراج: JPG أو PNG وفق مخطط Replicate.
• مستوى فلتر الأمان: ثلاثة إعدادات، من الصارم إلى المتساهل. بعض الأوامر ما زالت تُحظر حتى في أكثرها تساهلًا.

أسعار Nano Banana Pro API

تختلف الأسعار بين المزوّدين أكثر من أي شيء آخر، لذلك سنعرض الأرقام مصدرًا تلو الآخر.

الأسعار الرسمية من Google

يُحتسب نص الأمر النصي بشكل منفصل بسعر $2.00 لكل مليون توكن إدخال. لذلك يكلّف أمر من 150 توكنًا نحو $0.0003، وهو مبلغ ضئيل مقارنةً بالصورة نفسها. الإنفاق الحقيقي يكون على الصورة الناتجة، والدقة هي أكبر ما تتحكم فيه: صورة 4K تكلّف نحو 79 في المئة أكثر من صورة 2K.

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

💡 ما زال معرّف النموذج يحمل كلمة "preview". يمكن أن تغيّر Google الأسماء والحدود والأسعار في نماذج المعاينة، لذا اقرأ صفحة الأسعار في اليوم الذي تخطط فيه للإطلاق.

وضع الدفعات يقسم الفاتورة إلى النصف

تكلّف مهام الدفعات بالضبط نصف السعر القياسي: $0.067 بدلًا من $0.134 عند 1K أو 2K، و**$0.12** بدلًا من $0.24 عند 4K. الثمن هو السرعة. ترسل ملفًا من الطلبات، فتعالجه Google عندما تتوفر الطاقة، وتجمع النتائج لاحقًا. هذا يناسب الكتالوجات والتحديثات الليلية وأعمال الأرشفة، ولا يناسب زرًا ينتظره عميل.

مثال عملي يوضح الفرق. تصيير 2,000 صورة منتج بدقة 2K يكلّف $268.00 في الفئة القياسية و$134.00 في وضع الدفعات. النموذج نفسه والإخراج نفسه، ووفرت $134.00 مقابل الانتظار.

هوامش Replicate وfal.ai

تُبلغ متتبّعات الأسعار المستقلة عن نحو $0.18 للصورة على كل من Replicate وfal.ai. مقارنةً بسعر Google البالغ $0.134، فهذا أعلى بنحو 34 في المئة للصورة الواحدة. تدفع هذا الفرق مقابل الراحة: لا حاجة إلى مشروع Google Cloud، ورمز واحد لمئات النماذج، وواجهة توقعات موحدة. تحقق من صفحة النموذج على كل منصة قبل وضع الميزانية، فالأرقام الخاصة بـ Google فقط هي المأخوذة مباشرة من صفحة المزوّد الرسمية.

كيف تبدو الميزانيات الشهرية

ثلاثة سيناريوهات واقعية

تعتمد هذه الصفوف على الأسعار المعلنة من Google.

صفّا الاستوديو هما الأكثر دلالة. الطابور الليلي يكلّف نصف المبلغ، فالسؤال الوحيد هو ما إذا كان أحد يحتاج الملصق في هذه اللحظة.

لتسعير مشروعك، اضرب عدد الصور المتوقعة شهريًا في سعر فئتك، ثم اقسم الناتج على نسبة الاحتفاظ بالصور. فالمتجر الذي يتوقع الاحتفاظ بنسبة 4 من كل 5 عمليات توليد، ويحتاج إلى 1,000 صورة صالحة للاستخدام بدقة 2K، يجب أن يرصد ميزانية تكفي 1,250 عملية توليد، أي نحو $167.50 بالسعر القياسي.

إعادة المحاولات تضيف تكلفة خفية

لا أحد يحتفظ بكل عمليات التصيير. إذا احتفظت بأربع صور من كل خمس، فكل صورة محتفظ بها تكلّف $0.134 ÷ 0.8 = $0.1675 عند 2K و**$0.30** عند 4K. معظم إعادات المحاولة تنشأ من أوامر غامضة لا من أوامر محظورة، مما يعني أن أرخص حل هو كتابة أفضل لا ميزانية أكبر. ثلاث عادات تقلل هذا الرقم:

• اختبر عند 1K أولًا. تعود النتائج أسرع، وتعيد تصيير الأفضل فقط عند 4K.
• خزّن الطلبات مؤقتًا. اجعل تجزئة (hash) من الأمر النصي والمعلمات، فلا يُحتسب الطلب المطابق مرتين أبدًا.
• سجّل كل استدعاء. مجموع التكلفة الجاري لكل مشروع يلتقط الحلقة المتكررة الخارجة عن السيطرة قبل أن تلتقطها الفاتورة.

نقطة النهاية، خطوة بخطوة

نقطة نهاية Gemini API من Google

يتبع مسار REST النمط القياسي الذي تعتمده Google:

POST https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-image-preview:generateContent

نسخ الأمر النصي

أثبت هويتك باستخدام بيانات الاعتماد التي تنشئها في Google AI Studio، وتُمرَّر في ترويسة الطلب كما تصف مرجعية Gemini API. يحمل النص الأمر النصي وإعداد الصورة:

{
  "contents": [{"parts": [{"text": "A ceramic mug on a walnut desk at sunrise, 85mm lens, soft window light"}]}],
  "generationConfig": {
    "responseModalities": ["TEXT", "IMAGE"],
    "imageConfig": {"aspectRatio": "16:9", "imageSize": "2K"}
  }
}

نسخ الأمر النصي

تصل الاستجابة كنص بترميز base64 داخل جزء الصورة، لذا تفكّ ترميزه قبل كتابة الملف. وتعرض وثائق Google الحالية أيضًا استدعاءً أحدث بنمط interactions يحذف لاحقة "preview" من اسم النموذج. تغيّرت أسماء هذه العائلة من قبل، لذا تأكد من السلسلة الدقيقة في الوثائق قبل النشر.

نقطة REST في Replicate

يستخدم Replicate مسار توقعات (predictions) لكل نموذج:

curl -s -X POST \
  -H "Authorization: Bearer $REPLICATE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Prefer: wait" \
  -d '{"input": {"prompt": "A ceramic mug on a walnut desk at sunrise, 85mm lens, soft window light", "aspect_ratio": "16:9", "resolution": "2K", "output_format": "jpg"}}' \
  https://api.replicate.com/v1/models/google/nano-banana-pro/predictions

نسخ الأمر النصي

ترويسة Prefer: wait تُبقي الاتصال مفتوحًا لتلقي إجابة متزامنة. من دونها تتلقى كائن توقع وتستعلم العنوان الموجود في urls.get حتى تصبح الحالة succeeded. يحمل الحقل output في التوقع المكتمل رابط الصورة. نزّل الملف واحفظه بنفسك بدلًا من الاكتفاء بالرابط.

مثال Python يعمل

نسخة Gemini SDK

ثبّت الحزم باستخدام pip install google-genai pillow، ثم شغّل:

from google import genai
from google.genai import types

client = genai.Client()  # reads your Gemini credential from the environment

response = client.models.generate_content(
    model="gemini-3-pro-image-preview",
    contents="A ceramic mug on a walnut desk at sunrise, 85mm lens, soft window light",
    config=types.GenerateContentConfig(
        response_modalities=["TEXT", "IMAGE"],
        image_config=types.ImageConfig(aspect_ratio="16:9", image_size="2K"),
    ),
)

for part in response.parts:
    if part.inline_data is not None:
        part.as_image().save("mug.png")
    elif part.text:
        print(part.text)

نسخ الأمر النصي

تطلب وثائق Google حرف K كبيرًا في image_size، لذا اكتب "2K" لا "2k". الحلقة مهمة أيضًا: قد يعيد النموذج نصًا إلى جانب الصورة، والأمر المحظور يعيد نصًا دون أي صورة.

نسخة عميل Replicate

import replicate

output = replicate.run(
    "google/nano-banana-pro",
    input={
        "prompt": "A ceramic mug on a walnut desk at sunrise, 85mm lens, soft window light",
        "aspect_ratio": "16:9",
        "resolution": "2K",
        "output_format": "jpg",
        "safety_filter_level": "block_only_high",
    },
)

with open("mug.jpg", "wb") as f:
    f.write(output.read())

نسخ الأمر النصي

ثبّتها باستخدام pip install replicate واضبط REPLICATE_API_TOKEN في بيئتك. لتعديل صورة موجودة، أضف image_input مع قائمة روابط عامة لصور (حتى 14) وصف التغيير في الأمر النصي:

input={
    "prompt": "Place the mug from the first image on the desk from the second image",
    "image_input": [
        "https://example.com/mug.jpg",
        "https://example.com/desk.jpg",
    ],
    "aspect_ratio": "match_input_image",
}

نسخ الأمر النصي

ثلاثة تفاصيل إنتاجية توفر وقت التصحيح:

• المهلات الزمنية: تسرد صفحة أمثلة PicassoIA لهذا النموذج نحو 18 ثانية لتصيير 1K واحد و113 ثانية لتصيير 2K واحد. اضبط مهلات العميل على ثلاث دقائق على الأقل.
• حدود المعدل: أعد المحاولة عند استجابات HTTP 429 باستخدام التراجع الأُسّي (exponential backoff)، وضع حدًا أقصى لعدد المحاولات.
• تتبّع التكلفة: أضف السعر المعلن بعد كل استدعاء ناجح.

PRICE = {"1K": 0.134, "2K": 0.134, "4K": 0.24}

def add_cost(total: float, resolution: str) -> float:
    return round(total + PRICE[resolution], 4)

نسخ الأمر النصي

استخدم Nano Banana Pro على PicassoIA

لا تحتاج كل مهمة إلى كود. تشغّل صفحة Nano Banana Pro على PicassoIA النموذج في المتصفح، وتصف الصفحة أنه متاح للتجربة مجانًا دون ترميز. كما تشغّل PicassoIA واجهة مطورين على api.picassoia.com/v1، لكنها تخدم نماذج داخلية مثل PicassoIA Image وPicassoIA Image Editor Pro، لا Nano Banana Pro. أما Nano Banana Pro عبر الكود فاستخدم Google أو Replicate كما هو موضح أعلاه.

1. افتح صفحة النموذج واكتب الأمر النصي بلغة واضحة: الشخص، والعدسة، والإضاءة، والمزاج.
2. اختر نسبة العرض إلى الارتفاع. استخدم 16:9 للبانرات، و9:16 للقصص، و1:1 للصور الرمزية.
3. حدد الدقة. 2K هي الافتراضية، و4K مناسبة للطباعة.
4. أضف صورًا مرجعية إن كانت لديك، حتى 14.
5. اختر JPG أو PNG واضبط مستوى فلتر الأمان.
6. ولّد الصورة، ثم غيّر بضع كلمات وقارن التنويعات قبل أن تحتفظ بواحدة.

الإعدادات المهمة

💡 مع نسبة العرض الافتراضية، يتبع الناتج أول صورة مرجعية لديك. اضبط النسبة يدويًا عندما تولّد من النص وحده.

الصور المرجعية دون كود

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

ليس المزيد من المراجع دائمًا نتائج أفضل. ابدأ بصورتين أو ثلاث، وسمِّ دور كل واحدة في الأمر النصي (مثل "استخدم الإضاءة من الصورة الثانية")، وحافظ على اتساق الإضاءة عبر المجموعة. أضف المزيد فقط عندما ينحرف الناتج عن المظهر الذي تريده.

متى يفوز نموذج أرخص

Nano Banana Pro هو الخيار الصحيح للإخراج بدقة 4K والعمل الكثيف بالمراجع. نادرًا ما تحتاج المسودات والصور المصغّرة والحشو بكميات كبيرة إلى هذا السقف.

مقارنة سريعة للنماذج

صياغة الأوامر بواسطة نموذج لغوي

الملخص القصير ينتج صورة غامضة، والصورة الغامضة تنتج إعادة محاولة. اطلب من نموذج لغوي توسيع الملخص أولًا. Gemini 3.5 Flash سريع بما يكفي للعمل الكثيف، وClaude Sonnet 5 يتعامل جيدًا مع التعليمات الطويلة. تعليمة مفيدة تبدو هكذا:

أعد كتابة هذا الملخص كأمر صورة واحد من 60 كلمة. سمِّ الشخص، وزاوية الكاميرا، والعدسة، واتجاه الضوء، وملمس سطح واحد. لا نص داخل الصورة.

شغّل الأمر الموسّع بدقة 1K، واحتفظ بالفائز، ثم ادفع ثمن 4K عندئذ فقط. هذه العادة الواحدة، نموذج لغوي للأمر ومستوى رخيص للاختبار، تزيل معظم عمليات التصيير الضائعة في الشهر النموذجي.

أنشئ صورتك الأولى اليوم

لديك الآن الأشياء الثلاثة التي تخفيها صفحات API: الأسعار ونقاط النهاية وسكربت يعمل. أسرع طريقة لمعرفة إن كان Nano Banana Pro يناسب مشروعك هي قضاء عشر دقائق معه قبل إنفاق أي سنت. افتح صفحة Nano Banana Pro على Picasso IA، والصق أمرًا من هذا المقال، وبدّل بين 1K و4K، وأضف صورة مرجعية أو اثنتين. ثم خذ الأمر الفائز إلى سكربت Python الخاص بك. جرّب الإعدادات، وقارن النتائج جنبًا إلى جنب، ودع جدول الميزانية يقرر أين يذهب الكود.