Metaplex x402 - 按请求付费的 AI 与 Solana RPC

Metaplex x402 是面向 LLM 推理、图像生成和 Solana RPC 的按请求付费 HTTP API — 无需 API 密钥、账户或订阅。只需准备一个持有 USDC 的 Solana 钱包、Core 资产或已注册的 Agent，每个请求都会在发出时以 USDC 自动完成支付。

摘要

Metaplex x402 将 HTTP 的 402 Payment Required 状态转变为机器可支付的流程：您的应用照常调用端点，服务端返回带有支付要求的 402，客户端对一笔 USDC 支付签名并重试，服务端在 Solana 上结算后返回响应。该服务由链上 Metaplex Agent Mech 运营。

• 三项服务 — OpenAI 兼容的聊天补全、OpenAI 兼容的图像生成，以及支持 DAS 透传的 Solana JSON-RPC
• 三种支付模式 — 标准钱包、Core 资产或 Agent 直接支付，以及无需逐次签名即可支付的委托 Agent
• USDC 结算 — 支付来自经典 SPL Token 的关联代币账户，不支持 Token-2022 支付铸币
• 开源客户端 — @metaplex-foundation/x402 采用 Apache-2.0 许可，附带 12 个可运行示例；托管服务端未公开

Metaplex x402 提供的服务

Metaplex x402 在单一基础 URL https://api.metaplex.com/x402 下提供三项付费服务和两个免费的发现端点。

聊天和图像端点使用标准的 OpenAI 传输格式，因此任何 OpenAI 兼容客户端只需修改 baseURL 并提供支持支付的 fetch 即可工作。请求与响应的完整细节见 API 参考。

Mech：运营 Metaplex x402 的 Agent

Mech 是销售 x402 服务的链上 Metaplex Agent，USDC 支付会结算到 Mech 的 Core 钱包。Mech 本身也是一个拥有 Asset Signer PDA 钱包的已注册 Agent — 即一个 Agent 向您的 Agent 销售服务，这正是Agent 商业模式端到端运转的样子。

快速开始

安装客户端，并用支持支付的 fetch 将 OpenAI SDK 指向 Metaplex x402。本示例使用标准钱包支付；三种模式的完整说明见支付模式指南。

pnpm add @metaplex-foundation/x402 \
  @metaplex-foundation/umi \
  @solana/kit \
  @x402/core \
  @x402/fetch \
  @x402/svm \
  openai

import { METAPLEX_X402_BASE_URL } from '@metaplex-foundation/x402';
import { createKeyPairSignerFromBytes, getBase58Encoder } from '@solana/kit';
import { x402Client } from '@x402/core/client';
import { wrapFetchWithPayment } from '@x402/fetch';
import { ExactSvmScheme } from '@x402/svm/exact/client';
import OpenAI from 'openai';

// A Solana signer whose token account holds USDC.
const svmSigner = await createKeyPairSignerFromBytes(
  getBase58Encoder().encode(process.env.SVM_PRIVATE_KEY!),
);

const paymentClient = new x402Client();
paymentClient.register('solana:*', new ExactSvmScheme(svmSigner));

const openai = new OpenAI({
  // The OpenAI SDK requires a value, but this gateway authenticates by payment.
  apiKey: 'x402',
  baseURL: METAPLEX_X402_BASE_URL,
  fetch: wrapFetchWithPayment(fetch, paymentClient),
});

const completion = await openai.chat.completions.create({
  model: 'openai/gpt-5.4-mini',
  messages: [{ role: 'user', content: 'Say hi in one word.' }],
});

支付在被包装的 fetch 内部完成；您的代码只会看到最终的 API 响应。

支付模式一览

Metaplex x402 支持三种支付方式，区别在于 USDC 的来源以及所有者签名的频率。

委托是一项可随时撤销的链上授权。各模式的设置、代码和撤销流程见支付模式指南。

Metaplex x402 如何为请求定价

Metaplex x402 按上游提供商的 token 费率为推理定价，按请求为 RPC 定价，并在 GET /x402/pricing 免费公开最新价目表。

• 聊天补全 — 按每百万 token 计价，输入、缓存输入和输出各有独立费率，并适用每次请求 $0.001 的最低金额
• 图像生成 — 按输入文本、输入图像、输出图像和输出文本四类，每百万 token 计价，同样适用 $0.001 的最低金额
• Solana RPC — 默认每次请求 $0.00001，getSignaturesForAddress 等较重的方法费率更高，为 $0.0001

注意事项

• 支付以 USDC 从经典 SPL Token 的关联代币账户结算。目前不支持 Token-2022 支付铸币。
• Core 资产和 Agent 支付模式需要在资产签名者 PDA 中保留少量 SOL，用于支付 Core execute 的交易费用。标准钱包支付无需 SOL — 网络费用由服务方的费用支付者承担。
• x402 的 RPC 端点仅支持 HTTP 请求。不支持 WebSocket 连接和订阅。
• 托管服务端不是开源的。客户端、示例和协议类型以 Apache-2.0 发布。
• 使用本服务即表示同意 Metaplex.com 使用条款和隐私政策。

快速参考

FAQ

关于 Metaplex x402 的常见问题。

什么是 Metaplex x402？

Metaplex x402 是一个按请求付费的 HTTP API，销售 LLM 推理、图像生成和 Solana RPC 访问。无需 API 密钥、账户或订阅 — 每个请求都通过 x402 协议在 Solana 上以 USDC 结算。x402 将 HTTP 的 402 Payment Required 状态转变为机器可支付的流程。

使用 Metaplex x402 需要 API 密钥或账户吗？

不需要。支付即认证。您只需要一个持有 USDC 的 Solana 钱包、Core 资产或已注册的 Agent。OpenAI SDK 要求 apiKey 为非空值，因此示例传入字符串 'x402'，网关会忽略该值。

什么是 Mech？

Mech 是运营 x402 服务的链上 Metaplex Agent。支付以 USDC 结算到 Mech 的 Core 钱包 — 即其 Asset Signer PDA。Mech 是一个向您的 Agent 或钱包销售服务的 Agent，地址为 MECHjj31U1hBapoVeJtZo5U5WGRd2293JEwRErvPTuF。

Nori 服务 Agent 的文档怎么了？

Nori 页面描述的是一个从未公开发布、目前也不再维护的早期原型。取代它并实际上线的服务是 Metaplex x402。Nori 这个名称现在指的是 Metaplex AI 副驾驶，那是一个与付费推理和 RPC 无关的独立产品。

Metaplex x402 是以 SOL 还是 USDC 计费？

USDC。支付来自经典 SPL Token 的关联代币账户，不支持 Token-2022 支付铸币。Core 资产和 Agent 支付模式还需要在资产签名者 PDA 中保留少量 SOL，用于支付 Core execute 的交易费用。

Metaplex x402 的服务端是开源的吗？

客户端是开源的。TypeScript 客户端、示例和协议类型以 Apache-2.0 发布在 github.com/metaplex-foundation/x402。运行托管服务的服务端目前未公开。

一次请求的费用是多少？

推理定价与上游提供商的 token 费率一致，并适用每次请求 $0.001 的最低金额。RPC 调用按请求计费，起价 $0.00001，较重的方法费率更高。GET /x402/pricing 返回最新费率，可免费调用。

术语表

Metaplex x402 文档中使用的术语。

由 Metaplex Foundation 维护。最后验证日期：2026-09-08。客户端版本：@metaplex-foundation/x402 0.1.0。在 GitHub 上查看源码。