Cherry Studio 配置

Cherry Studio 是一款流行的 AI 对话桌面客户端。本指南介绍如何在 Cherry Studio 中配置 TopRouter API。

前置条件

• 已安装 Cherry Studio
• 已注册 TopRouter 账号并获取 API Key
• 已完成 充值

配置步骤

第一步：打开设置

1. 启动 Cherry Studio
2. 点击左下角的 设置（⚙️）图标
3. 选择 模型服务商 选项

第二步：添加自定义服务商

1. 点击 添加服务商 或 自定义 API
2. 填写以下信息：

配置项	值
服务商名称	TopRouter（自定义名称）
API 地址	https://toprouter.cc
API 密钥	您的 TopRouter API Key

第三步：添加模型

添加服务商后，手动添加您需要使用的模型：

1. 在 TopRouter 服务商下点击 添加模型
2. 输入模型 ID，例如：
   • anthropic/claude-4.6-sonnet
   • gpt-5.5
   • google/gemini-3.1-pro
   • anthropic/claude-4.8-opus

💡 批量添加

您也可以点击「获取模型列表」按钮，如果 Cherry Studio 支持该功能，将自动拉取 TopRouter 上的所有可用模型。

第四步：开始对话

1. 返回对话界面
2. 在模型选择下拉框中选择 TopRouter 下的模型
3. 开始对话！

推荐模型配置

用途	推荐模型	模型 ID
日常对话	Claude 4.6 Sonnet	anthropic/claude-4.6-sonnet
深度分析	Claude 4.8 Opus	anthropic/claude-4.8-opus
通用任务	GPT-5.5	gpt-5.5
快速回复	GPT-5.5 Mini	openai/gpt-5.5-instant
长文处理	Gemini 3.1 Pro	google/gemini-3.1-pro

常见问题

连接测试失败？

1. 确认 API 地址为 https://toprouter.cc（不带 /v1）
2. 确认 API Key 正确且账户余额充足
3. 检查网络连接，确保可以访问 toprouter.cc

模型列表为空？

手动添加所需模型即可。输入正确的模型 ID，如 anthropic/claude-4.6-sonnet。

回复乱码或格式异常？

确认 Cherry Studio 版本为最新版，旧版本可能存在兼容性问题。

流式响应不工作？

在设置中确认已开启流式传输（Streaming）选项。

📖 相关文档

• 模型列表 — 查看所有可用模型 ID
• API 密钥 — 管理 API Key
• 快速开始 — API 基础使用