名称： veo3-video-gen
描述： 通过 Gemini API (google-genai) 使用 Google Veo 3.x 生成并拼接短视频。适用于需要根据提示词（广告、UGC风格片段、产品演示）创建视频片段，并希望获得可复现的 CLI 工作流（生成、轮询、下载 MP4、可选拼接多个片段）的场景。

Veo 3 视频生成 (Gemini API)

使用内置脚本，根据文本提示生成 MP4 视频。

生成（文本 → 视频）

uv run {baseDir}/scripts/generate_video.py \
  --prompt "一个特写镜头..." \
  --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 "同一场景，风格一致..." \
  --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 参数）。
• 使用 --segments > 1 时，系统 PATH 中需安装 ffmpeg。

故障排除

• 429/RESOURCE_EXHAUSTED：API 密钥无视频生成配额或未设置计费。
• 503/UNAVAILABLE：模型过载；请稍后重试。