ControlNet パイプライン (ControlNet Pipeline)

構築されたパイプラインをラップし、生成時に ControlNet 入力を受け入れられるように再構成します。

カテゴリ: ModularDiffusion/Pipeline

概要 (TL;DR)

Pipeline Builder と Generate Media Latents の間に配置され、キャッシュされたパイプラインを ControlNet 対応バリアントに再配線します。
1 つ以上の Configure ControlNet ノードから受け取った control_net 設定のリストを受け付けます。モデルが対応している場合（例: Flux Union）、複数の ControlNet のスタック（多重適用）をサポートします。
出力型: Pipeline Config — 下流工程でベースパイプラインの完全な代替として機能します。

Pipeline Builder → [ControlNet Pipeline] → Generate Media Latents → Decode Media Latent
Configure ControlNet ─┘
Configure ControlNet ─┘

ControlNet Pipeline

名前	型	必須	備考
`pipeline`	`Pipeline Config`	はい	ベースとなる Pipeline Builder から供給。すでに ControlNet パイプラインとなっているものは指定不可。
`control_nets`	`list[control_net]`	はい	Configure ControlNet からの 1 つ以上のエントリ。すべてベースパイプラインのプロバイダーと一致している必要があります。

名前	型	備考
`controlnet_pipeline`	`Pipeline Config`	ControlNet 配線が施されたパイプラインアーティファクト。
`control_parameters`	`control_parameters`	接続されたすべての ControlNet 設定のパススルー。Generate Media Latents の `controlnet_parameters` 入力に接続します。
`logs`	`str`	解決された設定ハッシュを含むビルドログ。

プロバイダーの一致: 各 ControlNet の provider はベースパイプラインのプロバイダーと一致している必要があります。ノードは実行前にこの整合性を検証します。
パイプラインクラスの互換性: すべてのベースパイプラインが ControlNet スタックをサポートしているわけではありません。ノードは実行前にドライバを検証し、サポートされていない組み合わせを検出します。
単一ノード内で複数 ControlNet をスタック: 2 つの ControlNet Pipeline ノードを直列に繋ぐのではなく、1 つの ControlNet Pipeline ノードに対して複数の control_nets 入力を接続してください（すでに入力が ControlNet アーティファクトである場合、2 つ目のノードはエラーとなります）。
パイプラインの再利用: 選択された control_nets の重みがロードされますが、ベースパイプライン自体は利用可能な場合キャッシュから再利用されます。