前置条件
- 已下载并安装 Cherry Studio
- 已获取 Sub2API API Key(详见 创建 API Key)
配置步骤
1
打开 Cherry Studio
启动 Cherry Studio 桌面客户端。
2
进入服务商设置
点击设置图标,进入「服务商」或「Providers」页面。
截图占位:此处可插入实际客户端配置截图
3
添加新服务商
点击「添加服务商」或「Add Provider」按钮。 选择「OpenAI Compatible」类型。
截图占位:此处可插入实际客户端配置截图
4
填写服务商信息
根据提示填写以下信息:
TODO:请在后台确认实际配置后填写。(API 路径
/v1 需根据实际配置确认)截图占位:此处可插入实际客户端配置截图
5
添加模型
添加你希望使用的模型名称,例如:
gpt-4oclaude-opus-4-5
截图占位:此处可插入实际客户端配置截图
6
保存并启用
点击保存按钮,确保该服务商状态为「已启用」。 在对话界面中选择刚添加的 Sub2API 服务商及对应模型,开始对话测试。
故障排查
保存后模型列表为空
保存后模型列表为空
- 确认 API URL 填写正确
- 检查 API Key 是否有效
- 参考 API Key 无效排查
对话返回 401 错误
对话返回 401 错误
- 确认使用的是 Sub2API 控制台生成的 API Key
- 参考 401 错误排查
提示模型不可用
提示模型不可用
- 确认添加的模型名称与 Sub2API 支持的模型名称一致
- 参考 模型不可用排查

