Agent Skills
返回列表
Agnes 短视频生成

Agnes 短视频生成

设计多媒体 更新于 2026.08.30

将以下提示词粘贴到你的 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 分镜表批量转成可播放的视频片段给导演看。