Agnes 短视频生成
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_858115ff/agnes-video-skills。
技能介绍
要解决什么问题
当你手头只有一段文字分镜或创意描述,却需要一段可本地保存的 MP4 短视频(例如概念预览、分镜动画草图、社交媒体素材草稿),手动跑通「创建任务 → 轮询状态 → 下载文件」整套 Agnes API 流程容易踩坑:节点用错(.cn / .com)、num_frames 格式不合规、401 与网络超时难以区分。
本技能把 agnes-video-v2.0 封装成固定工作流:接收中英文提示词,通过 scripts/generate_video.py 向 POST /v1/videos 提交任务,自动轮询 GET /v1/videos/{task_id},完成后写入默认或自定义的 output/agnes_video.mp4。
技能如何工作
核心能力包括:
- 文生视频:
--prompt必填,可选--negative-prompt、分辨率(默认 768×1152)、帧率与总帧数(默认 121 帧、24fps,约 5 秒)。 - 图生视频:通过
--image与--mode(ti2vid/keyframes)从参考图开生成。 - 环境自检:
scripts/selfcheck.py校验 Python、API Key、网络(仅查/v1/models,不消耗生成积分)。 - 批量 / 多镜头:可参考
examples/batch_water_curtain.json与generate_batch.py按分镜 JSON 连续出片。
WorkBuddy 版默认 Base URL 为 https://apihub.agnes-ai.cn/v1;同一 Key 在该节点对文本模型与视频模型均有效。Key 来源优先级:config.json → 环境变量 AGNES_API_KEY → --api-key。
适用边界与注意点
num_frames必须为 8n+1 且 ≤441,否则 API 会直接报错。- 401「无效的令牌」多半是节点与 Key 不匹配,或 Key 已吊销;连接超时与 Key 无关,脚本内置 5 次指数退避重试。
- 依赖仅为 Python 3.8+ 标准库(
urllib),需能访问国内 apihub 节点;更细的字段说明见技能内references/api_reference.md。
使用场景
- 策划写好产品概念分镜文案,需要快速生成 5 秒左右竖屏 MP4 给内部评审。
- 美术提供一张关键帧参考图,要用 ti2vid 模式试出一段动态过渡效果。
- 活动运营按 `prompts_cn.md` 里不同画风各出一条短视频草稿做 A/B 选材。
- 多镜头水幕类脚本已整理成分镜 JSON,要按 `generate_batch.py` 连续生成多段视频文件。
适合人员
- 独立短视频创作者,习惯用中文提示词试镜头氛围再决定是否精修。
- 品牌营销同学,要在评审会上展示 AI 生成的概念片而非静态 mockup。
- 技术向内容制作人,希望用标准库脚本把 Agnes 任务轮询与下载固定进 WorkBuddy 工作流。
- 分镜 / 预演方向负责人,需要把 JSON 分镜表批量转成可播放的视频片段给导演看。