# LTXV افزودن فریم‌های کلیدی تولیدشده

گره LTXV Add Generated Keyframes کی‌فریم‌های جزئیات‌دهنده را به یک لیتن ویدیو می‌افزاید. هر کی‌فریم یک فریم لیتن از توکن‌ها است که روی یک فریم پیکسلی واحد قرار می‌گیرد؛ همراه ویدیو نویززدایی می‌شود و بخشی از خروجی رمزگشایی‌شده نیست. قرارگیری به‌صورت یک اسلات در هر `interval_frames` پیکسل است، با رد کردن فریم‌های I2V، راهنماهای موجود، و کی‌فریم‌های تولیدشده‌ای که از قبل روی شرطی‌سازی هستند؛ آن‌ها را با LTXV Separate Generated Keyframes دوباره استخراج کنید. یک چک‌پوینت آموزش‌دیده برای کی‌فریم‌های تولیدشده (چک‌پوینتی که `keyframes_abs_pos_embedding` را دارد) لازم است.

## ورودی‌ها

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `positive` | شرطی‌سازی مثبتی که کی‌فریم‌ها به آن متصل می‌شوند. | CONDITIONING | بله | N/A |
| `negative` | شرطی‌سازی منفی‌ای که کی‌فریم‌ها به آن متصل می‌شوند. | CONDITIONING | بله | N/A |
| `vae` | فقط برای خواندن فاکتورهای مقیاس لیتن استفاده می‌شود. | VAE | بله | N/A |
| `latent` | لیتن ویدیوی پنج‌بعدی ساده برای تولید کی‌فریم‌ها در کنار آن. آن‌ها را قبل از Concat AV Latent اضافه کنید. | LATENT | بله | N/A |
| `interval_frames` | گام فریم پیکسلی برای قرارگیری خودکار. مقدار پیش‌فرض 24 تقریباً یک کی‌فریم در هر ثانیه با 24 fps است. پیکسل‌های اشغال‌شده رد می‌شوند. وقتی `frame_indices` تنظیم شده باشد نادیده گرفته می‌شود. (پیش‌فرض: 24) | INT | خیر | 1-1024 |
| `keyframes` | محتوای اختیاری برای مقداردهی اولیه کی‌فریم‌های جدید. کی‌فریم‌ها را از یک Separate قبلی (با همان اندازه فضایی) وصل کنید، یا یک لیتن ویدیوی ساده را برای کپی نزدیک‌ترین فریم در هر اسلات جدید (مثلاً بعد از ارتقای زمانی) وصل کنید. این‌ها همچنان نویززدایی می‌شوند و به‌عنوان راهنما پین نمی‌شوند. ایندکس‌های ثبت‌شده روی یک لیتن کی‌فریم نادیده گرفته می‌شوند مگر اینکه `frame_indices` تنظیم شده باشد. فقط زمانی اثر دارد که نمونه‌گیری زیر sigma 1 شروع شود. | LATENT | خیر | N/A |
| `frame_indices` | ایندکس‌های اختیاری فریم پیکسلی. برای قرارگیری از `interval_frames` روی بوم فعلی، خالی بگذارید. وقتی تنظیم شود، این فهرست همان قرارگیری است (کی‌فریم‌های متصل به‌ترتیب تطبیق داده می‌شوند). آخرین فریم مجاز است؛ فریم 0 مجاز نیست (از قبل یک توکن مستقل است). (پیش‌فرض: رشته خالی) | STRING | خیر | اعداد صحیح جداشده با کاما؛ 1 تا آخرین فریم پیکسلی (فریم 0 مستثنی است) |

**توجه:** `latent` باید یک لیتن ویدیوی پنج‌بعدی ساده باشد که کی‌فریم‌های تولیدشده قبل از Concat AV Latent به آن اضافه شده‌اند. وقتی `frame_indices` تنظیم شده است، هر فریم پیکسلی فهرست‌شده باید یکتا باشد و از قبل نمی‌تواند یک کی‌فریم تصویر، یک راهنما، یا یک کی‌فریم تولیدشده را نگه دارد. اگر `frame_indices` خالی باشد، پیکسل‌های اشغال‌شده به‌طور خودکار رد می‌شوند؛ اگر هیچ اسلات جزئیات‌دهی آزادی وجود نداشته باشد، گره خطا می‌دهد. هنگام افزودن به کی‌فریم‌های تولیدشده موجود، لیتن باید هنوز همان تعداد توکن در هر فریم را داشته باشد و بلوک موجود باید در آخرین فریم لیتن پایان یابد.

## خروجی‌ها

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

## نکات

- پارامتر `interval_frames` فاصله کی‌فریم‌های خودکار را تعیین می‌کند. مقدار بالاتر منجر به کی‌فریم‌های کمتر و فاصله بیشتر می‌شود؛ مقدار پایین‌تر کی‌فریم‌های بیشتری تولید می‌کند.
- ورودی `keyframes` به شما امکان می‌دهد کی‌فریم‌های جدید را با کی‌فریم‌های موجود یا یک لیتن ویدیو مقداردهی اولیه کنید. اگر یک لیتن ویدیوی ساده طولانی‌تر ارائه شود، نزدیک‌ترین فریم ویدیو در هر اسلات جدید کپی می‌شود. این کی‌فریم‌ها همچنان نویززدایی می‌شوند و به‌عنوان راهنما پین نمی‌شوند.
- پارامتر `frame_indices` به شما امکان می‌دهد ایندکس‌های دقیق فریم پیکسلی را که کی‌فریم‌ها باید در آن‌ها قرار گیرند مشخص کنید. وقتی ارائه شود، `interval_frames` نادیده گرفته می‌شود. فهرست باید شامل اعداد صحیح یکتا در محدوده معتبر پیکسل باشد، و فریم 0 مجاز نیست.
- خروجی‌های `positive` و `negative` شامل شرطی‌سازی با توجه کی‌فریم تولیدشده متصل به آن هستند.
- خروجی `latent` شامل لیتن ویدیو با کی‌فریم‌های تولیدشده است که روی T افزوده شده‌اند.
- یک چک‌پوینت آموزش‌دیده برای کی‌فریم‌های تولیدشده (چک‌پوینتی که `keyframes_abs_pos_embedding` را دارد) لازم است.
- کی‌فریم‌های تولیدشده را با LTXV Separate Generated Keyframes دوباره استخراج کنید.

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

---
**Source fingerprint (SHA-256):** `43053d15eceb61f37223c46dd46417c71f0503ef3a412ee50a3b2f764f310a64`
