Freebeat Generate

# Freebeat Generate

जब user image generation, image editing और text-to-video generation के लिए एक Freebeat entry point चाहता हो, यह 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 में देने को कहें.

## समर्थित model values

Image models:

- Nano Banana 2: --model 80
- Nano Banana Pro: --model 64
- Wan V2.7 Image: --model 99
- Wan V2.7 Pro Image: --model 100
- GPT-Image 2: --model 108

Video models:

- Pixverse C1: --model pixverse-c1 or 103
- Pixverse V6: --model pixverse-v6 or 94
- Sora 2 Pro: --model sora-2-pro or 56
- Kling V3 4K: --model kling-v3-4k or 112
- SeedDance 2.0: --model seedance-2.0 or 102
- SeedDance 2.0 Fast: --model seedance-2.0-fast or 101
- Wan V2.7 Video: --model wan-v2.7-video or 104
- HappyHorse: --model happy-horse or 111

Use करने से पहले model हमेशा inspect करें:

~~~bash
freebeat models list image
freebeat models list video
freebeat models help --name <model>
~~~

## Images generate करें

~~~bash
freebeat image generate --model 80 --prompt "neon city album cover" --size 1024x1024 --count 1 --wait
freebeat image generate --model 108 --prompt "electronic single के लिए cinematic album cover" --resolution 1024x1024 --quality medium --wait
~~~

## Images edit करें

~~~bash
freebeat image edit --model 80 --image ref.png --prompt "इसे cinematic और campaign-ready बनाएं" --wait
freebeat image edit --model 108 --image https://cdn.example.com/ref.png --prompt "इसे cinematic बनाएं" --resolution 1024x1024 --quality medium --wait
~~~

## Video generate करें

~~~bash
freebeat video generate --model pixverse-c1 --prompt "fast cuts, neon city, kinetic camera" --duration 5 --resolution 720p --aspect-ratio 16:9 --wait
freebeat video generate --model sora-2-pro --prompt "glowing music festival से surreal night drive" --duration 8 --resolution 720p --aspect-ratio 16:9 --wait
freebeat video generate --model seedance-2.0 --prompt "quick lighting changes के साथ energetic dance performance" --duration 5 --resolution 720p --aspect-ratio 9:16 --wait
~~~

## Model-specific notes

- GPT-Image 2 --model 108 use करता है. freebeat-cli 0.1.2 या newer में omitted होने पर CLI default --quality medium और --resolution 1024x1024 भेजता है. आप --resolution explicitly दे सकते हैं, जैसे 1024x1024, 1024x1536 या 1920x1088.
- Pixverse C1 और Pixverse V6 --generate-audio support करते हैं.
- Kling V3 4K को --resolution 4k चाहिए.
- Sora 2 Pro duration 4, 8 या 12 support करता है.
- SeedDance 2.0 और SeedDance 2.0 Fast 720p output 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 करें.