SupaStore

返回博客列表

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?Cherry Studio 添加模型与中转 API 教程(2026)

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 密钥

  1. 登录 SupaStore,进入控制台的【令牌管理】,点击【添加令牌】;
  2. 名称填 cherry-studio,方便在使用日志里区分;
  3. 勾选准备在 Cherry Studio 里使用的模型,并设置额度上限;
  4. 复制生成的 sk- 开头的密钥。

第二步:Cherry Studio 添加模型服务商

  1. 打开 Cherry Studio,点击左下角的 设置,进入 模型服务;
  2. 点击服务商列表底部的 添加,名称填 SupaStore,提供商类型 选择 OpenAI;
  3. API 密钥 填入刚才复制的密钥;
  4. API 地址 填写:
https://api.supastore.cc
  1. 打开服务商右上角的开关,启用这个服务商。

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 必须和模型广场中的写法完全一致,大小写和连字符都不能错。


第四步:检查连接并开始对话

  1. 在 API 密钥旁边点击 检查,选择一个已添加的模型,提示连接成功即说明配置正确;
  2. 回到对话页面,在顶部的模型选择器里选中 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 使用技巧

  1. 长对话及时新开话题:每轮对话都会把之前的历史一起发送,话题越长,输入 Token 越多。换话题就新建一个;
  2. 调整上下文数量:在助手设置里限制携带的历史消息条数,可以明显降低长对话的成本;
  3. 读图片和 PDF 选对模型:上传图片或文件时,要选择支持多模态的模型,Claude 处理图片和 PDF 的方式见《Claude 图片识别怎么用?》和《Claude 怎么读取 PDF?》;
  4. 一个 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)模型把文档转成向量,再用对话模型回答。在服务商里添加嵌入模型后,在知识库设置中选择它即可,具体可用的嵌入模型以模型广场为准。