Studio immagini

# Studio immagini

Usa questo Skill per generazione di immagini statiche o modifica immagini guidata da prompt.

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

## Modelli immagine supportati

- 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

Controlla un modello prima della generazione:

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

## Generare una nuova immagine

~~~bash
freebeat image generate --model 80 --prompt "copertina album città neon" --size 1024x1024 --count 1 --wait
freebeat image generate --model 108 --prompt "poster prodotto premium con luce studio" --resolution 1024x1024 --quality medium --count 1 --wait
~~~

## Modificare un’immagine

La prima versione CLI accetta esattamente un --image. Usa un percorso locale o un URL immagine.

~~~bash
freebeat image edit --model 80 --image ref.png --prompt "rendila cinematica e pronta per campagna" --wait
freebeat image edit --model 108 --image https://cdn.example.com/ref.png --prompt "trasforma questo in una copertina album rifinita" --resolution 1024x1024 --quality medium --wait
~~~

## Parametri GPT-Image 2

GPT-Image 2 usa --model 108 e supporta --quality low|medium|high più --resolution. Da freebeat-cli 0.1.2, --quality predefinito è medium e --resolution predefinito è 1024x1024. Se --resolution manca ma --size è presente, la CLI invia il valore --size come resolution per compatibilità.

## Gestione output

I comandi immagine restituiscono batch id e numero seriale. Aggiungi --json per script o agenti.

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