Veo 3 视频生成（Gemini API）

使用捆绑脚本来根据文本提示生成 MP4 视频。

生成（文本 → 视频）

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

通过拼接片段生成长视频

Veo 通常每次请求输出约 8 秒的片段。使用--segments来生成多个片段并使用 ffmpeg 将它们拼接起来。

重要提示：此功能会为每个片段发送一个提示（每个片段对应一个 Veo 请求）。使用--base-style以保持各片段间风格一致。

uv run {baseDir}/scripts/generate_video.py \
  --prompt "Same scene, consistent style..." \
  --filename "out-24s.mp4" \
  --model "veo-3.1-generate-preview" \
  --aspect-ratio "9:16" \
  --segments 3 \
  --segment-style continuation

选项：

• --base-style "..."：预置到每个片段提示前（推荐）。
• --segment-prompt "..."（可重复）：为每个片段提供一个提示（会覆盖--prompt）。
• --segment-style continuation（默认）：为每个片段附加连续性指令（仅在使用了--prompt时使用）。
• --segment-style same：对每个片段使用完全相同的提示词（仅在使用了--prompt时使用）。
• --use-last-frame：对于片段 >=2，提取前一个片段的最后一帧并将其作为lastFrame传递以保持连续性。
• --emit-segment-media：在每个片段完成时打印MEDIA:（用于显示进度）。
• --keep-segments：保留中间的*.segXX.mp4文件。
• --reference-image path.jpg（可重复使用）：使用产品/风格参考图像来引导生成。

要求

• GEMINI_API_KEY环境变量（或--api-key）。
• ffmpeg在PATH中，当使用--segments > 1时。

故障排除

• 429/RESOURCE_EXHAUSTED：API密钥没有视频的配额/计费。
• 503/UNAVAILABLE：模型过载；稍后重试。