# צור פרומפט LTX2

הצומת TextGenerateLTX2Prompt מרחיב פרומפט משתמש קצר לתיאור מפורט ואורקולי, המתאים ליצירת וידאו עם סדרת מודלי הווידאו LTX-2. הוא מוסיף באופן אוטומטי הוראות מערכת ייעודיות למשימה, שולח את הפרומפט המעוצב למודל שפה, ומחזיר את הטקסט המשופר. כאשר מסופקת תמונת עזר אופציונלית, הצומת עובר למצב תמונה-לווידאו ומרחיב את הפרומפט החל מתוכן התמונה.

## קלטים

### קלטים משותפים

| פרמטר | תיאור | סוג נתונים | חובה | טווח |
| --- | --- | --- | --- | --- |
| `clip` | מודל CLIP המשמש לקידוד טקסט. הצומת בודק את שם הטוקנייזר של המודל כדי לבחור את ההוראות המתאימות: מודלים מבוססי Gemma 4 משתמשים בפורמט LTX-2.4, בעוד מודלים אחרים משתמשים בפורמט LTX-2 (Gemma 3). | CLIP | כן | - |
| `prompt` | קלט הטקסט הגולמי המתאר את הסצנה או הרעיון שיש להרחיב לפרומפט מפורט ליצירת וידאו. | STRING | כן | - |
| `image` | תמונת קלט אופציונלית המשמשת כפריים הראשון של הווידאו. כאשר היא מסופקת, הצומת עובר למצב תמונה-ללווידאו ומשתמש בפרומפט מערכת שמרחיב את פרומפט המשתמש בהתאם לתוכן התמונה. | IMAGE | לא | - |
| `video` | קלט וידאו אופציונלי המשמש כהקשר נוסף. מועבר למודל השפה כאצוות תמונות; מניחים שהוא בקצב 24 FPS ומבצעים דגימת משנה ל-1 FPS באופן פנימי. | IMAGE | לא | - |
| `audio` | קלט אודיו אופציונלי שיכול לשמש כהקשר נוסף ליצירה. | AUDIO | לא | - |
| `max_length` | מספר הטוקנים המרבי שמודל השפה רשאי לייצר (ברירת מחדל: 512). | INT | כן | 1 עד 32768 |
| `sampling_mode` | קובע אם נעשה שימוש בדגימה אקראית במהלך יצירת הטקסט. כאשר הוא מוגדר ל-`"on"`, פרמטרי הדגימה שלמטה הופכים לזמינים; עם `"off"` הצומת מייצר טקסט ללא דגימה אקראית. | DYNAMIC_COMBO | כן | `"on"`<br>`"off"` |
| `thinking` | כאשר הוא מופעל, המודל מקבל הוראה לחשוב לפני מתן תשובה. כל בלוק חשיבה מוחזר בפלט `thinking` במקום ב-`generated_text` (ברירת מחדל: False). | BOOLEAN | לא | True/False |
| `use_default_template` | כאשר הוא מופעל, הצומת משתמש בתבנית הצ'אט המוגדרת כברירת מחדל לעיצוב (ברירת מחדל: True). הגדרה מתקדמת. | BOOLEAN | לא | True/False |
| `mtp` | פענוח ספקולטיבי עם ראש חיזוי רב-טוקנים של הצ'קפוינט. אין לכך השפעה ללא משקולות MTP. `"auto"` מתאים את עומק הטיוטה, `"2"` עד `"5"` מקבעים אותו. הפלט הנדגם נשאר בעל התפלגות תקינה אך שונה מפלט ללא MTP עבור אותו seed (ברירת מחדל: `"auto"`). | COMBO | לא | `"auto"`<br>`"off"`<br>`"2"`<br>`"3"`<br>`"4"`<br>`"5"` |
| `system_prompt` | מחליף את פרומפט המערכת המובנה של LTX-2. כאשר הוא נשאר ריק, הצומת משתמש בהוראות שלו עצמו: פרומפט תמונה-ללווידאו כאשר `image` מחובר, אחרת פרומפט טקסט-ללווידאו. חבר קלט STRING במקום להקליד בצומת (ברירת מחדל: ריק). | STRING | לא | - |

### פרמטרי דגימה (כאשר `sampling_mode` הוא `"on"`)

| פרמטר | תיאור | סוג נתונים | חובה | טווח |
| --- | --- | --- | --- | --- |
| `temperature` | קובע את מידת האקראיות של הפלט. ערכים נמוכים יותר הופכים את הפלט ליותר צפוי, וערכים גבוהים יותר הופכים אותו ליותר יצירתי (ברירת מחדל: 0.7). | FLOAT | כן | 0.01 עד 2.0 |
| `top_k` | מגביל את מאגר הדגימה ל-K הטוקנים הבאים הסבירים ביותר. ערך 0 מבטל את המסנן הזה (ברירת מחדל: 64). | INT | כן | 0 עד 1000 |
| `top_p` | משתמש בדגימת גרעין (nucleus sampling): שומר על הקבוצה הקטנה ביותר של טוקנים סבירים שההסתברות המצטברת שלהם מגיעה לערך הזה. (ברירת מחדל: 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"`. כאשר הוא מוגדר ל-`"off"`, לא זמינים פרמטרי דגימה והצומת מייצר טקסט ללא דגימה אקראית.

**הערה:** התנהגות הצומת משתנה בהתאם לקלטים שלו:

- אם מסופק `image`, הפרומפט הנוצר מעוצב למשימת תמונה-ללווידאו תוך שימוש בפרומפט מערכת המתאר כיצד להרחיב את הפרומפט בהתאם לתוכן התמונה. אם לא מסופקת תמונה, העיצוב מיועד למשימת טקסט-ללווידאו תוך שימוש בפרומפט מערכת שמרחיב את הפרומפט לתיאור מפורט ליצירת וידאו.
- אם שם הטוקנייזר של CLIP מכיל "gemma4", הצומת משתמש בפרומפטי המערכת של LTX-2.4 ובפורמט הצ'אט של Gemma 4. אחרת, הוא משתמש בפרומפטי המערכת של LTX-2 (Gemma 3) ובפורמט הצ'אט שלהם.
- כאשר `thinking` מופעל עם מודל Gemma 4, המודל נפתח בערוץ החשיבה שלו; כאשר הוא מושבת, המודל נפתח ישירות בערוץ התשובה הסופית. עבור מודלים שאינם Gemma 4, `thinking` מועבר לשלב היצירה הבסיסי.
- `system_prompt` מחליף את ההוראות המובנות עבור המצב הנבחר (תמונה-ללווידאו או טקסט-ללווידאו); כאשר הוא ריק, נעשה שימוש בפרומפט המובנה.
- כל בלוק חשיבה מוחזר בפלט `thinking` במקום ב-`generated_text`.
- אם מודל השפה לא מייצר טקסט שמיש, הצומת מחזיר את `prompt` המקורי במקום.

## פלטים

| שם פלט | תיאור | סוג נתונים |
| --- | --- | --- |
| `generated_text` | פרומפט יצירת הווידאו המשופר שהפיק מודל השפה, כאשר כל בלוק חשיבה מופרד לפלט `thinking`. אם התוצאה ריקה, מוחזר פרומפט המשתמש המקורי. | STRING |
| `thinking` | בלוק החשיבה שהמודל הפיק, כאשר תג הפתיחה `<think>` הוסר. ריק כאשר המודל לא הפיק בלוק חשיבה; עם מודלי Gemma 4, בלוק חשיבה צפוי רק כאשר `thinking` מופעל. | STRING |

> מסמך זה נוצר על ידי בינה מלאכותית. אם מצאתם שגיאות או שיש לכם הצעות לשיפור, אתם מוזמנים לתרום! [עריכה ב-GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TextGenerateLTX2Prompt/he.md)

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