veo3-1
Generate videos with Google Veo 3.1 via grsai.com API. Use for any video creation, text-to-video, or motion content requests. Triggers on "generate video", "create a clip", "make a video of", "video of", "animate". Supports fast/pro quality tiers; 720p/1080p/4K; 4/6/8-second durations; 16:9 and 9:16 aspect ratios.
Resources
1Install
npx skillscat add delneg/nano-banana-pro-skill-grsai-com/veo3-1 Install via the SkillsCat registry.
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]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
Save to current directory. Report the saved path to the user. Do not open or read the video back.
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:9Install
npx skillscat add delneg/nano-banana-pro-skill-grsai-com/veo3-1 Install via the SkillsCat registry.