> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# LTXVAddLatentGuide - ComfyUI Built-in Node Documentation

> LTXV Add Latent Guide ノードは、ガイドが画像ではなく前段の処理から出力される場合に、すでにエンコード済みの latent をガイドとして固定します。

LTXV Add Latent Guide ノードは、ガイドが画像ではなく前段の処理から出力される場合に、すでにエンコード済みの latent をガイドとして固定します。これは VAE のデコード／エンコードの往復を伴わずに LTXV Add Guide と同じ効果を持ちます。ターゲットより空間的に小さいガイド（IC-LoRA またはディテーリング参照）は疎なグリッド上に拡張（dilate）され、その RoPE 終端位置も同じ比率で拡張されるため、ターゲットキャンバスの左上隅だけを扱うのではなく、キャンバス全体をカバーします。

## 入力

| パラメータ            | 説明                                                                                                                                                              | データ型         | 必須  | 範囲                   |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | --- | -------------------- |
| `positive`       | ポジティブコンディショニング入力。                                                                                                                                               | CONDITIONING | はい  | N/A                  |
| `negative`       | ネガティブコンディショニング入力。                                                                                                                                               | CONDITIONING | はい  | N/A                  |
| `vae`            | フレーム配置用のダウンスケールインデックス計算式を読み取るために使用される VAE モデル。                                                                                                                  | VAE          | はい  | N/A                  |
| `latent`         | ガイドを固定する対象の動画 latent。                                                                                                                                           | LATENT       | はい  | N/A                  |
| `guiding_latent` | ガイド latent。その空間サイズは、両軸においてターゲットの空間サイズを同じ整数で割り切れる必要があります。同じサイズの場合はそのまま固定され、半分のサイズは x2 IC-LoRA 参照として扱われます。                                                        | LATENT       | はい  | N/A                  |
| `latent_idx`     | ガイドを開始する latent フレームインデックス。ピクセルフレームではなく latent フレームで数えます。負の値は、latent の終端からさかのぼって数えるのではなく、latent の開始前のフレームにガイドを配置します。デフォルト: 0。                                   | INT          | はい  | -9999 〜 9999         |
| `strength`       | 上限は 1.0 です。拡張されたガイドは、パディング位置に負のデノイズマスクを付けてモデルがそれらを破棄するようにします。1.0 を超えると、保持される位置も負になり、ガイド全体が破棄されてしまいます。1.0 を超えて増幅する場合は、代わりに attention\_mask を使用してください。デフォルト: 1.0。 | FLOAT        | はい  | 0.0 〜 1.0, step 0.01 |
| `attention_mask` | オプションのピクセル空間の空間マスク。self-attention を介して領域ごとのコンディショニングの影響を制御し、strength が乗算されます。                                                                                   | MASK         | いいえ | N/A                  |

### 注意

* `latent` と `guiding_latent` はどちらも、(batch, channels, frames, height, width) 形状の 5D 動画 latent である必要があります。
* ガイドはターゲット latent 内に収まる必要があります。ガイドのフレーム数に `latent_idx` を加えた値が、ターゲット latent の終端を超えてはなりません。負の `latent_idx` 値も使用でき、latent の開始前にガイドを配置します。
* ガイドの空間サイズは、高さ軸と幅軸の両方で、ターゲットの空間サイズを整数で割り切れる必要があります。
* 高さの比率と幅の比率は同じ値である必要があります（正方形の比率）。正方形でない比率はエラーになります。これは、拡張と RoPE 配置が両軸で単一のダウンスケール係数を使用するためです。

## 出力

| 出力名        | 説明                                            | データ型         |
| ---------- | --------------------------------------------- | ------------ |
| `positive` | ガイドが付加されたポジティブコンディショニング。                      | CONDITIONING |
| `negative` | ガイドが付加されたネガティブコンディショニング。                      | CONDITIONING |
| `latent`   | ガイドが適用された latent 出力。更新された `noise_mask` を含みます。 | LATENT       |

> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください！ [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVAddLatentGuide/ja.md)

***

**Source fingerprint (SHA-256):** `19542500484dbc57fdbeeab8ba05bc2978246b3be5decc413825f616cab46f73`