# TextGenerate

Узел 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 или False |
| `use_default_template` | Использовать встроенный системный промпт/шаблон, если он есть у модели. Значение по умолчанию — True. Это расширенный параметр. | BOOLEAN | Нет | True или False |
| `mtp` | Спекулятивное декодирование с головой multi-token-prediction чекпоинта. Не даёт эффекта без весов MTP. `"auto"` адаптирует глубину и ширину драфта по наблюдаемым совпадениям токенов и стоимости выполнения, `"2"`–`"5"` фиксируют постоянную глубину, а режимы `tree` фиксируют и ширину, и глубину. Сэмплированный вывод остаётся корректно распределённым, но отличается от вывода без MTP для того же seed (по умолчанию: `"auto"`). | COMBO | Нет | `"auto"`<br>`"off"`<br>`"2"`<br>`"3"`<br>`"4"`<br>`"5"`<br>`"tree2s1"`<br>`"tree2s2"`<br>`"tree3s1"`<br>`"tree4s1m8"` |
| `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` | Использует нуклеарное (nucleus) сэмплирование: оставляет минимальный набор наиболее вероятных токенов, суммарная вероятность которых достигает этого значения. Значение по умолчанию — 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 |

> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TextGenerate/ru.md)

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