x402 快速入门

在 Base 上部署兼容 x402 的按次付费接口，支持 AI 代理使用 USDC 支付。

什么是 x402？

HTTP 状态码 402（“Payment Required”，需付款）是机器对机器（M2M）支付的标准协议。AI 代理发起请求后收到带定价信息的 402 响应，随后在 Base 链上支付 USDC，即可获取所需数据。全程无需 API 密钥、账户或订阅服务。

生态进展（2026 年第一季度）：Stripe、Cloudflare、Google（AP2）、Coinbase 均将原生支持 x402。

快速部署

1. 生成接口脚手架

bash scripts/scaffold.sh my-service "My cool API" 0.01

在 ./my-service/ 目录下创建一个开箱即用的 Express 服务，并集成 x402 支付中间件。

2. 配置钱包

设置你的 Base 钱包地址以接收付款：

# 在生成的 .env 文件中
WALLET_ADDRESS=0xYourBaseWalletAddress
USDC_CONTRACT=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
CHAIN_ID=8453
PORT=3402

3. 本地运行

cd my-service && npm install && node server.js

4. 通过 Cloudflare Tunnel 暴露服务（零成本）

cloudflared tunnel --url http://localhost:3402

工作原理

AI 代理调用流程

Agent → GET /api/data → 402 Payment Required
                         ├── price: "0.01 USDC"
                         ├── payTo: "0x..."
                         └── network: "base"
Agent → 在 Base 上支付 USDC → 获取交易哈希（tx hash）
Agent → GET /api/data（携带 X-Payment-Tx: 0x... 头）→ 200 OK + 返回数据

服务端处理流程

1. 请求未附带付款信息 → 返回 402 响应并附带定价信息
2. 请求携带 X-Payment-Tx 请求头 → 在链上验证该交易
3. 若付款已确认 → 返回目标数据
4. 若付款失败 → 再次返回 402 响应

推荐的接口类型

AI 代理愿意付费调用的高价值接口：

付款验证

脚手架中已包含 scripts/verify-payment.js，用于链上付款验证：

// 验证 Base 链上的 USDC 转账
const verified = await verifyPayment(txHash, expectedAmount, recipientAddress);

使用 Base RPC（免费层级）——基础验证无需 API 密钥。

与 OpenClaw 集成

作为技能接口（Skill Endpoint）

将该接口添加至 AI 代理的能力列表中：

// 在 SKILL.md 或代理配置文件中
{
  tools: [{
    name: "my_x402_service",
    endpoint: "https://my-service.example.com/api",
    payment: { currency: "USDC", network: "base" }
  }]
}

结合 Cloudflare Tunnel 使用

利用现有设备实现零成本托管：

# 一次性初始化
cloudflared tunnel create my-x402
cloudflared tunnel route dns my-x402 api.mydomain.com

# 启动隧道
cloudflared tunnel run --url http://localhost:3402 my-x402

Spraay 网关集成

在 Spraay 注册你的接口，以便 AI 代理自动发现：

curl -X POST https://gateway.spraay.app/register 
  -H "Content-Type: application/json" 
  -d '{"url": "https://api.mydomain.com", "category": "data", "price": "0.01"}'

定价策略

• 数据类接口：$0.005–0.05（标准化、高频调用）
• 分析类接口：$0.10–1.00（附加价值、中等频次）
• 研究类接口：$1.00–5.00（高端服务、低频调用）
• GPU/计算类接口：$0.05–0.50（基于资源消耗计价）

建议从低价起步，待积累用户和调用量后再逐步提价。以 $0.01 实现 1000 次调用，远胜于 $1.00 零调用。