Veo 3.1 Video Generation
Usage
Run from the user's current working directory (do NOT cd into the skill directory):
uv run scripts/generate_video.py --prompt "description" --filename "output.mp4" [--model MODEL] [--duration 4|6|8] [--aspect-ratio 16:9|9:16] [--api-key KEY]Use --url-only to skip the download and print just the video URL — useful for chaining with other tools:
uv run scripts/generate_video.py --prompt "description" --url-only [--model MODEL] [--duration 4|6|8]Workflow (draft → final)
- Draft —
--model veo3.1-fast --duration 4(cheapest, iterate on prompt) - Final —
--model veo3.1-pro-4k --duration 8(only when prompt is locked)
Model Options
| Model | Quality | Resolution | Cost |
|---|---|---|---|
veo3.1-fast (default) | Fast | 720p | Lowest |
veo3.1-fast-1080p | Fast | 1080p | Low |
veo3.1-fast-4k | Fast | 4K | Medium |
veo3.1-pro | Pro | 720p | Medium |
veo3.1-pro-1080p | Pro | 1080p | High |
veo3.1-pro-4k | Pro | 4K | Highest |
Map user requests:
- No mention / "draft" / "fast" →
veo3.1-fast - "1080p" / "HD" →
veo3.1-fast-1080p - "4K" / "ultra" →
veo3.1-fast-4k - "high quality" / "pro" →
veo3.1-pro - "best quality" / "pro 4K" →
veo3.1-pro-4k
Duration & Aspect Ratio
- Duration:
4(drafts),6,8(default/finals) seconds - Aspect ratio:
16:9(default, landscape),9:16(portrait/mobile)
API Key
Provide via --api-key argument or set GRSAI_API_KEY environment variable.
Troubleshooting
| Symptom | Resolution | |
|---|---|---|
Error: No API key provided. | Set GRSAI_API_KEY env var or pass --api-key | |
| HTTP 401 | Wrong or expired API key | |
Generation failed: | Content moderation or invalid input; rephrase prompt | |
| Timeout | Use a faster model (veo3.1-fast) or shorter duration (--duration 4) | |
uv: command not found | Install: `curl -LsSf https://astral.sh/uv/install.sh \ | sh`, then restart terminal |
For transient errors (HTTP 429, network timeouts), retry once after 30 seconds. Do not retry more than twice — surface the issue to the user instead.
Filename Convention
Pattern: yyyy-mm-dd-hh-mm-ss-descriptive-name.mp4
2025-11-23-14-23-05-sunset-mountains.mp42025-11-23-15-30-12-dancing-robot-neon.mp4
Output
Always prints VIDEO_URL: <full_url> on its own line after generation — use this to extract the URL for chaining.
Without --url-only: saves the file to disk and prints Video saved: <path>. Report the saved path to the user. Do not open or read the video back.
With --url-only: prints only the generation info and VIDEO_URL: line — no download, no --filename required.
Chaining with qwen-3-5-plus-video-feedback
Extract the URL from stdout and pass it directly to the feedback skill:
VIDEO_URL=$(uv run veo3-1/scripts/generate_video.py --prompt "..." --url-only | grep '^VIDEO_URL:' | cut -d' ' -f2)
uv run qwen-3-5-plus-openrouter/scripts/analyze_video.py --video-url "$VIDEO_URL" --prompt "Does this video match the prompt? Rate quality 1-10."Examples
uv run scripts/generate_video.py --prompt "A golden sunset over mountain peaks with birds flying" --filename "2025-11-23-14-23-05-sunset-draft.mp4" --model veo3.1-fast --duration 4uv run scripts/generate_video.py --prompt "Close-up of waves crashing on rocky shore, slow motion, cinematic" --filename "2025-11-23-15-30-12-ocean-waves.mp4" --model veo3.1-pro-4k --duration 8 --aspect-ratio 16:9