Text

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"` `"off"`
`생각 중`	활성화하면 모델이 답변하기 전에 추론하도록 지시합니다. 모든 추론 블록은 반환된 출력에서 제거됩니다(기본값: False).	BOOLEAN	아니요	True/False
`use_default_template`	활성화하면 노드가 서식을 지정할 때 기본 채팅 템플릿을 사용합니다(기본값: True). 고급 설정입니다.	BOOLEAN	아니요	True/False
`mtp`	체크포인트의 다중 토큰 예측 헤드를 사용하는 추측 디코딩입니다. MTP 가중치가 없으면 효과가 없습니다. `"auto"`는 드래프트 깊이를 조정하고, `"2"`부터 `"5"`는 고정합니다. 샘플링된 출력은 분포가 올바르게 유지되지만 동일한 시드에 대해 비-MTP 출력과 다릅니다(기본값: `"auto"`).	COMBO	아니요	`"auto"` `"off"` `"2"` `"3"` `"4"` `"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에서 편집

Source fingerprint (SHA-256): 1da4a388b7c358e5649b4746b9b8d288977ec6fbed3eedc4c8709187c9f7b943