Introduction
# Veo 3 Video Generation (Gemini API)
Use the bundled script to generate an MP4 from a text prompt.
## Generate (text → video)
```bash 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.
```bash 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.