sub2api 教程中心

这是我们最推荐的无感接入方式。你不必四处寻找文本框也不用理解什么叫 BaseURL，只要一键点击就好。

• 环境准备

  请确保你的设备安装了 CC-Switch (点击获取下载) 客户端，并且确保在后台正常运行中。

• 创建具备明确分组权限的密钥

  在开始前，请先进入我们控制台的 API 密钥 页面。点击界面左上角的【添加新密钥 / 创建密钥】，务必在弹窗中为您将要生成的新接口提供合适的分组（决定了您能使用哪种模型组合）。

• 执行一键同步

  在创建完毕并属于你的 API Keys 信息列表旁边，找到 【导入到 CCS】 按钮并按下。此时浏览器会自动唤醒并在你的 CC-Switch 面板中一秒注册完毕。

• 插件穿透与聊天直连

  CCS 能自动反向将我们的接口数据推送到你在用的类似 VSCode Cline、Continue、Codex 等第三方生产力插件中。一切都在静默中丝滑生效。完成配置后，请务必重启编辑器 / 重新打开插件以绝对应用最新的配置。

• 原理解构与异常恢复 (非常重要)

  CC-Switch 的核心底层原理是自动为您修改并代理相关插件的 config.toml 或类似的独立配置文件。如果您后续想恢复原来的旧设置或彻底清理隔离，只需前往编辑器里对应插件存放配置的目录下，找到该配置文件直接删除或手动涂改即可。
  
  ⚠️ 记录如何找回与究极破局思路：切换接口可能会导致插件机制变动而让您觉得“以前记录不见了”。别慌，记录本身全盘存在您的电脑本地，不主动删除就永远不可能消失！
  🔑 找回动作：点开 CC-Switch 客户端，在右上角点击【会话管理】按钮。里面留存了所有过往记录，找到你想恢复的那条，直接复制它后面专用的唤醒代码（长得类似这样：codex resume 019d420d-a0e1-76e3-bc5d-f6b647e8325d），在编辑器插件命令行里执行这串代码即可断点接续！
  如果上面这套行不通，发挥最强战力吧：把你的异状或这段 resume 代码喂给 Codex 或豆包等 AI，甩手让大模型直接手把手教你在当前版本下怎样敲脚本抢救回来！

Cherry Studio 是当下最为流行的桌面本地端，能将你所有的 GPT 归集一处管理。设置极其简单，请打开软件跟我一步步“照葫芦画瓢”。

• 找到入口

  在 Cherry Studio 界面左下角点击 ⚙️设置图标，在弹出侧边栏点击 【提供商】(Providers)，然后点击右上角的 ➕添加自定义提供商。

• 类型严格选取

  在弹出的提供商类型选择中，请 **务必** 选择 OpenAI 或 OpenAI Compatible (OpenAI 兼容协议)。我们的接口全程对齐此国际主干道协议。

• 见招拆招：对照填写如下表单

  请将下方深色区域对应的文本无脑复制并贴在你的 Cherry Studio 界面表单中：

  模拟的 Cherry Studio 设置表单界面

  名称 (Name) :

  sub2api

  复制

  API 根地址 :

  https://api.xxxaicode.com/v1

  复制

  API 密钥 (Key) :

  sk-你的真实API-Key

  ----

  避坑指南：API 根地址务必携带 /v1 后缀。如果你发现点刷新拉取不到模型列表，请检查你的网络环境是否拦截请求，最后核对上方的复制文本里面绝对不能含有不小心多加的空格！

网页版的双霸天软件，操作非常类似。只需要重定向 OpenAI 官方的 API 域名到我们这里即可使用。

• 进入设置

  在左下角点击打开【设置】（LobeChat）或【设置 -> 语言模型 -> OpenAI】（NextChat）。

• 填写自定义地址

  打开【自定义接口地址】或【使用代理地址】开关。

  网页端配置项目

  接口代理地址 :

  https://api.xxxaicode.com/v1

  复制

  API Key :

  sk-你的真实API-Key

  ----

  💡 温馨提示：输入这行链接后，如果遇到 404，在 LobeChat 下也可不带 `/v1`，直接填写 `https://api.xxxaicode.com` 后点击保存即可测通连通性。

利用极其便宜的 GPT 模型帮你做网页双语对照翻译的神级插件。消耗 Token 极大，对接我们是降本奇招。

• 定位设置项

  鼠标点击浏览器右上角的【沉浸式翻译】插件图标打开面板 -> 单击左下角【设置】 -> 点击左侧导航【翻译服务】 -> 在服务列表中选择 OpenAI。

• 非常特殊的填写要求

  注意！因为沉浸式插件内置底层请求逻辑的特殊性，它强迫您填写包含最尾端 /chat/completions 的完整端点。请完全参照下表填写：

  请点击左下角按钮展开【更多设置项】后填写

  自定义 API URL :

  https://api.xxxaicode.com/v1/chat/completions

  复制

  API Key :

  sk-你的API-Key

  ----

  自定义模型名字 :

  gpt-5.4-mini

  复制

OpenClaw 是现在最潮的个人 AI 助理框架。跟着指令复制粘贴 3 步起飞！

• 终端执行安装 (推荐 Node 24 环境)

  在你的电脑终端窗口原封不动敲打下边命令（安装过则跳过）：
  npx @openclaw/cli onboard
  碰到系统询问回答 y 或摁下回车耐心等待即可。

• 直接替换配置文件

  使用记事本打开 ~/.openclaw/openclaw.json 文件。把下面的完整片段强行粘进你的 Providers 配置位置里即可。这已经排除了因为名字前缀带来的识别错误，它是一个极度标准的 OpenAI JSON体！
  🚨 关键阻断警报：复制下方代码块粘贴后，请绝对务必要把 "sk-你的-sub2api-key" 这串占位字符，自行修改成你系统里真正拿到的 API 秘钥，否则百分之百会报错！

  ~/.openclaw/openclaw.json 标准覆盖方案 复制整个片段

  {
    "agents": {
      "models": {
        "providers": {
          "openai": {
            "api": "openai-completions",
            "baseUrl": "https://api.xxxaicode.com/v1",
            "apiKey": "sk-你的-sub2api-key",
            "models": [
              { "id": "gpt-5.4", "contextWindow": 128000 }
            ]
          }
        }
      },
      "defaults": {
        "model": {
          "primary": "gpt-5.4"
        }
      }
    }
  }

• 重启与享用

  在终端打入 openclaw gateway restart，然后大摇大摆关掉终端窗口，你已经在 AI 超车道上了。

在 Cursor 和 VSCode 等旗舰级代码编辑器中，我们主推全量使用 **Codex 插件**。因为它可以跟 CC-Switch 完美打通结对，让你不需要每次都陷入手动修改底层参数的泥潭！

• 利用 CCS 自动下盘

  参考顶部的 CC-Switch 教程，当您点击了网站上的“一键导入”之后，CC-Switch 已经神不知鬼不觉地为您把本地电脑里 Codex 的 config.toml 配置文件改成了正确的地址和您的秘钥。

• 退出并重启编辑器 (极其关键)

  很多人配置完了说不生效，因为编辑器还保留着热缓存！请完全退出您的 VSCode 或 Cursor，然后重新打开。重启之后，插件就会顺理成章地装载最新的模型通道，满血开始工作。

• 手工检查防呆（可选）

  如果你信不过自动配置流，或者依然没有反应，你可以手动点开 Codex 插件的高级设置，确保它指向了 https://api.xxxaicode.com/v1 并且使用了正确的我们的 Key。

自己编写爬虫、分析统计程序？完全脱离开 UI 界面的限制！你仅需要给官方的连接库强行写入一个 base_url 环境变量覆写指令。

• Python 环境方案

  from openai import OpenAI
  
  # 第一步就是最核心的操作！
  client = OpenAI(
      api_key="sk-你的真实API-Key",
      base_url="https://api.xxxaicode.com/v1" 
  )
  
  # 剩下的调用一切照旧，不用修改
  response = client.chat.completions.create(
      model="gpt-5.4",
      messages=[
          {"role": "user", "content": "写一个贪吃蛇游戏"}
      ]
  )
  print(response.choices[0].message.content)

• Node.js 环境方案

  import OpenAI from 'openai';
  
  // 初始化客户端时加上 baseURL
  const openai = new OpenAI({
      apiKey: 'sk-你的真实API-Key',
      baseURL: 'https://api.xxxaicode.com/v1',
  });
  
  async function main() {
      const chatCompletion = await openai.chat.completions.create({
          messages: [{ role: 'user', content: 'Say hello to sub2api' }],
          model: 'gpt-5.4',
      });
      console.log(chatCompletion.choices[0].message.content);
  }
  main();

我们专注深耕完全对齐 OpenAI 协议的高端模型。您能使用的模型取决于当前 Key 绑定的确切套餐。目前提供的模型如下表，可以直接复制填入任意上述客户端即可调用：