Cherry Studio

配置 Cherry Studio 本地服务商的 OpenAI 基地址与模型列表。

安装与准备

从 Cherry Studio 发布页面下载 Windows、macOS 或 Linux 安装包并启动桌面应用。在 routerra.ai/keys为客户端创建密钥，并从网关模型列表复制获准模型 ID。无需 Docker 或本地推理服务器；此方式将密钥保存在客户端服务商设置中。

配置连接

打开 Settings → Model Services → + Add Provider，命名为 routerra.ai，端点选择 OpenAI，基地址填 https://routerra.ai/v1，API Key 填 YOUR_API_KEY。若版本显示 API Address，填 https://routerra.ai/v1，并查看请求 URL 预览，确保最终为 /v1/chat/completions。新版按协议分别配置端点，请配置 OpenAI 聊天端点，而非 Anthropic 或 Responses。保存并启用服务商。

OpenAI base URL: https://routerra.ai/v1
API Key: YOUR_API_KEY
Model ID: YOUR_MODEL_ID
Generated chat URL: https://routerra.ai/v1/chat/completions

选择模型与排查错误

点击 Get model list 添加获准模型，或用 + 手动添加 YOUR_MODEL_ID。新建聊天并选择该服务商和模型，发送简短文本。404 时检查最终 URL 是否重复 /v1 或缺少 /chat/completions；列表为空时确认服务商已启用，并手动添加准确 ID。密钥检查通过不代表可调用所有模型。