cherry-studio 怎么配置第三方 API

Cherry Studio 是桌面端多模型客户端，添加第三方网关的路径很固定。

第一步：新增服务商

设置 → 模型服务 → 添加 → 选择 OpenAI（兼容格式）。

第二步：填写连接信息

• API Host：https://relay.example.com（有的版本需要带 /v1，以网关文档为准）。
• API Key：你的 key。
• 点“检查”或“获取模型列表”。

第三步：添加模型

在服务商下点“添加模型”，填入网关支持的模型 ID，例如 claude-sonnet-5-5。回到聊天页，在顶部选择该模型。

验证

发一句“reply with OK”，再试一次带图片或长文本的请求，确认多模态与上下文都正常。

常见报错

• 连接失败：API Host 多了或少了 /v1，两种都试一次。
• 401：key 错误，或该 key 没有这个模型的权限。
• 模型列表为空：网关不提供 /models 接口，手动添加模型 ID 即可。
• 回复中断：关闭流式输出再试，排查网关的 SSE 支持。

注意

• 不同版本的界面文案略有差异，找不到时在设置里搜索“OpenAI”。
• 客户端会把对话保存在本地，敏感内容注意清理历史记录。