Rust Core

XAI Control 可以简单理解为:您专属的、免部署的、功能强大的 AI 路由

它如同您自己购买了一台海外主机并搭建了完整的 XAI Router 服务,但省去了所有复杂的开发和运维工作。

  • 您的密钥,您做主:将 Deepseek、OpenAI、Anthropic 等官方 API Key 添加到您的加密空间,XAI Control 负责调用。密钥所有权和控制权始终在您手中,全程零信任加密,安全无忧
  • 一个入口,通所有模型:无需为不同模型维护不同代码,所有请求通过 api.xaicontrol.com 统一入口,由 XAI Router 智能路由至后端服务商
  • 开箱即用,功能完备:无需关心负载均衡、故障切换、密钥轮换等问题,同时获得强大的子账户管理、成本控制和安全防护能力

本文档将引导您快速启用这台为您预置好的「专属 AI 路由」。


1. 注册账号

  1. 打开浏览器,访问 a.xaicontrol.com
  2. 点击**「立即注册」,输入常用邮箱,点击「发送验证码」**
  3. 登录邮箱,找到主题为 「Your XAI Verification Code」 的邮件(注意:邮件可能被误判为垃圾邮件,请一并检查垃圾箱)
  4. 点击邮件中的**「点击激活账户」**按钮,页面将跳转回 XAI Control 并提示激活成功
  5. 激活成功后,系统自动向同一邮箱再发送一封主题为 「Welcome to XAI - Your Account is Ready!」 的邮件,内含您的专属 XAI API Key

2. 新增 Provider Key

  1. 登录 a.xaicontrol.com
  2. 进入**「模型服务商」** → 「新增 Provider Key」
  3. 填写:
    • 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
    • SecretKey:对应服务商的 API Key,通常为 sk- 开头(Google Gemini 为 AIzaSy 开头)
  4. 点击**「添加 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 有两个管理入口:

  1. 配置管理入口a.xaicontrol.com(注册用户为一级主账户,在此配置管理第三方 AI Provider Key 资源)
  2. 账户管理入口m.xaicontrol.com(主账户在此管理子账户、额度;子账户在此查看自身用量)

4.1 创建子账户

  1. 主账户登录 m.xaicontrol.com,进入**「创建子账户」**选项页面
  2. 填写:
    • 子账户用户名
    • 子账户邮箱(系统将发送子账户 XAI API Key 到该邮箱)
    • 初始额度
  3. 点击**「创建子账户」**

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_urlapi_key
零信任安全端到端加密存储,无超级管理员,数据仅用户私钥可解密,杜绝泄露风险
强大账户体系灵活的多级子账户管理,可为团队成员或客户创建独立子账户,精细控制费率、额度、速率限制(RPM/TPM)和可用模型