Video musical

# Video musical

Usa este Skill para crear un video musical de Freebeat desde una canción, prompt y referencias opcionales.

## Antes de ejecutar comandos CLI

Freebeat CLI es un paquete npm y un cliente API autenticado. Instálalo o actualízalo primero:

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

El usuario debe proporcionar una clave API de Freebeat antes de generar. Usa uno de estos patrones:

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

Valida las credenciales antes de iniciar un flujo pago o de larga duración:

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

No pegues ni registres la clave API sin procesar. Pide al usuario que la proporcione en su terminal, gestor de secretos o variable de entorno.

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

## Enviar una tarea MV con assets subidos

~~~bash
freebeat mv submit --music-id <musicId> --prompt "ciudad neón, cortes rápidos" --image-url <imageUrl> --aspect-ratio 9:16 --wait
~~~

## Ejecutar una tarea MV con assets locales

~~~bash
freebeat mv run --audio song.mp3 --image ref.png --prompt "ciudad neón, cortes rápidos" --aspect-ratio 9:16 --wait
~~~

Los comandos MV admiten opciones como --image-url, --image, --mv-type, --style, --aspect-ratio, --resolution, --watermark, --start-ms, --end-ms y --wait.

## Comprobar progreso

Los comandos Open RPC de imagen y video devuelven un batch id y un número de serie. Los comandos MV y efectos heredados devuelven 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>
~~~

Usa --json cuando otro agente, script o CI necesite analizar task ids, batch ids, números de serie, URLs de resultado, créditos o estados.