返回教程列表
Cherry StudioDeepSeekAPI教程

Cherry Studio配置DeepSeek API教程(2026)

发布于 2026-09-10阅读约 9 分钟

Cherry Studio 是一款开源免费的多模型桌面客户端(支持 Windows/macOS/Linux),内置 300+ 助手模板、知识库、翻译、MCP 等功能(据 DeepSeek 官方 awesome-deepseek-agent 文档)。把 DeepSeek 官方 API 接进去,就能在一个类 ChatGPT 的界面里用上满血 DeepSeek 模型,还能和本地 Ollama 模型自由切换。这篇教程从注册到跑通,全程 5 分钟。

一、准备:注册 DeepSeek 开放平台并拿到 API Key

DeepSeek 的网页版/App 聊天完全免费,但那是给人聊天用的;要在 Cherry Studio 这类第三方客户端里调用,需要用开放平台 API Key(两个入口是分开的)。

  1. 打开 DeepSeek 开放平台:[https://platform.deepseek.com](https://platform.deepseek.com) (认准 deepseek.com 域名),手机号注册/登录;
  2. 按提示完成实名认证(国内正规 API 平台的监管要求);
  3. 左侧菜单进入「API keys(API 密钥)」→ 点「创建 API Key」,起个名字(如 cherry-studio),生成后立即复制保存 `sk-` 开头的密钥——它只完整显示一次(操作据 Cherry Studio 官方文档 DeepSeek 页);
  4. 费用方面:新账号有免费 Token 额度可先体验(具体额度与有效期以平台页面公示为准,约够数千次测试调用);免费额度用完后按量计费,充值 1 元起,轻度使用几块钱能用很久。截至 2026 年 9 月,主力模型 deepseek-v4-flash 空闲时段输入约 1 元/百万 Token、输出约 4 元/百万 Token,缓存命中低至 0.02 元,高峰时段(工作日 9-12 点、14-18 点)价格翻倍(据DeepSeek 价格报道与计费文档)。

安全提醒:API Key 和充值只走 platform.deepseek.com 官方渠道;任何"低价 DeepSeek 中转 Key/内部额度"都有跑路和泄露对话内容的风险。

二、下载安装 Cherry Studio

两种官方渠道任选:

  • 官网:[https://cherry-ai.com](https://cherry-ai.com) (或国内站 cherryai.com.cn/download);
  • GitHub Releases:[https://github.com/CherryHQ/cherry-studio/releases](https://github.com/CherryHQ/cherry-studio/releases)

Windows 选 .exe,macOS 选 .dmg(区分 Apple Silicon / Intel),Linux 选 .AppImage/.deb/.rpm。个人用户免费。安装后打开,界面左下角齿轮图标就是「设置」。

三、在 Cherry Studio 中配置 DeepSeek(核心 4 步)

以下步骤与 DeepSeek 官方文档一致(据 awesome-deepseek-agent · Cherry Studio 接入指南):

  1. 点击左下角齿轮设置图标 → 左侧选「模型服务(Model Provider)」;
  2. 在内置提供商列表中找到并选择 DeepSeek
  3. 填写两项:

- API 密钥:粘贴刚才复制的 sk-...

- API 地址(API Host):保持默认 `https://api.deepseek.com` 不用改;

  1. 点「获取模型列表 / 检查」按钮,Cherry Studio 会自动拉取你账号可用的模型,把想用的(如 deepseek-v4-flashdeepseek-v4-pro添加/勾选上;最后把页面右上角开关打开,显示"连接成功"即配置完成。

四、开始对话与实用设置

  1. 回到聊天界面,顶部模型选择器(或输入框里用 @ 呼出模型菜单)选中 DeepSeek 模型,发消息即可;
  2. 深度思考:输入框工具栏的灯泡图标可调节推理强度(reasoning effort),选最高档对应官方 reasoning_effort: "max",复杂代码/数学题效果最好;
  3. 识图/多模态:2026 年的 DeepSeek Flash 系列支持图片输入,若你的模型支持视觉,添模型时记得在模型设置里勾选「图片」输入类型,否则上传图片入口不出现;
  4. 知识库 RAG:Cherry Studio 可拖入 PDF/Word 建本地知识库。注意 DeepSeek 官方没有嵌入模型(embedding),知识库的嵌入模型建议选其他提供商(如硅基流动的 bge-m3,有免费额度),对话模型仍用 DeepSeek(据 Cherry Studio 官方文档)。
  5. 顺手再把 Ollama 提供商也配上(地址 http://localhost:11434),就能在本地免费模型和 DeepSeek 在线模型之间一键切换。

五、常见报错排查

现象原因与解决
点检查提示 401 / Invalid AuthenticationAPI Key 填错或有多余空格;重新复制 sk- 完整密钥,注意别漏字符
提示 Insufficient Balance / 余额不足免费额度用完,去 platform.deepseek.com「充值」,1 元起充
获取模型列表为空网络问题或密钥无效;确认能正常打开 platform.deepseek.com,重试拉取
能发消息但模型名报 Not Found旧的模型 ID 已下线;不要手填旧名,用「获取模型列表」自动拉取当前可用模型
上传图片没反应模型设置里没勾「图片/视觉」输入类型,勾上后重开对话
高峰时段回复慢/报繁忙工作日 9-12、14-18 点为高峰,批量任务挪到晚间或周末,且高峰计费翻倍
想确认请求是否走官方API Host 必须是 https://api.deepseek.com;填成任何第三方域名都不是官方通道

六、花费心里有个数

DeepSeek API 按 Token 计费且有缓存优惠:日常问答一天几千 Token 的轻度用法,充 10 元能用一两个月;长文档分析、批量处理这类重活,注意输出 Token 单价远高于输入,把任务集中在空闲时段跑最省。网页版/App 聊天则始终免费、与 API 额度互不影响。

📦 省心资料包

  • 《AI工具充值避坑手册》(9.9元):DeepSeek、千问、Kimi、智谱各家官方充值渠道、免费额度规则、会员档位、第三方中转骗局清单——充钱前翻一遍,省下的远不止 9.9。→ https://pay.66buff.com/buy/1
  • 《AI提效指令库》(9.9元):85 个验证过的高频提示词模板,写作、识图分析、代码调试直接套用;固定系统提示词还能提高 API 缓存命中率,Token 更省。→ https://pay.66buff.com/buy/3
  • 《本地部署AI完全指南》(19.9元):想彻底免费用开源模型?Ollama + Cherry Studio 接本地模型的完整步骤与报错排查都在里面。→ https://pay.66buff.com/buy/2

需要 API 对接、企业私有 AI / RAG 知识库或远程代部署服务,可扫码联系客服一对一咨询:👉 https://pay.66buff.com/kefu.jpg

(本文基于 2026 年 9 月 DeepSeek 开放平台与 Cherry Studio 现状整理,模型名与价格以官方页面为准。)

参考资料

  1. DeepSeek 开放平台(注册/API Key/充值):platform.deepseek.com
  2. DeepSeek 官方文档 · Cherry Studio 接入:github.com
  3. Cherry Studio 官方文档 · DeepSeek 提供商:cherryai.com.cn
  4. Cherry Studio 官网 / GitHub:cherry-ai.comreleases
  5. DeepSeek Flash 系列定价(2026-09-10 生效):toutiao.com

想要更系统、更全的整理?

配套付费资料,把本页讲不透的细节一次补全

微信客服二维码 - 大山资源

购买或使用有疑问?需要远程代部署、建站、支付对接、企业私有 AI/RAG 定制?加工程师微信,本人接单

微信:大山资源点击添加工程师微信