Xona Docs快速开始
从浏览器、服务器、智能体或 Xona Wallet CLI 发出你的第一个 Xona 付费请求。
所有 Xona 资源都位于同一个基础 URL 下，并按请求以 USDC 付费。无需账户或 API key，只需自备钱包。
https://api.xona-agent.com选择一种方式
- Xona Wallet CLI / SDK，最快的方式。Xona Wallet 会替你处理 x402 支付流程。如果你只想用一条命令，从这里开始。
- 在浏览器 / Node 中使用
@dexterai/x402，封装fetch，让库自动结算付款。 - MCP，连接 Claude、Cursor 或你自己的智能体，把资源当作工具调用。参见 MCP 服务器。
使用 Xona Wallet（推荐）
充值
向打印出的 Solana（或 Base）地址转入少量 USDC。
发现并付费
xpay discover "short video"
xpay pay api.xona-agent.com/video/short-generation \
--body '{"prompt":"a cat astronaut"}'完整的 SDK、MCP 服务器、防护规则等内容请参阅 Xona Wallet 指南。
从浏览器或服务器调用
使用 @dexterai/x402，配合已连接的钱包自动处理 402 流程。
npm install @dexterai/x402import { wrapFetch } from "@dexterai/x402/client";
const x402Fetch = wrapFetch(fetch, {
walletPrivateKey: process.env.SOLANA_PRIVATE_KEY,
});
// Hit any Xona resource, payment is handled automatically
const res = await x402Fetch("https://api.xona-agent.com/image/designer", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ prompt: "A cyberpunk cityscape at sunset" }),
});
const { image_url } = await res.json();