इमेज स्टूडियो

# इमेज स्टूडियो

Still image generation या prompt-guided image editing के लिए यह 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 में देने को कहें.

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

Generation से पहले एक model inspect करें:

~~~bash
freebeat models help --name 108
~~~

## नई image generate करें

~~~bash
freebeat image generate --model 80 --prompt "neon city album cover" --size 1024x1024 --count 1 --wait
freebeat image generate --model 108 --prompt "studio lighting वाला premium product poster" --resolution 1024x1024 --quality medium --count 1 --wait
~~~

## Image edit करें

पहला CLI version ठीक एक --image स्वीकार करता है. Local file path या image URL use करें.

~~~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 "इसे polished album cover में बदलें" --resolution 1024x1024 --quality medium --wait
~~~

## GPT-Image 2 parameters

GPT-Image 2 --model 108 use करता है और --quality low|medium|high plus --resolution support करता है. freebeat-cli 0.1.2 या newer में --quality default medium और --resolution default 1024x1024 है. अगर --resolution omitted है लेकिन --size दिया गया है, CLI compatibility के लिए --size value को resolution के रूप में भेजता है.

## Output handling

Image commands batch id और serial number लौटाते हैं. Scripts या agents के लिए --json जोड़ें.

## 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 करें.