用途:该技能用于通过 Google Veo 3.x 模型(经 Gemini API / google-genai 调用)从文本提示词生成短视频,并将多个短片段拼接成较长视频。适合制作广告、UGC 风格短片等视频素材。
主要能力:\n1. 文本生成视频:调用内置脚本 generate_video.py,将文本提示词生成 MP4 文件。脚本支持指定模型(如 veo-3.1-generate-preview)、画面比例(如 9:16)、输出文件名与轮询间隔(--poll-seconds)。\n2. 分段拼接长视频:Veo 通常每次请求输出约 8 秒片段,可使用 --segments 参数生成多段并借助 ffmpeg 拼接为更长视频。每个分段发送一次请求,一次提示词对应一次 Veo 请求。\n3. 分段一致性控制:--base-style 可为每个分段提示词前置统一风格描述;--segment-prompt 可逐段指定提示词(覆盖 --prompt);--segment-style continuation(默认)在使用 --prompt 时为各段追加连续性说明,same 则对每段使用完全相同的提示词。\n4. 末帧衔接:--use-last-frame 在第 2 段及之后提取上一段最后一帧,作为下一段的 lastFrame 以提升连续性。\n5. 进度与中间文件:--emit-segment-media 在每段完成时输出 MEDIA: 便于观察进度;--keep-segments 保留中间 *.segXX.mp4 文件。\n6. 参考图引导:--reference-image 可重复传入图片路径,用产品或风格参考引导生成。\n\n使用方式:通过 uv run 执行脚本,例如生成单段视频:uv run {baseDir}/scripts/generate_video.py --prompt "A close up of ..." --filename "out.mp4" --model "veo-3.1-generate-preview" --aspect-ratio "9:16" --poll-seconds 10。生成多段拼接视频时增加 --segments 3 与 --segment-style continuation 等参数。\n\n适用场景:需要从提示词快速产出短视频片段的广告、UGC 风格内容;需要将多个约 8 秒片段组合成更长视频;需要通过参考图控制产品或风格一致性的生成任务。\n\n限制与要求:需要设置 GEMINI_API_KEY 环境变量(或使用 --api-key);当 --segments 大于 1 时,需在 PATH 中安装 ffmpeg。常见错误:429/RESOURCE_EXHAUSTED 表示 API 密钥没有视频配额或计费;503/UNAVAILABLE 表示模型过载,需稍后重试。其他功能、收费与效果细节暂未提供。