Cherry Studio 接入
在 Cherry Studio 中添加 Sublyx OpenAI compatible 服务商。
Cherry Studio 可通过自定义 OpenAI compatible 服务商接入 Sublyx，适合验证模型、日常对话和多模型比较。
添加服务商
打开模型服务设置
进入 Cherry Studio 的设置页面，找到模型服务或服务商管理。
新建 OpenAI compatible 服务商
服务商名称可填写 Sublyx，类型选择 OpenAI 或 OpenAI compatible。
填写连接信息
| 配置项 | 值 |
|---|---|
| API 地址 | https://api.sublyx.org/v1 |
| API Key | sk-sublyx-example |
| 模型 ID | 例如 gpt-5.6-terra |
测试并启用
保存配置，执行连接测试，然后在助手或对话页面选择已添加的模型。
添加模型
如果客户端未自动加载模型列表，可手动添加模型列表中的模型 ID。模型 ID 区分字符与连字符，应完整复制。
常见问题
| 现象 | 检查项 |
|---|---|
| 拉取模型失败 | API 地址是否包含 /v1，Key 是否有效 |
| 对话返回 401 | 是否误填了空格、引号或已停用的 Key |
| 找不到模型 | 手动添加准确的模型 ID |
| 流式输出中断 | 暂时关闭流式模式，确认基础请求可用后再排查网络代理 |
保护桌面端配置
个人电脑上的客户端配置仍属于敏感信息。不要分享包含 Key 的截图、配置导出文件或日志。