设置

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

适用场景

用户需要借助当前模型与 API 生成、编辑或扩展 AI 视频。 使用本技能可选择合适的当前模型栈、编写更具表现力的运镜提示词，并运行稳定可靠的异步视频处理流水线。

架构

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

~/video-generation/
├── memory.md      # 首选服务商、模型路由策略、可复用的分镜模板
└── history.md     # 可选：任务执行日志，含耗时、费用与输出信息

快速参考

核心规则

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 安装以下技能：

• image-generation —— 在视频生成前构建静态概念图与关键帧
• image-edit —— 准备干净的参考图、蒙版与风格帧
• video-edit —— 对生成片段及最终导出内容进行后期处理
• video-captions —— 添加字幕与文字叠加工作流
• ffmpeg —— 合成、转码与封装生产级输出

反馈

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