Cherry Studio
安装 Cherry Studio，并添加 TokenHub OpenAI 兼容服务商。
Cherry Studio 适合用作桌面聊天、模型调试和提示词验证客户端。TokenHub 可作为 OpenAI 兼容服务商加入，方便在不同模型之间切换。
适合场景
Cherry Studio 更适合非代码 Agent 场景：日常对话、提示词调试、多模型对比、临时验证模型输出。它也适合在正式接入 IDE/CLI Agent 之前，先测试 TokenHub API Key 和模型是否可用。
安装 Cherry Studio
先参考 Cherry Studio 服务商配置官方文档 或 Cherry Studio 官方仓库。常见方式：
- 打开官方仓库 Releases。
- 下载与你系统匹配的安装包。
- 安装并启动 Cherry Studio。
- 进入设置中的模型服务商页面。
如果你使用企业设备，确认系统允许安装桌面客户端，并且网络能访问 https://us-api.tokenhub.com。
准备 TokenHub 凭证
export TOKENHUB_API_KEY="sk-..."准备一个常用聊天模型 ID，并确认账户余额或额度可用。
持久化设置位置
Cherry Studio 是桌面客户端，推荐把 TokenHub 保存为客户端内的服务商，而不是依赖系统临时环境变量。常见位置如下：
| 位置 | 用途 |
|---|---|
| 设置里的服务商页面 | 新增 TokenHub，并保存 API 地址、API Key 和模型列表。 |
| 模型管理页面 | 手动添加 TokenHub Model ID，避免自动拉取失败影响使用。 |
| 客户端本地配置 | 只在本机保存；不要把包含 API Key 的配置导出到公共仓库。 |
如果只是验证 TokenHub API Key 是否可用，Cherry Studio 很适合作为第一站；验证成功后，再把同样的 Base URL、Key 和 Model ID 填到 IDE 或 CLI Agent。
添加 TokenHub 服务商
在 Cherry Studio 中进入服务商或模型设置，新增 OpenAI Compatible 服务商：
| 字段 | 值 |
|---|---|
| 名称 | TokenHub |
| 类型 | OpenAI Compatible 或 OpenAI |
| API 地址 | https://us-api.tokenhub.com/v1 |
| API Key | TOKENHUB_API_KEY 对应的密钥值 |
| 模型 | TokenHub 模型列表中的 Model ID |
如果 Cherry Studio 支持手动添加模型，建议先添加一个聊天模型和一个低成本快速模型，分别用于日常对话和草稿。
推荐模型分组
| 分组 | 用途 |
|---|---|
| 主力聊天 | 日常问答、长文本理解、提示词调试 |
| 快速模型 | 草稿、改写、短问题 |
| 推理模型 | 复杂分析、方案比较 |
| 代码模型 | 代码解释、脚本生成 |
可以把模型名称写成 TokenHub / 模型名，避免和其他服务商的同名模型混淆。
验证
新建一个会话，选择 TokenHub 模型并发送：
用一句话说明你现在通过哪个模型服务商响应。如果能正常回复，说明服务商配置完成。随后再测试长上下文、流式输出和图片/文件能力。
常见问题
| 现象 | 处理方式 |
|---|---|
| 测试连接失败 | 检查 API 地址是否是 https://us-api.tokenhub.com/v1。 |
| 模型为空 | 手动添加模型 ID，不依赖自动拉取。 |
| 响应慢 | 换用 TokenHub 中更快的模型，或关闭深度推理类模型。 |
| 401 | 重新粘贴 API Key，确认没有空格和换行。 |
| 功能不支持 | 桌面客户端能力取决于模型和客户端版本，先用纯文本对话验证。 |
最后更新于