WorkBuddy + Agnes：3 分钟接入无限期免费文本、图片、视频模型，告别 Token 焦虑

目录

• • 背景：Agnes AI 是什么？
  • 一、前置准备：两样东西
  • 二、第一步：注册拿 Key（2 分钟）
  • 三、第二步：配置文本模型（核心一步）
  • • 方式一：界面操作（推荐新手）
    • 方式二：编辑 models.json（推荐进阶用户）
  • 四、第三步：配置图片和视频模型
  • • 方式一：Skill 自动生成（最简单，推荐）
    • 方式二：MCP 连接器（功能更全，推荐进阶）
  • 五、实测效果：三大模型实战验证
  • • 5.1 文本对话
    • 5.2 文生图
    • 5.3 图生图
    • 5.4 文生视频
  • 六、踩坑避雷速查表（建议收藏）
  • 七、适用场景推荐
  • 总结：四步走完整接入
  • 参考链接

一句话速览：把 Agnes AI 的三大免费模型接入 WorkBuddy，文本对话、4K 生图、音画同步视频全部零成本调用——无需绑卡、无 Token 上限，仅限每分钟请求数。本文从注册到出图出视频，保姆级全流程实操，含 models.json 配置、MCP 连接器搭建、踩坑避雷全套方案。

背景：Agnes AI 是什么？

Agnes AI 是新加坡 Sapiens AI 公司旗下的全模态模型品牌，自研文本、图像、视频三大模型，完全兼容 OpenAI API 格式。自 2026 年 6 月 1 日起，三大模型 API 无限期、全球范围免费开放——无需绑卡、无 Token 额度上限，仅限制每分钟请求数（约 30 RPM）。

而 WorkBuddy 原生支持自定义 OpenAI 兼容模型，两者结合，你不需要写一行代码，在 WorkBuddy 聊天框里就能直接对话、生图、生视频。

本文基于 Agnes 官方 WorkBuddy 集成指南，把从零到出成果的完整流程拆解一遍。

一、前置准备：两样东西

二、第一步：注册拿 Key（2 分钟）

当前推广期所有模型免费调用，不扣费。免费版约 30 RPM（每分钟请求数），日常开发够用。

三、第二步：配置文本模型（核心一步）

WorkBuddy 有两种配置方式：界面操作和直接编辑配置文件。两种都讲。

方式一：界面操作（推荐新手）

方式二：编辑 models.json（推荐进阶用户）

配置文件路径：C:\\Users\\<你的用户名>\\.workbuddy\\models.json

添加文本模型配置：

{
"id": "agnes-2.5-flash",
"name": "Agnes 2.5 Flash",
"vendor": "Custom",
"url": "https://apihub.agnes-ai.com/v1",
"apiKey": "sk-你的API Key",
"supportsToolCall": true,
"supportsImages": true,
"supportsReasoning": true,
"useCustomProtocol": false
}

重启 WorkBuddy 后，在聊天界面切换到 Agnes 2.5 Flash 模型，发一句"你好"验证连通。

踩坑提醒：id 字段必须与平台实际模型名完全一致（区分大小写），否则会报 503 “No available channel for model”。不确定时用 GET /v1/models 接口查实际可用模型名。

四、第三步：配置图片和视频模型

文本模型走对话接口，图片和视频有两种接入方式。

方式一：Skill 自动生成（最简单，推荐）

直接在 WorkBuddy 聊天框输入：

我想使用 Agnes Image 2.1 Flash 模型生成图片，以及 Agnes Video V2.0 模型生成视频。
请访问 https://agnes-ai.com/doc/overview 并将其打包为一个 Skill。

WorkBuddy 会自动读取 Agnes API 文档，生成图像和视频相关的 Skill。生成后在 Skill 列表中即可调用：

• 生图：选择 agnes-image-gen Skill，输入提示词，如"赛博朋克城市夜景，霓虹灯光，电影风格，高细节"
• 生视频：选择 agnes-video-gen Skill，输入提示词，如"5 秒视频，亚洲女模特在白色摄影棚穿黑色连衣裙，镜头从全身缓慢移动到半身特写"

方式二：MCP 连接器（功能更全，推荐进阶）

MCP 方式可以更灵活地调用图片和视频 API，适合需要批量生成或自定义参数的场景。

1. 创建虚拟环境并安装依赖

# 用 WorkBuddy 自带 Python 创建虚拟环境
"C:/Users/<用户名>/.workbuddy/binaries/python/versions/3.13.12/python.exe" \\
-m venv "C:/Users/<用户名>/.workbuddy/binaries/python/envs/agnes"

# 安装 agnes-mcp 和 mcp
"C:/Users/<用户名>/.workbuddy/binaries/python/envs/agnes/Scripts/pip.exe" \\
install "agnes-mcp==0.3.1"
"C:/Users/<用户名>/.workbuddy/binaries/python/envs/agnes/Scripts/pip.exe" \\
install "mcp<2.0.0"

踩坑提醒：agnes-mcp 依赖 mcp.server.fastmcp，但 mcp v2.0.0 已重构模块路径，必须降级到 v1.x，否则报 ModuleNotFoundError。

2. 配置 MCP 服务

编辑 C:\\Users\\<用户名>\\.workbuddy\\mcp.json（注意是 mcp.json 不是 .mcp.json）：

{
"mcpServers": {
"agnes": {
"command": "C:\\\\Users\\\\<用户名>\\\\.workbuddy\\\\binaries\\\\python\\\\envs\\\\agnes\\\\Scripts\\\\python.exe",
"args": ["-m", "agnes_mcp"],
"env": {
"AGNES_API_KEY": "sk-你的API Key"
}
}
}
}

3. 激活服务

重启 WorkBuddy，在右上角「连接器管理」页面找到 agnes 条目，点击「信任」完成激活。

4. 追加图片和视频模型到 models.json

图片模型：

{
"id": "agnes-image-2.1-flash",
"name": "Agnes Image 2.1 Flash",
"vendor": "Custom",
"url": "https://apihub.agnes-ai.com/v1",
"apiKey": "sk-你的API Key",
"supportsToolCall": false,
"supportsImages": true,
"supportsReasoning": false,
"useCustomProtocol": false
}

视频模型：

{
"id": "agnes-video-v2.0",
"name": "Agnes Video V2.0",
"vendor": "Custom",
"url": "https://apihub.agnes-ai.com/v1",
"apiKey": "sk-你的API Key",
"supportsToolCall": false,
"supportsImages": false,
"supportsReasoning": false,
"useCustomProtocol": false
}

五、实测效果：三大模型实战验证

5.1 文本对话

切换到 agnes-2.5-flash，直接对话。256K 上下文窗口、支持 Tool Calling 和 Thinking Mode，日常编码、Agent 工作流、多轮对话都能胜任。SWE-bench Verified 75.6 分，日常代码任务体感与头部付费模型差距不大。

5.2 文生图

用 Skill 或 MCP 调用 agnes-image-2.1-flash，示例提示词：

一位穿旗袍的女性站在江南水乡的石桥边，晨光柔和，水面倒映着白墙黑瓦，电影级写实风格，浅景深。768×1024

实测：十几秒出图，构图、光影、细节都在线，旗袍纹理和背景水乡氛围到位。支持最高 4K（4096×4096）输出，免费额度内不扣费。

5.3 图生图

传入参考图 + 描述，模型会基于参考图生成新图。实测效果"像但又不是你"——会带有模型自己的审美风格，适合风格化创作，不适合需要严格保持人物身份的场景。

5.4 文生视频

用 Skill 或 MCP 调用 agnes-video-v2.0，示例提示词：

5 秒视频，亚洲女模特在白色摄影棚穿黑色连衣裙，镜头从全身缓慢移动到半身特写，同时自然转身。

特点：原生同步生成音频，支持 720P/1080P，最长 18 秒。实测生成时间约几分钟。注意：视频人物面部与原图会有差异，这是当前 AI 视频领域共性挑战，非 Agnes 独有。

六、踩坑避雷速查表（建议收藏）

七、适用场景推荐

总结：四步走完整接入

文本、图片、视频三大模型全部免费——三项能力零成本，适合日常办公和内容创作高频使用。

对开发者来说，最实际的改变是：以前在 WorkBuddy 里用付费模型，每调一次都在烧钱；现在接入 Agnes 后，对话、生图、生视频随便用，不用担心月底账单。免费版 30 RPM 对个人开发和小团队够用，高频生产场景可升级 Token Plan（Starter / Plus / Pro 三档）。

参考链接

• Agnes 官方 WorkBuddy 集成指南：https://wiki.agnes-ai.com/zh-Hans/docs/cid5
• Agnes 开发者平台：https://platform.agnes-ai.com
• Agnes 官方 FAQ（免费政策与定价）：https://wiki.agnes-ai.com/en/docs/faqs
• AgnesCode for VS Code：https://marketplace.visualstudio.com/items?itemName=AgnesAI.SapiensAI

声明：资源可能存在第三方来源，若有侵权请联系删除！

本文数据截至 2026年9月14日，基于多方信源交叉验证。免费政策与模型版本以官方最新文档为准。

觉得有用？点赞 + 收藏 + 关注，后续持续跟进相关内容。