S Skye API 文档

CC Switch 一键配置

CC Switch 是一个桌面端配置管理工具,可以统一管理 AI 编程工具的供应商配置。 Skye API 基于 NewAPI,控制台里支持一键生成 Codex 的 CCS 配置,比手动改 JSON、TOML 更快,也更不容易填错。

目前 Skye API 只有 GPT 系列模型,所以只提供 Codex 的一键配置功能;其他软件可以参考通用配置自行摸索。 如果你还没有安装 CC Switch,可以先前往 CC Switch 下载页面 获取对应系统的安装包。

推荐方式:控制台一键配置 CCS

  1. 打开 Skye API 控制台 并登录账号。
  2. 进入 API Key 或令牌管理页面,创建一个可用的 API Key。
  3. 在密钥列表右侧点击聊天或配置下拉菜单,选择 CC Switch
  4. 弹窗中选择 Codex,再选择你要使用的 GPT 模型并确认。
  5. 浏览器弹出“要打开 CC Switch 吗?”时,点击 打开 CC Switch 完成导入。
  6. 回到 CC Switch 后确认配置已写入,然后打开 Codex 发送一个简单问题测试。

步骤 1:点击 CC Switch

在 Skye API 控制台的密钥列表中,点击右侧的配置菜单,然后选择 CC Switch

在 Skye API 控制台点击 CC Switch 一键配置入口
在密钥操作菜单里选择 CC Switch,开始生成一键配置。

步骤 2:选择 Codex 和模型

在弹窗里选择 Codex。目前只提供 Codex 的一键配置功能; 主模型请选择你想使用的 GPT 模型,例如 gpt-5.4gpt-5.5gpt-5.3-codex

在 CC Switch 配置弹窗里选择 Codex 和模型
先选择 Codex,再选择主模型。截图中示例选择的是 gpt-5.5。

步骤 3:确认导入 CC Switch

确认后,浏览器会询问是否打开 CC Switch。点击 打开 CC Switch, 让浏览器把 Skye API 生成的配置导入到本机 CC Switch。

浏览器确认打开 CC Switch 并导入配置
如果是第一次打开此类链接,可以勾选始终允许,后续导入会更顺滑。

一键配置会写入什么

一键配置的核心内容通常包括供应商名称、API 地址、API Key 和默认模型。你只需要确认这些值正确:

配置项
名称: Skye API
API 地址: https://skyeapi.cn/v1
API Key: 控制台创建的 sk- 开头密钥
模型: gpt-5.3-codex / gpt-5.4 / gpt-5.4-mini / gpt-5.5

手动配置方式

如果一键配置不可用,也可以在 CC Switch 里手动新增一个 OpenAI 兼容服务商:

  1. 打开 CC Switch,进入 Provider 或供应商管理页面。
  2. 新增服务商,名称填写 Skye API
  3. Base URL / API Host / Endpoint 填写 https://skyeapi.cn/v1
  4. API Key 填写 Skye API 控制台创建的 sk- 开头密钥。
  5. 模型填写控制台可用模型,例如 gpt-5.4gpt-5.3-codex
  6. 保存后切换到该配置,并重启对应 CLI 工具。

模型建议

  • 编程任务优先使用 gpt-5.3-codex
  • 通用高质量任务推荐 gpt-5.4
  • 省额度或轻量任务可以使用 gpt-5.4-mini
  • 需要更高质量时可以尝试 gpt-5.5

常见问题

  • 如果提示鉴权失败,重新复制 API Key,确认没有多余空格或换行。
  • 如果提示模型不存在,确认模型名称属于 Skye API 当前可用模型。
  • 如果控制台没有调用日志,优先检查 Base URL 是否为 https://skyeapi.cn/v1
  • 如果切换后仍使用旧配置,重启对应 CLI 工具后再测试。