DeepSeek API 配置教程

这份教程按富酬者 AI 当前插件界面编写。你只需要准备自己的 DeepSeek API Key,把它填进 Obsidian 插件设置页,然后点击“测试连接”。

插件当前只开放 DeepSeek

设置页里的“提供商”固定显示为 DeepSeek,不需要选择其他模型平台。

推荐默认模型

日常使用选 V4 Flash,对应模型 ID 为 deepseek-v4-flash

不要泄露 API Key

API Key 只填在本地插件里。售后排查时不要发送完整 Key 或含 Key 截图。

一、注册 DeepSeek 开放平台并确认余额

  1. 打开 DeepSeek 开放平台
  2. 登录账号。大陆用户按页面提示使用手机号、邮箱或平台支持的方式登录即可。
  3. 进入控制台后,先查看余额或充值入口。富酬者 AI 插件费用不包含 DeepSeek API 调用额度。
  4. 首次建议小额充值,用插件测试通过后再按自己的使用量补充余额。
DeepSeek 官方中文文档说明,API 会按输入和输出 token 计量计费,费用从充值余额或赠送余额中扣减。价格可能调整,最终以官方“模型 & 价格”页面为准。

二、创建 API Key

  1. 打开 API Keys 页面
  2. 点击创建新的 API Key。名称可以写 fuchouzhe-ai-obsidian,方便以后识别。
  3. 复制生成出来的 API Key,并保存在自己的密码管理器或安全笔记里。
  4. 如果怀疑 Key 泄露,立刻到 DeepSeek 控制台删除旧 Key,再重新创建。
API Key 等同于你的模型账户凭证。不要发给任何人,也不要上传带完整 Key 的截图。

三、按插件设置页逐项填写

打开 Obsidian,进入:设置 -> 第三方插件 -> 富酬者 AI for Obsidian -> 插件选项。当前交付版的模型配置区如下。

提供商
DeepSeek,该项固定显示,不需要修改。
模型
默认选 V4 Flash;复杂分析、长文整理或更重的任务再切换 V4 Pro
API Base URL
填写 https://api.deepseek.com。不要填写 /chat/completions,末尾也不要加多余空格。
API Key
粘贴你在 DeepSeek 控制台创建的 API Key。输入框是密码框,正常情况下不会明文显示。
插件默认值与官方中文文档一致:OpenAI 兼容 Base URL 为 https://api.deepseek.com,可用模型为 deepseek-v4-flashdeepseek-v4-pro

四、模型怎么选

V4 Flash

插件默认模型。适合大多数笔记总结、资料整理、普通问答、内容生成和日常工作流。成本更低,响应更轻。

V4 Pro

适合复杂分析、长文推理、项目规划、代码与多步骤任务。插件在无工具调用的 Pro 请求中会启用思考模式。

不建议新用户填写 deepseek-chatdeepseek-reasoner。DeepSeek 官方中文文档说明,这两个旧模型名将在北京时间 2026-07-24 23:59 弃用。

五、点击“测试连接”

  1. 确认 API Base URL、API Key、模型都已填写。
  2. 点击设置页里的 测试连接 按钮。
  3. 如果提示“DeepSeek API 连接成功”,说明当前 Key、模型和 URL 可用。
  4. 如果提示失败,按顺序检查:Key 是否复制完整、DeepSeek 账户是否有余额、Base URL 是否填写为 https://api.deepseek.com、模型是否为 V4 FlashV4 Pro

插件内部测试会使用当前设置发起一次很小的非流式请求。这个测试只验证连通性,不会读取你的笔记内容。

常见问题

我应该看英文文档还是中文文档?

看官方中文文档即可。本文所有 DeepSeek 文档入口都指向 /zh-cn/ 中文页面,更适合大陆用户按步骤操作。

API Key 要发给你吗?

不需要。API Key 只填在自己的 Obsidian 插件设置里。售后排查只需要错误提示、插件版本、Obsidian 版本和系统环境。

插件包是否包含 DeepSeek 调用额度?

不包含。插件包费用和 DeepSeek API 调用费用分开。DeepSeek API 调用费用由你自己的 DeepSeek 开放平台账户结算。

填了以后还是失败怎么办?

先回到 DeepSeek 控制台确认 API Key 没有被删除、账户有可用余额。然后在插件里重新粘贴 Key,模型选 V4 Flash,Base URL 填 https://api.deepseek.com,再点一次“测试连接”。

参考:DeepSeek 官方中文首次调用 APIDeepSeek API 基本信息对话补全模型 & 价格更新日志