/veo-use

name: veo-use
description: "Create and edit videos using Google's Veo 2 and Veo 3 models. Supports Text-to-Video, Image-to-Video, Reference-to-Video, Inpainting, and Video Extension. Available parameters: prompt, image, mask, mode, duration, aspect-ratio. Always confirm parameters with the user or explicitly state defaults before running."

Veo Use

Use this skill to generate and edit videos using Google's Veo models (`veo-3.1` and `veo-2.0`).

This skill uses portable Python scripts managed by `uv`.

Prerequisites

Ensure you have one of the following authentication methods configured in your environment:

1. **API Key**:

• `GOOGLE_API_KEY` or `GEMINI_API_KEY`

2. **Vertex AI**:

• `GOOGLE_CLOUD_PROJECT`
• `GOOGLE_CLOUD_LOCATION`
• `GOOGLE_GENAI_USE_VERTEXAI=1`

Usage

1. Text to Video

Generate a video purely from a text description.

uv run skills/veo-use/scripts/text_to_video.py "A cinematic drone shot of a futuristic city" --output city.mp4

2. Image to Video

Generate a video starting from a static image context.

uv run skills/veo-use/scripts/image_to_video.py "Zoom out from the flower" --image start.png --output flower.mp4

3. Reference to Video

Use specific asset images (subjects, products) to guide generation.

uv run skills/veo-use/scripts/reference_to_video.py "A man walking on the moon" --reference-image man.png --output moon_walk.mp4

4. Edit Video (Inpainting)

Modify existing videos using masks.

**Modes:**

• `REMOVE`: Remove dynamic object.
• `REMOVE_STATIC`: Remove static object (watermark).
• `INSERT`: Insert new object (requires `--prompt`).

uv run skills/veo-use/scripts/edit_video.py --video input.mp4 --mask mask.png --mode INSERT --prompt "A flying car" --output edited.mp4

5. Extend Video

Extend the duration of an existing video clip.

uv run skills/veo-use/scripts/extend_video.py --video clip.mp4 --prompt "The car flies away into the sunset" --duration 6 --output extended.mp4

Common Options

• `--model`: Default `veo-3.1-generate-001`.
• `--resolution`: `1080p` (default), `720p`, `4k`.
• `--aspect-ratio`: `16:9` (default), `9:16`.
• `--duration`: `6` (default), `4`, `8`.

References

> **Before running scripts**, review the reference guides for prompting tips and best practices.

• [Prompting Guide](references/prompting.md) - Camera angles, movements, lens effects, and visual styles