# HeyGen Video 1.0 Reference to Video

یک ویدیو با گفت‌وگوی همگام‌شده و صدا را از یک پرامپت متنی با استفاده از HeyGen Video 1.0 تولید کنید و به‌صورت اختیاری با مواد مرجع متصل‌شده راهنمایی بگیرید. تصاویر افراد، محصولات یا مکان‌ها، ویدیوهایی برای استفادهٔ مجدد و کلیپ‌های صوتی که یک صدا را فراهم می‌کنند، همگی می‌توانند به‌عنوان مرجع استفاده شوند. هر مرجع را در پرامپت به‌صورت @Image1، @Video1 یا @Audio1 ذکر کنید و آن‌ها را بر اساس نوع و به ترتیب اتصال ورودی‌ها شماره‌گذاری کنید: این برچسب‌ها به برچسب‌هایی که HeyGen انتظار دارد بازنویسی می‌شوند و برچسبی که به مرجع متصل‌نشده اشاره کند خطا می‌دهد. بدون هیچ تصویر یا ویدیوی مرجع، این گره به‌صورت تولید ویدیو از متن اجرا می‌شود.

## ورودی‌ها

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `مدل` | نسخه مدل استفاده‌شده برای تولید. (پیش‌فرض: `"heygen-video-1"`) | DYNAMIC_COMBO | بله | `"heygen-video-1"` |
| `prompt` | توضیح ویدیو، شامل هر گفت‌وگو. به مرجع‌های متصل به‌صورت @Image1، @Video1، @Audio1 ارجاع دهید، که برای هر نوع به ترتیب ورودی شماره‌گذاری می‌شوند. (پیش‌فرض: رشته خالی) | STRING | بله | 1 تا 32000 کاراکتر |
| `duration` | مدت‌زمان ویدیوی خروجی بر حسب ثانیه. (پیش‌فرض: 5) | INT | بله | 5 تا 15 |
| `resolution` | رزولوشن خروجی. رزولوشن 2k به نسبت ابعاد 16:9 یا 9:16 نیاز دارد؛ `"auto"` فقط بدون مرجع در 2k کار می‌کند. (پیش‌فرض: `"768p"`) | COMBO | بله | `"768p"`<br>`"480p"`<br>`"2k"` |
| `aspect_ratio` | نسبت ابعاد خروجی. `"auto"` وقتی هیچ مرجعی متصل نیست 16:9 است، در غیر این صورت از نخستین تصویر مرجع پیروی می‌کند، یا وقتی هیچ تصویری متصل نیست از نخستین ویدیوی مرجع. (پیش‌فرض: `"auto"`) | COMBO | بله | `"auto"`<br>`"16:9"`<br>`"9:16"`<br>`"1:1"`<br>`"4:3"`<br>`"3:4"`<br>`"21:9"` |
| `seed` | Seed برای تولید. نتایج هنوز می‌توانند بین اجراها با همان Seed متفاوت باشند. (پیش‌فرض: 42) | INT | بله | 0 تا 4294967295 |
| `reference_images` | اسلات قابل‌افزایش: تصاویر افراد، محصولات یا مکان‌ها برای استفاده در ویدیو (`image_1` ... `image_9`)؛ به آن‌ها به‌صورت @Image1، @Image2، ... ارجاع دهید. هر ورودی باید دقیقاً شامل یک تصویر باشد، و نسبت ابعاد هر تصویر باید بین 1:4 و 4:1 باشد. | IMAGE | خیر | 0 تا 9 تصویر |
| `reference_videos` | اسلات قابل‌افزایش: ویدیوهایی برای استفاده به‌عنوان مرجع (`video_1` ... `video_3`)؛ به آن‌ها به‌صورت @Video1، @Video2، ... ارجاع دهید. | VIDEO | خیر | 0 تا 3 ویدیو |
| `reference_audios` | اسلات قابل‌افزایش: کلیپ‌های صوتی مانند صدای یک گوینده (`audio_1` ... `audio_3`)؛ به آن‌ها به‌صورت @Audio1، @Audio2، ... ارجاع دهید. حداقل به یک تصویر یا ویدیوی مرجع نیاز دارد. یک مرجع صوتی به چند ثانیه گفتار تمیز نیاز دارد، و کلیپ‌های کوتاه‌تر از حدود 2 ثانیه معمولاً نادیده گرفته می‌شوند. | AUDIO | خیر | 0 تا 3 کلیپ صوتی |

### محدودیت‌های پارامترها

- **محدودیت مرجع:** حداکثر 12 مرجع در مجموع در `reference_images`، `reference_videos` و `reference_audios`؛ اتصال بیشتر خطا ایجاد می‌کند.
- **صدا به تصویر یا ویدیو نیاز دارد:** وقتی هیچ تصویر مرجع و هیچ ویدیوی مرجعی متصل نباشد، صدای مرجع رد می‌شود.
- **قواعد تصویر مرجع:** هر ورودی `reference_images` باید دقیقاً یک تصویر داشته باشد (یک دسته رد می‌شود)، و نسبت ابعاد هر تصویر باید بین 1:4 و 4:1 باشد.
- **برچسب‌های پرامپت:** `@ImageN`، `@VideoN` و `@AudioN` بدون حساسیت به بزرگی و کوچکی حروف تطبیق داده می‌شوند. عدد نباید از تعداد مرجع‌های متصل از آن نوع بیشتر باشد، و پرامپت پس از حذف فاصله‌های ابتدایی و انتهایی باید غیرخالی باشد.
- **حالت:** با حداقل یک تصویر یا ویدیوی مرجع، درخواست یک اجرای مرجع‌به‌ویدیو است؛ بدون هیچ‌کدام، یک اجرای ساده متن‌به‌ویدیو است.
- **رزولوشن 2k:** وقتی `resolution` برابر `"2k"` است، `aspect_ratio` باید `"16:9"` یا `"9:16"` باشد؛ `"auto"` فقط زمانی در 2k پذیرفته می‌شود که هیچ تصویر مرجع و هیچ ویدیوی مرجعی متصل نباشد.
- **Seed:** seed فقط تعیین می‌کند که گره دوباره اجرا شود؛ نتایج با همان seed قابل بازتولید نیستند.

## خروجی‌ها

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

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

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