Videostudio

# Videostudio

Nutze diesen Skill für Text-zu-Video-Generierung über Freebeat CLI.

## Vor dem Ausführen von CLI-Befehlen

Freebeat CLI ist ein npm-Paket und authentifizierter API-Client. Installiere oder aktualisiere es zuerst:

~~~bash
npm install -g freebeat-cli@latest
freebeat --help
~~~

Vor der Generierung muss ein Freebeat API-Schlüssel vorhanden sein. Nutze eines dieser Muster:

~~~bash
freebeat auth set-api-key
printf '%s' "$FREEBEAT_API_KEY" | freebeat auth set-api-key --stdin
freebeat --api-key <apiKey> <command>
~~~

Prüfe die Zugangsdaten, bevor ein kostenpflichtiger oder langer Workflow startet:

~~~bash
freebeat auth show
freebeat auth test
~~~

Füge den rohen API-Schlüssel nicht ein und logge ihn nicht. Der Nutzer soll ihn im Terminal, Secret Store oder als Umgebungsvariable bereitstellen.

## Unterstützte Videomodelle

- Pixverse C1: --model pixverse-c1 or 103
- Pixverse V6: --model pixverse-v6 or 94
- Sora 2 Pro: --model sora-2-pro or 56
- Kling V3 4K: --model kling-v3-4k or 112
- SeedDance 2.0: --model seedance-2.0 or 102
- SeedDance 2.0 Fast: --model seedance-2.0-fast or 101
- Wan V2.7 Video: --model wan-v2.7-video or 104
- HappyHorse: --model happy-horse or 111

Prüfe vor der Generierung ein Modell:

~~~bash
freebeat models help --name pixverse-c1
~~~

## Video generieren

~~~bash
freebeat video generate --model pixverse-c1 --prompt "schnelle Schnitte, Neonstadt, kinetische Kamera" --duration 5 --resolution 720p --aspect-ratio 16:9 --wait
freebeat video generate --model pixverse-v6 --prompt "dramatische Bühnenperformance mit weit schwenkender Kamera" --duration 5 --resolution 720p --generate-audio --wait
freebeat video generate --model sora-2-pro --prompt "surreale Nachtfahrt durch ein leuchtendes Musikfestival" --duration 8 --resolution 720p --aspect-ratio 16:9 --wait
freebeat video generate --model kling-v3-4k --prompt "4K-Musikvideoszene mit Tänzer unter Laserlicht" --duration 5 --resolution 4k --aspect-ratio 16:9 --wait
freebeat video generate --model seedance-2.0-fast --prompt "schnelle Tanzmontage mit buntem Bühnenlicht" --duration 5 --resolution 720p --aspect-ratio 9:16 --wait
~~~

## Modellgrenzen

- Pixverse C1: duration 1-15, 360p|540p|720p|1080p, supports --generate-audio.
- Pixverse V6: duration 5-15, 720p|1080p, supports --generate-audio.
- Sora 2 Pro: duration 4|8|12, 720p|1080p, aspect ratio auto|16:9|9:16.
- Kling V3 4K: duration 3-15, resolution 4k.
- SeedDance models: duration 4-15, resolution 720p.
- Wan V2.7 Video: duration 2-15, 720p|1080p.
- HappyHorse: duration 3-15, 720p|1080p.

## Fortschritt prüfen

Open-RPC-Bild- und Videobefehle geben eine Batch-ID und Seriennummer zurück. Legacy-MV- und Effektbefehle geben eine Task-ID zurück.

~~~bash
freebeat task status <batch-id>
freebeat task status <batch-id> --serial-no <serial-no>
freebeat task wait <batch-id> --serial-no <serial-no>
freebeat task status <task-id>
freebeat task wait <task-id>
freebeat task result <task-id>
~~~

Nutze --json, wenn ein Agent, Skript oder CI-Job Task-IDs, Batch-IDs, Seriennummern, Ergebnis-URLs, Credits oder Statuswerte parsen muss.