Estudio de imágenes

# Estudio de imágenes

Usa este Skill cuando el usuario quiera generar imágenes fijas o editar imágenes guiadas por prompt.

## Antes de ejecutar comandos CLI

Freebeat CLI es un paquete npm y un cliente API autenticado. Instálalo o actualízalo primero:

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

El usuario debe proporcionar una clave API de Freebeat antes de generar. Usa uno de estos patrones:

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

Valida las credenciales antes de iniciar un flujo pago o de larga duración:

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

No pegues ni registres la clave API sin procesar. Pide al usuario que la proporcione en su terminal, gestor de secretos o variable de entorno.

## Modelos de imagen compatibles

- 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

Inspecciona un modelo antes de generar:

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

## Generar una imagen nueva

~~~bash
freebeat image generate --model 80 --prompt "portada de álbum de ciudad neón" --size 1024x1024 --count 1 --wait
freebeat image generate --model 108 --prompt "póster premium de producto con iluminación de estudio" --resolution 1024x1024 --quality medium --count 1 --wait
~~~

## Editar una imagen

La primera versión de la CLI acepta exactamente un --image. Usa una ruta local o una URL de imagen.

~~~bash
freebeat image edit --model 80 --image ref.png --prompt "hazlo cinematográfico y listo para campaña" --wait
freebeat image edit --model 108 --image https://cdn.example.com/ref.png --prompt "convierte esto en una portada de álbum pulida" --resolution 1024x1024 --quality medium --wait
~~~

## Parámetros de GPT-Image 2

GPT-Image 2 usa --model 108 y admite --quality low|medium|high además de --resolution. En freebeat-cli 0.1.2 o superior, --quality usa medium y --resolution usa 1024x1024 por defecto. Si falta --resolution pero se proporciona --size, la CLI envía ese valor como resolution por compatibilidad.

## Manejo de salida

Los comandos de imagen devuelven un batch id y número de serie. Añade --json para scripts o agentes.

## Comprobar progreso

Los comandos Open RPC de imagen y video devuelven un batch id y un número de serie. Los comandos MV y efectos heredados devuelven un 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 cuando otro agente, script o CI necesite analizar task ids, batch ids, números de serie, URLs de resultado, créditos o estados.