# ByteDance vCube Video Enhance

این گره ویدئوها را با استفاده از ByteDance vCube بزرگنمایی و بازیابی می‌کند. می‌تواند وضوح را تا 8K افزایش دهد، آثار فشرده‌سازی و نویز را حذف کند، رنگ و تیزی را بهبود بخشد و به‌صورت اختیاری فریم‌ها را برای نرخ فریم بالاتر درون‌یابی کند. ویدئو به سرویس vCube بارگذاری می‌شود، با پیش‌تنظیم بهبود انتخاب‌شده پردازش می‌شود و به‌صورت یک فایل ویدئوی بهبودیافته بازگردانده می‌شود.

## ورودی‌ها

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

این ورودی‌ها همیشه قابل مشاهده هستند.

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `ویدئو` | ویدئویی که باید بهبود یابد. وضوح منبع باید حداکثر 2560x1440 (2K) باشد؛ اندازه خروجی با ورودی resolution تعیین می‌شود. | VIDEO | بله | حداکثر 2560x1440 (2K) |
| `tool_version` | 'standard' سرعت و کیفیت را با بیش از 10 الگوریتم بهبود متعادل می‌کند. 'professional' از بیش از 30 الگوریتم برای بازیابی در سطح سینمایی استفاده می‌کند، حدود 3 برابر بیشتر طول می‌کشد و 10 برابر گران‌تر است. | DYNAMIC_COMBO | بله | "standard"<br>"professional" |
| `وضوح` | وضوح خروجی. ضلع کوتاه روی سطح انتخاب‌شده تنظیم می‌شود و ضلع بلند از نسبت ابعاد منبع پیروی می‌کند. 'source' اندازه منبع را حفظ می‌کند، 'custom' ضلع کوتاه را بر حسب پیکسل تنظیم می‌کند. منابعی که عرض یا ارتفاعشان بیش از حدود 2.2:1 باشد، یک رده وضوح بالاتر محاسبه می‌شوند. | DYNAMIC_COMBO | بله | "720p"<br>"1080p"<br>"2k"<br>"4k"<br>"8k"<br>"source"<br>"custom" |
| `fps` | نرخ فریم خروجی. نرخ بالاتر از منبع، درون‌یابی فریم با هوش مصنوعی را فعال می‌کند؛ نرخ پایین‌تر فریم‌ها را حذف می‌کند. 'source' نرخ منبع را تا 120 fps حفظ می‌کند. نرخ‌های بالای 30 fps دو برابر و بالای 60 fps چهار برابر هزینه دارند. (پیش‌فرض: "source") | COMBO | بله | "source" (پیش‌فرض)<br>نرخ‌های فریم عددی تا 120 fps |
| `bitrate_level` | نرخ بیت هدف فایل تحویلی، متناسب با وضوح و نرخ فریم خروجی مقیاس می‌شود. (پیش‌فرض: "medium") | COMBO | بله | "low"<br>"medium"<br>"high" |

### ورودی‌های استاندارد

زمانی نمایش داده می‌شود که `tool_version` روی "standard" تنظیم شده باشد.

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `scene` | پیش‌تنظیم متناسب با محتوا: 'aigc' برای فوتیج تولیدشده با هوش مصنوعی، 'common' برای ویدئوی عمومی، 'ugc' برای کلیپ‌های فشرده گوشی، 'short_series' برای درام دارای چهره، 'old_film' برای فوتیج آرشیوی خش‌دار یا سوسوزن. (پیش‌فرض: "aigc") | COMBO | بله | "aigc"<br>"common"<br>"ugc"<br>"short_series"<br>"old_film" |
| `enhance_style` | 'hd' بهبود تیزتری اعمال می‌کند؛ 'natural' شدت را کاهش می‌دهد تا ظاهری نرم‌تر و کمتر تیز داشته باشد. (پیش‌فرض: "hd") | COMBO | بله | "hd"<br>"natural" |

### ورودی‌های حرفه‌ای

زمانی نمایش داده می‌شود که `tool_version` روی "professional" تنظیم شده باشد.

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `enhance_style` | 'hd' بهبود تیزتری اعمال می‌کند؛ 'natural' شدت را کاهش می‌دهد تا ظاهری نرم‌تر و کمتر تیز داشته باشد. (پیش‌فرض: "hd") | COMBO | بله | "hd"<br>"natural" |

### ورودی‌های وضوح سفارشی

زمانی نمایش داده می‌شود که `resolution` روی "custom" تنظیم شده باشد.

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `short_side` | ضلع کوتاه خروجی بر حسب پیکسل؛ ضلع بلند از نسبت ابعاد منبع پیروی می‌کند. (پیش‌فرض: 1080) | INT | بله | پیش‌فرض 1080؛ محدودشده توسط حداقل و حداکثر محدودیت‌های ضلع کوتاه vCube |

### نکات

- ویدئوی منبع باید حداکثر 2560x1440 (2K) باشد. ویدئوهای بزرگ‌تر از این رد می‌شوند و باید پیش از بهبود، کوچک مقیاس شوند.
- مدت ویدئوی منبع به حداکثر مدت پشتیبانی‌شده توسط سرویس vCube محدود است.
- وقتی `tool_version` روی "standard" باشد، هم `scene` و هم `enhance_style` در دسترس هستند. وقتی روی "professional" باشد، فقط `enhance_style` در دسترس است.
- وقتی `resolution` روی "custom" باشد، مقدار `short_side` الزامی است. پیش‌تنظیم‌های وضوح و "source" از `short_side` استفاده نمی‌کنند.
- وقتی `resolution` روی "source" باشد و ضلع کوتاه منبع دست‌کم برابر با حداقل محدودیت ضلع کوتاه باشد، خروجی وضوح منبع را حفظ می‌کند.
- وقتی `fps` روی "source" باشد، نرخ فریم خروجی با نرخ فریم منبع مطابقت دارد، تا 120 fps.

## خروجی‌ها

| نام خروجی | توضیحات | نوع داده |
|-------------|-------------|-----------|
| `video` | ویدئوی بهبودیافته، بزرگ‌نمایی‌شده و بازیابی‌شده با وضوح و نرخ فریم درخواستی. | VIDEO |

> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/fa.md)

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