為 AI 模型而設的 x402 API：以 USDC 按次付費
RunAPI 的按次收費端點支援 x402 付款。AI 代理發出一般請求，收到 402 報價，用錢包簽署後就能取得結果。毋須帳戶、API key 或預付點數。
curl -i -X POST "https://runapi.ai/api/v1/z_image/text_to_image" \ -H 'Content-Type: application/json' \ --data @request.json # HTTP/2 402# PAYMENT-REQUIRED: <base64 JSON with accepts: scheme, network, asset, amount, payTo>- 155 支援 x402 付款的資源
- Base 結算網絡
- USDC 付款資產
- 0 所需 API key 數目
由請求到結果只需四步
-
不附 key 發出請求
以 POST 發送與使用 API key 時相同的 JSON 請求內容，只是略去 Authorization header。
-
讀取 402 報價
RunAPI 回傳 402 狀態碼，並附上 PAYMENT-REQUIRED header，列明準確的金額、資產、網絡及收款地址。報價有效期為 300 秒。
-
簽署後重試
你的 x402 v2 客戶端以 AI 代理的錢包簽署 EIP-3009 授權，再附上 PAYMENT-SIGNATURE header 重新發出請求。
-
輪詢任務
RunAPI 完成結算、啟動任務，並回傳 200 狀態碼，附上 PAYMENT-RESPONSE 收據及用來取得結果的 poll_url。
付款前需要了解的事
免註冊，免 API key
付款錢包就是唯一身分。毋須建立帳戶、保存 key，也不用增值餘額。
USDC 付款免 gas
付款方簽署 EIP-3009 授權，由 Coinbase CDP facilitator 提交轉帳，錢包只需要 USDC，不需要 ETH。
取得結果
大部分媒體任務以非同步方式完成。200 回應中包含一個 poll_url，內附唯讀的任務存取 token。此 token 只能開啟這一個任務，並在任務完成後 30 日內保持有效。
任務失敗時
x402 本身沒有退款機制。已付款的任務如以失敗狀態結束，RunAPI 會按實收金額記錄一筆全額退款責任，再由營運人員以另一筆 USDC 轉帳退回付款錢包；退款並非自動完成。
支援哪些端點
x402 適用於單次價格固定的按次收費 REST 端點。按 token、秒數或字元計費的模型（包括 LLM 端點）仍然需要 API key 及點數。MCP server 不接受 x402 付款。
API key 照用無誤
x402 是額外提供的付款方式。附有效 API key 的請求會照舊扣除帳戶點數；附無效 key 的請求則會收到 401，而不是付款報價。
實際交互過程
將回應交給任何已連接 AI 代理錢包的 x402 v2 客戶端，簽署和重試都由客戶端處理：
request = {method: "POST", url: task_url, json: payload}response = x402_client.send(request, wallet: agent_wallet)# The x402 v2 client reads PAYMENT-REQUIRED, signs an EIP-3009# authorization, and replays the request with PAYMENT-SIGNATURE.response.status # => 200response.headers["PAYMENT-RESPONSE"] # settlement receiptresponse.json["poll_url"] # read-only task result URL價格例子
以下是現時支援 x402 的部分模型的最低單次調用價格。價格取自即時模型目錄，每個 402 報價都會列明該次請求的準確金額。
| 模型 | 端點 | 單次調用價格 |
|---|---|---|
| Z Image Text to image z-image | POST /api/v1/z_image/text_to_image | $0.01 |
| Flux Text to image flux-2-klein | POST /api/v1/flux/text_to_image | $0.03 |
| Suno Stitch audio suno-v4 | POST /api/v1/suno/stitch_audio | $0.01 |
| Suno Stitch audio suno-v4.5 | POST /api/v1/suno/stitch_audio | $0.01 |
| Recraft Upscale image recraft-crisp-upscale | POST /api/v1/recraft/upscale_image | $0.01 |
| Recraft Remove background recraft-remove-background | POST /api/v1/recraft/remove_background | $0.01 |
付款細節
RunAPI 跟從 x402 v2 的 exact 方案，只接受以下數值。任何其他數值都會在 RunAPI 要求 facilitator 結算之前被拒絕。
| 網絡 | Base mainnet（eip155:8453） |
|---|---|
| 資產 | USDC，合約地址 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913，6 位小數 |
| Facilitator | Coinbase CDP |
| 授權方式 | EIP-3009，付款方只需持有 USDC，毋須 ETH 支付 gas |
| 上限 | 每次請求最多 10 USDC；報價 300 秒後失效 |
x402 常見問題
甚麼是 x402？
x402 是建基於 HTTP 402 Payment Required 狀態碼的開放付款協議。伺服器回傳 402 並附上付款要求，客戶端以已簽署的穩定幣授權付款，然後重新發出請求。協議由 x402 Foundation 維護。
用 x402 付款需要 RunAPI 帳戶嗎？
不需要。付款的錢包就是身份。RunAPI 只會在首次成功結算後建立內部錢包檔案，絕不會要求電郵或 API key。
x402 facilitator 負責甚麼？
Facilitator 負責驗證已簽署的付款，並在 Base 上提交 USDC 轉帳。RunAPI 使用 Coinbase CDP facilitator，所以付款方毋須支付 gas。
一次請求要幾多錢？
每個端點都有固定的單次調用價格。簽署之前，402 報價會顯示準確的 USDC 金額，模型目錄亦會列出現行價格。
AI 代理可以透過 x402 Bazaar 找到 RunAPI 嗎？
每個 402 報價都包含 Bazaar 探索聲明，附有輸入 schema 及範例，因此 x402 客戶端和目錄都可以收錄該端點。
如果我已付款，但請求在任務開始前失敗，會點樣？
驗證失敗的請求會在結算前被拒絕，所以不會收費。付款一經結算，其後失敗的任務都會產生全額退款責任。