AI 扫盲系列第 4 篇：接上模型——获取 API 密钥并完成配置
阅读时长：约 10 分钟。
上一篇我们装好了 OpenCode。这篇就给它"插上电"——把 DeepSeek 接进去，让它真正开口说话。
一、什么是 API 密钥？为什么 OpenCode 需要它？
先打个比方：
API 密钥（API Key），就是你使用 AI 服务的"充值卡 + 钥匙"。
有了它，OpenCode 才能替你向 DeepSeek 的大脑"借算力"，并按实际用量扣费。
- 你在网页上聊天，网站帮你登录，不用你操心；
- 但 OpenCode 是跑在你电脑上的独立工具，它需要一个凭证来证明"这是你在用"——这个凭证就是 API Key。
所以流程是：注册 DeepSeek → 充点钱 → 拿到 Key → 填进 OpenCode。整个流程只需要你复制粘贴，不涉及任何编程。
⚠️ 安全提醒先放最前面：API Key 就像银行卡密码，绝不能发给别人、不要截图发到网上、不要在教程里贴出来。 如果发现泄露，立即到官网删除重建。
二、注册 DeepSeek 账号
- 打开 DeepSeek 开放平台（注意：是"开放平台/开发者平台"，不是普通聊天版网页）。
- 点击右上角"注册"，可以用手机号注册，也可以用微信扫码。
- 按提示完成手机验证，登录进去。
到这里你只是有了账号，还没"钱"。下一步充值。
三、充值（购买额度）
- 登录后，在页面顶部或左侧菜单找到 "充值" / "购买 Token" 入口。
- 第一次建议 充 10~30 元 即可——对普通人来说，这够你用上几个月甚至半年。
- 选择支付方式（支付宝/微信），支付完成后，页面上会显示你的账户余额。
关于"充多少"的实用建议：平时写写周报、做做 PPT，一次对话成本几分钱。先充 10 元试水，用完了再补，永远不心疼。
四、创建并复制你的 API Key
- 在左侧菜单找到 "API Keys" 或 "密钥管理"。
- 点击 "创建" / "新建 API Key"，可以给它起个名字，比如
opencode。 - 创建后，页面会显示一串以
sk-开头的长字符——这就是你的 Key。 - 立刻点击"复制"把它存到安全的地方（比如自己的记事本，或密码管理器）。
⚠️ 重要：这串字符只在创建时完整显示一次，刷新页面后就看不到了，只能重新生成。
五、把 Key 填进 OpenCode，完成配置
下面两种方式，任选一种，效果一样。推荐方式一，最简单。
方式一：在 OpenCode 界面里直接配置（推荐新手）
- 打开 OpenCode，在界面中找到 "设置 / Settings" 入口（一般在左下角或输入框附近）。
- 找到 "模型 / Models" 或 "Providers"（服务商） 一项，选择添加 DeepSeek。
- 在对应的输入框里，粘贴你刚才复制的 API Key。
- 保存后，OpenCode 会自动识别出 DeepSeek 的模型（比如
deepseek-chat），设为默认即可。
方式二：用配置文件（进阶，多一种选择）
如果你在界面里没找到设置入口，也可以用配置文件方式：
- 在 OpenCode 里执行
/config指令（输入框里敲/config回车）。 - 它会在你电脑上生成（或打开）一个配置文件，按它提示的格式加入下面的内容并保存：
{"provider": {"deepseek": {"apiKey": "这里粘贴你的API Key"}} } - 保存文件后，重启 OpenCode 即可生效。
看不懂 JSON 结构？没关系——在界面里点选输入就够用了，配置文件只是给想更深入的朋友多一个选择。记住：你只需要把 Key 贴进去，其余不用动。
六、测试你的第一个对话
- 回到 OpenCode 对话区，确认左下角/顶部显示的模型是 DeepSeek。
- 在输入框里输入：
你好，请用一句话介绍你自己，回车。 - 看到它正常回复了，恭喜！你的本地 AI 助手正式上岗了！
如果没反应或报错，对照这个表
| 现象 | 原因 | 解决 |
|---|---|---|
| 提示"API Key 无效 / 401" | Key 复制漏字符或多字符 | 重新创建 Key，重新粘贴，注意 sk- 开头要完整 |
| 提示"余额不足 / 402" | 没充值或余额用光 | 回 DeepSeek 官网充值 |
| 提示"网络错误 / 连接超时" | 网络问题 | 换网络，或稍后再试 |
| 提示"找不到模型" | 模型名填错 | 用 DeepSeek 默认模型名，别手写奇怪名字 |
七、进阶：多模型切换与默认模型
配置好 DeepSeek 后，如果你想再加个 Kimi 备用（读长文档用），完全支持：
- 按上面的方式，再添加一个服务商（比如 Kimi 所属的"月之暗面"开放平台），同样拿到它的 API Key 填进来。
- 在 OpenCode 里，输入框旁边通常有个模型切换按钮，点一下就能在已配置的模型间切换。
- 在设置里可以指定默认模型，这样每次打开自动用 DeepSeek，省心。
建议：新手阶段只配 DeepSeek 一个就够了，先用顺手，以后再慢慢加。工具贵精不贵多。
八、安全与省钱的 5 条铁律
- Key 只存自己电脑里，截图打码，不分享。
- 泄露了怎么办：立刻去官网"删除该 Key"，重新生成一个新的。
- 先充小钱：10 元够玩很久，用不完不心疼。
- 看用量：DeepSeek 官网有用量明细，偶尔瞄一眼，做到心里有数。
- 没把握先问 AI：配置遇到问题，把报错原文发给 AI 问，往往比搜教程更快。
九、本篇小结
- API Key = 你的"充值卡 + 钥匙"，OpenCode 靠它替你调用 DeepSeek。
- 全流程 4 步：注册 → 充值 → 创建 Key → 填进 OpenCode，全程复制粘贴。
- 界面里就能配置，不用碰代码；配置文件是进阶玩法，可选。
- 配好后测一句"你好"，它回话就代表全部打通。
- 安全第一条：Key 谁都不给，泄露就删了重办。
下一篇预告：《实战一——让 AI 生成你的第一个 PPT》，你已经有了一台能干活的小助手，该让它亮一手了。