> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.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"` |
| `생각 중` | 활성화하면 모델이 답변하기 전에 추론하도록 지시합니다. 모든 추론 블록은 `generated_text`가 아니라 `thinking` 출력으로 반환됩니다(기본값: 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"` |
| `system_prompt` | 내장된 LTX-2 시스템 프롬프트를 대체합니다. 비워 두면 노드는 자체 지침을 사용합니다. `image`가 연결된 경우 이미지-투-비디오 프롬프트, 그렇지 않으면 텍스트-투-비디오 프롬프트를 사용합니다. 노드에서 직접 입력하는 대신 STRING 입력을 연결합니다(기본값: 비어 있음). | STRING | 아니요 | - |

### 샘플링 매개변수 (`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`은 기본 생성 단계로 전달됩니다.
* `system_prompt`는 선택한 모드(이미지-투-비디오 또는 텍스트-투-비디오)의 내장 지침을 대체합니다. 비어 있으면 내장 프롬프트가 사용됩니다.
* 모든 추론 블록은 `generated_text`가 아니라 `thinking` 출력으로 반환됩니다.
* 언어 모델이 사용 가능한 텍스트를 생성하지 않으면 노드는 대신 원래 `prompt`를 반환합니다.

## 출력

| 출력 이름 | 설명 | 데이터 타입 |
| - | - | - |
| `generated_text` | 언어 모델이 생성한 향상된 비디오 생성 프롬프트이며, 추론 블록은 `thinking` 출력으로 분리됩니다. 결과가 비어 있으면 원래 사용자 프롬프트가 반환됩니다. | STRING |
| `thinking` | 모델이 생성한 추론 블록이며, 여는 `<think>` 태그가 제거됩니다. 모델이 추론 블록을 생성하지 않으면 비어 있습니다. Gemma 4 모델에서는 `thinking`이 활성화된 경우에만 추론 블록이 생성됩니다. | STRING |

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

***

**Source fingerprint (SHA-256):** `a601a8bff65e8ee148d09f04ac0afc201dbc9ba5e09a65856400e9be37e085bb`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.