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 - メインの生成スクリプト