Cherry Studio 接入 302API：添加服务商并完成流式对话

验证日期：2026-09-29。macOS 桌面版 Cherry Studio 2.1.3，模型 gpt-5.6-luna。已开启流式输出、完成真实短对话并核对本站调用记录；本文不覆盖工具调用、图片、长上下文、多轮任务或其他模型。

使用 Cherry Studio 的自定义服务商入口，可以为 302API 单独保存连接配置，并在助手中选择对应模型。

1. 新建独立服务商

打开设置中的模型服务页面，添加一个自定义服务商，名称可填 302API。如果已有正在使用的同名服务商，可另取名称用于验证，保留原配置。

302API 的网站是 302api.com。 不要把客户端内置的其他近似名称服务商当作本站配置。

Key 只填入密钥输入框。建议使用独立的限额 Key，便于区分这次配置产生的调用；不要公开 Key 或包含 Key 的配置导出文件。

2. 添加模型并选择助手

1. 在新建服务商中添加模型，完整填写 gpt-5.6-luna。
2. 确认服务商已启用，在助手中选择该服务商下的 Luna。
3. 首次验证开启流式输出，最大输出 Token 设为 32，不添加知识库或工具任务。
4. 新建对话，避免历史消息增加首次验证的输入量。

添加模型也可能产生真实调用。 本次 2.1.3 的添加流程自动执行了模型检测，账本中有对应成功记录。开始配置前就应设置好限额，并将检测费用计入预算。

3. 发出第一条消息

输入：

请只回复：302API_CHERRY_OK

本次实测得到 302API_CHERRY_OK，客户端结束生成，本站对应调用记录为成功。短回复可能很快显示完，不能只凭逐字动画判断流式是否完整。

验证时一起检查三项：选中的是目标服务商和模型、消息生成已结束、控制台有对应成功记录。本文的真实验证仅代表上述版本和模型的基础文本路径。

4. 对照控制台记录

按专用 Key、模型和时间查看调用明细。客户端自动检测、标题生成等行为可能带来附加请求，实际费用以本站记录为准。

如果界面显示失败，但请求结果未知，先查记录再决定是否重发；不要把没有显示答案理解为没有费用。关于 Token 分类和费用精度，可继续阅读 缓存计费说明。

5. 常见配置问题

• 认证失败： 检查 Key 状态与输入内容，避免首尾空格，不公开密钥排错。
• 地址错误： 使用本站 Base URL，避免重复拼接 /v1 或手动把完整请求路径填进地址栏。
• 模型选错： 核对服务商名称与完整 gpt-5.6-luna ID，不与 GPT-6 Luna 混用。
• 回复中断或截断： 核对结束状态与输出上限，参考 流式排错教程。

临时验收结束后，可关闭测试服务商并停用测试 Key；原有服务商继续保留。长期使用时再按实际任务设置输出长度与费用限额。