Cherry Studio
最近更新：2026年8月26日
Cherry Studio 添加一个 OpenAI 类型的供应商指向 Amux，模型列表会自动拉取。
Cherry Studio 是一款桌面端多模型对话客户端。添加一个 OpenAI 类型的供应商并指向 Amux 后，模型列表会自动拉取，无需手动填写模型 ID。
一、创建 Amux 密钥
在控制台的密钥页创建密钥。创建后仍可在该页面再次查看，无需重新生成。
二、添加供应商
进 设置 → 模型服务，点「添加」新建一个供应商：
| 字段 | 填什么 |
|---|---|
| 供应商名称 | Amux（随意，只是列表里的标签） |
| 供应商类型 | OpenAI |
| API 密钥 | 你的 Amux 密钥 |
| API 地址 | https://gateway.amux.ai/v1 |
粘贴密钥时请确认未包含首尾空格或换行。这是该步骤最常见的失败原因，通常会表现为“密钥无效”。
三、拉取模型列表
填写完成后点击“管理”，Cherry Studio 会拉取可用模型列表。该列表来自 /v1/models，包含当前密钥可调用的模型及相关扩展信息。
四、验证
在模型列表里选择一个模型，开一个新对话并发送一条测试消息。
选模型
列表中的每一项名称都是规范 ID（如 anthropic/claude-opus-5）。可选模型不限于 OpenAI 厂商；跨协议调用的参数差异见协议转换参数兼容性。
同一个模型可能有多家供应商在提供，价格不同。Cherry Studio 这里不做区分，路由会按你在设置里选的策略挑。要锁定某一家，手动添加一个带后缀的模型 ID（anthropic/claude-opus-5:anthropic），见 API 参考。
常见问题
模型列表拉不出来
请先核对 API 地址。Cherry Studio 会在该地址后追加路径，因此这里应填写 https://gateway.amux.ai/v1，并保留 /v1 前缀。随后再检查密钥与网络连通性。
密钥无效
常见原因是复制时附带了空格或换行。建议重新复制并检查首尾，同时确认密钥仍处于启用状态，且工作区余额充足。
某个模型调用失败
工作区余额是否充足，以及那个模型是不是还在架上——列表是拉取时的快照，模型下架之后本地那份不会自动更新，点一下「管理」重拉即可。
想按项目分开算账
给每个用途建一把单独的密钥，在 Cherry Studio 里添加成两个供应商。用量按密钥统计，同一把密钥下的请求事后分不开。