Skill

Video musicale

Trasforma brani caricati, prompt e immagini di riferimento in task video musicali Freebeat.

freebeat CLI

Prova oraPreinstallato

Utilizzo totale community

4Utilizzo crediti

8Generazioni totali

Informazioni sullo Skill

skill.md

# Video musicale

Usa questo Skill per generare un video musicale Freebeat da brano, prompt e riferimenti opzionali.

## Prima di eseguire comandi CLI

Freebeat CLI è un pacchetto npm e un client API autenticato. Installalo o aggiornalo prima:

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

L’utente deve fornire una chiave API Freebeat prima della generazione. Usa uno di questi schemi:

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

Verifica le credenziali prima di avviare un workflow a pagamento o lungo:

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

Non incollare né registrare la chiave API grezza. Chiedi all’utente di fornirla nel terminale, in un secret store o come variabile d’ambiente.

## Preparare asset

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

## Inviare un task MV con asset caricati

~~~bash
freebeat mv submit --music-id <musicId> --prompt "città neon, tagli rapidi" --image-url <imageUrl> --aspect-ratio 9:16 --wait
~~~

## Eseguire un task MV con asset locali

~~~bash
freebeat mv run --audio song.mp3 --image ref.png --prompt "città neon, tagli rapidi" --aspect-ratio 9:16 --wait
~~~

I comandi MV supportano opzioni come --image-url, --image, --mv-type, --style, --aspect-ratio, --resolution, --watermark, --start-ms, --end-ms e --wait.

## Controllare l’avanzamento

I comandi immagine e video Open RPC restituiscono batch id e numero seriale. I comandi MV ed effetti legacy restituiscono 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 quando un agente, script o job CI deve analizzare task id, batch id, numeri seriali, URL risultato, crediti o stati.