Clip musical

# Clip musical

Utilisez ce Skill pour générer un clip musical Freebeat depuis une chanson, un prompt et des références facultatives.

## Avant d’exécuter les commandes CLI

Freebeat CLI est un paquet npm et un client API authentifié. Installez-le ou mettez-le à jour d’abord:

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

L’utilisateur doit fournir une clé API Freebeat avant toute génération. Utilisez l’un de ces modèles:

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

Validez les identifiants avant de lancer un workflow payant ou long:

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

Ne collez pas et ne journalisez pas la clé API brute. Demandez à l’utilisateur de la fournir dans son terminal, coffre de secrets ou variable d’environnement.

## Préparer les assets

~~~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
~~~

## Soumettre une tâche MV depuis des assets importés

~~~bash
freebeat mv submit --music-id <musicId> --prompt "ville néon, coupes rapides" --image-url <imageUrl> --aspect-ratio 9:16 --wait
~~~

## Exécuter une tâche MV avec des assets locaux

~~~bash
freebeat mv run --audio song.mp3 --image ref.png --prompt "ville néon, coupes rapides" --aspect-ratio 9:16 --wait
~~~

Les commandes MV acceptent --image-url, --image, --mv-type, --style, --aspect-ratio, --resolution, --watermark, --start-ms, --end-ms et --wait.

## Vérifier la progression

Les commandes Open RPC image et vidéo renvoient un batch id et un numéro de série. Les commandes MV et effets héritées renvoient un task id.

~~~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>
~~~

Utilisez --json lorsqu’un agent, script ou CI doit parser task ids, batch ids, numéros de série, URLs de résultat, crédits ou statuts.