云服务 XAI Control 上手
XAI Control 可以简单理解为:您专属的、免部署的、功能强大的 AI 路由。
它如同您自己购买了一台海外主机并搭建了完整的 XAI Router 服务,但省去了所有复杂的开发和运维工作。
- 您的密钥,您做主:将 Deepseek、OpenAI、Anthropic 等官方 API Key 添加到您的加密空间,XAI Control 负责调用。密钥所有权和控制权始终在您手中,全程零信任加密,安全无忧
- 一个入口,通所有模型:无需为不同模型维护不同代码,所有请求通过
api.xaicontrol.com统一入口,由 XAI Router 智能路由至后端服务商 - 开箱即用,功能完备:无需关心负载均衡、故障切换、密钥轮换等问题,同时获得强大的子账户管理、成本控制和安全防护能力
本文档将引导您快速启用这台为您预置好的「专属 AI 路由」。
1. 注册账号
- 打开浏览器,访问 a.xaicontrol.com
- 点击**「立即注册」,输入常用邮箱,点击「发送验证码」**
- 登录邮箱,找到主题为 「Your XAI Verification Code」 的邮件(注意:邮件可能被误判为垃圾邮件,请一并检查垃圾箱)
- 点击邮件中的**「点击激活账户」**按钮,页面将跳转回 XAI Control 并提示激活成功
- 激活成功后,系统自动向同一邮箱再发送一封主题为 「Welcome to XAI - Your Account is Ready!」 的邮件,内含您的专属 XAI API Key
2. 新增 Provider Key
- 登录 a.xaicontrol.com
- 进入**「模型服务商」** → 「新增 Provider Key」
- 填写:
- Name(可选):自定义名称,便于管理
- Level:模型分组归类,填写任意正整数
- Provider:模型服务商的 API Base URL,例如:
- OpenAI:
https://api.openai.com - Anthropic:
https://api.anthropic.com - DeepSeek:
https://api.deepseek.com - Google Gemini:
https://generativelanguage.googleapis.com - 智谱 AI:
https://open.bigmodel.cn/api/anthropic - Kimi AI:
https://api.moonshot.cn/anthropic
- OpenAI:
- SecretKey:对应服务商的 API Key,通常为
sk-开头(Google Gemini 为AIzaSy开头)
- 点击**「添加 Provider Key」**,系统将加密存储该密钥至您的专属数据空间

3. 快速测试
完成上述步骤后,即可使用您的 XAI API Key 调用已接入的 AI 服务。
重要前提
以下示例展示了如何分别调用 OpenAI 和 Anthropic 的模型。请确保您已在第 2 步中为想要测试的模型服务商(如 OpenAI、Anthropic)添加了对应的 Provider Key。若仅添加了 OpenAI 的 Key,则 Anthropic 调用示例将无法成功。
调用 OpenAI 模型
export XAI_API_KEY="你的XAI-API-Key"
curl https://api.xaicontrol.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $XAI_API_KEY" \
-d '{
"model": "gpt-4o-mini",
"messages": [{"role": "user", "content": "Hello, world"}]
}'
调用 Anthropic 模型
export XAI_API_KEY="你的XAI-API-Key"
curl https://api.xaicontrol.com/v1/messages \
-H "x-api-key: $XAI_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-3-7-sonnet-latest",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello, world"}]
}'
4. 子账户管理(精细化权限与额度控制)
XAI Control 支持多级子账户体系,便于团队或客户隔离资源、独立计费。
请特别注意 XAI Control 有两个管理入口:
- 配置管理入口:a.xaicontrol.com(注册用户为一级主账户,在此配置管理第三方 AI Provider Key 资源)
- 账户管理入口:m.xaicontrol.com(主账户在此管理子账户、额度;子账户在此查看自身用量)
4.1 创建子账户
- 主账户登录 m.xaicontrol.com,进入**「创建子账户」**选项页面
- 填写:
- 子账户用户名
- 子账户邮箱(系统将发送子账户 XAI API Key 到该邮箱)
- 初始额度
- 点击**「创建子账户」**

4.2 配置子账户权限与额度
点击**「更新子账户」**,可精细化控制:
| 配置项 | 说明 | 示例 |
|---|---|---|
| 额度上限 | 子账户可消耗的最大金额(USD) | 100.00 |
| 模型白名单 | 允许调用的模型列表 | ["gpt-4o-mini", "claude-3-7-sonnet-latest"] |
| RPM 限制 | 每分钟最大请求数 | 60 |
| TPM 限制 | 每分钟最大 Token 数 | 100000 |
| IP 白名单 | 仅允许指定 IP 调用(留空为不限制) | ["203.0.113.0/24"] |

4.3 子账户登录
子账户使用独立 XAI API Key 登录 m.xaicontrol.com,仅能看到:
- 自己的用量与剩余额度
- 无法查看或修改主账户的 AI Provider Key
5. 为什么选择 XAI?
| 特性 | 说明 |
|---|---|
| 统一入口 | 所有模型调用统一走 api.xaicontrol.com,智能调度至最优上游 |
| 密钥轮换 | 可添加多个上游密钥,实时监测健康状态,自动轮询、休眠与恢复,避免单点限速 |
| 故障切换 | 上游异常(429/5xx)毫秒级熔断,自动重试并切换节点,业务完全无感知 |
| 模型映射 | 支持别名映射(如 gpt-3.5-turbo=gpt-4o-mini),存量代码无需改动即可升级 |
| 极致兼容 | 原生兼容 OpenAI/Anthropic API,仅需替换 base_url 和 api_key |
| 零信任安全 | 端到端加密存储,无超级管理员,数据仅用户私钥可解密,杜绝泄露风险 |
| 强大账户体系 | 灵活的多级子账户管理,可为团队成员或客户创建独立子账户,精细控制费率、额度、速率限制(RPM/TPM)和可用模型 |