Cherry Studio 配置教程（图文）

在 Cherry Studio 中添加一个 OpenAI 类型的 apizt 提供商，填写 API Key 和国内直连地址，再加入需要使用的模型。本文使用 gpt-6-sol 演示文字对话配置。

配图来自本机当前设置界面。红框标出操作位置，红字说明填写要点；点击图片可页内放大，点击关闭按钮、图片外区域或按 Esc 关闭。

一、准备 API Key 和模型 ID

1. 安装 Cherry Studio。
2. 在 apizt 控制台创建工具专用令牌；查看创建 API Key 图文步骤。
3. 在 模型价格页复制完整模型 ID，并确认令牌所属分组可用。本文示例为 gpt-6-sol。

截图中的密钥是已遮蔽的示例值。实际配置请填写自己的 API Key，例如 sk-demo-replace-with-your-key 是占位内容，不能用于调用。

二、添加 apizt 提供商

1. 打开 Cherry Studio 的设置，选择左侧模型服务。
2. 在服务商列表底部点击＋ 添加。
3. 提供商名称填写 apizt。
4. 提供商类型选择 OpenAI，点击确定。

三、填写 API 密钥和国内直连地址

1. 在刚添加的 apizt 设置页，找到API 密钥，粘贴自己的令牌。
2. API 地址填写根地址 https://api.apizt.com。
3. 核对下方预览为 https://api.apizt.com/v1/chat/completions。

此界面会自动补上 /v1/chat/completions。按图填写根地址即可，不要把控制台地址或完整的 /chat/completions 请求路径填进 API 地址。

四、添加模型：ID 和名称保持一致

1. 在模型区域，点击获取模型列表右侧的＋，打开添加模型弹窗。
2. 模型 ID填写 gpt-6-sol。
3. 模型名称也填写 gpt-6-sol，便于在聊天中直接核对真实模型。
4. 分组名称可填写 apizt，用于本地列表整理；它不会改变令牌的计费分组。
5. 点击添加模型保存，确认提供商的模型列表出现 gpt-6-sol。

需要其他模型时，按同样方式添加价格页中的完整 ID。也可使用获取模型列表，获取后将所需模型加入当前提供商列表；仅看到远端列表不代表已添加。

五、保存配置与开始使用

填写 API 密钥和地址后，设置会保存；添加模型后，再检查右上角的服务商开关。若暂时只保存配置，保持开关关闭；添加模型时开关可能自动打开，可手动关闭。

准备使用时：

1. 确认密钥、请求地址预览和模型 ID 正确，再开启 apizt 服务商。
2. 返回聊天页面，从模型选择器选择 apizt 下的 gpt-6-sol。
3. 新建一个普通对话，发送短文本，例如“请用一句话介绍你能帮助我做什么。”。
4. 核对模型回复，并在 apizt 控制台查看对应时间、模型和状态的使用记录。

检测按钮和发送消息都会产生真实 API 请求。本文配图展示已保存的设置，示例服务商最终保持关闭，未执行检测或对话请求；保存成功与实际调用成功需要分别确认。

其他模型与图片功能

本文配置的是 OpenAI 兼容文字对话。更换模型时先确认接口和令牌权限；图片生成需要图像模型及对应图像接口，不能直接用文字模型代替。查看模型与协议目录 · 查看 Chat 与 Responses 的区别。