專為 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 標頭。
-
讀取 402 報價
RunAPI 回傳 402 狀態碼，並附上 PAYMENT-REQUIRED 標頭，列出確切的金額、資產、網路與收款地址。報價有效期為 300 秒。
-
簽署後重試
你的 x402 v2 用戶端以 AI 代理的錢包簽署 EIP-3009 授權，再帶上 PAYMENT-SIGNATURE 標頭重新送出請求。
-
輪詢任務
RunAPI 完成結算、啟動任務，並回傳 200 狀態碼，附上 PAYMENT-RESPONSE 收據與用來取得結果的 poll_url。
付款前需要了解的事
免註冊，免 API key
付款錢包就是唯一身分。不必建立帳號、保存 key，也不用儲值餘額。
USDC 付款免 gas
付款方簽署 EIP-3009 授權，由 Coinbase CDP facilitator 送出轉帳，錢包只需要 USDC，不需要 ETH。
取得結果
大多數媒體任務以非同步方式完成。200 回應中包含一個 poll_url，內含唯讀的任務存取權杖。此權杖只能開啟這一個任務，並在任務完成後 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 用戶端與目錄都能收錄該端點。
如果我已付款，但請求在任務開始前就失敗了怎麼辦？
驗證未通過的請求會在結算之前就被拒絕，因此不會扣款。付款一旦完成結算，之後失敗的任務都會產生全額退款義務。