---
name: "video-generator"
description: "Professioneller KI-Videoproduktions-Workflow für Videos, Kurzfilme, Werbespots und Videoinhalte."
---

# video-generator

Professioneller KI-Videoproduktions-Workflow für die Erstellung von Videos, Kurzfilmen, Werbespots oder anderen Videoinhalten mithilfe von KI-Generierungstools.

## Wann verwenden

- User fragt nach Video, Kurzfilm, Werbespot, Reel, TikTok, YouTube-Short
- Bewegtbild aus Text-Prompt oder Bild-Referenz
- Multi-Scene-Produktion mit narrativem Fluss

## Tools

- **Primär:** `video_generate` (OpenClaw built-in, mehrere Provider)
- **Status:** `video_generate action="status"`
- **Modell-Liste:** `video_generate action="list"`

## Workflow

### 1. Konzept (Pre-Production)
Vor jedem Generate-Call klären:
- **Format:** 16:9 (YouTube), 9:16 (TikTok/Shorts/Reels), 1:1 (Insta-Post)
- **Dauer:** Standard 4-8s pro Clip (Provider-abhängig)
- **Auflösung:** 720P/1080P/4K
- **Stil:** photoreal / animated / cinematic / kinetic
- **Audio:** mit/ohne generiertes Audio (`audio: true`)

### 2. Prompt-Struktur

```
[Subject] + [Action] + [Setting] + [Camera] + [Lighting] + [Style]
```

Beispiel:
> "A red fox running through a snow-covered forest at golden hour, low tracking shot, cinematic depth of field, hyperrealistic 4K"

### 3. Multi-Scene-Projekte

Bei längeren Videos:
1. **Storyboard erstellen** (Szenen-Liste mit jeweils Subject/Action/Setting)
2. **Konsistenz sichern:** gleiche Charaktere → identische Beschreibung (Kleidung, Farbe, Look)
3. **Image-to-Video:** ersten Frame als Referenz übergeben (`imageRoles: ["first_frame"]`)
4. **Last-Frame-Chaining:** letzter Frame Szene N = first_frame Szene N+1

### 4. Generierung

```
video_generate(
  prompt: "...",
  aspectRatio: "16:9",
  durationSeconds: 6,
  resolution: "1080P",
  audio: true,
  model: "qwen/wan2.6-t2v"  // optional
)
```

**Background-Task:** Nicht erneut callen für gleiche Anfrage — auf Completion warten.

### 5. Post-Production

- Multi-Clip-Merge → `ffmpeg` via `exec`
- Audio-Overlay → `ffmpeg -i video.mp4 -i audio.mp3 ...`
- Untertitel → siehe Skill `html-video-production` für HTML-basierte On-Screen-Text-Layer

## Provider-Wahl

| Use-Case | Empfehlung |
|---|---|
| Photoreal | wan2.6-t2v, kling |
| Animation/Stylized | sora-style, runway |
| Avatar/Talking-Head | Manus native (nicht hier) |
| HTML-basiert / editierbar | Skill `html-video-production` |

## Fallstricke

- ⚠️ Provider clampt `durationSeconds` oft auf 4/6/8s
- ⚠️ AspectRatio: nicht jeder Provider unterstützt alle Ratios
- ⚠️ Bei Multi-Scene: ohne Image-Referenzen springt der Look zwischen Clips
- ⚠️ Cost: Video-Generierung ist teuer — vorher Format/Dauer mit User klären

## Lieferung

- `MEDIA:<pfad>` in finaler Reply (auf eigener Zeile, kein Markdown)
- Bei mehreren Clips: jeden als eigene MEDIA-Zeile
