Skip to content

1.1 配置第一个模型

本节目标

给 dsh 填上第一个 DeepSeek API 密钥,让"大脑"上线。这是整个界面第一道必做配置,做完模型立即可用。

为什么第一步是配置模型

上一节我们看到了 dsh 的界面,它什么都好,但还缺一样东西:大脑

dsh 本身不生产模型,它负责调度、干活,而真正"想问题、写代码、回话"的是背后的大模型服务。所以开工前必须先告诉 dsh:用哪家的模型、用什么密钥。配置好之前,即使发了指令也得不到任何回复。

第一步:申请 DeepSeek API 密钥

dsh 对 DeepSeek 支持得最好,开箱即用,我们先用它。

  1. 打开 DeepSeek 开放平台 https://platform.deepseek.com/
  2. 注册并登录账号(支持手机号或邮箱)
  3. 在左侧菜单找到 API 密钥(API Keys)
  4. 点击创建 API 密钥,给密钥起个名字,比如 dsh-tutorial
  5. 创建后立刻复制保存,格式是 sk- 开头的一长串字符

密钥只显示一次

DeepSeek 平台的密钥创建后只在页面上完整显示一次,关闭页面就再也看不到了。请先复制到安全的地方再关页面。

第二步:打开设置里的模型页

回到 dsh 界面,点左侧边栏底部的设置,在弹出的面板里点模型这个 tab:

模型配置页

页面上方有一句话:填入各提供方的 API 密钥即可使用其模型。下面列出了 DeepSeek 提供方,已经默认预置好了。

第三步:填入密钥并保存

  1. 在 DeepSeek 提供方的卡片上,点编辑按钮
  2. 弹出编辑表单,找到 API 密钥一栏:

编辑 DeepSeek 提供方

  1. 把上一步复制的 sk- 开头的密钥粘贴进去
  2. 不用动其他配置,Base URL 默认就是 https://api.deepseek.com,模型列表里也已经列好了可用的模型(V4-Flash 和 V4-Pro)
  3. 保存

保存后,模型路由立即生效,不需要重启 dsh。

验证一下

回到主界面,看底部输入区的选择模型按钮,如果显示的是 DeepSeek 的模型名(比如 DeepSeek-V4-Flash),就说明配置成功了。

还没配置时的样子

如果你在配置前看这个位置,它不会显示具体模型。配置好之后模型名才会出现,并且可以点开它切换其他模型,这部分在 4.1 节讲。

安全提醒

API 密钥就是你的钱袋子,按使用量计费,请把它当密码对待:

  • 不要把密钥截图发到群里、贴到博客里
  • 不要提交到 git 仓库
  • 如果怀疑泄露,到 DeepSeek 平台吊销重建一个就行,旧密钥立即失效

常见问题

问:保存后模型不可用,提示密钥无效?

多半是密钥复制不全(sk- 开头的一整串都要),或者密钥刚创建还没生效。回平台重新创建一个试试。

问:提示余额不足?

DeepSeek 平台是按量付费的,新账号可能需要先充值。到平台费用页面查看余额和账单。

问:不想用 DeepSeek,能用别的模型吗?

可以。1.2 节会讲怎么接入其他提供方,以及自定义 OpenAI 兼容端点。

小结

  • 模型页在设置 → 模型,DeepSeek 提供方已预置
  • 填 API 密钥点保存,模型立即可用,不用重启
  • 密钥是敏感信息,丢了就去平台吊销重建

大脑接好了,下一节我们看看除了 DeepSeek,还能接哪些模型。

发现错误?提交反馈 · 欢迎 提 PR 改进本书