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

## بررسی اجمالی

گره LTXV Separate Generated Keyframes، کی‌فریم‌های تولیدشده‌ای را که توسط LTXV Add Generated Keyframes اضافه شده‌اند، از یک latent نمونه‌گیری‌شده جدا می‌کند و آن‌ها را از conditioning حذف می‌کند. از آن پیش از بزرگ‌نمایی فضایی latent ویدئو استفاده کنید. ابتدا LTXV Crop Guides را اجرا نکنید — زیرا با کی‌فریم‌های تولیدشده مانند راهنماهای یک‌بارمصرف رفتار می‌کند و آن‌ها را حذف می‌کند.

## ورودی‌ها

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `positive` | conditioning مثبتی که فراداده کی‌فریم تولیدشده را نگه می‌دارد. این فراداده در خروجی از آن حذف می‌شود. | CONDITIONING | بله | N/A |
| `negative` | conditioning منفی‌ای که فراداده کی‌فریم تولیدشده را نگه می‌دارد. این فراداده در خروجی از آن حذف می‌شود. | CONDITIONING | بله | N/A |
| `latent` | latent ویدئویی که شامل کی‌فریم‌های تولیدشده است. کی‌فریم‌ها در خروجی از آن جدا می‌شوند. | LATENT | بله | N/A |
| `keyframes_to_batch` | کی‌فریم‌ها را به‌صورت یک batch از latentهای تک‌فریمی برمی‌گرداند. برای دریافت آن‌ها به‌صورت یک latent چندفریمی، آن را خاموش بگذارید؛ همان چیزی که latent upsampler و یک Add Generated Keyframes بعدی انتظار دارند. | BOOLEAN | خیر | پیش‌فرض: False |

### نکات مربوط به ورودی‌ها

- `positive` باید فراداده کی‌فریم تولیدشده را داشته باشد؛ در غیر این صورت گره خطایی ایجاد می‌کند و به شما می‌گوید که ابتدا آن‌ها را با LTXV Add Generated Keyframes اضافه کنید.
- `latent` باید یک latent ویدئوی ساده (یک تنسور 5D) باشد. اگر latentهای ویدئو و صدا هنوز ترکیب هستند، ابتدا آن‌ها را با Separate AV Latent جدا کنید.
- تعداد توکن‌ها به ازای هر فریم latent که هنگام افزودن کی‌فریم‌ها ثبت شده است باید با تعداد توکن‌ها به ازای هر فریم در `latent` ارائه‌شده مطابقت داشته باشد. اگر latent پس از افزودن کی‌فریم‌ها تغییر مقیاس داده شده باشد، دیگر هم‌تراز نیستند و گره خطا ایجاد می‌کند — پیش از بزرگ‌نمایی latent آن‌ها را جدا کنید.
- محدوده فریم کی‌فریم ثبت‌شده باید در `latent` ارائه‌شده جای بگیرد؛ در غیر این صورت گره خطایی ایجاد می‌کند مبنی بر اینکه کی‌فریم‌ها برای latent دیگری ثبت شده‌اند.
- اندیس درایه attention راهنمای ثبت‌شده باید هنوز در conditioning وجود داشته باشد. اگر conditioning پس از افزودن کی‌فریم‌ها بازسازی شده باشد، گره خطا ایجاد می‌کند.

## خروجی‌ها

| نام خروجی | توضیحات | نوع داده |
|-------------|-------------|-----------|
| `positive` | conditioning مثبت با فراداده کی‌فریم تولیدشده حذف‌شده. | CONDITIONING |
| `negative` | conditioning منفی با فراداده کی‌فریم تولیدشده حذف‌شده. | CONDITIONING |
| `latent` | latent ویدئو با کی‌فریم‌های تولیدشده جداشده. | LATENT |
| `keyframes` | کی‌فریم‌های جداشده، برچسب‌خورده با generated_keyframe_indices و generated_keyframe_num_frames. این‌ها را به یک Add Generated Keyframes بعدی بدهید تا اسلات‌های جدید را مقداردهی اولیه کند، یا به Generated Keyframes To Guides بدهید تا آن‌ها را به‌عنوان راهنماهای تصویری ثابت پین کنید (اگر طول بوم تغییر کرده باشد، اندیس‌ها دوباره نگاشت می‌شوند). | LATENT |

## نکات

- پارامتر `keyframes_to_batch` تعیین می‌کند که کی‌فریم‌ها به‌صورت یک batch از latentهای تک‌فریمی برگردانده شوند یا به‌صورت یک latent چندفریمی.
- گره تضمین می‌کند که کی‌فریم‌های تولیدشده پیش از هر پردازش دیگری از conditioning و latent حذف شوند.
- خروجی `keyframes` می‌تواند برای مقداردهی اولیه اسلات‌های جدید برای کی‌فریم‌های تولیدشده یا برای پین کردن آن‌ها به‌عنوان راهنماهای تصویری ثابت استفاده شود.
- اگر latent شامل کی‌فریم‌های تولیدشده نباشد یا کی‌فریم‌ها با قالب مورد انتظار مطابقت نداشته باشند، گره یک `ValueError` ایجاد می‌کند.
- گره فرض می‌کند که کی‌فریم‌های تولیدشده با استفاده از گره LTXV Add Generated Keyframes اضافه شده‌اند و با latent فعلی سازگار هستند.

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

---
**Source fingerprint (SHA-256):** `295e49181e87445a1c47b2e9413d95b20585b12e89f26f13129ac5d97f913007`
