星空 API 使用指南

Appearance

DeepSeek Harness 接入星空 API ​

本页适用于 Mac 版 DeepSeek Harness。已经装好？按下面四步操作，就可以填写星空 API 的配置。

开始前，先创建星空 API 密钥。创建时选择与你的卡或套餐对应的分组，例如 DeepSeek 体验卡就选“Deepseek 体验卡”分组。卡或套餐是否支持这个客户端，以该卡或套餐的说明为准；不明确时先向平台确认。

本页固定从 DeepSeek → 编辑 进入，API 地址按表格填写即可。

下方为 Mac 客户端实际截图。红框与序号标出了需要点击、填写的位置，文字步骤与图中序号一一对应。

还没有安装？先点这里（Mac）
  1. 打开 DeepSeek Harness 官网，进入下载入口，选择 Mac 版本。
  2. 若下载页区分芯片，在苹果菜单 → 关于本机查看芯片类型，再选对应版本。
  3. 在 Finder → 下载中打开刚下载的文件，完成安装，再从 应用程序打开 DeepSeek Harness。
  4. 看到主界面后，继续下面第一步。

✅ 本节完成检查点：软件已打开，可以找到左下角“更多”。

第一步：打开设置 ​

  1. 打开 DeepSeek Harness。
  2. 点击左下角的 ① 更多（三个点）。
  3. 在展开的菜单中点击 ② 设置。
图 1：点击①更多，再点击②设置。
截图与操作标注

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

✅ 本节完成检查点：已经打开“设置”窗口。

第二步：找到 DeepSeek 的编辑入口 ​

  1. 点击设置窗口左边的 ③ 模型。
  2. 找到右侧的 DeepSeek 卡片。
  3. 点击卡片右边的 ④ 编辑。

这里直接编辑 DeepSeek，不需要点击“添加模型提供商”。

图 2：点击③模型，找到 DeepSeek 卡片，再点击④编辑。
截图与操作标注

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

✅ 本节完成检查点：已经展开 DeepSeek 的配置表单。

第三步：填写密钥、地址和模型 ​

  1. 在 ⑤ API 密钥中粘贴你在星空创建的完整 Key。
  2. 点击展开 ⑥ 自定义设置，找到 ⑦ API 地址并填写星空端点。
  3. 检查 ⑧ 模型目录，按表格核对模型 ID 和名称；缺少模型时点击 ⑨ 添加模型。
配置项怎么填
⑤ API 密钥你的星空完整 Key，直接粘贴，不加 Bearer
⑦ API 地址填写网页获取的 API 端点——https://cdn.api.inxk.com
⑧ 模型 ID（左边输入框）从星空当前分组的可用模型说明中复制，拼写、大小写和符号保持一致；不要填中文显示名称
⑧ 模型名称（右边输入框）给自己看的名字，可以自定义，例如“我的 DeepSeek”

截图中，地址框下方写着“请填写兼容 Anthropic Messages 协议的 API 地址”，认准这行提示。

图 3：⑤粘贴 Key，⑥展开设置，⑦填 API 地址，⑧核对模型；需要时点⑨添加模型，完成后点⑩保存。
截图与操作标注

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

💡 模型怎么选

截图中的模型只是当时配置的示例，不代表每个星空账户都能使用。先按 模型 ID 查找图解查看星空的分组说明，确认模型 ID；列表中已有相同 ID 就直接使用，没有时再点击 ⑨ 添加模型。找不到分组的可用模型说明时，先联系平台确认 ID，不要自己猜。

⚠️ 不要照抄灰色提示地址

截图中的灰色文字 https://api.deepseek.com/anthropic 是 DeepSeek 官方地址提示，并不是要填写的星空地址。这里填写网页获取的 API 端点 https://cdn.api.inxk.com，不要自行在末尾添加 /anthropic、/v1/messages 或 /v1/chat/completions。

✅ 本节完成检查点：Key 已填入，地址已改为星空地址，模型 ID 已核对。

第四步：保存，发一句“你好” ​

  1. 确认三项配置都填好，点击右下角 ⑩ 保存（位置见图 3）。
  2. 关闭设置窗口，点击左侧 新会话。
  3. 打开 Finder，进入“桌面”，按 Shift + Command + N 新建文件夹，命名为 星空测试。回到客户端，点击 选择工作区，选中这个文件夹。工作区就是本次任务使用的文件夹。
  4. 在输入框附近的模型选择器中，选中刚才配置的模型。
  5. 输入：你好，请只回复一句问候，不要读取或修改文件。
  6. 点击发送按钮，等待回复。

收到回复后，可以到星空控制台的 使用记录中查看这次请求。

✅ 本节完成检查点：配置已保存，选好了工作区和模型，并收到问候回复。

没成功？先看这里 ​

遇到的情况先检查什么
输入框不能发送是否选择了工作区和模型
提示密钥错误 / 401Key 是否复制完整，是否已启用、未到期
提示权限不足 / 403当前分组是否支持 Messages 和所选模型，是否有 IP 限制
提示找不到接口 / 404是否误填了控制台网址、聊天补全路径或重复的 /v1；核对分组的 Messages 接入地址
提示模型不存在左侧模型 ID 是否与星空提供的 ID 完全一致；改完后新建会话测试
提示额度不足检查卡或套餐的剩余额度、密钥预算，以及创建密钥时是否选对了对应分组
提示限速 / 429停止重复发送，查看并发或频率限制，按提示等待后再试

还有问题，可以查看 常见问题与报错。分享截图时，记得遮住完整 Key。

✅ 本节完成检查点：能根据错误提示检查配置，不会反复盲目重试。

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

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

使用 VitePress 构建