## 正文

### 先说结论

想免费用大模型，不用一个个平台去注册、去申请。OpenRouter 这类**模型聚合平台**，一个 API Key 就能调用几十个厂商的免费模型，接入自己的智能体（比如 WorkBuddy），全程不需要信用卡。

但「拿 Key」只是第一步，真正麻烦的是「接进智能体」：模型名怎么写、能力字段怎么填、文档写的参数上限是不是虚标、接完怎么确认真的能用。这些坑我一个不落都踩过，所以我把整套流程写成了一**个 Skill（model-connector）**，把我的踩坑经验固化进去：你只需要把 API Key 交给它，它自动完成查配置、验证、写入、实测。

我 2026-08-21 实测，从注册拿 Key 到智能体里真正跑通，全程 10 分钟、花了 0 元。这篇就是完整教程：skill 从哪来、怎么装、跑起来你会看到什么、每一步它为什么这么做。

### 聚合平台是什么：大模型界的「携程」

OpenRouter 自己不训练模型，它把几十个模型厂商（OpenAI、Anthropic、DeepSeek、智谱、Meta 这些）的 API 聚合到一个入口。你只需要跟它打交道，它帮你路由到背后的模型。

它对新手最友好的地方，是**免费模型**。为什么厂商愿意免费给你用？据公开资料整理，主要有三个原因：模型厂商拿免费额度做获客，希望你以后付费；部分免费模型的对话数据可能被用于训练，你拿免费额度，平台拿数据；免费用户是未来的付费用户。

理解这一点很重要：**免费不是慈善，是有交换条件的**。用免费模型做测试、学习、跑通流程完全没问题，别把生产环境的关键业务押在免费模型上。

### 准备工作：注册拿 Key + 安装 Skill

**第一步，注册 OpenRouter 拿 API Key：**

1. 打开 openrouter.ai，用 Google 或 GitHub 账号登录（支持邮箱注册）
2. 右上角头像 → Keys → Create Key，给 Key 起个名字
3. 复制保存弹出的 Key。注意：**Key 只显示一次**，关闭页面就看不到了

拿到的 Key 长这样，以 `sk-or-v1-` 开头：

```
sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
```

不需要信用卡，不需要手机验证。免费模型直接用。

**第二步，安装 model-connector skill：**

这个 skill 我开源在 GitHub（sichenai/sichen-skills），两种安装方式任选：

```bash
# 方式一：npx 一键安装（推荐）
npx skills add sichenai/sichen-skills

# 方式二：git clone 后手动复制
git clone https://github.com/sichenai/sichen-skills.git
# 把 skills/model-connector 整个目录复制到你的智能体 skill 目录
```

WorkBuddy 用户的 skill 目录是 `~/.workbuddy/skills/`，复制进去就能用。装完在智能体对话里输入 `@skill:model-connector`，能唤起就说明装好了。

### 核心：跑 Skill，全程自动

装好之后，接入就变成一句话的事。在智能体对话里发：

```
@skill:model-connector api_key:sk-or-v1-你的Key
```

skill 会自动往下跑。你不用手动改任何配置，但要**看懂它每步在做什么**，方便判断哪里出问题。它一共走六步：

**第一步：查注册表，识别模型。**

skill 内置了一份模型注册表，收录了常见模型的接入参数（官方接口地址、鉴权方式、模型名、能力字段、Token 上限）。你说"接入 OpenRouter 免费模型"或直接给模型名，它先匹配注册表；匹配到了就预填配置，没匹配到就自动去读官方文档提取参数。

我这次的模型是 `stealth/ox-alpha`，注册表里有，直接命中预填。

**第二步：官方元数据核对。**

skill 会去 OpenRouter 官方接口拉取这个模型的元数据，核对真实能力。我这次拉到的是：

| 项 | 官方值 |
|---|---|
| 上下文长度 | 1,048,576（1M） |
| 最大输出 | 131,072 |
| 输入模态 | 文本 + 图片 + 视频 |
| 输出模态 | 仅文本 |
| 定价 | 0 / 0（免费） |
| 推理 | 强制开启 |

这一步的意义：**注册表是起点假设，官方元数据才是权威**。模型能力会更新，注册表可能过期，所以每次接入都重新核对。

**第三步：三个探针实测。**

静态配置写得再对，不如实际发一次请求。skill 会连发三个探针：

1. **文本探针**：发一条最简请求，验证模型名和 Key 对不对（返回 200 且带内容 = 通）
2. **上限探针**：把 `max_tokens` 设成标称上限（131072）再发一次，验证文档没虚标。这一步很重要，文档写的上限经常虚标，不实测就写进配置，你选这个模型发长文时会直接报错
3. **图片探针**：带一张图发一次，验证是不是真的支持图片输入。能力字段最怕想当然，兄弟模型支持不等于这个模型支持，必须拿确切模型名实测

三个探针全过，才说明「这个模型真的能用」。

**第四步：写入配置。**

skill 把探针验证过的值写进智能体的自定义模型配置（WorkBuddy 是 `~/.workbuddy/models.json`）。这里有两个细节它替你守住了：

- **模型名 id 一字不差**。id 会被智能体原样当成请求里的 `model` 字段发给 API，多一个字符、大小写不对、斜杠写错，都会 404。所以 id 必须精确等于 OpenRouter 的模型 slug，比如 `stealth/ox-alpha`
- **能力字段如实填写**。支持什么填什么，不支持的不硬填。比如 Ox Alpha 支持图片输入（实测 200）、不支持图片输出（官方元数据只有文本输出），配置就按这个填，避免智能体误启用不存在的功能

**第五步：宿主层验证。**

写进配置文件 ≠ 智能体真的能用了。skill 会回到智能体里做两层验证：先看智能体的模型列表里有没有出现新模型（出现 = 配置被正确加载），再实际选这个模型发一句话，返回正常才算链路全通。

这一步我用命令行实测，返回：

```
我是 CodeBuddy Code，一个在命令行中帮你完成软件工程任务的交互式编程助手，底层由 ox-alpha 模型驱动。
```

**第六步：收工。**

到这一步，你在智能体的模型选择器里就能看到 `stealth/ox-alpha` 了，选它就能用。全程你没有手改过一行配置。

### Skill 自动帮你规避的坑

| 坑 | 手动接入时会发生什么 | skill 怎么规避 |
|---|---|---|
| 模型名 id 写错 | 404 model not found，排查半天 | 注册表 + 官方元数据核对，id 精确写入 |
| 文档上限虚标 | 配置写上界，发长文时 400 报错 | 上限探针实测，被拒就下调到真实可用值 |
| 能力字段想当然 | 不支持图片的模型被误开图片功能 | 图片探针拿确切模型名实测 |
| 429 限流被误判 | 以为是配置错，反复改 | 区分限流和参数拒绝：429 重试，400 才算真上限 |
| 配置写了没生效 | 模型列表里找不到，以为没写对 | 宿主层两步验证：列表检查 + 真实请求 |

免费模型还有一个现实问题：**随时可能下架或转收费**。厂商调整政策不打招呼，所以别把免费模型写死在关键路径上。用之前看一眼模型页的定价，用的时候多备一两个替代模型。model-connector 的注册表会随实测持续更新，同一模型下次接入更快。

### 诚实的说明

- 本文全部为实测：2026-08-21，WorkBuddy 5.3.14 + macOS 15.7.1，OpenRouter 免费模型 `stealth/ox-alpha`，接入全程 0 元
- 「厂商为什么提供免费模型」的三个原因，据公开资料整理（聚合平台商业模式分析），非官方说法
- 免费模型的限流数字，各来源说法不一，以 OpenRouter 模型页实时标注为准，文中不写死
- 免费定价有时效：Ox Alpha 截至 2026-08-21 定价为 0，之后可能变化，以 OpenRouter 实时定价为准
- model-connector 是我自研 skill，接入流程为我个人实测环境（WorkBuddy 5.3.14 + macOS）。其他智能体字段名可能不同，但「探针验证 + 宿主层验证」的思路通用

### 经验总结

把「接入聚合平台免费模型」从手动流程变成 skill，最大的价值不是省那几分钟，而是**把踩过的坑固化成流程**：查注册表、对官方元数据、三连探针、写配置、宿主验证，每一步都有明确目的，不会再靠猜。新手拿到手就是完整方法论。

**数据来源标注**：本文全部来自一次真实接入过程的工具实证（API 探针、官方元数据接口、命令行实测、智能体宿主层验证），实测环境为 WorkBuddy 5.3.14 + macOS 15.7.1 + OpenRouter，实测日期 2026-08-21。

想免费用大模型，不用一个个平台去注册、去申请。OpenRouter 这类模型聚合平台，一个 API Key 就能调用几十个厂商的免费模型，接入自己的智能体（比如 WorkBuddy），全程不需要信用卡。

OpenRouter 免费模型接入：model-connector Skill 从注册到Workbuddy跑通

人工智能

开发工具

后端

实测免费用大模型无需逐平台注册，OpenRouter聚合API一个Key即可接入几十个免费模型。本文教程展示自研model-connector Skill全自动流程：注册拿Key后，10分钟零成本完成模型接入。核心六步包括查注册表、官方元数据核对、三探针实测（文本/上限/图片）、精确写配置、宿主层双重验证。全程规避模型ID写错、文档虚标、能力误判等坑，2026-08-21实测通过。

数据接口

软件工程

代码解释

智能体

WorkBuddy 

DeepSeek

路由

GitHub

WorkBuddy企业版限时双倍 Credits 活动

workbuddy

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

实测免费用大模型无需逐平台注册，OpenRouter聚合API一个Key即可接入几十个免费模型。本文教程展示自研model-connector Skill全自动流程：注册拿Key后，10分钟零成本完成模型接入。核心六步包括查注册表、官方元数据核对、三探针实测（文本/上限/图片）、精确写配置、宿主层双重验证。全程规避模型...

OpenRouter 免费模型接入：model-connector Skill 从注册到Workbuddy跑通-腾讯云开发者社区-腾讯云

OpenRouter 免费模型接入：model-connector Skill 从注册到Workbuddy跑通

OpenRouter 免费模型接入：model-connector Skill 从注册到Workbuddy跑通

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐