الخلاصة الأساسية
X402 ليست نظام تسعير مستقلاً. لكل استدعاء API تكلفة أصلية محسوبة بـ Credits، وهي المصدر الوحيد للسعر المشترك بين جميع طرق الفوترة (خصم أرصدة API Token، رصيد الحساب، والدفع على السلسلة عبر X402). يقوم X402 فقط بتحويل تكلفة Credits هذه إلى USDC على السلسلة بسعر صرف ثابت:
1 Credit = 0.095215 USDC (أي 95215 atomic USDC، حيث يحتوي USDC على 6 منازل عشرية)
أي:
أساس التسعير
تُجرى عملية التحويل بشكل موحد من قبل المنصة، وتكون المبالغ متطابقة لجميع الشبكات المدعومة (Base وSolana)؛ وتختلف الشبكات فقط في عقد الأصل وطريقة التوقيع، أما السعر فواحد.
العلاقة بسعر Credits العادي
تبيع المنصة Credits بنظام شرائح «كلما زاد الاستخدام، انخفض سعر الوحدة». عند الفوترة لكل استدعاء، يستخدم X402 دائماً سعر أفضل شريحة:
بعبارة أخرى، يسوّي X402 كل استدعاء بسعر Credits الخاص بأفضل شريحة. يكون سعر الوحدة للمستخدمين الذين يشترون Credits عبر إعادة شحن بمبالغ صغيرة أعلى من X402؛ ولا يتطابق سعر وحدتهم مع X402 إلا لمستخدمي إعادة الشحن بكميات كبيرة.
شكلان للسعر: exact وupto
في استجابة 402 الخاصة بـ X402، تكون maxAmountRequired هي المبلغ الذي يجب عليك توقيعه. وله شكلان:
exact(سعر ثابت): يمكن تحديد السعر قبل معالجة الطلب (الصور، الفيديو، الموسيقى، البحث، دفع الطلبات).maxAmountRequired = تكلفة Credits للاستدعاء × 0.095215، أي المبلغ المستحق لذلك الاستدعاء (وهو متطابق معcost.amountفي استجابة النجاح).upto(قياس الاستخدام لاحقاً): للواجهات مثل إكمال الدردشة التي «لا يُعرف عدد الـ token المستخدمة فيها إلا عند انتهاء الاستجابة». تمثلmaxAmountRequiredحداً أعلى (محسوباً وفق حد الأرصدة المعين لذلك النموذج: الحد الأقصى لـ Credits × 0.095215)، وتتم التسوية الفعلية وفق الاستخدام الحقيقي، من دون تجاوز الحد الأعلى.
exact وupto. ما يلي يتناول الأسعار فقط.
أسعار Chat (إكمال الدردشة)
يستخدم إكمال الدردشة قياسupto: وتتم الفوترة حسب الاستخدام الفعلي لـ prompt / completion token. السعر لكل مليون (1M) token = تكلفة Credits لكل 1M token لذلك النموذج × 0.095215، وهو مطابق تماماً لسعر USD المعروض في دليل النماذج العام للمنصة (/api/v1/models?with_pricing=true).
يوضح الجدول التالي الأسعار الفعلية (المأخوذة من دليل النماذج، والمحسوبة بسعر تحويل X402)، بوحدة USD / 1M token:
ملاحظات:
- يعرض الجدول سعر الوحدة المقاس حسب token؛ تكلفة الطلب الواحد = token الإدخال × سعر وحدة الإدخال + token الإخراج × سعر وحدة الإخراج.
- حد
uptoهو أكبر مبلغ مسموح توقيعه لطلب واحد لذلك النموذج؛ وليس الخصم الفعلي، إذ تكون غالبية الطلبات أقل بكثير من الحد. - يحدد الحد فقط «أقصى مبلغ يمكن خصمه»، بينما تُحسب التسوية الفعلية وفق استخدام token.
مثال: تطابق عرض السعر والخصم (exact)
فيما يلي استدعاء مدفوع حقيقي تم إجراؤه باستخدام X402Client الرسمي إلى serp/google (Base exact). ويوضح تطابق العناصر الثلاثة: عرض سعر 402، ومبلغ التوقيع، وcost المعاد في استجابة النجاح.
cost.amount المُعادة (0.000952 USDC) تمامًا مع عرض سعر 402 ومع Credits × 0.095215. حقل settlement هو حالة تسوية هذه الدفعة (authorized = تم التفويض)؛ تتم معالجة التسوية على السلسلة بواسطة المنصة، وللاطلاع على الآلية راجع خطط الفوترة exact وupto.
حساب عرض سعر upto (المحادثة)
تُقاس المحادثة حسب التوكنات. يُحسب عرض سعر طلب معيّن (وليس الحد الأعلى) بالصيغة التالية (باستخدام gpt-4o-mini كمثال):
upto الأعلى (بالنسبة إلى gpt-4o-mini، 1 Credit = 95215 atomic)، وهذا هو فقط الحد الأقصى الممكن خصمه؛ عرض السعر الفعلي لهذا الطلب (نحو $0.0001 في المثال أعلاه) أقل بكثير من الحد الأعلى، وتتم التسوية وفق استخدام التوكنات. وللاطلاع على آلية التسوية على السلسلة لـ upto، راجع خطط الفوترة exact وupto.
أسعار الخدمات الأخرى (exact بسعر ثابت)
يمكن تحديد سعر واجهات مثل الصور والفيديو والموسيقى والبحث عند الطلب، وتستخدم exact. يبين الجدول التالي الأسعار الفعلية، المأخوذة من maxAmountRequired في استجابة 402 التي تعيدها الواجهات عبر الإنترنت للطلبات غير المدفوعة (لن تترتب أي رسوم على الاستعلام عن عرض السعر):
ملاحظات:
- يتغير سعر الخدمة نفسها وفقًا لـ النموذج والدقة والمدة والحركة (خصوصًا الفيديو). الجدول أعلاه هو قيمة فعلية لمجموعة معيّنة من المعاملات، وهو للرجوع إلى المستوى السعري فقط.
- بالنسبة إلى هذه الواجهات ذات السعر الثابت (
exact)، فإنmaxAmountRequiredفي استجابة 402 الخاصة بهذا الطلب هو المبلغ المستحق لهذه المرة (ويتطابق معcost.amountفي الاستجابة الناجحة، وقد تم اختباره فعليًا في القسم السابق). - يُحتسب كل سعر عبر التقريب إلى الأسفل إلى وحدة atomic من
Credits × 0.095215(راجع أساس التسعير أعلاه)، باستخدام نفس آلية التحويل المستخدمة في المحادثة. بسبب تمثيل الفاصلة العائمة والتقريب، قد تختلف بعض القيم عن حاصل الضرب المباشر بمقدار 1 atomic ($0.000001)، وتُعتمد قيمة 402 المُعادة دائمًا.
سعر دفع الطلب
عند استخدام X402 لدفع طلبات وحدة التحكم (شراء باقات / شحن Credits)، يعتمد السعر على ما يظهر في صفحة الطلب، ويكونamount في 402 هو أساس التوقيع النهائي. تمر مدفوعات الطلبات عبر واجهة API للمنصة وتتطلب رمز حساب، وللتفاصيل راجع دليل دفع الطلبات.
مثال فعلي من دليل دفع الطلبات (شراء 10 Credits):
0.095215/Credit؛ أما دفع الطلبات فيعتمد على تسعير الباقات، ويخضع الفرق بين سعر إنشائه ومبلغ التسوية النهائي إلى دليل دفع الطلبات.
كيفية الحصول على الأسعار في الوقت الفعلي
تتغير الأسعار حسب النموذج والمعاملات، لذا استخدم برنامجًا للحصول عليها في الوقت الفعلي، ولا تُضمّنها بشكل ثابت:- سعر حسب الاستدعاء: أرسل طلبًا واحدًا إلى واجهة API المستهدفة من دون
PAYMENT-SIGNATURE(ومن دونAuthorizationأيضًا)، واقرأaccepts[].maxAmountRequiredالمُعاد في 402. لا تترتب أي رسوم على هذه الخطوة. بالنسبة إلى واجهاتexact، فهو السعر النهائي؛ وبالنسبة إلى واجهاتupto(المحادثة)، فهو الحد الأعلى، وتتم التسوية الفعلية حسب الاستخدام. - سعر المحادثة لكل توكن:
GET https://platform.acedata.cloud/api/v1/models?with_pricing=true&type=chat، اقرأpricing.input_usd/pricing.output_usdلكل نموذج (تم احتسابها بالفعل وفقًا لـcredit_usd_rate). - التحقق من التحويل:
atomic = floor(Credits × 0.095215 × 1e6)،USDC = atomic / 1e6(أيUSDC ≈ Credits × 0.095215).
الخلاصة
- سعر X402 = تكلفة Credits لهذه العملية ×
0.095215، وهو نفس السعر مثل فوترة Credits العادية، لكن تتم التسوية باستخدام USDC على السلسلة. 0.095215/Credit هو سعر وحدة Credits في أفضل شريحة (للكميات الكبيرة) على المنصة؛ سعر وحدة Credits عند الشحن بمبالغ صغيرة أعلى، لذلك يساوي X402 الحصول تلقائيًا على أفضل سعر للوحدة.- مبلغ التوقيع لواجهات
exact(الصور / الفيديو / الموسيقى / البحث / الطلبات) هو المبلغ المستحق لهذه العملية؛ أما واجهاتupto(الدردشة) فيكون توقيعها للحد الأعلى، وتتم التسوية وفقًا للاستخدام الفعلي. - السعر المعتمد هو
maxAmountRequiredالذي تُرجعه 402: فيexactهو المبلغ المستحق (ومتطابق معcost.amountفي الاستجابة الناجحة، وقد تم اختباره فعليًا)؛ وفيuptoهو الحد الأعلى، بينماcost.amountفي الاستجابة الناجحة هو المبلغ الفعلي الذي تمت تسويته حسب الاستخدام (≤ الحد الأعلى).

