دليل تسعير وتقدير تكاليف Nano Banana Pro API

يمكن لنموذج صور يبدو رخيصاً أن يرسل إليك فاتورة مفاجئة إذا أسأت قراءة وحدة الفوترة الخاصة به. وتعد أسعار Nano Banana Pro API على TokenLab مثالاً جيداً على ذلك. حيث تدرج nano-banana-pro سعراً لكل صورة، بينما تدرج النماذج المجاورة لها التي تحمل اسم Gemini، وهي gemini-3-pro-image و gemini-3.1-flash-image، أسعاراً لكل token. يضع هذا الدليل هذه المدخلات جنباً إلى جنب، ويعمل على تقدير دفعة (batch)، ويوضح شكلي الطلب اللذين سترسلهما فعلياً. كما يشرح كيفية التأكد من الرسوم النهائية. كل رقم مأخوذ من واجهة برمجة تطبيقات النماذج المباشرة ووثائق TokenLab، كما تمت ملاحظته في 2026-10-03.

أبرز النقاط

• تدرج nano-banana-pro سعراً أساسياً قدره 0.067 دولار أمريكي لكل صورة، مع نطاق مدرج يتراوح بين 0.067 إلى 0.12 عبر مدخلات الأسعار الخاصة بها (واجهة برمجة تطبيقات النموذج المباشرة، تمت ملاحظتها في 2026-10-03).
• تدرج nano-banana-2 سعراً قدره 0.0335 لكل صورة، وتدرج nano-banana-2-lite سعراً قدره 0.0168، لذا فإن السعر الأساسي لـ Pro يعادل ضعف سعر النموذج الأول وأربعة أضعاف سعر الثاني.
• يتم تسعير gemini-3-pro-image و gemini-3.1-flash-image بناءً على الـ token، لذا لا تنطبق عليهما صيغة الميزانية لكل صورة.
• تنتقل طلبات الصور المرجعية (reference-image) الخاصة بـ Nano Banana إلى /v1/images/generations مع operation: "image-to-image"، وليس إلى /v1/images/edits.
• توجد الرسوم النهائية في Usage وفي billing_transaction_id، وليس في تقديراتك.
• لا يحتوي هذا الدليل على بيانات قياس أداء (benchmark)، لذا فهو لا يدعي أن مخرجات Pro تبدو أفضل من المعرفات (IDs) الأرخص.

نظرة سريعة على أسعار Nano Banana Pro API

لقد قرأنا إدخالات الكتالوج لخمسة نماذج صور ووضعناها في جدول واحد. يقول كتلة السعر لـ nano-banana-pro "يحتوي على إدخالات أسعار إضافية"، ولم نجد تفصيلاً مفصلاً لكل دقة في الأدلة. لذا يوضح الجدول ما هو مدرج فقط لا غير.

معرف النموذج (Model ID)	وحدة التسعير	إدخالات الأسعار المدرجة (بالدولار الأمريكي)	المصدر	تاريخ الملاحظة
nano-banana-pro	per_image	السعر الأساسي per_request 0.067؛ ملخص النطاق 0.067 إلى 0.12؛ إدخال مخرجات النص native-gemini-text-output-20260723 (per_token): المدخلات 1، المخرجات 6	واجهة برمجة تطبيقات النموذج المباشرة	2026-10-03 (تم تحديث الأسعار في 2026-10-02T16:53:30.068Z)
nano-banana-2	per_image	السعر الأساسي per_request 0.0335؛ النطاق 0.0225 إلى 0.0755؛ إدخال مخرجات النص (per_token): المدخلات 0.25، المخرجات 1.5	واجهة برمجة تطبيقات النموذج المباشرة	2026-10-03
nano-banana-2-lite	per_image	السعر الأساسي per_request 0.0168؛ قيمة نطاق واحدة 0.0168؛ الإدخال google-1k (1k، من نص إلى صورة ومن صورة إلى صورة): 0.0168	واجهة برمجة تطبيقات النموذج المباشرة	2026-10-03
gemini-3-pro-image	per_token	المدخلات 1 والمخرجات 6 لكل 1 مليون لمخرجات النص؛ إدخال مخرجات الصور: 60	واجهة برمجة تطبيقات النموذج المباشرة	2026-10-03
gemini-3.1-flash-image	per_token	المدخلات 0.25 والمخرجات 1.5 لكل 1 مليون لمخرجات النص؛ إدخال مخرجات الصور: 30	واجهة برمجة تطبيقات النموذج المباشرة	2026-10-03

هناك تفصيلان في الجدول يسهل تفويتهما.

• يقول الكتالوج إن مخرجات صور nano-banana-pro "تحتفظ بمستويات الدقة الحالية لكل صورة". ولا يذكر أي مستوى يرتبط بـ 0.067 وأي منها يرتبط بـ 0.12. اقرأ GET /v1/models/nano-banana-pro/pricing لمعرفة هذا التعيين قبل تخصيص ميزانية، كما ينصح دليل الفوترة.
• إدخال مخرجات النص في nano-banana-pro مسعر بالـ token. تعامل معه كبند منفصل عن الرسوم لكل صورة، وتحقق مما إذا كانت طلباتك تنتج مخرجات نصية.

تحذر وثائق الفوترة أيضاً من كتابة جداول الأسعار المنسوخة برمجياً (hard-coding). جدولنا عبارة عن لقطة مؤرخة، ويجب أن يقرأ كودك السعر عندما يحتاج إليه.

العمل على تقدير دفعة (batch)

تخيل فريقاً يقوم بإنشاء 200 صورة منتج في عملية واحدة. قمنا بضرب الأسعار المدرجة لرؤية التفاوت. هذه تقديرات وليست عروض أسعار.

النموذج	العملية الحسابية	التقدير (بالدولار الأمريكي)
nano-banana-pro، السعر الأساسي	200 × 0.067	13.40
nano-banana-pro، أعلى النطاق المدرج	200 × 0.12	24.00
nano-banana-2، السعر الأساسي	200 × 0.0335	6.70
nano-banana-2، أعلى النطاق المدرج	200 × 0.0755	15.10
nano-banana-2-lite	200 × 0.0168	3.36

الآن أضف إعادة الإنشاء. إذا رفض الفريق 20% من النتائج وأعاد تنفيذها على nano-banana-pro بالسعر الأساسي، فهذا يعني 40 صورة إضافية. يصبح المجموع 240 × 0.067 = 16.08، وهو تقدير أيضاً. تقول وثائق العمليات غير المتزامنة (async) إن المهمة الفاشلة لا يتم تحصيل رسوم عليها، ولكن إعادة محاولة إنشاء فاشلة تنشئ مهمة جديدة وقد تنشئ رسوماً جديدة. تتم فوترة عمليات إعادة المحاولة التي تنجح مثل أي صورة مكتملة أخرى.

التفاوت بين 13.40 و 24.00 هو عدم اليقين الحقيقي. وهو ناتج عن إدخالات الأسعار التي لا يمكننا ربطها بالدقة من الأدلة وحدها. قم بتشغيل دفعة اختبار صغيرة بدقة الهدف الخاصة بك، ثم قارن سجل Usage بالحسابات أعلاه.

متى تختار nano-banana-pro بدلاً من المعرفات الأرخص

الاختلافات الموثقة أقل مما قد تأمل. إليك ما تدعمه الوثائق والكتالوج.

• المحددات. يدعم كل من nano-banana-pro و nano-banana-2 كلاً من aspect_ratio و resolution (1k، 2k، 4k) للتحويل من نص إلى صورة ومن صورة إلى صورة. بالنسبة لـ nano-banana-2-lite، فإن إدخال السعر الوحيد الذي وجدناه هو عند 1k، وتنسيقات الطلبات المقبولة الخاصة به "غير مدرجة" في الكتالوج. إذا كنت بحاجة إلى مخرجات 2k أو 4k، فلم نجد أي دعم موثق لها في Lite.
• التسليم. تدرج nano-banana-pro كلاً من TokenLab Verified و Official كخيارات متاحة لكلتا العمليتين. تدرج gemini-3-pro-image خيار Verified فقط.
• السعر. السعر الأساسي لـ Pro هو 0.067، مقابل 0.0335 و 0.0168. لا يقدم الكتالوج أي سبب أبعد من ذلك لهذا الفارق.
• دورة الحياة. تظهر النماذج الثلاثة مرحلة دورة حياة نشطة بدون نموذج بديل وبدون تاريخ إيقاف. ذكر المقال المصدر أن nano-banana و nano-banana-edit قد تم إيقافهما، لكننا لم نجد دليلاً على ذلك، لذا حذفنا هذا الادعاء. تحقق من صفحة النموذج قبل الاعتماد على أي من المعرفين.

ما لم نقم بقياس أدائه يهم أكثر من القائمة أعلاه. ليس لدينا بيانات حول جودة الصورة، أو الالتزام بالمطالبة (prompt-adherence)، أو عرض النص، أو زمن الاستجابة لأي من هذه النماذج. لذا لا يمكننا القول إن Pro تبدو أفضل من nano-banana-2. النهج السليم هو عرض نفس الـ 20 مطالبة على كل مرشح ومقارنة المخرجات بالعين. ثم قارن التكلفة لكل صورة مقبولة في Usage. هذه هي الطريقة التي تقترحها وثائق الفوترة أيضاً: أقل سعر مدرج ليس دائماً هو أقل تكلفة لكل مهمة مكتملة.

طلب إنشاء واحد وطلب تعديل واحد

كلا الاستدعاءين أدناه يستخدمان POST /v1/images/generations. يقول دليل إنشاء الصور إن إنشاء المراجع بأسلوب Nano Banana لا ينتمي إلى /v1/images/edits. أرسل دائماً model بشكل صريح، لأن واجهات برمجة تطبيقات الصور ليس لديها نموذج افتراضي.

التحويل من نص إلى صورة، باستخدام الحقول التي يسردها مرجع إنشاء الصور لعائلات صور Google:

curl -X POST "https://api.tokenlab.sh/v1/images/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "prompt": "A cinematic portrait of a white cat sitting on a rainy windowsill",
    "aspect_ratio": "16:9",
    "resolution": "2k"
  }'

التعديل، أي إنشاء صورة مرجعية مع operation: "image-to-image" و image_urls:

curl -X POST "https://api.tokenlab.sh/v1/images/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "operation": "image-to-image",
    "prompt": "Keep the product shape, change the background to a bright studio setup",
    "image_urls": ["https://example.com/input/product.png"],
    "aspect_ratio": "1:1",
    "resolution": "2k"
  }'

بعض القواعد من الوثائق، كما تمت ملاحظتها في 2026-10-03:

• يجب أن تكون عناوين URL المرجعية عامة عبر http أو https. تجنب عناوين URL للشبكات الخاصة، وبيانات الاعتماد المضمنة، والأجزاء، وعناوين URL الموقعة التي قد تنتهي صلاحيتها قبل بدء المعالجة.
• بالنسبة لصورة مصدر خاصة أو محمية برأس (header)، أرسل ملف image متعدد الأجزاء بدلاً من image_urls.
• لا يتم قبول images[] و file_id في نقطة النهاية هذه.
• اضبط مهلة عميل HTTP الخاص بك على 120 ثانية على الأقل. إذا كانت الاستجابة تحمل status: "pending"، أو task_id، أو poll_url، فاتبع poll_url بدلاً من الانتظار.
• قم بالاستطلاع (poll) باستخدام GET /v1/tasks/{id}. يقترح دليل الوظائف غير المتزامنة التحقق كل 5 إلى 10 ثوانٍ، والتوقف عند completed أو failed.

احفظ عنوان URL المرجع، ومعرف المهمة، والنموذج، ومعرف الوظيفة الخاص بك. قد يتم الاحتفاظ بعناوين URL للنتائج المؤهلة كنسخ وسائط لمدة 30 يوماً، ويعرض media_retention.items حالة كل عنصر و expires_at.

التأكد من الرسوم النهائية

التقدير هو مجرد خطة. تصف وثائق الفوترة أين يظهر الرقم الحقيقي.

1. الحجز والإفراج. تحجز بعض المهام غير المتزامنة التكلفة المقدرة عند الإنشاء. يتم تحصيل رسوم المهمة المكتملة مرة واحدة. تقوم المهمة الفاشلة بالإفراج عن المبلغ المعلق أو استرداده.
2. قراءة معرف المعاملة. تتضمن الاستجابات غير المتدفقة (non-streaming) billing_transaction_id عندما تنتهي الفوترة قبل إرسال الاستجابة. قد تظهر نفس القيمة في رأس X-Billing-Transaction-ID. تتضمن المهام غير المتزامنة ذلك بعد الاكتمال.
3. افتح Usage. تعرض صفحة Usage السجل حسب النموذج وتفاصيل التكلفة. قارنها بتقديرك.
4. احتفظ بالمعرفات معاً. قم بتخزين request_id، و task_id، و billing_transaction_id، ومعرف الوظيفة الخاص بك في سجل واحد.
5. التصعيد بالأدلة. إذا لم تظهر صفحة Usage أي رسوم نهائية أو مبلغ مفرج عنه بعد انتهاء المهمة، أرسل بريداً إلكترونياً إلى support@tokenlab.sh مع معرف الطلب (Request ID) ومعرف المهمة.

يؤثر خيار التسليم أيضاً على السعر. يستخدم Verified أسعار TokenLab العامة، ويستخدم Official طبقة سعر بناءً على السعر العام للجهة المصنعة، ويحاول Auto استخدام Verified أولاً. أنت تدفع مقابل الخيار الذي يكمل الطلب، لذا لاحظ أياً منها خدم دفعة الاختبار الخاصة بك.

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

هل تتم فوترة nano-banana-pro لكل صورة أم لكل token؟

الإدخال الأساسي هو لكل صورة: per_request 0.067 مع وحدة per_image. يدرج الكتالوج أيضاً إدخال مخرجات النص مسعراً لكل token، عند المدخلات 1 والمخرجات 6. تحقق من نقطة نهاية التسعير لمعرفة أي إدخال تطلقه أنواع طلباتك.

هل يمكنني إرسال تعديلات nano-banana-pro إلى /v1/images/edits؟

لا. تقول الوثائق إن طلبات الصور المرجعية لـ Nano Banana، بما في ذلك nano-banana-pro، تنتمي إلى /v1/images/generations مع operation: "image-to-image" و image_urls. تم توثيق نقطة نهاية التعديلات لنماذج مثل gpt-image-2.

هل يتم تحصيل رسوم على مهمة صورة فاشلة؟

يقول دليل الفوترة إن المهمة الفاشلة لا يتم تحصيل رسوم عليها، ويتم الإفراج عن أي مبلغ محجوز أو استرداده. تنشئ إعادة المحاولة مهمة جديدة وقد تنشئ رسوماً جديدة. قم بإلغاء التكرار (deduplicate) باستخدام معرف الوظيفة الخاص بك حتى لا تؤدي المهلة الزمنية إلى إنشاء طلب إنشاء ثانٍ.

هل تغير الدقة التي أختارها سعر nano-banana-pro؟

يقول الكتالوج إن مخرجات الصور تحتفظ بمستويات الدقة لكل صورة، ويتراوح نطاقها المدرج من 0.067 إلى 0.12. لا تربط الأدلة المستويات بـ 1k، أو 2k، أو 4k. اقرأ GET /v1/models/nano-banana-pro/pricing وتأكد من خلال طلب اختبار في Usage.

أي حقل يثبت ما تم تحصيله مني فعلياً؟

استخدم billing_transaction_id، أو رأس X-Billing-Transaction-ID، وقم بمطابقته مع السجل في Usage. يمكن أن ينتهي البث (streaming) قبل انتهاء الفوترة، لذا فإن Usage هو الخيار الاحتياطي عند غياب الرأس.

لمقارنة هذه المعرفات مع نماذج صور أخرى بناءً على مطالباتك الخاصة، ابدأ من دليل النماذج.