म्यूजिक वीडियो

# म्यूजिक वीडियो

Song, prompt और optional references से Freebeat music video generate करने के लिए यह Skill use करें.

## CLI कमांड चलाने से पहले

Freebeat CLI एक npm package और authenticated API client है. पहले इसे install या refresh करें:

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

Generation से पहले user को Freebeat API key देनी होगी. इनमें से कोई pattern इस्तेमाल करें:

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

Paid या long-running workflow शुरू करने से पहले credentials validate करें:

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

Raw API key paste या log न करें. User से इसे terminal, secret store या environment variable में देने को कहें.

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

## Uploaded assets से MV task submit करें

~~~bash
freebeat mv submit --music-id <musicId> --prompt "neon city, fast cuts" --image-url <imageUrl> --aspect-ratio 9:16 --wait
~~~

## Local assets से MV task चलाएं

~~~bash
freebeat mv run --audio song.mp3 --image ref.png --prompt "neon city, fast cuts" --aspect-ratio 9:16 --wait
~~~

MV commands --image-url, --image, --mv-type, --style, --aspect-ratio, --resolution, --watermark, --start-ms, --end-ms और --wait जैसे options support करते हैं.

## Progress जांचें

Open RPC image और video commands batch id और serial number लौटाते हैं. Legacy MV और effect commands 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>
~~~

जब कोई agent, script या CI task ids, batch ids, serial numbers, result URLs, credits या statuses parse करे तो --json use करें.