Estúdio de imagens

# Estúdio de imagens

Use este Skill para gerar imagens estáticas ou editar imagens guiadas por prompt.

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

## Modelos de imagem compatíveis

- 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

Inspecione um modelo antes da geração:

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

## Gerar nova imagem

~~~bash
freebeat image generate --model 80 --prompt "capa de álbum de cidade neon" --size 1024x1024 --count 1 --wait
freebeat image generate --model 108 --prompt "pôster premium de produto com iluminação de estúdio" --resolution 1024x1024 --quality medium --count 1 --wait
~~~

## Editar imagem

A primeira versão da CLI aceita exatamente um --image. Use caminho local ou URL de imagem.

~~~bash
freebeat image edit --model 80 --image ref.png --prompt "deixe cinematográfico e pronto para campanha" --wait
freebeat image edit --model 108 --image https://cdn.example.com/ref.png --prompt "transforme isto em uma capa de álbum polida" --resolution 1024x1024 --quality medium --wait
~~~

## Parâmetros GPT-Image 2

GPT-Image 2 usa --model 108 e aceita --quality low|medium|high mais --resolution. No freebeat-cli 0.1.2 ou mais recente, --quality usa medium e --resolution usa 1024x1024 por padrão. Se --resolution for omitido mas --size for informado, a CLI envia o valor de --size como resolution por compatibilidade.

## Tratamento de saída

Comandos de imagem retornam batch id e número serial. Adicione --json para scripts ou agentes.

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