Studio image

# Studio image

Utilisez ce Skill pour générer des images fixes ou modifier des images guidées par prompt.

## Avant d’exécuter les commandes CLI

Freebeat CLI est un paquet npm et un client API authentifié. Installez-le ou mettez-le à jour d’abord:

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

L’utilisateur doit fournir une clé API Freebeat avant toute génération. Utilisez l’un de ces modèles:

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

Validez les identifiants avant de lancer un workflow payant ou long:

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

Ne collez pas et ne journalisez pas la clé API brute. Demandez à l’utilisateur de la fournir dans son terminal, coffre de secrets ou variable d’environnement.

## Modèles image pris en charge

- 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

Inspectez un modèle avant génération:

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

## Générer une nouvelle image

~~~bash
freebeat image generate --model 80 --prompt "pochette d’album ville néon" --size 1024x1024 --count 1 --wait
freebeat image generate --model 108 --prompt "affiche produit premium avec éclairage studio" --resolution 1024x1024 --quality medium --count 1 --wait
~~~

## Modifier une image

La première version de la CLI accepte exactement un --image. Utilisez un chemin local ou une URL d’image.

~~~bash
freebeat image edit --model 80 --image ref.png --prompt "rends-la cinématique et prête pour campagne" --wait
freebeat image edit --model 108 --image https://cdn.example.com/ref.png --prompt "transforme ceci en pochette d’album soignée" --resolution 1024x1024 --quality medium --wait
~~~

## Paramètres GPT-Image 2

GPT-Image 2 utilise --model 108 et prend en charge --quality low|medium|high ainsi que --resolution. Avec freebeat-cli 0.1.2 ou plus récent, --quality vaut medium et --resolution vaut 1024x1024 par défaut. Si --resolution est omis mais --size fourni, la CLI envoie cette valeur comme resolution pour compatibilité.

## Gestion de sortie

Les commandes image renvoient un batch id et un numéro de série. Ajoutez --json pour scripts ou agents.

## Vérifier la progression

Les commandes Open RPC image et vidéo renvoient un batch id et un numéro de série. Les commandes MV et effets héritées renvoient 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>
~~~

Utilisez --json lorsqu’un agent, script ou CI doit parser task ids, batch ids, numéros de série, URLs de résultat, crédits ou statuts.