AR ▾

API نصي غير خاضع للرقابة لخط الأنابيب الخاص بك

أسعار Nano Banana API: شرح التكلفة لكل رمز

الإجابة المختصرة: هذه الخدمة تحسب $0.15 لكل مليون رمز مدخل و$0.50 لكل مليون رمز مخرج من الرصيد المسبق الدفع دون اشتراك. إنها واجهة برمجة تطبيقات نصية وليست مولد صور، لذا فإن الأسعار أدناه للنص فقط.

تم التحديث

رسم توضيحي متساوي الأبعاد لميزان يزن عملات مقابل تدفقات من الرموز، لتمثيل تسعير API حسب الرمز

نقاط رئيسية

  • تبلغ تكلفة المدخلات $0.15 لكل مليون رمز وتبلغ تكلفة المخرجات $0.50 لكل مليون رمز.
  • اشحن أي مبلغ صحيح من $20 إلى $500، مع +5% من $50، و+10% من $100، و+15% من $200.
  • الطلبات الفاشلة أو المرفوضة لا يتم احتسابها، ولا ينتهي الرصيد.
  • يمكن الحصول على رصيد تجريبي بقيمة $0.50 بنقرة واحدة بعد التسجيل، وهو صالح لمدة 7 أيام.

قائمة الأسعار في جدول واحد

الأشخاص الذين يبحثون عن أسعار واجهة برمجة التطبيقات Nano Banana يقارنون عادةً تكاليف توليد الصور، والتي تُقدّر عادةً لكل صورة. هذا الموقع مختلف. إنه يبيع الوصول إلى نموذج لغة نصي من خلال نقطة نهاية متوافقة مع OpenAI، ويتم احتساب تكلفة النص حسب الرمز. إذا كنت تحتاج إلى صور، فهذا ليس المنتج المناسب، لكنه يناسب بشكل جيد بجانب أداة الصور لكتابة الموجّهات والتسميات التوضيحية والسيناريوهات.

العنصرالسعر أو القاعدة
الرموز المدخلة$0.15 لكل 1M
الرموز المخرجة$0.50 لكل 1M
الاشتراكلا شيء، ادفع حسب الاستخدام
الحد الأدنى للإيداع$20 (مبالغ كاملة تصل إلى $500)
الطلبات الفاشلة أو المرفوضةغير مُحمّل
انتهاء صلاحية الرصيدلا ينتهي أبدًا
تجريبي$0.50، نقرة واحدة، 7 أيام، بدون بطاقة

الأرقام الحالية موجودة في صفحة الأسعار، ويمكنك الحصول على مفتاح API من صفحة مفتاح API.

ما هو الرمز (token) من الناحية المالية

الرمز (token) هو جزء من النص، وغالباً ما يكون كلمة قصيرة أو جزءاً من كلمة أطول. كقاعدة إرشادية تقريبية للغة الإنجليزية، فإن 1,000 رمز (token) تعادل قليلاً أقل من 800 كلمة، على الرغم من أن هذا يختلف حسب النص. يتم احتساب تكلفتك بناءً على عددين في كل استدعاء: الرموز التي ترسلها (الموجّه، بما في ذلك أي رسالة نظام وسجل المحادثة) والرموز التي يكتبها النموذج.

تكاليف المخرجات أعلى من تكاليف المدخلات، بحوالي 3.3 مرة لكل رمز (token) ($0.50 مقسوماً على $0.15). وهذا له نتيجة عملية. الطلب الذي يرسل مستنداً طويلاً ويطالب بإجابة في سطر واحد يكون رخيصاً. الطلب الذي يرسل جملة واحدة ويطالب بقصة طويلة يكلف أكثر لكل كلمة من النص مقارنة بالعكس. عند تخطيط ميزانيتك، قدّر طول المخرجات أولاً.

المعادلة بسيطة:

cost = (input_tokens x 0.15 + output_tokens x 0.50) / 1,000,000

تتضمن كل استجابة كائن استخدام يحتوي على العدادات الدقيقة، ويعرض رأس الاستجابة X-Balance-USD رصيدك المتبقي، بحيث يمكنك التحقق من الحساب مقابل المكالمات الفعلية.

أمثلة محسوبة

هذه الأرقام محسوبة مباشرة من السعرين.

رسالة دردشة

2,000 رمز مدخل و500 رمز مخرجات. المدخل: 2,000 × $0.15 / 1M = $0.0003. المخرجات: 500 × $0.50 / 1M = $0.00025. الإجمالي: $0.00055. يغطي رصيد التجربة بقيمة $0.50 حوالي 909 رسالة من هذا النوع، لأن 0.50 / 0.00055 يساوي 909.

دفعة كتابة موجّه لسير عمل الصور

500 طلب، كل منها يحتوي على 400 رمز مدخل و600 رمز مخرجات. المدخل: 200,000 رمز × $0.15 / 1M = $0.03. المخرجات: 300,000 رمز × $0.50 / 1M = $0.15. الإجمالي: $0.18.

قصة طويلة مع سياق كبير

طلب واحد يحتوي على 6,000 رمز من الملاحظات و1,500 رمز من الرد. المدخل: $0.0009. المخرجات: $0.00075. الإجمالي: $0.00165. تكلفة ألف من هذه الطلبات هي $1.65.

أسوأ حالة لاستدعاء واحد

نافذة السياق هي 100,000 رمز، للموجّه والمكمل معاً. املأ 96,000 بالمدخلات واترك النموذج يكتب 4,000: المدخل 96,000 × $0.15 / 1M = $0.0144 والمخرجات 4,000 × $0.50 / 1M = $0.002، للإجمالي $0.0164. حتى الطلب الذي يستهلك نافذة السياق بالكامل يكلف أقل من سنتين.

حلقة وكيل

يُجري الوكيل 50 استدعاءً، كل منها يعيد إرسال 20,000 رمز من المحفوظات ويكتب 1,000 رمز. المدخلات: 1,000,000 رمز = $0.15. المخرجات: 50,000 رمز = $0.025. المجموع: $0.175. هذه هي الحالة التي تُفاجئ الناس، لأن المحفوظات تُفوتر مرة أخرى في كل استدعاء. احذف الرسائل القديمة أو لخصها للحفاظ على عدد المدخلات منخفضًا.

شحن الرصيد والمكافآت وكيفية الدفع

الرصيد مسبق الدفع. تختار أي مبلغ كامل بالدولار من $20 إلى $500. الشحنات الأكبر تضيف مكافأة فوق ذلك:

شحن الرصيدالمكافأةالرصيد الذي تتلقاه
$20لا شيء$20.00
$50+5%$52.50
$100+10%$110.00
$200+15%$230.00
$500+15%$575.00

الدفع يتم بالعملات المشفرة (USDT على TRC20، USDC على Base). بما أن الرصيد لا ينتهي، فإن الشحن الأكبر هو ببساطة سعر أفضل، بدون موعد نهائي يدفعك للإنفاق. شراء شحن بقيمة $20 بحجم رسالة الدردشة المذكور أعلاه يشتري حوالي 36,000 رسالة.

رصيد التجربة وحدود المعدل

للتجربة أولاً، سجّل حسابك عبر Google أو عبر البريد الإلكتروني وكلمة المرور، ثم اضغط على زر المطالبة في صفحة المفتاح. تتلقى رصيدًا تجريبيًا بقيمة $0.50، لشخص واحد، صالح لمدة 7 أيام، دون الحاجة إلى بطاقة. يسمح المفتاح التجريبي بإجراء 2 طلب متزامن و60 طلب في الدقيقة.

المفتاح الكامل، أي المفتاح الذي يحتوي على رصيد مدفوع، يسمح بـ 8 طلبات متزامنة و300 طلب في الدقيقة. هذه حدود للسرعة، وليس للإنفاق. إذا تجاوزت هذه الحدود، ستحصل على استجابة HTTP 429 مع الكود rate_limited أو concurrency، وإذا كان الحمل الزائد مؤقتاً، ستحصل على استجابة 429 مع Retry-After: 5. بما أن الطلبات الفاشلة لا تُفوتر، فإن 429 لا تكلفك مالاً؛ فهي تعني فقط أنك بحاجة للانتظار.

استخدم التجربة لمحاكاة حركة المرور الحقيقية، وليس لإرسال موجّه بسيط، حتى تخبرك أرقام الاستخدام التي تقيسها بشيء حول الفاتورة.

تقدير فاتورتك الخاصة

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

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.nanobananaapis.com/v1",
    api_key=os.environ["NANOBANANA_KEY"],
)

IN_PRICE, OUT_PRICE = 0.15, 0.50   # dollars per 1M tokens
prompts = ["Write an image prompt for a desert market at noon.", "Write a caption for a paper boat photo."]

total = 0.0
for p in prompts:
    r = client.chat.completions.create(
        model="uncensored",
        messages=[{"role": "user", "content": p}],
        max_tokens=300,
    )
    u = r.usage
    cost = (u.prompt_tokens * IN_PRICE + u.completion_tokens * OUT_PRICE) / 1_000_000
    total += cost
    print(u.prompt_tokens, u.completion_tokens, round(cost, 6))

print("sample total:", round(total, 6))

اضرب المتوسط بعدد المكالمات الشهري المتوقع، ثم أضف هامشاً من 20 إلى 30 في المئة لمحاولات إعادة المحاولة والمخرجات الأطول من المتوقع. اضبط max_tokens إذا كنت تريد سقفًا صارماً لطول المخرجات، على الرغم من أنه اختياري. لمزيد من تفاصيل الإعداد خلف هذا النص البرمجي، راجع صفحة التوثيق.

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

طرق الحفاظ على الفاتورة صغيرة

بما أن الوحدة هي الرمز، فإن معظم التوفير يأتي من إرسال واستقبال عدد أقل منها. هذه التغييرات تساعد تقريباً بهذا الترتيب.

  1. اختصر سجل المحادثة. في الدردشة أو الوكيل، تُفوتر الأدوار القديمة مرة أخرى مع كل استدعاء جديد. احتفظ بآخر بضع أدوار، واستبدل الباقي بملخص قصير.
  2. اختصر رسالة النظام. مجموعة تعليمات مكونة من 1,500 رمز تُرسل 100,000 مرة تساوي 150 مليون رمز مدخل، وهو ما يكلف $22.50 بسعر $0.15 لكل مليون. إذا كان نصفها حشو، فأنت تدفع مقابل الحشو.
  3. اطلب الطول الذي تحتاجه. المخرجات هي الجانب المكلف. قل "جملتان" أو "كائن JSON يحتوي على ثلاثة حقول" بدلاً من السماح للنموذج بالتشعب، واضبط max_tokens كسقف.
  4. ادمج الأسئلة ذات الصلة. طلب واحد يطلب خمسة عناصر قصيرة يكلف عادةً أقل من خمسة طلبات منفصلة تكرر نفس السياق.
  5. لا تُعد المحاولة بشكل أعمى. خطأ 429 مجاني، لكن حلقة إعادة المحاولة بدون تأخير تضيع الوقت فقط. انتظر خمس ثوانٍ ثم حاول مرة أخرى.
  6. اختبر على عيّنة صغيرة. قم بتشغيل 20 طلباً حقيقياً، اقرأ أرقام الاستخدام، ثم قم بتشغيل المجموعة الكاملة.

لا يحتاج أي من هذا إلى أدوات خاصة. كائن الاستخدام في كل استجابة كافٍ لمعرفة أي موجّه هو الأثقل.

أسئلة يجب طرحها قبل مقارنة الأسعار

مقارنة أسعار الرموز (tokens) بين الخدمات تكون عادلة فقط عندما تكون المنتجات متشابهة. قبل وضع رقمين جنباً إلى جنب، تحقق من هذه النقاط، وتحقق من أسعار كل مزود بنفسك بدلاً من الاعتماد على جدول من شخص آخر.

  • نفس نوع المخرجات؟ رموز النص وأسعار الصور لكل صورة ليست وحدات قابلة للمقارنة. هذه الخدمة للنصوص فقط.
  • نفس سلوك الرفض؟ الإجابة المرفوضة أو المفلترة التي لا تزال تدفع ثمنها أغلى من سعر القائمة الذي توحي به. هنا، الطلبات المرفوضة والفاشلة لا تُحسب تكلفة.
  • مسبق الدفع أو اشتراك؟ الرسوم الشهرية هي تكلفة ثابتة سواء استخدمت الخدمة أم لا. رصيد مسبق الدفع لا ينتهي لا يحتوي على مثل هذا الحد الأدنى.
  • ما هي الحدود؟ سعر الرمز الرخيص مع تزامن محدود قد يكلفك في وقت الانتظار. هنا هو 8 طلبات متزامنة و300 في الدقيقة على مفتاح كامل.
  • هل السياق كبير بما فيه الكفاية؟ نافذة مكونة من 100,000 رمز (token) تغطي المستندات الطويلة والدردشات الطويلة في استدعاء واحد.

عندما تبدو أرقامك صحيحة، أنشئ مفتاحاً، أنفِق رصيد التجربة على موجّهاتك الحقيقية، وقارن التكلفة المقاسة لكل مهمة بميزانيتك.

أسئلة وأجوبة

كم تكلفة الـ API لكل رمز (token)؟

تكلفة الرموز المدخلة $0.15 لكل مليون، وتكلفة الرموز المخرجة $0.50 لكل مليون. لا يوجد اشتراك ولا حد إنفاق شهري أدنى.

هل هناك تجربة مجانية؟

يمكن للمستخدمين الجدد المطالبة برصيد تجريلي بقيمة $0.50 بنقرة واحدة في صفحة مفتاح API بعد التسجيل. لا يتطلب بطاقة، صالح لمدة 7 أيام، ومحدود لشخص واحد.

هل ينتهي الرصيد؟

لا. الرصيد المسبق الدفع لا ينتهي، ويمكنك شحن الرصيد بمبلغ صحيح يتراوح بين $20 و $500.

هل السعر محسوب لكل صورة؟

لا. هذه واجهة برمجة التطبيقات (API) للنصوص فقط وتُفوتر حسب الرمز. لا تولد صوراً أو صوتاً أو فيديو.

هل أدفع عند فشل الطلب؟

لا. الطلبات الفاشلة أو المرفوضة لا تُحسب عليها التكلفة.

مفتاحك على بُعد نموذج واحد

أنشئ حساباً، وانسخ المفتاح، ثم غيّر URL الأساسي. هذه هي الإعدادات الكاملة.

احصل على مفتاح API