video-generation

Files (3)

• SKILL.md
• sora.py · scripts/
• veo.py · scripts/

SKILL.md (first lines)

# Video Generation Skill

Generate videos using AI (Google Veo 3.1, OpenAI Sora).

**Capabilities:**
- 🎬 **Text-to-Video**: Create videos from text descriptions
- 🖼️ **Image-to-Video**: Animate images as the first frame
- 🔊 **Audio Generation**: Dialogue, sound effects, ambient sounds (Veo 3+)
- 🎭 **Reference Images**: Guide video content with up to 3 reference images (Veo 3.1)

## Prerequisites

### Default: Vertex AI (10 requests/minute) ⭐

Vertex AI is the default backend with 1400x higher rate limits:

```bash
# 1. Set your project
export GOOGLE_CLOUD_PROJECT=your-project-id

# 2. Authenticate (opens browser)
gcloud auth application-default login

# 3. Enable the API (one-time)
gcloud services enable aiplatform.googleapis.com
```

Add to your `.env` file:
```
GOOGLE_CLOUD_PROJECT=your-project-id
GOOGLE_CLOUD_LOCATION=us-central1
```

### Fallback: AI Studio (10 requests/day)

Only use if you don't have a GCP project:

- `GOOGLE_API_KEY` - Get from https://aistudio.google.com/apikey

### For Sora (OpenAI)

- `OPENAI_API_KEY` - For OpenAI Sora

## Available Models

### Google Veo Models

| Model | Description | Best For |
|-------|-------------|----------|
| `veo-3.1` | Highest quality (default) | Professional videos, dialogue, reference images |
| `veo-3.1-fast` | Faster processing | Quick iterations, batch generation |

**Both models include:**
- 720p/1080p resolution
- 4, 6, or 8 second duration
- Native audio (dialogue, SFX, ambient)
- Image-to-video (animate images)
- Reference images (up to 3)
- Video extension
- Batch/parallel generation

### OpenAI Sora
- **Best for**: Creative videos, cinematic quality, complex motion
- **Resolutions**: 480p, 720p, 1080p
- **Durations**: 5s, 10s, 15s, 20s
- **Features**: Text-to-video, image-to-video

## Workflow

### Step 1: Gather Requirements (REQUIRED)

⚠️ **Use interactive questioning — ask ONE question at a time.**

#### Question Flow

⚠️ **Use the `AskUserQuestion` tool for each question below.** Do not just print questions in your response — use the tool to create interactive prompts with the options shown.

**Q1: Image**
> "I'll generate that video for you! First — **do you have an image to animate?**
> 
> - Yes (provide path — I'll use it as the first frame)
> - No, generate from scratch"

*Wait for response.*

**Q2: Audio**
> "What **audio preference**?
> 
> - With audio (default) — Veo 3.1 generates dialogue, SFX, ambient
> - Silent video — no audio"

*Wait for response.*

**Q3: Model**
> "Which **model** would you like?
> 
> - `veo-3.1` — Latest, highest quality with audio (default)
> - `veo-3.1-fast` — Faster processing with audio
> - `veo-3` / `veo-3-fast` — Previous generation with audio
> - `sora` — OpenAI, up to 20 seconds, no audio"

*Wait for response.*

**Q4: Duration**
> "What **duration**?
> 
> - 4 seconds
> - 6 seconds
> - 8 seconds (default)"

*Wait for response.*

**Q5: Format**
> "What **aspect ratio and resolution**?
> 
> - 16:9 landscape, 720p
> - 16:9 landscape, 1080p
> - 9:16 portrait, 720p
> - 9:16 portrait, 1080p

From michaelboeding/skills, MIT.

More from michaelboeding/skills