把 AI XHub API 接入你常用的 AI 工具

优先使用下面的国内加速直链下载。如果链接不可用，再使用官方 Release 页或联系客服获取网盘中转包。

CC-Switch

Codex 桌面版

推荐新用户先走这条路线：安装软件、创建密钥、一键导入、重启工具。下面每一步都配了按钮标注。

1

下载并打开 CC-Switch

先在“软件下载”里下载 CC-Switch。Windows 选 MSI，macOS 选 DMG。安装后打开软件，保持它在后台运行。

• 看不懂芯片型号时，Windows 大多数选 x64。
• macOS 的 DMG 同时支持 M 系列和 Intel。

1. 1Windows 用户点击“下载 MSI”。如果公司电脑不能安装软件，再选便携版 ZIP。
2. 2macOS 用户点击“下载 DMG”，这个安装包同时支持 M 系列芯片和 Intel 芯片。

1

2

2

进入 AI XHub API 控制台的 API 密钥页面

打开控制台后，先点击左侧“API 密钥”。密钥就像门禁卡，用来让软件访问你的 AI XHub API 额度。

• 如果现在在“仪表盘”，先点左侧菜单切换过去。
• 右侧卡片里的 API 密钥数量也能帮你确认当前有没有密钥。

1. 1在左侧菜单点击“API 密钥”，进入密钥管理页面。
2. 2右侧卡片会显示当前已有多少个 API 密钥，新用户这里通常是 0。

1

2

3

点击“创建密钥”

进入 API 密钥页面后，点击右上角或空列表中间的“创建密钥”。创建时选择你要使用的分组。

• 密钥只展示一次，创建后先不要关闭页面。
• 如果有多个分组，选择你要用的那一个。

1. 1填写一个容易辨认的密钥名称。
2. 2选择需要使用的分组，然后点击“创建”。

1

2

4

导入到 CCS，然后重启工具

密钥创建成功后会出现在列表里。找到这一行，在右侧“操作”里点击“导入到 CCS”，然后完全退出 Codex、Cursor、VSCode 或相关插件，再重新打开。

• 如果浏览器询问是否打开 CC-Switch，选择允许。
• 确认 CC-Switch 已经打开，否则导入可能没有反应。

1. 1先看最右侧“操作”这一列，密钥相关按钮都在这里。
2. 2点击“导入到 CCS”，然后按提示允许浏览器打开 CC-Switch。

1

2

1. 打开 Cherry Studio 左下角设置。
2. 进入 提供商，添加自定义提供商。
3. 类型选择 OpenAI 或 OpenAI Compatible。
4. 按下面字段填写。

这类网页客户端一般都支持自定义 OpenAI 接口地址。

1. 进入客户端设置里的 OpenAI 或语言模型配置。
2. 打开自定义接口地址、代理地址或 Base URL 选项。
3. 填写 AI XHub API 根地址和你的 API Key。

1. 打开浏览器扩展的设置。
2. 进入翻译服务，选择 OpenAI。
3. 展开更多设置，填写完整的 Chat Completions 地址。

OpenClaw 可通过 OpenAI 兼容 provider 接入 AI XHub API。

1. 确认已安装 OpenClaw，并完成初始化。
2. 打开 ~/.openclaw/openclaw.json。
3. 把 provider 的 baseUrl 和 apiKey 改为 AI XHub API。
4. 运行 openclaw gateway restart。

{
  "agents": {
    "models": {
      "providers": {
        "aixhub": {
          "api": "openai-completions",
          "baseUrl": "https://api.aixhub.vip/v1",
          "apiKey": "sk-你的 AI XHub API Key",
          "headers": {
            "User-Agent": "OpenClaw/JS"
          },
          "models": [
            { "id": "gpt-5.4", "contextWindow": 128000 }
          ]
        }
      }
    },
    "defaults": {
      "model": {
        "primary": "aixhub/gpt-5.4"
      }
    }
  }
}

如果你使用 CC-Switch，一键导入后通常不需要再手动编辑 Codex 配置。未安装 Codex 时，先按系统下载 Codex 桌面版。

1. 通过 AI XHub API 控制台的 导入到 CCS 写入配置。
2. 完全退出 Cursor 或 VSCode。
3. 重新打开编辑器和插件。
4. 如果仍未生效，检查插件设置里的 Base URL 是否为 AI XHub API 地址。

Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的 AI XHub API Key",
    base_url="https://api.aixhub.vip/v1",
)

response = client.chat.completions.create(
    model="gpt-5.4-mini",
    messages=[
        {"role": "user", "content": "用一句话介绍 AI XHub API"}
    ],
)

print(response.choices[0].message.content)

Node.js

import OpenAI from "openai";

const openai = new OpenAI({
  apiKey: "sk-你的 AI XHub API Key",
  baseURL: "https://api.aixhub.vip/v1",
});

const completion = await openai.chat.completions.create({
  model: "gpt-5.4-mini",
  messages: [{ role: "user", content: "Say hello to AI XHub API" }],
});

console.log(completion.choices[0].message.content);

可用模型由你的 API Key 分组决定。控制台能看到的模型才是最终可用模型。

请求 401 或无权限

通常是 API Key 填错、Key 被删除、复制时带了空格，或 Bearer 前缀重复。

请求 404

大多数客户端应该填写 https://api.aixhub.vip/v1。少数客户端会自动补 /v1，此时可尝试填写 https://api.aixhub.vip。

模型不可用

检查 API Key 所属分组是否包含该模型；如果分组没有绑定对应账号或账号异常，也会导致模型无法调度。

配置后不生效

完全退出客户端和编辑器后重新打开。很多插件会缓存旧配置，只刷新页面不一定生效。