gemini-video-gen

Gemini Video Gen

Use this skill to generate short video clips powered by Google Veo 3.1. Video generation is asynchronous: you start a job, then poll until the MP4 is ready.

When to use this skill

• Product demos: Animate a UI flow, show a feature in action, or create a walkthrough clip.
• B-roll footage: Generate background video for a presentation, landing page, or social media post.
• Short animations: Bring a concept, diagram, or illustration to life as a few-second motion clip.
• Motion design concepts: Prototype a logo animation, loading screen, or transition effect.
• Marketing content: Short social clips, teaser videos, or visual hooks.

MCP tools

Tool	Purpose
gemini_start_video	Submit a video generation request; returns a job ID
gemini_get_video	Poll for job status and retrieve the completed MP4 when done

Async start+poll pattern

Video generation with Veo 3.1 is not instant. The typical workflow is:

1. Call gemini_start_video with a prompt. Receive a job_id.
2. Wait a few seconds (Veo 3.1 typically takes 20-90 seconds for short clips).
3. Call gemini_get_video with the job_id. If status is processing, wait and retry. If status is done, retrieve the output file path.

Do NOT spin-poll aggressively. Wait at least 10 seconds between poll attempts.

Usage pattern

Step 1: Start video generation

{
  "tool": "gemini_start_video",
  "arguments": {
    "prompt": "A mobile phone screen showing a recipe app. The user scrolls through a list of recipes, taps on 'Spaghetti Bolognese', and the detail screen slides in smoothly. Clean, modern UI, soft lighting.",
    "duration_seconds": 5,
    "aspect_ratio": "9:16"
  }
}

Response example: { "job_id": "veo-abc123", "status": "processing" }

Step 2: Poll for completion

{
  "tool": "gemini_get_video",
  "arguments": {
    "job_id": "veo-abc123"
  }
}

Poll every 15 seconds until status is done. Then the response will include an output file path or URL.