# مرجع 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 رندر شود.

## ورودی‌ها

### ورودی‌های مشترک

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `مدل` | انتخاب‌کننده مدل. 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 غیرقطعی هستند. پیش‌فرض: 0. | INT | بله | 0 تا 2147483647 |
| `واترمارک` | اینکه آیا واترمارک به ویدیو اضافه شود یا نه. پیش‌فرض: False. تنظیم پیشرفته. | BOOLEAN | بله | true<br>false |

### ورودی‌های Seedance 2.5

این ورودی‌ها زمانی نمایش داده می‌شوند که `model` روی "Seedance 2.5" تنظیم شده باشد.

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `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" تنظیم شده باشد.

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `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" تنظیم شده باشد. هر دو مدل مجموعه ورودی یکسانی دارند.

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `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 دارایی را پشتیبانی می‌کنند.

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `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) داشته باشند، حداقل 300x300 پیکسل باشند و به‌صورت خودکار به حداکثر ضلع 6000 پیکسل کوچک می‌شوند. گزینه‌های "edit" و "extend" در `task_type` فقط با Seedance 2.5 در دسترس هستند و هر دو حداقل یک ویدیوی مرجع نیاز دارند؛ هنگامی که "edit" استفاده می‌شود، خروجی طول و نسبت ابعاد خود کلیپ منبع را حفظ می‌کند و ابزارک‌های `duration` و `ratio` نادیده گرفته می‌شوند، و هنگامی که "extend" استفاده می‌شود، خروجی فقط شامل بخش تازه تولیدشده با مدتی که تنظیم کرده‌اید است. دارایی‌های ارجاع‌شده باید در وضعیت Active باشند، در غیر این صورت وظیفه شکست می‌خورد. هر اجرا شناسه وظیفه خود را به‌عنوان `draft_task_id` برمی‌گرداند، اما فقط شناسه اجرای `Seedance 2.5 Draft` می‌تواند توسط گره ByteDance Seedance 2.5 Draft to Final Video رندر شود؛ بنابراین با هر مدل دیگری خروجی باید بدون اتصال رها شود، در غیر این صورت اجرا شکست می‌خورد.

## خروجی‌ها

| نام خروجی | توضیحات | نوع داده |
|-------------|-------------|-----------|
| `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/fa.md)

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