Videoclipe

# Videoclipe

Use este Skill para gerar um videoclipe Freebeat a partir de música, prompt e referências opcionais.

## Antes de executar comandos CLI

Freebeat CLI é um pacote npm e cliente API autenticado. Instale ou atualize primeiro:

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

O usuário deve fornecer uma chave API Freebeat antes da geração. Use um destes padrões:

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

Valide as credenciais antes de iniciar um fluxo pago ou demorado:

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

Não cole nem registre a chave API bruta. Peça ao usuário para fornecê-la no terminal, cofre de segredos ou variável de ambiente.

## 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 tarefa MV com assets enviados

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

## Executar tarefa MV com assets locais

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

Comandos MV aceitam opções como --image-url, --image, --mv-type, --style, --aspect-ratio, --resolution, --watermark, --start-ms, --end-ms e --wait.

## Verificar progresso

Comandos Open RPC de imagem e vídeo retornam batch id e número serial. Comandos legados de MV e efeitos retornam 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>
~~~

Use --json quando outro agente, script ou CI precisar analisar task ids, batch ids, números seriais, URLs de resultado, créditos ou status.