Skip to content

Chatbox 接入星空 API ​

本页适用于 Mac 版 Chatbox。已经安装好?从第一步开始。红框和序号对应需要点击、填写的位置。

开始前,先创建 API 密钥:选择卡或套餐对应的分组,例如 DeepSeek 体验卡选择“Deepseek 体验卡”。本页先按截图选择 OpenAI Responses API 兼容,所用模型需在卡或套餐支持范围内;Claude API 的选法放在下面的可选说明中。

还没有安装?先点这里(Mac)
  1. 打开 Chatbox 官网,进入下载页,选择 macOS。
  2. 如果下载页区分 Apple 芯片与 Intel,点击 Mac 左上角苹果菜单 → 关于本机,按显示的芯片选择。
  3. 下载完成后,在 Finder → 下载中双击安装包,按安装窗口提示将 Chatbox 放入 应用程序。
  4. 从“应用程序”打开 Chatbox,看到聊天主界面后回到下面第一步。

✅ 本节完成检查点:Chatbox 已打开,能找到设置入口。

第一步:打开设置 ​

打开 Chatbox,点击左下角 ① 设置。

图 1:先点击①设置;配置完成后,在这里点⑨新对话,再通过⑩模型选择器切换模型。
截图与操作标注

文字看不清?点“放大细节”。按 Esc 或点击“关闭”返回。

✅ 本节完成检查点:已经打开 Chatbox 设置。

第二步:添加“星空”,填入地址和密钥 ​

  1. 点击左侧 ② 模型提供方。
  2. 点击提供方列表底部 ③ 添加,按提示创建自定义提供方,名称填写 星空。
  3. 添加后,在提供方列表中点击 星空,按下表填写。
图 2:点击②模型提供方,再点击列表底部③添加,创建自己的星空配置。
截图与操作标注

文字看不清?点“放大细节”。按 Esc 或点击“关闭”返回。

配置项怎么填
名称星空,用于自己辨认
④ API 模式先选择 OpenAI Responses API 兼容,与图 3 一致
⑤ API 密钥粘贴你在星空创建的完整 Key,不加 Bearer
⑥ API 主机填写网页获取的 API 端点——https://cdn.api.inxk.com
API 路径保留所选模式的默认路径,按下方预览核对;不要把一种模式的路径填到另一种模式中

核对请求预览应为 https://cdn.api.inxk.com/v1/responses。API 主机只填上表地址,API 路径保持默认。

我想使用 Claude API 模式

也可以选择 Claude API 兼容。保留该模式的默认路径,最终请求预览应为 https://cdn.api.inxk.com/v1/messages。Key 和 API 主机的填写方式相同,模型仍需属于当前分组。切换模式后重新获取模型并测试。

✅ 本节完成检查点:已添加“星空”,填好模式、Key 和 API 主机。

第三步:先点击“获取”模型 ​

  1. 先点击“模型”这一行右侧的 ⑦ 获取,等待 Chatbox 读取当前 Key 的可用模型。
  2. 查看获取结果:弹出选择列表时,选中自己套餐内的目标模型并完成添加;直接更新列表时,确认目标模型已出现在“星空”下。此时只是把模型加入提供方,第四步还要在对话中选择它。
  3. 模型获取完成后,再点击右上角 ⑧ ×,关闭设置,回到聊天页。
图 3:④选 API 模式(截图以 Responses 为例,也可选 Claude API),⑤填 Key,⑥填星空端点;先点⑦获取模型,完成后点⑧关闭设置。
截图与操作标注

文字看不清?点“放大细节”。按 Esc 或点击“关闭”返回。

💡 获取不到,才考虑手动添加

先检查 Key、地址和分组权限,再重试一次。平台未提供模型列表,或列表里缺少已确认可用的模型时,再点击 新建,按平台给出的准确模型 ID 手动添加。不要一开始就照抄截图里的模型名称。

截图中的模型属于当时的配置示例,你应选择自己卡或套餐对应分组允许使用的模型。旁边的“检查”按钮可辅助检查连接,不能代替一次真实聊天测试。

✅ 本节完成检查点:已经先点击“获取”,并确认要使用的模型出现在列表里。

第四步:选择模型,发送“你好” ​

  1. 点击左侧 ⑨ 新对话(位置见图 1)。
  2. 点击输入框右下角的 ⑩ 模型选择器。
  3. 在 星空提供方下选择刚才获取的模型,不要误选其他提供方的同名模型。
  4. 在输入框输入 你好,点击发送按钮。
  5. 收到回复后,回星空控制台的 使用记录查看这次请求。

✅ 本节完成检查点:会话使用“星空”下的模型,并成功收到回复。

没成功?先检查 ​

遇到的情况先检查什么
获取模型失败 / 401Key 是否完整、已启用且未到期,API 主机是否正确
模型不在列表里先点“获取”,再核对当前分组权限;仅在确认 ID 可用后手动新建
权限不足 / 403是否选对卡或套餐分组,是否有 IP 限制
找不到接口 / 404API 模式和路径是否匹配:Responses 对应 /v1/responses,Claude API 对应 /v1/messages
提示购买 Chatbox AI 服务当前会话可能选了 Chatbox AI,切换到自己配置的“星空”提供方
提示额度不足查看套餐剩余量、账户余额和密钥预算,并确认对应分组
超时或限速停止重复发送,查看网络与平台状态,稍后单次测试

不要分享完整 Key,也不要把含密钥的配置上传到 GitHub。

✅ 本节完成检查点:知道先获取模型、选对提供方,并能按报错检查配置。

收到回复了?完成最后的检查 →

仍然失败?查看排查与工单步骤 →

使用 VitePress 构建