# ویدئوی آواتار HeyGen

از یک آواتار HeyGen یک ویدیوی ارائه‌دهندهٔ سخنگو بسازید. این گره ویدیویی از یک آواتار هوش مصنوعی می‌سازد که متن ارائه‌شدهٔ شما را بیان می‌کند یا با صدای خودتان لب‌هماهنگ می‌شود و از موتورهای رندر HeyGen استفاده می‌کند.

## ورودی‌ها

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

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `موتور` | موتور رندر؛ هر گزینه فقط آواتارهایی را فهرست می‌کند که از آن پشتیبانی می‌کنند. "auto" همهٔ آواتارها را ارائه می‌دهد و بهترین موتور آن‌ها را انتخاب می‌کند (Avatar IV ترجیح داده می‌شود). Avatar V بالاترین وفاداری را دارد، Avatar III مقرون‌به‌صرفه‌ترین است. | DYNAMIC_COMBO | بله | `"auto"`<br>`"avatar_iv"`<br>`"avatar_iii"`<br>`"avatar_v"` |
| `شناسه آواتار سفارشی` | شناسهٔ ظاهر آواتار HeyGen اختیاری. وقتی تنظیم شود، آواتار انتخاب‌شده در بالا را نادیده می‌گیرد. می‌توان از هر یک از بیش از ۳۰۰۰ ظاهر عمومی HeyGen (یا آواتارهای خصوصی خودتان) استفاده کرد. پیش‌فرض: `""`. | STRING | خیر |  |
| `گفتار` | آواتار را با یک متن گفتار (تبدیل متن به گفتار HeyGen) یا صدای خودتان هدایت کنید. نام نمایشی: «منبع گفتار». | DYNAMIC_COMBO | بله | `"script"`<br>`"audio"` |
| `وضوح تصویر` | رزولوشن ویدیوی خروجی. پیش‌فرض: `"1080p"`. | COMBO | خیر | `"720p"`<br>`"1080p"` |
| `نسبت تصویر` | نسبت تصویر خروجی. "auto" از فوتیج منبع آواتار پیروی می‌کند. پیش‌فرض: `"auto"`. | COMBO | خیر | `"auto"`<br>`"16:9"`<br>`"9:16"`<br>`"1:1"`<br>`"4:5"`<br>`"5:4"` |
| `رنگ پس‌زمینه` | رنگ پس‌زمینهٔ یکدست اختیاری به‌صورت کد هگز (مثلاً `"#00ff00"`). برای پس‌زمینهٔ خود آواتار خالی بگذارید. اگر ارائه شود، مقدار باید با `#` شروع شود. پیش‌فرض: `""`. | STRING | خیر |  |
| `seed` | به HeyGen ارسال نمی‌شود؛ آن را تغییر دهید تا اجرای مجدد اجباری شود. پیش‌فرض: `42`. | INT | خیر | حداقل: 0<br>حداکثر: 2147483647 |

### ورودی‌های `auto`

وقتی `engine` برابر `"auto"` است، زیرپارامتر زیر در دسترس است:

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `avatar` | ظاهر آواتار برای ارائهٔ ویدیو (گزیده‌شده از کتابخانهٔ عمومی HeyGen). بهترین موتوری که این ظاهر پشتیبانی می‌کند به‌صورت خودکار انتخاب می‌شود. | COMBO | بله | گزینه‌های متعدد موجود است |

### ورودی‌های `avatar_iv`

وقتی `engine` برابر `"avatar_iv"` است، زیرپارامتر زیر در دسترس است:

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `avatar` | ظاهرهای آواتاری که از موتور Avatar IV پشتیبانی می‌کنند. | COMBO | بله | گزینه‌های متعدد موجود است |

### ورودی‌های `avatar_iii`

وقتی `engine` برابر `"avatar_iii"` است، زیرپارامتر زیر در دسترس است:

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `avatar` | ظاهرهای آواتاری که از موتور Avatar III پشتیبانی می‌کنند. | COMBO | بله | گزینه‌های متعدد موجود است |

### ورودی‌های `avatar_v`

وقتی `engine` برابر `"avatar_v"` است، زیرپارامتر زیر در دسترس است:

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `avatar` | ظاهرهای آواتاری که از موتور Avatar V پشتیبانی می‌کنند. | COMBO | بله | گزینه‌های متعدد موجود است |

### ورودی‌های `script`

وقتی `speech` برابر `"script"` است، زیرپارامترهای زیر در دسترس هستند:

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `text` | متنی که آواتار باید بگوید (حداکثر ۵۰۰۰ کاراکتر). گفتار تولیدشده باید حداقل ۱ ثانیه طول داشته باشد. پیش‌فرض: `""`. | STRING | بله | حداقل: 1 کاراکتر<br>حداکثر: 5000 کاراکتر |
| `voice` | صدای متن. گزینهٔ پیش‌فرض از صدایی استفاده می‌کند که HeyGen به آواتار اختصاص داده است. اگر `custom_voice_id` تنظیم شده باشد، نادیده گرفته می‌شود. | COMBO | بله | `"(avatar's default voice)"`<br>گزینه‌های متعدد صدای عمومی موجود است |
| `custom_voice_id` | شناسهٔ صدای HeyGen اختیاری. وقتی تنظیم شود، صدای انتخاب‌شده در بالا را نادیده می‌گیرد. می‌توان از هر صدایی از کتابخانهٔ HeyGen (بیش از ۲۰۰۰) استفاده کرد. پیش‌فرض: `""`. | STRING | خیر |  |
| `voice_speed` | ضریب سرعت گفتار. پیش‌فرض: `1.0`. | FLOAT | خیر | حداقل: 0.5<br>حداکثر: 1.5<br>گام: 0.05 |

### ورودی‌های `audio`

وقتی `speech` برابر `"audio"` است، زیرپارامتر زیر در دسترس است:

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `audio` | صدایی که آواتار باید با آن لب‌هماهنگ شود، حداکثر ۱۰ دقیقه. | AUDIO | بله |  |

نکته: `engine` و `speech` انتخابگرهایی هستند که بسته به مقدار انتخاب‌شده، زیرپارامترهای متفاوتی را آشکار می‌کنند. انتخابگر `speech` دو حالت متقابلاً انحصاری دارد: در حالت `"script"`، `text` الزامی است؛ اگر `custom_voice_id` ارائه شود، `voice` را نادیده می‌گیرد. در حالت `"audio"`، آواتار با کلیپ صوتی ارائه‌شده لب‌هماهنگ می‌شود. `background_color` هنگام ارائه باید یک کد رنگ هگز باشد که با `#` شروع می‌شود. وقتی `custom_avatar_id` تنظیم شود، انتخاب `avatar` را نادیده می‌گیرد و موتور `engine` انتخاب‌شده باید توسط آن ظاهر آواتار پشتیبانی شود؛ در غیر این صورت، خطایی ایجاد می‌شود مگر اینکه `engine` برابر `"auto"` باشد.

## خروجی‌ها

| نام خروجی | توضیحات | نوع داده |
|-------------|-------------|-----------|
| `VIDEO` | ویدیوی ارائه‌دهندهٔ آواتار تولیدشده. | VIDEO |

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

---
**Source fingerprint (SHA-256):** `86dc799d3a8cf2666449b0d422853b12feffb81ce002f84594f9b925d58b522a`
