云路 API进入控制台 内容核对 · 2026-10-20
配置前先准备三项信息
准备云路 API 账号、可用模型额度和一个应用密钥。未创建密钥时，先登录密钥管理。Cherry Studio 是客户端，本身不会自动为你充值云路 API 余额。
从Cherry Studio 官方网站下载安装适合自己系统的版本；已有客户端可直接继续。不要把账户登录密码当成 API 密钥。
第一步：添加模型服务商
- 打开 Cherry Studio 的“设置 → 模型服务”。
- 添加自定义服务商，名称可填“云路 API”，类型选择 OpenAI 兼容。
- 填写你在云路 API 创建的应用密钥，避免多余空格与换行。
本教程采用 OpenAI 兼容聊天路径。Claude 同样可以通过该格式使用；如果选用 Anthropic 原生类型，请参考Messages 地址说明，不要混用两套设置。
第二步：正确填写 API 地址
桌面客户端若会自动补全 /v1/chat/completions，API 地址填写根地址 https://api.yunluapi.com。如果字段明确要求 SDK Base URL，则填写 https://api.yunluapi.com/v1。
核对最终请求应为 https://api.yunluapi.com/v1/chat/completions。不要重复拼出 /v1/v1，不要填写主站登录页，也不要在普通配置中添加 # 来关闭路径补全。
地址的补全规则见客户端官方模型服务设置文档。手机端或不同 Provider 模板可能显示不同字段，按该版本说明核对最终路径。
第三步：获取并启用模型
- 点击“获取模型列表”或“管理”，按需添加你有权限调用的模型。
- 找不到列表时，可按模型广场显示的完整 ID 手动添加。例如
gpt-6-luna或claude-sonnet-5。 - 打开服务商启用开关，在对话页面选中该服务商下的模型。
- 发送一条短消息检查连接，再到云路 API 用量日志核对结果。检测和对话都可能消耗额度。
模型未显示或检测失败怎么办
- 获取到模型，但对话列表没有显示
- 在模型管理列表中添加所需模型，并确认服务商启用开关已打开。
- 401 或密钥错误
- 检查平台密钥是否完整、是否失效、是否有多余空格。不要向工单或截图暴露完整密钥。
- 404 或路径错误
- 重点检查 API 地址是否重复带
/v1，以及服务商类型是否为 OpenAI 兼容。 - 余额不足、429 或超时
- 核对账户与密钥额度，减少并发，按返回提示处理。仍有问题时提交支持工单，附时间、模型和请求 ID。
更完整的协议说明见OpenAI API 中转接入页，模型和价格以当前实际配置为准。