# TextGenerateLTX2Prompt

عقدة TextGenerateLTX2Prompt توسّع نص المستخدم التوجيهي القصير إلى وصف سمعي بصري مفصل مناسب لتوليد فيديو باستخدام سلسلة نماذج الفيديو LTX-2. وتضيف تلقائيًا تعليمات نظام خاصة بالمهمة، وترسل النص المنسّق إلى نموذج لغة، وتعيد النص المحسّن. عند توفير صورة مرجعية اختيارية، تنتقل العقدة إلى وضع الصورة إلى فيديو وتوسّع النص التوجيهي انطلاقًا من محتوى تلك الصورة.

## المدخلات

### المدخلات العامة

| المعامل | الوصف | نوع البيانات | مطلوب | النطاق |
| --- | --- | --- | --- | --- |
| `clip` | نموذج CLIP المستخدم لترميز النص. تتحقق العقدة من اسم tokenizer الخاص بالنموذج لتحديد التعليمات المطابقة: النماذج المبنية على Gemma 4 تستخدم تنسيق LTX-2.4، بينما تستخدم النماذج الأخرى تنسيق LTX-2 (Gemma 3). | CLIP | نعم | - |
| `المطالبة` | إدخال النص الخام الذي يصف المشهد أو المفهوم المراد توسيعه إلى نص توجيهي مفصل لتوليد الفيديو. | STRING | نعم | - |
| `الصورة` | صورة إدخال اختيارية تُستخدم كالإطار الأول للفيديو. عند توفيرها، تنتقل العقدة إلى وضع الصورة إلى فيديو وتستخدم نصًا توجيهيًا للنظام يوسّع نص المستخدم التوجيهي بناءً على محتوى الصورة. | IMAGE | لا | - |
| `فيديو` | إدخال فيديو اختياري يُستخدم كسياق إضافي. يُمرَّر إلى نموذج اللغة كدفعة صور؛ يُفترض أن يكون 24 FPS ويُعاد أخذ عينات منه فرعيًا إلى 1 FPS داخليًا. | IMAGE | لا | - |
| `صوت` | إدخال صوتي اختياري يمكن استخدامه كسياق إضافي للتوليد. | AUDIO | لا | - |
| `الحد الأقصى للطول` | الحد الأقصى لعدد الرموز (tokens) المسموح لنموذج اللغة بتوليدها (القيمة الافتراضية: 512). | INT | نعم | 1 إلى 32768 |
| `وضع العينة` | يتحكم فيما إذا كان أخذ العينات العشوائي مستخدمًا أثناء توليد النص. عند ضبطه على `"on"`، تصبح معاملات أخذ العينات أدناه متاحة؛ وعند ضبطه على `"off"` تولّد العقدة النص دون أخذ عينات عشوائي. | DYNAMIC_COMBO | نعم | `"on"`<br>`"off"` |
| `التفكير` | عند تمكينه، يُطلب من النموذج أن يستدل قبل الإجابة. تُعاد أي كتلة استدلال في مخرَج `thinking` بدلًا من `generated_text` (القيمة الافتراضية: False). | BOOLEAN | لا | True/False |
| `استخدام القالب الافتراضي` | عند تمكينه، تستخدم العقدة قالب المحادثة الافتراضي للتنسيق (القيمة الافتراضية: True). إعداد متقدم. | BOOLEAN | لا | True/False |
| `mtp` | فك ترميز تخميني باستخدام رأس التنبؤ متعدد الرموز الخاص بالـ checkpoint. لا تأثير له دون أوزان 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` | يستخدم أخذ عينات النواة: يحتفظ بأصغر مجموعة من الرموز الأكثر احتمالًا التي يصل احتمالها التراكمي إلى هذه القيمة. (القيمة الافتراضية: 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`، يُنسّق النص التوجيهي المولّد لمهمة صورة إلى فيديو باستخدام نص توجيهي للنظام يصف كيفية توسيع النص التوجيهي بناءً على محتوى الصورة. وإذا لم تُقدَّم صورة، يكون التنسيق لمهمة نص إلى فيديو باستخدام نص توجيهي للنظام يوسّع النص التوجيهي إلى وصف مفصل لتوليد الفيديو.
- إذا احتوى اسم tokenizer الخاص بـ 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/ar.md)

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