Agnes无限期免费！我做了专门生图、生视频的WorkBuddy Skill
做自媒体、运营内容团队的朋友，应该深有体会：
写文章、做短视频最大的卡点，往往不是写文案，而是配图、素材制作。
各种绘图、视频生成工具要么按次扣费，要么额度有限；手动复制API地址、调试参数、等待视频任务，来回折腾半小时，效率极低。
7月13号 Agnes AI 正式推出2.5 Flash版本，短短一个月，国内域名 agnes-ai.cn 上线，API从国际.com切换国内.cn节点。
之前使用国际站生成图片、视频经常卡顿、加载慢，现在国内版 agnes-image-2.1-flash 、 agnes-image-2.0-flash 速度提升非常明显。
最关键的一点：无限期免费使用。
资源摆在眼前，但直接让WorkBuddy原生调用坑非常多：端点容易选错、密钥混淆、视频是异步任务经常不等渲染完成就中断、参数格式出错，十次调用五次翻车。
折腾一段时间，我直接开发了 agnes-ai-media 专属Skill，完美适配WorkBuddy，同时兼容Hermes。
它不是简单调用绘图模型，而是把站点切换、API密钥管理、请求参数、异步轮询、文件下载校验整套工作流封装完毕。
现在只需要一句话指令，WorkBuddy就能稳定完成文生图、图生图、图文转视频，不用再纠结繁杂接口规则。
一、先搞懂：这套Skill解决哪些痛点

很多人直接在Agent里调用Agnes，普遍踩这些坑：
✅ 分不清国内站、国际站密钥，两套Key混用直接报错
✅ 图片、视频请求参数格式不匹配，反复调试Prompt
✅ 视频属于异步任务，发起请求直接结束，拿不到成品文件
✅ 生成链接无法自动下载，还要手动复制浏览器打开
✅ 网络波动接口访问失败，没有容灾重试方案
我的 agnes-ai-media 直接把所有规范固化：
1. 默认优先使用国内站点agnes-ai.cn，网络异常自动重试国际站；参数错误、限流不会盲目切换站点，避免重复生成任务浪费资源
2. 统一规范图片、视频接口请求格式，区分文生图、图生图、图生视频调用路径

3. 视频任务自动轮询状态，必须等到completed状态才下载成品
4. 文件落地校验，自动保存到本地目录，确认文件有效才算任务完成
二、Agnes站点密钥配置步骤
Agnes国内站、国际站密钥相互独立，不能通用，分开创建、分开保存。
1. 登录对应站点控制台，打开API Key管理页面，生成密钥
2. 在WorkBuddy用户目录 \.workbuddy\skills 或者项目根目录新建 .env 文件
plaintext
# Agnes国内站
AGNES_CN_API_KEY=填入你的国内密钥
# Agnes国际站
AGNES_API_KEY=填入国际密钥
只使用国内站，仅填写AGNES_CN_API_KEY；想要自动容灾，两套密钥全部配置。仓库附带.env.example模板，可以直接复制修改。
三、WorkBuddy部署Skill流程
1. 下载完整仓库
2. 将整个 agnes-ai-media 文件夹复制到路径：
C:\Users\用户名\.workbuddy\skills\
3. 重启WorkBuddy，系统自动识别加载Skill
4. 对话输入指令启用： /agnes-ai-media
部署完成，直接下发创作指令即可。
示范指令1｜文章封面（文生图，头条公众号通用）
使用Agnes中国站生成图片。
画面：清晨的内容工作室，木质桌面摆放笔记本电脑、相机、分镜稿，屏幕展示AI工作流；主体靠右，左侧预留三分之一空白放标题；商业写实摄影，柔和自然光，无任何文字、水印。
规格：16:9，1K
保存文件：agent-work-header.png
示范指令2｜图生图改造产品素材
使用Agnes中国站进行图生图。
输入图片：本地图片路径/公网图片链接
需求：保留产品外形与配色，背景替换简约浅灰色科技工作室，柔和侧逆光，适合SaaS官网首页；不改动产品原有logo文字。
比例：16:9，1K
保存：product-home-hero.png
示范指令3｜图生短视频（视频号、短视频开场素材）
使用Agnes中国站图生视频。
素材链接：封面图片公网地址
镜头效果：画面轻微推镜，纸张边缘微风晃动，屏幕蓝色光点缓慢流动，画面稳定自然，不新增人物文字。
参数：24fps，121帧（约5秒短视频）
保存：video-opening-5s.mp4
补充知识点：Agnes视频帧数遵循8n+1规则，121帧、241帧、441帧可用，不要随意填写数字。
四、新手最容易踩的坑，提前避开
1. ❌ 图生图不要用 /v1/images/edits 路径，统一调用图片生成接口，图片资源放入extra_body.image数组
2. ❌ 不要直接传入本地文件路径，Agnes服务端无法读取，本地图片需要转为公网链接或者base64
3. ❌ 402报错=账户配额问题，不会自动切换站点；429请求限流，降低调用频率
4. ❌ 不要认为视频提交请求立刻出片，必须持续轮询video_id，等待任务完成
五、完整落地工作流（自媒体直接照搬）
配置.env密钥 → WorkBuddy加载agnes-ai-media Skill
→ 文生图制作文章头图
→ 不满意直接图生图二次优化画面
→ 选取优质封面生成5秒短视频素材
→ 自动下载图片、视频至本地文件夹

整套流程全部交给WorkBuddy自主执行，我们只需要专注构思画面创意，不用钻研复杂API文档。
很多人只把WorkBuddy当成聊天工具，却忽略Skill真正的价值：把零散API整合为稳定可复用的自动化流水线。
Agnes提供免费的图文视频生成能力，而这套 agnes-ai-media Skill，就是打通WorkBuddy和Agnes的桥梁。
如果你正在搭建AI内容自动化工作流，这套Skill可以直接纳入你的工具库。