### نمای کلی

این گره با استفاده از مدل Kling V3 ویدیو تولید می‌کند. از دو حالت اصلی پشتیبانی می‌کند: **متن به ویدیو** که در آن ویدیو بر اساس توضیحات متنی ساخته می‌شود، و **تصویر به ویدیو** که در آن یک تصویر موجود پویانمایی می‌شود. همچنین قابلیت‌های پیشرفته‌ای مانند ساخت ویدیوهای چندبخشی با دستورات متفاوت برای هر بخش (storyboard) و تولید اختیاری صدای هم‌زمان را ارائه می‌دهد.

## ورودی‌ها

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
| --- | --- | --- | --- | --- |
| `چند شات` | مشخص می‌کند که یک ویدیوی تکی تولید شود یا مجموعه‌ای از بخش‌ها با دستورات و مدت‌زمان مجزا. در صورت غیرفعال نبودن، ورودی‌های اضافی برای دستور و مدت‌زمان هر استوری‌بورد ظاهر می‌شود. | COMBO | بله | `"غیرفعال"`<br>`"1 استوری‌بورد"`<br>`"2 استوری‌بورد"`<br>`"3 استوری‌بورد"`<br>`"4 استوری‌بورد"`<br>`"5 استوری‌بورد"`<br>`"6 استوری‌بورد"` |
| `تولید صوت` | در صورت فعال بودن، گره برای ویدیو صدا تولید می‌کند. پیش‌فرض `True` است. | BOOLEAN | بله | `True` / `False` |
| `مدل` | مدل و تنظیمات مرتبط با آن. انتخاب این گزینه زیرپارامترهای `resolution` و `aspect_ratio` را نمایش می‌دهد. | COMBO | بله | `"kling-v3"` |
| `model.resolution` | وضوح تصویر ویدیوی تولیدشده. این تنظیم زمانی در دسترس است که `مدل` روی "kling-v3" تنظیم شده باشد. | COMBO | بله | `"4k"`<br>`"1080p"`<br>`"720p"` |
| `model.aspect_ratio` | نسبت ابعاد ویدیوی تولیدشده. زمانی که تصویری برای `فریم شروع` (حالت تصویر به ویدیو) ارائه شود، این تنظیم نادیده گرفته می‌شود. زمانی در دسترس است که `مدل` روی "kling-v3" تنظیم شده باشد. | COMBO | بله | `"16:9"`<br>`"9:16"`<br>`"1:1"` |
| `seed` | مقدار دانه (seed) برای تولید. تغییر این مقدار باعث اجرای مجدد گره می‌شود، اما نتایج غیرقطعی هستند. پیش‌فرض `0` است. | INT | بله | 0 تا 2147483647 |
| `فریم شروع` | یک تصویر شروع اختیاری. هنگام اتصال، گره از حالت متن به ویدیو به حالت تصویر به ویدیو تغییر وضعیت می‌دهد و تصویر ارائه‌شده را پویانمایی می‌کند. | IMAGE | خیر | - |

**ورودی‌های حالت `multi_shot`:**

* زمانی که `multi_shot` روی **"غیرفعال"** تنظیم شده باشد، ورودی‌های زیر ظاهر می‌شوند:
  * `prompt` (STRING): توضیحات متنی اصلی برای ویدیو. الزامی. باید بین 1 تا 2500 کاراکتر باشد.
  * `negative_prompt` (STRING): متنی که مشخص می‌کند چه چیزی نباید در ویدیو ظاهر شود. اختیاری.
  * `duration` (INT): طول ویدیو بر حسب ثانیه. باید بین 3 تا 15 باشد. پیش‌فرض `5` است.
* زمانی که `multi_shot` روی یک گزینه استوری‌بورد (مثلاً `"3 استوری‌بورد"`) تنظیم شده باشد، ورودی‌هایی برای هر بخش استوری‌بورد ظاهر می‌شود (مثلاً `storyboard_1_prompt`، `storyboard_1_duration`). هر دستور باید بین 1 تا 512 کاراکتر باشد. **مجموع کل مدت‌زمان‌های استوری‌بورد** باید بین 3 تا 15 ثانیه باشد.

**محدودیت‌ها:**

* گره در حالت **متن به ویدیو** کار می‌کند زمانی که `start_frame` متصل نباشد. در این حالت از تنظیم `model.aspect_ratio` استفاده می‌کند.
* گره در حالت **تصویر به ویدیو** کار می‌کند زمانی که `start_frame` متصل باشد. تنظیم `model.aspect_ratio` نادیده گرفته می‌شود. تصویر ورودی باید حداقل 300x300 پیکسل باشد و نسبت ابعادی بین 1:2.5 و 2.5:1 داشته باشد.
* در حالت استوری‌بورد (`multi_shot` غیرفعال نباشد)، ورودی‌های اصلی `prompt` و `negative_prompt` پنهان شده و استفاده نمی‌شوند.

## خروجی‌ها

| نام خروجی | توضیحات | نوع داده |
| --- | --- | --- |
| `video` | فایل ویدیوی تولیدشده. | VIDEO |

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

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