Cherry Studio 配置 AI 模型完整教程
如果你正在寻找一款清爽、跨平台的 AI 对话客户端,Cherry Studio 绝对值得一试。它支持多家模型供应商,既可以直连官方 API,也能接入第三方中转站。本文将手把手带你完成从零到一的完整配置,让你在桌面端流畅调用 DeepSeek、Qwen、Claude、Gemini 等主流模型。
## 准备工作
首先,从 Cherry Studio 的 GitHub Releases 页面或官网下载对应系统的安装包。它同时支持 Windows、macOS 和 Linux,安装过程极其简单,双击一路下一步即可。启动后,你会看到一个简洁的对话界面,左侧是会话列表,右侧是聊天区域——但这时还没法直接对话,因为我们还没有为它接入任何模型。
要使用模型,一般有两个选择:直接去模型厂商(如 DeepSeek、Anthropic)申请 API Key,或者通过中转站统一管理。中转站的好处是一次充值就能使用多个模型,不需要每家分别注册、绑卡,而且支付方式更灵活。本文会以 TokenPocket API 中转站为例,演示如何配置。
## 获取 API 密钥
打开 TokenPocket API 官网(https://tokenpocket.site),注册账号后进入控制台。平台目前支持 USDT 直接支付,按量计费,新用户注册就送免费体验额度,很适合先试用再决定是否充值。
在控制台的“API 密钥”页面,点击“创建密钥”,系统会生成一串 `sk-` 开头的字符串,这就是你的 API Key。请务必复制并妥善保存,它只显示一次。这个密钥的权限等同于你的账户,支持调用所有已开通的模型,包括 DeepSeek-V3、Qwen2.5、Claude 3.5 Sonnet、Gemini 1.5 Pro 等。
记下 API Key 的同时,还需要留意中转站提供的“API 地址”(Base URL)。TokenPocket 的控制台会清晰地列出这个地址,一般形如:
``` https://api.tokenpocket.site/v1 ```
这正是 Cherry Studio 连接时所需要填入的接口地址。
## 在 Cherry Studio 中配置中转站
回到 Cherry Studio,点击左下角的“设置”(齿轮图标),进入“模型服务”标签页。这里你会看到已经预设了 OpenAI、Anthropic 等原生接口。我们要添加一个自定义的 OpenAI 兼容接口。
1. 在“模型服务”页面找到“添加服务”或“自定义服务”。 2. 供应商类型选择 **OpenAI Compatible**,因为多数中转站都兼容 OpenAI 的接口规范。 3. 在“名称”一栏填写便于识别的名字,例如“TokenPocket”。 4. “API 地址”填入刚才的 Base URL:`https://api.tokenpocket.site/v1`。 5. “API 密钥”粘贴你从 TokenPocket 后台获取的 `sk-...` 密钥。 6. 点击“保存”后,Cherry Studio 会自动测试连接,并拉取可用模型列表。
如果一切正常,你会在该服务下面看到一长串模型名称,比如 `deepseek-chat`、`qwen2.5-72b-instruct`、`claude-3-5-sonnet-20241022`、`gemini-1.5-pro` 等。勾选你想使用的模型,它们就会出现在对话页面的模型选择下拉菜单中。
## 测试对话与模型切换
新建一个聊天会话,在输入框上方的下拉菜单中选中刚刚添加的模型,比如 `deepseek-chat`。随便问一句:“你好,请用一句话介绍你自己。” 如果返回了正常的回复,说明整个链路已经打通。
Cherry Studio 允许在同一个会话中随时切换模型,你可以在对话过程中下拉选择另一个模型,让不同模型接力回答,方便对比效果。由于 TokenPocket 的计费是按模型分别统计的,你的余额会扣除对应模型的 token 消耗,后台可以实时查看用量明细。
## 进阶配置:编写系统提示词
在模型服务的高级设置中,你还可以为不同模型预设 System Prompt。比如为 `qwen2.5-72b-instruct` 设置“你是一个精通 Go 语言的资深后端工程师,请用简洁的方式回答代码问题”,这样每次调用该模型时,都会自动带上这条指令,非常适合团队内共享同一套配置。
以下是 Cherry Studio 配置文件中对应模型的 JSON 片段示例,有兴趣手动编辑的话可以直接修改配置:
```json { "models": [ { "provider": "TokenPocket", "name": "deepseek-chat", "apiKey": "sk-xxxxxxxxxxxxxxxxxxxxxxxx", "baseURL": "https://api.tokenpocket.site/v1", "systemPrompt": "你是一个有帮助的 AI 助手。" } ] } ```
不过大多数情况下,直接通过图形界面配置就已经足够。
## 写在最后
至此,你已经成功在 Cherry Studio 中接入了 TokenPocket API 中转站,解锁了几乎市面上所有主流大模型。相比分别去各厂商开户,这种方式明显更省心,而且按量计费、无需月租,适合自由开发者和内容创作者。新用户注册就有免费额度,完全可以不花一分钱先体验一圈,看看哪个模型更适合自己的工作流。如果你正需要一个稳定、方便的一站式模型接入服务,不妨去 https://tokenpocket.site 试试看。