X402 سعر الشرح

​

الاستنتاجات الأساسية

1 Credit = 0.095215 USDC (أي 95215 atomic USDC، USDC بـ 6 أرقام عشرية)

سعر X402 (USDC) = تكلفة الاعتمادات لهذه المكالمة × 0.095215

​

معايير التسعير

​

العلاقة مع سعر الاعتمادات العادي

​

نوعان من أسعار: exact و upto

• exact (سعر ثابت): يمكن تحديد السعر قبل معالجة الطلب (صور، فيديو، موسيقى، بحث، دفع الطلبات). maxAmountRequired = تكلفة الاعتمادات لهذه المكالمة × 0.095215، أي المبلغ المستحق لهذه المكالمة (يتطابق مع cost.amount في الاستجابة الناجحة).
• upto (قياس الاستخدام بعد): واجهات مثل إكمال الدردشة التي “لا تعرف كم تم استخدامه حتى نهاية الاستجابة”. maxAmountRequired هو حد أقصى (محسوب وفقًا للحد الأقصى المحدد في هذا النموذج: الحد الأقصى من الاعتمادات × 0.095215)، ويتم التسوية فعليًا وفقًا للاستخدام الحقيقي، ولا تتجاوز الحد الأقصى.

​

أسعار الدردشة (إكمال الدردشة)

• الجدول يعرض سعر الوحدة حسب token؛ تكلفة الطلب الواحد = إدخال token × سعر الإدخال + إخراج token × سعر الإخراج.
• الحد الأقصى لـ upto هو المبلغ الأقصى المسموح بتوقيعه في طلب واحد لهذا النموذج؛ ليس هو المبلغ الفعلي المخصوم، حيث أن معظم الطلبات تكون أقل بكثير من الحد الأقصى.
• الحد الأقصى يحدد فقط “أقصى ما يمكن خصمه”، بينما يتم التسوية الفعلية وفقًا لاستخدام token.

​

مثال: تطابق السعر والخصم ( exact )

# 1) طلب غير مدفوع -> 402، الحصول على السعر (لا خصم)
POST /serp/google  ->  402
base/exact maxAmountRequired = 952 atomic = $0.000952 = 0.01 Credit
# 0.01 × 0.095215 = 0.00095215، يتم التقريب لأسفل إلى atomic = 952

# 2) توقيع 952 atomic باستخدام المحفظة كـ PAYMENT-SIGNATURE، إعادة المحاولة
POST /serp/google (PAYMENT-SIGNATURE) -> 200
body.cost = {"amount": 0.000952, "currency": "usdc", "settlement": "authorized"}

​

upto 报价计算（聊天）

Credits = 1e-6 × (0.835733 × prompt_tokens + 3.342933 × completion_tokens)
USDC    = Credits × 0.095215

Credits = 1e-6 × (0.835733 × 500 + 3.342933 × 200) ≈ 0.001086 Credits
报价 USDC ≈ 0.001086 × 0.095215 ≈ $0.0001034

​

其他服务价格（固定价 exact）

• 同一服务的价格随模型、分辨率、时长、动作变化（尤其是视频）。上表是某一组参数下的真实取值，仅供量级参考。
• 这类固定价（exact）接口，该请求 402 响应里的 maxAmountRequired 即该次应付金额（与成功响应的 cost.amount 一致，上节已实测）。
• 每个价格都由 Credits × 0.095215 向下取整到 atomic 单位得到（见上文计价基准），与聊天用的是同一套换算。因浮点表示与取整，个别值可能与朴素乘积相差 1 atomic（$0.000001），一律以 402 返回值为准。

​

订单支付价格

description Ace Data Cloud Credits x 10.0
created price 1.26          # 订单创建价（USD）
settled    1.20 USDC        # 最终签名/结算金额（= 402 amount）
            = 1200000 atomic USDC

​

如何实时获取价格

• 按调用价格：对目标 API 发一次不带 PAYMENT-SIGNATURE（也不带 Authorization）的请求，读取返回的 402 accepts[].maxAmountRequired。这一步不会扣费。对 exact 接口它是最终价格；对 upto 接口（聊天）它是上限，实际按用量结算。
• 聊天每 token 单价：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）。

curl -sS -X POST https://x402.acedata.cloud/midjourney/imagine \
  -H 'Content-Type: application/json' \
  -d '{"prompt": "a cat"}'
# 返回 402，accepts[].maxAmountRequired 即为该次（exact）调用价格

​

小结

• سعر X402 = تكلفة الاعتمادات لهذه المكالمة × 0.095215، وهو نفس سعر الاعتمادات العادية، فقط يتم التسوية باستخدام USDC على السلسلة.
• 0.095215/اعتماد هو أفضل سعر (للكميات الكبيرة) للاعتمادات؛ سعر الاعتمادات عند الشحن بكميات صغيرة أعلى، لذا فإن X402 تعني تلقائيًا الحصول على أفضل سعر.
• المبلغ الموقّع في واجهة exact (صور / فيديوهات / موسيقى / بحث / طلبات) هو المبلغ المستحق؛ المبلغ الموقّع في واجهة upto (دردشة) هو الحد الأقصى، ويتم التسوية حسب الاستخدام الفعلي.
• السعر المعتمد هو ما يتم إرجاعه في maxAmountRequired من 402: exact هو المبلغ المستحق (يتطابق مع cost.amount في الاستجابة الناجحة، وقد تم اختباره بالفعل)؛ upto هو الحد الأقصى، وcost.amount في الاستجابة الناجحة هو المبلغ الحقيقي الذي يتم تسويته حسب الاستخدام (≤ الحد الأقصى).

​

الوثائق ذات الصلة