image-generator

name	image-generator
description	Génère des images heroic fantasy pour BFRPG via fal.ai FLUX.1. Portraits de personnages/PNJ, scènes d'aventure, monstres, objets magiques et lieux. Utilise des prompts optimisés pour le style fantasy médiéval.
allowed-tools	["Bash"]

Image Generator - Générateur d'images Heroic Fantasy

Skill pour générer des illustrations fantasy de haute qualité via l'API fal.ai avec le modèle FLUX.1 [pro].

Prérequis

Variable d'environnement requise :

export FAL_KEY="votre_clé_api_fal"

Utilisation Rapide

# Compiler si nécessaire
go build -o sw-image ./cmd/image

# Portrait de personnage existant
./sw-image character "Aldric"

# Portrait de PNJ généré
./sw-image npc --race=elf --gender=f --occupation=skilled

# Scène d'aventure
./sw-image scene "Trois aventuriers explorent une crypte en pleine nuit par temps couvert"

# Monstre
./sw-image monster dragon --style=epic

Commandes Disponibles

Portrait de Personnage

./sw-image character <nom> [options]

# Exemples:
./sw-image character "Aldric" --style=realistic
./sw-image character "Lyra" --style=painted

Portrait de PNJ

./sw-image npc [options]

# Options:
#   --race=<race>          Race (human, dwarf, elf, halfling)
#   --gender=<m|f>         Sexe
#   --occupation=<type>    Type d'occupation
#   --style=<style>        Style artistique

# Exemples:
./sw-image npc --race=dwarf --gender=m --occupation=authority
./sw-image npc --race=elf --occupation=religious --style=dark_fantasy

Scène d'Aventure

./sw-image scene "<description>" [options]

# Options:
#   --type=<type>          Type de scène prédéfini
#   --style=<style>        Style artistique
#   --size=<size>          Taille d'image

# Types de scène:
#   tavern, dungeon, forest, castle, village,
#   cave, battle, treasure, camp, ruins

# Exemples:
./sw-image scene "Combat contre des gobelins" --type=battle --style=epic
./sw-image scene "Repos au coin du feu" --type=camp --style=painted
./sw-image scene "Une taverne animée" --type=tavern

Illustration de Monstre

./sw-image monster <type> [options]

# Monstres disponibles:
#   goblin, orc, skeleton, zombie, dragon,
#   troll, ogre, wolf, spider, rat, bat, slime,
#   ghost, vampire, werewolf, minotaur, basilisk,
#   chimera, hydra, lich

# Exemples:
./sw-image monster dragon --style=epic
./sw-image monster lich --style=dark_fantasy
./sw-image monster goblin --style=illustrated

Objet Magique

./sw-image item <type> [description] [options]

# Types d'objets:
#   weapon, armor, potion, scroll, ring,
#   amulet, staff, wand, book, artifact

# Exemples:
./sw-image item weapon "épée flamboyante ancienne"
./sw-image item potion "potion de guérison rouge brillante"
./sw-image item artifact "orbe de pouvoir mystérieux"

Lieu / Carte

./sw-image location <type> [nom] [options]

# Types de lieux:
#   city, town, village, castle, dungeon,
#   forest, mountain, swamp, desert, coast,
#   island, underworld

# Exemples:
./sw-image location dungeon "Les Mines Abandonnées"
./sw-image location castle "Forteresse de Shadowkeep"
./sw-image location forest "La Forêt des Murmures"

Prompt Personnalisé

./sw-image custom "<prompt>" [options]

# Pour des besoins spécifiques non couverts par les autres commandes

# Exemples:
./sw-image custom "Un groupe d'aventuriers traversant un pont de corde au-dessus d'un gouffre"
./sw-image custom "Une bibliothèque magique avec des livres volants"

Styles Artistiques

Style	Description	Utilisation recommandée
realistic	Photoréaliste, détaillé	Portraits immersifs
painted	Style peinture à l'huile	Scènes, lieux
illustrated	Illustration digitale	PNJ, personnages (défaut)
dark_fantasy	Sombre, atmosphérique	Monstres, donjons
epic	Cinématique, héroïque	Batailles, dragons

Tailles d'Image

Taille	Dimensions	Utilisation
square_hd	1024x1024	Objets, portraits
square	512x512	Vignettes
portrait_4_3	768x1024	Portraits verticaux
portrait_16_9	576x1024	Portraits étroits
landscape_4_3	1024x768	Scènes
landscape_16_9	1024x576	Scènes panoramiques (défaut)

Options Communes

--style=<style>     # Style artistique (realistic, painted, illustrated, dark_fantasy, epic)
--size=<size>       # Taille d'image (square_hd, landscape_16_9, etc.)
--format=<format>   # Format de sortie (png, jpeg, webp)

Exemples d'Utilisation en Session

Illustrer un personnage créé

# Créer le personnage
./sw-character create "Thorin" --race=dwarf --class=fighter

# Générer son portrait
./sw-image character "Thorin" --style=epic

Illustrer un PNJ rencontré

# Générer le PNJ
./sw-npc generate --race=human --occupation=authority --attitude=negative

# Générer son portrait dans la foulée
./sw-image npc --race=human --occupation=authority --style=dark_fantasy

Illustrer une scène de combat

# Logger le combat
./adventure log "Mon Aventure" combat "Embuscade de gobelins dans la forêt"

# Générer l'illustration
./sw-image scene "Embuscade de gobelins dans une forêt sombre" --type=battle --style=epic

Sortie

Les images sont sauvegardées dans data/images/ avec un nom unique basé sur le timestamp.

data/images/
├── image_1703001234567890123.png
├── image_1703001234567890124.png
└── ...

Coûts

FLUX.1 [schnell] via fal.ai coûte environ $0.003 par image, soit ~300 images par dollar.

Dépannage

Erreur "FAL_KEY environment variable not set"

export FAL_KEY="votre_clé_fal_ai"

Erreur API 401

Vérifiez que votre clé API est valide sur fal.ai/dashboard/keys.

Images de mauvaise qualité

• Utilisez un style approprié au sujet
• Ajoutez plus de détails dans les descriptions
• Essayez --style=realistic pour plus de détails

Lister les Options

./sw-image list              # Toutes les options
./sw-image list styles       # Styles disponibles
./sw-image list scenes       # Types de scènes
./sw-image list monsters     # Types de monstres
./sw-image list items        # Types d'objets
./sw-image list locations    # Types de lieux
./sw-image list sizes        # Tailles d'image

Utilisé par

Ce skill est utilisé par les agents suivants :

Agent	Usage
dungeon-master	Illustrations de scènes et personnages

Type : Skill autonome, peut être invoqué directement via /image-generator

Dépendances : Peut être utilisé avec character-generator et npc-generator pour illustrer les personnages créés