跳轉到主要內容
這篇文件說明用 X402 呼叫 Ace Data Cloud API 時,價格是怎麼定的,以及它和平台普通 Credits(額度)價格是什麼關係。

核心結論

X402 不是一套獨立的價格體系。每個 API 呼叫本來就有一個以 Credits 計的成本,這是所有計費方式(API Token 扣額度、帳戶餘額、X402 鏈上支付)共用的唯一價格來源。X402 只是把這個 Credits 成本按一個固定匯率換算成鏈上 USDC:
1 Credit = 0.095215 USDC(即 95215 atomic USDC,USDC 為 6 位小數)
也就是說:
這個匯率不是憑空設定的,它等於平台 最優檔(大額)Credits 單價。所以用 X402 付費 ≈ 用最優檔單價買 Credits 再消費,沒有 X402 溢價,反而直接享受最便宜的 Credits 單價,且無需預充值、無需 API Token。

計價基準

換算由平台統一完成,金額對所有支援的網路(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),實際按真實用量結算,且不超過上限。
關於這兩種 scheme 的協定細節見 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 為例):
一次 500 prompt + 200 completion token 的請求:
客戶端按 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):
注意:按呼叫付費(上文 Chat / 其他服務)和訂單支付是兩條不同路徑。按呼叫付費統一用 0.095215/Credit 的最優檔單價;訂單支付按套餐定價,其建立價與最終結算金額的差異以 訂單支付教學 為準。

如何即時取得價格

價格隨模型和參數變化,請用程式即時取得,不要硬編碼:
  • 按呼叫價格:對目標 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)。
取得價格的最小請求範例:

小結

  • X402 價格 = 該次呼叫的 Credits 成本 × 0.095215,和一般 Credits 計費是相同價格,只是使用鏈上 USDC 結算。
  • 0.095215/Credit 是平台最優級距(大額)Credits 單價;小額儲值購買 Credits 的單價更高,所以 X402 等於自動取得最優單價。
  • exact 介面(圖片 / 影片 / 音樂 / 搜尋 / 訂單)簽名金額即該次應付金額;upto 介面(聊天)簽名的是上限,依實際用量結算。
  • 權威價格以 402 回傳的 maxAmountRequired 為準:exact 是應付金額(與成功回應的 cost.amount 一致,已實測);upto 是上限,成功回應的 cost.amount 才是依用量結算的實際金額(≤ 上限)。

相關文件