# ByteDance Seedance 2.5 مرجع إلى فيديو

تُنشئ عقدة ByteDance Seedance 2.5 Reference to Video فيديوهات أو تعدّلها أو تمدّدها باستخدام نماذج ByteDance Seedance (‏Seedance 2.5 و2.5 Draft و2.0 و2.0 Fast و2.0 Mini) موجّهة بنص توجيهي وصور أو فيديوهات أو صوت مرجعية اختيارية أو أصول مكتبة سبق رفعها. تقوم برفع المراجع، وإرسال مهمة توليد، والانتظار حتى الاكتمال، ثم إرجاع ملف الفيديو النهائي. يؤدي اختيار `Seedance 2.5 Draft` إلى عرض معاينة سريعة بدقة 480p بدلًا من ذلك؛ صِل مخرج `draft_task_id` الناتج بعقدة ByteDance Seedance 2.5 Draft to Final Video لعرض النسخة النهائية بدقة 1080p.

## المدخلات

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

| Parameter | Description | Data Type | Required | Range |
|-----------|-------------|-----------|----------|-------|
| `model` | مُحدِّد النموذج. اختر Seedance 2.5 لأحدث نموذج، وفيديوهات تصل إلى 30 ثانية ومخرجات mp4؛ وSeedance 2.5 Draft لمعاينة سريعة بدقة 480p يُنتج مخرج `draft_task_id` منها النسخة النهائية بدقة 1080p في عقدة ByteDance Seedance 2.5 Draft to Final Video؛ وSeedance 2.0 لأقصى جودة و4k؛ وFast لتحسين السرعة؛ وMini لأسرع توليد وأقل تكلفة. يؤدي اختيار نموذج إلى تغيير عناصر الإدخال الظاهرة أدناه. | DYNAMIC_COMBO | نعم | "Seedance 2.5"<br>"Seedance 2.5 Draft"<br>"Seedance 2.0"<br>"Seedance 2.0 Fast"<br>"Seedance 2.0 Mini" |
| `seed` | يتحكم `seed` فيما إذا كان يجب إعادة تشغيل العقدة؛ النتائج غير حتمية بغض النظر عن `seed`. الافتراضي: 0. | INT | نعم | 0 إلى 2147483647 |
| `علامة مائية` | هل تُضاف علامة مائية إلى الفيديو. الافتراضي: False. إعداد متقدم. | BOOLEAN | نعم | true<br>false |

### مدخلات Seedance 2.5

تظهر هذه المدخلات عندما يكون `model` مضبوطًا على "Seedance 2.5".

| Parameter | Description | Data Type | Required | Range |
|-----------|-------------|-----------|----------|-------|
| `prompt` | النص التوجيهي لتوليد الفيديو. ضع الجمل المنطوقة بين علامتي اقتباس مزدوجتين لتوجيه الحوار المُولَّد. الافتراضي: سلسلة فارغة. | STRING | نعم | نص متعدد الأسطر |
| `resolution` | دقة الفيديو الناتج. الافتراضي: 720p. | COMBO | نعم | "480p"<br>"720p"<br>"1080p" |
| `ratio` | نسبة أبعاد الفيديو الناتج. الافتراضي: 16:9. | COMBO | نعم | "16:9"<br>"4:3"<br>"1:1"<br>"3:4"<br>"9:16"<br>"21:9"<br>"adaptive" |
| `duration` | مدة الفيديو الناتج بالثواني (4-30). الافتراضي: 5. | INT | نعم | 4 إلى 30 |
| `generate_audio` | تمكين توليد الصوت للفيديو الناتج. الافتراضي: True. | BOOLEAN | نعم | true<br>false |
| `task_type` | ما الذي يجب فعله بالوسائط المرجعية. يتم التحقق من كل قيمة باستثناء auto عند إرسال المهمة، لذا تفشل الإعدادات غير المتوافقة قبل بدء التوليد.<br>auto: يستنتج النموذج المهمة من النص التوجيهي والمدخلات، ولا تفشل الإعدادات المتعارضة مع قراءته إلا بعد بدء التوليد.<br>reference: توليد فيديو جديد موجّه بالصور والفيديوهات والصوت المرجعية.<br>edit: تغيير فيديو مرجعي متصل (إضافة أو إزالة أو استبدال)؛ يحتفظ الناتج بطول المقطع المصدر ونسبة أبعاده، ويتم تجاهل عنصري `duration` و `ratio`.<br>extend: متابعة فيديو مرجعي متصل إلى الأمام أو الخلف؛ ينبغي أن يقول النص التوجيهي "extend forward" أو "extend backward" أو "continue"، وتتبع نسبة الأبعاد المقطع المصدر، ويحتوي الناتج فقط على المقطع المُولَّد حديثًا بالمدة التي حددتها، وليس المقطع المصدر. الافتراضي: auto. | COMBO | نعم | "auto"<br>"reference"<br>"edit"<br>"extend" |
| `output_format` | تنسيق الحاوية للفيديو الناتج. الافتراضي: mp4. | COMBO | نعم | "mp4" |

### مدخلات Seedance 2.5 Draft

تظهر هذه المدخلات عندما يكون `model` مضبوطًا على "Seedance 2.5 Draft". تطابق مجموعة المعاملات Seedance 2.5 أعلاه، باستثناء أن `resolution` يوفر فقط `"480p"` (الافتراضي `"480p"`).

### مدخلات Seedance 2.0

تظهر هذه المدخلات عندما يكون `model` مضبوطًا على "Seedance 2.0".

| Parameter | Description | Data Type | Required | Range |
|-----------|-------------|-----------|----------|-------|
| `prompt` | النص التوجيهي لتوليد الفيديو. الافتراضي: سلسلة فارغة. | STRING | نعم | نص متعدد الأسطر |
| `resolution` | دقة الفيديو الناتج. | COMBO | نعم | "480p"<br>"720p"<br>"1080p"<br>"4k" |
| `ratio` | نسبة أبعاد الفيديو الناتج. الافتراضي: adaptive. | COMBO | نعم | "16:9"<br>"4:3"<br>"1:1"<br>"3:4"<br>"9:16"<br>"21:9"<br>"adaptive" |
| `duration` | مدة الفيديو الناتج بالثواني (4-15). الافتراضي: 7. | INT | نعم | 4 إلى 15 |
| `generate_audio` | تمكين توليد الصوت للفيديو الناتج. الافتراضي: True. | BOOLEAN | نعم | true<br>false |

### مدخلات Seedance 2.0 Fast و Seedance 2.0 Mini

تظهر هذه المدخلات عندما يكون `model` مضبوطًا على "Seedance 2.0 Fast" أو "Seedance 2.0 Mini". يشترك كلا النموذجين في مجموعة المدخلات نفسها.

| Parameter | Description | Data Type | Required | Range |
|-----------|-------------|-----------|----------|-------|
| `prompt` | النص التوجيهي لتوليد الفيديو. الافتراضي: سلسلة فارغة. | STRING | نعم | نص متعدد الأسطر |
| `resolution` | دقة الفيديو الناتج. | COMBO | نعم | "480p"<br>"720p" |
| `ratio` | نسبة أبعاد الفيديو الناتج. الافتراضي: adaptive. | COMBO | نعم | "16:9"<br>"4:3"<br>"1:1"<br>"3:4"<br>"9:16"<br>"21:9"<br>"adaptive" |
| `duration` | مدة الفيديو الناتج بالثواني (4-15). الافتراضي: 7. | INT | نعم | 4 إلى 15 |
| `generate_audio` | تمكين توليد الصوت للفيديو الناتج. الافتراضي: True. | BOOLEAN | نعم | true<br>false |

### المدخلات المرجعية

تتوفر فتحات المراجع القابلة للتوسيع هذه لجميع النماذج. يختلف الحد الأقصى لعدد الفتحات حسب النموذج: يدعم Seedance 2.5 ما يصل إلى 30 صورة و10 فيديوهات و10 مقاطع صوتية و30 أصلًا؛ ويدعم Seedance 2.0 و2.0 Fast و2.0 Mini ما يصل إلى 9 صور و3 فيديوهات و3 مقاطع صوتية و9 أصول.

| Parameter | Description | Data Type | Required | Range |
|-----------|-------------|-----------|----------|-------|
| `reference_images` | فتحة قابلة للتوسيع: صِل 1..N من الصور المرجعية التي توجّه الناتج. حد العدد لكل نموذج (راجع أقسام النماذج). يتم التحقق من الصور من حيث نسبة الأبعاد (0.4 إلى 2.5) ويتم تصغيرها تلقائيًا إلى حد أقصى للضلع يبلغ 6000 بكسل. | IMAGE | لا | 1..9 فتحات (عائلة Seedance 2.0)<br>1..30 فتحة (Seedance 2.5) |
| `reference_videos` | فتحة قابلة للتوسيع: صِل 1..N من الفيديوهات المرجعية. حد العدد لكل نموذج (راجع أقسام النماذج). يجب أن يكون طول كل فيديو 1.8 ثانية على الأقل وأن يتوافق مع حدود البكسل للنموذج والدقة المحددين. | VIDEO | لا | 1..3 فتحات (عائلة Seedance 2.0)<br>1..10 فتحات (Seedance 2.5) |
| `reference_audios` | فتحة قابلة للتوسيع: صِل 1..N من المسارات الصوتية المرجعية. حد العدد لكل نموذج (راجع أقسام النماذج). يجب أن يكون طول كل مقطع صوتي 1.8 ثانية على الأقل. | AUDIO | لا | 1..3 فتحات (عائلة Seedance 2.0)<br>1..10 فتحات (Seedance 2.5) |
| `reference_assets` | فتحة قابلة للتوسيع: صِل 1..N من سلاسل معرّف الأصل لوسائط سبق رفعها إلى مكتبة Seedance الافتراضية. يجب أن يكون كل أصل بحالة Active. يمكنك الإشارة إلى أصل في النص التوجيهي برموز مثل `asset1` أو `asset 1`؛ تستبدلها العقدة بالعلامة الموضعية للأصل (على سبيل المثال "Image 2" أو "Video 1"). | STRING | لا | 1..9 فتحات (عائلة Seedance 2.0)<br>1..30 فتحة (Seedance 2.5) |
| `auto_downscale` | تصغير الفيديوهات المرجعية تلقائيًا التي تتجاوز ميزانية البكسل للنموذج بالنسبة للدقة المحددة. تُحفظ نسبة الأبعاد؛ لا تُمس الفيديوهات الواقعة ضمن الحدود بالفعل. الافتراضي: True. | BOOLEAN | لا | true<br>false |
| `auto_upscale` | تكبير الفيديوهات المرجعية تلقائيًا التي تقل عن الحد الأدنى لعدد البكسل للنموذج بالنسبة للدقة المحددة. تُحفظ نسبة الأبعاد؛ لا تُمس الفيديوهات المستوفية للحد الأدنى بالفعل. ملاحظة: تكبير مصدر منخفض الدقة لا يضيف تفاصيل حقيقية وقد ينتج عمليات توليد بجودة أقل. الافتراضي: False. إعداد متقدم. | BOOLEAN | لا | true<br>false |

**ملاحظة:** يلزم وجود صورة مرجعية واحدة على الأقل أو فيديو أو أصل لتشغيل العقدة (يقبل Seedance 2.5 أيضًا مراجع صوتية فقط). يجب أن يكون طول كل من الفيديوهات والمقاطع الصوتية المرجعية 1.8 ثانية على الأقل، ويجب ألا يتجاوز مجموع مدة كل الفيديوهات المرجعية (وبشكل منفصل، كل المقاطع الصوتية المرجعية) الحد الأقصى لإجمالي الثواني للنموذج المحدد. يجب أن تكون نسبة أبعاد الصور المرجعية بين 2:5 و5:2 تقريبًا (0.4 إلى 2.5)، وألا تقل عن 300×300 بكسل، ويتم تصغيرها تلقائيًا إلى حد أقصى للضلع يبلغ 6000 بكسل. تتوفر خيارات `task_type` "edit" و"extend" فقط مع Seedance 2.5، وكلاهما يتطلب فيديو مرجعيًا واحدًا على الأقل؛ عند استخدام "edit"، يحتفظ الناتج بطول المقطع المصدر ونسبة أبعاده ويتم تجاهل عنصري `duration` و`ratio`، وعند استخدام "extend"، يحتوي الناتج فقط على المقطع المُولَّد حديثًا بالمدة التي حددتها. يجب أن تكون الأصول المرجعية بحالة Active، وإلا تفشل المهمة. تُرجع كل عملية تشغيل معرّف المهمة الخاص بها باسم `draft_task_id`، لكن معرّف تشغيل `Seedance 2.5 Draft` فقط هو الذي يمكن لعقدة ByteDance Seedance 2.5 Draft to Final Video عرضه، لذا مع أي نموذج آخر يجب ترك المخرج غير متصل، وإلا فشل التشغيل.

## المخرجات

| Output Name | Description | Data Type |
|-------------|-------------|-----------|
| `video` | الفيديو الناتج، الذي يُنزَّل من المزوّد بمجرد اكتمال مهمة التوليد. يحتوي على صوت عند تمكين توليد الصوت. | VIDEO |
| `draft_task_id` | معرّف المهمة الذي تُرجعه عملية التشغيل. فقط تشغيل `Seedance 2.5 Draft` ينتج مسودة يمكن لعقدة ByteDance Seedance 2.5 Draft to Final Video عرضها؛ مع أي نموذج آخر يجب ترك المخرج غير متصل، وإلا فشل التشغيل. | STRING |

> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/ar.md)

---
**Source fingerprint (SHA-256):** `12fee29b280ff71e29f268f52131d1c15cf3066e0804356b735b61d97c80a6a9`
