acedatacloud 負責 API 呼叫,acedatacloud-x402 負責簽出 PAYMENT-SIGNATURE 請求標頭。
原始碼與套件位址:
- SDK 儲存庫:https://github.com/AceDataCloud/SDK
- X402 Client 儲存庫:https://github.com/AceDataCloud/X402Client
- PyPI SDK:https://pypi.org/project/acedatacloud/
- PyPI X402 Client:https://pypi.org/project/acedatacloud-x402/
安裝相依套件
upto,還需要一次性呼叫 Permit2 approve CLI,該 CLI 相依於 web3:
acedatacloud和acedatacloud-x402均可從 PyPI 安裝並匯入。pip install 'acedatacloud-x402[cli]'會附帶approve-permit2CLI,用於upto前置授權。
Base 範例
下面範例不需要 API Token。錢包私鑰只在本機簽名,不會傳送給 Ace Data Cloud。dict,所以範例使用 res["choices"][0]["message"]["content"]。不要直接假設它一定有 .choices 屬性。
Solana 範例
Solana 使用 base58 編碼的 secret key:TransferChecked 交易,然後把交易簽名放入 PAYMENT-SIGNATURE envelope。
Solana paid retry 在生產 API 上已回傳 HTTP 200 和 ADC_SOLANA_E2E_OK。本次公開 RPC 查詢遇到限流,未穩定確認鏈上 signature;需要對帳時請使用你自己的 Solana RPC 查詢該次交易。
Async 用戶端
同一個 payment handler 可以用於AsyncAceDataCloud:
使用 upto 後置計量
聊天補全、模型呼叫等 API 的實際成本可能需要等回應結束後才知道。此時 API 可能同時回傳 exact 和 upto。如果要優先使用 upto:
upto 的程式執行結果:
content ADC_BASE_UPTO_OK說明請求實際進入模型 API。settled value 3 atomic USDC說明upto按實際用量結算,而不是扣除完整上限。settlement tx可在 BaseScan 開啟,對帳時儲存 tx hash、payer、completion id 和請求摘要。
upto 使用 Permit2 授權一個上限,實際結算金額不能超過該上限。第一次使用前,需要對目標鏈上的 USDC 做一次 approve(Permit2, amount)。
CLI 方式:
{"skipped": true},不會重複發送鏈上交易。
低階簽名
如果你不使用 SDK,也可以直接呼叫低階簽名函式:create_x402_payment_handler。
