マスク付きメディア潜在変数のエンコード (Encode Masked Media Latent)
元画像とバイナリマスクを InpaintMaskArtifact にエンコードします。このアーティファクトを入力することで、下流の Generate Media Latents ノードが自動的にインペイント(Inpainting)モードに切り替わります。
カテゴリ: ModularDiffusion/Encode\Decode
概要 (TL;DR)
- インペイント(Inpainting) に使用します。出力されるアーティファクトにはマスク、マスク済み画像潜在変数、強度がひとまとめに含まれており、下流のノードで個別の入力を用意する必要がありません。
latents出力を Generate Media Latents ノードのinput_latent入力に接続します。Generate ノードはアーティファクトの型を自動検知し、インペイントパイプラインに自動ルーティングします。- インペイント用パイプラインクラスが登録されているモデル(例: Flux Fill, SDXL Inpaint)でのみ動作します。
ワークフローにおける一般的な配置 (Typical workflow position)
Load Image ──┐
├─→ [Encode Masked Media Latent] → Generate Media Latents → Decode
Paint Mask ──┘
ノードプレビュー (Node preview)

入力 (Inputs)
| 名前 | 型 | 必須 | 備考 |
|---|---|---|---|
pipeline |
Pipeline Config |
はい | インペイントに対応している必要があります(ドライバが _inpaint_pipeline_class を保持)。 |
image |
ImageArtifact / ImageUrlArtifact |
はい | 元画像。 |
mask |
ImageArtifact / ImageUrlArtifact |
はい | バイナリマスク — 白ピクセル = インペイント対象領域、黒ピクセル = 元画像を保持。 |
strength |
float (0.0〜1.0) | いいえ | インペイントのデノイズ強度(デフォルト: 1.0)。値を小さくすると元画像のディテールが強く残ります。 |
出力 (Outputs)
| 名前 | 型 | 備考 |
|---|---|---|
latents |
InpaintMaskArtifact |
マスク + 元画像/マスク済み画像潜在変数 + 強度を統合したアーティファクト。 |
ヒントと注意点 (Tips & pitfalls)
- パイプラインがインペイントに対応している必要があります: 選択したパイプラインにインペイントバリアントが存在しない場合、検証エラーとなります。Pipeline Builder で Flux Fill などを選択してください。
- マスクは元画像の解像度と一致させてください: 内部で潜在変数グリッドにリサンプリングされますが、アスペクト比が大きく異なると歪みの原因となります。
strengthはこのアーティファクト上で設定されます: Generate Media Latents 側ではなく、本ノード側で強度を調整します。
関連項目 (See also)
- Encode Media Latent — 非マスク版(通常のエンコード)。
- Generate Media Latents — インペイントアーティファクトを自動検出して処理。