X402 價格說明

​

核心結論

1 Credit = 0.095215 USDC（即 95215 atomic USDC，USDC 為 6 位小數）

X402 價格 (USDC) = 該次調用的 Credits 成本 × 0.095215

​

計價基準

​

和普通 Credits 單價的關係

​

兩種價格形態：exact 與 upto

• exact（固定價）：請求處理前價格就能確定（圖片、視頻、音樂、搜索、訂單支付）。maxAmountRequired = 該調用 Credits 成本 × 0.095215，即該次調用的應付金額（與成功響應裡的 cost.amount 一致）。
• upto（用量後置計量）：聊天補全這類「響應結束才知道用了多少 token」的接口。maxAmountRequired 是一個上限（按該模型設定的上限額度換算：上限 Credits × 0.095215），實際按真實用量結算，且不超過上限。

​

Chat（聊天補全）價格

• 表中為按 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 價格 = 該次調用的 Credits 成本 × 0.095215，和普通 Credits 計費是同一個價格，只是用鏈上 USDC 結算。
• 0.095215/Credit 是平台最優檔（大額）Credits 單價；小額充值買 Credits 單價更高，所以 X402 等於自動拿到最優單價。
• exact 接口（圖片 / 視頻 / 音樂 / 搜索 / 訂單）簽名金額即該次應付金額；upto 接口（聊天）簽名的是上限，按真實用量結算。
• 權威價格以 402 返回的 maxAmountRequired 為準：exact 是應付金額（與成功響應的 cost.amount 一致，已實測）；upto 是上限，成功響應的 cost.amount 才是按用量結算的真實金額（≤ 上限）。

​

相關文檔