按 API 请求计费
使用 x402 中间件，通过每次请求的定价来实现任何 HTTP 端点的货币化。服务器声明价格，客户端按调用付费，结算在请求生命周期内完成。无需账户、无需 API 密钥、无需计费周期。
工作原理
服务器为其希望货币化的端点添加 x402 中间件。当请求未携带付款到达时，服务器返回 HTTP 402 Payment Required 以及包含价格、代币和网络的 PAYMENT-REQUIRED 头。客户端为指定金额签署一个 ERC-3009 授权并重新提交。Facilitator 在链上结算付款，服务器返回资源。
请求流程
- 客户端向服务器发送 HTTP 请求。
- 服务器返回
402 Payment Required，并附带包含价格、代币、网络和收款方的PAYMENT-REQUIRED头。 - 客户端为指定金额签署 ERC-3009 授权，并带着
PAYMENT-SIGNATURE头重新提交请求。 - Facilitator 验证签名并在链上结算转账。
- 服务器返回资源，并附带包含结算收据的
PAYMENT-RESPONSE头。
定价
价格以 USDT0 原子单位（6 位小数）计价。成本参数 "1000" 恰好等于 $0.001。成本 "50000" 等于 $0.05。这种精度使服务器能够将价格设置为不到一美分的小数额。
基础设施
在 Stable 上，Semantic Pay 运营着一个公共 facilitator。开发者可以将其中间件指向此端点，而无需运行自己的结算基础设施。
x402 为 Express（@x402/express）、Hono（@x402/hono）和 Next.js（@x402/next）提供中间件。所有框架的模式都相同：创建一个 facilitator 客户端，注册 EVM 方案，并应用中间件。
有何不同
传统的 API 货币化需要用户注册、API 密钥管理、用量追踪、计费周期以及支付处理器集成。使用 x402，服务器为每个端点附加一个付款处理器，客户端按请求付费，结算在同一个 HTTP 生命周期内完成。服务器无需知道客户端是谁，只需知道提交了有效付款即可。
| 方面 | 传统方式（API 密钥 + 计费周期） | Stable（x402） |
|---|---|---|
| 服务端设置 | 注册、API 密钥、用量追踪、计费周期、支付处理器 | 每个端点的 x402 付款处理器 |
| 客户端接入 | 账户创建、API 密钥发放 | 无（仅需钱包） |
| 计费模式 | 按月或按用量开票 | 按请求结算 |
| 是否需要客户端身份 | 是（API 密钥） | 否（仅需有效付款） |
| 结算 | 计费周期结束时 | 请求生命周期内（1 秒以内） |
| 最低可行价格 | 约 $0.30（卡处理下限） | $0.001（USDT0 原子单位） |
| 客户端类型 | 仅限人类用户（需注册） | 任意钱包：人类、AI 代理、脚本 |