核心結論
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
X402 的 402 回應裡,maxAmountRequired 就是你要簽名的金額。它有兩種形態:
exact(固定價):請求處理前價格就能確定(圖片、影片、音樂、搜尋、訂單支付)。maxAmountRequired = 該呼叫 Credits 成本 × 0.095215,即該次呼叫的應付金額(與成功回應裡的cost.amount一致)。upto(用量後置計量):聊天補全這類「回應結束才知道用了多少 token」的介面。maxAmountRequired是一個上限(按該模型設定的上限額度換算:上限 Credits × 0.095215),實際按真實用量結算,且不超過上限。
exact 與 upto 計費方案。下面只講價格。
Chat(聊天補全)價格
聊天補全是upto 計量:按 prompt / completion token 實際用量計費。每百萬(1M)token 的價格 = 該模型每 1M token 的 Credits 成本 × 0.095215,與平台公開模型目錄(/api/v1/models?with_pricing=true)展示的 USD 單價完全一致。
下表為真實價格(取自模型目錄,按 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 報價計算(聊天)
聊天按 token 計量。某次請求的報價(不是上限)按下式計算(以 gpt-4o-mini 為例):
upto 上限(gpt-4o-mini 為 1 Credit = 95215 atomic)簽名,這只是最多可能扣多少;該次請求的真實報價(上例約 $0.0001)遠低於上限,按 token 用量結算。upto 的鏈上結算機制見 exact 與 upto 計費方案。
其他服務價格(固定價 exact)
圖片、影片、音樂、搜尋這類介面在請求時價格即可確定,使用 exact。下表為真實價格,取自線上介面對未支付請求返回的 402 maxAmountRequired(查詢報價不會產生扣費):
說明:
- 同一服務的價格隨模型、解析度、時長、動作變化(尤其是影片)。上表是某一組參數下的真實取值,僅供量級參考。
- 這類固定價(
exact)介面,該請求 402 回應裡的maxAmountRequired即該次應付金額(與成功回應的cost.amount一致,上節已實測)。 - 每個價格都由
Credits × 0.095215向下取整到 atomic 單位得到(見上文計價基準),與聊天用的是同一套換算。因浮點表示與取整,個別值可能與樸素乘積相差 1 atomic($0.000001),一律以 402 返回值為準。
訂單支付價格
用 X402 支付控制台訂單(購買套餐 / 儲值 Credits)時,價格以訂單頁面顯示為準,402 的amount 為最終簽名依據。訂單支付走平台 API、需要帳戶權杖,詳見 訂單支付教學。
訂單支付教學中的一個真實例子(購買 10 Credits):
0.095215/Credit 的最優檔單價;訂單支付按套餐定價,其建立價與最終結算金額的差異以 訂單支付教學 為準。
如何即時取得價格
價格隨模型和參數變化,請用程式即時取得,不要硬編碼:- 按呼叫價格:對目標 API 發一次不帶
PAYMENT-SIGNATURE(也不帶Authorization)的請求,讀取返回的 402accepts[].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)。
小結
- X402 價格 = 該次呼叫的 Credits 成本 ×
0.095215,和一般 Credits 計費是相同價格,只是使用鏈上 USDC 結算。 0.095215/Credit 是平台最優級距(大額)Credits 單價;小額儲值購買 Credits 的單價更高,所以 X402 等於自動取得最優單價。exact介面(圖片 / 影片 / 音樂 / 搜尋 / 訂單)簽名金額即該次應付金額;upto介面(聊天)簽名的是上限,依實際用量結算。- 權威價格以 402 回傳的
maxAmountRequired為準:exact是應付金額(與成功回應的cost.amount一致,已實測);upto是上限,成功回應的cost.amount才是依用量結算的實際金額(≤ 上限)。

