Back to Details

image-generator

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

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].
一款通过fal.ai API调用FLUX.1 [pro]模型生成高质量奇幻插画的Skill。

Prérequis

前提条件

Variable d'environnement requise :
bash
export FAL_KEY="votre_clé_api_fal"
所需环境变量 :
bash
export FAL_KEY="votre_clé_api_fal"

Utilisation Rapide

快速使用

bash
undefined
bash
undefined

Compiler si nécessaire

如有需要请编译

go build -o sw-image ./cmd/image
go build -o sw-image ./cmd/image

Portrait de personnage existant

生成已有角色肖像

./sw-image character "Aldric"
./sw-image character "Aldric"

Portrait de PNJ généré

生成PNJ肖像

./sw-image npc --race=elf --gender=f --occupation=skilled
./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"
./sw-image scene "Trois aventuriers explorent une crypte en pleine nuit par temps couvert"

Monstre

生成怪物图像

./sw-image monster dragon --style=epic
undefined
./sw-image monster dragon --style=epic
undefined

Commandes Disponibles

可用命令

Portrait de Personnage

角色肖像

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

Exemples:

示例:

./sw-image character "Aldric" --style=realistic ./sw-image character "Lyra" --style=painted
undefined
./sw-image character "Aldric" --style=realistic ./sw-image character "Lyra" --style=painted
undefined

Portrait de PNJ

PNJ肖像

bash
./sw-image npc [options]
bash
./sw-image npc [options]

Options:

可选参数:

--race=<race> Race (human, dwarf, elf, halfling)

--race=<race> 种族 (human, dwarf, elf, halfling)

--gender=<m|f> Sexe

--gender=<m|f> 性别

--occupation=<type> Type d'occupation

--occupation=<type> 职业类型

--style=<style> Style artistique

--style=<style> 艺术风格

Exemples:

示例:

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

Scène d'Aventure

冒险场景

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

Options:

可选参数:

--type=<type> Type de scène prédéfini

--type=<type> 预设场景类型

--style=<style> Style artistique

--style=<style> 艺术风格

--size=<size> Taille d'image

--size=<size> 图像尺寸

Types de scène:

场景类型:

tavern, dungeon, forest, castle, village,

tavern, dungeon, forest, castle, village,

cave, battle, treasure, camp, ruins

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
undefined
./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
undefined

Illustration de Monstre

怪物插画

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

Monstres disponibles:

支持的怪物类型:

goblin, orc, skeleton, zombie, dragon,

goblin, orc, skeleton, zombie, dragon,

troll, ogre, wolf, spider, rat, bat, slime,

troll, ogre, wolf, spider, rat, bat, slime,

ghost, vampire, werewolf, minotaur, basilisk,

ghost, vampire, werewolf, minotaur, basilisk,

chimera, hydra, lich

chimera, hydra, lich

Exemples:

示例:

./sw-image monster dragon --style=epic ./sw-image monster lich --style=dark_fantasy ./sw-image monster goblin --style=illustrated
undefined
./sw-image monster dragon --style=epic ./sw-image monster lich --style=dark_fantasy ./sw-image monster goblin --style=illustrated
undefined

Objet Magique

魔法物品

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

Types d'objets:

物品类型:

weapon, armor, potion, scroll, ring,

weapon, armor, potion, scroll, ring,

amulet, staff, wand, book, artifact

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"
undefined
./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"
undefined

Lieu / Carte

地点/地图

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

Types de lieux:

地点类型:

city, town, village, castle, dungeon,

city, town, village, castle, dungeon,

forest, mountain, swamp, desert, coast,

forest, mountain, swamp, desert, coast,

island, underworld

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"
undefined
./sw-image location dungeon "Les Mines Abandonnées" ./sw-image location castle "Forteresse de Shadowkeep" ./sw-image location forest "La Forêt des Murmures"
undefined

Prompt Personnalisé

自定义提示词

bash
./sw-image custom "<prompt>" [options]
bash
./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"
undefined
./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"
undefined

Styles Artistiques

艺术风格

StyleDescriptionUtilisation recommandée
realistic
Photoréaliste, détailléPortraits immersifs
painted
Style peinture à l'huileScènes, lieux
illustrated
Illustration digitalePNJ, personnages (défaut)
dark_fantasy
Sombre, atmosphériqueMonstres, donjons
epic
Cinématique, héroïqueBatailles, dragons
风格描述推荐用途
realistic
照片级写实，细节丰富沉浸式肖像
painted
油画风格场景、地点
illustrated
数字插画风格PNJ、角色（默认）
dark_fantasy
暗黑氛围感怪物、地下城
epic
电影级英雄风格战斗场景、巨龙

Tailles d'Image

图像尺寸

TailleDimensionsUtilisation
square_hd
1024x1024Objets, portraits
square
512x512Vignettes
portrait_4_3
768x1024Portraits verticaux
portrait_16_9
576x1024Portraits étroits
landscape_4_3
1024x768Scènes
landscape_16_9
1024x576Scènes panoramiques (défaut)
尺寸分辨率用途
square_hd
1024x1024物品、肖像
square
512x512缩略图
portrait_4_3
768x1024竖版肖像
portrait_16_9
576x1024窄幅肖像
landscape_4_3
1024x768场景
landscape_16_9
1024x576全景场景（默认）

Options Communes

通用可选参数

bash
--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)
bash
--style=<style>     # 艺术风格 (realistic, painted, illustrated, dark_fantasy, epic)
--size=<size>       # 图像尺寸 (square_hd, landscape_16_9, etc.)
--format=<format>   # 输出格式 (png, jpeg, webp)

Exemples d'Utilisation en Session

会话使用示例

Illustrer un personnage créé

为创建的角色生成插画

bash
undefined
bash
undefined

Créer le personnage

创建角色

./sw-character create "Thorin" --race=dwarf --class=fighter
./sw-character create "Thorin" --race=dwarf --class=fighter

Générer son portrait

生成角色肖像

./sw-image character "Thorin" --style=epic
undefined
./sw-image character "Thorin" --style=epic
undefined

Illustrer un PNJ rencontré

为遇到的PNJ生成插画

bash
undefined
bash
undefined

Générer le PNJ

生成PNJ

./sw-npc generate --race=human --occupation=authority --attitude=negative
./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
undefined
./sw-image npc --race=human --occupation=authority --style=dark_fantasy
undefined

Illustrer une scène de combat

为战斗场景生成插画

bash
undefined
bash
undefined

Logger le combat

记录战斗

./adventure log "Mon Aventure" combat "Embuscade de gobelins dans la forêt"
./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
undefined
./sw-image scene "Embuscade de gobelins dans une forêt sombre" --type=battle --style=epic
undefined

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
└── ...
图像会保存至
data/images/
目录，文件名基于时间戳自动生成唯一名称。
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.
通过fal.ai使用FLUX.1 [schnell]模型生成单张图像约需0.003美元，即1美元可生成约300张图像。

Dépannage

故障排除

Erreur "FAL_KEY environment variable not set"

错误提示 "FAL_KEY environment variable not set"

bash
export FAL_KEY="votre_clé_fal_ai"
bash
export FAL_KEY="votre_clé_fal_ai"

Erreur API 401

API 401错误

Vérifiez que votre clé API est valide sur fal.ai/dashboard/keys.
请前往fal.ai/dashboard/keys验证你的API密钥是否有效。

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
  • 为主题选择合适的艺术风格
  • 在描述中添加更多细节
  • 尝试使用
    --style=realistic
    以获取更丰富的细节

Lister les Options

查看可用选项

bash
./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
bash
./sw-image list              # 查看所有选项
./sw-image list styles       # 查看可用风格
./sw-image list scenes       # 查看场景类型
./sw-image list monsters     # 查看怪物类型
./sw-image list items        # 查看物品类型
./sw-image list locations    # 查看地点类型
./sw-image list sizes        # 查看图像尺寸

Utilisé par

适用场景

Ce skill est utilisé par les agents suivants :
AgentUsage
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
该Skill被以下Agent使用：
Agent用途
dungeon-master
生成场景与角色插画
类型 : 独立Skill，可通过
/image-generator
直接调用
依赖关系 : 可与
character-generator
和
npc-generator
配合使用，为生成的角色创建插画