AI Video Generation技能使用说明

设置

首次使用时，请阅读setup.md。

何时使用

用户需要使用当前模型和API生成、编辑或扩展AI视频。 使用此技能可选择合适的当前模型栈，编写更有效的运动提示，并运行可靠的异步视频处理流程。

架构

用户偏好设置持久保存在~/video-generation/目录中。具体设置请参见memory-template.md。

~/video-generation/
├── memory.md      # Preferred providers, model routing, reusable shot recipes
└── history.md     # Optional run log for jobs, costs, and outputs

快速参考

核心规则

1. 在调用API之前解析模型别名

首先将社区名称映射到真实的API模型ID。 示例：sora-2、sora-2-pro、veo-3.0-generate-001、gen4_turbo、gen4_aleph。

2. 根据任务而非品牌偏好进行路由

3. 廉价草稿，精细成品

先用短时长和低阶模型验证动作与构图，再用高级模型或更长时间重新渲染优胜者。

4. 将提示词设计为镜头指令

始终包含主体、动作、摄像机运动、镜头风格、灯光和场景时序。 对于参考画面及起止帧，需明确保持连续性约束。

5. 默认采用异步处理并预设失败可能

每个服务商流程必须支持任务队列、轮询/退避、重试、取消，以及在到期前通过签名URL下载。

6. 建立备用链

若首选模型受阻或过载：

1. 同一供应商的低层级模型，2) 跨供应商的等效模型，3) 开源模型/本地运行。

常见陷阱

• 在代码中仅使用模型昵称标签 -> 可避免的API故障
• 在验证3-5秒草稿前就推送8-10秒的生成内容 -> 浪费额度
• 生成后再裁剪，而非生成原生比例 -> 构图质量降低
• 忽略提示词增强开关 -> 不同供应商间的风格漂移
• 重用过期的输出URL -> 导出工作流中断
• 将所有供应商视为同步处理 -> 任务停滞和超时处理不当

外部端点

没有其他数据被发送至外部。

安全与隐私

离开您设备的数据：

• 提示文本
• 可选的参考图片或片段
• 请求的渲染参数（时长、分辨率、宽高比）

保留在本地设备的数据：

• 提供者偏好设置位于~/video-generation/memory.md
• 可选的本地任务历史记录位于~/video-generation/history.md

此技能不会：

• 在项目文件中存储API密钥
• 在请求的提供者调用之外上传媒体文件
• 删除本地资产，除非用户要求

信任

此技能可以将提示文本和媒体参考发送给第三方AI提供者。 仅当您信任这些提供者处理您的内容时，才请安装。

相关技能

通过以下命令安装clawhub install <slug>如果用户确认：

• 图像生成- 在视频生成前构建静态概念图和关键帧
• 图像编辑- 准备干净的参考图、遮罩和风格帧
• 视频编辑- 对生成的剪辑片段和最终导出文件进行后期处理
• 视频字幕- 添加字幕和文本叠加的工作流程
• ffmpeg- 合成、转码和打包制作输出

反馈

• 如果觉得有用：clawhub star video-generation
• 保持更新：clawhub sync