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

​
准备工作

  • 已完成 创建账号。
  • 已完成 获取 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 下载页，按你的系统选择对应安装包。
1

下载安装包

从官方入口选择 Windows、macOS 或 Linux 版本。Windows 用户注意区分安装版和便携版，macOS 用户注意区分 Intel 和 Apple Silicon。
2

启动 Cherry Studio

安装完成后先打开一次 Cherry Studio，确认主界面可以正常进入。
3

进入设置

打开 设置，确认可以看到模型服务、模型供应商或 API 配置相关页面。

​
新增供应商

1

打开设置

启动 Cherry Studio，进入 设置。不同版本入口可能略有差异，通常在左下角或侧边栏。
2

进入模型服务

找到 模型服务、模型供应商、Provider 或 API 配置相关页面。
3

新增供应商

点击 添加、新增供应商 或类似按钮。供应商名称建议填写 4096bytes。
4

选择兼容类型

选择 OpenAI、OpenAI Compatible、自定义 OpenAI 或类似选项。

​
填写接入信息

在 4096bytes 供应商配置中填写下面字段。 Base URL 填写根地址即可。不要手动拼接 /v1/chat/completions、/v1/responses 或其他完整接口路径。
API Key 会保存在本机 Cherry Studio 配置中。不要在共享电脑上配置个人 Key，也不要把包含 Key 的设置截图发给他人。

​
添加模型

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

尝试获取模型

如果页面提供 获取模型、刷新模型列表 或 Check 按钮，可以先点击测试。
2

手动添加模型

如果模型列表为空，请点击 添加模型 或 自定义模型，填写控制台展示的模型名。
3

保存供应商

确认供应商启用，并保存 API Key、Base URL 和模型列表。
模型名必须和控制台显示完全一致。不要修改大小写、连接符或版本号。

​
测试连接

保存后，在 Cherry Studio 中新建一个会话，并选择 4096bytes 供应商下的模型。 可以先发送一个短问题：
如果可以正常回复，说明 Cherry Studio 已经能通过 4096bytes 发起请求。确认无误后再用于正式对话。

​
使用建议

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

​
常见排查

先确认供应商类型是 OpenAI 兼容，再检查 API Key、Base URL 和模型名。Base URL 使用 https://api.4096bytes.com，不要填写完整接口路径。
如果 Cherry Studio 不能自动获取模型，请手动添加控制台展示的模型名。添加后保存供应商并重新打开会话。
检查 API Key 是否完整，是否复制了多余空格或换行。确认 Key 没有被删除、过期或超过额度。
回到控制台复制模型名。模型名需要完全匹配，不能使用其他客户端页面、旧截图或其他用户配置里的名称。
检查当前会话的模型选择器。Cherry Studio 可能会保留上一次使用的模型，需要手动切换到 4096bytes 供应商下的模型。
先用短问题测试。长上下文、附件、代理网络或并发请求都可能影响响应速度。必要时查看 Cherry Studio 的请求日志。