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

# TextGenerateLTX2Prompt - ComfyUI Built-in Node Documentation

> TextGenerateLTX2Prompt 노드는 짧은 사용자 프롬프트를 LTX-2 시리즈 비디오 모델로 비디오를 생성하는 데 적합한 상세한 시청각 설명으로 확장합니다. 작업별 시스템 지침을 자동으로 추가하고, 형식이 지정된 프롬프트를 언어 모델로 전송한 뒤 향상된 텍스트를 반환합니다. 선택적 참조 이미지가 제공되면 노드는

TextGenerateLTX2Prompt 노드는 짧은 사용자 프롬프트를 LTX-2 시리즈 비디오 모델로 비디오를 생성하는 데 적합한 상세한 시청각 설명으로 확장합니다. 작업별 시스템 지침을 자동으로 추가하고, 형식이 지정된 프롬프트를 언어 모델로 전송한 뒤 향상된 텍스트를 반환합니다. 선택적 참조 이미지가 제공되면 노드는 이미지-투-비디오 모드로 전환하고 해당 이미지의 내용에서 시작하여 프롬프트를 확장합니다.

## 입력

### 공통 입력

| 매개변수                   | 설명                                                                                                                                                                          | 데이터 타입         | 필수  | 범위                                                                |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | --- | ----------------------------------------------------------------- |
| `clip`                 | 텍스트 인코딩에 사용되는 CLIP 모델입니다. 노드는 모델의 토크나이저 이름을 확인하여 일치하는 지침을 선택합니다. Gemma 4 기반 모델은 LTX-2.4 형식을 사용하고, 다른 모델은 LTX-2(Gemma 3) 형식을 사용합니다.                                          | CLIP           | 예   | -                                                                 |
| `프롬프트`                 | 장면이나 개념을 설명하는 원시 텍스트 입력으로, 상세한 비디오 생성 프롬프트로 확장됩니다.                                                                                                                          | STRING         | 예   | -                                                                 |
| `이미지`                  | 비디오의 첫 프레임으로 사용되는 선택적 입력 이미지입니다. 제공되면 노드는 이미지-투-비디오 모드로 전환하고 이미지 내용을 기반으로 사용자 프롬프트를 확장하는 시스템 프롬프트를 사용합니다.                                                                   | IMAGE          | 아니요 | -                                                                 |
| `비디오`                  | 추가 컨텍스트로 사용되는 선택적 비디오 입력입니다. 언어 모델에 이미지 배치로 전달되며, 24 FPS로 가정하고 내부적으로 1 FPS로 서브샘플링됩니다.                                                                                       | IMAGE          | 아니요 | -                                                                 |
| `오디오`                  | 생성을 위한 추가 컨텍스트로 사용할 수 있는 선택적 오디오 입력입니다.                                                                                                                                     | AUDIO          | 아니요 | -                                                                 |
| `최대 길이`                | 언어 모델이 생성할 수 있는 최대 토큰 수입니다(기본값: 512).                                                                                                                                       | INT            | 예   | 1 \~ 32768                                                        |
| `샘플링 모드`               | 텍스트 생성 중 무작위 샘플링 사용 여부를 제어합니다. `"on"`으로 설정하면 아래 샘플링 매개변수를 사용할 수 있습니다. `"off"`이면 노드는 무작위 샘플링 없이 텍스트를 생성합니다.                                                                  | DYNAMIC\_COMBO | 예   | `"on"`<br />`"off"`                                               |
| `생각 중`                 | 활성화하면 모델이 답변하기 전에 추론하도록 지시합니다. 모든 추론 블록은 반환된 출력에서 제거됩니다(기본값: False).                                                                                                        | BOOLEAN        | 아니요 | True/False                                                        |
| `use_default_template` | 활성화하면 노드가 서식을 지정할 때 기본 채팅 템플릿을 사용합니다(기본값: True). 고급 설정입니다.                                                                                                                  | BOOLEAN        | 아니요 | True/False                                                        |
| `mtp`                  | 체크포인트의 다중 토큰 예측 헤드를 사용하는 추측 디코딩입니다. MTP 가중치가 없으면 효과가 없습니다. `"auto"`는 드래프트 깊이를 조정하고, `"2"`부터 `"5"`는 고정합니다. 샘플링된 출력은 분포가 올바르게 유지되지만 동일한 시드에 대해 비-MTP 출력과 다릅니다(기본값: `"auto"`). | COMBO          | 아니요 | `"auto"`<br />`"off"`<br />`"2"`<br />`"3"`<br />`"4"`<br />`"5"` |

### 샘플링 매개변수 (`sampling_mode`가 "on"일 때)

| 매개변수                 | 설명                                                                            | 데이터 타입 | 필수  | 범위                        |
| -------------------- | ----------------------------------------------------------------------------- | ------ | --- | ------------------------- |
| `temperature`        | 출력의 무작위성을 제어합니다. 값이 낮을수록 출력이 더 예측 가능해지고, 높을수록 더 창의적이 됩니다(기본값: 0.7).           | FLOAT  | 예   | 0.01 \~ 2.0               |
| `top_k`              | 가장 가능성이 높은 상위 K개의 다음 토큰으로 샘플링 풀을 제한합니다. 값이 0이면 이 필터를 비활성화합니다(기본값: 64).        | INT    | 예   | 0 \~ 1000                 |
| `top_p`              | 뉴클리어스 샘플링을 사용하여 누적 확률이 이 값에 도달하는 가장 가능성이 높은 토큰의 최소 집합을 유지합니다.(기본값: 0.95)      | FLOAT  | 예   | 0.0 \~ 1.0                |
| `min_p`              | 토큰이 고려되기 위한 최소 확률 임계값을 설정합니다(기본값: 0.05).                                      | FLOAT  | 예   | 0.0 \~ 1.0                |
| `repetition_penalty` | 이미 생성된 토큰에 페널티를 부여하여 반복을 줄입니다. 값이 1.0이면 페널티를 적용하지 않습니다(기본값: 1.05).            | FLOAT  | 예   | 0.0 \~ 5.0                |
| `seed`               | 재현 가능한 결과를 위해 난수 생성기를 초기화하는 데 사용되는 숫자입니다(기본값: 0).                             | INT    | 예   | 0 \~ 18446744073709551615 |
| `presence_penalty`   | 지금까지 텍스트에 등장했는지 여부에 따라 새 토큰에 페널티를 부여하여 모델이 새로운 주제에 대해 이야기하도록 장려합니다(기본값: 0.0). | FLOAT  | 아니요 | 0.0 \~ 5.0                |

**참고:** 위 샘플링 매개변수는 `sampling_mode`가 "on"으로 설정된 경우에만 노드 인터페이스에서 활성화되고 표시됩니다. "off"로 설정하면 사용 가능한 샘플링 매개변수가 없으며 노드는 무작위 샘플링 없이 텍스트를 생성합니다.

**참고:** 노드의 동작은 입력에 따라 달라집니다:

* `image`가 제공되면 생성된 프롬프트는 이미지 내용을 기반으로 프롬프트를 확장하는 방법을 설명하는 시스템 프롬프트를 사용하여 이미지-투-비디오 작업에 맞게 형식이 지정됩니다. 이미지가 제공되지 않으면 텍스트-투-비디오 작업에 맞게 형식이 지정되며, 시스템 프롬프트를 사용하여 프롬프트를 상세한 비디오 생성 설명으로 확장합니다.
* CLIP 토크나이저의 이름에 "gemma4"가 포함되어 있으면 노드는 LTX-2.4 시스템 프롬프트와 Gemma 4 채팅 형식을 사용합니다. 그렇지 않으면 LTX-2(Gemma 3) 시스템 프롬프트와 채팅 형식을 사용합니다.
* Gemma 4 모델에서 `thinking`이 활성화되면 모델은 추론 채널에서 열리고, 비활성화되면 최종 답변 채널에서 직접 열립니다. Gemma 4가 아닌 모델의 경우 `thinking`은 기본 생성 단계로 전달됩니다.
* 언어 모델이 추론 블록을 제거한 후 사용 가능한 텍스트를 생성하지 않으면 노드는 대신 원래 `prompt`를 반환합니다.

## 출력

| 출력 이름            | 설명                                                                                | 데이터 타입 |
| ---------------- | --------------------------------------------------------------------------------- | ------ |
| `generated_text` | 언어 모델이 생성한 향상된 비디오 생성 프롬프트이며, 모든 추론 블록이 제거되어 있습니다. 결과가 비어 있으면 원래 사용자 프롬프트가 반환됩니다. | STRING |

> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TextGenerateLTX2Prompt/ko.md)

***

**Source fingerprint (SHA-256):** `1da4a388b7c358e5649b4746b9b8d288977ec6fbed3eedc4c8709187c9f7b943`