AI 代理的自动售货机：x402 与 IteraTools 实现自主微支付

I’m ready to translate the article for you, but I don’t have the text of the post itself—only the source link you provided. Could you please paste the content you’d like translated (or the specific sections you want)? Once I have the text, I’ll translate it into Simplified Chinese while preserving the original formatting, markdown, and technical terms.

问题：AI 代理需要更简便的工具付费方式

当 AI 代理需要使用工具时，它不应该必须：

• 填写表单
• 等待 API‑key 审批
• 管理月度订阅

它只需要支付 $0.001 并获取所需资源。

当前每次外部 API 调用的工作流程

1. 在 API 提供商处创建账户
2. 输入信用卡信息（通常需要 KYC）
3. 购买积分或订阅套餐——预付以获得使用权
4. 存储并管理 API key（存在安全风险）
5. 处理账单、续费、速率限制

在 人类 集成时这还算可以。但 AI 代理没有信用卡，无法点击“同意条款”，也无法在金库中管理轮换的密钥。

互联网是为人类而建的。但现在代理正在使用它。

通过 x402 协议介绍 HTTP 402 “需要付款”

• HTTP 402 于 1991 年被定义为 保留 状态码——“供将来使用”。
• 它在三十多年里未被使用。
• 2024 年：Coinbase 发布了 x402，这是一项开放标准，终于赋予 HTTP 402 其用途。

完整的 x402 流程

1. Agent 发送 HTTP 请求 → Server 返回 402 并附带付款要求。
2. Agent 对 无燃料 USDC 授权（EIP‑3009，无需 gas）进行签名。
3. Agent 使用 X-Payment 头部重新请求。
4. Server 验证 → 在 Base 上结算 → 返回 200 OK。

无需账户。无需 API 密钥。无需订阅。
代理携带钱包，按次付费获取资源——互联网的自动售货机。

402 响应示例

HTTP/1.1 402 Payment Required
Content-Type: application/json

{
  "x402Version": 1,
  "error": "X-Payment header is required",
  "accepts": [
    {
      "scheme": "exact",
      "network": "base",
      "maxAmountRequired": "1000",
      "resource": "https://api.iteratools.com/qrcode",
      "description": "QR code generation",
      "payTo": "0xa81Dbd562436511dE5268BF70cF124C2689Ab11a",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
    }
  ]
}

• 付款金额 为机器可读。
• 钱包地址 包含在响应中。
• 代理无需询问任何人——只需付款。

为什么传统 API 不适合 AI 代理

AI 代理的需求

• 自主代码执行
• 能持有加密钱包（通过 CDP、viem 等）
• 推理循环中的毫秒级支付
• 对 $0.001 API 调用实现零人工干预

x402 完全契合代理的思维模型：

“我需要这个资源。它多少钱？这是付款。把资源给我。”

这正是自动售货机的逻辑：投币 → 出货。没有账户，没有订阅，没有文书工作。

IteraTools: 41 Utility Tools Built for AI Agents (x402‑Compatible)

• 无需订阅 即可开始。
• 无需管理 API 密钥。
• 只需一个 Base 钱包，存入几美分的 USDC。

Source: …

完整的 Node.js 代理示例（零人工干预）

import { withPaymentInterceptor } from '@x402/fetch';
import { createWalletClient, http } from 'viem';
import { base } from 'viem/chains';
import { privateKeyToAccount } from 'viem/accounts';

// ---------------------------------------------------
// 1️⃣  代理的钱包 – 从环境变量加载
// ---------------------------------------------------
const wallet = createWalletClient({
  account: privateKeyToAccount(process.env.AGENT_PRIVATE_KEY),
  chain: base,
  transport: http(),
});

// ---------------------------------------------------
// 2️⃣  包装 fetch – x402/fetch 自动处理 402
// ---------------------------------------------------
const payingFetch = withPaymentInterceptor(fetch, wallet);

// ---------------------------------------------------
// 3️⃣  研究主题（费用 $0.001）
// ---------------------------------------------------
const searchRes = await payingFetch('https://api.iteratools.com/search', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ query: 'x402 protocol AI agents', num: 5 }),
});
const searchData = await searchRes.json();

// ---------------------------------------------------
// 4️⃣  汇总结果（费用 $0.002）
// ---------------------------------------------------
const summaryRes = await payingFetch('https://api.iteratools.com/summarize', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    text: searchData.results.map(r => r.snippet).join('\n')
  }),
});
const summary = await summaryRes.json();

// ---------------------------------------------------
// 5️⃣  生成指向来源的二维码（费用 $0.001）
// ---------------------------------------------------
const qrRes = await payingFetch('https://api.iteratools.com/qrcode', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ text: searchData.results[0].url }),
});
const qr = await qrRes.json();

// ---------------------------------------------------
// 6️⃣  输出（总费用 $0.004 USDC）
// ---------------------------------------------------
console.log('Summary:', summary.text);
console.log('QR Code:', qr.qr_url);

withPaymentInterceptor 的工作原理

• 代理永远不知道付款已经发生——它只会收到数据。
• 零 gas 对代理而言；服务器的结算方在 Base 上支付 gas。
• 唯一要求：代理在 Base 上持有足够的 USDC。

Server（IteraTools）处理付款的方式

1. 验证 EIP‑712 签名。
2. 验证 收款人、金额、时间窗口和 nonce。
3. 调用 USDC.transferWithAuthorization 在 Base（settler 支付 gas）。
4. 执行 所请求的工具。
5. 返回 结果给代理。

结论

• x402 将 HTTP 402 转变为实用的、机器可读的支付流程。
• AI 代理可以使用加密钱包 按调用付费，消除对以人为中心的注册流程的需求。
• IteraTools 提供现成的低成本、兼容 x402 的工具目录，使代理能够在文本、网络、图像、数据、通信和代码等领域自主运行。

互联网是为人类构建的；有了 x402，它终于也能为代理服务。

代理间商务

一个编排代理可以创建子代理，每个子代理都有自己的资金钱包，并且能够自主购买工具：

Orchestrator Agent
├── Research Agent  → pays $0.001 for /search
│                     → pays $0.002 for /scrape
├── Writing Agent   → pays $0.002 for /summarize
│                     → pays $0.001 for /sentiment
└── Media Agent     → pays $0.005 for /image/generate
                      → pays $0.001 for /tts

总计： $0.012 USDC — 在 Base 上结算，无需人工介入

这就是 多代理经济。代理之间不共享 API 密钥——每个代理都有自己的钱包，只为实际使用的服务付费。编排代理可以恰好为子代理提供完成任务所需的资金，绝不多余。

Traditional API vs. x402 + IteraTools

入门

作为代理开发者（买家）

npm install @x402/fetch viem @iteratools/mcp

import { withPaymentInterceptor } from '@x402/fetch';

// 为你的 Base 钱包充值 1 美元的 USDC
// 根据使用的工具，这大约可以支持 100‑1000 次 API 调用

作为 MCP 用户（Claude、Cursor 等）

npx @iteratools/mcp

• 41 个工具 可即时使用。无需 API 密钥，按使用付费。

试试实时 402 响应

curl -s -X POST https://api.iteratools.com/qrcode \
  -H "Content-Type: application/json" \
  -d '{"text":"hello world"}'

你将看到一个真实的 402 响应以及付款说明。

为什么是 x402？

x402 不仅仅是一个支付协议——它是 为自主代理解锁能力 的钥匙。

如今，大多数 AI 代理只能使用其创建者预先授权并预付费用的工具。借助 x402，代理可以自行发现并为 任何兼容 x402 的服务 付费——实时、自动、只需几分钱。

API 的互联网将变成 代理工具的互联网。

IteraTools 正在基于此模型构建：

• 当前 41 种工具，每月持续新增
• 只要拥有 Base 钱包和少量 USDC，即可供 任何代理 使用

自动售货机已经打开。投放你的 USDC，取走你的工具。

IteraTools: https://iteratools.com

快速命令

# Test the 402 endpoint
curl -s -X POST https://api.iteratools.com/qrcode \
  -H 'Content-Type: application/json' \
  -d '{"text":"test"}'

# Run the MCP package
npx @iteratools/mcp

资源

• x402 协议: https://x402.org | https://docs.x402.org
• GitHub（x402）: https://github.com/coinbase/x402
• Live 402 演示脚本: https://github.com/fredpsantos33/iteratools-x402-demo

Contact

IteraTools 是由 Iterasoft 构建的。如果您正在构建 AI 代理，欢迎与我们联系。