云服务 XAI Control 上手

本文档将带你一步步完成 XAI Control 云服务的注册、API Key 获取，以及子账户的精细化管理，帮助你快速上手。

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
   • 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 配置子账户权限与额度

点击 「更新子账户」，可精细化控制：

4.3 子账户登录

子账户使用独立 XAI API Key 登录 m.xaicontrol.com，仅能看到：

• 自己的用量与剩余额度
• 无法查看或修改主账户的 AI Provider Key

5. 为什么选择 XAI？