模型服务设置

本页介绍 设置 → 模型服务 里单个服务商配置页的各项功能。配置某一家服务商的完整流程，见 服务商配置。

API 密钥

填入服务商的 API 密钥即可。Cherry Studio 支持 一个服务商配置多个密钥、轮询使用（按列表从前到后循环）。有两种管理方式：

• 快速添加：多个密钥用 英文逗号 隔开直接填入，如 sk-xxx1,sk-xxx2,sk-xxx3。
• API 密钥管理：点 API 密钥输入框右侧的 钥匙图标按钮（悬停显示「API 密钥管理」）即可进入——每个密钥是一个独立条目，可分别 编辑标签、启用 / 禁用、复制、删除。

API 地址

内置服务商一般无需填 API 地址（用默认即可）。如需修改，请按服务商官方文档填写。

若服务商给的是 https://xxx.com/v1/chat/completions 这种完整地址，通常只填 根地址 https://xxx.com 即可，Cherry Studio 会自动补上 /v1/chat/completions。

添加模型

点服务商配置页的「获取模型列表」按钮，会拉取该服务商支持的模型；在弹出的「模型管理」列表里点模型右侧的 + 把它加入你的模型列表。只有加入列表的模型 才会出现在各处的模型选择器里。

模型名称下方会显示服务商返回的 实际 API 模型 ID。日期版、供应商前缀版等名称相近的模型不会再被合并；添加或选择模型前，先核对这行 ID，避免选到同名的另一版本。

连通性检查

点「检测」按钮、选一个模型即可测试是否配置成功（配置多个密钥时，还可选择用哪个密钥检测）。若检测失败，请检查模型列表里是否有填错的或不受支持的模型。

API 设置（高级）

部分服务商可在「API 设置」里开启特定能力，如：支持数组格式的 message content、Developer Message、enable_thinking（控制 Qwen3 等模型的思考）、service_tier（仅 OpenAI）等。一般无需改动。

---

获取帮助与提交反馈

如果您在配置或使用过程中遇到任何疑问、Bug 或有功能改进建议，请参考 反馈与建议 中提供的官方渠道。