Cherry Studio 怎么配置 API?Cherry Studio 添加模型与中转 API 教程(2026)
Cherry Studio 怎么配置 API?本文一步步完成 Cherry Studio 添加模型服务商、填写 API 密钥与 API 地址、获取模型列表,讲清 API 地址末尾 / 和 # 的拼接规则,通过中转 API 在 Cherry Studio 里使用 Claude、GPT、DeepSeek,并附常见报错排查。
SupaStore 开发者体验组 ·

Cherry Studio 配置 API 只需要三步:在设置里添加一个模型服务商,填好 API 密钥和 API 地址,再把要用的模型加进来。配置完成后,就能在 Cherry Studio 里和 Claude、GPT、DeepSeek 等模型对话,按 Token 用量付费。
本文用 SupaStore 演示 Cherry Studio 添加模型的完整流程,重点讲清最容易填错的 API 地址规则,并附模型选择建议和常见报错排查。还没有选好服务商,可以先看《API中转站是什么?AI中转站选型避坑指南》。
Cherry Studio 是什么
Cherry Studio 是一款跨平台的桌面端 AI 客户端,支持 Windows、macOS 和 Linux。它可以同时接入多家模型服务商,在一个界面里切换不同模型,还内置了大量预设助手、本地知识库和文件对话功能。
Cherry Studio 本身不提供模型,需要你配置 API。只要中转站兼容 OpenAI 接口,一个 Key 就能在 Cherry Studio 里使用多家模型。
第一步:创建 API 密钥
- 登录 SupaStore,进入控制台的【令牌管理】,点击【添加令牌】;
- 名称填
cherry-studio,方便在使用日志里区分; - 勾选准备在 Cherry Studio 里使用的模型,并设置额度上限;
- 复制生成的
sk-开头的密钥。
第二步:Cherry Studio 添加模型服务商
- 打开 Cherry Studio,点击左下角的 设置,进入 模型服务;
- 点击服务商列表底部的 添加,名称填
SupaStore,提供商类型 选择 OpenAI; - API 密钥 填入刚才复制的密钥;
- API 地址 填写:
https://api.supastore.cc
- 打开服务商右上角的开关,启用这个服务商。
Cherry Studio API 地址怎么填
Cherry Studio 会根据 API 地址的结尾自动拼接接口路径,这是配置时最容易出错的地方:
| API 地址写法 | 实际请求的地址 | 说明 |
|---|---|---|
https://api.supastore.cc |
https://api.supastore.cc/v1/chat/completions |
推荐,自动补全 /v1/chat/completions |
https://api.supastore.cc/v1/ |
https://api.supastore.cc/v1/chat/completions |
以 / 结尾时,只追加 chat/completions |
https://api.supastore.cc/v1/chat/completions# |
原样使用 | 以 # 结尾时,不做任何拼接 |
如果请求报 404,十有八九是地址拼出了重复的 /v1 或少了 /v1,按上表改成推荐写法即可。不同工具的填写规则对照,见《Base URL 是什么?API Base URL 怎么填》。
第三步:Cherry Studio 添加模型
方式一:获取模型列表
点击服务商页面下方的 管理,Cherry Studio 会调用中转站的 /v1/models 接口,列出这个 Key 可以使用的全部模型,点击模型旁边的加号即可添加。
方式二:手动添加模型
列表没有返回,或者只想加几个模型时,点击 添加,在 模型 ID 里填写模型名称,例如:
claude-sonnet-4-6:写作、长文总结、复杂问题;gpt-5.6-luna:通用对话与问答;deepseek-v4-flash:翻译、润色、简单问答,单价最低。
模型 ID 必须和模型广场中的写法完全一致,大小写和连字符都不能错。
第四步:检查连接并开始对话
- 在 API 密钥旁边点击 检查,选择一个已添加的模型,提示连接成功即说明配置正确;
- 回到对话页面,在顶部的模型选择器里选中
SupaStore下的模型,发送一句"你好"测试。
能正常回复,就说明 Cherry Studio 配置 API 已经完成。在 SupaStore 控制台的使用日志里,可以看到每次对话的 Token 数和扣费金额。
Cherry Studio 用什么模型好
下面是 2026-10-29 模型广场中的几个常用模型(每百万 Token,USD,默认分组),实时价格以模型广场为准:
| 场景 | 模型 ID | 输入 | 输出 |
|---|---|---|---|
| 长文写作、复杂推理、读文档 | claude-sonnet-4-6 |
$0.9 | $4.5 |
| 通用对话与问答 | gpt-5.6-luna |
$1 | $6 |
| 推理、数学、代码问题 | deepseek-v4-pro |
$0.348 | $0.696 |
| 翻译、润色、日常聊天 | deepseek-v4-flash |
$0.05 | $0.1 |
日常聊天用便宜的模型就够了,遇到复杂问题再切换到 Claude。在 Cherry Studio 里给不同的助手指定不同的默认模型,可以省去来回切换的麻烦。
Cherry Studio 使用技巧
- 长对话及时新开话题:每轮对话都会把之前的历史一起发送,话题越长,输入 Token 越多。换话题就新建一个;
- 调整上下文数量:在助手设置里限制携带的历史消息条数,可以明显降低长对话的成本;
- 读图片和 PDF 选对模型:上传图片或文件时,要选择支持多模态的模型,Claude 处理图片和 PDF 的方式见《Claude 图片识别怎么用?》和《Claude 怎么读取 PDF?》;
- 一个 Key 多处使用要分开:电脑和手机上的客户端、编程工具最好各用一个 Key,方便查看各自的消耗。
Cherry Studio 配置 API 常见报错
| 现象 | 常见原因 | 处理方法 |
|---|---|---|
| 401 / 密钥无效 | 密钥复制时多了空格,或 Key 已删除 | 重新复制密钥,点击"检查"验证 |
| 404 Not Found | API 地址拼出重复或缺少的 /v1 |
改成 https://api.supastore.cc |
| 获取不到模型列表 | API 地址错误,或 Key 没有勾选模型 | 先修正地址,或改用手动添加 |
| 模型不存在 | 模型 ID 拼写错误,或 Key 未勾选该模型 | 在模型广场核对 ID,检查 Key 的可用模型 |
| 402 / 余额不足 | 钱包余额或 Key 额度用完 | 充值或调高该 Key 的额度上限 |
更多错误码的含义见《Claude API 报错怎么办?》。
常见问题 (FAQ)
Q: Cherry Studio 是免费的吗?
答: Cherry Studio 客户端本身免费开源,但调用模型需要你自己的 API Key,费用按实际使用的 Token 计算,由 API 服务商收取。
Q: Cherry Studio 的提供商类型应该选 OpenAI 还是 Anthropic?
答: 选 OpenAI 最通用,一个服务商就能用 Claude、GPT、DeepSeek 等所有模型。如果只用 Claude,并且想用 Claude 原生协议的特性,也可以再单独添加一个 Anthropic 类型的服务商,但要按该类型的地址规则填写。
Q: Cherry Studio 能用一个 Key 同时在电脑和手机上用吗?
答: 技术上可以,但建议每个设备各建一个 Key,分别设置额度。这样某台设备的 Key 泄露时,只需要删掉那一个。
Q: Cherry Studio 里的知识库需要单独的模型吗?
答: 需要。知识库要先用嵌入(Embedding)模型把文档转成向量,再用对话模型回答。在服务商里添加嵌入模型后,在知识库设置中选择它即可,具体可用的嵌入模型以模型广场为准。