> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-recommend-assets-api.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# LTXVAddGuide - ComfyUI 組み込みノードのドキュメント

> ComfyUI の LTXVAddGuide ノードに関する完全なドキュメントです。入力、出力、パラメーターおよび使用方法について学びましょう。

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

LTXVAddGuide ノードは、入力画像または動画をエンコードし、それをキーフレームとして条件付けデータに統合することで、潜在空間シーケンスに動画条件付けガイドを追加します。このノードは入力を VAE エンコーダーで処理し、得られた潜在表現を指定されたフレーム位置に戦略的に配置するとともに、正の条件付けおよび負の条件付けの両方をキーフレーム情報で更新します。また、フレームのアライメント制約を処理し、条件付けの影響強度を制御することも可能です。

## 入力

| パラメーター      | データ型         | 必須  | 範囲           | 説明                                                                                                                                                                                   |
| ----------- | ------------ | --- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `positive`  | CONDITIONING | はい  | -            | キーフレームガイドで修正される正の条件付け入力                                                                                                                                                              |
| `negative`  | CONDITIONING | はい  | -            | キーフレームガイドで修正される負の条件付け入力                                                                                                                                                              |
| `vae`       | VAE          | はい  | -            | 入力画像／動画フレームのエンコードに使用される VAE モデル                                                                                                                                                      |
| `latent`    | LATENT       | はい  | -            | 条件付けフレームを受ける入力潜在空間シーケンス                                                                                                                                                              |
| `image`     | IMAGE        | はい  | -            | 潜在空間動画に条件付けを行うための画像または動画。フレーム数は `8*n + 1`（例：1、9、17、25 フレーム）である必要があります。動画のフレーム数が `8*n + 1` でない場合、最も近い有効な `8*n + 1` フレーム数に自動的に切り捨てられます。                                                |
| `frame_idx` | INT          | いいえ | -9999 ～ 9999 | 条件付けを開始するフレームインデックス。単一フレームの画像、または 1～8 フレームの動画の場合、任意の `frame_idx` 値を指定できます。9 フレーム以上の動画では、`frame_idx` は 8 の倍数である必要があります。そうでない場合は、最も近い 8 の倍数に切り捨てられます。負の値は動画の終端から逆算してカウントされます。（デフォルト：0） |
| `strength`  | FLOAT        | いいえ | 0.0 ～ 1.0    | 条件付けの影響強度。1.0 では完全な条件付けが適用され、0.0 では条件付けが適用されません。（デフォルト：1.0）                                                                                                                          |

**注意：** 入力画像／動画のフレーム数は `8*n + 1` のパターン（例：1、9、17、25 フレーム）に従っている必要があります。入力がこのパターンに適合しない場合、最も近い有効なフレーム数に自動的に切り捨てられます。

## 出力

| 出力名        | データ型         | 説明                                   |
| ---------- | ------------ | ------------------------------------ |
| `positive` | CONDITIONING | キーフレームガイド情報を反映して更新された正の条件付けデータ       |
| `negative` | CONDITIONING | キーフレームガイド情報を反映して更新された負の条件付けデータ       |
| `latent`   | LATENT       | 条件付けフレームが組み込まれ、ノイズマスクが更新された潜在空間シーケンス |
