从注册到第一次 API 调用

开始前准备

• 使用本站正式域名完成注册和登录，不要通过第三方页面提交账号或 API Key。
• 准备一台可以运行 curl 或兼容 SDK 的电脑。
• 充值、模型、分组和支付方式均以控制台与模型广场当前展示为准。

完成六个步骤

1. 注册并登录

打开注册页，阅读页面当时展示的服务条款与政策，按页面要求完成注册。随后从登录页进入控制台。

2. 充值余额

登录后进入充值页，只使用页面当前展示的站内支付入口。支付后在订单页核对订单状态和余额变化，不要向站外账户、个人收款码或临时链接付款。

3. 创建 API Key

进入API Key 管理创建 Key，并为它选择与目标协议和模型匹配的当前分组。一把 Key 绑定一个分组；同一分组内通常通过请求中的 model 字段切换模型。

4. 选择当前模型

从模型广场确认模型属于该 Key 的分组，并复制当前模型标识。教程不固定模型数量或价格，因为这些信息可能调整。

5. 发送第一次请求

下面以 OpenAI 兼容的 Chat Completions 为例。先将占位符替换为你自己的 Key 和模型标识，并让 Key 只存在于本机环境变量或服务端密钥管理中。

export XIAMA_API_KEY="<XIAMA_API_KEY>"

curl https://api.xmapi.me/v1/chat/completions \
  -H "Authorization: Bearer $XIAMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<MODEL_ID>",
    "messages": [
      {"role": "user", "content": "用一句话介绍 API 网关"}
    ],
    "stream": false
  }'

使用 Anthropic Messages 请求格式时，请改看Anthropic Messages 接入。具体客户端配置优先使用 Key 列表中的“使用密钥”指引。

6. 核对用量与费用

请求成功后打开用量页，按 Key、模型、分组或时间筛选记录，核对请求用量和费用。只想查询某一把 Key 时，也可以使用本站的公开 API Key 用量查询页。

成功标志

• 客户端收到结构正确的 API 响应，而不是登录页或 HTML 页面。
• 控制台用量记录中出现对应时间、Key、模型和费用信息。
• 余额变化与该条用量记录相互对应；具体单价以模型广场和最终账单为准。

常见问题

返回 401 怎么办？

检查请求是否使用 Authorization: Bearer <API_KEY>、Key 是否完整且仍处于可用状态。怀疑泄露时立即停用并重新创建，不要把完整 Key 发给支持人员。

返回 400 或 404 怎么办？

检查端点、请求体和模型标识，并确认模型属于 Key 所绑定的分组。不要从过期教程复制模型名。

返回 403 或 429 怎么办？

检查账户余额、Key 额度、有效期、限速和 IP 限制，并以响应体的错误信息为准。更多方法见错误与计费核对。