TextGenerate - ComfyUI Built-in Node Documentation

TextGenerate 노드는 CLIP 모델을 사용하여 사용자의 프롬프트를 기반으로 텍스트를 생성합니다. 선택적으로 이미지, 비디오 또는 오디오를 추가 컨텍스트로 사용하여 텍스트 생성을 안내할 수 있습니다. 출력 길이를 제어하고, 지원되는 모델에서 사고 모드를 활성화하며, 다양한 설정으로 무작위 샘플링을 사용할지 또는 샘플링 없이 텍스트를 생성할지 선택할 수 있습니다.

입력

공통 입력

매개변수	설명	데이터 타입	필수	범위
`샘플링 모드`	텍스트 생성 중 무작위 샘플링 사용 여부를 제어합니다. “on”으로 설정하면 추가 샘플링 매개변수를 사용할 수 있습니다. “off”로 설정하면 노드가 무작위 샘플링 없이 텍스트를 생성합니다.	DYNAMIC_COMBO	예	`"on"` `"off"`
`clip`	프롬프트를 토큰화하고 텍스트를 생성하는 데 사용되는 CLIP 모델입니다.	CLIP	예	N/A
`프롬프트`	생성을 안내하는 텍스트 프롬프트입니다. 이 필드는 여러 줄과 동적 프롬프트를 지원합니다. 기본값은 빈 문자열입니다.	STRING	예	N/A
`이미지`	텍스트 프롬프트와 함께 사용되어 생성된 텍스트에 영향을 줄 수 있는 선택적 이미지입니다.	IMAGE	아니요	N/A
`비디오`	이미지 배치로 제공되는 비디오 프레임입니다. 24 FPS로 가정하며 내부적으로 1 FPS로 서브샘플링됩니다.	IMAGE	아니요	N/A
`오디오`	텍스트 프롬프트와 함께 사용되어 생성된 텍스트에 영향을 줄 수 있는 선택적 오디오 입력입니다.	AUDIO	아니요	N/A
`최대 길이`	모델이 생성할 최대 토큰 수입니다. 기본값은 512입니다.	INT	예	1 ~ 32768
`생각 중`	모델이 지원하는 경우 사고 모드로 동작합니다. 기본값은 False입니다.	BOOLEAN	아니요	True or False
`use_default_template`	모델에 내장 시스템 프롬프트/템플릿이 있는 경우 사용합니다. 기본값은 True입니다. 고급 매개변수입니다.	BOOLEAN	아니요	True or False
`mtp`	체크포인트의 다중 토큰 예측 헤드를 사용한 추측 디코딩입니다. MTP 가중치가 없으면 효과가 없습니다. `"auto"`는 드래프트 깊이를 조정하고, `"2"`에서 `"5"`는 이를 고정합니다. 샘플링된 출력은 올바른 분포를 유지하지만 동일한 시드에 대해 비 MTP 출력과 다릅니다(기본값: `"auto"`).	COMBO	아니요	`"auto"` `"off"` `"2"` `"3"` `"4"` `"5"`
`system_prompt`	모델의 채팅 템플릿에 있는 시스템 프롬프트를 대체합니다. 기본 템플릿을 사용하지 않으면 무시됩니다. 노드에서 직접 입력하는 대신 STRING 입력을 연결합니다(기본값: 비어 있음).	STRING	아니요	N/A

샘플링 매개변수 (`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”으로 설정된 경우에만 노드 인터페이스에서 활성화되고 표시됩니다. sampling_mode가 “off”로 설정되면 사용 가능한 샘플링 매개변수가 없으며 노드는 무작위 샘플링 없이 텍스트를 생성합니다. 참고: 생성된 텍스트에 추론 블록이 포함된 경우(텍스트가 <think>로 시작하거나 프롬프트가 그것으로 끝나는 경우) 추론은 별도로 반환됩니다. generated_text에는 답변이, thinking에는 여는 태그가 제거된 추론이 들어갑니다. 그렇지 않으면 generated_text에 모델이 생성한 모든 내용이 들어가고 thinking은 비어 있습니다.

출력

출력 이름	설명	데이터 타입
`generated_text`	입력 프롬프트와 선택적 이미지, 비디오 또는 오디오를 기반으로 모델이 생성한 텍스트이며, 추론 블록은 `thinking` 출력으로 분리됩니다.	STRING
`thinking`	모델이 생성한 추론 블록이며, 여는 `<think>` 태그가 제거됩니다. 모델이 추론 블록을 생성하지 않으면 비어 있습니다.	STRING

이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! GitHub에서 편집

Source fingerprint (SHA-256): 80813781c06dfb0c3b59ee72c8bd6ebced69a4de8152de916ebc15153a0757fa

​입력

​공통 입력

​샘플링 매개변수 (sampling_mode가 “on”일 때)

​출력

입력

공통 입력

샘플링 매개변수 (`sampling_mode`가 “on”일 때)

출력