最后更新于
这有帮助吗?
本页介绍 设置 → 模型服务 里单个服务商配置页的各项功能。配置某一家服务商的完整流程,见 服务商配置。
内置服务商通常只需填对应的 API 密钥。
不同服务商对密钥的叫法不同:密钥、Key、API Key、令牌,指的都是同一个东西。
填入服务商的 API 密钥即可。Cherry Studio 支持 一个服务商配置多个密钥、轮询使用(按列表从前到后循环)。有两种管理方式:
快速添加:多个密钥用 英文逗号 隔开直接填入,如 sk-xxx1,sk-xxx2,sk-xxx3。
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 设置」里开启特定能力,如:支持数组格式的 message content、Developer Message、enable_thinking(控制 Qwen3 等模型的思考)、service_tier(仅 OpenAI)等。一般无需改动。
配置好后,务必打开服务商右上角的 启用开关,否则该服务商仍未启用,其模型不会出现在模型选择列表里。
如果您在配置或使用过程中遇到任何疑问、Bug 或有功能改进建议,请参考 反馈与建议 中提供的官方渠道。
最后更新于
这有帮助吗?
这有帮助吗?