# LTXVAddGuide

گره LTXVAddGuide تصاویر یا ویدئوهای ورودی را از طریق یک رمزگذار VAE رمزگذاری می‌کند و آن‌ها را به‌عنوان کی‌فریم‌های راهنما به یک توالی latent ویدئویی اضافه می‌کند. این گره هم شرطی‌سازی مثبت و هم شرطی‌سازی منفی را به‌روزرسانی می‌کند و latent اصلاح‌شده را برمی‌گرداند، همراه با گزینه‌هایی برای تعیین فریم شروع، قدرت شرطی‌سازی، یک ماسک توجه اختیاری و پارامترهای اختیاری IC-LoRA.

## ورودی‌ها

| پارامتر | توضیحات | نوع داده | اجباری | بازه |
|-----------|-------------|-----------|----------|-------|
| `مثبت` | ورودی شرطی‌سازی مثبت که با راهنمایی کی‌فریم اصلاح می‌شود. | CONDITIONING | بله | - |
| `منفی` | ورودی شرطی‌سازی منفی که با راهنمایی کی‌فریم اصلاح می‌شود. | CONDITIONING | بله | - |
| `vae` | مدل VAE مورد استفاده برای رمزگذاری فریم‌های تصویر/ویدئوی ورودی. | VAE | بله | - |
| `latent` | توالی latent ورودی که فریم‌های شرطی‌سازی را دریافت می‌کند. | LATENT | بله | - |
| `تصویر` | تصویر یا ویدئویی که latent ویدئویی بر اساس آن شرطی می‌شود. باید 8*n + 1 فریم باشد. اگر ویدئو 8*n + 1 فریم نباشد، به نزدیک‌ترین تعداد 8*n + 1 فریم برش داده می‌شود. | IMAGE | بله | - |
| `اندیس فریم` | شاخص فریمی که شرطی‌سازی از آن شروع می‌شود. برای تصاویر تک‌فریم یا ویدئوهای با 1 تا 8 فریم، هر مقدار frame_idx قابل قبول است. برای ویدئوهای با 9 فریم یا بیشتر، frame_idx باید بر 8 بخش‌پذیر باشد؛ در غیر این صورت به نزدیک‌ترین مضرب 8 به سمت پایین گرد می‌شود. مقادیر منفی از انتهای ویدئو شمرده می‌شوند. پیش‌فرض: 0. | INT | بله | -9999 تا 9999 |
| `شدت` | قدرت تأثیر شرطی‌سازی، به‌طوری‌که 1.0 شرطی‌سازی کامل و 0.0 بدون شرطی‌سازی اعمال می‌کند. پیش‌فرض: 1.0. | FLOAT | بله | 0.0 تا 10.0 |
| `attention_mask` | ماسک مکانی اختیاری در فضای پیکسلی. تأثیر شرطی‌سازی را به‌ازای هر ناحیه از طریق self-attention کنترل می‌کند و در strength ضرب می‌شود. | MASK | خیر | - |
| `iclora_parameters` | پارامترهای اختیاری IC-LoRA از یک گره Get IC-LoRA Parameters. برای تنظیم پردازش راهنما همان‌گونه که برخی IC-LoRAها نیاز دارند استفاده می‌شود (مثلاً آن‌هایی که `reference_downscale_factor` بزرگ‌تر از 1 دارند). هنگام زنجیره‌سازی، هر LTXVAddGuide فقط از پارامترهای متصل به خودش استفاده می‌کند. | IC_LORA_PARAMETERS | خیر | - |

**توجه:** تصویر/ویدئوی ورودی باید تعداد فریمی مطابق الگوی 8*n + 1 داشته باشد (مثلاً 1، 9، 17، 25 فریم). اگر ورودی از این الگو بیشتر باشد، به‌طور خودکار به نزدیک‌ترین تعداد فریم معتبر برش داده می‌شود.

**توجه درباره `iclora_parameters`:** هنگام استفاده از پارامترهای IC-LoRA با `reference_downscale_factor` بزرگ‌تر از 1، ابعاد مکانی latent (عرض و ارتفاع) باید بر آن عامل بخش‌پذیر باشند. اگر این شرط برآورده نشود، گره خطا ایجاد می‌کند.

**توجه:** فریم‌های راهنمای رمزگذاری‌شده باید در موقعیت فریم انتخاب‌شده داخل توالی latent جای بگیرند. اگر فریم‌های شرطی‌شده از طول توالی latent فراتر روند، گره خطا ایجاد می‌کند.

**توجه:** افزودن راهنما به latentی که کانال‌های صدا و تصویر را ترکیب می‌کند پشتیبانی نمی‌شود و باعث خطا می‌شود.

## خروجی‌ها

| نام خروجی | توضیحات | نوع داده |
|-------------|-------------|-----------|
| `positive` | شرطی‌سازی مثبت به‌روزرسانی‌شده با اطلاعات راهنمای کی‌فریم. | CONDITIONING |
| `negative` | شرطی‌سازی منفی به‌روزرسانی‌شده با اطلاعات راهنمای کی‌فریم. | CONDITIONING |
| `latent` | توالی latent همراه با فریم‌های شرطی‌سازی ادغام‌شده و ماسک نویز به‌روزرسانی‌شده. | LATENT |

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

---
**Source fingerprint (SHA-256):** `031bc9030dafed85b5ff1cbceae36234e9d5f77f7f4b040267067ecd16a27929`
