メディア潜在変数の生成 (Generate Media Latents)

デノイズループを実行します。ノイズ、エンコード済み、または部分的にデノイズされた潜在変数を入力として受け取り、デノイズされた潜在変数を出力します。

カテゴリ: ModularDiffusion/Processing

概要 (TL;DR)

パイプラインの中核となる主力ノードです。pipeline と input_latent を接続し、プロンプトとステップ数を設定して実行します。
すべてのランタイムパラメータ（プロンプト、ガイダンス、解像度、ControlNet 入力など）は 動的 (Dynamic) であり、接続されたパイプラインに基づいて自動的に適応・表示されます。
マルチステージ / 再拡散 (Rediffusion) ワークフローでは、複数の Generate ノードを連結し、start_step と end_step を使ってデノイズスケジュールを分割実行します。
出力は潜在変数テンソルです。画像や動画として書き出すには Decode Media Latent に接続します。

Pipeline Builder → Create Noise Latents → [Generate Media Latents] → Decode Media Latent

Generate Media Latents

名前	型	必須	備考
`pipeline`	`Pipeline Config`	はい	Pipeline Builder または ControlNet Pipeline から供給。
`input_latent`	`LatentArtifact` または `InpaintMaskArtifact`	はい	開始となる潜在変数。ノイズ（Text-to-Image / Text-to-Video）、エンコード結果（Image-to-Image / Video-to-Video）、または前段の Generate 出力（マルチステージ）を使用。
`controlnet_parameters`	`control_parameters`	`pipeline` が ControlNet パイプライン時のみ	ControlNet Pipeline ノードの `control_parameters` 出力から接続。
`additional_parameters`	list[dict]	いいえ	パイプライン呼び出しに転送されるプロバイダー固有の追加 kwargs。

名前	型	備考
`output_latent`	`LatentArtifact`	デノイズされた潜在変数。
`preview_image`	`ImageUrlArtifact`	リアルタイムの中間プレビュー画像 — 設定 → Modular Diffusion Library → Enable Image Preview Intermediates が有効な場合のみ生成。
`progress`	プログレスバー	ステップカウンター。
`logs`	str	ステップごとの実行時間ログ。

接続されたパイプラインによって表示される項目が変化します。主なパラメータ：

名前	型	備考
`prompt`	str	ポジティブプロンプト。
`negative_prompt`	str	ネガティブプロンプト — Classifier-Free Guidance (CFG) をサポートするパイプラインで表示。
`guidance_scale` / `true_cfg_scale`	float	CFG / True-CFG ガイダンス強度。名称はパイプラインによって異なります。
`num_inference_steps`	int (デフォルト: `20`)	デノイズスケジュールのステップ数。
`seed`	int	再現性制御用のシード値。

名前	型	デフォルト	備考
`add_noise`	bool	`False`	デノイズ前に入力にノイズを再付加します（再拡散や Image-to-Image 型の実行に有用）。
`start_step`	int	`0`	デノイズスケジュールにおける開始インデックス（0 からカウント）。
`end_step`	int	`-1`	終了インデックス。`-1` の場合はスケジュール終了まで実行。

ControlNet: pipeline が ControlNetDiffusionPipelineArtifact の場合、controlnet_parameters 入力が自動的に追加されます。
インペイント: input_latent に InpaintMaskArtifact（Encode Masked Media Latent から）が接続された場合、自動的にインペイントパイプラインクラスへルーティングされ、アーティファクト側の strength が適用されます。

パイプライン切り替え時の接続保持: 新しいパイプラインにも同名のパラメータが存在する場合、ノード間のワイヤー接続は自動的に維持されます。
ライブプレビューによる推論速度への影響: プレビュー生成はデフォルトで OFF になっています。設定 → Modular Diffusion Library → Enable Image Preview Intermediates で切り替えます。
スケジューラーのスライス: 2 つの Generate ノード（例: ステップ 0–10 と 10–20）を連結することで、段階的リファインメントが実現できます。
ステップ途中でのキャンセル: キャンセルボタンを押すとパイプラインの _interrupt フラグが立ち、現在のステップ終了後に即時停止します。
解像度は input_latent から継承: 本ノードには width / height / num_frames の項目はありません。上流の Create Noise Latents などで指定してください。