面向 AI 模型的 x402 API：按请求以 USDC 付费
RunAPI 在按次计费的端点上接受 x402 支付。智能体发送一个普通请求，收到 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 发送请求
发送和携带 API key 时相同的 JSON 请求体，只是省略 Authorization 请求头。
-
读取 402 报价
RunAPI 返回 402 状态码，附带 PAYMENT-REQUIRED 响应头，列出准确的金额、资产、网络和收款地址。报价有效期为 300 秒。
-
签名并重试
你的 x402 v2 客户端用智能体钱包签署 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，而不是支付报价。
交互过程是什么样的
把响应交给任意连接了智能体钱包的 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 金额，模型目录中也列出了当前价格。
智能体能通过 x402 Bazaar 发现 RunAPI 吗？
每个 402 报价都包含 Bazaar 发现声明，其中带有输入 schema 和示例，因此 x402 客户端和目录都可以收录该端点。
如果我付款了，但请求在任务开始前失败会怎样？
校验失败的请求会在结算之前被拒绝，因此不会产生扣费。一旦支付结算完成，之后失败的任务会产生全额退款义务。