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.