配合 Cherry Studio 使用

前置条件

• 已在 控制台 创建 API Key，账户余额充足。
• 本机已安装 Cherry Studio 桌面端。

配置步骤

1. 打开设置，进入模型服务（或称模型提供商）页面。
2. 新增一个供应商，类型选择 OpenAI 或 OpenAI 兼容，名称可以填「万川」。
3. API 地址填 https://chuanapi.com/v1。 部分版本会把地址拆成「主机」与「路径」两栏，此时确保最终拼出来的仍然以 /v1 结尾。
4. API 密钥填控制台创建的万川 Key。
5. 点击「获取模型」自动拉取目录；如果该版本不支持自动拉取，就从 模型目录 复制真实 model id 手动添加。
6. 保存后新建一次对话验证。

手动确认可用模型

如果客户端拉取列表失败，可以先在终端里确认当前密钥能看到哪些模型， 再把 id 抄进客户端：

curl https://chuanapi.com/v1/models \
  -H "Authorization: Bearer $WANCHUAN_API_KEY"

常见问题

• 404 / 模型列表为空： API 地址漏了 /v1， 或者客户端自动补了一层导致重复。用上面的 curl 对照一下就能确认是哪一种。
• 401：密钥填错或前后带了空格。 重新从控制台复制一次。
• 403：密钥有效但账号分组不含该模型， 换一个目录里可用的。
• 对话能开始但中途断流： 先看是不是触发了限流（429），再检查客户端的超时设置。相关行为见 流式输出。

相关文档

• 视觉输入—— 在客户端里发图片前先确认模型支持。
• 计费说明—— 桌面客户端的长上下文会显著影响费用。

本页基于 2026-08-19 的 Cherry Studio 版本校订。该客户端设置项名称随版本变动， 如界面与本文描述不一致，按「OpenAI 兼容供应商 + Base URL + Key」三要素对应即可。