For the complete documentation index, see llms.txt. This page is also available as Markdown.

模型服务设置

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

  • 内置服务商通常只需填对应的 API 密钥

  • 不同服务商对密钥的叫法不同:密钥、Key、API Key、令牌,指的都是同一个东西。

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

如果服务商的请求路径不是常规的 /v1/chat/completions,可在 API 地址栏填 完整地址并以 # 结尾——以 # 结尾时不再自动拼接版本路径,只用你填的地址。

添加模型

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

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

连通性检查

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

API 设置(高级)

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


获取帮助与提交反馈

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

最后更新于

这有帮助吗?