日记详情

AI 扫盲系列第 4 篇：接上模型——获取 API 密钥并完成配置

阅读时长：约 10 分钟。
上一篇我们装好了 OpenCode。这篇就给它"插上电"——把 DeepSeek 接进去，让它真正开口说话。

---

一、什么是 API 密钥？为什么 OpenCode 需要它？

先打个比方：

API 密钥（API Key），就是你使用 AI 服务的"充值卡 + 钥匙"。
有了它，OpenCode 才能替你向 DeepSeek 的大脑"借算力"，并按实际用量扣费。

• 你在网页上聊天，网站帮你登录，不用你操心；
• 但 OpenCode 是跑在你电脑上的独立工具，它需要一个凭证来证明"这是你在用"——这个凭证就是 API Key。

所以流程是：注册 DeepSeek → 充点钱 → 拿到 Key → 填进 OpenCode。整个流程只需要你复制粘贴，不涉及任何编程。

⚠️ 安全提醒先放最前面：API Key 就像银行卡密码，绝不能发给别人、不要截图发到网上、不要在教程里贴出来。 如果发现泄露，立即到官网删除重建。

---

二、注册 DeepSeek 账号

1. 打开 DeepSeek 开放平台（注意：是"开放平台/开发者平台"，不是普通聊天版网页）。
2. 点击右上角"注册"，可以用手机号注册，也可以用微信扫码。
3. 按提示完成手机验证，登录进去。

到这里你只是有了账号，还没"钱"。下一步充值。

---

三、充值（购买额度）

1. 登录后，在页面顶部或左侧菜单找到 "充值" / "购买 Token" 入口。
2. 第一次建议 充 10~30 元 即可——对普通人来说，这够你用上几个月甚至半年。
3. 选择支付方式（支付宝/微信），支付完成后，页面上会显示你的账户余额。

关于"充多少"的实用建议：平时写写周报、做做 PPT，一次对话成本几分钱。先充 10 元试水，用完了再补，永远不心疼。

---

四、创建并复制你的 API Key

1. 在左侧菜单找到 "API Keys" 或 "密钥管理"。
2. 点击 "创建" / "新建 API Key"，可以给它起个名字，比如 opencode。
3. 创建后，页面会显示一串以 sk- 开头的长字符——这就是你的 Key。
4. 立刻点击"复制"把它存到安全的地方（比如自己的记事本，或密码管理器）。

   ⚠️ 重要：这串字符只在创建时完整显示一次，刷新页面后就看不到了，只能重新生成。

---

五、把 Key 填进 OpenCode，完成配置

下面两种方式，任选一种，效果一样。推荐方式一，最简单。

方式一：在 OpenCode 界面里直接配置（推荐新手）

1. 打开 OpenCode，在界面中找到 "设置 / Settings" 入口（一般在左下角或输入框附近）。
2. 找到 "模型 / Models" 或 "Providers"（服务商） 一项，选择添加 DeepSeek。
3. 在对应的输入框里，粘贴你刚才复制的 API Key。
4. 保存后，OpenCode 会自动识别出 DeepSeek 的模型（比如 deepseek-chat），设为默认即可。

方式二：用配置文件（进阶，多一种选择）

如果你在界面里没找到设置入口，也可以用配置文件方式：

1. 在 OpenCode 里执行 /config 指令（输入框里敲 /config 回车）。
2. 它会在你电脑上生成（或打开）一个配置文件，按它提示的格式加入下面的内容并保存：

   {"provider": {"deepseek": {"apiKey": "这里粘贴你的API Key"}}
   }
   

3. 保存文件后，重启 OpenCode 即可生效。

看不懂 JSON 结构？没关系——在界面里点选输入就够用了，配置文件只是给想更深入的朋友多一个选择。记住：你只需要把 Key 贴进去，其余不用动。

---

六、测试你的第一个对话

1. 回到 OpenCode 对话区，确认左下角/顶部显示的模型是 DeepSeek。
2. 在输入框里输入：你好，请用一句话介绍你自己，回车。
3. 看到它正常回复了，恭喜！你的本地 AI 助手正式上岗了！

如果没反应或报错，对照这个表

现象	原因	解决
提示"API Key 无效 / 401"	Key 复制漏字符或多字符	重新创建 Key，重新粘贴，注意 sk- 开头要完整
提示"余额不足 / 402"	没充值或余额用光	回 DeepSeek 官网充值
提示"网络错误 / 连接超时"	网络问题	换网络，或稍后再试
提示"找不到模型"	模型名填错	用 DeepSeek 默认模型名，别手写奇怪名字

---

七、进阶：多模型切换与默认模型

配置好 DeepSeek 后，如果你想再加个 Kimi 备用（读长文档用），完全支持：

1. 按上面的方式，再添加一个服务商（比如 Kimi 所属的"月之暗面"开放平台），同样拿到它的 API Key 填进来。
2. 在 OpenCode 里，输入框旁边通常有个模型切换按钮，点一下就能在已配置的模型间切换。
3. 在设置里可以指定默认模型，这样每次打开自动用 DeepSeek，省心。

建议：新手阶段只配 DeepSeek 一个就够了，先用顺手，以后再慢慢加。工具贵精不贵多。

---

八、安全与省钱的 5 条铁律

1. Key 只存自己电脑里，截图打码，不分享。
2. 泄露了怎么办：立刻去官网"删除该 Key"，重新生成一个新的。
3. 先充小钱：10 元够玩很久，用不完不心疼。
4. 看用量：DeepSeek 官网有用量明细，偶尔瞄一眼，做到心里有数。
5. 没把握先问 AI：配置遇到问题，把报错原文发给 AI 问，往往比搜教程更快。

---

九、本篇小结

• API Key = 你的"充值卡 + 钥匙"，OpenCode 靠它替你调用 DeepSeek。
• 全流程 4 步：注册 → 充值 → 创建 Key → 填进 OpenCode，全程复制粘贴。
• 界面里就能配置，不用碰代码；配置文件是进阶玩法，可选。
• 配好后测一句"你好"，它回话就代表全部打通。
• 安全第一条：Key 谁都不给，泄露就删了重办。

下一篇预告：《实战一——让 AI 生成你的第一个 PPT》，你已经有了一台能干活的小助手，该让它亮一手了。

---