WorkBuddy 自定义模型踩坑记：9 家免费 API 全配置指南

这两天看到好几篇文章都在说 WorkBuddy 的 hy3 模型 9 月要收费了。作为一个程序员，肯定要想其他的路子，毕竟能白嫖还是要白嫖的。

WorkBuddy 支持自定义模型，只要有 OpenAI 兼容接口，啥都能接。我挑了一个下午，把市面上的免费模型平台翻了个遍，注册了 9 家，逐家实测，最后全接上了。

中间踩了两个坑。第二个坑折腾了我快一个小时。这篇文章把整个过程写出来，包括踩坑的每一个细节。照着做，你应该能省下接下来一年的模型订阅费。

01

PART

先给结论

CONCLUSION · 9家全部免费

9 家全部实测通过，API 正常返回，一分钱没花。

— 9 把免费 API Key，一次全拿到

各家不太一样。Agnes AI 不用绑卡，速度也快，适合当主力。商汤的公测政策最慷慨，每 5 小时刷新额度，重度使用没问题。智谱中文能力在免费档里最能打。OpenRouter 是聚合站，一个 Key 调几百个模型，二十多个带 free 标记。NVIDIA 注册就送积分，永不过期，适合当备胎。

02

PART

注册和拿 Key

REGISTRATION · 各平台门槛

这一步没技术含量，但有几个地方要注意。

Agnes AI 和 OpenRouter 用邮箱就能注册，OpenRouter 还支持 Google 和 GitHub 登录，门槛最低。智谱、商汤、硅基流动、DeepSeek、基元律动这几家国内平台要中国手机号。阿里百炼和腾讯混元要云账号实名，麻烦一点，但额度实在。

！踩坑提示 🕳

NVIDIA 有个坑单独说。在 build.nvidia.com 注册后创建 API Key，有效期一定要选 Never Expire。默认选项有时效，到期 Key 直接作废，很多人在这里白白浪费注册福利。

各家拿 Key 的位置大同小异。登录控制台，找 API Keys 或 API 密钥，点创建，复制保存。每家平均五分钟。

03

PART

第一轮测试，顺利得可疑

FIRST TEST · 九家全部通过

拿到 Key 之后，我写了个 curl 脚本，逐家发请求。

九家全部返回 200。Agnes 回了一句「你好！我是 Agnes」。DeepSeek、硅基流动、阿里百炼各自打了个招呼。OpenRouter 的返回里带着费用字段，显示 cost 为 0。

我以为事情结束了。注册，拿 Key，填配置，收工。实际用时不到两小时，大部分时间在等短信验证码。

后来证明，真正的麻烦才刚开始。

04

PART

第一个坑，配置文件位置

TRAP 01 · 配置文件路径错误

把模型配置进 WorkBuddy 走的是配置文件，不是设置界面。这里埋了第一个坑。

我一开始把配置写到 ~/.codebuddy/models.json，网上搜到的教程都这么写。重启应用，模型下拉列表里空空如也。反复确认了 JSON 格式没问题，重启了三次，还是不行。

最后翻应用数据目录才发现，WorkBuddy 实际读的是另一个路径。

...text

~/.codebuddy/models.json　　← 错误路径，网上教程都这么写

~/.workbuddy/models.json　　← 正确路径，实际读取位置

— 配置文件路径写错，模型列表空无一物

文件格式也有讲究，必须是顶层数组，每个模型一个对象。

...json

[
{
"id": "agnes-2.0-flash",
"name": "Agnes AI · 2.0 Flash",
"url": "https://apihub.agnes-ai.com/v1",
"apiKey": "你的Key",
"supportsToolCall": true,
"supportsImages": true,
"supportsReasoning": true,
"useCustomProtocol": false
}
]

url 填 Base 地址，不要带 /chat/completions 后缀。supportsToolCall 要设成 true，否则 AI 助手没法调用工具，等于残废。改完配置要彻底退出应用再启动，托盘图标也要退出，光关窗口没用。

改对路径和格式之后，模型列表终于出现了。我当时想，这下总该成了吧。

05

PART

第二个坑，报错报得莫名其妙

TRAP 02 · max\_tokens 超限

模型出现在列表里，选中，发一条消息，几秒钟后弹出「模型错误」。

我挨个试了 Agnes、智谱、商汤、硅基流动、阿里百炼，全军覆没。腾讯混元的 hy3 能正常用。

第一反应是 Key 不对。但 curl 单测全部通过。同一个 Key，同一个模型，curl 能通，放进应用就报错。

好在应用有本地日志，位置在 ~/.workbuddy/logs/ 目录下，按日期分文件夹。翻到报错时间点的日志，找到了真正的错误信息。

Agnes 的：> max\_tokens exceeds the limit of 65536

商汤的：> field MaxTokens invalid, should be in [1, 65536]

硅基流动的：> max\_tokens (262144) exceeded max\_seq\_len (163840)

阿里百炼的：> Range of max\_tokens should be [1, 16384]

— 本地日志揭示了真正的错误：max\_tokens 超限

破案了。WorkBuddy 给没有配置输出上限的自定义模型，默认按 26 万的 max\_tokens 发请求。这个数字超过了每一家平台的上限。curl 测试时我没传这个参数，所以全都通过了。

各家上限整理如下，这张表建议存下来。

腾讯混元能直接用，就是因为它的上限够高，扛住了默认值。

06

PART

修复，以及一个野路子

FIX · maxOutputTokens 字段

解法不难。在 models.json 的每个模型条目里加一个字段。

...json

"maxOutputTokens": 8192

这个字段官方文档没提。我解开了应用的安装包 app.asar，在编译后的代码里搜 maxTokens 相关逻辑，确认了这个字段确实会被读取。没配置时默认取 20 万，请求时又可能放大到 26 万。

各家的安全值，按前面那张上限表填即可。懒得逐家填的，统一填 8192 最稳。

加完字段重启，九个模型全部正常对话。带工具调用、流式输出一起测，全部通过。

✦ 野路子提示

还有一个不改配置文件的野路子。设置环境变量 CODEBUDDY\_CODE\_MAX\_OUTPUT\_TOKENS 可以全局覆盖输出上限。适合不想一个个改配置的情况。

— 环境变量也可以全局设置 maxOutputTokens

07

PART

腾讯混元的地址也要留意

HINT · 正确的接口地址

补一个不算坑的坑。网上部分教程给腾讯混元 TokenHub 的接口地址是 api.tokenhub.cloud.tencent.com，这个域名解析不出来，直接连不上。

实际可用的地址是 tokenhub.tencentmaas.com。另外模型名要填 hy3，文档里有些地方写的 hunyuan-turbos 在这个接口下是不存在的模型 ID。

这个接口下能用的模型不少，我拉了一遍列表，118 个，DeepSeek 和智谱的模型也能从这里调。

广告

08

PART

基元律动，注册送 68 元额度

PLATFORM · 聚合网关推荐

上面九家都是官方平台。除了它们，还有一类聚合网关，把多个厂家的模型统一成一个入口，注册也送额度。

基元律动（TokenRhythm）就是其中之一。

一个 Key 调所有模型，这是聚合网关最大的好处。基元律动上面能直接调 DeepSeek、Qwen 这些模型，而且它不只能跑对话，文生图也能跑。我用它生成文章配图，出图干净不带水印。

赠送额度有效期 30 天，过期作废。适合短期集中用，这阵子要写文章、配图、跑任务，注册一个，额度用光再换别家，白嫖接力。

09

PART

终极方案，Ollama 本地跑，一分钱不花

LOCAL · Ollama 本地部署

如果上面的平台你都嫌折腾，还有一条更彻底的路线。

本地跑大模型最省事的工具是 Ollama。官网装一个，命令行拉模型就行。Qwen、Llama、DeepSeek、Gemmad 等 的开源版本都能拉，几个 GB 到几十 GB 不等，按需下载。

WorkBuddy 接本地模型也不难，把配置里的接口地址填 http://localhost:11434/v1 就行，跟接在线 API 一样。

— Ollama 本地部署，数据全在本机

这个方案的好处是彻底。不花任何一家的钱，没有限流，没有额度有效期，数据全在本机，敏感内容随便聊，不用担心内容出网。

代价是吃配置。内存 16G 以上能跑 7B 级别的模型，体验基本可用。配置不够的话，小模型跑起来也磕磕绊绊，还不如用上面的免费 API。

我的用法是本地 Ollama 常驻，处理敏感数据；在线免费 API 当日常主力，两边各管一摊。电脑配置够的话，强烈建议装一个。

///

LAST

写在最后

SUMMARY · 实话与心得

免费的东西，稳定性上就别抱太高期待了。智谱的免费模型在晚高峰经常限流，报 429 访问量过大，错峰使用没任何问题。各家免费额度政策随时可能调整，商汤现在是公测免费，公测什么时候结束没人知道。

我的用法是多个平台配置好，平时用 Agnes，限流了切商汤，复杂任务交给 NVIDIA 的 Nemotron，本地还跑着一个 Ollama 处理敏感数据。免费模型之间互相兜底，反而比单一付费渠道更稳当。

DeepSeek 官方虽然收费，但输入一元一百万 token，充 10 块钱个人用一个月绰绰有余，当保底很合适。

全部配置字段和各家接口地址，前文几张表里都列全了，对着填即可。模型文件用 ~/.workbuddy/models.json（不是 ~/.codebuddy），记得每个条目加 maxOutputTokens 字段。

愿你也能在模型收费的时代，把白嫖进行到底。

📎 厂商链接汇总

Agnes AI：platform.agnes-ai.com

OpenRouter：openrouter.ai

NVIDIA NIM：build.nvidia.com

智谱 AI：open.bigmodel.cn

商汤 SenseNova：platform.sensenova.cn

硅基流动：siliconflow.cn

DeepSeek 官方：platform.deepseek.com

阿里百炼：bailian.console.aliyun.com

腾讯混元 TokenHub：tokenhub.tencentmaas.com

基元律动 TokenRhythm：tokenrhythm.studio

Ollama：ollama.com

基元律动：https://tokenrhythm.studio/i/rf\_tr\_k\_Zg27Qn\_rkke9SaeQ46wq0F

我是 小左与AI，热衷于分享 AI 观察与干货。如果你也觉得这篇有用，记得点赞、关注、转发三连，我们下篇见。

既然看到这里了，如果觉得有用，随手点个赞、关注、转发三连吧。

点赞

关注

转发

THANKS FOR READING