> ## 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.

# TextGenerate - ComfyUI Built-in Node Documentation

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

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

## 입력

### 공통 입력

| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 |
| - | - | - | - | - |
| `샘플링 모드` | 텍스트 생성 중 무작위 샘플링 사용 여부를 제어합니다. "on"으로 설정하면 추가 샘플링 매개변수를 사용할 수 있습니다. "off"로 설정하면 노드가 무작위 샘플링 없이 텍스트를 생성합니다. | DYNAMIC\_COMBO | 예 | `"on"`<br />`"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"`<br />`"off"`<br />`"2"`<br />`"3"`<br />`"4"`<br />`"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에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TextGenerate/ko.md)

***

**Source fingerprint (SHA-256):** `80813781c06dfb0c3b59ee72c8bd6ebced69a4de8152de916ebc15153a0757fa`


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