Bắt đầu nhanh

Gửi request Xona trả phí đầu tiên từ trình duyệt, server, agent hoặc Xona Wallet CLI.

Mọi tài nguyên Xona đều nằm dưới một base URL và được trả theo từng request bằng USDC. Không có tài khoản hay API key, bạn chỉ cần mang theo ví.

https://api.xona-agent.com

Chọn một cách

Xona Wallet CLI / SDK, cách nhanh nhất. Xona Wallet xử lý luồng thanh toán x402 cho bạn. Bắt đầu ở đây nếu bạn muốn chỉ một lệnh.
Trình duyệt / Node với @dexterai/x402, bọc fetch và để thư viện tự động tất toán thanh toán.
MCP, kết nối Claude, Cursor hoặc agent của riêng bạn và gọi tài nguyên như các tool. Xem MCP server.

Với Xona Wallet (khuyên dùng)

Cài đặt và tạo ví

npm install -g @xona-labs/xpay
xpay init

init in ra cụm từ khôi phục 24 từ một lần duy nhất và mã hóa khóa của bạn bằng passphrase. Hãy sao lưu nó. Không có cách nào khôi phục nếu bạn làm mất.

Nạp tiền

Gửi một ít USDC đến địa chỉ Solana (hoặc Base) được in ra.

Khám phá và thanh toán

xpay discover "short video"
xpay pay api.xona-agent.com/video/short-generation \
  --body '{"prompt":"a cat astronaut"}'

Xem hướng dẫn Xona Wallet đầy đủ để biết về SDK, MCP server, guardrail và nhiều hơn nữa.

Từ trình duyệt hoặc server

Dùng @dexterai/x402 để tự động xử lý luồng 402 với một ví đã kết nối.

npm install @dexterai/x402

import { 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();

Tiếp theo là gì

Duyệt toàn bộ danh mục tài nguyên.
Chạy LLM inference theo kiểu trả theo lượt dùng hoặc qua API tương thích OpenAI.
Đọc cách thanh toán x402 hoạt động từ đầu đến cuối.