如何在 WorkBuddy 中导入自定义的 API Key？

编程并不是一个机械性的工作，而是需要有思考，有创新的工作，语法是固定的，但解决问题的思路则是依靠人的思维，这就需要我们坚持学习和更新自己的知识。今天golang学习网就整理分享《如何在 WorkBuddy 中导入自定义的 API Key？》，文章讲解的知识点主要包括，如果你对科技周边方面的知识点感兴趣，就不要错过golang学习网，在这可以对大家的知识积累有所帮助，助力开发能力的提升。

WorkBuddy 不支持在图形界面中直接输入 API Key，因「添加模型」UI 仅对预置提供商生效，选「自定义」后跳过密钥字段；密钥必须手动写入 ~/.workbuddy/models.json 文件，且修改后需完全退出并重启应用才生效。

WorkBuddy 不支持在图形界面中直接粘贴或输入 API Key —— 所有自定义模型的密钥必须通过修改 models.json 文件手动注入。

为什么不能在「模型」配置界面填 API Key？

WorkBuddy 的 Web UI 中的「添加模型」流程仅对预置提供商（如腾讯云、Kimi）生效；选择「自定义」后，UI 会跳过密钥字段，实际密钥需写入本地配置文件。这是当前 v4.6.4+ 版本的设计限制，不是 bug。

• UI 提交时不会校验或保存 api_key 字段，留空即被忽略
• 即使你看到「保存成功」提示，models.json 文件里也不会出现密钥内容
• 密钥明文写入本地 JSON 是唯一可靠方式，WorkBuddy 启动时只读取该文件

正确写入 API Key 的路径和格式

确保配置目录和文件存在，并按标准 JSON 格式填写密钥字段。路径必须是 ~/.workbuddy/models.json，其他位置（如项目根目录、/tmp）无效。

• 先执行 mkdir -p ~/.workbuddy 创建目录（注意中间是 -p，不是 _p）
• 用编辑器打开 ~/.workbuddy/models.json，不要新建同名文件放在别处
• 每个模型对象必须包含 "api_key" 字段，值为字符串，例如："api_key": "sk-xxx123"
• 若使用 Ollama 或本地部署模型，"api_key" 可设为空字符串 "" 或直接省略（但 HTTP 模型必须提供）

常见错误：密钥写对了却调用失败

API Key 能被读取，不代表请求能通。以下问题比密钥本身更常导致 401/403 错误：

• base_url 拼写错误，比如写成 baseurl 或漏掉 http:// 前缀
• 模型名（model 字段）与服务商要求不一致，例如 Kimi 必须用 moonshot-v1-8k，写成 kimi-8k 就拒收
• 没配 max_tokens 或 temperature 等必要参数，部分接口（如月之暗面）会静默拒绝无参请求
• JSON 末尾多了一个逗号（,），导致整个 models.json 解析失败，WorkBuddy 启动时不会报错，但模型列表为空

最易被忽略的一点：WorkBuddy 不会热重载 models.json。改完文件后必须完全退出应用（macOS 下右键 Dock 图标 →「退出」），再重新启动才能生效。

好了，本文到此结束，带大家了解了《如何在 WorkBuddy 中导入自定义的 API Key？》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多科技周边知识！