---
title: "什么是 x402？为 AI agent 和链上 API 设计的支付协议"
description: "x402 是一种开放协议，将加密货币支付嵌入 HTTP，让 AI agent 能够实时支付 API 调用费用：无需 API 密钥，无需订阅，无需账单面板。"
---

# 什么是 x402？为 AI agent 和链上 API 设计的支付协议

<ImageBlock
  src="https://media.alchemy.com/1761687534-x402_1.png"
  alt="x402 支付协议示意图"
  width={1920}
  height={900}
  priority
/>

[AI 智能体](https://www.alchemy.com/dapps/best/ai-agents)需要为各种东西付费：API 调用、数据源、算力。但它们没有信用卡，也无法填写注册表单。标准的计费模式假设的是人在另一端操作。当客户端是软件时，这套模式就不成立了。

[x402](https://www.x402.org/) 是一个开源协议，正是为解决这个问题而生。它把加密货币支付直接嵌入 HTTP，使用 402 "Payment Required" 状态码——这个状态码从上世纪 90 年代起就写在规范里，但从未被真正使用过。客户端发送请求，收到付款条件，用加密货币支付，然后重试。不需要 API 密钥，不需要订阅，不需要计费看板。

自 2025 年 5 月上线以来，x402 已处理超过 1 亿笔支付。2025 年 12 月，[x402 V2](https://www.x402.org/writing/x402-v2-launch) 发布，支持多链、基于钱包的会话以及可扩展架构。2026 年 4 月，[Coinbase](https://www.alchemy.com/dapps/coinbase) 将该协议贡献给了 [Linux 基金会](https://www.linuxfoundation.org/press/linux-foundation-is-launching-the-x402-foundation-and-welcoming-the-contribution-of-the-x402-protocol)，后者成立了 x402 基金会，创始成员超过 20 个，包括 Google、Visa、Stripe、AWS、Mastercard、Circle、Microsoft 和 Shopify。

<ImageBlock
  src="https://media.alchemy.com/1761687667-402_payment_flow.png"
  alt="展示 x402 支付流程的示意图"
  width={684}
  height={684}
  caption="Source: https://x.com/jarrodWattsDev/status/1982036553481568512"
/>

## x402 支付流程是如何运作的？

整个过程分五步：

1. 客户端向服务器请求资源。
2. 如果该资源需要付费，服务器返回 402 Payment Required 响应，附带付款条件：金额、币种和目标地址。
3. 客户端读取条件，发送付款（通常是 USDC），并带上支付头重试请求。
4. 服务器验证付款，可以本地验证，也可以通过 facilitator 验证。
5. 服务器以 200 OK 交付资源。

就是这样。任何 HTTP 端点都能变成付费服务，任何拥有加密钱包的客户端都能成为付费用户。付款发生在请求周期内部，而不是通过单独的计费系统。

x402 已在生产环境中运行。你可以在 [x402scan.com](https://www.x402scan.com/) 上查看实时交易。

<ImageBlock
  src="https://media.alchemy.com/1761687788-402scan.png"
  alt="x402scan 实时支付交易截图"
  width={1191}
  height={625}
/>

## 什么是 HTTP 402，为什么它从未被使用过？

如果你写过网络相关的东西，你应该熟悉状态码。200 表示请求成功。404 表示页面不存在。那 402 呢？表示需要付款。

大多数开发者从未在实际场景中见过 402。这个状态码从上世纪 90 年代起就写入了 HTTP 规范，但原作者只是将它保留"供未来使用"，并没有定义支付该如何运作。于是开发者们建立了其他计费模式：注册账户、绑定信用卡、获取 API 密钥、按使用量付费。

x402 填补了这个空白。付款不再依赖 API 密钥和计费看板，而是发生在 HTTP 请求本身内部。服务器返回 402，客户端用加密货币支付，服务器交付资源。HTTP 与区块链在一次交互中完成。

## x402 V2 有哪些新特性？

x402 V2 在经过六个月的生产环境使用后，于 2025 年 12 月发布。其中四项改动最为重要。

### 多链和多支付渠道

V1 只支持 Base 上的 USDC。V2 支持跨 Base、Solana、Ethereum、Polygon、[Starknet](https://www.alchemy.com/starknet) 和 Injective 的代币，未来还会支持更多链。它还通过可插拔的 facilitator 支持传统支付渠道（ACH、SEPA、银行卡网络）。

如果你在构建一个市场或多租户 API，动态 "payTo" 路由可以让你按请求将付款分发到不同的地址或角色。

### 基于钱包的会话

V1 要求每次请求都完成一次完整的链上支付。这对一次性 API 调用没问题，但对高频工作负载就行不通了。V2 引入了钱包会话：认证一次，之后的请求使用会话令牌。服务器会定期结算累计使用量，而不是逐次在链上验证。

如果你在构建 LLM 推理管道、实时数据源或多步骤智能体工作流，会话机制正是让微支付变得可行的关键。延迟更低，单次请求成本更低，链上交易更少。

### 可扩展架构

V2 将协议规范与 SDK 和 facilitator 分离开来。新的链、支付方案和 facilitator 可以作为独立的包接入，无需改动核心协议。SDK 使用 [CAIP 标准](https://chainagnostic.org/)来标识链和资产，因此接入新网络不需要自定义逻辑。

### 自动 API 发现

服务会暴露结构化元数据，facilitator 会自动爬取这些数据。定价、路由和端点无需手动更新或硬编码目录即可保持同步。你只需发布一次服务，网络中的每个 facilitator 就都能发现它。不需要注册，不需要合作方对接，不需要维护目录。

## Facilitator 在 x402 中扮演什么角色？

如果你是 API 开发者，你大概不想自己写区块链结算逻辑。Facilitator 会替你处理这些。可以把它们想象成开放网络的支付处理商：它们确认客户端的授权，在链上执行交易，并将确认结果返回给你的服务器。

<ImageBlock
  src="https://media.alchemy.com/1761687860-facilitator.png"
  alt="展示 x402 facilitator 工作流程的示意图"
  width={1400}
  height={834}
  caption="Source: https://medium.com/@christianobi98/x402-awakening-http-402-for-autonomous-web-payments-2fd944cb703a"
/>

有了 facilitator，你无需编写任何区块链代码就能接受 x402 支付。V2 支持同时使用多个 facilitator，SDK 会根据链、资产以及你的偏好自动选择最合适的一个。

## x402 适合谁使用？

如果以下任意一条听起来像是你的问题，x402 就是为你而建的：

- 你是 API 提供方，希望实现按使用量付费的变现方式，而不强迫用户创建账户或管理订阅
- 你在构建 AI 智能体或机器人，它们需要在没有人工介入的情况下为服务付费
- 你使用编程智能体（Cursor、Claude Code、ChatGPT），它们需要自行访问付费 API、数据或算力
- 你在构建智能体间（A2A）商业模式、机器对机器支付或自主服务市场

x402 适用于任何软件需要自行为资源付费的场景：AI 推理 API、数据访问的微支付、内容付费墙、算力计费。对于加密生态之外的购买场景，像 [AgentCard](https://agentcard.ai/) 这样的项目可以为智能体提供带有可配置消费限额和实时追踪的专属信用卡。

## 用 x402 能构建什么？

- 面向 AI 推理、数据源或算力的按调用付费 API 端点
- 数字内容的微支付系统：图片、视频、研究论文、数据集
- 智能体间自主商业交易，AI 智能体之间互相购买数据、算力或 API 访问权限
- 存储、带宽或任何计量资源的按使用量计费
- 带有加密货币门槛高级层级的免费增值 API
- 利用 V2 会话机制、以次分币级费率按请求付费的多链数据管道

这些都不是空想。AI 智能体已经在查询区块链数据来管理 DeFi 仓位，在没有人工监督的情况下监控代币价格并执行交易，并端到端地运行多链索引管道。还有一些正在通过支持 x402 的服务购买算力和部署智能合约。

关于 x402 与 Machine Payments Protocol（MPP）的详细对比，参见 [x402 vs MPP: comparing agent payment protocols](/overviews/x402-vs-mpp-comparing-agent-payment-protocols)。

## Alchemy 如何支持 x402？

我们构建了一个[智能体网关](/blog/ai-agents-can-now-sign-up-for-alchemy)，让 AI 智能体无需任何人工设置即可通过 x402 访问区块链基础设施。

实际流程是这样的：一个智能体带着它的链上钱包出现，没有 API 密钥，没有看板账户。它直接调用我们的 API。如果需要付款，我们返回一个附带付款条件的 402。智能体在 Base 上用 USDC 支付，我们处理该请求。后续请求从已充值余额中扣除，直到余额耗尽，网关会发出新的 402，智能体自行充值。

### 可用的 API

智能体可以访问 Coinbase、Visa 和 Stripe 等团队所使用的同一套生产级 API，覆盖 100\+ 条区块链：

- 覆盖 100\+ 条区块链的核心 RPC
- 用于查询所有权和元数据的 NFT API
- 用于多链钱包视图的 Portfolio API
- 用于现货和历史代币价格的 Prices API

智能体最低只需 1 美元的算力额度即可开始，相当于按使用量计费层级中 1 美元的 CU。不需要签合同，不需要审批排队。

### Alchemy Skills

我们还发布了 [Alchemy Skills](https://github.com/alchemyplatform/skills)：一种结构化、机器可读的文档，专为智能体而非人类设计。Skills 会告诉智能体我们提供了什么、哪些端点可用以及如何调用它们，让智能体无需阅读面向人类的文档就能发现并集成我们的产品。

### Alchemy CLI

[Alchemy CLI](https://www.alchemy.com/docs/alchemy-cli) 是为智能体和终端工作流而构建的：使用 `--json --no-interactive` 进行认证、查询数据，并通过 `alchemy --json --no-interactive agent-prompt` 为编程智能体生成完整的命令清单。

<CodeSnippet
  language="bash"
  code={`npm i -g @alchemy/cli@latest
alchemy auth
alchemy --json --no-interactive prices symbol ETH,BTC,SOL
alchemy --json --no-interactive agent-prompt`}
/>

添加 [Alchemy Skills](https://www.alchemy.com/docs/alchemy-agent-skills) 或连接 [Alchemy MCP server](https://www.alchemy.com/docs/alchemy-mcp-server)。

## 如何开始用 x402 构建

准备好试一试了吗？根据你想从哪里入手，有四条路径：

- 在 [x402.org](https://www.x402.org/) 阅读完整规范并探索参考 SDK
- 克隆 GitHub 上的 [coinbase/x402](https://github.com/coinbase/x402) 仓库并运行示例
- 通过[我们的智能体平台](/agents)构建能为区块链数据付费的智能体，该平台原生支持 x402：不需要 API 密钥，只需一个钱包和一次 HTTP 调用
- 安装 [CLI](https://www.alchemy.com/docs/alchemy-cli)，用 `--json --no-interactive` 在终端中查询端点

对于测试网开发，可以从 [Alchemy Faucet](https://www.alchemy.com/faucets/base-sepolia) 获取 Base [Sepolia ETH](https://www.alchemy.com/overviews/sepolia-testnet)，从 [Circle Faucet](https://faucet.circle.com/) 获取 USDC 测试代币。

## 常见问题

### 什么是 x402 协议？

x402 是一个开源协议，使用 HTTP 402 "Payment Required" 状态码将加密货币支付直接嵌入网络请求中。它让 AI 智能体、应用和机器人能够实时为 API 调用和数字服务付费，无需 API 密钥、订阅或手动设置计费。

### x402 支付流程是如何运作的？

客户端发送 HTTP 请求。服务器返回 402 状态码及付款条件。客户端付款（通常使用 USDC）并带着支付头重试。服务器验证付款后以 200 OK 返回资源。

### x402 支持哪些区块链？

x402 V2 支持 Base、Solana、Ethereum、Polygon、Starknet 和 Injective，并计划扩展到所有支持稳定币交易的 L1 和 L2。它还通过可插拔的 facilitator 支持 ACH、SEPA 和银行卡网络等传统支付渠道。

### 什么是 x402 基金会？

x402 基金会于 2026 年 4 月在 Linux 基金会旗下成立，是管理 x402 协议的中立机构。创始成员超过 20 个，包括 Google、Visa、Stripe、AWS、Mastercard、Circle、Microsoft、Shopify 和 American Express。

### x402 和 MPP 有什么区别？

x402 将[稳定币支付](https://www.alchemy.com/dapps/best/stablecoin-payments)直接嵌入 HTTP。MPP（Machine Payments Protocol）在同样的 402 模式基础上扩展了与支付方式无关的渠道、基于会话的计费、MCP 传输支持，以及幂等性和重放保护等标准化协议基元。MPP 向后兼容 x402。[阅读完整对比](/overviews/x402-vs-mpp-comparing-agent-payment-protocols)。

### 使用 x402 需要写区块链代码吗？

不需要。Facilitator 负责处理支付验证和链上结算，因此 API 开发者无需编写区块链逻辑即可接受 x402 支付。V2 支持多个作为独立包接入的 facilitator。

### AI 智能体可以通过 x402 使用 Alchemy 吗？

可以。Alchemy 运行着一个原生支持 x402 的智能体网关。智能体用自己的链上钱包完成认证，在 Base 上用 USDC 付款，即可访问核心 RPC（100\+ 条链）、NFT、Portfolio 和 Prices API。不需要 API 密钥、看板或人工设置。从 [alchemy.com/agents](/agents) 开始。

### x402 使用什么加密货币进行支付？

x402 主要使用 USDC——一种以美元计价的稳定币——进行支付。V2 已将支持范围扩展到多条链和多个网络上的代币。该协议还通过可插拔的 facilitator 支持传统支付渠道（ACH、SEPA、银行卡），不过[稳定币](https://www.alchemy.com/dapps/top/stablecoins)仍是主要的支付方式。

### 我该如何开始用 x402 构建？

可以从 [x402.org](https://www.x402.org/) 的规范和参考 SDK 入手，或使用 GitHub 上的 [coinbase/x402](https://github.com/coinbase/x402) 仓库，也可以通过 [Alchemy 的智能体平台](/agents)构建使用 x402 访问区块链数据的智能体。[Alchemy CLI](https://www.alchemy.com/docs) 提供了从设置到查询端点的快捷路径。
