一句话总结：去 openrouter.ai 领个 Key，把 nex-agi/nex-n2.5-pro:free 配进 WorkBuddy，重启就能用。262K 上下文、支持图片输入、工具调用和推理，全程不花一分钱。

一、先唠两句：这次来的不是普通聊天模型

上回我给你扒了 MiniMax M3 的免费接入，我测试了一下，人家把免费的模型下架了。这回 OpenRouter 免费池里又来了个狠角色——Nex AGI 的 Nex-N2.5-Pro。我们今天换这个模型。

这模型啥来头？它是 Nex AGI 9 月 8 号刚发布的旗舰智能体模型，定位非常明确：专门干活的，不是陪你聊天的。

官方给它的定位是：把目标变成"可运行、可验证的结果"。说人话就是，它不光会写代码，还能自己探索代码库、改多文件、跑命令、启动应用、操作浏览器和桌面界面，然后从用户视角测试软件。发现结果不对，它还能自己诊断、改代码、再测试，直到跑通为止。

这配置啥水平？我直接给你列出来：

问题来了：这玩意儿原本是商业模型，按道理该收费。 但 OpenRouter（一个 AI 模型聚合平台，相当于模型界的"外卖平台"）给了一个免费版：把 :free 加到模型名后面，就能白嫖。

所以今天这篇教程就一件事：怎么把 OpenRouter 上免费版的 Nex-N2.5-Pro，接到 WorkBuddy 里。整个流程 10 分钟，全程不花一分钱，搞完你就有一个能看图、能改代码、能跑 Agent 的免费劳动力了。

为啥不直接用官方版本要绕 OpenRouter？两件事：1）官方渠道可能需要绑卡或海外支付，国内门槛高；2）OpenRouter 这个 :free 路由是真·免费，不用绑卡，直接拿。

二、准备：去 OpenRouter 领个通行证

动手之前，先办个"通行证"——API Key。这玩意儿相当于你调接口的账号密码。上次的流程不变，可以参考这篇文不用换，直接跳转到第四步接入就可以了，积分又不够了，不慌 MiniMax M3 免费接入 WorkBuddy 保姆教程

第 1 步：注册 OpenRouter 账号

打开浏览器，访问 https://openrouter.ai

。

右上角点「Sign In」，可以用 Google 账号、GitHub 账号、MetaMask 钱包登录，或者用邮箱注册一个新账号。邮箱注册最稳，建议用你常用的邮箱。

⚠️ 国内直连 openrouter.ai 偶尔会卡。如果页面加载不出来，你需要先解决网络问题。这不是 openrouter 的问题，是境外网站访问的常规情况。

第 2 步：去 Key 管理页签生成一个 Key

登录成功后，浏览器直接访问
https://openrouter.ai/keys（或者点右上角头像 → Keys），进入 Key 管理页面。

点页面上的「Create Key」按钮，给你的 Key 起个名字（比如 workbuddy-nex

），然后点确认。

系统会弹出一个只显示一次的 Key，格式是这样的：

sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

⚠️ 重点提醒：这个 Key 页面上只显示一次！ 生成后当场复制，粘到记事本里存好。关了页面再想看，只能重新生成一个。

安全提醒：API Key 等于你的账号密码。别截图发群里、别写进会公开分享的文档。本文里所有 Key 都用 sk-or-v1-你的OpenRouter密钥 占位，你实际填的时候换成自己的真 Key 即可。

第 3 步：看看免费版的额度限制

免费版没有 token 费用，但有调用速率限制。OpenRouter 的免费模型通常按账户状态分档限速（例如未充值账户每日请求数较少，充值后可提升），具体数值以 OpenRouter 当前页面为准。

普通体验、写写代码、跑跑 Agent，免费版足够。如果哪天真香了想长期用，把模型 ID 里的 :free 去掉就是付费版。

三、找模型：在 400+ 模型里精准定位

OpenRouter 上有 400 多个模型，自己一个个翻太费劲。下面三种方法任选其一：

方法一：直接访问免费版页面

浏览器打开
https://openrouter.ai/nex-agi/nex-n2.5-pro:free，直达模型详情页。

注意 URL 里的拼写是 nex-agi/nex-n2.5-pro:free，全部小写、冒号+free 拼上去。这是模型在 OpenRouter 上的"完整身份证号"，少一个字符都识别不了。

页面上能看到的核心信息我帮你列一下：

• 模型名：

nex-agi/nex-n2.5-pro:free（这个串就是你要在 WorkBuddy 里填的 id）

• 价格：Free
• 上下文：262K token（262,144）
• 发布日期：2026-09-08
• 输入类型：文本 + 图片
• 输出类型：文本
• 工具调用：支持
• 结构化输出：支持（JSON Schema）
• 推理能力：支持

方法二：用命令行查

如果你习惯终端，开个 Git Bash 跑一行：

curl -s https://openrouter.ai/api/v1/models \   -H "Authorization: Bearer sk-or-v1-你的OpenRouter密钥" \   | grep -o '"id":"nex-agi/nex-n2.5-pro:free"' 

返回了就是模型在架，没返回就是暂时下架或改名了。

方法三：在网页目录里翻

打开
https://openrouter.ai/models，左侧筛选器选「Free」，搜索框输 nex 或 N2.5，也能找到。

四、核心：把模型加进 WorkBuddy（小白三步版）

别看那一堆 JSON 了，小白照这三步走就行，全程 1 分钟。

打开 WorkBuddy 桌面版 → 看对话框左上角那个模型选择框（显示你现在用的模型名，比如"内置模型"或别的）→ 点一下 → 弹出来的列表里找「添加自定义模型 / 自定义模型管理」之类的按钮（不同版本叫法略不同，看到"自定义"三个字就对了）→ 点进去。

进去后你会看到一个表单，把下面这 4 个值逐个粘进去（其它的字段都保持默认，什么都别动）：填完点保存。等 3 秒，回到对话框的模型下拉框，你刚起的那个名字（比如"NEX N2.5 Pro 免费版"）就出现了——选它，发条"你好"试试，能回就完事了。

看到什么"厂商 / 协议 / 支持工具调用 / 支持图像"之类的小选项，全部保持默认。如果看到"支持推理 / Reasoning"选项，可以先勾上试试；如果遇到 400 报错，再把勾去掉重连。

进阶：为什么这样填就能用（30 秒看懂）

WorkBuddy 内置了"自定义模型"功能，本质上就是给它三样东西：

https://openrouter.ai/api/v1/chat/completions 是 OpenRouter 的"前台地址"，sk-or-v1-... 是你的"会员卡"，nex-agi/nex-n2.5-pro:free 是"点哪道菜"——三样齐了，WorkBuddy 就能帮你下单。

至于 OpenRouter 怎么跟上游模型沟通、key 怎么验证、返回结果怎么处理——WorkBuddy 全帮你干了，你不用管。这就是"填进去就能用"的原理。

五、验证： 确认能跑通

验证 ：在 WorkBuddy 里实测

在 WorkBuddy 对话框选 NEX N2.5 Pro 免费版，发一句"你是谁"。

正常情况：等 2-3 秒，模型用中文回答"我是 Nex N2.5 Pro..."。

异常情况： - 报错 400 is not a valid model ID → 模型 ID 拼错 - 报错 401 Unauthorized → Key 错了 - 报错 429 Too Many Requests → 触发限速，等几分钟再试 - 报错 408/超时 → 网络问题，检查代理或稍后重试

六、踩坑清单（省你两小时调试）

我把整个过程可能踩的坑全列这儿了，按出现频率排：

坑 1：模型 ID 拼错（最高频）

❌ Nex-N2.5-Pro-free（大小写错、没冒号） ❌ nex-agi/nex-n2.5-pro-free（少了冒号） ✅ nex-agi/nex-n2.5-pro:free（正确）

为什么会拼错？ 因为很多人直觉认为模型名就是品牌+版本号。OpenRouter 的命名规则是 品牌/模型名:变体，三段式，冒号、分隔符、大小写全都有讲究。

怎么避免？ 直接复制本文给你的那串，或者去
https://openrouter.ai/api/v1/models 接口里查真名。

坑 2：URL 填成 base url 形式

❌ https://openrouter.ai/api/v1 ✅ https://openrouter.ai/api/v1/chat/completions

WorkBuddy 的 url 字段需要完整端点路径，带 /chat/completions。填 base url 看着合理，但 WorkBuddy 不会自己拼，会直接报 404。

坑 3：勾了"支持推理"导致 400

NEX 本身是支持推理的，但 WorkBuddy 某些版本在勾了"支持推理"后，发给 OpenRouter 的 reasoning 参数格式可能不匹配，导致 400 报错。

解决方法：在 models.json 里把 "supportsReasoning": true 改成 false，或者直接去 UI 里把"支持推理"的勾去掉，然后完全退出再重开 WorkBuddy。

坑 4：完全没重启 WorkBuddy

改了 models.json 后不重启，新模型不会出现在下拉里。

不是关窗口那种"软关"——要真正退出进程。右下角托盘里小锦图标右键选「退出」，等 5 秒，再重新打开。

坑 5：网络问题

国内直连 openrouter.ai 不稳。如果你 WorkBuddy 调模型半天没反应，最后报超时/连接失败，但 curl 又能通——那大概率是 WorkBuddy 自己的网络出口被卡了。

这种情况： - 临时方案：用国内能直连的 OpenRouter 镜像（如果有的话） - 根本方案：把整个 WorkBuddy 的出网流量都挂代理

坑 6：API Key 误给别人

别把 Key 发群里、发微信对话里、commit 到 GitHub 公开仓库。OpenRouter 的 Key 没有 IP 限制，谁拿到都能用你的额度。

真要分享配置，把 apiKey 字段替换成 sk-or-v1-你的OpenRouter密钥 这种占位符。

坑 7：把免费版当永久免费

这点必须说清楚：:free 是 OpenRouter 当前的免费路由，不代表永久免费。 新模型上线期进免费池很常见，但免费窗口可能随时调整。

所以正确姿势是：当限时体验用，不当长期基建用。代码里如果要用，务必留一条 fallback（比如付费版或池内其它免费模型），别赌它明天还在。

七、几个常见疑问

Q1：免费版和付费版有啥区别？ A：价格、速率、内容过滤严格程度。模型能力、上下文大小、支持的参数都一样。把 id 里 :free 去掉就是付费版。

Q2：我的 Key 安全吗？ A：你账户下的 Key 别人拿到了能用。WorkBuddy 把 Key 存在 models.json 里（明文），所以别把这台电脑随便借人。

Q3：能同时配多个 OpenRouter 模型吗？ A：能。在 models.json 数组里多加几条，把 id 改一下就行。比如同时配 nex-agi/nex-n2.5-pro:free 和 MiniMax/MiniMax-M3:free，一个主攻智能体编程，一个主攻长上下文，换着来用。

Q4：模型下拉里没看到我配的？ A：四个原因：1）没重启 WorkBuddy；2）models.json 格式不对（漏了逗号或括号）；3）文件路径不对；4）编辑时编码出错（比如带 BOM 的 UTF-8）。

Q5：Nex AGI 这家公司靠谱吗？ A：Nex AGI 是专注于智能体模型的公司，N2.5 系列主打 agentic coding 和 computer use。OpenRouter 免费池上线当天就有大量开发者在测，Kilo Code、Claude Code 等编程 Agent 都在接这类模型。

Q6：它和 MiniMax M3 哪个更值得用？ A：看场景。MiniMax M3 强在 1M 超长上下文和多模态输入；Nex N2.5 Pro 强在智能体编程、工具调用和视觉反馈闭环。简单说：看长文档选 M3，改代码跑 Agent 选 NEX。

Q7：免费版每天能用多少次？ A：OpenRouter 免费模型的限速按账户状态分档，未充值账户通常较低（例如每日几十次），充值后可提升。具体数值以 OpenRouter 当前页面为准，建议别把免费模型用在高频生产任务上。

写完收工。核心动作就三步：注册拿 Key → 复制进 models.json → 重启 WorkBuddy。10 分钟搞定，白嫖一个能看图、能改代码、能跑 Agent 的免费劳动力。

白嫖嘛，能白嫖就白嫖。Happy prompting！

——小蚂蚁，一只正在帮 WorkBuddy 找免费劳动力的蚂蚁