Cherry Studio 配置 Yunwu OpenAI API：Base URL、/v1、模型 ID 怎么填
简答：配置 Yunwu 时，Cherry Studio 通常应优先选择“自定义服务商”，再从 Yunwu 当前 API 文档或控制台复制 Base URL、API Key 和精确模型 ID。本文无法从公开页面核验固定地址、是否保留 /v1 及完整模型清单，因此不要直接套用占位值；先按下文路径核对，再执行模型同步和聊天测试。
定义：Cherry Studio 的 OpenAI 兼容配置，是将服务平台提供的 Base URL、API Key 和模型 ID 映射到客户端字段，让客户端按对应协议发送聊天请求。
先做选择：Yunwu 应该用哪个 Cherry Studio 入口
本文是接入指南，不是 YUNWU.CYOU（云雾 API）官方页面。YUNWU.CYOU 的公开页面介绍了 OpenAI 接口协议兼容，并提示用户通过“API令牌”创建令牌、选择分组；但当前公开页面没有展示可独立核验的固定 Base URL、是否保留 /v1 或完整模型 ID 清单。可查看 YUNWU.CYOU 公开页面
| Cherry Studio 入口 | 适用情况 | 配置 Yunwu 时的判断 |
|---|---|---|
| 内置 OpenAI | 你使用的是 OpenAI 对应的官方服务地址和 Key，或平台文档明确要求选择这一入口 | 不要因为接口“兼容 OpenAI”就直接选择；先看 Yunwu 当前文档是否指定该入口 |
| 自定义服务商 | 服务平台支持 OpenAI 兼容协议，但不在 Cherry Studio 内置列表中 | 优先选择，填写平台文档提供的 Base URL、Key 和模型 ID |
| NewAPI | 平台明确说明其地址是 NewAPI 服务，或文档要求使用 NewAPI 入口 | Yunwu 公开页面只核实到 OpenAI 协议兼容，未核实其当前服务端是否应按 NewAPI 配置 |
Cherry Studio 文档将 OpenAI-compatible、Custom Provider 和 NewAPI 作为不同配置方向：兼容接口可以通过自定义服务商接入，而 NewAPI 有单独的协议和路径处理逻辑。查看 Cherry Studio 服务商类型说明 查看 Cherry Studio NewAPI 配置文档
决策结论：除非 Yunwu 当前 API 文档明确写明“选择 NewAPI”或“选择内置 OpenAI”，否则先使用自定义服务商；这样可以把平台给出的地址和模型字段原样核对，减少错误拼接。
配置前先核对三项真实信息
- API Key：登录 Yunwu 控制台，进入页面提示的“API令牌”，选择“新建令牌”，再选择可用分组并确认。公开页面明确展示了“API令牌 → 新建令牌 → 选择喜好的分组 → 确定”的路径。查看令牌与分组提示
- Base URL：打开 Yunwu 当前 API 文档或控制台中的接口说明，查找 OpenAI 兼容接口地址。本文不能提供固定值，因为公开首页没有显示可独立核验的地址，且页面提示模型、分组和接口信息可能随公告调整。
- 模型 ID：优先从 Cherry Studio 的“同步模型”结果中复制，或从 Yunwu 当前模型列表复制精确字符串。模型的显示名称只是客户端展示文字，不能替代请求中的
model值。
如果你在 Yunwu 页面只看到模型名称、倍率或分组，而没有看到 API Host、Base URL 或模型 ID，应先进入页面中的“API 文档”入口，或联系平台支持确认。不要把登录页、控制台首页、模型展示名称或完整聊天路径当作 Base URL。
| 需要的字段 | 应从哪里复制 | 本文能否直接给出 Yunwu 固定值 |
|---|---|---|
| 服务商名称 | Cherry Studio 本地自定义 | 可以自定义，例如 Yunwu OpenAI |
| API Key | Yunwu 控制台的 API令牌 | 不能代填，必须使用你自己的令牌 |
| Base URL | Yunwu 当前 API 文档或控制台接口说明 | 公开首页未核验到固定地址 |
| 是否保留 /v1 | Yunwu 当前接口文档与 Cherry Studio 最终请求路径 | 未核实，不能凭“兼容 OpenAI”推断 |
| 模型 ID | 同步模型结果或 Yunwu 当前模型列表 | 公开首页只概括列出 GPT、Claude、Gemini 等类别，未提供稳定 ID 清单 |
| 分组 | 令牌创建页面或平台文档 | 公开页面确认创建令牌时需要选择分组，但未公开每个模型与分组的稳定映射 |
Cherry Studio 的实际配置步骤
1. 打开自定义服务商
- 启动 Cherry Studio，进入设置 → 模型服务。
- 添加自定义服务商，并填写便于识别的名称，例如
Yunwu OpenAI。 - 在 API Key 字段粘贴从 Yunwu 控制台创建的真实令牌。
- 在 API Host 或 Base URL 字段填写 Yunwu 当前文档提供的地址。
Cherry Studio 的自定义服务商文档要求用户填写服务平台提供的 API Key 和 API Host，并支持通过“同步模型”或手动方式添加模型。查看自定义服务商官方配置步骤
2. 处理 /v1 和完整路径
Cherry Studio 官方设置说明给出了一个重要规则：如果服务商文档提供的是类似 https://example.com/v1/chat/completions 的完整地址，通常只填写根地址部分，客户端会追加剩余路径；如果服务商要求非标准路径，则应按文档填写，并可能需要使用末尾 # 禁止自动追加。查看 API Host 与路径处理规则
因此，Yunwu 的 /v1 不能直接判断为“必须保留”或“必须删除”。请按以下顺序核对：
- 先查看 Yunwu 文档给出的地址是根地址、版本地址，还是完整请求地址。
- 再对照 Cherry Studio 的 API Host 规则，避免把
/v1/chat/completions整段重复粘贴。 - 保存后执行模型同步或 Model Check，观察错误是否指向路径。
- 如果平台明确要求不带版本路径，再按 Cherry Studio 文档说明在地址末尾使用
#；普通情况下不要自行添加。
3. 同步或手动添加模型
- 点击模型区域旁的同步模型。
- 从返回结果中选择一个有文本聊天能力的模型并加入列表。
- 如果同步失败，点击加号手动添加。
- 在 Model ID 中粘贴平台实际识别的精确 ID，在 Model Name 中填写便于阅读的名称。
- 如果页面要求 Group Name，再按平台文档或模型列表填写；没有公开依据时不要自行猜测分组名称。
- 完成后打开右上角服务商启用开关。
Cherry Studio 文档说明，同步得到的模型仍需加入服务商模型列表；配置完成后还要开启服务商，否则模型可能不会进入可选列表。查看模型添加、检测和启用说明
完整字段结构示例：示例值不可直接请求
由于当前公开页面没有提供可核验的 Yunwu 固定 Base URL 和稳定模型 ID，下面只能展示“字段如何对应”的结构，不能当作可直接运行的配置。请将尖括号内容替换为你从当前文档或控制台复制的真实值。
| Cherry Studio 字段 | 填写示例结构 | 说明 |
|---|---|---|
| Provider Name | Yunwu OpenAI | 本地显示名称，可自行命名 |
| API Key | <从 Yunwu API令牌复制> | 不要使用登录密码或公开示例 Key |
| API Host | <从 Yunwu API 文档复制> | 不能用控制台首页或登录地址替代 |
| Model ID | <从同步结果或模型列表复制> | 必须是接口实际接受的字符串 |
| Model Name | Yunwu Chat Model | 仅用于 Cherry Studio 展示 |
| Group Name | <仅在平台或界面要求时填写> | 是否需要填写取决于当前接口实现 |
路径自查卡：如果错误信息显示请求地址包含两次 /v1、两次 /chat/completions，或把聊天完整路径拼接到了另一条完整路径后面，应回到 API Host 字段重新按 Cherry Studio 文档拆分。不要把模型显示名称当作 Model ID，也不要为了绕过同步失败随意更换模型字符串。
最小聊天验收：检测通过后还要做什么
Cherry Studio 的快速开始文档建议添加并启用模型，然后回到聊天页面发送消息；收到正常回复，才说明基础配置完成。查看 Cherry Studio 快速开始文档
- 确认服务商开关已开启。
- 确认聊天窗口选中的 Provider 与 Model ID，就是刚刚检测的那一组。
- 发送短文本：
请只回复 OK。 - 确认返回的是正常文本，而不是错误 JSON、空响应或持续转圈。
- 再发送一条普通中文问题，确认模型可以持续完成对话。
- 记录成功时的 Provider、模型 ID、状态和是否使用流式输出，便于后续排查。
这一步只能验证当前选中的 Key、地址、模型和权限组合，不能证明 Yunwu 的所有模型、所有分组或所有协议都可用。
配置失败排查：先分清客户端问题和平台信息问题
| 现象 | 优先检查 | 可执行动作 |
|---|---|---|
| 401 | Key 是否复制完整、是否过期、认证方式是否符合平台文档 | 重新复制 API令牌，检查前后空格，并确认当前令牌仍在 Yunwu 控制台有效 |
| 403 | 令牌权限、分组权限、模型权限 | 回到“API令牌”页面核对所选分组；Yunwu 公开页面确认需要选择分组，但未公开每个分组的稳定权限映射 |
| 404 | Base URL、版本路径和自动拼接结果 | 检查是否重复添加 /v1 或 /chat/completions，并按 Cherry Studio API Host 文档重新填写 |
| 429 | 平台限速、并发、额度或当前分组状态 | 降低并发并稍后重试，同时查看 Yunwu 当前公告、控制台额度和分组说明；不要单凭 429 判断 Key 错误 |
| 模型不存在 | Model ID 是否精确、模型是否属于当前分组 | 重新同步或从当前模型列表复制 ID；显示名称不能代替 Model ID |
| 同步模型失败 | /models 是否可用、Key 权限和地址路径 | 先手动添加一个已从平台文档核对的模型，再执行 Model Check；如仍失败，保存实际错误文本 |
| 检测通过但聊天失败 | 聊天窗口是否换了模型或 Provider | 重新确认 Provider、Model ID、启用开关、令牌分组和聊天模式 |
| 余额或额度拒绝 | 平台账户额度、令牌状态和分组限制 | 登录 Yunwu 控制台查看当前额度与公告；本文不提供未经核验的价格或余额规则 |
以上错误码表是 Cherry Studio 接入 OpenAI 兼容接口时的通用排查顺序，不代表 Yunwu 对每个状态码都有已公开的专属处理规则。Yunwu 的分组和模型信息应以当前控制台、API 文档及公告为准。
Key 安全与配置维护
- API Key 只粘贴到 Cherry Studio 的密钥字段，不要放进 URL、公开代码、截图或提交记录。
- 如果令牌已经泄露，应优先在 Yunwu 控制台撤销，再创建新的 API令牌。
- 发生 403、404 或模型不存在时，先重新核对当前文档和控制台，不要只依赖旧配置。
- 不要把 Yunwu 的模型显示名称、倍率名称或分组名称直接当作 API 的 Model ID，除非当前接口文档明确如此规定。
- Cherry Studio 版本更新后，字段名称和路径处理界面可能变化；遇到界面不一致时，以当前 Cherry Studio 文档和实际请求结果为准。
常见问题
Cherry Studio 配置 Yunwu 时，优先选择内置 OpenAI 还是自定义服务商？
优先选择自定义服务商。只有 Yunwu 当前 API 文档明确要求使用内置 OpenAI，或明确提供对应入口时，才考虑内置 OpenAI；NewAPI 也必须以平台文档指定为准。
Yunwu 的 Base URL 可以直接填写什么？
目前不能根据公开首页核验一个固定地址。请登录 Yunwu 控制台或进入页面中的 API 文档入口，复制 OpenAI 兼容接口地址，再按 Cherry Studio 的 API Host 规则检查路径。
Yunwu 的 Base URL 要不要保留 /v1？
不能一概而论。若平台文档提供版本地址，应按文档和 Cherry Studio 的最终请求路径核对；不要重复添加 /v1，也不要把完整的 /chat/completions 路径再次拼接。
模型同步失败时，能不能手动添加模型？
可以。Cherry Studio 支持手动添加 Model ID、Model Name 和必要的 Group Name，但 Model ID 必须从 Yunwu 当前模型列表或接口文档复制，不能用自定义显示名称代替。
为什么 Model Check 通过，聊天仍然提示模型不存在？
常见原因是聊天窗口选用了不同模型、不同 Provider 或不同分组。请重新核对聊天窗口的 Provider、Model ID、服务商启用开关和令牌分组，并用短文本再次测试。
Yunwu 的分组应该怎么填写？
公开页面确认创建 API令牌时需要选择分组，但没有提供每个模型与分组的稳定映射。先在令牌创建页面选择当前可用分组，再以模型列表、API 文档或实际错误信息核对是否需要在 Cherry Studio 单独填写 Group Name。
相关阅读
参考资料
- YUNWU.CYOU（云雾 API）使用指南与常见问题
- Model Service Configuration | Cherry Studio Docs（cherryai.com）
- Model Service Settings | Cherry Studio Docs（cherryai.com）
- Custom AI Service Provider | Cherry Studio Docs（cherryai.com）
- NewAPI | Cherry Studio Docs
- Quick Start | Cherry Studio Docs（cherryai.com）