> ## 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 또는 디테일링 참조)는 희소 그리드에 팽창 배치되며, 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` | 선택적 픽셀 공간 마스크입니다. 셀프 어텐션을 통해 영역별 컨디셔닝 영향을 제어하며, `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/ko.md)

***

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