> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-custom-nodes-sdk-v2-frontend.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           | 是  | 不适用                 |
| `提示词`                  | 引导生成的文本提示。此字段支持多行和动态提示。默认值为空字符串。                                    | STRING         | 是  | 不适用                 |
| `图像`                   | 可选的图像，可与文本提示一起使用以影响生成的文本。                                           | IMAGE          | 否  | 不适用                 |
| `视频`                   | 视频帧作为图像批次。假定为 24 FPS；内部子采样为 1 FPS。                                  | IMAGE          | 否  | 不适用                 |
| `音频`                   | 可选的音频输入，可与文本提示一起使用以影响生成的文本。                                         | AUDIO          | 否  | 不适用                 |
| `最大长度`                 | 模型将生成的最大 token 数量。默认值为 512。                                         | INT            | 是  | 1 至 32768           |
| `思考模式`                 | 如果模型支持，则以思考模式运行。默认值为 False。                                         | BOOLEAN        | 否  | True 或 False        |
| `use_default_template` | 如果模型有内置系统提示/模板，则使用它。默认值为 True。这是一个高级参数。                             | BOOLEAN        | 否  | True 或 False        |

### 采样参数（当 `sampling_mode` 为 "on" 时）

| 参数                   | 描述                                               | 数据类型  | 必填 | 范围                       |
| -------------------- | ------------------------------------------------ | ----- | -- | ------------------------ |
| `temperature`        | 控制输出的随机性。较低的值使输出更可预测，较高的值使其更具创造性。默认值为 0.7。       | FLOAT | 是  | 0.01 至 2.0               |
| `top_k`              | 将采样池限制为最可能的 K 个下一个 token。值为 0 时禁用此过滤器。默认值为 64。   | INT   | 是  | 0 至 1000                 |
| `top_p`              | 使用核采样，将选择限制为累积概率小于此值的 token。默认值为 0.95。           | FLOAT | 是  | 0.0 至 1.0                |
| `min_p`              | 为要考虑的 token 设置最小概率阈值。默认值为 0.05。                  | FLOAT | 是  | 0.0 至 1.0                |
| `repetition_penalty` | 对已生成的 token 进行惩罚以减少重复。值为 1.0 时不施加惩罚。默认值为 1.05。   | FLOAT | 是  | 0.0 至 5.0                |
| `seed`               | 用于初始化随机数生成器以获得可重现结果的数字。默认值为 0。                   | INT   | 是  | 0 至 18446744073709551615 |
| `presence_penalty`   | 根据新 token 是否已出现在当前文本中来对其进行惩罚，鼓励模型讨论新主题。默认值为 0.0。 | FLOAT | 否  | 0.0 至 5.0                |

**注意：** 上述采样参数仅在 `sampling_mode` 设置为 "on" 时才会在节点界面中激活并可见。当 `sampling_mode` 设置为 "off" 时，没有任何采样参数可用，节点将不使用随机采样生成文本。

## 输出

| 输出名称   | 描述                          | 数据类型   |
| ------ | --------------------------- | ------ |
| `生成文本` | 模型根据输入提示以及可选的图像、视频或音频生成的文本。 | STRING |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TextGenerate/zh.md)

***

**Source fingerprint (SHA-256):** `6274a2db7c9a963304daf6df494b2b20879155e918d73429fd2ce7f3b5b9da02`
