#Cherry Studio 接入万模API

适用协议：OpenAI Chat | 适合：桌面多模型聊天、图片和长对话工作流

Cherry Studio 是很多用户第一次接触中转站时会选择的桌面客户端。你只需要把它的 OpenAI 兼容服务地址改成万模API，再填入令牌和模型名。

#开始前确认

如果你还没有 API Key，先看认证与令牌。

#配置步骤

1. 打开 Cherry Studio。
2. 进入设置或模型服务设置。
3. 添加一个 OpenAI 兼容服务，名称可以写 WanmoAPI。
4. API Host / Base URL 填：https://www.wanmoapi.com/v1。
5. API Key 填：你的 sk-...。
6. 模型列表里手动添加控制台可用模型，例如 gpt-5.4-mini。
7. 保存配置。
8. 新建对话，选择刚添加的模型，发起对话，可以正常响应即代表配置成功。

#字段对照

#验证方式

发送：

你好，用一句话介绍你自己。

成功标志：

• 客户端正常返回回复。
• 控制台调用日志能看到一次 /v1/chat/completions 请求。
• 日志里的模型名和你在 Cherry Studio 选择的模型一致。

#常见问题

#模型列表没有自动出现

手动添加模型名。模型名必须和控制台展示一致，不能自己改大小写、空格或横线。

#返回 401

API Key 错或复制不完整。重新复制令牌，确认没有前后空格。

#返回 404

优先检查两点：

• Base URL 是否填成了 https://www.wanmoapi.com/v1/chat/completions 或者填写成了 https://www.wanmoapi.com/v1，可以在API地址下看你输入的预览。
• 模型名是否属于当前令牌分组。

#图片或多模态失败

先用纯文本模型验证。如果文本正常、图片失败，通常是模型能力或客户端上传格式不匹配，需要换支持图片输入/输出的模型。

下一步：协议选择指南 或 常见问题排查。