EasyLoader (Kolors) ノード(kolorsLoader)

EasyLoader (Kolors) ノード（kolorsLoader）は、UNet、VAE、ChatGLM3 テキストエンコーダー、オプションの LoRA を含む完全な Kolors 推論パイプラインを 1 ステップで読み込みます。EasyUse/Loaders カテゴリに分類されています。準備された MODEL と VAE を返すことに加えて、後段の EasyUse ノードが直接利用できる PIPE_LINE も構築します。

説明

Kolors は、標準的な CLIP ベースのエンコーダーの代わりに ChatGLM3 をテキストエンコーダーとして使用する、テキストから画像へのモデルファミリーです。このローダーはそのアーキテクチャに特化しており、必要なモデル構成要素を読み込み、EasyUse パイプライン、モデル、VAE を 1 つのノードで構築します。プロンプトのエンコードには ChatGLM3 が必要なため、chatglm3_name ウィジェットは必須です。

入力

必須

• unet_name (コンボ): 読み込む Kolors UNet ファイルを選択します。
• vae_name (コンボ): 潜在変数のデコードに使用する VAE ファイルを選択します。
• chatglm3_name (コンボ): positive と negative のエンコードに使用する ChatGLM3 テキストエンコーダーファイルを選択します。
• lora_name (コンボ): 適用する LoRA を選択します。選択肢は ComfyUI が認識している LoRA ファイルです。
• lora_model_strength (浮動小数点, デフォルト=1, 最小=-10, 最大=10, ステップ=0.01): 拡散モデルの重みに対する LoRA の適用強度です。0 にするとモデル側の LoRA 効果が無効になり、負の値を指定すると反転します。
• lora_clip_strength (浮動小数点, デフォルト=1, 最小=-10, 最大=10, ステップ=0.01): ChatGLM3 テキストエンコーダーの重みに対する LoRA の適用強度です。0 にするとテキストエンコーダー側の LoRA 効果が無効になり、負の値を指定すると反転します。
• resolution (コンボ, デフォルト="1024 x 576"): empty_latent_width と empty_latent_height を標準値に設定するプリセットショートカットです。プリセットを選択した後も、カスタムサイズを手動で入力できます。
• empty_latent_width (整数): 作成する空の潜在変数の幅です。通常は resolution コンボによって設定されますが、カスタムサイズ用に上書きできます。
• empty_latent_height (整数): 作成する空の潜在変数の高さです。通常は resolution コンボによって設定されますが、カスタムサイズ用に上書きできます。
• positive (文字列, デフォルト=""): ポジティブプロンプトのテキストです。選択された ChatGLM3 テキストエンコーダーを使用してエンコードされます。
• negative (文字列, デフォルト=""): ネガティブプロンプトのテキストです。選択された ChatGLM3 テキストエンコーダーを使用してエンコードされます。
• batch_size (整数, デフォルト=1, 最小=1, 最大=64): パイプラインで作成する潜在変数の数です。値が大きいほど多くの VRAM を使用します。

オプション

• model_override (MODEL): 接続すると、unet_name から UNet を読み込む代わりに、このモデルを使用します。
• vae_override (VAE): 接続すると、vae_name から VAE を読み込む代わりに、この VAE を使用します。
• optional_lora_stack (LORA_STACK): ここに LoRA スタックを接続すると、プライマリの lora_name 選択に加えて、複数の LoRA を適用できます。
• auto_clean_gpu (ブール, デフォルト=false): 有効にすると、読み込み後に自動的な GPU クリーンアップを試行します。モデルを頻繁に切り替える場合の VRAM 負荷を軽減できます。読み込んだモデルを繰り返しのサンプリングのためにメモリにキャッシュしておきたい場合は、無効にしてください。

出力

• PIPE_LINE: 読み込まれたモデル、VAE、プロンプト、潜在変数の幅/高さ、バッチサイズを含む EasyUse パイプラインオブジェクトです。サンプリングのために、パイプライン対応の EasyUse ノードに接続します。
• MODEL: 読み込み後に、選択された LoRA / LoRA スタック / モデルオーバーライドを適用した有効なモデルです。標準的な ComfyUI サンプリングノードで使用します。
• VAE: 読み込み後に、VAE オーバーライドを適用した有効な VAE です。潜在変数を画像にデコードするために使用します。

使用上の注意

• Kolors は通常の CLIP テキストエンコーダーではなく ChatGLM3 を使用します。プロンプトエンコーダーを変更するには、chatglm3_name を使用します。
• resolution メニューは、empty_latent_width と empty_latent_height を設定するための便利なショートカットです。プリセットを選択するとこれらのフィールドが上書きされるため、異なるアスペクト比が必要な場合は、その後にカスタム値を入力してください。サイズは潜在変数の形式と互換性があるようにしてください。通常は 8 または 16 の倍数が必要です。
• LoRA の強度は独立しています。lora_model_strength は拡散モデルの重みに影響し、lora_clip_strength は ChatGLM3 テキストエンコーダーの重みに影響します。0 を指定すると LoRA の該当側が無効になり、ウィジェットでは負の値も受け付けられます。
• 複数の LoRA が必要な場合は、optional_lora_stack を接続してください。プライマリの lora_name LoRA は、その強度が 0 に設定されているか、何もしないエントリが選択されていない限り、引き続き適用されます。
• グラフ内の別の場所でモデルまたは VAE をすでに読み込んでいる場合は、model_override と vae_override を使用します。これにより、同じファイルをディスクから再読み込みすることを避け、複数のローダー構成間でリソースを再利用できます。