Musikvideo

# Musikvideo

Nutze diesen Skill, wenn aus einem Song, Prompt und optionalen Referenzen ein Freebeat Musikvideo entstehen soll.

## 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.

## Assets vorbereiten

~~~bash
freebeat assets upload-audio --file song.mp3
freebeat assets upload-audio --url https://www.youtube.com/watch?v=abc123
freebeat assets upload-image ref-a.jpg ref-b.jpg
~~~

## MV-Task mit hochgeladenen Assets senden

~~~bash
freebeat mv submit --music-id <musicId> --prompt "Neonstadt, schnelle Schnitte" --image-url <imageUrl> --aspect-ratio 9:16 --wait
~~~

## MV-Task mit lokalen Assets ausführen

~~~bash
freebeat mv run --audio song.mp3 --image ref.png --prompt "Neonstadt, schnelle Schnitte" --aspect-ratio 9:16 --wait
~~~

MV-Befehle unterstützen Optionen wie --image-url, --image, --mv-type, --style, --aspect-ratio, --resolution, --watermark, --start-ms, --end-ms und --wait.

## 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.