# LTXV 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 (단계: 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`
