> ## Documentation Index
> Fetch the complete documentation index at: https://docs.4096bytes.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cherry Studio

> 在 Cherry Studio 中新增 4096bytes 供应商

Cherry Studio 适合把多个模型供应商集中管理。你可以把 4096bytes 作为 OpenAI 兼容供应商添加到 Cherry Studio，然后在不同会话中选择对应模型。

## 准备工作

* 已完成 [创建账号](/quickstart/create-account)。
* 已完成 [获取 API Key](/quickstart/get-api-key)。
* 已安装 Cherry Studio，并确认可以打开设置页面。
* 已准备好 4096bytes 的 API Key、Base URL 和模型名。

建议为 Cherry Studio 单独创建一个 API Key，例如 `cherry-studio-home` 或 `cherry-studio-work`。这样可以单独查看 Cherry Studio 的消耗，也方便后续停用。

## 安装客户端

如果你还没有安装 Cherry Studio，请打开 [Cherry Studio 下载页](https://docs.cherry-ai.com/docs/en-us/cherry-studio/download)，按你的系统选择对应安装包。

<Steps>
  <Step title="下载安装包">
    从官方入口选择 Windows、macOS 或 Linux 版本。Windows 用户注意区分安装版和便携版，macOS 用户注意区分 Intel 和 Apple Silicon。
  </Step>

  <Step title="启动 Cherry Studio">
    安装完成后先打开一次 Cherry Studio，确认主界面可以正常进入。
  </Step>

  <Step title="进入设置">
    打开 **设置**，确认可以看到模型服务、模型供应商或 API 配置相关页面。
  </Step>
</Steps>

## 新增供应商

<Steps>
  <Step title="打开设置">
    启动 Cherry Studio，进入 **设置**。不同版本入口可能略有差异，通常在左下角或侧边栏。
  </Step>

  <Step title="进入模型服务">
    找到 **模型服务**、**模型供应商**、**Provider** 或 API 配置相关页面。
  </Step>

  <Step title="新增供应商">
    点击 **添加**、**新增供应商** 或类似按钮。供应商名称建议填写 `4096bytes`。
  </Step>

  <Step title="选择兼容类型">
    选择 **OpenAI**、**OpenAI Compatible**、**自定义 OpenAI** 或类似选项。
  </Step>
</Steps>

## 填写接入信息

在 4096bytes 供应商配置中填写下面字段。

| Cherry Studio 字段               | 填写内容                         |
| ------------------------------ | ---------------------------- |
| `名称`、`供应商名称`                   | `4096bytes`                  |
| `API Key`、`密钥`                 | 你在 4096bytes 控制台创建的 API Key。 |
| `API 地址`、`API Host`、`Base URL` | `https://api.4096bytes.com`。 |
| `接口类型`、`兼容类型`                  | OpenAI 兼容。                   |
| `模型`、`模型名称`                    | 控制台展示的模型名。                   |

Base URL 填写根地址即可。不要手动拼接 `/v1/chat/completions`、`/v1/responses` 或其他完整接口路径。

<Warning>
  API Key 会保存在本机 Cherry Studio 配置中。不要在共享电脑上配置个人 Key，也不要把包含 Key 的设置截图发给他人。
</Warning>

## 添加模型

Cherry Studio 的不同版本对模型列表处理方式不同。有些版本可以自动拉取模型，有些版本需要手动添加。

<Steps>
  <Step title="尝试获取模型">
    如果页面提供 **获取模型**、**刷新模型列表** 或 **Check** 按钮，可以先点击测试。
  </Step>

  <Step title="手动添加模型">
    如果模型列表为空，请点击 **添加模型** 或 **自定义模型**，填写控制台展示的模型名。
  </Step>

  <Step title="保存供应商">
    确认供应商启用，并保存 API Key、Base URL 和模型列表。
  </Step>
</Steps>

模型名必须和控制台显示完全一致。不要修改大小写、连接符或版本号。

## 测试连接

保存后，在 Cherry Studio 中新建一个会话，并选择 4096bytes 供应商下的模型。

可以先发送一个短问题：

```text theme={null}
请用一句话说明你当前使用的模型名称。
```

如果可以正常回复，说明 Cherry Studio 已经能通过 4096bytes 发起请求。确认无误后再用于正式对话。

## 使用建议

* 为 Cherry Studio 单独创建 API Key，不要和 Codex、Claude Code、Cursor 共用同一个 Key。
* 如果你添加了多个供应商，发送消息前确认当前会话选择的是 4096bytes 模型。
* 如果 Cherry Studio 支持模型分组或默认模型，可以把常用 4096bytes 模型设为默认。
* 团队共享设备上不建议配置个人 API Key。确实需要共享时，请使用单独 Key 并设置额度限制。

## 常见排查

<AccordionGroup>
  <Accordion title="测试连接失败">
    先确认供应商类型是 OpenAI 兼容，再检查 API Key、Base URL 和模型名。Base URL 使用 `https://api.4096bytes.com`，不要填写完整接口路径。
  </Accordion>

  <Accordion title="模型列表为空">
    如果 Cherry Studio 不能自动获取模型，请手动添加控制台展示的模型名。添加后保存供应商并重新打开会话。
  </Accordion>

  <Accordion title="提示认证失败">
    检查 API Key 是否完整，是否复制了多余空格或换行。确认 Key 没有被删除、过期或超过额度。
  </Accordion>

  <Accordion title="提示模型不存在">
    回到控制台复制模型名。模型名需要完全匹配，不能使用其他客户端页面、旧截图或其他用户配置里的名称。
  </Accordion>

  <Accordion title="对话使用了其他供应商">
    检查当前会话的模型选择器。Cherry Studio 可能会保留上一次使用的模型，需要手动切换到 4096bytes 供应商下的模型。
  </Accordion>

  <Accordion title="请求很慢或中断">
    先用短问题测试。长上下文、附件、代理网络或并发请求都可能影响响应速度。必要时查看 Cherry Studio 的请求日志。
  </Accordion>
</AccordionGroup>