invokeai-image-gen

InvokeAI 图像生成

通过 InvokeAI 的 REST API 生成图像。支持 FLUX.2 Klein（默认）、Z-Image Turbo、FLUX.1 和 SDXL。

快速开始

只需使用提示词和输出文件名调用脚本：

python scripts/generate.py -p "A dramatic sunset over snow-capped mountains, warm orange light reflecting off a still alpine lake in the foreground. Soft clouds catch the fading light." -o sunset.png

覆盖默认模型

如果用户要求使用特定模型，请先查找模型键，然后在命令中使用：

python scripts/generate.py --list-models | grep -i 'flux'

python scripts/generate.py -p "A tabby cat with bright green eyes sits on a weathered wooden windowsill, soft afternoon light streaming through lace curtains. Cosy, intimate mood." --model MODEL_KEY -o cat.png

选项

选项	描述
--prompt, -p	生成提示词（必填）
--negative, -n	负面提示词（仅限 SDXL）
--model, -m	模型键（UUID）或部分名称匹配
--width, -W / --height, -H	尺寸
--steps, -s	去噪步数
--cfg, -c	CFG 比例
--guidance, -g	引导强度（仅限 FLUX.1）
--scheduler	采样调度器
--seed	随机种子
--output, -o	输出路径（默认：invokeai-{seed}.png）
--list-models	列出已安装的模型
--json	JSON 输出

模型默认值

注意：FLUX.2 Klein 是最新模型，也是默认使用的模型。

模型	步数	引导	CFG	调度器
FLUX.2 Klein	4	3.5	1.0	euler
Z-Image Turbo	9	-	1.0	euler
FLUX.1 dev	28	3.5	1.0	euler
FLUX.1 Krea dev	28	4.5	1.0	euler
FLUX.1 Kontext dev	28	2.5	1.0	euler
FLUX.1 schnell	4	0.0	1.0	euler
SDXL	25	-	6.0	dpmpp_2m_k
SDXL Turbo	8	-	1.0	dpmpp_sde

所有模型的默认尺寸均为 1024x1024。FLUX 要求尺寸可被 16 整除，SDXL 要求可被 8 整除。

FLUX.1 变体说明

• FLUX.1 dev：标准文生图模型，兼顾质量与速度
• FLUX.1 Krea dev：针对审美摄影进行微调，使用较高引导值（4.5）
• FLUX.1 Kontext dev：图像编辑模型，使用较低引导值（2.5）
• FLUX.1 schnell：蒸馏快速模型，4 步，无需引导

模型选择

自动优先级：Klein > Z-Image > FLUX > SDXL

按名称/基础模型检测：

• flux2_klein：名称中包含 "klein"，或基础模型中包含 "flux2"
• flux_krea：名称中包含 "krea"（FLUX.1 基础模型）
• flux_kontext：名称中包含 "kontext"（FLUX.1 基础模型）
• flux_schnell：名称中包含 "schnell"（FLUX.1 基础模型）
• flux：基础模型中包含 "flux"（标准 dev）
• zimage：基础模型中包含 "z-image"，或名称中包含 "z-image/zimage"
• sdxl：基础模型中包含 "sdxl"（自动检测 turbo/lightning 变体）

提示词编写（通用信息，对 FLUX.2 Klein 尤其有用）

使用描述性文字，而不是关键词。结构：主体 -> 场景 -> 细节 -> 光线 -> 氛围

A weathered fisherman in his late sixties stands at the bow of a wooden boat,
wearing a salt-stained wool sweater. Golden hour sunlight filters through
morning mist, creating quiet determination and solitude.

关键技巧：

1. 将关键元素放在前面（词序很重要）
2. 描述光线：光源、质感、方向、色温
3. 加入感官质感：材质、反射、氛围

好例子：“一位留着金色短发的女性，戴着色彩鲜艳的耳环，靠在手上托着下巴，在浅色中性背景前摆姿势。”

坏例子：“女性，金发，短发，中性背景，耳环”

添加风格标签：Style: Country chic. Mood: Serene, romantic.

故障排除

问题	解决方案
连接被拒绝	检查 InvokeAI 是否正在运行
未找到模型	使用 --list-models 获取有效键
尺寸错误	FLUX：16 的倍数；SDXL：8 的倍数
图像发黑（macOS）	在 invokeai.yaml 中设置 precision: bfloat16

如果脚本无法找到 URL 或身份验证令牌，可以设置环境变量，或请用户设置：

export INVOKEAI_API_URL='http://localhost:9090'
export INVOKEAI_AUTH_TOKEN='your-token'  # Optional

资源

• scripts/generate.py - 主生成脚本