# TextGenerateLTX2Prompt

`TextGenerateLTX2Prompt` 節點會將簡短的使用者提示擴展為詳細的視聽描述，適合用於搭配 LTX-2 系列影片模型生成影片。它會自動加入特定任務的系統指示，將格式化後的提示傳送給語言模型，並傳回增強後的文字。當提供選用的參考圖像時，此節點會切換至圖像轉影片模式，並以該圖像內容為起點擴展提示。

## 輸入

### 通用輸入

| 參數 | 說明 | 資料類型 | 必填 | 範圍 |
| --- | --- | --- | --- | --- |
| `clip` | 用於文字編碼的 CLIP 模型。此節點會檢查模型的分詞器名稱，以選擇相符的指示：以 Gemma 4 為基礎的模型使用 LTX-2.4 格式，其他模型則使用 LTX-2 (Gemma 3) 格式。 | CLIP | 是 | - |
| `提示詞` | 原始文字輸入，用於描述要擴展為詳細影片生成提示的場景或概念。 | STRING | 是 | - |
| `圖像` | 選用的輸入圖像，用作影片的第一幀。提供時，此節點會切換至圖像轉影片模式，並使用可根據圖像內容擴展使用者提示的系統提示。 | IMAGE | 否 | - |
| `影片` | 選用的影片輸入，用作額外上下文。會以圖像批次形式傳遞給語言模型；內部假設為 24 FPS，並次取樣至 1 FPS。 | IMAGE | 否 | - |
| `音訊` | 選用的音訊輸入，可作為生成的額外上下文。 | AUDIO | 否 | - |
| `最大長度` | 允許語言模型生成的 token 數量上限（預設值：512）。 | INT | 是 | 1 至 32768 |
| `取樣模式` | 控制文字生成期間是否使用隨機取樣。設為 `"on"` 時，下方取樣參數會變為可用；設為 `"off"` 時，此節點會在不進行隨機取樣的情況下生成文字。 | DYNAMIC_COMBO | 是 | `"on"`<br>`"off"` |
| `思考模式` | 啟用時，會指示模型在回答前進行推理。任何推理區塊會傳回到 `thinking` 輸出，而不是放在 `generated_text` 中（預設值：False）。 | BOOLEAN | 否 | True/False |
| `use_default_template` | 啟用時，此節點會使用預設聊天範本進行格式化（預設值：True）。進階設定。 | BOOLEAN | 否 | True/False |
| `mtp` | 使用檢查點的多 token 預測頭進行推測解碼。沒有 MTP 權重時不會有作用。`"auto"` 會調適草稿深度，`"2"` 至 `"5"` 則將其固定。取樣輸出會保持正確分佈，但在相同 `seed` 下與非 MTP 輸出不同（預設值：`"auto"`）。 | COMBO | 否 | `"auto"`<br>`"off"`<br>`"2"`<br>`"3"`<br>`"4"`<br>`"5"` |
| `系統提示詞` | 取代內建的 LTX-2 系統提示。留空時，此節點使用自身的指示：連接 `image` 時使用圖像轉影片提示，否則使用文字轉影片提示。以 STRING 輸入連接，而不是在節點中輸入（預設值：空）。 | STRING | 否 | - |

### 取樣參數（當 `sampling_mode` 為 "on" 時）

| 參數 | 說明 | 資料類型 | 必填 | 範圍 |
| --- | --- | --- | --- | --- |
| `temperature` | 控制輸出的隨機性。較低的值會使輸出更可預測，較高的值則使其更有創意（預設值：0.7）。 | FLOAT | 是 | 0.01 至 2.0 |
| `top_k` | 將取樣池限制為最可能的下一個 token 中前 K 個。值為 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" 時才會在節點介面中啟用並顯示。設為 "off" 時，不會提供任何取樣參數，且此節點會在不進行隨機取樣的情況下生成文字。

**注意：** 此節點的行為會根據其輸入而改變：

- 如果提供 `image`，所生成的提示會針對圖像轉影片任務進行格式化，並使用描述如何根據圖像內容擴展提示的系統提示。如果未提供圖像，則會針對文字轉影片任務進行格式化，並使用將提示擴展為詳細影片生成描述的系統提示。
- 如果 CLIP 分詞器的名稱包含 "gemma4"，此節點會使用 LTX-2.4 系統提示與 Gemma 4 聊天格式。否則，會使用 LTX-2 (Gemma 3) 系統提示與聊天格式。
- 當 Gemma 4 模型啟用 `thinking` 時，模型會在其推理通道上開啟；停用時，模型會直接在最終答案通道上開啟。對於非 Gemma 4 模型，`thinking` 會傳遞至底層生成步驟。
- `system_prompt` 會取代所選模式（圖像轉影片或文字轉影片）的內建指示；為空時使用內建提示。
- 任何推理區塊會傳回到 `thinking` 輸出，而不是 `generated_text`。
- 如果語言模型未產生任何可用文字，此節點會改為傳回原始 `prompt`。

## 輸出

| 輸出名稱 | 說明 | 資料類型 |
| --- | --- | --- |
| `generated_text` | 由語言模型產生的增強影片生成提示，推理區塊會單獨輸出至 `thinking`。如果結果為空，則傳回原始使用者提示。 | STRING |
| `thinking` | 模型產生的推理區塊，已移除開頭的 `<think>` 標籤。模型未產生推理區塊時為空；對於 Gemma 4 模型，只有啟用 `thinking` 時才預期會有推理區塊。 | STRING |

> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議，歡迎貢獻！ [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TextGenerateLTX2Prompt/zh-TW.md)

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