---

name: veo3-video-gen description: Generate and stitch short videos via Google Veo 3.x using the Gemini API (google-genai). Use when you need to create video clips from prompts (ads, UGC-style clips, product demos) and want a reproducible CLI workflow (generate, poll, download MP4, optionally stitch multiple segments).

Veo 3 Video Generation (Gemini API)

Use the bundled script to generate an MP4 from a text prompt.

Generate (text → video)

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

Generate a longer video by stitching segments

Veo commonly outputs ~8s clips per request. Use --segments to generate multiple clips and concatenate them with ffmpeg.

Important: This skill sends one prompt per segment (one Veo request per segment). Use --base-style to keep style consistent across segments.

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

Options:

• --base-style "...": prepended to every segment prompt (recommended).
• --segment-prompt "..." (repeatable): provide one prompt per segment (overrides --prompt).
• --segment-style continuation (default): appends continuity instructions per segment (only when using --prompt).
• --segment-style same: uses the exact same prompt for each segment (only when using --prompt).
• --use-last-frame: for segment >=2, extract previous segment last frame and pass it as lastFrame for continuity.
• --emit-segment-media: print MEDIA: for each segment as it finishes (useful for progress).
• --keep-segments: keep intermediate *.segXX.mp4 files.
• --reference-image path.jpg (repeatable): guide generation with product/style references.

Requirements

• GEMINI_API_KEY env var (or --api-key).
• ffmpeg on PATH when using --segments > 1.

Troubleshooting

• 429/RESOURCE_EXHAUSTED: API key has no quota/billing for video.
• 503/UNAVAILABLE: model overloaded; retry later.