常见问题

xmAI 与直接调用 OpenAI/Anthropic/Google 有什么区别？

xmAI 提供统一的 API，让你通过一个端点和一个 API Key 访问多家供应商（OpenAI、Anthropic、Google 等）的模型。优势包括：

• 一个 API，多种模型 — 无需为每个供应商单独管理账号和密钥
• 成本优势 — 按量付费，价格有竞争力
• 高可用 — 多通道自动故障转移
• OpenAI 兼容 — 使用标准 OpenAI SDK，零代码改动

如何从 OpenAI 迁移到 xmAI？

只需修改一行代码，更新 OpenAI SDK 配置中的 base_url：

Python

# 之前（直接调用 OpenAI）
client = OpenAI(api_key="sk-openai-key")

# 之后（使用 xmAI）
client = OpenAI(
    api_key="sk-your-xmai-key",
    base_url="https://api.xmai.sg/v1",
)

Node.js

// 之前（直接调用 OpenAI）
const client = new OpenAI({ apiKey: 'sk-openai-key' })

// 之后（使用 xmAI）
const client = new OpenAI({
  apiKey: 'sk-your-xmai-key',
  baseURL: 'https://api.xmai.sg/v1',
})

你现有的所有代码 — 模型参数、消息格式、流式输出 — 完全不变。

使用 Claude Code / OpenCode / Codex 等 CLI？参考 集成指南 查看分步说明。

支持哪些模型？

xmAI 支持来自 OpenAI、Anthropic、Google 等多家供应商的模型。访问 模型页面 查看完整列表和实时定价。

如何查看余额和用量？

登录 XmAI 控制台 可查看：

• 余额 — 当前账户余额
• 用量 — 请求历史和费用明细
• 充值 — 通过信用卡充值（由 Airwallex 提供支付服务）

API Key 丢失怎么办？

API Key 仅在创建时显示一次。如果丢失了密钥：

1. 登录 控制台
2. 撤销丢失的密钥（防止未授权使用）
3. 创建新密钥
4. 在应用中更新为新密钥

请求失败如何排查？

1. 查看错误响应 — type 字段会告诉你出了什么问题。详见 错误码。
2. 验证 API Key — 确保密钥有效，且已包含在 Authorization: Bearer 请求头中。
3. 检查余额 — 402 错误表示需要充值。
4. 检查频率限制 — 429 错误表示请求过于频繁，请实现退避重试。
5. 尝试其他模型 — 503 错误表示模型暂时不可用，可以尝试其他模型。
6. 检查请求格式 — 确保请求体符合 API 参考 的格式要求。