diff --git a/comfyui_embedded_docs/docs/APG/en.md b/comfyui_embedded_docs/docs/APG/en.md index c482050b3..fce08815c 100644 --- a/comfyui_embedded_docs/docs/APG/en.md +++ b/comfyui_embedded_docs/docs/APG/en.md @@ -11,6 +11,8 @@ The APG (Adaptive Projected Guidance) node modifies the sampling process by adju | `norm_threshold` | Normalize guidance vector to this value, normalization disabled at a setting of 0 (default: 5.0). | FLOAT | Yes | 0.0 to 50.0 | | `momentum` | Controls a running average of guidance during diffusion, disabled at a setting of 0 (default: 0.0). | FLOAT | Yes | -5.0 to 1.0 | +Note: When the noise level (`sigma`) increases during sampling, the momentum running average resets to zero. If the model provides only a single conditioning output (no separate unconditional conditioning), the guidance adjustment is skipped and the conditioning is left unchanged. + ## Outputs | Output Name | Description | Data Type | @@ -20,4 +22,4 @@ The APG (Adaptive Projected Guidance) node modifies the sampling process by adju > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/APG/en.md) --- -**Source fingerprint (SHA-256):** `89e2486bf08f750f82608db93c389f0b25ce0be766f62faa8704d19bd7e41654` +**Source fingerprint (SHA-256):** `df0c76aee28479d49c4e471e54d1d32082adc6921a6a50b506675144a79e018a` diff --git a/comfyui_embedded_docs/docs/ARVideoI2V/en.md b/comfyui_embedded_docs/docs/ARVideoI2V/en.md index 580e8eff1..c40c07a9e 100644 --- a/comfyui_embedded_docs/docs/ARVideoI2V/en.md +++ b/comfyui_embedded_docs/docs/ARVideoI2V/en.md @@ -2,7 +2,7 @@ ## Overview -This node prepares an image-to-video generation setup for AR (Auto-Regressive) video models. It takes a starting image, encodes it into the latent space using a VAE, and stores the encoded image in the model's configuration. This allows the video sampling process to use the image as the first frame, effectively seeding the generation without needing a separate image-to-video model architecture. +This node prepares an image-to-video generation setup for AR (Auto-Regressive) video models that use Causal Forcing or Self-Forcing. It encodes a starting image into latent space with a VAE and stores it in the model's transformer options, so the video sampling process can seed the KV cache before denoising. It uses the same text-to-video model checkpoint, so no separate image-to-video architecture is needed. ## Inputs @@ -10,20 +10,22 @@ This node prepares an image-to-video generation setup for AR (Auto-Regressive) v | --- | --- | --- | --- | --- | | `model` | The AR video model to be used for generation. | MODEL | Yes | - | | `vae` | The VAE model used to encode the starting image into latent space. | VAE | Yes | - | -| `start_image` | The initial image that will serve as the first frame of the generated video. | IMAGE | Yes | - | +| `start_image` | The initial image that will serve as the first frame of the generated video. Only the first image in the input batch is used, and only its RGB channels are encoded. | IMAGE | Yes | - | | `width` | The width of the generated video frames (default: 832). | INT | Yes | 16 to 8192 (step: 16) | | `height` | The height of the generated video frames (default: 480). | INT | Yes | 16 to 8192 (step: 16) | | `length` | The total number of frames in the generated video (default: 81). | INT | Yes | 1 to 1024 (step: 4) | | `batch_size` | The number of video sequences to generate in a single batch (default: 1). | INT | Yes | 1 to 64 | +Note: The start image is resized to the specified `width` and `height` before being encoded. The latent temporal dimension is calculated as `((length - 1) // 4) + 1`, and the latent spatial dimensions are `height / 8` and `width / 8`. + ## Outputs | Output Name | Description | Data Type | | --- | --- | --- | -| `MODEL` | The cloned model with the encoded start image stored in its configuration for video generation. | MODEL | -| `LATENT` | An empty latent tensor with the correct dimensions for the video generation process. | LATENT | +| `MODEL` | The cloned model with the encoded start image stored in its transformer options (`ar_config.initial_latent`), which the sampler uses to seed the KV cache before denoising. | MODEL | +| `LATENT` | A zero-filled latent tensor with shape `[batch_size, 16, lat_t, height // 8, width // 8]`, where `lat_t = ((length - 1) // 4) + 1`. | LATENT | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ARVideoI2V/en.md) --- -**Source fingerprint (SHA-256):** `0445b279ba49fa946050cfa70d1e6b13240eaa600b99dfe63f27c3203dc4b61b` +**Source fingerprint (SHA-256):** `984834951b9d5a22aef51c85a5019fd8ba58cdb2d6fff235371ed29f316896d8` diff --git a/comfyui_embedded_docs/docs/AddLayer/ar.md b/comfyui_embedded_docs/docs/AddLayer/ar.md index 60e2c26d7..e6d0a7428 100644 --- a/comfyui_embedded_docs/docs/AddLayer/ar.md +++ b/comfyui_embedded_docs/docs/AddLayer/ar.md @@ -6,20 +6,20 @@ | المعامل | الوصف | نوع البيانات | مطلوب | النطاق | |-----------|-------------|-----------|----------|-------| -| `layers` | مكدس الطبقات المطلوب الإلحاق به. اتركه غير موصول لبدء مكدس جديد. | LAYERS | لا | — | -| `image` | محتوى الطبقة بحجمه الأصلي. الدفعة تتوسع إلى طبقات متتالية. | IMAGE | نعم | — | -| `mask` | قناع الشفافية لهذه الطبقة. المناطق المُقنَّعة (القيمة 1) تصبح شفافة، وتُضرب مع أي قناة ألفا تحملها الصورة بالفعل. | MASK | لا | — | -| `name` | اسم الطبقة المعروض في محرر التركيب. (الافتراضي: "") | STRING | لا | — | -| `x` | الموضع الأفقي الأولي على لوحة الرسم. (الافتراضي: 0) | INT | لا | من -MAX_RESOLUTION إلى MAX_RESOLUTION | -| `y` | الموضع الرأسي الأولي على لوحة الرسم. (الافتراضي: 0) | INT | لا | من -MAX_RESOLUTION إلى MAX_RESOLUTION | -| `opacity` | الشفافية الأولية للطبقة. (الافتراضي: 1.0) | FLOAT | لا | من 0.0 إلى 1.0 (الخطوة: 0.01) | -| `blend_mode` | وضع المزج الأولي، ويُطبَّق على الطبقات السفلية. على الطبقة السفلية فوق الخلفية الشفافة الافتراضية، تُنتج الأوضاع غير الوضع العادي شفافية. (الافتراضي: "normal") | COMBO | لا | خيارات متعددة متاحة | -| `rotation` | الدوران الأولي بالدرجات، في اتجاه عقارب الساعة. (الافتراضي: 0.0) | FLOAT | لا | من -360.0 إلى 360.0 (الخطوة: 1.0) | -| `width` | العرض الأولي للطبقة. القيمة 0 تُبقي العرض الأصلي للصورة. (الافتراضي: 0) | INT | لا | من 0 إلى MAX_RESOLUTION | -| `height` | الارتفاع الأولي للطبقة. القيمة 0 تُبقي الارتفاع الأصلي للصورة. (الافتراضي: 0) | INT | لا | من 0 إلى MAX_RESOLUTION | -| `z_index` | تجاوز ترتيب التراص. تُفرز الطبقات فرزًا مستقرًا حسب z_index؛ والقيم المتساوية تحتفظ بترتيبها في القائمة. (الافتراضي: 0) | INT | لا | من -1000 إلى 1000 | -| `flip_h` | قلب الطبقة أفقيًا. (الافتراضي: False) | BOOLEAN | لا | false / true | -| `flip_v` | قلب الطبقة رأسيًا. (الافتراضي: False) | BOOLEAN | لا | false / true | +| `طبقات` | مكدس الطبقات المطلوب الإلحاق به. اتركه غير موصول لبدء مكدس جديد. | LAYERS | لا | — | +| `صورة` | محتوى الطبقة بحجمه الأصلي. الدفعة تتوسع إلى طبقات متتالية. | IMAGE | نعم | — | +| `قناع` | قناع الشفافية لهذه الطبقة. المناطق المُقنَّعة (القيمة 1) تصبح شفافة، وتُضرب مع أي قناة ألفا تحملها الصورة بالفعل. | MASK | لا | — | +| `الاسم` | اسم الطبقة المعروض في محرر التركيب. (الافتراضي: "") | STRING | لا | — | +| `س` | الموضع الأفقي الأولي على لوحة الرسم. (الافتراضي: 0) | INT | لا | من -MAX_RESOLUTION إلى MAX_RESOLUTION | +| `ص` | الموضع الرأسي الأولي على لوحة الرسم. (الافتراضي: 0) | INT | لا | من -MAX_RESOLUTION إلى MAX_RESOLUTION | +| `الشفافية` | الشفافية الأولية للطبقة. (الافتراضي: 1.0) | FLOAT | لا | من 0.0 إلى 1.0 (الخطوة: 0.01) | +| `وضع الدمج` | وضع المزج الأولي، ويُطبَّق على الطبقات السفلية. على الطبقة السفلية فوق الخلفية الشفافة الافتراضية، تُنتج الأوضاع غير الوضع العادي شفافية. (الافتراضي: "normal") | COMBO | لا | خيارات متعددة متاحة | +| `الدوران` | الدوران الأولي بالدرجات، في اتجاه عقارب الساعة. (الافتراضي: 0.0) | FLOAT | لا | من -360.0 إلى 360.0 (الخطوة: 1.0) | +| `العرض` | العرض الأولي للطبقة. القيمة 0 تُبقي العرض الأصلي للصورة. (الافتراضي: 0) | INT | لا | من 0 إلى MAX_RESOLUTION | +| `الارتفاع` | الارتفاع الأولي للطبقة. القيمة 0 تُبقي الارتفاع الأصلي للصورة. (الافتراضي: 0) | INT | لا | من 0 إلى MAX_RESOLUTION | +| `مؤشر التكديس` | تجاوز ترتيب التراص. تُفرز الطبقات فرزًا مستقرًا حسب z_index؛ والقيم المتساوية تحتفظ بترتيبها في القائمة. (الافتراضي: 0) | INT | لا | من -1000 إلى 1000 | +| `عكس أفقي` | قلب الطبقة أفقيًا. (الافتراضي: False) | BOOLEAN | لا | false / true | +| `عكس رأسي` | قلب الطبقة رأسيًا. (الافتراضي: False) | BOOLEAN | لا | false / true | ملاحظات: - فقط `image` مطلوب؛ جميع المدخلات الأخرى اختيارية. diff --git a/comfyui_embedded_docs/docs/AddLayer/es.md b/comfyui_embedded_docs/docs/AddLayer/es.md index 9c0d0107c..b52fbf3b9 100644 --- a/comfyui_embedded_docs/docs/AddLayer/es.md +++ b/comfyui_embedded_docs/docs/AddLayer/es.md @@ -6,20 +6,20 @@ El nodo Add Layer convierte una imagen de entrada en una capa y la coloca en un | Parámetro | Descripción | Tipo de dato | Requerido | Rango | |-----------|-------------|--------------|-----------|-------| -| `layers` | Pila de capas a la que se añadirá. Si se deja sin conectar, se inicia una nueva pila. | LAYERS | No | — | -| `image` | Contenido de la capa en su tamaño nativo. Un lote se expande a capas consecutivas. | IMAGE | Sí | — | -| `mask` | Máscara de transparencia para esta capa. Las áreas enmascaradas (valor 1) se vuelven transparentes, multiplicándose con cualquier canal alfa que la imagen ya contenga. | MASK | No | — | -| `name` | Nombre de la capa mostrado en el editor del compositor. (predeterminado: "") | STRING | No | — | +| `capas` | Pila de capas a la que se añadirá. Si se deja sin conectar, se inicia una nueva pila. | LAYERS | No | — | +| `imagen` | Contenido de la capa en su tamaño nativo. Un lote se expande a capas consecutivas. | IMAGE | Sí | — | +| `máscara` | Máscara de transparencia para esta capa. Las áreas enmascaradas (valor 1) se vuelven transparentes, multiplicándose con cualquier canal alfa que la imagen ya contenga. | MASK | No | — | +| `nombre` | Nombre de la capa mostrado en el editor del compositor. (predeterminado: "") | STRING | No | — | | `x` | Posición horizontal inicial en el lienzo. (predeterminado: 0) | INT | No | -MAX_RESOLUTION a MAX_RESOLUTION | | `y` | Posición vertical inicial en el lienzo. (predeterminado: 0) | INT | No | -MAX_RESOLUTION a MAX_RESOLUTION | -| `opacity` | Opacidad inicial de la capa. (predeterminado: 1.0) | FLOAT | No | 0.0 a 1.0 (paso 0.01) | -| `blend_mode` | Modo de fusión inicial, aplicado contra las capas inferiores. En la capa inferior sobre el fondo transparente predeterminado, los modos no normales producen transparencia. (predeterminado: "normal") | COMBO | No | Múltiples opciones disponibles | -| `rotation` | Rotación inicial en grados, en sentido horario. (predeterminado: 0.0) | FLOAT | No | -360.0 a 360.0 (paso 1.0) | -| `width` | Ancho de visualización inicial. 0 conserva el ancho nativo de la imagen. (predeterminado: 0) | INT | No | 0 a MAX_RESOLUTION | -| `height` | Altura de visualización inicial. 0 conserva la altura nativa de la imagen. (predeterminado: 0) | INT | No | 0 a MAX_RESOLUTION | -| `z_index` | Anulación del orden de apilamiento. Las capas se ordenan de forma estable por z_index; los valores iguales mantienen su orden en la lista. (predeterminado: 0) | INT | No | -1000 a 1000 | -| `flip_h` | Voltear la capa horizontalmente. (predeterminado: False) | BOOLEAN | No | false / true | -| `flip_v` | Voltear la capa verticalmente. (predeterminado: False) | BOOLEAN | No | false / true | +| `opacidad` | Opacidad inicial de la capa. (predeterminado: 1.0) | FLOAT | No | 0.0 a 1.0 (paso 0.01) | +| `modo de fusión` | Modo de fusión inicial, aplicado contra las capas inferiores. En la capa inferior sobre el fondo transparente predeterminado, los modos no normales producen transparencia. (predeterminado: "normal") | COMBO | No | Múltiples opciones disponibles | +| `rotación` | Rotación inicial en grados, en sentido horario. (predeterminado: 0.0) | FLOAT | No | -360.0 a 360.0 (paso 1.0) | +| `ancho` | Ancho de visualización inicial. 0 conserva el ancho nativo de la imagen. (predeterminado: 0) | INT | No | 0 a MAX_RESOLUTION | +| `alto` | Altura de visualización inicial. 0 conserva la altura nativa de la imagen. (predeterminado: 0) | INT | No | 0 a MAX_RESOLUTION | +| `índice z` | Anulación del orden de apilamiento. Las capas se ordenan de forma estable por z_index; los valores iguales mantienen su orden en la lista. (predeterminado: 0) | INT | No | -1000 a 1000 | +| `voltear_h` | Voltear la capa horizontalmente. (predeterminado: False) | BOOLEAN | No | false / true | +| `voltear_v` | Voltear la capa verticalmente. (predeterminado: False) | BOOLEAN | No | false / true | Notas: - Solo se requiere `image`; todos los demás parámetros son opcionales. diff --git a/comfyui_embedded_docs/docs/AddLayer/fa.md b/comfyui_embedded_docs/docs/AddLayer/fa.md index 7455416cd..ce3106d36 100644 --- a/comfyui_embedded_docs/docs/AddLayer/fa.md +++ b/comfyui_embedded_docs/docs/AddLayer/fa.md @@ -6,20 +6,20 @@ | پارامتر | توضیحات | نوع داده | الزامی | محدوده | |-----------|-------------|-----------|----------|-------| -| `layers` | پشته لایه‌ای که باید به آن اضافه شود. برای شروع یک پشته جدید، اتصال را خالی بگذارید. | LAYERS | خیر | — | -| `image` | محتوای لایه در اندازه اصلی خود. یک دسته (batch) به لایه‌های متوالی گسترش می‌یابد. | IMAGE | بله | — | -| `mask` | ماسک شفافیت برای این لایه. نواحی ماسک‌شده (مقدار ۱) شفاف می‌شوند و با هر کانال آلفایی که تصویر از قبل دارد ترکیب (ضرب) می‌شوند. | MASK | خیر | — | -| `name` | نام لایه که در ویرایشگر کامپوزیت نمایش داده می‌شود. (پیش‌فرض: "") | STRING | خیر | — | +| `لایه‌ها` | پشته لایه‌ای که باید به آن اضافه شود. برای شروع یک پشته جدید، اتصال را خالی بگذارید. | LAYERS | خیر | — | +| `تصویر` | محتوای لایه در اندازه اصلی خود. یک دسته (batch) به لایه‌های متوالی گسترش می‌یابد. | IMAGE | بله | — | +| `ماسک` | ماسک شفافیت برای این لایه. نواحی ماسک‌شده (مقدار ۱) شفاف می‌شوند و با هر کانال آلفایی که تصویر از قبل دارد ترکیب (ضرب) می‌شوند. | MASK | خیر | — | +| `نام` | نام لایه که در ویرایشگر کامپوزیت نمایش داده می‌شود. (پیش‌فرض: "") | STRING | خیر | — | | `x` | موقعیت افقی اولیه روی بوم. (پیش‌فرض: 0) | INT | خیر | -MAX_RESOLUTION تا MAX_RESOLUTION | | `y` | موقعیت عمودی اولیه روی بوم. (پیش‌فرض: 0) | INT | خیر | -MAX_RESOLUTION تا MAX_RESOLUTION | -| `opacity` | تیرگی اولیه لایه. (پیش‌فرض: 1.0) | FLOAT | خیر | 0.0 تا 1.0 (گام: 0.01) | -| `blend_mode` | حالت ترکیب اولیه که روی لایه‌های زیرین اعمال می‌شود. در لایه پایینی روی پس‌زمینه شفاف پیش‌فرض، حالت‌های غیر از normal باعث ایجاد شفافیت می‌شوند. (پیش‌فرض: "normal") | COMBO | خیر | چند گزینه موجود است | -| `rotation` | چرخش اولیه بر حسب درجه، در جهت عقربه‌های ساعت. (پیش‌فرض: 0.0) | FLOAT | خیر | -360.0 تا 360.0 (گام: 1.0) | -| `width` | عرض نمایش اولیه. ۰ عرض اصلی تصویر را حفظ می‌کند. (پیش‌فرض: 0) | INT | خیر | 0 تا MAX_RESOLUTION | -| `height` | ارتفاع نمایش اولیه. ۰ ارتفاع اصلی تصویر را حفظ می‌کند. (پیش‌فرض: 0) | INT | خیر | 0 تا MAX_RESOLUTION | +| `شفافیت` | تیرگی اولیه لایه. (پیش‌فرض: 1.0) | FLOAT | خیر | 0.0 تا 1.0 (گام: 0.01) | +| `حالت ترکیب` | حالت ترکیب اولیه که روی لایه‌های زیرین اعمال می‌شود. در لایه پایینی روی پس‌زمینه شفاف پیش‌فرض، حالت‌های غیر از normal باعث ایجاد شفافیت می‌شوند. (پیش‌فرض: "normal") | COMBO | خیر | چند گزینه موجود است | +| `چرخش` | چرخش اولیه بر حسب درجه، در جهت عقربه‌های ساعت. (پیش‌فرض: 0.0) | FLOAT | خیر | -360.0 تا 360.0 (گام: 1.0) | +| `عرض` | عرض نمایش اولیه. ۰ عرض اصلی تصویر را حفظ می‌کند. (پیش‌فرض: 0) | INT | خیر | 0 تا MAX_RESOLUTION | +| `ارتفاع` | ارتفاع نمایش اولیه. ۰ ارتفاع اصلی تصویر را حفظ می‌کند. (پیش‌فرض: 0) | INT | خیر | 0 تا MAX_RESOLUTION | | `z_index` | بازنویسی ترتیب قرارگیری. لایه‌ها به‌صورت پایدار بر اساس z_index مرتب می‌شوند؛ مقادیر برابر ترتیب فهرست را حفظ می‌کنند. (پیش‌فرض: 0) | INT | خیر | -1000 تا 1000 | -| `flip_h` | قرینه‌سازی افقی لایه. (پیش‌فرض: False) | BOOLEAN | خیر | false / true | -| `flip_v` | قرینه‌سازی عمودی لایه. (پیش‌فرض: False) | BOOLEAN | خیر | false / true | +| `وارونه افقی` | قرینه‌سازی افقی لایه. (پیش‌فرض: False) | BOOLEAN | خیر | false / true | +| `وارونه عمودی` | قرینه‌سازی عمودی لایه. (پیش‌فرض: False) | BOOLEAN | خیر | false / true | نکات: - فقط `image` الزامی است؛ سایر ورودی‌ها اختیاری هستند. diff --git a/comfyui_embedded_docs/docs/AddLayer/fr.md b/comfyui_embedded_docs/docs/AddLayer/fr.md index c361ef5ab..1f5376db2 100644 --- a/comfyui_embedded_docs/docs/AddLayer/fr.md +++ b/comfyui_embedded_docs/docs/AddLayer/fr.md @@ -6,20 +6,20 @@ Le nœud Add Layer convertit une image d’entrée en un calque et le place sur | Paramètre | Description | Type de données | Requis | Plage | |-----------|-------------|-----------------|--------|-------| -| `layers` | Pile de calques à laquelle ajouter le calque. Laisser non connecté pour démarrer une nouvelle pile. | LAYERS | Non | — | +| `calques` | Pile de calques à laquelle ajouter le calque. Laisser non connecté pour démarrer une nouvelle pile. | LAYERS | Non | — | | `image` | Contenu du calque à sa taille native. Un lot d’images se déploie en calques consécutifs. | IMAGE | Oui | — | -| `mask` | Masque de transparence pour ce calque. Les zones masquées (valeur 1) deviennent transparentes, en multipliant tout canal alpha que l’image contient déjà. | MASK | Non | — | -| `name` | Nom du calque affiché dans l’éditeur de composition. (défaut : "") | STRING | Non | — | +| `masque` | Masque de transparence pour ce calque. Les zones masquées (valeur 1) deviennent transparentes, en multipliant tout canal alpha que l’image contient déjà. | MASK | Non | — | +| `nom` | Nom du calque affiché dans l’éditeur de composition. (défaut : "") | STRING | Non | — | | `x` | Placement horizontal initial sur le canevas. (défaut : 0) | INT | Non | -MAX_RESOLUTION à MAX_RESOLUTION | | `y` | Placement vertical initial sur le canevas. (défaut : 0) | INT | Non | -MAX_RESOLUTION à MAX_RESOLUTION | -| `opacity` | Opacité initiale du calque. (défaut : 1.0) | FLOAT | Non | 0.0 à 1.0 (pas 0.01) | -| `blend_mode` | Mode de fusion initial, appliqué aux calques inférieurs. Sur le calque inférieur, au-dessus du fond transparent par défaut, les modes non normaux produisent de la transparence. (défaut : "normal") | COMBO | Non | Plusieurs options disponibles | +| `opacité` | Opacité initiale du calque. (défaut : 1.0) | FLOAT | Non | 0.0 à 1.0 (pas 0.01) | +| `mode de fusion` | Mode de fusion initial, appliqué aux calques inférieurs. Sur le calque inférieur, au-dessus du fond transparent par défaut, les modes non normaux produisent de la transparence. (défaut : "normal") | COMBO | Non | Plusieurs options disponibles | | `rotation` | Rotation initiale en degrés, dans le sens horaire. (défaut : 0.0) | FLOAT | Non | -360.0 à 360.0 (pas 1.0) | -| `width` | Largeur d’affichage initiale. 0 conserve la largeur native de l’image. (défaut : 0) | INT | Non | 0 à MAX_RESOLUTION | -| `height` | Hauteur d’affichage initiale. 0 conserve la hauteur native de l’image. (défaut : 0) | INT | Non | 0 à MAX_RESOLUTION | +| `largeur` | Largeur d’affichage initiale. 0 conserve la largeur native de l’image. (défaut : 0) | INT | Non | 0 à MAX_RESOLUTION | +| `hauteur` | Hauteur d’affichage initiale. 0 conserve la hauteur native de l’image. (défaut : 0) | INT | Non | 0 à MAX_RESOLUTION | | `z_index` | Surcharge d’empilement. Les calques sont triés de manière stable selon `z_index` ; les valeurs égales conservent leur ordre de liste. (défaut : 0) | INT | Non | -1000 à 1000 | -| `flip_h` | Retourne le calque horizontalement. (défaut : False) | BOOLEAN | Non | false / true | -| `flip_v` | Retourne le calque verticalement. (défaut : False) | BOOLEAN | Non | false / true | +| `retourner_h` | Retourne le calque horizontalement. (défaut : False) | BOOLEAN | Non | false / true | +| `retourner_v` | Retourne le calque verticalement. (défaut : False) | BOOLEAN | Non | false / true | Notes : diff --git a/comfyui_embedded_docs/docs/AddLayer/ja.md b/comfyui_embedded_docs/docs/AddLayer/ja.md index 731971134..b028d939e 100644 --- a/comfyui_embedded_docs/docs/AddLayer/ja.md +++ b/comfyui_embedded_docs/docs/AddLayer/ja.md @@ -6,20 +6,20 @@ Add Layer ノードは、入力画像をレイヤーに変換してキャンバ | パラメータ | 説明 | データ型 | 必須 | 範囲 | |-----------|-------------|-----------|----------|-------| -| `layers` | 追加先のレイヤースタック。未接続のままにすると新しいスタックが開始されます。 | LAYERS | いいえ | — | -| `image` | ネイティブサイズでのレイヤーコンテンツ。バッチは連続したレイヤーに展開されます。 | IMAGE | はい | — | -| `mask` | このレイヤーの透明マスク。マスクされた領域(値1)は透明になり、画像がすでに持つアルファチャンネルと乗算されます。 | MASK | いいえ | — | -| `name` | コンポジターエディターに表示されるレイヤー名。(デフォルト: "") | STRING | いいえ | — | -| `x` | キャンバス上の初期水平位置。(デフォルト: 0) | INT | いいえ | -MAX_RESOLUTION から MAX_RESOLUTION | -| `y` | キャンバス上の初期垂直位置。(デフォルト: 0) | INT | いいえ | -MAX_RESOLUTION から MAX_RESOLUTION | -| `opacity` | 初期レイヤー不透明度。(デフォルト: 1.0) | FLOAT | いいえ | 0.0 から 1.0(ステップ: 0.01) | -| `blend_mode` | 初期ブレンドモード。下のレイヤーに対して適用されます。最下レイヤーでデフォルトの透明背景に対しては、通常モード以外では透明が生成されます。(デフォルト: "normal") | COMBO | いいえ | 複数のオプションから選択可能 | -| `rotation` | 初期回転角度(度、時計回り)。(デフォルト: 0.0) | FLOAT | いいえ | -360.0 から 360.0(ステップ: 1.0) | -| `width` | 初期表示幅。0 の場合は画像のネイティブ幅が維持されます。(デフォルト: 0) | INT | いいえ | 0 から MAX_RESOLUTION | -| `height` | 初期表示高さ。0 の場合は画像のネイティブ高さが維持されます。(デフォルト: 0) | INT | いいえ | 0 から MAX_RESOLUTION | -| `z_index` | 重なり順の上書き。レイヤーは z_index で安定ソートされ、同じ値の場合はリスト順が保持されます。(デフォルト: 0) | INT | いいえ | -1000 から 1000 | -| `flip_h` | レイヤーを水平方向に反転します。(デフォルト: False) | BOOLEAN | いいえ | false / true | -| `flip_v` | レイヤーを垂直方向に反転します。(デフォルト: False) | BOOLEAN | いいえ | false / true | +| `レイヤースタック` | 追加先のレイヤースタック。未接続のままにすると新しいスタックが開始されます。 | LAYERS | いいえ | — | +| `画像` | ネイティブサイズでのレイヤーコンテンツ。バッチは連続したレイヤーに展開されます。 | IMAGE | はい | — | +| `マスク` | このレイヤーの透明マスク。マスクされた領域(値1)は透明になり、画像がすでに持つアルファチャンネルと乗算されます。 | MASK | いいえ | — | +| `名前` | コンポジターエディターに表示されるレイヤー名。(デフォルト: "") | STRING | いいえ | — | +| `X座標` | キャンバス上の初期水平位置。(デフォルト: 0) | INT | いいえ | -MAX_RESOLUTION から MAX_RESOLUTION | +| `Y座標` | キャンバス上の初期垂直位置。(デフォルト: 0) | INT | いいえ | -MAX_RESOLUTION から MAX_RESOLUTION | +| `不透明度` | 初期レイヤー不透明度。(デフォルト: 1.0) | FLOAT | いいえ | 0.0 から 1.0(ステップ: 0.01) | +| `ブレンドモード` | 初期ブレンドモード。下のレイヤーに対して適用されます。最下レイヤーでデフォルトの透明背景に対しては、通常モード以外では透明が生成されます。(デフォルト: "normal") | COMBO | いいえ | 複数のオプションから選択可能 | +| `回転` | 初期回転角度(度、時計回り)。(デフォルト: 0.0) | FLOAT | いいえ | -360.0 から 360.0(ステップ: 1.0) | +| `幅` | 初期表示幅。0 の場合は画像のネイティブ幅が維持されます。(デフォルト: 0) | INT | いいえ | 0 から MAX_RESOLUTION | +| `高さ` | 初期表示高さ。0 の場合は画像のネイティブ高さが維持されます。(デフォルト: 0) | INT | いいえ | 0 から MAX_RESOLUTION | +| `Zインデックス` | 重なり順の上書き。レイヤーは z_index で安定ソートされ、同じ値の場合はリスト順が保持されます。(デフォルト: 0) | INT | いいえ | -1000 から 1000 | +| `水平反転` | レイヤーを水平方向に反転します。(デフォルト: False) | BOOLEAN | いいえ | false / true | +| `垂直反転` | レイヤーを垂直方向に反転します。(デフォルト: False) | BOOLEAN | いいえ | false / true | 注記: - 必須なのは `image` のみで、他の入力はすべてオプションです。 diff --git a/comfyui_embedded_docs/docs/AddLayer/pt-BR.md b/comfyui_embedded_docs/docs/AddLayer/pt-BR.md index 1a63d94e7..c702e4fe5 100644 --- a/comfyui_embedded_docs/docs/AddLayer/pt-BR.md +++ b/comfyui_embedded_docs/docs/AddLayer/pt-BR.md @@ -6,20 +6,20 @@ O nó Add Layer transforma uma imagem de entrada em uma camada e a coloca em uma | Parâmetro | Descrição | Tipo de Dados | Obrigatório | Faixa | |-----------|-------------|-----------|----------|-------| -| `layers` | Pilha de camadas à qual anexar. Deixe desconectado para iniciar uma nova pilha. | LAYERS | Não | — | -| `image` | Conteúdo da camada em seu tamanho nativo. Um lote se expande em camadas consecutivas. | IMAGE | Sim | — | -| `mask` | Máscara de transparência para esta camada. Áreas mascaradas (valor 1) tornam-se transparentes, multiplicando-se com qualquer canal alfa que a imagem já possua. | MASK | Não | — | -| `name` | Nome da camada exibido no editor do compositor. (padrão: "") | STRING | Não | — | +| `camadas` | Pilha de camadas à qual anexar. Deixe desconectado para iniciar uma nova pilha. | LAYERS | Não | — | +| `imagem` | Conteúdo da camada em seu tamanho nativo. Um lote se expande em camadas consecutivas. | IMAGE | Sim | — | +| `máscara` | Máscara de transparência para esta camada. Áreas mascaradas (valor 1) tornam-se transparentes, multiplicando-se com qualquer canal alfa que a imagem já possua. | MASK | Não | — | +| `nome` | Nome da camada exibido no editor do compositor. (padrão: "") | STRING | Não | — | | `x` | Posicionamento horizontal inicial na tela. (padrão: 0) | INT | Não | -MAX_RESOLUTION a MAX_RESOLUTION | | `y` | Posicionamento vertical inicial na tela. (padrão: 0) | INT | Não | -MAX_RESOLUTION a MAX_RESOLUTION | -| `opacity` | Opacidade inicial da camada. (padrão: 1.0) | FLOAT | Não | 0.0 a 1.0 (passo: 0.01) | -| `blend_mode` | Modo de mesclagem inicial, aplicado às camadas abaixo. Na camada inferior sobre o fundo transparente padrão, modos não normais produzem transparência. (padrão: "normal") | COMBO | Não | Múltiplas opções disponíveis | -| `rotation` | Rotação inicial em graus, no sentido horário. (padrão: 0.0) | FLOAT | Não | -360.0 a 360.0 (passo: 1.0) | -| `width` | Largura de exibição inicial. 0 mantém a largura nativa da imagem. (padrão: 0) | INT | Não | 0 a MAX_RESOLUTION | -| `height` | Altura de exibição inicial. 0 mantém a altura nativa da imagem. (padrão: 0) | INT | Não | 0 a MAX_RESOLUTION | +| `opacidade` | Opacidade inicial da camada. (padrão: 1.0) | FLOAT | Não | 0.0 a 1.0 (passo: 0.01) | +| `modo_de_mesclagem` | Modo de mesclagem inicial, aplicado às camadas abaixo. Na camada inferior sobre o fundo transparente padrão, modos não normais produzem transparência. (padrão: "normal") | COMBO | Não | Múltiplas opções disponíveis | +| `rotação` | Rotação inicial em graus, no sentido horário. (padrão: 0.0) | FLOAT | Não | -360.0 a 360.0 (passo: 1.0) | +| `largura` | Largura de exibição inicial. 0 mantém a largura nativa da imagem. (padrão: 0) | INT | Não | 0 a MAX_RESOLUTION | +| `altura` | Altura de exibição inicial. 0 mantém a altura nativa da imagem. (padrão: 0) | INT | Não | 0 a MAX_RESOLUTION | | `z_index` | Substituição de empilhamento. As camadas são ordenadas de forma estável por z_index; valores iguais mantêm sua ordem na lista. (padrão: 0) | INT | Não | -1000 a 1000 | -| `flip_h` | Inverter a camada horizontalmente. (padrão: False) | BOOLEAN | Não | false / true | -| `flip_v` | Inverter a camada verticalmente. (padrão: False) | BOOLEAN | Não | false / true | +| `inverter_h` | Inverter a camada horizontalmente. (padrão: False) | BOOLEAN | Não | false / true | +| `inverter_v` | Inverter a camada verticalmente. (padrão: False) | BOOLEAN | Não | false / true | Notas: - Apenas `image` é obrigatório; todos os outros parâmetros são opcionais. diff --git a/comfyui_embedded_docs/docs/AddLayer/ru.md b/comfyui_embedded_docs/docs/AddLayer/ru.md index 3c1b47331..a7a14eb15 100644 --- a/comfyui_embedded_docs/docs/AddLayer/ru.md +++ b/comfyui_embedded_docs/docs/AddLayer/ru.md @@ -6,20 +6,20 @@ | Параметр | Описание | Тип данных | Обязательность | Диапазон | |-----------|-------------|-----------|----------|-------| -| `layers` | Стек слоёв, к которому нужно добавить слой. Оставьте неподключённым, чтобы создать новый стек. | LAYERS | Нет | — | -| `image` | Содержимое слоя в его исходном размере. Пакет изображений расширяется в последовательные слои. | IMAGE | Да | — | -| `mask` | Маска прозрачности для этого слоя. Области маски (значение 1) становятся прозрачными, перемножаясь с альфа-каналом, который уже есть у изображения. | MASK | Нет | — | -| `name` | Имя слоя, отображаемое в редакторе композитора. (по умолчанию: "") | STRING | Нет | — | +| `слои` | Стек слоёв, к которому нужно добавить слой. Оставьте неподключённым, чтобы создать новый стек. | LAYERS | Нет | — | +| `изображение` | Содержимое слоя в его исходном размере. Пакет изображений расширяется в последовательные слои. | IMAGE | Да | — | +| `маска` | Маска прозрачности для этого слоя. Области маски (значение 1) становятся прозрачными, перемножаясь с альфа-каналом, который уже есть у изображения. | MASK | Нет | — | +| `имя` | Имя слоя, отображаемое в редакторе композитора. (по умолчанию: "") | STRING | Нет | — | | `x` | Начальное горизонтальное размещение на холсте. (по умолчанию: 0) | INT | Нет | -MAX_RESOLUTION до MAX_RESOLUTION | | `y` | Начальное вертикальное размещение на холсте. (по умолчанию: 0) | INT | Нет | -MAX_RESOLUTION до MAX_RESOLUTION | -| `opacity` | Начальная непрозрачность слоя. (по умолчанию: 1.0) | FLOAT | Нет | 0.0 до 1.0 (шаг 0.01) | -| `blend_mode` | Начальный режим наложения, применяемый к слоям ниже. На нижнем слое поверх прозрачного фона по умолчанию режимы, отличные от normal, создают прозрачность. (по умолчанию: "normal") | COMBO | Нет | Доступно несколько вариантов | -| `rotation` | Начальный поворот в градусах, по часовой стрелке. (по умолчанию: 0.0) | FLOAT | Нет | -360.0 до 360.0 (шаг 1.0) | -| `width` | Начальная ширина отображения. 0 сохраняет исходную ширину изображения. (по умолчанию: 0) | INT | Нет | 0 до MAX_RESOLUTION | -| `height` | Начальная высота отображения. 0 сохраняет исходную высоту изображения. (по умолчанию: 0) | INT | Нет | 0 до MAX_RESOLUTION | -| `z_index` | Переопределение порядка в стеке. Слои стабильно сортируются по z_index; при равных значениях сохраняется их порядок в списке. (по умолчанию: 0) | INT | Нет | -1000 до 1000 | -| `flip_h` | Отразить слой по горизонтали. (по умолчанию: False) | BOOLEAN | Нет | false / true | -| `flip_v` | Отразить слой по вертикали. (по умолчанию: False) | BOOLEAN | Нет | false / true | +| `непрозрачность` | Начальная непрозрачность слоя. (по умолчанию: 1.0) | FLOAT | Нет | 0.0 до 1.0 (шаг 0.01) | +| `режим смешивания` | Начальный режим наложения, применяемый к слоям ниже. На нижнем слое поверх прозрачного фона по умолчанию режимы, отличные от normal, создают прозрачность. (по умолчанию: "normal") | COMBO | Нет | Доступно несколько вариантов | +| `вращение` | Начальный поворот в градусах, по часовой стрелке. (по умолчанию: 0.0) | FLOAT | Нет | -360.0 до 360.0 (шаг 1.0) | +| `ширина` | Начальная ширина отображения. 0 сохраняет исходную ширину изображения. (по умолчанию: 0) | INT | Нет | 0 до MAX_RESOLUTION | +| `высота` | Начальная высота отображения. 0 сохраняет исходную высоту изображения. (по умолчанию: 0) | INT | Нет | 0 до MAX_RESOLUTION | +| `z-индекс` | Переопределение порядка в стеке. Слои стабильно сортируются по z_index; при равных значениях сохраняется их порядок в списке. (по умолчанию: 0) | INT | Нет | -1000 до 1000 | +| `отразить по горизонтали` | Отразить слой по горизонтали. (по умолчанию: False) | BOOLEAN | Нет | false / true | +| `отразить по вертикали` | Отразить слой по вертикали. (по умолчанию: False) | BOOLEAN | Нет | false / true | Примечания: - Только `image` является обязательным; все остальные входы необязательны. diff --git a/comfyui_embedded_docs/docs/AddLayer/tr.md b/comfyui_embedded_docs/docs/AddLayer/tr.md index fdc2ff457..1778881c2 100644 --- a/comfyui_embedded_docs/docs/AddLayer/tr.md +++ b/comfyui_embedded_docs/docs/AddLayer/tr.md @@ -6,20 +6,20 @@ Add Layer düğümü, bir girdi görüntüsünü katmana dönüştürür ve onu | Parametre | Açıklama | Veri Türü | Gerekli | Aralık | |-----------|-------------|-----------|----------|-------| -| `layers` | Eklenecek katman yığını. Yeni bir yığın başlatmak için bağlantısız bırakın. | LAYERS | Hayır | — | -| `image` | Katman içeriği, doğal boyutunda. Bir grup, ardışık katmanlara genişler. | IMAGE | Evet | — | -| `mask` | Bu katman için saydamlık maskesi. Maskeli alanlar (değer 1) saydam hale gelir ve görüntünün zaten sahip olduğu alfa kanalıyla çarpılır. | MASK | Hayır | — | -| `name` | Birleştirici düzenleyicide gösterilen katman adı. (varsayılan: "") | STRING | Hayır | — | +| `katmanlar` | Eklenecek katman yığını. Yeni bir yığın başlatmak için bağlantısız bırakın. | LAYERS | Hayır | — | +| `görüntü` | Katman içeriği, doğal boyutunda. Bir grup, ardışık katmanlara genişler. | IMAGE | Evet | — | +| `maske` | Bu katman için saydamlık maskesi. Maskeli alanlar (değer 1) saydam hale gelir ve görüntünün zaten sahip olduğu alfa kanalıyla çarpılır. | MASK | Hayır | — | +| `isim` | Birleştirici düzenleyicide gösterilen katman adı. (varsayılan: "") | STRING | Hayır | — | | `x` | Tuval üzerindeki başlangıç yatay konumu. (varsayılan: 0) | INT | Hayır | -MAX_RESOLUTION ile MAX_RESOLUTION | | `y` | Tuval üzerindeki başlangıç dikey konumu. (varsayılan: 0) | INT | Hayır | -MAX_RESOLUTION ile MAX_RESOLUTION | -| `opacity` | Başlangıç katman opaklığı. (varsayılan: 1.0) | FLOAT | Hayır | 0.0 ile 1.0 (adım: 0.01) | -| `blend_mode` | Alttaki katmanlara uygulanan başlangıç karışım modu. Varsayılan saydam arka plan üzerindeki en alt katmanda, normal olmayan modlar saydamlık üretir. (varsayılan: "normal") | COMBO | Hayır | Birden fazla seçenek mevcut | -| `rotation` | Derece cinsinden başlangıç dönüşü, saat yönünde. (varsayılan: 0.0) | FLOAT | Hayır | -360.0 ile 360.0 (adım: 1.0) | -| `width` | Başlangıç görüntüleme genişliği. 0, görüntünün doğal genişliğini korur. (varsayılan: 0) | INT | Hayır | 0 ile MAX_RESOLUTION | -| `height` | Başlangıç görüntüleme yüksekliği. 0, görüntünün doğal yüksekliğini korur. (varsayılan: 0) | INT | Hayır | 0 ile MAX_RESOLUTION | -| `z_index` | İstifleme geçersiz kılma. Katmanlar z_index'e göre kararlı şekilde sıralanır; eşit değerler liste sıralarını korur. (varsayılan: 0) | INT | Hayır | -1000 ile 1000 | -| `flip_h` | Katmanı yatay olarak çevir. (varsayılan: False) | BOOLEAN | Hayır | false / true | -| `flip_v` | Katmanı dikey olarak çevir. (varsayılan: False) | BOOLEAN | Hayır | false / true | +| `opaklık` | Başlangıç katman opaklığı. (varsayılan: 1.0) | FLOAT | Hayır | 0.0 ile 1.0 (adım: 0.01) | +| `karışım_modu` | Alttaki katmanlara uygulanan başlangıç karışım modu. Varsayılan saydam arka plan üzerindeki en alt katmanda, normal olmayan modlar saydamlık üretir. (varsayılan: "normal") | COMBO | Hayır | Birden fazla seçenek mevcut | +| `dönüş` | Derece cinsinden başlangıç dönüşü, saat yönünde. (varsayılan: 0.0) | FLOAT | Hayır | -360.0 ile 360.0 (adım: 1.0) | +| `genişlik` | Başlangıç görüntüleme genişliği. 0, görüntünün doğal genişliğini korur. (varsayılan: 0) | INT | Hayır | 0 ile MAX_RESOLUTION | +| `yükseklik` | Başlangıç görüntüleme yüksekliği. 0, görüntünün doğal yüksekliğini korur. (varsayılan: 0) | INT | Hayır | 0 ile MAX_RESOLUTION | +| `z_indeksi` | İstifleme geçersiz kılma. Katmanlar z_index'e göre kararlı şekilde sıralanır; eşit değerler liste sıralarını korur. (varsayılan: 0) | INT | Hayır | -1000 ile 1000 | +| `yatay_çevir` | Katmanı yatay olarak çevir. (varsayılan: False) | BOOLEAN | Hayır | false / true | +| `dikey_çevir` | Katmanı dikey olarak çevir. (varsayılan: False) | BOOLEAN | Hayır | false / true | Notlar: - Yalnızca `image` gereklidir; diğer tüm girdiler isteğe bağlıdır. diff --git a/comfyui_embedded_docs/docs/AddLayer/zh.md b/comfyui_embedded_docs/docs/AddLayer/zh.md index 8da10c555..b4fc14222 100644 --- a/comfyui_embedded_docs/docs/AddLayer/zh.md +++ b/comfyui_embedded_docs/docs/AddLayer/zh.md @@ -5,20 +5,20 @@ The Add Layer 节点将输入图像转换为图层并将其放置在画布上, ## 输入 | 参数 | 描述 | 数据类型 | 必填 | 范围 | |-----------|-------------|-----------|----------|-------| -| `layers` | 要追加到的图层堆栈。保持未连接以开始新的堆栈。 | LAYERS | 否 | — | -| `image` | 以其原始尺寸显示的图层内容。批次会展开为连续的图层。 | IMAGE | 是 | — | -| `mask` | 此图层的透明度遮罩。遮罩区域(值 1)变为透明,并与图像已携带的任何 Alpha 通道相乘。 | MASK | 否 | — | -| `name` | 合成器编辑器中显示的图层名称。(默认值:"") | STRING | 否 | — | -| `x` | 在画布上的初始水平位置。(默认值:0) | INT | 否 | -MAX_RESOLUTION 到 MAX_RESOLUTION | -| `y` | 在画布上的初始垂直位置。(默认值:0) | INT | 否 | -MAX_RESOLUTION 到 MAX_RESOLUTION | -| `opacity` | 初始图层不透明度。(默认值:1.0) | FLOAT | 否 | 0.0 到 1.0 (步长 0.01) | -| `blend_mode` | 初始混合模式,应用于下方的图层。在默认透明背景上的底层上,非 normal 模式会产生透明效果。(默认值:"normal") | COMBO | 否 | 多个选项可用 | -| `rotation` | 初始旋转角度,顺时针方向。(默认值:0.0) | FLOAT | 否 | -360.0 到 360.0 (步长 1.0) | -| `width` | 初始显示宽度。0 表示保持图像的原始宽度。(默认值:0) | INT | 否 | 0 到 MAX_RESOLUTION | -| `height` | 初始显示高度。0 表示保持图像的原始高度。(默认值:0) | INT | 否 | 0 到 MAX_RESOLUTION | -| `z_index` | 堆叠顺序覆盖。图层按 z_index 稳定排序;相同值保持列表顺序。(默认值:0) | INT | 否 | -1000 到 1000 | -| `flip_h` | 水平翻转图层。(默认值:False) | BOOLEAN | 否 | false / true | -| `flip_v` | 垂直翻转图层。(默认值:False) | BOOLEAN | 否 | false / true | +| `图层组` | 要追加到的图层堆栈。保持未连接以开始新的堆栈。 | LAYERS | 否 | — | +| `图像` | 以其原始尺寸显示的图层内容。批次会展开为连续的图层。 | IMAGE | 是 | — | +| `遮罩` | 此图层的透明度遮罩。遮罩区域(值 1)变为透明,并与图像已携带的任何 Alpha 通道相乘。 | MASK | 否 | — | +| `名称` | 合成器编辑器中显示的图层名称。(默认值:"") | STRING | 否 | — | +| `X` | 在画布上的初始水平位置。(默认值:0) | INT | 否 | -MAX_RESOLUTION 到 MAX_RESOLUTION | +| `Y` | 在画布上的初始垂直位置。(默认值:0) | INT | 否 | -MAX_RESOLUTION 到 MAX_RESOLUTION | +| `不透明度` | 初始图层不透明度。(默认值:1.0) | FLOAT | 否 | 0.0 到 1.0 (步长 0.01) | +| `混合模式` | 初始混合模式,应用于下方的图层。在默认透明背景上的底层上,非 normal 模式会产生透明效果。(默认值:"normal") | COMBO | 否 | 多个选项可用 | +| `旋转` | 初始旋转角度,顺时针方向。(默认值:0.0) | FLOAT | 否 | -360.0 到 360.0 (步长 1.0) | +| `宽度` | 初始显示宽度。0 表示保持图像的原始宽度。(默认值:0) | INT | 否 | 0 到 MAX_RESOLUTION | +| `高度` | 初始显示高度。0 表示保持图像的原始高度。(默认值:0) | INT | 否 | 0 到 MAX_RESOLUTION | +| `层级` | 堆叠顺序覆盖。图层按 z_index 稳定排序;相同值保持列表顺序。(默认值:0) | INT | 否 | -1000 到 1000 | +| `水平翻转` | 水平翻转图层。(默认值:False) | BOOLEAN | 否 | false / true | +| `垂直翻转` | 垂直翻转图层。(默认值:False) | BOOLEAN | 否 | false / true | 注意: - 仅 `image` 是必需的;所有其他输入均为可选。 diff --git a/comfyui_embedded_docs/docs/AddNoise/en.md b/comfyui_embedded_docs/docs/AddNoise/en.md index db3a12bad..2b0672a84 100644 --- a/comfyui_embedded_docs/docs/AddNoise/en.md +++ b/comfyui_embedded_docs/docs/AddNoise/en.md @@ -1,6 +1,6 @@ # AddNoise -This node adds controlled noise to a latent image using a specified noise generator and sigma values. It processes the input through the model's sampling system to apply noise scaling appropriate for the given sigma range, returning a new latent representation with the noise applied. +This node adds controlled noise to a latent image using a specified noise generator and sigma values. It processes the input through the model's sampling system to apply noise scaling appropriate for the given sigma range, returning a new latent representation with the noise applied. This node is currently marked as experimental. ## Inputs @@ -20,4 +20,4 @@ This node adds controlled noise to a latent image using a specified noise genera > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/AddNoise/en.md) --- -**Source fingerprint (SHA-256):** `7e2b3e7f55c7c4380e831be5a558c506a6328ad2ec974f550ed30b40ddfab037` +**Source fingerprint (SHA-256):** `6b11db10af9a2b8ea24dbf3b40c08d7e37de39df746e3966e5bfc94b84dee068` diff --git a/comfyui_embedded_docs/docs/AdjustBrightness/en.md b/comfyui_embedded_docs/docs/AdjustBrightness/en.md index 1c957468a..cd67ea96e 100644 --- a/comfyui_embedded_docs/docs/AdjustBrightness/en.md +++ b/comfyui_embedded_docs/docs/AdjustBrightness/en.md @@ -18,4 +18,4 @@ The Adjust Brightness node modifies the brightness of an input image. It works b > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/AdjustBrightness/en.md) --- -**Source fingerprint (SHA-256):** `dd1a35a4a133e6e15bb51788376e89c4e20e52ad395f889f4a4aa34fa614612e` +**Source fingerprint (SHA-256):** `696fb3c0bfc8edccc2049dad8f44b4b056fe1caa95b0cc0126164269cb65ab1a` diff --git a/comfyui_embedded_docs/docs/AdjustContrast/en.md b/comfyui_embedded_docs/docs/AdjustContrast/en.md index 87f6d9035..4b714efd4 100644 --- a/comfyui_embedded_docs/docs/AdjustContrast/en.md +++ b/comfyui_embedded_docs/docs/AdjustContrast/en.md @@ -13,9 +13,9 @@ The Adjust Contrast node modifies the contrast level of an input image. It works | Output Name | Description | Data Type | | --- | --- | --- | -| `image` | The resulting image with adjusted contrast. | IMAGE | +| `image` | The resulting image with adjusted contrast. Pixel values are clamped to the 0.0–1.0 range. | IMAGE | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/AdjustContrast/en.md) --- -**Source fingerprint (SHA-256):** `3debe91086d9818883dbe29b0cb2ae3ecaed44e4636b124d42a85d9906252330` +**Source fingerprint (SHA-256):** `1f5fbd0f0b739492bc171d3c43ea2150a3ca76dc3ede9bf63cb97c45a90b9e44` diff --git a/comfyui_embedded_docs/docs/AlignYourStepsScheduler/en.md b/comfyui_embedded_docs/docs/AlignYourStepsScheduler/en.md index 0f98e19b7..53c68c987 100644 --- a/comfyui_embedded_docs/docs/AlignYourStepsScheduler/en.md +++ b/comfyui_embedded_docs/docs/AlignYourStepsScheduler/en.md @@ -1,15 +1,17 @@ # AlignYourStepsScheduler -The AlignYourStepsScheduler node generates sigma values for the denoising process based on different model types. It calculates appropriate noise levels for each step of the sampling process and adjusts the total number of steps according to the denoise parameter. This helps align the sampling steps with the specific requirements of different diffusion models. +The AlignYourStepsScheduler node generates sigma values for the denoising process based on different model types. It calculates appropriate noise levels for each step of the sampling process and adjusts the total number of steps according to the `denoise` parameter. This helps align the sampling steps with the specific requirements of different diffusion models. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `model_type` | Specifies the type of model to use for sigma calculation (default: "SD1") | STRING | Yes | `"SD1"`
`"SDXL"`
`"SVD"` | +| `model_type` | Specifies the type of model to use for sigma calculation (default: "SD1") | COMBO | Yes | `"SD1"`
`"SDXL"`
`"SVD"` | | `steps` | The total number of sampling steps to generate (default: 10) | INT | Yes | 1 to 10000 | | `denoise` | Controls how much to denoise the image, where 1.0 uses all steps and lower values use fewer steps (default: 1.0) | FLOAT | Yes | 0.0 to 1.0 | +Note: Each model type has a built-in noise level schedule containing 11 sigma values (for 10 steps). When `denoise` is 0.0, the node returns an empty sigma tensor. When `denoise` is between 0.0 and 1.0, the effective number of steps is calculated as `round(steps × denoise)`, and only the corresponding last portion of the sigma schedule is used. If the requested `steps` value does not match the built-in schedule length, the noise levels are log-linearly interpolated to match the requested step count. The final sigma value is always set to 0. + ## Outputs | Output Name | Description | Data Type | @@ -19,4 +21,4 @@ The AlignYourStepsScheduler node generates sigma values for the denoising proces > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/AlignYourStepsScheduler/en.md) --- -**Source fingerprint (SHA-256):** `ea8694299147f6f28a1191f0f3c416c64cff9ca3a73bc54fa9319ab7eaab4ce9` +**Source fingerprint (SHA-256):** `3adbe1016c1ff4b9b7ad3737f50b168f54444d4ca355488e60537d1136f85d3f` diff --git a/comfyui_embedded_docs/docs/ApplyTextureToMesh/ar.md b/comfyui_embedded_docs/docs/ApplyTextureToMesh/ar.md new file mode 100644 index 000000000..57a755a05 --- /dev/null +++ b/comfyui_embedded_docs/docs/ApplyTextureToMesh/ar.md @@ -0,0 +1,27 @@ +# ApplyTextureToMesh + +تقوم هذه العقدة بإرفاق صور النسيج المخبوزة بتخطيط UV للشبكة بحيث يمكن تصديرها مع الشبكة بواسطة عقدة SaveGLB. قم بتوصيل نفس الشبكة المفككة UV التي استخدمتها في الخبز، مع خرائط الصور المخبوزة. يتم دمج خرائط المعدن والخشونة والإطباق الاختيارية في نسيج ORM واحد، كما أن توفير خريطة عموديات يخزن أيضًا العموديات الملساء والمماسات اللازمة للتظليل الصحيح. + +## المدخلات + +| المعامل | الوصف | نوع البيانات | إلزامي | النطاق | +|-----------|-------------|-----------|----------|-------| +| `mesh` | الشبكة المفككة UV التي سيتم إرفاق النسيج المخبوز بها. يجب أن تكون نفس الشبكة المستخدمة أثناء الخبز؛ يتم رفع خطأ إذا لم تحتوِ الشبكة على UV. | MESH | نعم | — | +| `base_color` | صورة اللون الأساسي المخبوزة. تُخزَّن كنسيج للشبكة وتُقيَّد إلى النطاق 0-1. | IMAGE | نعم | — | +| `metallic` | خريطة المعدن المخبوزة. تُستخدم كالقناة الزرقاء لنسيج ORM المدمج؛ القيمة الافتراضية 0 عند عدم توفيرها. | IMAGE | لا | — | +| `roughness` | خريطة الخشونة المخبوزة. تُستخدم كالقناة الخضراء لنسيج ORM المدمج؛ القيمة الافتراضية 1 عند عدم توفيرها. | IMAGE | لا | — | +| `occlusion` | خريطة الإطباق المحيط المخبوزة. تُستخدم كالقناة الحمراء لنسيج ORM المدمج؛ القيمة الافتراضية 1 عند عدم توفيرها. عند توفيرها، يتم أيضًا تعليم نسيج ORM كنسيج إطباق لعقدة SaveGLB. | IMAGE | لا | — | +| `normal_map` | خريطة العموديات المخبوزة في فضاء المماس. عند توفيرها، يعيد العقد حساب أساس المماس لكل قمة ويُصدِّر عموديات قمم ملساء بحيث تُظلِّل خريطة العموديات بشكل صحيح. | IMAGE | لا | — | + +ملاحظة: عند توصيل أي من `metallic` أو `roughness` أو `occlusion`، يتم دمج الثلاثة في نسيج ORM واحد بصيغة glTF مع قنوات R = إطباق، G = خشونة، B = معدن. تُملأ الخرائط المفقودة بالقيم الافتراضية (إطباق 1، خشونة 1، معدن 0)، وتُعاد قياس الخرائط ذات الدقة المختلفة إلى أكبر عرض وارتفاع. عند توصيل `normal_map`، تُستبدل عموديات الشبكة بعموديات قمم ملساء محسوبة، وتُضاف قاعدة مماسة (Tangent Basis). تُعاد قياس إحداثيات UV التي تقع خارج النطاق [0,1] بشكل موحّد إلى [0,1] مع الحفاظ على نسبة العرض إلى الارتفاع. + +## المخرجات + +| اسم المخرج | الوصف | نوع البيانات | +|-------------|-------------|-----------| +| `mesh` | الشبكة المدخلة مع صور النسيج المرفقة بتخطيطها UV، جاهزة للحفظ بواسطة SaveGLB. | MESH | + +> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ApplyTextureToMesh/ar.md) + +--- +**Source fingerprint (SHA-256):** `f91985ef686beddccc41a72614b3d263b4e0d9f1a156db6017d620de26d7b6cf` diff --git a/comfyui_embedded_docs/docs/ApplyTextureToMesh/en.md b/comfyui_embedded_docs/docs/ApplyTextureToMesh/en.md new file mode 100644 index 000000000..529c445bc --- /dev/null +++ b/comfyui_embedded_docs/docs/ApplyTextureToMesh/en.md @@ -0,0 +1,27 @@ +# ApplyTextureToMesh + +This node attaches baked texture images to a mesh's UV layout so they can be exported together with the mesh by the SaveGLB node. Connect the same UV-unwrapped mesh you used for baking, along with the baked image maps. Optional metallic, roughness, and occlusion maps are packed into a single ORM texture, and supplying a normal map also stores the smooth normals and tangents needed for correct shading. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `mesh` | The UV-unwrapped mesh that the baked textures will be attached to. Must be the same mesh used during baking; an error is raised if the mesh has no UVs. | MESH | Yes | — | +| `base_color` | The baked base color image. Stored as the mesh's texture and clamped to the 0-1 range. | IMAGE | Yes | — | +| `metallic` | The baked metallic map. Used as the blue channel of the combined ORM texture; defaults to 0 when not provided. | IMAGE | No | — | +| `roughness` | The baked roughness map. Used as the green channel of the combined ORM texture; defaults to 1 when not provided. | IMAGE | No | — | +| `occlusion` | The baked ambient occlusion map. Used as the red channel of the combined ORM texture; defaults to 1 when not provided. When provided, the ORM texture is also marked as the occlusion texture for SaveGLB. | IMAGE | No | — | +| `normal_map` | The baked tangent-space normal map. When provided, the node recomputes the per-vertex tangent basis and exports smooth vertex normals so the normal map shades correctly. | IMAGE | No | — | + +Note: When any of `metallic`, `roughness`, or `occlusion` is connected, all three are packed into a single glTF ORM texture with channels R = occlusion, G = roughness, B = metallic. Missing maps are filled with defaults (occlusion 1, roughness 1, metallic 0), and maps with different resolutions are resized to the largest width and height. When `normal_map` is connected, the mesh's normals are replaced with computed smooth vertex normals and a tangent basis is added. UV coordinates that fall outside the [0,1] range are uniformly scaled into [0,1] while preserving aspect ratio. + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `mesh` | The input mesh with the texture images attached to its UV layout, ready to be saved by SaveGLB. | MESH | + +> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ApplyTextureToMesh/en.md) + +--- +**Source fingerprint (SHA-256):** `f91985ef686beddccc41a72614b3d263b4e0d9f1a156db6017d620de26d7b6cf` diff --git a/comfyui_embedded_docs/docs/ApplyTextureToMesh/es.md b/comfyui_embedded_docs/docs/ApplyTextureToMesh/es.md new file mode 100644 index 000000000..5002ec5b1 --- /dev/null +++ b/comfyui_embedded_docs/docs/ApplyTextureToMesh/es.md @@ -0,0 +1,27 @@ +# ApplyTextureToMesh + +Este nodo adjunta imágenes de textura horneadas a la disposición UV de una malla para que puedan exportarse junto con la malla mediante el nodo SaveGLB. Conecte la misma malla con UV desenvueltos que utilizó para el horneado, junto con los mapas de imagen horneados. Los mapas opcionales de metalness, rugosidad y oclusión se empaquetan en una única textura ORM, y el suministro de un mapa de normales también almacena las normales suavizadas y las tangentes necesarias para un sombreado correcto. + +## Entradas + +| Parámetro | Descripción | Tipo de dato | Requerido | Rango | +|-----------|-------------|--------------|-----------|-------| +| `mesh` | La malla con UV desenvueltos a la que se adjuntarán las texturas horneadas. Debe ser la misma malla utilizada durante el horneado; se muestra un error si la malla no tiene UVs. | MESH | Sí | — | +| `base_color` | La imagen de color base horneada. Se almacena como textura de la malla y se limita al rango 0-1. | IMAGE | Sí | — | +| `metallic` | El mapa de metalness horneado. Se utiliza como canal azul de la textura ORM combinada; el valor predeterminado es 0 si no se proporciona. | IMAGE | No | — | +| `roughness` | El mapa de rugosidad horneado. Se utiliza como canal verde de la textura ORM combinada; el valor predeterminado es 1 si no se proporciona. | IMAGE | No | — | +| `occlusion` | El mapa de oclusión ambiental horneado. Se utiliza como canal rojo de la textura ORM combinada; el valor predeterminado es 1 si no se proporciona. Cuando se proporciona, la textura ORM también se marca como textura de oclusión para SaveGLB. | IMAGE | No | — | +| `normal_map` | El mapa de normales horneado en espacio tangente. Cuando se proporciona, el nodo recalcula la base tangente por vértice y exporta normales de vértice suavizadas para que el mapa de normales sombree correctamente. | IMAGE | No | — | + +Nota: Cuando se conecta cualquiera de `metallic`, `roughness` u `occlusion`, los tres se empaquetan en una única textura ORM (glTF) con canales R = oclusión, G = rugosidad, B = metalness. Los mapas faltantes se rellenan con valores predeterminados (oclusión 1, rugosidad 1, metalness 0), y los mapas con diferentes resoluciones se redimensionan al ancho y alto mayores. Cuando se conecta `normal_map`, las normales de la malla se reemplazan con normales de vértice suavizadas calculadas y se añade una base tangente. Las coordenadas UV que caen fuera del rango [0,1] se escalan uniformemente a [0,1] conservando la proporción de aspecto. + +## Salidas + +| Nombre de salida | Descripción | Tipo de dato | +|------------------|-------------|--------------| +| `mesh` | La malla de entrada con las imágenes de textura adjuntas a su disposición UV, lista para ser guardada por SaveGLB. | MESH | + +> Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ApplyTextureToMesh/es.md) + +--- +**Source fingerprint (SHA-256):** `f91985ef686beddccc41a72614b3d263b4e0d9f1a156db6017d620de26d7b6cf` diff --git a/comfyui_embedded_docs/docs/ApplyTextureToMesh/fa.md b/comfyui_embedded_docs/docs/ApplyTextureToMesh/fa.md new file mode 100644 index 000000000..398babbf1 --- /dev/null +++ b/comfyui_embedded_docs/docs/ApplyTextureToMesh/fa.md @@ -0,0 +1,25 @@ +# ApplyTextureToMesh + +## ورودی‌ها + +| پارامتر | توضیحات | نوع داده | ضروری | بازه | +|---------|----------|----------|--------|------| +| `mesh` | مش بازشدهٔ UV که بافت‌های پخته‌شده به آن متصل خواهند شد. باید همان مشی باشد که در هنگام پخت استفاده شده است؛ اگر مش UV نداشته باشد، خطایی صادر می‌شود. | MESH | بله | — | +| `base_color` | تصویر رنگ پایهٔ پخته‌شده. به‌عنوان بافت مش ذخیره و به بازهٔ ۰ تا ۱ محدود می‌شود. | IMAGE | بله | — | +| `metallic` | نقشهٔ فلزینگی پخته‌شده. به‌عنوان کانال آبی بافت ORM ترکیبی استفاده می‌شود؛ در صورت عدم ارائه، پیش‌فرض ۰ است. | IMAGE | خیر | — | +| `roughness` | نقشهٔ زبری پخته‌شده. به‌عنوان کانال سبز بافت ORM ترکیبی استفاده می‌شود؛ در صورت عدم ارائه، پیش‌فرض ۱ است. | IMAGE | خیر | — | +| `occlusion` | نقشهٔ انسداد محیطی پخته‌شده. به‌عنوان کانال قرمز بافت ORM ترکیبی استفاده می‌شود؛ در صورت عدم ارائه، پیش‌فرض ۱ است. در صورت ارائه، بافت ORM همچنین به‌عنوان بافت انسداد برای SaveGLB علامت‌گذاری می‌شود. | IMAGE | خیر | — | +| `normal_map` | نقشهٔ نرمال پخته‌شده در فضای مماس. در صورت ارائه، گره پایهٔ مماس برای هر رأس را دوباره محاسبه کرده و نرمال‌های رأس هموار را صادر می‌کند تا نقشهٔ نرمال به‌درستی سایه‌زنی شود. | IMAGE | خیر | — | + +نکته: وقتی هر یک از `metallic`، `roughness` یا `occlusion` متصل شود، هر سه در یک بافت ORM با فرمت glTF بسته‌بندی می‌شوند که در آن کانال‌ها R = انسداد، G = زبری، B = فلزینگی است. نقشه‌هایی که ارائه نشده‌اند با مقادیر پیش‌فرض پر می‌شوند (انسداد ۱، زبری ۱، فلزینگی ۰) و نقشه‌هایی با وضوح متفاوت به بزرگ‌ترین عرض و ارتفاع تغییر اندازه داده می‌شوند. وقتی `normal_map` متصل شود، نرمال‌های مش با نرمال‌های رأس هموار محاسبه‌شده جایگزین شده و پایهٔ مماس اضافه می‌شود. مختصات UV که خارج از بازهٔ [0,1] قرار می‌گیرند، با حفظ نسبت ابعاد، به‌طور یکنواخت در [0,1] مقیاس می‌شوند. + +## خروجی‌ها + +| نام خروجی | توضیحات | نوع داده | +|-----------|----------|----------| +| `mesh` | مش ورودی به همراه تصاویر بافت متصل‌شده به چیدمان UV آن، آماده برای ذخیره‌سازی توسط SaveGLB. | MESH | + +> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ApplyTextureToMesh/fa.md) + +--- +**Source fingerprint (SHA-256):** `f91985ef686beddccc41a72614b3d263b4e0d9f1a156db6017d620de26d7b6cf` diff --git a/comfyui_embedded_docs/docs/ApplyTextureToMesh/fr.md b/comfyui_embedded_docs/docs/ApplyTextureToMesh/fr.md new file mode 100644 index 000000000..f95df29a1 --- /dev/null +++ b/comfyui_embedded_docs/docs/ApplyTextureToMesh/fr.md @@ -0,0 +1,27 @@ +# ApplyTextureToMesh + +Ce nœud attache les images de texture cuites à la disposition UV d’un maillage afin qu’elles puissent être exportées avec le maillage par le nœud SaveGLB. Connectez le même maillage déplié en UV que celui utilisé pour le baking, ainsi que les cartes d’images cuites. Les cartes optionnelles de métallicité, de rugosité et d’occlusion sont regroupées dans une seule texture ORM, et la fourniture d’une carte de normales stocke également les normales lisses et les tangentes nécessaires à un ombrage correct. + +## Entrées + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `mesh` | Le maillage déplié en UV auquel les textures cuites seront attachées. Doit être le même maillage que celui utilisé pendant le baking ; une erreur est levée si le maillage n’a pas d’UV. | MESH | Oui | — | +| `base_color` | L’image de couleur de base cuite. Stockée comme texture du maillage et limitée à la plage 0-1. | IMAGE | Oui | — | +| `metallic` | La carte de métallicité cuite. Utilisée comme canal bleu de la texture ORM combinée ; par défaut à 0 lorsqu’elle n’est pas fournie. | IMAGE | Non | — | +| `roughness` | La carte de rugosité cuite. Utilisée comme canal vert de la texture ORM combinée ; par défaut à 1 lorsqu’elle n’est pas fournie. | IMAGE | Non | — | +| `occlusion` | La carte d’occlusion ambiante cuite. Utilisée comme canal rouge de la texture ORM combinée ; par défaut à 1 lorsqu’elle n’est pas fournie. Lorsqu’elle est fournie, la texture ORM est également marquée comme texture d’occlusion pour SaveGLB. | IMAGE | Non | — | +| `normal_map` | La carte de normales tangentes cuite. Lorsqu’elle est fournie, le nœud recalcule la base tangente par sommet et exporte des normales de sommet lisses afin que la carte de normales soit ombrée correctement. | IMAGE | Non | — | + +Remarque : lorsque l’une des cartes `metallic`, `roughness` ou `occlusion` est connectée, les trois sont regroupées dans une seule texture ORM glTF avec les canaux R = occlusion, G = rugosité, B = métallicité. Les cartes manquantes sont remplies avec des valeurs par défaut (occlusion 1, rugosité 1, métallicité 0), et les cartes de résolutions différentes sont redimensionnées à la largeur et à la hauteur maximales. Lorsque `normal_map` est connectée, les normales du maillage sont remplacées par des normales de sommet lisses calculées et une base tangente est ajoutée. Les coordonnées UV qui tombent hors de la plage [0,1] sont uniformément mises à l’échelle dans [0,1] tout en préservant le rapport d’aspect. + +## Sorties + +| Nom de sortie | Description | Type de données | +|---------------|-------------|-----------------| +| `mesh` | Le maillage d’entrée avec les images de texture attachées à sa disposition UV, prêt à être enregistré par SaveGLB. | MESH | + +> Cette documentation a été générée par IA. Si vous trouvez des erreurs ou avez des suggestions d'amélioration, n'hésitez pas à contribuer ! [Modifier sur GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ApplyTextureToMesh/fr.md) + +--- +**Source fingerprint (SHA-256):** `f91985ef686beddccc41a72614b3d263b4e0d9f1a156db6017d620de26d7b6cf` diff --git a/comfyui_embedded_docs/docs/ApplyTextureToMesh/ja.md b/comfyui_embedded_docs/docs/ApplyTextureToMesh/ja.md new file mode 100644 index 000000000..322e52754 --- /dev/null +++ b/comfyui_embedded_docs/docs/ApplyTextureToMesh/ja.md @@ -0,0 +1,27 @@ +# ApplyTextureToMesh + +このノードは、ベイク処理されたテクスチャ画像をメッシュのUVレイアウトに貼り付け、SaveGLBノードでメッシュと一緒にエクスポートできるようにします。ベイク処理で使用したものと同じUV展開済みメッシュと、ベイク処理された画像マップを接続してください。オプションのメタリック、ラフネス、オクルージョンマップは単一のORMテクスチャにパックされ、ノーマルマップを指定すると、正しいシェーディングに必要なスムーズなノーマルとタンジェントも保存されます。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `mesh` | ベイク処理されたテクスチャが貼り付けられるUV展開済みメッシュ。ベイク処理時に使用したものと同じメッシュである必要があります。メッシュにUVがない場合はエラーが発生します。 | MESH | はい | — | +| `base_color` | ベイク処理されたベースカラー画像。メッシュのテクスチャとして保存され、0~1の範囲にクランプされます。 | IMAGE | はい | — | +| `metallic` | ベイク処理されたメタリックマップ。合成されたORMテクスチャのブルーチャネルとして使用されます。指定しない場合はデフォルトで0になります。 | IMAGE | いいえ | — | +| `roughness` | ベイク処理されたラフネスマップ。合成されたORMテクスチャのグリーンチャネルとして使用されます。指定しない場合はデフォルトで1になります。 | IMAGE | いいえ | — | +| `occlusion` | ベイク処理されたアンビエントオクルージョンマップ。合成されたORMテクスチャのレッドチャネルとして使用されます。指定しない場合はデフォルトで1になります。指定した場合、ORMテクスチャはSaveGLBのオクルージョンテクスチャとしてもマークされます。 | IMAGE | いいえ | — | +| `normal_map` | ベイク処理されたタンジェント空間ノーマルマップ。指定すると、ノードは頂点ごとのタンジェント基底を再計算し、スムーズな頂点ノーマルをエクスポートして、ノーマルマップが正しくシェーディングされるようにします。 | IMAGE | いいえ | — | + +注記:`metallic`、`roughness`、`occlusion`のいずれかが接続されている場合、3つすべてが単一のglTF ORMテクスチャにパックされ、チャネルはR=オクルージョン、G=ラフネス、B=メタリックとなります。欠落しているマップはデフォルト値(オクルージョン1、ラフネス1、メタリック0)で埋められ、解像度が異なるマップは最大の幅と高さにリサイズされます。`normal_map`が接続されている場合、メッシュのノーマルは計算されたスムーズな頂点ノーマルに置き換えられ、タンジェント基底が追加されます。 [0,1] の範囲外にあるUV座標は、アスペクト比を維持したまま [0,1] に均一にスケーリングされます。 + +## 出力 + +| 出力名 | 説明 | データ型 | +|-------------|-------------|-----------| +| `mesh` | ベイク処理されたテクスチャ画像がUVレイアウトに貼り付けられた入力メッシュ。SaveGLBで保存できる状態になります。 | MESH | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ApplyTextureToMesh/ja.md) + +--- +**Source fingerprint (SHA-256):** `f91985ef686beddccc41a72614b3d263b4e0d9f1a156db6017d620de26d7b6cf` diff --git a/comfyui_embedded_docs/docs/ApplyTextureToMesh/ko.md b/comfyui_embedded_docs/docs/ApplyTextureToMesh/ko.md new file mode 100644 index 000000000..f90ca6729 --- /dev/null +++ b/comfyui_embedded_docs/docs/ApplyTextureToMesh/ko.md @@ -0,0 +1,27 @@ +# ApplyTextureToMesh + +이 노드는 베이크된 텍스처 이미지를 메시의 UV 레이아웃에 부착하여 SaveGLB 노드가 메시와 함께 내보낼 수 있도록 합니다. 베이킹에 사용한 것과 동일한 UV 언랩 메시와 베이크된 이미지 맵을 연결하십시오. 선택적인 메탈릭, 러프니스, 오클루전 맵은 단일 ORM 텍스처로 압축되며, 노멀 맵을 제공하면 올바른 셰이딩에 필요한 스무스 노멀과 탄젠트도 함께 저장됩니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `mesh` | 베이크된 텍스처가 부착될 UV 언랩 메시입니다. 베이킹 중 사용한 것과 동일한 메시여야 하며, 메시에 UV가 없으면 오류가 발생합니다. | MESH | 예 | — | +| `base_color` | 베이크된 베이스 컬러 이미지입니다. 메시의 텍스처로 저장되고 0-1 범위로 클램프됩니다. | IMAGE | 예 | — | +| `metallic` | 베이크된 메탈릭 맵입니다. 결합된 ORM 텍스처의 블루 채널로 사용되며, 제공되지 않으면 기본값은 0입니다. | IMAGE | 아니요 | — | +| `roughness` | 베이크된 러프니스 맵입니다. 결합된 ORM 텍스처의 그린 채널로 사용되며, 제공되지 않으면 기본값은 1입니다. | IMAGE | 아니요 | — | +| `occlusion` | 베이크된 앰비언트 오클루전 맵입니다. 결합된 ORM 텍스처의 레드 채널로 사용되며, 제공되지 않으면 기본값은 1입니다. 제공되면 ORM 텍스처는 SaveGLB의 오클루전 텍스처로도 표시됩니다. | IMAGE | 아니요 | — | +| `normal_map` | 베이크된 탄젠트 공간 노멀 맵입니다. 제공되면 노드가 정점별 탄젠트 기저를 다시 계산하고 스무스 정점 노멀을 내보내 노멀 맵이 올바르게 셰이딩되도록 합니다. | IMAGE | 아니요 | — | + +참고: `metallic`, `roughness`, `occlusion` 중 하나라도 연결되면 세 맵 모두 단일 glTF ORM 텍스처로 압축되며 채널은 R = 오클루전, G = 러프니스, B = 메탈릭입니다. 누락된 맵은 기본값(오클루전 1, 러프니스 1, 메탈릭 0)으로 채워지고, 해상도가 다른 맵은 가장 큰 너비와 높이로 크기가 조정됩니다. `normal_map`이 연결되면 메시의 노멀은 계산된 스무스 정점 노멀로 대체되고 탄젠트 기저가 추가됩니다. [0,1] 범위를 벗어나는 UV 좌표는 종횡비를 유지하면서 [0,1]로 균일하게 스케일됩니다. + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-----------|-------------|-------------| +| `mesh` | 텍스처 이미지가 UV 레이아웃에 부착된 입력 메시로, SaveGLB로 저장할 준비가 된 상태입니다. | MESH | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ApplyTextureToMesh/ko.md) + +--- +**Source fingerprint (SHA-256):** `f91985ef686beddccc41a72614b3d263b4e0d9f1a156db6017d620de26d7b6cf` diff --git a/comfyui_embedded_docs/docs/ApplyTextureToMesh/pt-BR.md b/comfyui_embedded_docs/docs/ApplyTextureToMesh/pt-BR.md new file mode 100644 index 000000000..ea72fed92 --- /dev/null +++ b/comfyui_embedded_docs/docs/ApplyTextureToMesh/pt-BR.md @@ -0,0 +1,27 @@ +# ApplyTextureToMesh + +Este nó anexa imagens de textura assadas ao layout de UV de uma malha para que possam ser exportadas junto com a malha pelo nó SaveGLB. Conecte a mesma malha com UVs planificados usada durante o processo de assar as texturas, juntamente com os mapas de imagem assados. Mapas opcionais de metálico, rugosidade e oclusão são empacotados em uma única textura ORM, e o fornecimento de um mapa normal também armazena as normais suaves e as tangentes necessárias para a sombreamento correto. + +## Entradas + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | +|-----------|-------------|-----------|----------|-------| +| `mesh` | A malha com UVs planificados à qual as texturas assadas serão anexadas. Deve ser a mesma malha usada durante o processo de assar; um erro é gerado se a malha não tiver UVs. | MESH | Sim | — | +| `base_color` | A imagem de cor base assada. Armazenada como textura da malha e limitada ao intervalo de 0 a 1. | IMAGE | Sim | — | +| `metallic` | O mapa de metálico assado. Usado como o canal azul da textura ORM combinada; o padrão é 0 quando não fornecido. | IMAGE | Não | — | +| `roughness` | O mapa de rugosidade assado. Usado como o canal verde da textura ORM combinada; o padrão é 1 quando não fornecido. | IMAGE | Não | — | +| `occlusion` | O mapa de oclusão ambiente assado. Usado como o canal vermelho da textura ORM combinada; o padrão é 1 quando não fornecido. Quando fornecido, a textura ORM também é marcada como a textura de oclusão para o SaveGLB. | IMAGE | Não | — | +| `normal_map` | O mapa normal assado em espaço tangente. Quando fornecido, o nó recalcula a base tangente por vértice e exporta normais de vértice suaves para que o mapa normal sombreie corretamente. | IMAGE | Não | — | + +Nota: Quando qualquer um dos parâmetros `metallic`, `roughness` ou `occlusion` estiver conectado, os três serão empacotados em uma única textura ORM glTF, com canais R = oclusão, G = rugosidade, B = metálico. Mapas ausentes são preenchidos com valores padrão (oclusão 1, rugosidade 1, metálico 0), e mapas com resoluções diferentes são redimensionados para a maior largura e altura. Quando `normal_map` estiver conectado, as normais da malha são substituídas por normais de vértice suaves calculadas e uma base tangente é adicionada. Coordenadas de UV que estejam fora do intervalo [0,1] são escaladas uniformemente para o intervalo [0,1], preservando a proporção. + +## Saídas + +| Nome da Saída | Descrição | Tipo de Dados | +|-------------|-------------|-----------| +| `mesh` | A malha de entrada com as imagens de textura anexadas ao seu layout de UV, pronta para ser salva pelo SaveGLB. | MESH | + +> Esta documentação foi gerada por IA. Se você encontrar erros ou tiver sugestões de melhoria, sinta-se à vontade para contribuir! [Editar no GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ApplyTextureToMesh/pt-BR.md) + +--- +**Source fingerprint (SHA-256):** `f91985ef686beddccc41a72614b3d263b4e0d9f1a156db6017d620de26d7b6cf` diff --git a/comfyui_embedded_docs/docs/ApplyTextureToMesh/ru.md b/comfyui_embedded_docs/docs/ApplyTextureToMesh/ru.md new file mode 100644 index 000000000..d15f37d8d --- /dev/null +++ b/comfyui_embedded_docs/docs/ApplyTextureToMesh/ru.md @@ -0,0 +1,27 @@ +# ApplyTextureToMesh + +Этот узел прикрепляет запечённые текстурные изображения к UV-развёртке меша, чтобы их можно было экспортировать вместе с мешем с помощью узла SaveGLB. Подключите ту же UV-развёртку меша, которая использовалась для запекания, вместе с запечёнными картами изображений. Дополнительные карты металличности, шероховатости и окклюзии упаковываются в единую текстуру ORM, а при наличии карты нормалей также сохраняются сглаженные нормали и касательные, необходимые для корректного затенения. + +## Входные параметры + +| Параметр | Описание | Тип данных | Обязательность | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `mesh` | Меш с UV-развёрткой, к которому будут прикреплены запечённые текстуры. Должен быть тем же мешем, который использовался при запекании; если у меша нет UV, возникает ошибка. | MESH | Да | — | +| `base_color` | Запечённое изображение базового цвета. Сохраняется как текстура меша и ограничивается диапазоном 0–1. | IMAGE | Да | — | +| `metallic` | Запечённая карта металличности. Используется как синий канал объединённой текстуры ORM; если не задана, по умолчанию 0. | IMAGE | Нет | — | +| `roughness` | Запечённая карта шероховатости. Используется как зелёный канал объединённой текстуры ORM; если не задана, по умолчанию 1. | IMAGE | Нет | — | +| `occlusion` | Запечённая карта фонового затенения (окклюзии). Используется как красный канал объединённой текстуры ORM; если не задана, по умолчанию 1. Когда задана, текстура ORM также помечается как текстура затенения для SaveGLB. | IMAGE | Нет | — | +| `normal_map` | Запечённая карта нормалей в касательном пространстве. Если задана, узел пересчитывает касательный базис для каждой вершины и экспортирует сглаженные вершинные нормали, чтобы карта нормалей отображалась корректно. | IMAGE | Нет | — | + +Примечание: Если подключена любая из карт `metallic`, `roughness` или `occlusion`, все три упаковываются в единую текстуру ORM glTF с каналами R = затенение, G = шероховатость, B = металличность. Отсутствующие карты заполняются значениями по умолчанию (затенение 1, шероховатость 1, металличность 0), а карты с разным разрешением изменяются до наибольшей ширины и высоты. Если подключена `normal_map`, нормали меша заменяются вычисленными сглаженными вершинными нормалями и добавляется касательный базис. UV-координаты, выходящие за пределы диапазона [0,1], равномерно масштабируются в [0,1] с сохранением соотношения сторон. + +## Выходные параметры + +| Имя выхода | Описание | Тип данных | +|-------------|-------------|-----------| +| `mesh` | Входной меш с прикреплёнными к его UV-развёртке текстурами, готовый к сохранению с помощью SaveGLB. | MESH | + +> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ApplyTextureToMesh/ru.md) + +--- +**Source fingerprint (SHA-256):** `f91985ef686beddccc41a72614b3d263b4e0d9f1a156db6017d620de26d7b6cf` diff --git a/comfyui_embedded_docs/docs/ApplyTextureToMesh/tr.md b/comfyui_embedded_docs/docs/ApplyTextureToMesh/tr.md new file mode 100644 index 000000000..e2be8f0d3 --- /dev/null +++ b/comfyui_embedded_docs/docs/ApplyTextureToMesh/tr.md @@ -0,0 +1,27 @@ +# ApplyTextureToMesh + +Bu düğüm, pişirilmiş doku görüntülerini bir ağın UV düzenine ekler; böylece SaveGLB düğümü tarafından ağ ile birlikte dışa aktarılabilirler. Pişirme sırasında kullandığınız aynı UV açılmış ağı, pişirilmiş görüntü haritalarıyla birlikte bağlayın. İsteğe bağlı metalik, pürüzlülük ve oklüzyon haritaları tek bir ORM dokusunda paketlenir ve normal harita sağlanması, doğru gölgeleme için gereken düzgün normalleri ve teğetleri de saklar. + +## Girdiler + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +|-----------|-------------|-----------|----------|-------| +| `mesh` | Pişirilmiş dokuların ekleneceği UV açılmış ağ. Pişirme sırasında kullanılan ağ ile aynı olmalıdır; ağda UV yoksa hata oluşturulur. | MESH | Evet | — | +| `base_color` | Pişirilmiş temel renk görüntüsü. Ağın dokusu olarak saklanır ve 0-1 aralığına sınırlanır. | IMAGE | Evet | — | +| `metallic` | Pişirilmiş metalik harita. Birleşik ORM dokusunun mavi kanalı olarak kullanılır; sağlanmadığında varsayılan olarak 0 değerini alır. | IMAGE | Hayır | — | +| `roughness` | Pişirilmiş pürüzlülük haritası. Birleşik ORM dokusunun yeşil kanalı olarak kullanılır; sağlanmadığında varsayılan olarak 1 değerini alır. | IMAGE | Hayır | — | +| `occlusion` | Pişirilmiş ortam oklüzyon haritası. Birleşik ORM dokusunun kırmızı kanalı olarak kullanılır; sağlanmadığında varsayılan olarak 1 değerini alır. Sağlandığında, ORM dokusu SaveGLB için oklüzyon dokusu olarak da işaretlenir. | IMAGE | Hayır | — | +| `normal_map` | Pişirilmiş teğet uzayı normal haritası. Sağlandığında, düğüm tepe noktası başına teğet tabanını yeniden hesaplar ve normal haritanın doğru gölgelenmesi için düzgün tepe normallerini dışa aktarır. | IMAGE | Hayır | — | + +Not: `metallic`, `roughness` veya `occlusion` girdilerinden herhangi biri bağlandığında, üçü de kanalları R = oklüzyon, G = pürüzlülük, B = metalik olacak şekilde tek bir glTF ORM dokusunda paketlenir. Eksik haritalar varsayılan değerlerle doldurulur (oklüzyon 1, pürüzlülük 1, metalik 0) ve farklı çözünürlükteki haritalar en büyük genişlik ve yüksekliğe yeniden boyutlandırılır. `normal_map` bağlandığında, ağın normalleri hesaplanan düzgün tepe normalleriyle değiştirilir ve bir teğet tabanı eklenir. [0,1] aralığının dışında kalan UV koordinatları, en-boy oranı korunarak [0,1] aralığına eşit şekilde ölçeklenir. + +## Çıktılar + +| Çıktı Adı | Açıklama | Veri Türü | +|-------------|-------------|-----------| +| `mesh` | Doku görüntüleri UV düzenine eklenmiş, SaveGLB tarafından kaydedilmeye hazır giriş ağı. | MESH | + +> Bu belge yapay zeka tarafından oluşturulmuştur. Herhangi bir hata bulursanız veya iyileştirme önerileriniz varsa, katkıda bulunmaktan çekinmeyin! [GitHub'da Düzenle](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ApplyTextureToMesh/tr.md) + +--- +**Source fingerprint (SHA-256):** `f91985ef686beddccc41a72614b3d263b4e0d9f1a156db6017d620de26d7b6cf` diff --git a/comfyui_embedded_docs/docs/ApplyTextureToMesh/zh-TW.md b/comfyui_embedded_docs/docs/ApplyTextureToMesh/zh-TW.md new file mode 100644 index 000000000..770328f10 --- /dev/null +++ b/comfyui_embedded_docs/docs/ApplyTextureToMesh/zh-TW.md @@ -0,0 +1,27 @@ +# ApplyTextureToMesh + +此節點將烘焙紋理影像附加到網格的 UV 佈局上,以便它們能透過 SaveGLB 節點與網格一起匯出。請連接您用於烘焙的相同 UV 展開網格,以及烘焙後的影像貼圖。可選的金屬度、粗糙度與環境光遮蔽貼圖會打包成單一 ORM 紋理,而提供法線貼圖時,也會儲存正確著色所需的平滑法線與切線。 + +## 輸入 + +| 參數 | 說明 | 資料型別 | 必要 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `mesh` | 要附加烘焙紋理的 UV 展開網格。必須是烘焙期間使用的相同網格;若網格沒有 UV,則會產生錯誤。 | MESH | 是 | — | +| `base_color` | 烘焙後的基底顏色影像。作為網格的紋理儲存,並限制在 0 到 1 的範圍內。 | IMAGE | 是 | — | +| `metallic` | 烘焙後的金屬度貼圖。用作組合 ORM 紋理的藍色通道;未提供時預設為 0。 | IMAGE | 否 | — | +| `roughness` | 烘焙後的粗糙度貼圖。用作組合 ORM 紋理的綠色通道;未提供時預設為 1。 | IMAGE | 否 | — | +| `occlusion` | 烘焙後的環境光遮蔽貼圖。用作組合 ORM 紋理的紅色通道;未提供時預設為 1。提供時,ORM 紋理也會標記為 SaveGLB 的環境光遮蔽紋理。 | IMAGE | 否 | — | +| `normal_map` | 烘焙後的切線空間法線貼圖。提供時,節點會重新計算每個頂點的切線基底,並匯出平滑頂點法線,使法線貼圖正確著色。 | IMAGE | 否 | — | + +注意:當 `metallic`、`roughness` 或 `occlusion` 任一項連接時,三者會打包成單一 glTF ORM 紋理,通道配置為 R = 環境光遮蔽、G = 粗糙度、B = 金屬度。缺少的貼圖會以預設值填補(環境光遮蔽 1、粗糙度 1、金屬度 0),而解析度不同的貼圖會調整為最大的寬度與高度。當 `normal_map` 連接時,網格的法線會替換為計算後的平滑頂點法線,並加入切線基底。位於 [0,1] 範圍之外的 UV 座標會被均勻縮放至 [0,1] 範圍內,同時保持長寬比。 + +## 輸出 + +| 輸出名稱 | 說明 | 資料型別 | +|-------------|-------------|-----------| +| `mesh` | 輸入的網格,其 UV 佈局上已附加紋理影像,可直接由 SaveGLB 儲存。 | MESH | + +> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ApplyTextureToMesh/zh-TW.md) + +--- +**Source fingerprint (SHA-256):** `f91985ef686beddccc41a72614b3d263b4e0d9f1a156db6017d620de26d7b6cf` diff --git a/comfyui_embedded_docs/docs/ApplyTextureToMesh/zh.md b/comfyui_embedded_docs/docs/ApplyTextureToMesh/zh.md new file mode 100644 index 000000000..eab6d5a8d --- /dev/null +++ b/comfyui_embedded_docs/docs/ApplyTextureToMesh/zh.md @@ -0,0 +1,27 @@ +# ApplyTextureToMesh + +此节点将烘焙纹理图像附加到网格的 UV 布局上,以便它们可以通过 SaveGLB 节点与网格一起导出。请连接与烘焙时相同的 UV 展开网格,以及烘焙后的图像贴图。可选的金属度、粗糙度和环境光遮蔽贴图会打包到单个 ORM 纹理中;提供法线贴图时,还会存储正确着色所需的平滑法线和切线。 + +## 输入 + +| 参数 | 说明 | 数据类型 | 必填 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `mesh` | 已展开 UV 的网格,烘焙纹理将附加到该网格上。必须与烘焙时使用的网格相同;如果网格没有 UV,则会报错。 | MESH | 是 | — | +| `base_color` | 烘焙后的基础颜色图像。存储为网格的纹理,并限制在 0–1 范围内。 | IMAGE | 是 | — | +| `metallic` | 烘焙后的金属度贴图。用作组合 ORM 纹理的蓝色通道;未提供时默认为 0。 | IMAGE | 否 | — | +| `roughness` | 烘焙后的粗糙度贴图。用作组合 ORM 纹理的绿色通道;未提供时默认为 1。 | IMAGE | 否 | — | +| `occlusion` | 烘焙后的环境光遮蔽贴图。用作组合 ORM 纹理的红色通道;未提供时默认为 1。提供时,ORM 纹理还会被标记为 SaveGLB 的环境光遮蔽纹理。 | IMAGE | 否 | — | +| `normal_map` | 烘焙后的切线空间法线贴图。提供时,节点会重新计算逐顶点切线基并导出平滑顶点法线,以便法线贴图正确着色。 | IMAGE | 否 | — | + +注意:当 `metallic`、`roughness` 或 `occlusion` 中任意一个被连接时,三者会打包到单个 glTF ORM 纹理中,通道为 R = 环境光遮蔽、G = 粗糙度、B = 金属度。缺失的贴图将使用默认值填充(环境光遮蔽 1、粗糙度 1、金属度 0),分辨率不同的贴图会调整为最大的宽度和高度。当连接 `normal_map` 时,网格的法线将被替换为计算出的平滑顶点法线,并添加切线基。落在 [0,1] 范围之外的 UV 坐标会在保持纵横比的同时统一缩放到 [0,1] 范围内。 + +## 输出 + +| 输出名称 | 说明 | 数据类型 | +|-------------|-------------|-----------| +| `mesh` | 输入网格,其 UV 布局上已附加纹理图像,可由 SaveGLB 保存。 | MESH | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ApplyTextureToMesh/zh.md) + +--- +**Source fingerprint (SHA-256):** `f91985ef686beddccc41a72614b3d263b4e0d9f1a156db6017d620de26d7b6cf` diff --git a/comfyui_embedded_docs/docs/AudioEncoderEncode/en.md b/comfyui_embedded_docs/docs/AudioEncoderEncode/en.md index 6e06af4ab..e7a56f100 100644 --- a/comfyui_embedded_docs/docs/AudioEncoderEncode/en.md +++ b/comfyui_embedded_docs/docs/AudioEncoderEncode/en.md @@ -1,6 +1,6 @@ # AudioEncoderEncode -The AudioEncoderEncode node processes audio data by encoding it using an audio encoder model. It takes audio input and converts it into an encoded representation that can be used for further processing in the conditioning pipeline. This node transforms raw audio waveforms into a format suitable for audio-based machine learning applications. +The AudioEncoderEncode node converts audio data into an encoded representation using an audio encoder model. It takes an audio encoder and raw audio input, then extracts the waveform and sample rate from the audio to produce an encoded output suitable for further processing in the conditioning pipeline. ## Inputs @@ -18,4 +18,4 @@ The AudioEncoderEncode node processes audio data by encoding it using an audio e > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/AudioEncoderEncode/en.md) --- -**Source fingerprint (SHA-256):** `abd34445d7b959a6421fe0fe6bed0498b3754ee313019e3315cbed399f68bbe6` +**Source fingerprint (SHA-256):** `85f77152ccc1e3f4687e2b655283e69e03d90b862d6a676dcb89ea973dd70a63` diff --git a/comfyui_embedded_docs/docs/AudioEncoderLoader/en.md b/comfyui_embedded_docs/docs/AudioEncoderLoader/en.md index 4662da1a0..0c5d23e26 100644 --- a/comfyui_embedded_docs/docs/AudioEncoderLoader/en.md +++ b/comfyui_embedded_docs/docs/AudioEncoderLoader/en.md @@ -6,7 +6,9 @@ The AudioEncoderLoader node loads an audio encoder model from a file in your aud | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `audio_encoder_name` | Selects which audio encoder model file to load | STRING | Yes | List of available audio encoder files in the audio_encoders folder | +| `audio_encoder_name` | Selects which audio encoder model file to load | COMBO | Yes | List of available audio encoder files in the audio_encoders folder | + +Note: If the selected file does not contain a valid audio encoder model, the node raises an error. ## Outputs @@ -17,4 +19,4 @@ The AudioEncoderLoader node loads an audio encoder model from a file in your aud > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/AudioEncoderLoader/en.md) --- -**Source fingerprint (SHA-256):** `66982618292df3881546883ff9efddbb8f8a2eae9aab45507ce0f96719fe6ee0` +**Source fingerprint (SHA-256):** `780d0c7fcf571e5ef02d273791e5d2e894baa6d5900d845ed65e9ce669769f7e` diff --git a/comfyui_embedded_docs/docs/AutogrowNamesTestNode/en.md b/comfyui_embedded_docs/docs/AutogrowNamesTestNode/en.md index fe1993918..a96b96257 100644 --- a/comfyui_embedded_docs/docs/AutogrowNamesTestNode/en.md +++ b/comfyui_embedded_docs/docs/AutogrowNamesTestNode/en.md @@ -19,4 +19,4 @@ This node is a test for the Autogrow input feature. It takes a dynamic number of > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/AutogrowNamesTestNode/en.md) --- -**Source fingerprint (SHA-256):** `7c9a6bdcbf7c65112d0810e5709a9d6d59f33c1980cd66fc475826565e35a1a9` +**Source fingerprint (SHA-256):** `dac384c9486ac645d0d292fc891603cbfa6d362baa0a1e939c43257bbc0b06a0` diff --git a/comfyui_embedded_docs/docs/AutogrowPrefixTestNode/en.md b/comfyui_embedded_docs/docs/AutogrowPrefixTestNode/en.md index c029d0baa..795cc9c4e 100644 --- a/comfyui_embedded_docs/docs/AutogrowPrefixTestNode/en.md +++ b/comfyui_embedded_docs/docs/AutogrowPrefixTestNode/en.md @@ -1,14 +1,14 @@ # AutogrowPrefixTestNode -The AutogrowPrefixTestNode is a logic node designed to test the autogrow input feature. It accepts a dynamic number of float inputs, combines their values into a comma-separated string, and outputs that string. +The AutogrowPrefixTestNode is a logic node that tests the autogrow input feature. It accepts a dynamic number of float inputs, converts each value into text, combines them into a comma-separated string, and outputs that string. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `autogrow` | A dynamic input group that can accept between 1 and 10 float values. Each input in the group is a FLOAT type with a minimum value of 1 and a maximum value of 10. | AUTOGROW | Yes | 1 to 10 inputs | +| `autogrow` | A dynamic input group that accepts between 1 and 10 float values. Each value is a floating-point number, and the generated inputs are named with the prefix `float`. | AUTOGROW | Yes | 1 to 10 inputs | -**Note:** The `autogrow` input is a special dynamic input. You can add multiple float inputs to this group, up to a maximum of 10. The node will process all provided values. Each individual float input is constrained to a range of 1 to 10. +**Note:** The `autogrow` input is a special dynamic input. You can add multiple float inputs to this group, from a minimum of 1 up to a maximum of 10. The node processes all provided values and includes every connected input in the output string. ## Outputs @@ -19,4 +19,4 @@ The AutogrowPrefixTestNode is a logic node designed to test the autogrow input f > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/AutogrowPrefixTestNode/en.md) --- -**Source fingerprint (SHA-256):** `93e3e3d13f8f411206d09e34e7e3b734596af0a2ef066712d6dfbe9dc3eec0cf` +**Source fingerprint (SHA-256):** `9b815f59961a4c661815f44b9c78e15e9084db1e4be89d502b9d92438f18e70b` diff --git a/comfyui_embedded_docs/docs/BakeAmbientOcclusion/ar.md b/comfyui_embedded_docs/docs/BakeAmbientOcclusion/ar.md new file mode 100644 index 000000000..bb783ce53 --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeAmbientOcclusion/ar.md @@ -0,0 +1,30 @@ +# BakeAmbientOcclusion + +```markdown +تُنشئ خريطة إضاءة محيطية (Ambient Occlusion) من شبكة عالية المضلعات إلى تخطيط إحداثيات UV لشبكة منخفضة المضلعات. الناتج هو صورة رمادية حيث تكون التيكسلات البيضاء مفتوحة والداكنة في الشقوق؛ وهي مخصصة لمدخل الإضاءة المحيطية في عقدة Apply Texture To Mesh. قم بتوصيل الشبكة منخفضة المضلعات المفكوكة إحداثياتها والشبكة عالية المضلعات التي اشتُقت منها بعد تقليل المضلعات. + +## المدخلات + +| Parameter | الوصف | Data Type | مطلوب | Range | +|-----------|-------------|-----------|----------|-------| +| `low_poly` | الشبكة منخفضة المضلعات المفكوكة إحداثياتها (UV) التي سيتم الحرق عليها. يجب أن تحتوي على إحداثيات UV؛ تُظهر العقدة خطأً في حال غيابها. | MESH | نعم | - | +| `high_poly` | الشبكة عالية المضلعات التي خُفِّضت منها الشبكة منخفضة المضلعات، وتُستخدم كمصدر هندسي لحساب الإضاءة المحيطية. | MESH | نعم | - | +| `resolution` | دقة النسيج بالبكسل؛ يستقبل كل تيكسل قيمة إضاءة محيطية. الافتراضي: 1024. | INT | نعم | 64 to 8192 (step 64) | +| `samples` | عدد الأشعة لكل تيكسل. المزيد يعني نتيجة أنعم لكن أبطأ. ارفع القيمة إذا كانت الصورة حبيبية. الافتراضي: 64. | INT | نعم | 4 to 1024 (step 4) | +| `max_distance` | طول الشعاع، ككسر من قطر الصندوق المحيط. القيم الأصغر تعني إضاءة محيطية أكثر إحكامًا ومحلية. الافتراضي: 0.5. | FLOAT | نعم | 0.01 to 2.0 (step 0.01) | +| `strength` | يضبط قوة الإضاءة المحيطية. القيم >1 تجعل الظلال أغمق، والقيم <1 تجعلها أفتح. الافتراضي: 1.0. | FLOAT | نعم | 0.0 to 2.0 (step 0.05) | +| `bias` | ارتفاع نقطة انطلاق الأشعة عن السطح، ككسر من قطر الصندوق المحيط. ارفع القيمة إذا ظهرت بقع أو ثقوب داكنة على الأسطح المستوية. الافتراضي: 0.01. | FLOAT | نعم | 0.0001 to 0.2 (step 0.0005) | + +ملاحظة: يجب أن يحتوي `low_poly` على إحداثيات UV — فهذه العقدة لا تقوم أبدًا بفك إحداثيات الشبكة. إذا كان `high_poly` يحتوي على عنصر دفعي واحد فقط، فسيُعاد استخدامه لكل عنصر دفعي من `low_poly`؛ أما عناصر `low_poly` الدفعية التي لا تحتوي على أوجه فسيتم تخطيها واستبدالها بصورة بيضاء بالكامل، مع تسجيل تحذير. + +## المخرجات + +| Output Name | الوصف | Data Type | +|-------------|-------------|-----------| +| `occlusion` | صورة رمادية للإضاءة المحيطية بقيم ضمن [0,1] (الأبيض = مساحات مفتوحة، الداكن = شقوق)، صورة واحدة لكل عنصر دفعي من `low_poly`. مخصصة لمدخل الإضاءة المحيطية في عقدة Apply Texture To Mesh (مضمّنة في خريطة ORM / occlusionTexture). | IMAGE | +``` + +> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeAmbientOcclusion/ar.md) + +--- +**Source fingerprint (SHA-256):** `63ea6ce5289728d351fdd7d722e9a299ebb1283e1128262a817466ec6d23786a` diff --git a/comfyui_embedded_docs/docs/BakeAmbientOcclusion/en.md b/comfyui_embedded_docs/docs/BakeAmbientOcclusion/en.md new file mode 100644 index 000000000..86cd06626 --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeAmbientOcclusion/en.md @@ -0,0 +1,28 @@ +# BakeAmbientOcclusion + +Bakes an ambient-occlusion map from a high-poly mesh into the UV layout of a low-poly mesh. The output is a grayscale image in which white texels are open and dark texels are in crevices; it is meant for the Apply Texture To Mesh node's occlusion input. Connect the UV-unwrapped low-poly mesh and the high-poly mesh it was decimated from. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `low_poly` | The UV-unwrapped low-poly mesh to bake into. Must have UVs; the node raises an error if they are missing. | MESH | Yes | - | +| `high_poly` | The high-poly mesh that the low-poly was decimated from, used as the source geometry for occlusion. | MESH | Yes | - | +| `resolution` | Texture resolution in pixels; each texel receives an occlusion value. Default: 1024. | INT | Yes | 64 to 8192 (step 64) | +| `samples` | Rays per texel. More = smoother, slower. Raise if grainy. Default: 64. | INT | Yes | 4 to 1024 (step 4) | +| `max_distance` | Ray length, as a fraction of the bounding box diagonal. Smaller = tighter, more local occlusion. Default: 0.5. | FLOAT | Yes | 0.01 to 2.0 (step 0.01) | +| `strength` | Scales the occlusion. >1 darkens, <1 lightens. Default: 1.0. | FLOAT | Yes | 0.0 to 2.0 (step 0.05) | +| `bias` | Ray origin lift off the surface, as a fraction of the bounding box diagonal. Raise if even surfaces show dark blotches/holes. Default: 0.01. | FLOAT | Yes | 0.0001 to 0.2 (step 0.0005) | + +Note: `low_poly` must have UV coordinates — this node never unwraps the mesh. If `high_poly` contains only one batch item, it is reused for every batch item of `low_poly`; batch items of `low_poly` with no faces are skipped and replaced with an all-white image, with a warning logged. + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `occlusion` | Grayscale ambient-occlusion image with values in [0,1] (white = open, dark = crevices), one image per batch item of `low_poly`. Intended for the Apply Texture To Mesh node's occlusion input (packed into the ORM map / occlusionTexture). | IMAGE | + +> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeAmbientOcclusion/en.md) + +--- +**Source fingerprint (SHA-256):** `63ea6ce5289728d351fdd7d722e9a299ebb1283e1128262a817466ec6d23786a` diff --git a/comfyui_embedded_docs/docs/BakeAmbientOcclusion/es.md b/comfyui_embedded_docs/docs/BakeAmbientOcclusion/es.md new file mode 100644 index 000000000..ed31e8df7 --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeAmbientOcclusion/es.md @@ -0,0 +1,28 @@ +# BakeAmbientOcclusion + +Hornea un mapa de oclusión ambiental de una malla de alta poligonización en el diseño UV de una malla de baja poligonización. La salida es una imagen en escala de grises en la que los texeles blancos están abiertos y los texeles oscuros están en hendiduras; está destinada a la entrada de oclusión del nodo Apply Texture To Mesh. Conecta la malla de baja poligonización con UV desplegados y la malla de alta poligonización de la que se decimó. + +## Entradas + +| Parámetro | Descripción | Tipo de dato | Requerido | Rango | +|-----------|-------------|--------------|-----------|-------| +| `low_poly` | La malla de baja poligonización con UV desplegados en la que se hornea. Debe tener UV; el nodo genera un error si faltan. | MESH | Sí | - | +| `high_poly` | La malla de alta poligonización de la que se decimó la de baja poligonización, utilizada como geometría de origen para la oclusión. | MESH | Sí | - | +| `resolution` | Resolución de textura en píxeles; cada texel recibe un valor de oclusión. Por defecto: 1024. | INT | Sí | 64 to 8192 (step 64) | +| `samples` | Rayos por texel. Más = más suave, más lento. Auméntalo si aparece granulado. Por defecto: 64. | INT | Sí | 4 to 1024 (step 4) | +| `max_distance` | Longitud del rayo, como fracción de la diagonal de la caja delimitadora. Más pequeño = más ajustado, oclusión más local. Por defecto: 0.5. | FLOAT | Sí | 0.01 to 2.0 (step 0.01) | +| `strength` | Escala la oclusión. >1 oscurece, <1 aclara. Por defecto: 1.0. | FLOAT | Sí | 0.0 to 2.0 (step 0.05) | +| `bias` | Elevación del origen del rayo desde la superficie, como fracción de la diagonal de la caja delimitadora. Auméntalo si superficies lisas muestran manchas o agujeros oscuros. Por defecto: 0.01. | FLOAT | Sí | 0.0001 to 0.2 (step 0.0005) | + +Nota: `low_poly` debe tener coordenadas UV — este nodo nunca despliega los UV de la malla. Si `high_poly` contiene solo un elemento de lote, se reutiliza para cada elemento de lote de `low_poly`; los elementos de lote de `low_poly` sin caras se omiten y se reemplazan con una imagen completamente blanca, registrándose una advertencia. + +## Salidas + +| Nombre de salida | Descripción | Tipo de dato | +|------------------|-------------|--------------| +| `occlusion` | Imagen de oclusión ambiental en escala de grises con valores en [0,1] (blanco = abierto, oscuro = hendiduras), una imagen por elemento de lote de `low_poly`. Destinada a la entrada de oclusión del nodo Apply Texture To Mesh (empaquetada en el mapa ORM / occlusionTexture). | IMAGE | + +> Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeAmbientOcclusion/es.md) + +--- +**Source fingerprint (SHA-256):** `63ea6ce5289728d351fdd7d722e9a299ebb1283e1128262a817466ec6d23786a` diff --git a/comfyui_embedded_docs/docs/BakeAmbientOcclusion/fa.md b/comfyui_embedded_docs/docs/BakeAmbientOcclusion/fa.md new file mode 100644 index 000000000..19c0e6239 --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeAmbientOcclusion/fa.md @@ -0,0 +1,28 @@ +# BakeAmbientOcclusion + +یک نقشه انسداد محیطی از مش پرجزئیات به چیدمان UV مش کم‌جزئیات می‌سازد. خروجی یک تصویر مقیاس خاکستری است که در آن تکسل‌های سفید نمایانگر نواحی باز و تکسل‌های تیره نمایانگر شکاف‌ها هستند؛ این تصویر برای ورودی occlusion گره Apply Texture To Mesh در نظر گرفته شده است. مش کم‌جزئیاتِ باز شده با UV و مش پرجزئیاتی که از آن کاهش یافته را متصل کنید. + +## ورودی‌ها + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `low_poly` | مش کم‌جزئیاتِ باز شده با UV که باید روی آن خروجی گرفته شود. باید UV داشته باشد؛ اگر UV وجود نداشته باشد، گره خطا صادر می‌کند. | MESH | بله | - | +| `high_poly` | مش پرجزئیاتی که کم‌جزئیات از آن کاهش یافته، به‌عنوان هندسه منبع برای انسداد استفاده می‌شود. | MESH | بله | - | +| `resolution` | وضوح بافت به پیکسل؛ هر تکسل یک مقدار انسداد دریافت می‌کند. پیش‌فرض: 1024. | INT | بله | 64 تا 8192 (گام 64) | +| `samples` | پرتوها به ازای هر تکسل. بیشتر = نرم‌تر، کندتر. اگر تصویر دانه‌دار بود افزایش دهید. پیش‌فرض: 64. | INT | بله | 4 تا 1024 (گام 4) | +| `max_distance` | طول پرتو، به‌صورت کسری از قطر جعبه محدودکننده. کوچک‌تر = انسداد موضعی‌تر و فشرده‌تر. پیش‌فرض: 0.5. | FLOAT | بله | 0.01 تا 2.0 (گام 0.01) | +| `strength` | مقیاس انسداد. >1 تیره‌تر، <1 روشن‌تر. پیش‌فرض: 1.0. | FLOAT | بله | 0.0 تا 2.0 (گام 0.05) | +| `bias` | ارتفاع نقطه شروع پرتو از سطح، به‌صورت کسری از قطر جعبه محدودکننده. اگر سطوح صاف لکه‌ها/حفره‌های تیره نشان دادند، افزایش دهید. پیش‌فرض: 0.01. | FLOAT | بله | 0.0001 تا 0.2 (گام 0.0005) | + +توجه: `low_poly` باید مختصات UV داشته باشد — این گره هرگز مش را UV باز نمی‌کند. اگر `high_poly` فقط یک آیتم دسته‌ای داشته باشد، برای هر آیتم دسته‌ای از `low_poly` دوباره استفاده می‌شود؛ آیتم‌های دسته‌ای `low_poly` که وجه ندارند نادیده گرفته شده و با یک تصویر تمام‌سفید جایگزین می‌شوند، همراه با ثبت یک هشدار. + +## خروجی‌ها + +| نام خروجی | توضیحات | نوع داده | +|-------------|-------------|-----------| +| `occlusion` | تصویر مقیاس خاکستری انسداد محیطی با مقادیر در [0,1] (سفید = باز، تیره = شکاف‌ها)، یک تصویر برای هر آیتم دسته‌ای از `low_poly`. برای ورودی occlusion گره Apply Texture To Mesh (که در نقشه ORM / occlusionTexture بسته‌بندی می‌شود) در نظر گرفته شده است. | IMAGE | + +> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeAmbientOcclusion/fa.md) + +--- +**Source fingerprint (SHA-256):** `63ea6ce5289728d351fdd7d722e9a299ebb1283e1128262a817466ec6d23786a` diff --git a/comfyui_embedded_docs/docs/BakeAmbientOcclusion/fr.md b/comfyui_embedded_docs/docs/BakeAmbientOcclusion/fr.md new file mode 100644 index 000000000..8a49563e8 --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeAmbientOcclusion/fr.md @@ -0,0 +1,28 @@ +# BakeAmbientOcclusion + +Génère une carte d'occlusion ambiante à partir d'un maillage high-poly dans la disposition UV d'un maillage low-poly. La sortie est une image en niveaux de gris dans laquelle les texels blancs sont ouverts et les texels sombres se trouvent dans les crevasses ; elle est destinée à l'entrée d'occlusion du nœud Apply Texture To Mesh. Connectez le maillage low-poly avec UV dépliés et le maillage high-poly à partir duquel il a été décimé. + +## Entrées + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `low_poly` | Le maillage low-poly avec UV dépliés dans lequel effectuer le baking. Doit avoir des UV ; le nœud génère une erreur s'ils sont manquants. | MESH | Oui | - | +| `high_poly` | Le maillage high-poly à partir duquel le low-poly a été décimé, utilisé comme géométrie source pour l'occlusion. | MESH | Oui | - | +| `resolution` | Résolution de la texture en pixels ; chaque texel reçoit une valeur d'occlusion. Par défaut : 1024. | INT | Oui | 64 à 8192 (pas de 64) | +| `samples` | Rayons par texel. Plus c'est élevé, plus c'est lisse, mais plus c'est lent. Augmentez si l'image est granuleuse. Par défaut : 64. | INT | Oui | 4 à 1024 (pas de 4) | +| `max_distance` | Longueur des rayons, en fraction de la diagonale de la boîte englobante. Plus la valeur est petite, plus l'occlusion est locale et resserrée. Par défaut : 0.5. | FLOAT | Oui | 0.01 à 2.0 (pas de 0.01) | +| `strength` | Met à l'échelle l'occlusion. >1 assombrit, <1 éclaircit. Par défaut : 1.0. | FLOAT | Oui | 0.0 à 2.0 (pas de 0.05) | +| `bias` | Élévation de l'origine des rayons au-dessus de la surface, en fraction de la diagonale de la boîte englobante. Augmentez si les surfaces planes présentent des taches/trous sombres. Par défaut : 0.01. | FLOAT | Oui | 0.0001 à 0.2 (pas de 0.0005) | + +Remarque : `low_poly` doit avoir des coordonnées UV — ce nœud ne déplie jamais le maillage. Si `high_poly` ne contient qu'un seul élément de lot, il est réutilisé pour chaque élément de lot de `low_poly` ; les éléments de lot de `low_poly` sans faces sont ignorés et remplacés par une image entièrement blanche, avec un avertissement consigné dans les journaux. + +## Sorties + +| Nom de sortie | Description | Type de données | +|---------------|-------------|-----------------| +| `occlusion` | Image d'occlusion ambiante en niveaux de gris avec des valeurs dans [0,1] (blanc = ouvert, sombre = crevasses), une image par élément de lot de `low_poly`. Destinée à l'entrée d'occlusion du nœud Apply Texture To Mesh (intégrée dans la carte ORM / occlusionTexture). | IMAGE | + +> Cette documentation a été générée par IA. Si vous trouvez des erreurs ou avez des suggestions d'amélioration, n'hésitez pas à contribuer ! [Modifier sur GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeAmbientOcclusion/fr.md) + +--- +**Source fingerprint (SHA-256):** `63ea6ce5289728d351fdd7d722e9a299ebb1283e1128262a817466ec6d23786a` diff --git a/comfyui_embedded_docs/docs/BakeAmbientOcclusion/ja.md b/comfyui_embedded_docs/docs/BakeAmbientOcclusion/ja.md new file mode 100644 index 000000000..33ac0b9da --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeAmbientOcclusion/ja.md @@ -0,0 +1,46 @@ +# BakeAmbientOcclusion + +Bakes an ambient-occlusion map from a high-poly mesh into the UV layout of a low-poly mesh. The output is a grayscale image in which white texels are open and dark texels are in crevices; it is meant for the Apply Texture To Mesh node's occlusion input. Connect the UV-unwrapped low-poly mesh and the high-poly mesh it was decimated from. + +ハイポリメッシュからアンビエントオクルージョンマップをベイクし、ローポリメッシュのUVレイアウトに焼き付けます。出力はグレースケール画像で、白いテクセルは開放領域、暗いテクセルは隙間やくぼみを示します。これは Apply Texture To Mesh ノードのオクルージョン入力用です。UV展開済みのローポリメッシュと、そのローポリメッシュのデシメーション元であるハイポリメッシュを接続してください。 + +## Inputs / 入力 + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `low_poly` | The UV-unwrapped low-poly mesh to bake into. Must have UVs; the node raises an error if they are missing. | MESH | Yes | - | +| `high_poly` | The high-poly mesh that the low-poly was decimated from, used as the source geometry for occlusion. | MESH | Yes | - | +| `resolution` | Texture resolution in pixels; each texel receives an occlusion value. Default: 1024. | INT | Yes | 64 to 8192 (step 64) | +| `samples` | Rays per texel. More = smoother, slower. Raise if grainy. Default: 64. | INT | Yes | 4 to 1024 (step 4) | +| `max_distance` | Ray length, as a fraction of the bounding box diagonal. Smaller = tighter, more local occlusion. Default: 0.5. | FLOAT | Yes | 0.01 to 2.0 (step 0.01) | +| `strength` | Scales the occlusion. >1 darkens, <1 lightens. Default: 1.0. | FLOAT | Yes | 0.0 to 2.0 (step 0.05) | +| `bias` | Ray origin lift off the surface, as a fraction of the bounding box diagonal. Raise if even surfaces show dark blotches/holes. Default: 0.01. | FLOAT | Yes | 0.0001 to 0.2 (step 0.0005) | + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `low_poly` | ベイク先となるUV展開済みローポリメッシュ。UVが必要です。UVがない場合、ノードはエラーを発生させます。 | MESH | はい | - | +| `high_poly` | ローポリのデシメーション元であるハイポリメッシュ。オクルージョンのソースジオメトリとして使用されます。 | MESH | はい | - | +| `resolution` | テクスチャ解像度(ピクセル単位)。各テクセルにオクルージョン値が割り当てられます。デフォルト: 1024。 | INT | はい | 64 to 8192 (step 64) | +| `samples` | テクセルあたりのレイ数。多いほど滑らかになりますが、遅くなります。ざらつきが目立つ場合は増やしてください。デフォルト: 64。 | INT | はい | 4 to 1024 (step 4) | +| `max_distance` | レイの長さ。バウンディングボックスの対角線に対する比率です。小さいほど密着した局所的なオクルージョンになります。デフォルト: 0.5。 | FLOAT | はい | 0.01 to 2.0 (step 0.01) | +| `strength` | オクルージョンをスケーリングします。1より大きいと暗く、1より小さいと明るくなります。デフォルト: 1.0。 | FLOAT | はい | 0.0 to 2.0 (step 0.05) | +| `bias` | サーフェスからのレイ起点の浮き上がり量。バウンディングボックスの対角線に対する比率です。平面にもかかわらず暗い斑点や穴が見られる場合は増やしてください。デフォルト: 0.01。 | FLOAT | はい | 0.0001 to 0.2 (step 0.0005) | + +Note: `low_poly` must have UV coordinates — this node never unwraps the mesh. If `high_poly` contains only one batch item, it is reused for every batch item of `low_poly`; batch items of `low_poly` with no faces are skipped and replaced with an all-white image, with a warning logged. + +注記: `low_poly` にはUV座標が必要です。このノードはメッシュをUV展開しません。`high_poly` にバッチ項目が1つしかない場合、`low_poly` のすべてのバッチ項目に対してそれが再利用されます。面がない `low_poly` のバッチ項目はスキップされ、警告がログに記録されたうえで全白画像に置き換えられます。 + +## Outputs / 出力 + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `occlusion` | Grayscale ambient-occlusion image with values in [0,1] (white = open, dark = crevices), one image per batch item of `low_poly`. Intended for the Apply Texture To Mesh node's occlusion input (packed into the ORM map / occlusionTexture). | IMAGE | + +| 出力名 | 説明 | データ型 | +|-------------|-------------|-----------| +| `occlusion` | 値が[0,1]のグレースケールのアンビエントオクルージョン画像(白=開放、暗=くぼみ)。`low_poly` のバッチ項目ごとに1枚の画像が生成されます。Apply Texture To Mesh ノードのオクルージョン入力(ORMマップ / occlusionTexture にパックされる)を想定しています。 | IMAGE | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeAmbientOcclusion/ja.md) + +--- +**Source fingerprint (SHA-256):** `63ea6ce5289728d351fdd7d722e9a299ebb1283e1128262a817466ec6d23786a` diff --git a/comfyui_embedded_docs/docs/BakeAmbientOcclusion/ko.md b/comfyui_embedded_docs/docs/BakeAmbientOcclusion/ko.md new file mode 100644 index 000000000..01fa5b8d4 --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeAmbientOcclusion/ko.md @@ -0,0 +1,28 @@ +# BakeAmbientOcclusion + +하이폴리 메시에서 앰비언트 오클루전 맵을 베이크하여 로우폴리 메시의 UV 레이아웃에 적용합니다. 출력은 흰색 텍셀이 열린 영역이고 어두운 텍션이 틈새 영역인 회색조 이미지입니다. 이는 Apply Texture To Mesh 노드의 오클루전 입력을 위한 것입니다. UV가 펼쳐진 로우폴리 메시와 해당 메시가 디시메이션된 하이폴리 메시를 연결하십시오. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `low_poly` | UV가 펼쳐진 로우폴리 메시로, 베이크 대상입니다. UV가 있어야 하며, UV가 없으면 노드에서 오류가 발생합니다. | MESH | 예 | - | +| `high_poly` | 로우폴리가 디시메이션된 하이폴리 메시로, 오클루전의 소스 지오메트리로 사용됩니다. | MESH | 예 | - | +| `resolution` | 픽셀 단위의 텍스처 해상도입니다. 각 텍셀은 오클루전 값을 받습니다. 기본값: 1024. | INT | 예 | 64 to 8192 (step 64) | +| `samples` | 텍셀당 광선 수입니다. 많을수록 더 부드러워지고 느려집니다. 노이즈가 심하면 값을 높이십시오. 기본값: 64. | INT | 예 | 4 to 1024 (step 4) | +| `max_distance` | 광선 길이로, 경계 상자 대각선의 비율입니다. 값이 작을수록 더 타이트하고 국소적인 오클루전이 생성됩니다. 기본값: 0.5. | FLOAT | 예 | 0.01 to 2.0 (step 0.01) | +| `strength` | 오클루전 강도를 조정합니다. 1보다 크면 어두워지고, 1보다 작으면 밝아집니다. 기본값: 1.0. | FLOAT | 예 | 0.0 to 2.0 (step 0.05) | +| `bias` | 광선 원점의 표면 이격 거리로, 경계 상자 대각선의 비율입니다. 평평한 표면에 어두운 반점이나 구멍이 보이면 값을 높이십시오. 기본값: 0.01. | FLOAT | 예 | 0.0001 to 0.2 (step 0.0005) | + +참고: `low_poly`에는 UV 좌표가 있어야 합니다. 이 노드는 메시를 언랩하지 않습니다. `high_poly`에 배치 항목이 하나만 있으면 `low_poly`의 모든 배치 항목에 대해 해당 항목이 재사용됩니다. 면이 없는 `low_poly`의 배치 항목은 건너뛰고, 경고를 기록한 후 모두 흰색 이미지로 대체됩니다. + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `occlusion` | [0,1] 범위의 값을 갖는 회색조 앰비언트 오클루전 이미지입니다(흰색 = 열린 영역, 어두운 색 = 틈새). `low_poly`의 배치 항목당 하나의 이미지가 생성됩니다. Apply Texture To Mesh 노드의 오클루전 입력(ORM 맵 / occlusionTexture에 패킹됨)에 사용하기 위한 것입니다. | IMAGE | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeAmbientOcclusion/ko.md) + +--- +**Source fingerprint (SHA-256):** `63ea6ce5289728d351fdd7d722e9a299ebb1283e1128262a817466ec6d23786a` diff --git a/comfyui_embedded_docs/docs/BakeAmbientOcclusion/pt-BR.md b/comfyui_embedded_docs/docs/BakeAmbientOcclusion/pt-BR.md new file mode 100644 index 000000000..ea4128778 --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeAmbientOcclusion/pt-BR.md @@ -0,0 +1,28 @@ +# BakeAmbientOcclusion + +Gera um mapa de oclusão ambiente a partir de uma malha de alta poligonalidade no layout UV de uma malha de baixa poligonalidade. A saída é uma imagem em escala de cinza em que texels brancos representam áreas abertas e texels escuros representam frestas; o mapa é destinado à entrada de oclusão do nó Apply Texture To Mesh. Conecte a malha de baixa poligonalidade com UVs desembrulhados e a malha de alta poligonalidade da qual ela foi decimada. + +## Entradas + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Range | +|-----------|-------------|-----------|----------|-------| +| `low_poly` | A malha de baixa poligonalidade com UVs desembrulhados usada para gerar o mapa. Precisa ter UVs; o nó gera um erro se eles estiverem ausentes. | MESH | Sim | - | +| `high_poly` | A malha de alta poligonalidade da qual a malha de baixa poligonalidade foi decimada, usada como geometria de origem para a oclusão. | MESH | Sim | - | +| `resolution` | Resolução da textura em pixels; cada texel recebe um valor de oclusão. Padrão: 1024. | INT | Sim | 64 a 8192 (passo 64) | +| `samples` | Raios por texel. Mais raios = resultado mais suave, porém mais lento. Aumente se houver granulação. Padrão: 64. | INT | Sim | 4 a 1024 (passo 4) | +| `max_distance` | Comprimento do raio, como fração da diagonal do bounding box. Valores menores = oclusão mais localizada e restrita. Padrão: 0,5. | FLOAT | Sim | 0,01 a 2,0 (passo 0,01) | +| `strength` | Escala a oclusão. >1 escurece, <1 clareia. Padrão: 1,0. | FLOAT | Sim | 0,0 a 2,0 (passo 0,05) | +| `bias` | Elevação da origem do raio em relação à superfície, como fração da diagonal do bounding box. Aumente se superfícies planas apresentarem manchas ou buracos escuros. Padrão: 0,01. | FLOAT | Sim | 0,0001 a 0,2 (passo 0,0005) | + +Nota: `low_poly` deve ter coordenadas UV — este nó nunca desembrulha a malha. Se `high_poly` contiver apenas um item de lote, ele será reutilizado para todos os itens de lote de `low_poly`; itens de lote de `low_poly` sem faces são ignorados e substituídos por uma imagem totalmente branca, com um aviso registrado no log. + +## Saídas + +| Nome da Saída | Descrição | Tipo de Dados | +|-------------|-------------|-----------| +| `occlusion` | Imagem de oclusão ambiente em escala de cinza com valores em [0,1] (branco = aberto, escuro = frestas), uma imagem por item de lote de `low_poly`. Destinada à entrada de oclusão do nó Apply Texture To Mesh (empacotada no mapa ORM / occlusionTexture). | IMAGE | + +> Esta documentação foi gerada por IA. Se você encontrar erros ou tiver sugestões de melhoria, sinta-se à vontade para contribuir! [Editar no GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeAmbientOcclusion/pt-BR.md) + +--- +**Source fingerprint (SHA-256):** `63ea6ce5289728d351fdd7d722e9a299ebb1283e1128262a817466ec6d23786a` diff --git a/comfyui_embedded_docs/docs/BakeAmbientOcclusion/ru.md b/comfyui_embedded_docs/docs/BakeAmbientOcclusion/ru.md new file mode 100644 index 000000000..14dd26128 --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeAmbientOcclusion/ru.md @@ -0,0 +1,28 @@ +# BakeAmbientOcclusion + +Запекает карту окружающего затенения из высокополигональной сетки в UV-развёртку низкополигональной сетки. На выходе получается полутоновое изображение, в котором белые тексели обозначают открытые участки, а тёмные — углубления; оно предназначено для входа occlusion узла Apply Texture To Mesh. Подключите низкополигональную сетку с UV-развёрткой и высокополигональную сетку, из которой она была получена. + +## Входные параметры + +| Параметр | Описание | Тип данных | Обязательный | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `low_poly` | Низкополигональная сетка с UV-развёрткой, в которую выполняется запекание. Должна иметь UV-координаты; при их отсутствии узел выдаёт ошибку. | MESH | Да | - | +| `high_poly` | Высокополигональная сетка, из которой низкополигональная была получена децимацией; используется как исходная геометрия для затенения. | MESH | Да | - | +| `resolution` | Разрешение текстуры в пикселях; каждый тексель получает значение затенения. По умолчанию: 1024. | INT | Да | 64 to 8192 (step 64) | +| `samples` | Количество лучей на тексель. Больше — плавнее, но медленнее. Увеличьте, если появляется зернистость. По умолчанию: 64. | INT | Да | 4 to 1024 (step 4) | +| `max_distance` | Длина луча в долях диагонали ограничивающей рамки. Меньше — плотнее, более локальное затенение. По умолчанию: 0.5. | FLOAT | Да | 0.01 to 2.0 (step 0.01) | +| `strength` | Масштабирует затенение. >1 затемняет, <1 осветляет. По умолчанию: 1.0. | FLOAT | Да | 0.0 to 2.0 (step 0.05) | +| `bias` | Подъём начала луча над поверхностью в долях диагонали ограничивающей рамки. Увеличьте, если на ровных поверхностях появляются тёмные пятна/отверстия. По умолчанию: 0.01. | FLOAT | Да | 0.0001 to 0.2 (step 0.0005) | + +Примечание: `low_poly` должна иметь UV-координаты — этот узел никогда не выполняет развёртку сетки. Если `high_poly` содержит только один элемент батча, он повторно используется для каждого элемента батча `low_poly`; элементы батча `low_poly`, не имеющие граней, пропускаются и заменяются полностью белым изображением, при этом в журнал записывается предупреждение. + +## Выходные параметры + +| Имя выхода | Описание | Тип данных | +|-------------|-------------|-----------| +| `occlusion` | Полутоновое изображение окружающего затенения со значениями в [0,1] (белый — открытые участки, тёмный — углубления), по одному изображению на каждый элемент батча `low_poly`. Предназначено для входа occlusion узла Apply Texture To Mesh (упаковывается в ORM-карту / occlusionTexture). | IMAGE | + +> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeAmbientOcclusion/ru.md) + +--- +**Source fingerprint (SHA-256):** `63ea6ce5289728d351fdd7d722e9a299ebb1283e1128262a817466ec6d23786a` diff --git a/comfyui_embedded_docs/docs/BakeAmbientOcclusion/tr.md b/comfyui_embedded_docs/docs/BakeAmbientOcclusion/tr.md new file mode 100644 index 000000000..0cf0c0bed --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeAmbientOcclusion/tr.md @@ -0,0 +1,28 @@ +# BakeAmbientOcclusion + +A high-poly mesh'ten düşük poly mesh'in UV yerleşimine bir ambient-occlusion haritası üretir. Çıktı, beyaz teksellerin açık ve koyu teksellerin çatlaklarda olduğu gri tonlamalı bir görüntüdür; Apply Texture To Mesh düğümünün occlusion girişi için tasarlanmıştır. UV açılımı yapılmış düşük poly mesh'i ve ondan sadeleştirilmiş yüksek poly mesh'i bağlayın. + +## Girdiler + +| Parametre | Açıklama | Veri Türü | Zorunlu | Aralık | +|-----------|-------------|-----------|----------|-------| +| `low_poly` | İçine bake yapılacak UV açılımı yapılmış düşük poly mesh. UV koordinatlarına sahip olmalıdır; eksiklerse düğüm hata verir. | MESH | Evet | - | +| `high_poly` | Düşük poly mesh'in sadeleştirildiği yüksek poly mesh; occlusion için kaynak geometri olarak kullanılır. | MESH | Evet | - | +| `resolution` | Piksel cinsinden doku çözünürlüğü; her teksel bir occlusion değeri alır. Varsayılan: 1024. | INT | Evet | 64 ila 8192 (adım 64) | +| `samples` | Teksel başına ışın sayısı. Daha yüksek = daha pürüzsüz, daha yavaş. Grenli görünüyorsa artırın. Varsayılan: 64. | INT | Evet | 4 ila 1024 (adım 4) | +| `max_distance` | Işın uzunluğu, sınırlayıcı kutu köşegeninin bir kesri olarak. Daha küçük = daha sıkı, daha yerel occlusion. Varsayılan: 0.5. | FLOAT | Evet | 0.01 ila 2.0 (adım 0.01) | +| `strength` | Occlusion değerini ölçekler. >1 koyulaştırır, <1 açıklaştırır. Varsayılan: 1.0. | FLOAT | Evet | 0.0 ila 2.0 (adım 0.05) | +| `bias` | Işın başlangıç noktasının yüzeyden kaldırılması, sınırlayıcı kutu köşegeninin bir kesri olarak. Düz yüzeylerde bile koyu lekeler/delikler görünüyorsa artırın. Varsayılan: 0.01. | FLOAT | Evet | 0.0001 ila 0.2 (adım 0.0005) | + +Not: `low_poly` UV koordinatlarına sahip olmalıdır — bu düğüm mesh'i asla UV açılımı yapmaz. `high_poly` yalnızca bir batch öğesi içeriyorsa, `low_poly`'nin her batch öğesi için yeniden kullanılır; yüzü olmayan `low_poly` batch öğeleri atlanır ve bir uyarı günlüğe kaydedilerek tamamen beyaz bir görüntüyle değiştirilir. + +## Çıktılar + +| Çıktı Adı | Açıklama | Veri Türü | +|-------------|-------------|-----------| +| `occlusion` | [0,1] aralığında değerlere sahip gri tonlamalı ambient-occlusion görüntüsü (beyaz = açık, koyu = çatlaklar), `low_poly`'nin her batch öğesi için bir görüntü. Apply Texture To Mesh düğümünün occlusion girişi için tasarlanmıştır (ORM haritasına / occlusionTexture'a paketlenir). | IMAGE | + +> Bu belge yapay zeka tarafından oluşturulmuştur. Herhangi bir hata bulursanız veya iyileştirme önerileriniz varsa, katkıda bulunmaktan çekinmeyin! [GitHub'da Düzenle](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeAmbientOcclusion/tr.md) + +--- +**Source fingerprint (SHA-256):** `63ea6ce5289728d351fdd7d722e9a299ebb1283e1128262a817466ec6d23786a` diff --git a/comfyui_embedded_docs/docs/BakeAmbientOcclusion/zh-TW.md b/comfyui_embedded_docs/docs/BakeAmbientOcclusion/zh-TW.md new file mode 100644 index 000000000..9131c9c8e --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeAmbientOcclusion/zh-TW.md @@ -0,0 +1,28 @@ +# BakeAmbientOcclusion + +將環境光遮蔽(ambient occlusion)貼圖從高多邊形網格(high-poly mesh)烘焙到低多邊形網格(low-poly mesh)的 UV 佈局中。輸出是一張灰階影像,其中白色紋素(texel)代表開放區域,深色紋素代表裂縫處;此影像用於「Apply Texture To Mesh」節點的 occlusion 輸入。請連接已展開 UV 的低多邊形網格,以及用於精簡出該低多邊形網格的高多邊形網格。 + +## 輸入 + +| 參數 | 描述 | 資料類型 | 必要 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `low_poly` | 要烘焙到的已展開 UV 的低多邊形網格。必須具有 UV;如果缺少 UV,節點會產生錯誤。 | MESH | 是 | - | +| `high_poly` | 低多邊形網格所精簡自的高多邊形網格,作為遮蔽的來源幾何。 | MESH | 是 | - | +| `resolution` | 紋理解析度(像素);每個紋素會接收一個遮蔽值。預設值:1024。 | INT | 是 | 64 to 8192 (step 64) | +| `samples` | 每個紋素的光線數。越多 = 越平滑,但越慢。如有顆粒感可提高此值。預設值:64。 | INT | 是 | 4 to 1024 (step 4) | +| `max_distance` | 光線長度,以邊界框對角線的比例表示。越小 = 更緊密、更局部的遮蔽。預設值:0.5。 | FLOAT | 是 | 0.01 to 2.0 (step 0.01) | +| `strength` | 縮放遮蔽強度。>1 變暗,<1 變亮。預設值:1.0。 | FLOAT | 是 | 0.0 to 2.0 (step 0.05) | +| `bias` | 光線原點從表面抬升的距離,以邊界框對角線的比例表示。如果平坦表面出現深色斑點或孔洞,請提高此值。預設值:0.01。 | FLOAT | 是 | 0.0001 to 0.2 (step 0.0005) | + +注意:`low_poly` 必須具有 UV 座標——此節點永遠不會展開網格。如果 `high_poly` 僅包含一個批次項目,則它會對 `low_poly` 的每個批次項目重複使用;`low_poly` 中沒有面的批次項目會被略過,並以全白影像替代,同時記錄警告。 + +## 輸出 + +| 輸出名稱 | 描述 | 資料類型 | +|-------------|-------------|-----------| +| `occlusion` | 灰階環境光遮蔽影像,數值範圍在 [0,1](白色 = 開放,深色 = 裂縫),每個 `low_poly` 批次項目對應一張影像。用於「Apply Texture To Mesh」節點的 occlusion 輸入(封裝在 ORM 貼圖 / occlusionTexture 中)。 | IMAGE | + +> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeAmbientOcclusion/zh-TW.md) + +--- +**Source fingerprint (SHA-256):** `63ea6ce5289728d351fdd7d722e9a299ebb1283e1128262a817466ec6d23786a` diff --git a/comfyui_embedded_docs/docs/BakeAmbientOcclusion/zh.md b/comfyui_embedded_docs/docs/BakeAmbientOcclusion/zh.md new file mode 100644 index 000000000..1a140fd28 --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeAmbientOcclusion/zh.md @@ -0,0 +1,28 @@ +# BakeAmbientOcclusion + +将高多边形网格的环境光遮蔽贴图烘焙到低多边形网格的 UV 布局中。输出是灰度图像,其中白色纹素表示开放区域,深色纹素表示裂缝;此输出用于 Apply Texture To Mesh 节点的遮挡输入。连接已展开 UV 的低多边形网格以及从中减面得到的高多边形网格。 + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `low_poly` | 要烘焙到的已展开 UV 的低多边形网格。必须具有 UV;如果缺少 UV,节点将报错。 | MESH | Yes | - | +| `high_poly` | 低多边形网格减面自的高多边形网格,用作遮挡的源几何体。 | MESH | Yes | - | +| `resolution` | 纹理分辨率(以像素为单位);每个纹素都会得到一个遮挡值。默认值:1024。 | INT | Yes | 64 to 8192 (step 64) | +| `samples` | 每个纹素的射线数。更多射线 = 更平滑、更慢。如果颗粒感明显,请增大此值。默认值:64。 | INT | Yes | 4 to 1024 (step 4) | +| `max_distance` | 射线长度,以包围盒对角线长度的比例表示。较小值 = 更紧密、更局部的遮挡。默认值:0.5。 | FLOAT | Yes | 0.01 to 2.0 (step 0.01) | +| `strength` | 缩放遮挡强度。>1 变暗,<1 变亮。默认值:1.0。 | FLOAT | Yes | 0.0 to 2.0 (step 0.05) | +| `bias` | 射线起点抬离表面的距离,以包围盒对角线长度的比例表示。如果平坦表面出现暗斑/孔洞,请增大此值。默认值:0.01。 | FLOAT | Yes | 0.0001 to 0.2 (step 0.0005) | + +注意:`low_poly` 必须具有 UV 坐标——此节点永远不会对网格进行 UV 展开。如果 `high_poly` 仅包含一个批次项,则它会为 `low_poly` 的每个批次项重用;对于没有面的 `low_poly` 批次项,将跳过,替换为全白图像,并记录一条警告。 + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `occlusion` | 灰度环境光遮蔽图像,值在 [0,1] 范围内(白色 = 开放,深色 = 裂缝),`low_poly` 每个批次项对应一张图像。用于 Apply Texture To Mesh 节点的遮挡输入(打包到 ORM 贴图 / occlusionTexture 中)。 | IMAGE | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeAmbientOcclusion/zh.md) + +--- +**Source fingerprint (SHA-256):** `63ea6ce5289728d351fdd7d722e9a299ebb1283e1128262a817466ec6d23786a` diff --git a/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/ar.md b/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/ar.md new file mode 100644 index 000000000..9abd16b40 --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/ar.md @@ -0,0 +1,26 @@ +# BakeNormalMapFromMesh + +يقوم هذا الكائن (العقدة) بإنشاء خريطة معايير فضاء المماس (tangent-space normal map) من شبكة عالية الدقة إلى تخطيط UV لشبكة منخفضة الدقة، لالتقاط تفاصيل السطح المفقودة أثناء التبسيط (decimation). قم بتوصيل الشبكة منخفضة الدقة ذات تفكيك UV والشبكة عالية الدقة التي اشتُقت منها، ويُخرج الكائن صورة جاهزة لإدخال `normal_map` في عقدة Apply Texture To Mesh. + +## المدخلات + +| المعامل | الوصف | نوع البيانات | مطلوب | المدى | +|-----------|-------------|-----------|----------|-------| +| `low_poly` | الشبكة منخفضة الدقة المكسوة بـ UV والتي تستقبل التفاصيل المخبوزة. يجب أن تحتوي على إحداثيات UV موجودة مسبقًا؛ لا تقوم العقدة أبدًا بإنشاء تخطيط UV. | MESH | نعم | — | +| `high_poly` | الشبكة عالية الدقة التي تُخبز تفاصيل سطحها في تخطيط UV الخاص بالشبكة منخفضة الدقة. | MESH | نعم | — | +| `resolution` | طول الحافة بالبكسل لخريطة النورمال المربعة الناتجة (الافتراضي: 1024). | INT | نعم | 64 to 8192 (step 64) | +| `cage_distance` | نطاق البحث عن السطح، ككسر من قطر الصندوق المحيط. ارفعه عند ظهور بقع خاطئة أو مفقودة عند التبسيط الشديد؛ اخفضه إذا كان يلتقط عبر الفجوات. الافتراضي: 0.05. | FLOAT | نعم | 0.001 to 0.5 (step 0.001) | +| `ignore_backfaces` | تخطي الأسطح عالية الدقة الموجهة بعيدًا عن البكسل النسيجي (texel)، بحيث لا تلتقط الشقوق أو المساحات المغلقة الجدار المقابل. عطّلها فقط إذا كان اتجاه لفّ الشبكة عالية الدقة غير متناسق. الافتراضي: true. | BOOLEAN | نعم | true / false | + +ملاحظة: يجب أن يحتوي `low_poly` على إحداثيات UV. إذا لم يتوفر أي منها، يرفع الكائن خطأً لأنه يخبز على تخطيط UV الموجود ولا يقوم بفك الشبكة. عندما يكون `low_poly` دفعة (batch)، يتم خبز كل عنصر بالترتيب؛ إذا كان `high_poly` يحتوي على عنصر واحد فقط، يُعاد استخدام ذلك العنصر لكل عنصر في الدفعة. يتم تخطي الشبكات الفارغة في الدفعة مع تحذير، وينتج عنها خريطة نورمال مسطحة رمادية متوسطة (0.5). + +## المخرجات + +| اسم المخرج | الوصف | نوع البيانات | +|-------------|-------------|-----------| +| `normal_map` | خريطة النورمال النهائية في فضاء المماس (باستخدام اصطلاح glTF/OpenGL +Y) كصورة RGB مربعة بدقة resolution × resolution بقيم في [0,1]. قم بتوصيلها بإدخال `normal_map` الخاص بـ Apply Texture To Mesh. | IMAGE | + +> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/ar.md) + +--- +**Source fingerprint (SHA-256):** `29df10014b5998b741d71db21d0c982d7bca85ad966a720063af15062e203322` diff --git a/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/en.md b/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/en.md new file mode 100644 index 000000000..819220ae4 --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/en.md @@ -0,0 +1,26 @@ +# BakeNormalMapFromMesh + +This node bakes a tangent-space normal map from a high-poly mesh onto a low-poly mesh's UV layout, capturing surface detail that was lost during decimation. Connect the UV-unwrapped low-poly mesh and the high-poly mesh it came from, and the node outputs an image ready for the `normal_map` input of Apply Texture To Mesh. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `low_poly` | The UV-unwrapped low-poly mesh that receives the baked detail. Must have existing UVs; the node never unwraps. | MESH | Yes | — | +| `high_poly` | The high-poly mesh whose surface detail is baked into the low-poly's UV layout. | MESH | Yes | — | +| `resolution` | Edge length in pixels of the square output normal map (default: 1024). | INT | Yes | 64 to 8192 (step 64) | +| `cage_distance` | Surface search band, as a fraction of the bounding box diagonal. Raise for wrong/missing patches under heavy decimation; lower if it grabs across gaps. Default: 0.05. | FLOAT | Yes | 0.001 to 0.5 (step 0.001) | +| `ignore_backfaces` | Skip high-poly surfaces facing away from the texel, so crevices/enclosed spaces don't grab the opposite wall. Disable only if the high-poly winding is inconsistent. Default: true. | BOOLEAN | Yes | true / false | + +Note: `low_poly` must have UV coordinates. If it has none, the node raises an error because it bakes onto the existing UV layout and does not unwrap the mesh. When `low_poly` is a batch, each item is baked in order; if `high_poly` contains only one item, that item is reused for every batch item. Empty meshes in the batch are skipped with a warning and produce a flat mid-gray (0.5) normal map. + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `normal_map` | The baked tangent-space normal map (glTF/OpenGL +Y convention) as a square resolution × resolution RGB image with values in [0,1]. Connect it to the `normal_map` input of Apply Texture To Mesh. | IMAGE | + +> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/en.md) + +--- +**Source fingerprint (SHA-256):** `29df10014b5998b741d71db21d0c982d7bca85ad966a720063af15062e203322` diff --git a/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/es.md b/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/es.md new file mode 100644 index 000000000..662c5421d --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/es.md @@ -0,0 +1,26 @@ +# BakeNormalMapFromMesh + +Este nodo hornea un mapa de normales en espacio tangente desde una malla de alta poligonización sobre la disposición de UV de una malla de baja poligonización, capturando el detalle de superficie que se perdió durante la decimación. Conecta la malla low-poly con UV desenvueltos y la malla high-poly de la que proviene, y el nodo generará una imagen lista para la entrada `normal_map` de Apply Texture To Mesh. + +## Entradas + +| Parámetro | Descripción | Tipo de datos | Requerido | Rango | +|-----------|-------------|---------------|-----------|-------| +| `low_poly` | La malla low-poly con UV desenvueltos que recibe el detalle horneado. Debe tener UV existentes; el nodo nunca desenvuelve. | MESH | Sí | — | +| `high_poly` | La malla high-poly cuyo detalle de superficie se hornea en la disposición de UV de la malla low-poly. | MESH | Sí | — | +| `resolution` | Longitud del lado en píxeles del mapa de normales cuadrado de salida (valor predeterminado: 1024). | INT | Sí | 64 a 8192 (paso 64) | +| `cage_distance` | Banda de búsqueda de superficie, como fracción de la diagonal de la caja delimitadora. Auméntala si hay parches incorrectos o faltantes bajo una decimación fuerte; redúcela si captura superficie a través de huecos. Valor predeterminado: 0.05. | FLOAT | Sí | 0.001 a 0.5 (paso 0.001) | +| `ignore_backfaces` | Omite las superficies high-poly que miran en dirección opuesta al texel, de modo que las grietas o los espacios cerrados no capturen la pared opuesta. Desactívalo solo si el orden de los vértices de la malla high-poly es inconsistente. Valor predeterminado: true. | BOOLEAN | Sí | true / false | + +Nota: `low_poly` debe tener coordenadas UV. Si no tiene ninguna, el nodo genera un error porque hornea sobre la disposición de UV existente y no desenvuelve la malla. Cuando `low_poly` es un lote, cada elemento se hornea en orden; si `high_poly` contiene solo un elemento, ese elemento se reutiliza para cada elemento del lote. Las mallas vacías en el lote se omiten con una advertencia y producen un mapa de normales gris medio plano (0.5). + +## Salidas + +| Nombre de salida | Descripción | Tipo de datos | +|------------------|-------------|---------------| +| `normal_map` | El mapa de normales en espacio tangente horneado (convención glTF/OpenGL +Y) como una imagen RGB cuadrada de resolución × resolución con valores en [0,1]. Conéctalo a la entrada `normal_map` de Apply Texture To Mesh. | IMAGE | + +> Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/es.md) + +--- +**Source fingerprint (SHA-256):** `29df10014b5998b741d71db21d0c982d7bca85ad966a720063af15062e203322` diff --git a/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/fa.md b/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/fa.md new file mode 100644 index 000000000..5d0dd03c6 --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/fa.md @@ -0,0 +1,26 @@ +# BakeNormalMapFromMesh + +این گره یک نقشه نرمال فضای مماس را از یک مش پرجزئیات (high-poly) روی چیدمان UV مش کم‌جزئیات (low-poly) می‌پزد و جزئیات سطحی را که در هنگام کاهش چندضلعی‌ها از دست رفته‌اند، ثبت می‌کند. مش کم‌جزئیات دارای UV و مش پرجزئیاتی را که از آن گرفته شده است وصل کنید؛ گره تصویری آماده برای ورودی `normal_map` گره Apply Texture To Mesh خروجی می‌دهد. + +## ورودی‌ها + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `low_poly` | مش کم‌جزئیات UV-بازشده که جزئیات پخته‌شده را دریافت می‌کند. باید UV موجود داشته باشد؛ این گره هرگز UV را باز نمی‌کند. | MESH | بله | — | +| `high_poly` | مش پرجزئیاتی که جزئیات سطح آن در چیدمان UV مش کم‌جزئیات پخته می‌شود. | MESH | بله | — | +| `resolution` | طول ضلع بر حسب پیکسل نقشه نرمال خروجی مربعی (پیش‌فرض: 1024). | INT | بله | 64 to 8192 (step 64) | +| `cage_distance` | نوار جستجوی سطح، به صورت کسری از قطر جعبه محدودکننده. برای بخش‌های نادرست/گم‌شده در کاهش چندضلعی شدید، آن را افزایش دهید؛ اگر از میان شکاف‌ها برداشت می‌کند، کاهش دهید. پیش‌فرض: 0.05. | FLOAT | بله | 0.001 to 0.5 (step 0.001) | +| `ignore_backfaces` | سطوح پرجزئیاتی را که رو به دور از تکسِل هستند نادیده می‌گیرد، بنابراین شکاف‌ها/فضاهای بسته دیوار مقابل را نمی‌گیرند. فقط در صورت ناسازگار بودن جهت پیچش (winding) مش پرجزئیات آن را غیرفعال کنید. پیش‌فرض: true. | BOOLEAN | بله | true / false | + +توجه: `low_poly` باید مختصات UV داشته باشد. اگر نداشته باشد، گره خطا می‌دهد، زیرا روی چیدمان UV موجود می‌پزد و مش را باز نمی‌کند. وقتی `low_poly` یک دسته (batch) باشد، هر آیتم به ترتیب پخته می‌شود؛ اگر `high_poly` فقط یک آیتم داشته باشد، آن آیتم برای هر آیتم دسته دوباره استفاده می‌شود. مش‌های خالی در دسته با هشدار نادیده گرفته می‌شوند و یک نقشه نرمال خاکستری میانی صاف (0.5) تولید می‌کنند. + +## خروجی‌ها + +| نام خروجی | توضیحات | نوع داده | +|-------------|-------------|-----------| +| `normal_map` | نقشه نرمال فضای مماس پخته‌شده (قرارداد glTF/OpenGL +Y) به صورت یک تصویر RGB مربعی با ابعاد resolution × resolution که مقادیر آن در بازه [0,1] است. آن را به ورودی `normal_map` گره Apply Texture To Mesh وصل کنید. | IMAGE | + +> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/fa.md) + +--- +**Source fingerprint (SHA-256):** `29df10014b5998b741d71db21d0c982d7bca85ad966a720063af15062e203322` diff --git a/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/fr.md b/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/fr.md new file mode 100644 index 000000000..c999fa89c --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/fr.md @@ -0,0 +1,26 @@ +# BakeNormalMapFromMesh + +Ce nœud cuit une carte normale tangentielle à partir d’un maillage haute poly sur la disposition UV d’un maillage basse poly, capturant les détails de surface perdus lors de la décimation. Connectez le maillage basse poly avec UV déroulés et le maillage haute poly dont il est issu, et le nœud génère une image prête pour l’entrée `normal_map` de Apply Texture To Mesh. + +## Entrées + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------|----------|-------| +| `low_poly` | Le maillage basse poly avec UV déroulés qui reçoit le détail cuit. Doit avoir des UV existants ; le nœud ne déroule jamais. | MESH | Oui | — | +| `high_poly` | Le maillage haute poly dont les détails de surface sont cuits dans la disposition UV du basse poly. | MESH | Oui | — | +| `resolution` | Longueur de côté en pixels de la carte normale carrée de sortie (par défaut : 1024). | INT | Oui | 64 à 8192 (pas de 64) | +| `cage_distance` | Bande de recherche de surface, en fraction de la diagonale de la boîte englobante. Augmentez-la pour les zones incorrectes ou manquantes après une décimation importante ; diminuez-la si elle capture à travers les espaces. Par défaut : 0.05. | FLOAT | Oui | 0.001 à 0.5 (pas de 0.001) | +| `ignore_backfaces` | Ignore les surfaces haute poly orientées à l’opposé du texel, afin que les crevasses/espaces fermés ne capturent pas la paroi opposée. Désactivez uniquement si l’orientation des faces du maillage haute poly est incohérente. Par défaut : true. | BOOLEAN | Oui | true / false | + +Note : `low_poly` doit avoir des coordonnées UV. S’il n’en a pas, le nœud lève une erreur car il cuit sur la disposition UV existante et ne déroule pas le maillage. Lorsque `low_poly` est un lot, chaque élément est cuit dans l’ordre ; si `high_poly` ne contient qu’un seul élément, cet élément est réutilisé pour chaque élément du lot. Les maillages vides du lot sont ignorés avec un avertissement et produisent une carte normale gris moyen (0.5) uniforme. + +## Sorties + +| Nom de sortie | Description | Type de données | +|-------------|-------------|-----------| +| `normal_map` | La carte normale tangentielle cuite (convention glTF/OpenGL +Y) sous forme d’image RGB carrée de résolution × résolution avec des valeurs dans [0,1]. Connectez-la à l’entrée `normal_map` de Apply Texture To Mesh. | IMAGE | + +> Cette documentation a été générée par IA. Si vous trouvez des erreurs ou avez des suggestions d'amélioration, n'hésitez pas à contribuer ! [Modifier sur GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/fr.md) + +--- +**Source fingerprint (SHA-256):** `29df10014b5998b741d71db21d0c982d7bca85ad966a720063af15062e203322` diff --git a/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/ja.md b/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/ja.md new file mode 100644 index 000000000..550e648ee --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/ja.md @@ -0,0 +1,26 @@ +# BakeNormalMapFromMesh + +このノードは、ハイポリメッシュからローポリメッシュのUVレイアウトへタンジェント空間ノーマルマップをベイクし、デシメーション中に失われた表面ディテールをキャプチャします。UV展開済みのローポリメッシュと、その元となったハイポリメッシュを接続すると、ノードはApply Texture To Meshの`normal_map`入力にそのまま使用できる画像を出力します。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|------|----------|------|------| +| `low_poly` | ベイクされたディテールを受け取るUV展開済みのローポリメッシュ。既存のUVが必要です。ノードは自動ではUV展開しません。 | MESH | はい | — | +| `high_poly` | ローポリのUVレイアウトにベイクされる表面ディテールを持つハイポリメッシュ。 | MESH | はい | — | +| `resolution` | 正方形の出力ノーマルマップのピクセル単位の辺の長さ(デフォルト: 1024)。 | INT | はい | 64 to 8192 (step 64) | +| `cage_distance` | バウンディングボックスの対角線に対するサーフェス検索帯域の比率。大幅なデシメーションで誤ったパッチや欠落が発生する場合は値を上げ、隙間を越えて取得する場合は下げてください。デフォルト: 0.05。 | FLOAT | はい | 0.001 to 0.5 (step 0.001) | +| `ignore_backfaces` | テクセルから背を向けているハイポリサーフェスをスキップし、隙間や密閉空間が反対側の壁を取得しないようにします。ハイポリの巻き順が一貫していない場合にのみ無効にしてください。デフォルト: true。 | BOOLEAN | はい | true / false | + +注: `low_poly`にはUV座標が必要です。UV座標がない場合、ノードは既存のUVレイアウトにベイクしメッシュを展開しないため、エラーを発生させます。`low_poly`がバッチの場合、各アイテムは順番にベイクされます。`high_poly`にアイテムが1つしかない場合は、そのアイテムがバッチの全アイテムに対して再利用されます。バッチ内の空のメッシュは警告付きでスキップされ、フラットなミッドグレー(0.5)のノーマルマップを生成します。 + +## 出力 + +| 出力名 | 説明 | データ型 | +|--------|------|----------| +| `normal_map` | ベイクされたタンジェント空間ノーマルマップ(glTF/OpenGL +Y規約)。解像度×解像度の正方形RGB画像で、値は[0,1]の範囲です。これをApply Texture To Meshの`normal_map`入力に接続してください。 | IMAGE | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/ja.md) + +--- +**Source fingerprint (SHA-256):** `29df10014b5998b741d71db21d0c982d7bca85ad966a720063af15062e203322` diff --git a/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/ko.md b/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/ko.md new file mode 100644 index 000000000..06e7aef3f --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/ko.md @@ -0,0 +1,26 @@ +# BakeNormalMapFromMesh + +이 노드는 하이폴리 메시의 표면 디테일을 로우폴리 메시의 UV 레이아웃에 베이크하여 탄젠트 공간 노멀 맵을 생성합니다. 이를 통해 데시메이션 과정에서 손실된 표면 디테일을 포착할 수 있습니다. UV 언랩된 로우폴리 메시와 해당 메시의 원본 하이폴리 메시를 연결하면, Apply Texture To Mesh의 `normal_map` 입력에 사용할 수 있는 이미지가 출력됩니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `low_poly` | 베이크된 디테일을 받는, UV 언랩된 로우폴리 메시입니다. 기존 UV가 있어야 하며, 이 노드는 언랩을 수행하지 않습니다. | MESH | 예 | — | +| `high_poly` | 표면 디테일이 로우폴리의 UV 레이아웃에 베이크되는 하이폴리 메시입니다. | MESH | 예 | — | +| `resolution` | 정사각형 출력 노멀 맵의 픽셀 단위 변 길이입니다(기본값: 1024). | INT | 예 | 64 to 8192 (step 64) | +| `cage_distance` | 표면 검색 대역으로, 경계 상자 대각선 길이에 대한 비율입니다. 심한 데시메이션으로 인해 잘못되거나 누락된 패치가 있을 경우 값을 높이고, 간격을 가로질러 포착하는 경우 값을 낮추십시오. 기본값: 0.05. | FLOAT | 예 | 0.001 to 0.5 (step 0.001) | +| `ignore_backfaces` | 텍셀에서 멀어지는 방향을 향하는 하이폴리 표면을 건너뜁니다. 따라서 틈이나 밀폐된 공간에서 반대쪽 벽을 포착하지 않습니다. 하이폴리의 와인딩이 일관되지 않은 경우에만 비활성화하십시오. 기본값: true. | BOOLEAN | 예 | true / false | + +참고: `low_poly`에는 UV 좌표가 있어야 합니다. UV 좌표가 없으면 기존 UV 레이아웃에 베이크하며 메시를 언랩하지 않으므로 노드가 오류를 발생시킵니다. `low_poly`가 배치(batch)인 경우 각 항목이 순서대로 베이크됩니다. `high_poly`에 항목이 하나만 있으면 해당 항목이 모든 배치 항목에 재사용됩니다. 배치의 빈 메시는 경고와 함께 건너뛰고 단색 중간 회색(0.5) 노멀 맵을 생성합니다. + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `normal_map` | 베이크된 탄젠트 공간 노멀 맵(glTF/OpenGL +Y 규약)으로, 값이 [0,1] 범위에 있는 정사각형 해상도 × 해상도 RGB 이미지입니다. 이 이미지를 Apply Texture To Mesh의 `normal_map` 입력에 연결하십시오. | IMAGE | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/ko.md) + +--- +**Source fingerprint (SHA-256):** `29df10014b5998b741d71db21d0c982d7bca85ad966a720063af15062e203322` diff --git a/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/pt-BR.md b/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/pt-BR.md new file mode 100644 index 000000000..e765e5bd2 --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/pt-BR.md @@ -0,0 +1,26 @@ +# BakeNormalMapFromMesh + +Este nó faz o bake de um mapa de normais em espaço tangente de uma malha high-poly para o layout de UV de uma malha low-poly, capturando detalhes de superfície que foram perdidos durante a decimação. Conecte a malha low-poly com UVs e a malha high-poly da qual ela se originou, e o nó gera uma imagem pronta para a entrada `normal_map` do nó Apply Texture To Mesh. + +## Entradas + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | +|-----------|-------------|-----------|----------|-------| +| `low_poly` | A malha low-poly com UVs que recebe o detalhe assado. Deve ter UVs existentes; o nó nunca faz unwrap da malha. | MESH | Sim | — | +| `high_poly` | A malha high-poly cujos detalhes de superfície são assados no layout de UV da malha low-poly. | MESH | Sim | — | +| `resolution` | Comprimento do lado, em pixels, do mapa de normais quadrado de saída (padrão: 1024). | INT | Sim | 64 to 8192 (step 64) | +| `cage_distance` | Faixa de busca na superfície, como fração da diagonal do bounding box. Aumente para regiões incorretas ou ausentes sob decimação intensa; diminua se ela capturar através de vãos. Padrão: 0.05. | FLOAT | Sim | 0.001 to 0.5 (step 0.001) | +| `ignore_backfaces` | Ignora superfícies high-poly que estão voltadas para longe do texel, para que frestas/espaços fechados não capturem a parede oposta. Desative apenas se a orientação das faces (winding) da malha high-poly estiver inconsistente. Padrão: true. | BOOLEAN | Sim | true / false | + +Nota: `low_poly` deve ter coordenadas de UV. Se não houver nenhuma, o nó gera um erro porque ele faz o bake no layout de UV existente e não faz unwrap da malha. Quando `low_poly` for um lote, cada item passa pelo bake em ordem; se `high_poly` contiver apenas um item, esse item é reutilizado para todos os itens do lote. Malhas vazias no lote são ignoradas com um aviso e produzem um mapa de normais cinza médio uniforme (0.5). + +## Saídas + +| Nome da Saída | Descrição | Tipo de Dados | +|-------------|-------------|-----------| +| `normal_map` | O mapa de normais em espaço tangente gerado (convenção glTF/OpenGL +Y) como uma imagem RGB quadrada de resolução × resolução, com valores em [0,1]. Conecte-o à entrada `normal_map` do nó Apply Texture To Mesh. | IMAGE | + +> Esta documentação foi gerada por IA. Se você encontrar erros ou tiver sugestões de melhoria, sinta-se à vontade para contribuir! [Editar no GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/pt-BR.md) + +--- +**Source fingerprint (SHA-256):** `29df10014b5998b741d71db21d0c982d7bca85ad966a720063af15062e203322` diff --git a/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/ru.md b/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/ru.md new file mode 100644 index 000000000..e6f59c33a --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/ru.md @@ -0,0 +1,26 @@ +# BakeNormalMapFromMesh + +Этот узел запекает карту нормалей в пространстве касательных с высокополигональной сетки на UV-развёртку низкополигональной сетки, фиксируя детали поверхности, утраченные при упрощении. Подключите низкополигональную сетку с UV-развёрткой и исходную высокополигональную сетку — узел выдаст изображение, готовое для входа `normal_map` узла Apply Texture To Mesh. + +## Входы + +| Параметр | Описание | Тип данных | Обязательный | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `low_poly` | Низкополигональная сетка с UV-развёрткой, принимающая запечённые детали. Должна иметь существующие UV-координаты; узел никогда не выполняет развёртку. | MESH | Да | — | +| `high_poly` | Высокополигональная сетка, детали поверхности которой запекаются в UV-развёртку низкополигональной сетки. | MESH | Да | — | +| `resolution` | Длина стороны в пикселях квадратной выходной карты нормалей (по умолчанию: 1024). | INT | Да | 64 to 8192 (step 64) | +| `cage_distance` | Полоса поиска по поверхности, как доля диагонали ограничивающей рамки. Увеличьте при неправильных/отсутствующих участках после сильного упрощения; уменьшите, если захват происходит через зазоры. По умолчанию: 0.05. | FLOAT | Да | 0.001 to 0.5 (step 0.001) | +| `ignore_backfaces` | Пропускать поверхности высокополигональной сетки, обращённые от текселя, чтобы углубления/замкнутые пространства не захватывали противоположную стенку. Отключайте только при непоследовательном порядке обхода граней высокополигональной сетки. По умолчанию: true. | BOOLEAN | Да | true / false | + +Примечание: `low_poly` должна иметь UV-координаты. Если их нет, узел выдаёт ошибку, поскольку запекание выполняется на существующую UV-развёртку, а не на вновь созданную. Если `low_poly` является батчем, каждый элемент запекается по порядку; если `high_poly` содержит только один элемент, он используется повторно для каждого элемента батча. Пустые сетки в батче пропускаются с предупреждением и создают однотонную средне-серую (0.5) карту нормалей. + +## Выходы + +| Имя выхода | Описание | Тип данных | +|-------------|-------------|-----------| +| `normal_map` | Запечённая карта нормалей в пространстве касательных (соглашение glTF/OpenGL +Y) в виде квадратного RGB-изображения размером resolution × resolution со значениями в диапазоне [0,1]. Подключите её ко входу `normal_map` узла Apply Texture To Mesh. | IMAGE | + +> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/ru.md) + +--- +**Source fingerprint (SHA-256):** `29df10014b5998b741d71db21d0c982d7bca85ad966a720063af15062e203322` diff --git a/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/tr.md b/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/tr.md new file mode 100644 index 000000000..98f5a5b54 --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/tr.md @@ -0,0 +1,26 @@ +# BakeNormalMapFromMesh + +Bu düğüm, yüksek poli bir ağdan düşük poli ağın UV düzenine teğet uzayı normal haritası pişirir; sadeleştirme sırasında kaybolan yüzey detayını yakalar. UV açılmış düşük poli ağı ve türetildiği yüksek poli ağı bağlayın; düğüm, Apply Texture To Mesh düğümünün `normal_map` girdisine hazır bir görüntü çıkarır. + +## Girdiler + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +|-----------|-------------|-----------|----------|-------| +| `low_poly` | Pişirilen detayı alan UV açılmış düşük poli ağ. Mevcut UV koordinatları olmalıdır; düğüm asla açma işlemi yapmaz. | MESH | Evet | — | +| `high_poly` | Yüzey detayı düşük poli ağın UV düzenine pişirilen yüksek poli ağ. | MESH | Evet | — | +| `resolution` | Kare çıktı normal haritasının piksel cinsinden kenar uzunluğu (varsayılan: 1024). | INT | Evet | 64 to 8192 (step 64) | +| `cage_distance` | Yüzey arama bandı, sınırlayıcı kutu köşegeninin bir kesri olarak. Yoğun sadeleştirme altında hatalı/eksik bölgeler için artırın; boşluklar arasında yakalıyorsa azaltın. Varsayılan: 0.05. | FLOAT | Evet | 0.001 to 0.5 (step 0.001) | +| `ignore_backfaces` | Tekselden uzağa bakan yüksek poli yüzeyleri atla; böylece yarıklar/kapalı alanlar karşı duvarı yakalamaz. Yalnızca yüksek poli sargı yönü tutarsızsa devre dışı bırakın. Varsayılan: true. | BOOLEAN | Evet | true / false | + +Not: `low_poly` UV koordinatlarına sahip olmalıdır. Yoksa düğüm hata verir çünkü mevcut UV düzenine pişirir ve ağı açmaz. `low_poly` bir küme (batch) olduğunda, her öğe sırayla pişirilir; `high_poly` yalnızca bir öğe içeriyorsa, bu öğe kümedeki her öğe için yeniden kullanılır. Kümedeki boş ağlar bir uyarıyla atlanır ve düz orta gri (0.5) normal harita üretir. + +## Çıktılar + +| Çıktı Adı | Açıklama | Veri Türü | +|-------------|-------------|-----------| +| `normal_map` | Pişirilmiş teğet uzayı normal haritası (glTF/OpenGL +Y kuralı), [0,1] değerlerine sahip kare çözünürlük × çözünürlük RGB görüntüsü. Apply Texture To Mesh düğümünün `normal_map` girdisine bağlayın. | IMAGE | + +> Bu belge yapay zeka tarafından oluşturulmuştur. Herhangi bir hata bulursanız veya iyileştirme önerileriniz varsa, katkıda bulunmaktan çekinmeyin! [GitHub'da Düzenle](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/tr.md) + +--- +**Source fingerprint (SHA-256):** `29df10014b5998b741d71db21d0c982d7bca85ad966a720063af15062e203322` diff --git a/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/zh-TW.md b/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/zh-TW.md new file mode 100644 index 000000000..6f9fe4614 --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/zh-TW.md @@ -0,0 +1,26 @@ +# BakeNormalMapFromMesh + +此節點會將高解析度網格上的切線空間法線貼圖,烘焙到低解析度網格的 UV 佈局上,以捕捉在減面過程中遺失的表面細節。請連接已展開 UV 的低解析度網格,以及其所來自的高解析度網格,節點便會輸出可用於「Apply Texture To Mesh」之 `normal_map` 輸入的影像。 + +## 輸入 + +| 參數 | 說明 | 資料類型 | 必要 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `low_poly` | 接收烘焙細節的已展開 UV 低解析度網格。必須具備現有的 UV;此節點絕不會自行展開 UV。 | MESH | 是 | — | +| `high_poly` | 其表面細節將被烘焙至低解析度網格 UV 佈局中的高解析度網格。 | MESH | 是 | — | +| `resolution` | 方形輸出的法線貼圖之邊緣長度(像素),預設值:1024。 | INT | 是 | 64 到 8192(間距 64) | +| `cage_distance` | 表面搜尋帶,以邊界框對角線的比例表示。若在大量減面後出現錯誤或缺失的區塊,請調高此值;若其跨越間隙抓取,則調低此值。預設值:0.05。 | FLOAT | 是 | 0.001 到 0.5(間距 0.001) | +| `ignore_backfaces` | 跳過背向紋素的高解析度表面,避免裂縫或封閉空間抓取到對向牆面。僅在高解析度網格的頂點繞序不一致時停用。預設值:true。 | BOOLEAN | 是 | true / false | + +注意:`low_poly` 必須具有 UV 座標。若沒有,節點會產生錯誤,因為它會烘焙到既有的 UV 佈局上,且不會對網格進行 UV 展開。當 `low_poly` 是批次時,每個項目會依序烘焙;若 `high_poly` 只包含一個項目,則該項目會對批次中的每個項目重複使用。批次中的空白網格會跳過並發出警告,且會產生平坦的中灰色(0.5)法線貼圖。 + +## 輸出 + +| 輸出名稱 | 說明 | 資料類型 | +|-------------|-------------|-----------| +| `normal_map` | 烘焙完成的切線空間法線貼圖(glTF/OpenGL +Y 慣例),為方形 resolution × resolution 的 RGB 影像,數值範圍在 [0,1]。可將其連接到「Apply Texture To Mesh」的 `normal_map` 輸入。 | IMAGE | + +> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/zh-TW.md) + +--- +**Source fingerprint (SHA-256):** `29df10014b5998b741d71db21d0c982d7bca85ad966a720063af15062e203322` diff --git a/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/zh.md b/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/zh.md new file mode 100644 index 000000000..94ad63c5e --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/zh.md @@ -0,0 +1,26 @@ +# BakeNormalMapFromMesh + +此节点将高多边形网格的表面细节烘焙到低多边形网格的 UV 布局上,生成切线空间法线贴图,捕捉减面过程中丢失的表面细节。连接已展开 UV 的低多边形网格及其来源的高多边形网格,节点将输出一张可直接用于 Apply Texture To Mesh 的 `normal_map` 输入的图像。 + +## 输入 + +| 参数 | 描述 | 数据类型 | 必需 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `low_poly` | 接收烘焙细节的已展开 UV 的低多边形网格。必须已有 UV 坐标;此节点从不执行展开操作。 | MESH | 是 | — | +| `high_poly` | 其表面细节被烘焙到低多边形 UV 布局中的高多边形网格。 | MESH | 是 | — | +| `resolution` | 方形输出法线贴图的边长(像素),默认值:1024。 | INT | 是 | 64 to 8192 (step 64) | +| `cage_distance` | 表面搜索范围,以包围盒对角线为比例。在强力减面导致贴片错误或缺失时可增大;若发生跨间隙捕获则减小。默认值:0.05。 | FLOAT | 是 | 0.001 to 0.5 (step 0.001) | +| `ignore_backfaces` | 跳过背离纹素的高多边形表面,使缝隙/封闭空间不会抓到对侧壁面。仅在高多边形绕序不一致时禁用。默认值:true。 | BOOLEAN | 是 | true / false | + +注意:`low_poly` 必须具有 UV 坐标。若没有,节点将报错,因为烘焙依赖现有的 UV 布局,不会对网格进行展开。当 `low_poly` 为批次时,每个项目按顺序烘焙;若 `high_poly` 仅包含一个项目,则该项目会被重复用于批次中的每一项。批次中的空网格会被跳过并发出警告,同时生成纯中灰色(0.5)的法线贴图。 + +## 输出 + +| 输出名称 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `normal_map` | 烘焙生成的切线空间法线贴图(glTF/OpenGL +Y 约定),为方形的 resolution × resolution RGB 图像,值域为 [0,1]。将其连接到 Apply Texture To Mesh 的 `normal_map` 输入。 | IMAGE | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeNormalMapFromMesh/zh.md) + +--- +**Source fingerprint (SHA-256):** `29df10014b5998b741d71db21d0c982d7bca85ad966a720063af15062e203322` diff --git a/comfyui_embedded_docs/docs/BakeTextureFromVoxel/ar.md b/comfyui_embedded_docs/docs/BakeTextureFromVoxel/ar.md new file mode 100644 index 000000000..aaf0f23ea --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeTextureFromVoxel/ar.md @@ -0,0 +1,31 @@ +# BakeTextureFromVoxel + +تقوم هذه العقدة بخبز أنسجة PBR على شبكة ثلاثية الأبعاد باستخدام تخطيط UV الموجود في الشبكة. تأخذ عينات من سمات اللون والمادة من حجم فوكسلي متناثر عند كل تيكسل، وتُخرج صورة اللون الأساسي بالإضافة إلى خريطتَي المعدنية والخشونة. وهي لا تفرد الشبكة، لذا يجب توصيل عقدة فرد UV في مرحلة سابقة. + +## المدخلات + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|-----------|-------------|-----------|----------|-------| +| `mesh` | الشبكة ثلاثية الأبعاد المراد خبز الأنسجة عليها. يجب أن تحتوي مسبقًا على تخطيط UV؛ ويجب توصيل عقدة فرد UV في مرحلة سابقة. | MESH | نعم | | +| `voxel_colors` | حجم فوكسلي متناثر يحتوي على ألوان لكل فوكسل، مع سمات PBR اختيارية (قناتا المعدنية والخشونة). | VOXEL | نعم | | +| `texture_size` | دقة أطلس UV المربعة (اسم العرض: "الدقة"، الافتراضي: 2048). | INT | نعم | 64 إلى 8192 | +| `reference_mesh` | شبكة مرجعية اختيارية كثيفة قبل تقليل الوجوه؛ يعيد إسقاط كل تيكسل على سطحه الأصلي قبل أخذ العينات، مما يلغي تجزئة النسيج المخبوز إلى أوجه على الشبكات الخشنة. | MESH | لا | | + +ملاحظات: + +- يجب أن تحتوي شبكة الإدخال على قيم UV. إذا لم توجد أي قيم UV، تُصدر العقدة خطأً. ويجب أن تكون قيم UV مطابقة 1:1 مع الرؤوس (قيمة UV واحدة لكل رأس). +- عندما تحتوي إحداثيات الشبكة والفوكسل على بُعد دفعة، يُخبز كل عنصر في الدفعة بشكل منفصل. إذا لم يكن لأحد عناصر الدفعة فوكسلات أو وجوه، يتم تخطيه ويُصدر نسيج أسود له. +- عند توفير `reference_mesh` لدفعة، يتم مطابقته حسب فهرس الدفعة، إلا إذا كان يحتوي على شبكة واحدة فقط، وفي هذه الحالة تُستخدم تلك الشبكة لجميع العناصر. + +## المخرجات + +| اسم المخرج | الوصف | نوع البيانات | +|-------------|-------------|-----------| +| `base_color` | خريطة نسيج اللون الأساسي RGB. القيم أعداد كسرية ضمن النطاق 0–1. | IMAGE | +| `metallic` | خريطة المعدنية بتدرج رمادي (قيم كسرية 0–1). تكون سوداء عندما لا تحتوي ألوان الفوكسل على قناة معدنية. | IMAGE | +| `roughness` | خريطة الخشونة بتدرج رمادي (قيم كسرية 0–1). تكون سوداء عندما لا تحتوي ألوان الفوكسل على قناة خشونة. | IMAGE | + +> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeTextureFromVoxel/ar.md) + +--- +**Source fingerprint (SHA-256):** `419f9e064edaeb9db8d5e052cf57a3b8b77bf7e025e8a0fc9aa0e1919c06b51c` diff --git a/comfyui_embedded_docs/docs/BakeTextureFromVoxel/en.md b/comfyui_embedded_docs/docs/BakeTextureFromVoxel/en.md new file mode 100644 index 000000000..8f3725f94 --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeTextureFromVoxel/en.md @@ -0,0 +1,31 @@ +# BakeTextureFromVoxel + +This node bakes PBR textures onto a 3D mesh using the mesh's existing UV layout. It samples color and material attributes from a sparse voxel volume at each texel and outputs a base color image plus metallic and roughness maps. It does not unwrap the mesh, so a UV unwrap node must be connected upstream. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `mesh` | The 3D mesh to bake textures onto. Must already have a UV layout; a UV unwrap node must be connected upstream. | MESH | Yes | | +| `voxel_colors` | Sparse voxel volume containing per-voxel colors and optional PBR attributes (metallic and roughness channels). | VOXEL | Yes | | +| `texture_size` | Square UV atlas resolution (display name: "resolution", default: 2048). | INT | Yes | 64 to 8192 | +| `reference_mesh` | Optional dense pre-decimation mesh; back-projects each texel onto its true surface before sampling, removing faceted baking on coarse meshes. | MESH | No | | + +Notes: + +- The input mesh must have UVs. If no UVs are present, the node raises an error. UVs must be 1:1 with the vertices (one UV per vertex). +- When the mesh and voxel coordinates contain a batch dimension, each batch item is baked separately. If a batch item has no voxels or no faces, it is skipped and a black texture is emitted for it. +- When `reference_mesh` is provided for a batch, it is matched by batch index unless it contains only a single mesh, in which case that mesh is used for all items. + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `base_color` | RGB base color texture map. Values are float in the 0–1 range. | IMAGE | +| `metallic` | Grayscale metallic map (float, 0–1). Black when the voxel colors contain no metallic channel. | IMAGE | +| `roughness` | Grayscale roughness map (float, 0–1). Black when the voxel colors contain no roughness channel. | IMAGE | + +> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeTextureFromVoxel/en.md) + +--- +**Source fingerprint (SHA-256):** `419f9e064edaeb9db8d5e052cf57a3b8b77bf7e025e8a0fc9aa0e1919c06b51c` diff --git a/comfyui_embedded_docs/docs/BakeTextureFromVoxel/es.md b/comfyui_embedded_docs/docs/BakeTextureFromVoxel/es.md new file mode 100644 index 000000000..29a2c6e54 --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeTextureFromVoxel/es.md @@ -0,0 +1,31 @@ +# BakeTextureFromVoxel + +Este nodo hornea texturas PBR sobre una malla 3D utilizando la disposición UV existente de la malla. Muestrea el color y los atributos de material de un volumen de vóxeles disperso en cada texel y genera una imagen de color base además de mapas de metalicidad y rugosidad. No desarrolla la malla, por lo que debe conectarse un nodo de desenvolvimento UV aguas arriba. + +## Entradas + +| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango | +|-----------|-------------|---------------|-------------|-------| +| `mesh` | La malla 3D sobre la que hornear texturas. Debe tener ya una disposición de UV; debe conectarse un nodo de desenvolvimento UV aguas arriba. | MESH | Sí | | +| `voxel_colors` | Volumen de vóxeles disperso que contiene colores por vóxel y atributos PBR opcionales (canales de metalicidad y rugosidad). | VOXEL | Sí | | +| `texture_size` | Resolución del atlas UV cuadrado (nombre mostrado: "resolution", predeterminado: 2048). | INT | Sí | 64 to 8192 | +| `reference_mesh` | Malla densa opcional anterior a la decimación; reproyecta cada texel sobre su superficie real antes de muestrear, eliminando el horneado facetado en mallas gruesas. | MESH | No | | + +Notas: + +- La malla de entrada debe tener UV. Si no hay UV, el nodo genera un error. Los UV deben ser 1:1 con los vértices (un UV por vértice). +- Cuando la malla y las coordenadas de vóxeles contienen una dimensión de lote, cada elemento del lote se hornea por separado. Si un elemento del lote no tiene vóxeles ni caras, se omite y se emite una textura negra para él. +- Cuando se proporciona `reference_mesh` para un lote, se empareja por índice de lote a menos que contenga solo una malla, en cuyo caso esa malla se usa para todos los elementos. + +## Salidas + +| Nombre de salida | Descripción | Tipo de datos | +|------------------|-------------|---------------| +| `base_color` | Mapa de textura de color base RGB. Los valores son flotantes en el rango 0–1. | IMAGE | +| `metallic` | Mapa de metalicidad en escala de grises (float, 0–1). Negro cuando los colores de vóxel no contienen canal de metalicidad. | IMAGE | +| `roughness` | Mapa de rugosidad en escala de grises (float, 0–1). Negro cuando los colores de vóxel no contienen canal de rugosidad. | IMAGE | + +> Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeTextureFromVoxel/es.md) + +--- +**Source fingerprint (SHA-256):** `419f9e064edaeb9db8d5e052cf57a3b8b77bf7e025e8a0fc9aa0e1919c06b51c` diff --git a/comfyui_embedded_docs/docs/BakeTextureFromVoxel/fa.md b/comfyui_embedded_docs/docs/BakeTextureFromVoxel/fa.md new file mode 100644 index 000000000..914bcbb95 --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeTextureFromVoxel/fa.md @@ -0,0 +1,31 @@ +# BakeTextureFromVoxel + +این گره بافت‌های PBR را با استفاده از چیدمان UV موجودِ مش، روی یک مش سه‌بعدی می‌پزد. برای هر تکسِل، ویژگی‌های رنگ و جنس را از یک حجم وکسل پراکنده نمونه‌برداری می‌کند و تصویر رنگ پایه را همراه با نگاشت‌های فلزی و زبری خروجی می‌دهد. این گره مش را باز نمی‌کند (unwrap)؛ بنابراین باید یک گره بازکردن UV در بالادست متصل شده باشد. + +## ورودی‌ها + +| پارامتر | توضیحات | نوع داده | الزامی | بازه | +|-----------|-------------|-----------|----------|-------| +| `mesh` | مش سه‌بعدی که بافت‌ها روی آن پخته می‌شوند. باید از قبل چیدمان UV داشته باشد؛ یک گره بازکردن UV باید بالادست متصل شده باشد. | MESH | بله | | +| `voxel_colors` | حجم وکسل پراکنده شامل رنگ‌های هر وکسل و ویژگی‌های اختیاری PBR (کانال‌های فلزی و زبری). | VOXEL | بله | | +| `texture_size` | وضوح اطلس UV مربعی (نام نمایشی: "resolution"، پیش‌فرض: 2048). | INT | بله | 64 تا 8192 | +| `reference_mesh` | مش متراکم اختیاری پیش از کاهش چگالی؛ پیش از نمونه‌برداری، هر تکسِل را با پروجکشن معکوس به سطح واقعی خودش برمی‌گرداند و از پخت وجه‌دار روی مش‌های درشت جلوگیری می‌کند. | MESH | خیر | | + +نکات: + +- مش ورودی باید UV داشته باشد. اگر UV وجود نداشته باشد، گره خطا صادر می‌کند. UVها باید با رأس‌ها یک‌به‌یک باشند (به ازای هر رأس یک UV). +- وقتی مختصات مش و وکسل دارای بعد دسته باشند، هر آیتم دسته به‌طور جداگانه پخته می‌شود. اگر یک آیتم دسته هیچ وکسل یا وجهی نداشته باشد، رد می‌شود و یک بافت سیاه برای آن تولید می‌شود. +- وقتی `reference_mesh` برای یک دسته ارائه شود، بر اساس شاخص دسته مطابقت داده می‌شود؛ مگر اینکه فقط یک مش داشته باشد، که در این صورت آن مش برای همه آیتم‌ها استفاده می‌شود. + +## خروجی‌ها + +| نام خروجی | توضیحات | نوع داده | +|-------------|-------------|-----------| +| `base_color` | نگاشت بافت رنگ پایه RGB. مقادیر به‌صورت ممیز شناور در بازه 0 تا 1 هستند. | IMAGE | +| `metallic` | نگاشت فلزی خاکستری (ممیز شناور، 0 تا 1). وقتی رنگ‌های وکسل کانال فلزی نداشته باشند سیاه است. | IMAGE | +| `roughness` | نگاشت زبری خاکستری (ممیز شناور، 0 تا 1). وقتی رنگ‌های وکسل کانال زبری نداشته باشند سیاه است. | IMAGE | + +> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeTextureFromVoxel/fa.md) + +--- +**Source fingerprint (SHA-256):** `419f9e064edaeb9db8d5e052cf57a3b8b77bf7e025e8a0fc9aa0e1919c06b51c` diff --git a/comfyui_embedded_docs/docs/BakeTextureFromVoxel/fr.md b/comfyui_embedded_docs/docs/BakeTextureFromVoxel/fr.md new file mode 100644 index 000000000..8648660d0 --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeTextureFromVoxel/fr.md @@ -0,0 +1,31 @@ +# BakeTextureFromVoxel + +Ce nœud projette des textures PBR sur un maillage 3D en utilisant la disposition UV existante du maillage. Il échantillonne les attributs de couleur et de matériau à partir d’un volume de voxels épars à chaque texel, et produit une image de couleur de base ainsi que des cartes de métallicité et de rugosité. Il ne déplie pas le maillage, donc un nœud de dépliage UV doit être connecté en amont. + +## Entrées + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `mesh` | Le maillage 3D sur lequel projeter les textures. Doit déjà posséder une disposition UV ; un nœud de dépliage UV doit être connecté en amont. | MESH | Oui | | +| `voxel_colors` | Volume de voxels épars contenant des couleurs par voxel et des attributs PBR optionnels (canaux de métallicité et de rugosité). | VOXEL | Oui | | +| `texture_size` | Résolution de l’atlas UV carré (nom d’affichage : « resolution », défaut : 2048). | INT | Oui | 64 à 8192 | +| `reference_mesh` | Maillage dense optionnel antérieur à la décimation ; rétroprojette chaque texel sur sa surface réelle avant l’échantillonnage, supprimant l’aspect facetté lors de la projection sur les maillages grossiers. | MESH | Non | | + +Remarques : + +- Le maillage d’entrée doit avoir des UV. Si aucun UV n’est présent, le nœud génère une erreur. Les UV doivent être en correspondance 1:1 avec les sommets (un UV par sommet). +- Lorsque le maillage et les coordonnées de voxels contiennent une dimension de lot, chaque élément du lot est projeté séparément. Si un élément du lot ne contient ni voxels ni faces, il est ignoré et une texture noire est émise pour celui-ci. +- Lorsque `reference_mesh` est fourni pour un lot, il est mis en correspondance par index de lot, sauf s’il ne contient qu’un seul maillage, auquel cas ce maillage est utilisé pour tous les éléments. + +## Sorties + +| Nom de sortie | Description | Type de données | +|---------------|-------------|-----------------| +| `base_color` | Carte de texture de couleur de base RVB. Les valeurs sont des flottants dans la plage 0–1. | IMAGE | +| `metallic` | Carte de métallicité en niveaux de gris (flottant, 0–1). Noire lorsque les couleurs de voxels ne contiennent aucun canal de métallicité. | IMAGE | +| `roughness` | Carte de rugosité en niveaux de gris (flottant, 0–1). Noire lorsque les couleurs de voxels ne contiennent aucun canal de rugosité. | IMAGE | + +> Cette documentation a été générée par IA. Si vous trouvez des erreurs ou avez des suggestions d'amélioration, n'hésitez pas à contribuer ! [Modifier sur GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeTextureFromVoxel/fr.md) + +--- +**Source fingerprint (SHA-256):** `419f9e064edaeb9db8d5e052cf57a3b8b77bf7e025e8a0fc9aa0e1919c06b51c` diff --git a/comfyui_embedded_docs/docs/BakeTextureFromVoxel/ja.md b/comfyui_embedded_docs/docs/BakeTextureFromVoxel/ja.md new file mode 100644 index 000000000..b7e207330 --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeTextureFromVoxel/ja.md @@ -0,0 +1,31 @@ +# BakeTextureFromVoxel + +このノードは、メッシュの既存のUVレイアウトを使用して、PBRテクスチャを3Dメッシュにベイクします。各テクセルでスパースボクセルボリュームから色とマテリアル属性をサンプリングし、ベースカラー画像とメタリックマップおよびラフネスマップを出力します。メッシュのUV展開は行わないため、上流にUV展開ノードを接続する必要があります。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `mesh` | テクスチャをベイクする3Dメッシュ。あらかじめUVレイアウトを持っている必要があります。上流にUV展開ノードを接続する必要があります。 | MESH | 必須 | | +| `voxel_colors` | 各ボクセルの色と、オプションのPBR属性(メタリックおよびラフネスチャンネル)を含むスパースボクセルボリューム。 | VOXEL | 必須 | | +| `texture_size` | 正方形のUVアトラス解像度(表示名: "resolution"、デフォルト: 2048)。 | INT | 必須 | 64 to 8192 | +| `reference_mesh` | オプションの高密度なデシメーション前メッシュ。各テクセルをサンプリング前に真のサーフェスに逆投影し、粗いメッシュ上のファセット状のベイクを除去します。 | MESH | 任意 | | + +注記: + +- 入力メッシュにはUVが必要です。UVがない場合、ノードはエラーを発生させます。UVは頂点と1:1(頂点ごとに1つのUV)である必要があります。 +- メッシュとボクセル座標にバッチ次元が含まれる場合、各バッチ項目は個別にベイクされます。バッチ項目にボクセルまたはフェースがない場合はスキップされ、その項目に対して黒いテクスチャが出力されます。 +- バッチに対して`reference_mesh`が指定されている場合、単一のメッシュのみを含む場合を除き、バッチインデックスによって照合されます。その場合、そのメッシュがすべての項目に使用されます。 + +## 出力 + +| 出力名 | 説明 | データ型 | +|-------------|-------------|-----------| +| `base_color` | RGBベースカラーテクスチャマップ。値は0〜1の範囲のfloatです。 | IMAGE | +| `metallic` | グレースケールのメタリックマップ(float、0〜1)。ボクセルカラーにメタリックチャンネルが含まれない場合は黒になります。 | IMAGE | +| `roughness` | グレースケールのラフネスマップ(float、0〜1)。ボクセルカラーにラフネスチャンネルが含まれない場合は黒になります。 | IMAGE | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeTextureFromVoxel/ja.md) + +--- +**Source fingerprint (SHA-256):** `419f9e064edaeb9db8d5e052cf57a3b8b77bf7e025e8a0fc9aa0e1919c06b51c` diff --git a/comfyui_embedded_docs/docs/BakeTextureFromVoxel/ko.md b/comfyui_embedded_docs/docs/BakeTextureFromVoxel/ko.md new file mode 100644 index 000000000..0dec12872 --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeTextureFromVoxel/ko.md @@ -0,0 +1,31 @@ +# BakeTextureFromVoxel + +이 노드는 메시의 기존 UV 레이아웃을 사용하여 3D 메시에 PBR 텍스처를 베이크합니다. 각 텍셀에서 희소 복셀 볼륨의 색상 및 재질 속성을 샘플링하여 베이스 컬러 이미지와 메탈릭 및 러프니스 맵을 출력합니다. 메시를 언랩하지 않으므로 UV 언랩 노드가 업스트림에 연결되어 있어야 합니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `mesh` | 텍스처를 베이크할 3D 메시입니다. 이미 UV 레이아웃이 있어야 하며, UV 언랩 노드가 업스트림에 연결되어 있어야 합니다. | MESH | 예 | | +| `voxel_colors` | 복셀별 색상과 선택적 PBR 속성(메탈릭 및 러프니스 채널)을 포함하는 희소 복셀 볼륨입니다. | VOXEL | 예 | | +| `texture_size` | 정사각형 UV 아틀라스 해상도입니다(표시 이름: "resolution", 기본값: 2048). | INT | 예 | 64 to 8192 | +| `reference_mesh` | 선택적 데시메이션(decimation) 전 고밀도 메시입니다. 샘플링 전에 각 텍셀을 실제 표면으로 역투영하여 거친 메시에서 면(facet)이 드러나는 베이킹을 제거합니다. | MESH | 아니요 | | + +참고: + +- 입력 메시에는 UV가 있어야 합니다. UV가 없으면 노드에서 오류가 발생합니다. UV는 정점과 1:1 비율이어야 합니다(정점당 UV 하나). +- 메시 및 복셀 좌표에 배치 차원이 포함된 경우 각 배치 항목이 개별적으로 베이크됩니다. 배치 항목에 복셀이나 면이 없으면 해당 항목은 건너뛰고 검은색 텍스처가 출력됩니다. +- 배치에 `reference_mesh`가 제공되면 배치 인덱스로 일치됩니다. 단, 메시가 하나만 포함된 경우 해당 메시가 모든 항목에 사용됩니다. + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `base_color` | RGB 베이스 컬러 텍스처 맵입니다. 값은 0–1 범위의 부동 소수점입니다. | IMAGE | +| `metallic` | 회색조 메탈릭 맵(float, 0–1)입니다. 복셀 색상에 메탈릭 채널이 없으면 검은색입니다. | IMAGE | +| `roughness` | 회색조 러프니스 맵(float, 0–1)입니다. 복셀 색상에 러프니스 채널이 없으면 검은색입니다. | IMAGE | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeTextureFromVoxel/ko.md) + +--- +**Source fingerprint (SHA-256):** `419f9e064edaeb9db8d5e052cf57a3b8b77bf7e025e8a0fc9aa0e1919c06b51c` diff --git a/comfyui_embedded_docs/docs/BakeTextureFromVoxel/pt-BR.md b/comfyui_embedded_docs/docs/BakeTextureFromVoxel/pt-BR.md new file mode 100644 index 000000000..2939bdc03 --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeTextureFromVoxel/pt-BR.md @@ -0,0 +1,31 @@ +# BakeTextureFromVoxel + +Este nó assa texturas PBR em uma malha 3D usando o layout de UV existente da malha. Ele amostra atributos de cor e material em um volume esparso de voxels para cada texel e gera uma imagem de cor base, além de mapas de metalicidade e rugosidade. Ele não desdobra a malha, portanto um nó de desdobramento de UV deve ser conectado anteriormente na cadeia. + +## Entradas + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | +|-----------|-------------|-----------|----------|-------| +| `mesh` | A malha 3D na qual as texturas serão assadas. Deve já possuir um layout de UV; um nó de desdobramento de UV deve ser conectado antes. | MESH | Sim | | +| `voxel_colors` | Volume esparso de voxels contendo cores por voxel e atributos PBR opcionais (canais de metalicidade e rugosidade). | VOXEL | Sim | | +| `texture_size` | Resolução do atlas de UV quadrado (nome de exibição: "resolution", padrão: 2048). | INT | Sim | 64 a 8192 | +| `reference_mesh` | Malha densa opcional anterior à decimação; projeta cada texel de volta na superfície real antes da amostragem, eliminando efeitos facetados do assamento em malhas grosseiras. | MESH | Não | | + +Notas: + +- A malha de entrada deve ter UVs. Se não houver UVs, o nó gera um erro. Os UVs devem estar em correspondência de 1:1 com os vértices (um UV por vértice). +- Quando as coordenadas da malha e do voxel contêm uma dimensão de lote, cada item do lote é assado separadamente. Se um item do lote não tiver voxels ou faces, ele é ignorado e uma textura preta é gerada para ele. +- Quando `reference_mesh` é fornecido para um lote, ele é associado pelo índice do lote, a menos que contenha apenas uma única malha; nesse caso, essa malha é usada para todos os itens. + +## Saídas + +| Nome da Saída | Descrição | Tipo de Dados | +|-------------|-------------|-----------| +| `base_color` | Mapa de textura de cor base RGB. Os valores são do tipo float no intervalo de 0 a 1. | IMAGE | +| `metallic` | Mapa de metalicidade em escala de cinza (float, 0–1). Preto quando as cores dos voxels não contêm canal de metalicidade. | IMAGE | +| `roughness` | Mapa de rugosidade em escala de cinza (float, 0–1). Preto quando as cores dos voxels não contêm canal de rugosidade. | IMAGE | + +> Esta documentação foi gerada por IA. Se você encontrar erros ou tiver sugestões de melhoria, sinta-se à vontade para contribuir! [Editar no GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeTextureFromVoxel/pt-BR.md) + +--- +**Source fingerprint (SHA-256):** `419f9e064edaeb9db8d5e052cf57a3b8b77bf7e025e8a0fc9aa0e1919c06b51c` diff --git a/comfyui_embedded_docs/docs/BakeTextureFromVoxel/ru.md b/comfyui_embedded_docs/docs/BakeTextureFromVoxel/ru.md new file mode 100644 index 000000000..a494d28fb --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeTextureFromVoxel/ru.md @@ -0,0 +1,31 @@ +# BakeTextureFromVoxel + +Этот узел запекает PBR-текстуры на 3D-сетку, используя существующую UV-разметку сетки. Он сэмплирует атрибуты цвета и материала из разреженного воксельного объема в каждом текселе и выводит изображение базового цвета, а также карты металличности и шероховатости. Узел не разворачивает UV, поэтому узел развертки UV должен быть подключен до него. + +## Входы + +| Параметр | Описание | Тип данных | Обязательный | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `mesh` | 3D-сетка для запекания текстур. Должна иметь UV-разметку; узел развертки UV должен быть подключен до нее. | MESH | Да | | +| `voxel_colors` | Разреженный воксельный объем, содержащий цвета для каждого вокселя и дополнительные PBR-атрибуты (каналы металличности и шероховатости). | VOXEL | Да | | +| `texture_size` | Разрешение квадратной UV-атласной текстуры (отображаемое имя: "resolution", по умолчанию: 2048). | INT | Да | 64 to 8192 | +| `reference_mesh` | Дополнительная плотная сетка до уменьшения количества полигонов; проецирует каждый тексель обратно на его истинную поверхность перед сэмплированием, устраняя фасеточное запекание на грубых сетках. | MESH | Нет | | + +Примечания: + +- Входная сетка должна иметь UV. Если UV отсутствуют, узел вызывает ошибку. UV должны быть 1:1 с вершинами (одна UV на вершину). +- Когда сетка и координаты вокселей содержат размерность пакета (batch), каждый элемент пакета запекается отдельно. Если элемент пакета не содержит вокселей или граней, он пропускается, и для него создается черная текстура. +- Когда `reference_mesh` указан для пакета, он сопоставляется по индексу пакета, если только он не содержит только одну сетку; в этом случае эта сетка используется для всех элементов. + +## Выходы + +| Имя выхода | Описание | Тип данных | +|-------------|-------------|-----------| +| `base_color` | Текстурная карта базового цвета RGB. Значения — числа с плавающей точкой в диапазоне 0–1. | IMAGE | +| `metallic` | Оттенки серого — карта металличности (float, 0–1). Черная, если воксельные цвета не содержат канал металличности. | IMAGE | +| `roughness` | Оттенки серого — карта шероховатости (float, 0–1). Черная, если воксельные цвета не содержат канал шероховатости. | IMAGE | + +> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeTextureFromVoxel/ru.md) + +--- +**Source fingerprint (SHA-256):** `419f9e064edaeb9db8d5e052cf57a3b8b77bf7e025e8a0fc9aa0e1919c06b51c` diff --git a/comfyui_embedded_docs/docs/BakeTextureFromVoxel/tr.md b/comfyui_embedded_docs/docs/BakeTextureFromVoxel/tr.md new file mode 100644 index 000000000..b2f7efe86 --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeTextureFromVoxel/tr.md @@ -0,0 +1,31 @@ +# BakeTextureFromVoxel + +Bu düğüm, mesh'in mevcut UV yerleşimini kullanarak PBR dokularını bir 3D mesh üzerine pişirir. Her texel'de seyrek bir voxel hacminden renk ve malzeme özniteliklerini örnekler ve bir temel renk (base color) görüntüsü ile metaliklik ve pürüzlülük haritaları çıktısı verir. Meshi unwrap yapmaz, bu nedenle yukarı akışta bir UV unwrap düğümünün bağlanması gerekir. + +## Girdiler + +| Parametre | Açıklama | Veri Türü | Zorunlu | Aralık | +|-----------|-------------|-----------|----------|-------| +| `mesh` | Dokuların pişirileceği 3D mesh. Üzerinde zaten bir UV yerleşimi bulunmalıdır; yukarı akışta bir UV unwrap düğümü bağlanmış olmalıdır. | MESH | Evet | | +| `voxel_colors` | Voxel başına renkler ve isteğe bağlı PBR öznitelikleri (metaliklik ve pürüzlülük kanalları) içeren seyrek voxel hacmi. | VOXEL | Evet | | +| `texture_size` | Kare UV atlas çözünürlüğü (görünen adı: "resolution", varsayılan: 2048). | INT | Evet | 64 ila 8192 | +| `reference_mesh` | İsteğe bağlı yoğun, decimation öncesi mesh; örneklemeden önce her texel'i gerçek yüzeyine geri yansıtır ve kaba meshlerde fasetli pişirmeyi ortadan kaldırır. | MESH | Hayır | | + +Notlar: + +- Girdi mesh'inde UV'ler bulunmalıdır. UV'ler yoksa düğüm bir hata verir. UV'ler köşelerle (vertex) birebir eşleşmelidir (her köşe için bir UV). +- Mesh ve voxel koordinatları bir batch boyutu içerdiğinde, her batch öğesi ayrı ayrı pişirilir. Bir batch öğesinde voxel veya yüz yoksa, bu öğe atlanır ve onun için siyah bir doku üretilir. +- Bir batch için `reference_mesh` sağlandığında, yalnızca tek bir mesh içeriyorsa tüm öğeler için o mesh kullanılır; aksi halde batch indeksiyle eşleştirilir. + +## Çıktılar + +| Çıktı Adı | Açıklama | Veri Türü | +|-------------|-------------|-----------| +| `base_color` | RGB temel renk doku haritası. Değerler 0-1 aralığında float'tır. | IMAGE | +| `metallic` | Gri tonlamalı metaliklik haritası (float, 0-1). Voxel renkleri metaliklik kanalı içermediğinde siyah olur. | IMAGE | +| `roughness` | Gri tonlamalı pürüzlülük haritası (float, 0-1). Voxel renkleri pürüzlülük kanalı içermediğinde siyah olur. | IMAGE | + +> Bu belge yapay zeka tarafından oluşturulmuştur. Herhangi bir hata bulursanız veya iyileştirme önerileriniz varsa, katkıda bulunmaktan çekinmeyin! [GitHub'da Düzenle](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeTextureFromVoxel/tr.md) + +--- +**Source fingerprint (SHA-256):** `419f9e064edaeb9db8d5e052cf57a3b8b77bf7e025e8a0fc9aa0e1919c06b51c` diff --git a/comfyui_embedded_docs/docs/BakeTextureFromVoxel/zh-TW.md b/comfyui_embedded_docs/docs/BakeTextureFromVoxel/zh-TW.md new file mode 100644 index 000000000..c0b2eadc9 --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeTextureFromVoxel/zh-TW.md @@ -0,0 +1,31 @@ +# BakeTextureFromVoxel + +此節點使用網格現有的 UV 佈局,將 PBR 紋理烘焙到 3D 網格上。它會在每個紋素(texel)從稀疏體素體積中取樣顏色和材質屬性,並輸出基礎顏色影像以及金屬度與粗糙度貼圖。此節點不會對網格進行 UV 展開,因此上游必須連接 UV 展開節點。 + +## 輸入 + +| 參數 | 說明 | 資料類型 | 必填 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `mesh` | 要將紋理烘焙上去的 3D 網格。必須已具有 UV 佈局;上游必須連接 UV 展開節點。 | MESH | 是 | | +| `voxel_colors` | 包含逐體素顏色與選擇性 PBR 屬性的稀疏體素體積(金屬度與粗糙度通道)。 | VOXEL | 是 | | +| `texture_size` | 方形 UV 圖集解析度(顯示名稱:「解析度」,預設值:2048)。 | INT | 是 | 64 至 8192 | +| `reference_mesh` | 可選的減面前密集網格;在取樣前將每個紋素反向投影到其實際表面上,以消除粗糙網格上的分面烘焙效果。 | MESH | 否 | | + +注意事項: + +- 輸入網格必須具有 UV。如果沒有 UV,節點將引發錯誤。UV 必須與頂點 1:1 對應(每個頂點一個 UV)。 +- 當網格與體素座標包含批次維度時,每個批次項目會分別烘焙。如果批次項目沒有體素或沒有面,則會跳過該項目,並為其輸出黑色紋理。 +- 當為批次提供 `reference_mesh` 時,會按批次索引進行匹配;除非其中僅包含單一網格,在這種情況下,該網格將用於所有項目。 + +## 輸出 + +| 輸出名稱 | 說明 | 資料類型 | +|-------------|-------------|-----------| +| `base_color` | RGB 基礎顏色紋理貼圖。數值為 0–1 範圍內的浮點數。 | IMAGE | +| `metallic` | 灰階金屬度貼圖(浮點數,0–1)。當體素顏色不包含金屬度通道時為黑色。 | IMAGE | +| `roughness` | 灰階粗糙度貼圖(浮點數,0–1)。當體素顏色不包含粗糙度通道時為黑色。 | IMAGE | + +> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeTextureFromVoxel/zh-TW.md) + +--- +**Source fingerprint (SHA-256):** `419f9e064edaeb9db8d5e052cf57a3b8b77bf7e025e8a0fc9aa0e1919c06b51c` diff --git a/comfyui_embedded_docs/docs/BakeTextureFromVoxel/zh.md b/comfyui_embedded_docs/docs/BakeTextureFromVoxel/zh.md new file mode 100644 index 000000000..c76a8a242 --- /dev/null +++ b/comfyui_embedded_docs/docs/BakeTextureFromVoxel/zh.md @@ -0,0 +1,31 @@ +# BakeTextureFromVoxel + +此节点使用网格现有的 UV 布局将 PBR 纹理烘焙到 3D 网格上。它在每个纹素处从稀疏体素体积中采样颜色和材质属性,并输出基础颜色图像以及金属度和粗糙度贴图。它不会对网格进行 UV 展开,因此必须在上游连接一个 UV 展开节点。 + +## 输入 + +| 参数 | 描述 | 数据类型 | 必填 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `mesh` | 要烘焙纹理的 3D 网格。必须已具有 UV 布局;必须在上游连接 UV 展开节点。 | MESH | 是 | | +| `voxel_colors` | 包含逐体素颜色以及可选 PBR 属性(金属度和粗糙度通道)的稀疏体素体积。 | VOXEL | 是 | | +| `texture_size` | 方形 UV 图集的分辨率(显示名称:"resolution",默认值:2048)。 | INT | 是 | 64 to 8192 | +| `reference_mesh` | 可选的减面前密集网格;在采样前将每个纹素反向投影到其真实表面,从而消除粗网格上的棱面化烘焙效果。 | MESH | 否 | | + +说明: + +- 输入网格必须具有 UV。如果不存在 UV,节点将引发错误。UV 必须与顶点一一对应(每个顶点一个 UV)。 +- 当网格和体素坐标包含批次维度时,每个批次项会单独烘焙。如果某个批次项没有体素或没有面,则跳过该项并为其输出黑色纹理。 +- 当为批次提供 `reference_mesh` 时,将按批次索引进行匹配;除非其中仅包含单个网格,在这种情况下,该网格将用于所有批次项。 + +## 输出 + +| 输出名 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `base_color` | RGB 基础颜色纹理贴图。值为 0–1 范围内的浮点数。 | IMAGE | +| `metallic` | 灰度金属度贴图(float,0–1)。当体素颜色不包含金属度通道时为黑色。 | IMAGE | +| `roughness` | 灰度粗糙度贴图(float,0–1)。当体素颜色不包含粗糙度通道时为黑色。 | IMAGE | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeTextureFromVoxel/zh.md) + +--- +**Source fingerprint (SHA-256):** `419f9e064edaeb9db8d5e052cf57a3b8b77bf7e025e8a0fc9aa0e1919c06b51c` diff --git a/comfyui_embedded_docs/docs/BasicGuider/en.md b/comfyui_embedded_docs/docs/BasicGuider/en.md index 77c3cf175..995a62c7e 100644 --- a/comfyui_embedded_docs/docs/BasicGuider/en.md +++ b/comfyui_embedded_docs/docs/BasicGuider/en.md @@ -18,4 +18,4 @@ The BasicGuider node creates a simple guidance mechanism for the sampling proces > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BasicGuider/en.md) --- -**Source fingerprint (SHA-256):** `87b4662787829c4f00a5cc362f12b1c046fe836f9eb7d90aa40bd48f5cecdf0a` +**Source fingerprint (SHA-256):** `8ea6b56be58ae99baaf13a04c4fadbf8ad921801d8f2ce2aecce768cc34a3b20` diff --git a/comfyui_embedded_docs/docs/BatchLatentsNode/en.md b/comfyui_embedded_docs/docs/BatchLatentsNode/en.md index 2cff1dfec..675ffc866 100644 --- a/comfyui_embedded_docs/docs/BatchLatentsNode/en.md +++ b/comfyui_embedded_docs/docs/BatchLatentsNode/en.md @@ -1,6 +1,6 @@ # Batch Latents -The Batch Latents node combines multiple latent inputs into a single batch. It takes a variable number of latent samples and merges them along the batch dimension, allowing them to be processed together in subsequent nodes. This is useful for generating or processing multiple images in a single operation. +The Batch Latents node combines multiple latent inputs into a single batch. It takes a variable number of latent samples and merges them along the batch dimension so they can be processed together by subsequent nodes. The node also merges the batch index metadata of all inputs into the combined output. ## Inputs @@ -8,15 +8,15 @@ The Batch Latents node combines multiple latent inputs into a single batch. It t | --- | --- | --- | --- | --- | | `latents` | A set of latent samples to be combined into a single batch. You must provide at least one latent, and you can add up to 50. The node automatically creates input slots as you connect more latents. | LATENT | Yes | 1 to 50 inputs | -**Note:** You must provide at least one latent input for the node to function. The node will automatically create input slots as you connect more latents, up to a maximum of 50. +**Note:** You must provide at least one latent input for the node to function. The node automatically creates input slots as you connect more latents, up to a maximum of 50. Each input latent is reshaped to match the sample shape of the first latent before being combined, and any latent without batch index metadata is assigned a sequential batch index. ## Outputs | Output Name | Description | Data Type | | --- | --- | --- | -| `output` | A single latent output containing all the input latents combined into one batch. | LATENT | +| `output` | A single latent output containing all the input latents combined into one batch, together with their merged batch index metadata. | LATENT | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BatchLatentsNode/en.md) --- -**Source fingerprint (SHA-256):** `66b2a315c1ce3842e0ee014edd576e87e959591e6d54576c93cba2116b599736` +**Source fingerprint (SHA-256):** `38df5e6cfa391e054c663af1cc55728d115cebfbb804e1c2c51dfc2aab37df47` diff --git a/comfyui_embedded_docs/docs/BetaSamplingScheduler/en.md b/comfyui_embedded_docs/docs/BetaSamplingScheduler/en.md index 90a850bc6..9a72052f8 100644 --- a/comfyui_embedded_docs/docs/BetaSamplingScheduler/en.md +++ b/comfyui_embedded_docs/docs/BetaSamplingScheduler/en.md @@ -8,8 +8,8 @@ The BetaSamplingScheduler node generates a sequence of noise levels (sigmas) for | --- | --- | --- | --- | --- | | `model` | The model used for sampling, which provides the model sampling object | MODEL | Yes | - | | `steps` | The number of sampling steps to generate sigmas for (default: 20) | INT | Yes | 1 to 10000 | -| `alpha` | Alpha parameter for the beta scheduler, controlling the scheduling curve (default: 0.6) | FLOAT | Yes | 0.0 to 50.0 | -| `beta` | Beta parameter for the beta scheduler, controlling the scheduling curve (default: 0.6) | FLOAT | Yes | 0.0 to 50.0 | +| `alpha` | Alpha parameter for the beta scheduler, controlling the scheduling curve (default: 0.6, advanced parameter) | FLOAT | Yes | 0.0 to 50.0 | +| `beta` | Beta parameter for the beta scheduler, controlling the scheduling curve (default: 0.6, advanced parameter) | FLOAT | Yes | 0.0 to 50.0 | ## Outputs @@ -20,4 +20,4 @@ The BetaSamplingScheduler node generates a sequence of noise levels (sigmas) for > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BetaSamplingScheduler/en.md) --- -**Source fingerprint (SHA-256):** `4be6f9ba853a1c8ff2b8f58ee3e37829a92e1fe9dc1f042fec20f22e04ae9d77` +**Source fingerprint (SHA-256):** `80adae3cbedff7fe544a1fbcf638af7965f1216e422931063ecf67da53ddff95` diff --git a/comfyui_embedded_docs/docs/BriaEraser/en.md b/comfyui_embedded_docs/docs/BriaEraser/en.md index 6a6d9f410..f3bd69a91 100644 --- a/comfyui_embedded_docs/docs/BriaEraser/en.md +++ b/comfyui_embedded_docs/docs/BriaEraser/en.md @@ -8,15 +8,15 @@ Bria Eraser removes objects or areas from an image using the Bria API. You provi |-----------|-------------|-----------|----------|-------| | `image` | The input image containing the objects or areas to remove. | IMAGE | Yes | - | | `mask` | White areas are erased, black areas are preserved. The mask is binarized before sending, so partially painted areas count as white. Must have the same aspect ratio as the image. | MASK | Yes | - | -| `mask_type` | Selects how the mask was created. "manual" is for hand-drawn or brush masks; "automatic" is for masks produced by segmentation models such as SAM. | STRING | Yes | "manual"
"automatic" | -| `moderation` | Moderation settings. Set to "true" to enable content moderation on the input and/or output images. | STRING | Yes | "false"
"true" | +| `mask_type` | Selects how the mask was created. "manual" is for hand-drawn or brush masks; "automatic" is for masks produced by segmentation models such as SAM. | COMBO | Yes | "manual"
"automatic" | +| `moderation` | Moderation settings. Set to "true" to enable visual content moderation on the input and/or output images. | DYNAMIC_COMBO | Yes | "false"
"true" | Note: When `moderation` is set to "true", two additional boolean settings become available: - `visual_input_moderation` — applies visual content moderation to the input image (default: false) - `visual_output_moderation` — applies visual content moderation to the output image (default: false) -The mask must match the aspect ratio of the image, otherwise the request fails. The mask is converted to a binary (black and white) mask before being sent to the API, so partially painted areas are treated as white and will be erased. +The mask must match the aspect ratio of the image, otherwise the request fails. The mask is converted to a binary (black and white) mask before being sent to the API: areas painted at less than half opacity are ignored, and partially painted areas are treated as white and will be erased. The mask must contain at least some white area; an empty mask causes the request to fail because there is nothing to erase. ## Outputs diff --git a/comfyui_embedded_docs/docs/BriaExpandImage/en.md b/comfyui_embedded_docs/docs/BriaExpandImage/en.md index bb5da40e2..2f6b9ca9d 100644 --- a/comfyui_embedded_docs/docs/BriaExpandImage/en.md +++ b/comfyui_embedded_docs/docs/BriaExpandImage/en.md @@ -7,7 +7,7 @@ Bria Expand Image expands an image beyond its original borders by generating new | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| | `image` | The input image to be expanded. | IMAGE | Yes | — | -| `expand_mode` | Target shape of the expanded image: a preset aspect ratio, a custom ratio, or manual placement of the original image on a canvas. Manual is the only mode that can reach a canvas taller than 1:2. Selecting `custom_ratio` reveals `ratio_width` and `ratio_height`. Selecting `manual` reveals the canvas and image placement parameters. | COMBO | Yes | `"1:1"`
`"2:3"`
`"3:2"`
`"3:4"`
`"4:3"`
`"4:5"`
`"5:4"`
`"9:16"`
`"16:9"`
`"custom_ratio"`
`"manual"` | +| `expand_mode` | Target shape of the expanded image: a preset aspect ratio, a custom ratio, or manual placement of the original image on a canvas. Manual is the only mode that can reach a canvas taller than 1:2. Selecting `custom_ratio` reveals `ratio_width` and `ratio_height`. Selecting `manual` reveals the canvas and image placement parameters. | DYNAMIC_COMBO | Yes | `"1:1"`
`"2:3"`
`"3:2"`
`"3:4"`
`"4:3"`
`"4:5"`
`"5:4"`
`"9:16"`
`"16:9"`
`"custom_ratio"`
`"manual"` | | `ratio_width` | Width side of the target ratio: 21 and 9 give 21:9. Default: 21. | INT | Conditional | 1–100 | | `ratio_height` | Height side of the target ratio: 21 and 9 give 21:9. Bria only accepts width/height between 0.5 and 3.0, so anything taller than 1:2 needs the manual mode. Default: 9. | INT | Conditional | 1–100 | | `canvas_width` | Width of the output canvas in pixels. Default: 1000. | INT | Conditional | 64–5000 | @@ -19,7 +19,7 @@ Bria Expand Image expands an image beyond its original borders by generating new | `prompt` | Optional description of the expanded scene; when empty, Bria generates one from the image. Default: empty string. | STRING | No | Any string | | `negative_prompt` | An optional negative prompt for the expansion. Default: empty string. | STRING | No | Any string | | `seed` | Seed for the random generation process. Default: 42. | INT | No | 1–2147483647 | -| `moderation` | Moderation settings. When set to `true`, additional moderation options are shown. | COMBO | No | `"false"`
`"true"` | +| `moderation` | Moderation settings. When set to `true`, additional moderation options are shown. | DYNAMIC_COMBO | No | `"false"`
`"true"` | | `prompt_content_moderation` | If enabled, moderates the prompt content. Default: false. Only available when `moderation` is `true`. | BOOLEAN | Conditional | true/false | | `visual_input_moderation` | If enabled, moderates the visual input. Default: false. Only available when `moderation` is `true`. | BOOLEAN | Conditional | true/false | | `visual_output_moderation` | If enabled, moderates the visual output. Default: false. Only available when `moderation` is `true`. | BOOLEAN | Conditional | true/false | diff --git a/comfyui_embedded_docs/docs/BriaImageEditNode/ar.md b/comfyui_embedded_docs/docs/BriaImageEditNode/ar.md index 170732d61..4eef74ece 100644 --- a/comfyui_embedded_docs/docs/BriaImageEditNode/ar.md +++ b/comfyui_embedded_docs/docs/BriaImageEditNode/ar.md @@ -7,16 +7,16 @@ | المعامل | الوصف | نوع البيانات | إلزامي | النطاق | |---|---|---|---|---| -| `model` | إصدار النموذج المستخدم لتحرير الصورة. | COMBO | نعم | `"FIBO"` | -| `image` | صورة الإدخال التي تريد تحريرها. | IMAGE | نعم | - | -| `prompt` | تعليمات لتحرير الصورة (الافتراضي: فارغ). | STRING | نعم | - | -| `negative_prompt` | نص يصف ما لا تريد ظهوره في الصورة المحررة (الافتراضي: فارغ). | STRING | نعم | - | -| `structured_prompt` | سلسلة تحتوي على الموجه المهيكل للتحرير بصيغة JSON. استخدمها بدلاً من الموجه المعتاد للتحكم الدقيق والبرمجي (الافتراضي: فارغ). | STRING | نعم | - | -| `seed` | رقم يُستخدم لتهيئة التوليد العشوائي، مما يضمن نتائج قابلة للتكرار (الافتراضي: 1). | INT | نعم | 1 to 2147483647 | -| `guidance_scale` | القيمة الأعلى تجعل الصورة تتبع الموجه بشكل أكثر دقة (الافتراضي: 3.0). | FLOAT | نعم | 3.0 to 5.0 | -| `steps` | عدد خطوات إزالة الضوضاء التي سينفذها النموذج (الافتراضي: 50). | INT | نعم | 20 to 50 | -| `moderation` | إعدادات الإشراف. تحديد `"true"` يعرض خيارات إشراف إضافية لمحتوى الموجه، والمدخلات المرئية، والمخرجات المرئية. | DYNAMIC_COMBO | نعم | `"false"`
`"true"` | -| `mask` | إذا تم حذفه، ينطبق التعديل على الصورة بأكملها. | MASK | لا | - | +| `النموذج` | إصدار النموذج المستخدم لتحرير الصورة. | COMBO | نعم | `"FIBO"` | +| `الصورة` | صورة الإدخال التي تريد تحريرها. | IMAGE | نعم | - | +| `التوجيه` | تعليمات لتحرير الصورة (الافتراضي: فارغ). | STRING | نعم | - | +| `توجيه سلبي` | نص يصف ما لا تريد ظهوره في الصورة المحررة (الافتراضي: فارغ). | STRING | نعم | - | +| `توجيه منظم` | سلسلة تحتوي على الموجه المهيكل للتحرير بصيغة JSON. استخدمها بدلاً من الموجه المعتاد للتحكم الدقيق والبرمجي (الافتراضي: فارغ). | STRING | نعم | - | +| `البذرة` | رقم يُستخدم لتهيئة التوليد العشوائي، مما يضمن نتائج قابلة للتكرار (الافتراضي: 1). | INT | نعم | 1 to 2147483647 | +| `مقياس التوجيه` | القيمة الأعلى تجعل الصورة تتبع الموجه بشكل أكثر دقة (الافتراضي: 3.0). | FLOAT | نعم | 3.0 to 5.0 | +| `الخطوات` | عدد خطوات إزالة الضوضاء التي سينفذها النموذج (الافتراضي: 50). | INT | نعم | 20 to 50 | +| `الإشراف` | إعدادات الإشراف. تحديد `"true"` يعرض خيارات إشراف إضافية لمحتوى الموجه، والمدخلات المرئية، والمخرجات المرئية. | DYNAMIC_COMBO | نعم | `"false"`
`"true"` | +| `القناع` | إذا تم حذفه، ينطبق التعديل على الصورة بأكملها. | MASK | لا | - | ### مدخلات الإشراف @@ -31,7 +31,7 @@ | اسم المخرج | الوصف | نوع البيانات | |---|---|---| | `IMAGE` | The edited image returned by the Bria API. | IMAGE | -| `structured_prompt` | The structured prompt used or generated during the editing process. | STRING | +| `توجيه منظم` | The structured prompt used or generated during the editing process. | STRING | > تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BriaImageEditNode/ar.md) diff --git a/comfyui_embedded_docs/docs/BriaImageEditNode/en.md b/comfyui_embedded_docs/docs/BriaImageEditNode/en.md index 69b29f87b..0001a660b 100644 --- a/comfyui_embedded_docs/docs/BriaImageEditNode/en.md +++ b/comfyui_embedded_docs/docs/BriaImageEditNode/en.md @@ -1,6 +1,6 @@ # Bria FIBO Image Edit -The Bria FIBO Image Edit node lets you edit an existing image with a text instruction. It sends the image and your prompt to the Bria API, which uses the FIBO model to create an edited version of the image. You can also provide a mask to limit the changes to a specific area. +The Bria FIBO Image Edit node edits an existing image using a text instruction. It sends the image and your prompt to the Bria API, where the FIBO model creates an edited version. An optional mask can limit the changes to a specific area. ## Inputs diff --git a/comfyui_embedded_docs/docs/BriaImageEditNode/es.md b/comfyui_embedded_docs/docs/BriaImageEditNode/es.md index 7f1d93d1f..182262624 100644 --- a/comfyui_embedded_docs/docs/BriaImageEditNode/es.md +++ b/comfyui_embedded_docs/docs/BriaImageEditNode/es.md @@ -8,16 +8,16 @@ El nodo **Bria FIBO Image Edit** te permite editar una imagen existente con una | Parámetro | Descripción | Tipo de datos | Obligatorio | Rango | |-----------|-------------|---------------|-------------|-------| -| `model` | La versión del modelo a utilizar para la edición de imágenes. | COMBO | Sí | `"FIBO"` | -| `image` | La imagen de entrada que deseas editar. | IMAGE | Sí | - | -| `prompt` | Instrucción para editar la imagen (predeterminado: vacío). | STRING | Sí | - | -| `negative_prompt` | Texto que describe lo que no deseas que aparezca en la imagen editada (predeterminado: vacío). | STRING | Sí | - | -| `structured_prompt` | Una cadena que contiene el prompt de edición estructurado en formato JSON. Úsala en lugar del prompt habitual para un control preciso y programático (predeterminado: vacío). | STRING | Sí | - | -| `seed` | Un número utilizado para inicializar la generación aleatoria, garantizando resultados reproducibles (predeterminado: 1). | INT | Sí | 1 a 2147483647 | -| `guidance_scale` | Un valor más alto hace que la imagen siga el prompt más fielmente (predeterminado: 3). | FLOAT | Sí | 3.0 a 5.0 | -| `steps` | El número de pasos de eliminación de ruido realizados por el modelo (predeterminado: 50). | INT | Sí | 20 a 50 | -| `moderation` | Configuración de moderación. Seleccionar `"true"` revela opciones de moderación adicionales. | DYNAMIC_COMBO | Sí | `"false"`
`"true"` | -| `mask` | Si se omite, la edición se aplica a toda la imagen. | MASK | No | - | +| `modelo` | La versión del modelo a utilizar para la edición de imágenes. | COMBO | Sí | `"FIBO"` | +| `imagen` | La imagen de entrada que deseas editar. | IMAGE | Sí | - | +| `instrucción` | Instrucción para editar la imagen (predeterminado: vacío). | STRING | Sí | - | +| `instrucción_negativa` | Texto que describe lo que no deseas que aparezca en la imagen editada (predeterminado: vacío). | STRING | Sí | - | +| `instrucción_estructurada` | Una cadena que contiene el prompt de edición estructurado en formato JSON. Úsala en lugar del prompt habitual para un control preciso y programático (predeterminado: vacío). | STRING | Sí | - | +| `semilla` | Un número utilizado para inicializar la generación aleatoria, garantizando resultados reproducibles (predeterminado: 1). | INT | Sí | 1 a 2147483647 | +| `escala_de_guía` | Un valor más alto hace que la imagen siga el prompt más fielmente (predeterminado: 3). | FLOAT | Sí | 3.0 a 5.0 | +| `pasos` | El número de pasos de eliminación de ruido realizados por el modelo (predeterminado: 50). | INT | Sí | 20 a 50 | +| `moderación` | Configuración de moderación. Seleccionar `"true"` revela opciones de moderación adicionales. | DYNAMIC_COMBO | Sí | `"false"`
`"true"` | +| `máscara` | Si se omite, la edición se aplica a toda la imagen. | MASK | No | - | ### Entradas de moderación @@ -39,7 +39,7 @@ Cuando `moderation` se establece en `"true"`, se habilitan estas entradas adicio | Nombre de salida | Descripción | Tipo de datos | |------------------|-------------|---------------| | `IMAGE` | La imagen editada devuelta por la API de Bria. | IMAGE | -| `structured_prompt` | El prompt estructurado utilizado o generado durante el proceso de edición. | STRING | +| `instrucción_estructurada` | El prompt estructurado utilizado o generado durante el proceso de edición. | STRING | > Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BriaImageEditNode/es.md) diff --git a/comfyui_embedded_docs/docs/BriaImageEditNode/fr.md b/comfyui_embedded_docs/docs/BriaImageEditNode/fr.md index f510bfa3b..f73d20263 100644 --- a/comfyui_embedded_docs/docs/BriaImageEditNode/fr.md +++ b/comfyui_embedded_docs/docs/BriaImageEditNode/fr.md @@ -8,16 +8,16 @@ Le nœud Bria FIBO Image Edit vous permet de modifier une image existante à l'a | Paramètre | Description | Type de données | Requis | Plage | |-----------|-------------|-----------------|--------|-------| -| `model` | La version du modèle à utiliser pour la modification d'image. | COMBO | Oui | `"FIBO"` | +| `modèle` | La version du modèle à utiliser pour la modification d'image. | COMBO | Oui | `"FIBO"` | | `image` | L'image d'entrée que vous souhaitez modifier. | IMAGE | Oui | - | -| `prompt` | Instruction pour modifier l'image (défaut : vide). | STRING | Oui | - | -| `negative_prompt` | Texte décrivant ce que vous ne voulez pas voir apparaître dans l'image modifiée (défaut : vide). | STRING | Oui | - | -| `structured_prompt` | Chaîne contenant le prompt de modification structuré au format JSON. Utilisez-la à la place du prompt habituel pour un contrôle précis et programmatique (défaut : vide). | STRING | Oui | - | -| `seed` | Nombre utilisé pour initialiser la génération aléatoire, garantissant des résultats reproductibles (défaut : 1). | INT | Oui | 1 à 2147483647 | -| `guidance_scale` | Une valeur plus élevée fait que l'image suit le prompt plus fidèlement (défaut : 3). | FLOAT | Oui | 3.0 à 5.0 | -| `steps` | Le nombre d'étapes de débruitage effectuées par le modèle (défaut : 50). | INT | Oui | 20 à 50 | -| `moderation` | Paramètres de modération. La sélection de `"true"` révèle des options de modération supplémentaires. | DYNAMIC_COMBO | Oui | `"false"`
`"true"` | -| `mask` | S'il est omis, la modification s'applique à l'image entière. | MASK | Non | - | +| `invite` | Instruction pour modifier l'image (défaut : vide). | STRING | Oui | - | +| `invite négative` | Texte décrivant ce que vous ne voulez pas voir apparaître dans l'image modifiée (défaut : vide). | STRING | Oui | - | +| `invite structurée` | Chaîne contenant le prompt de modification structuré au format JSON. Utilisez-la à la place du prompt habituel pour un contrôle précis et programmatique (défaut : vide). | STRING | Oui | - | +| `graine` | Nombre utilisé pour initialiser la génération aléatoire, garantissant des résultats reproductibles (défaut : 1). | INT | Oui | 1 à 2147483647 | +| `échelle de guidage` | Une valeur plus élevée fait que l'image suit le prompt plus fidèlement (défaut : 3). | FLOAT | Oui | 3.0 à 5.0 | +| `étapes` | Le nombre d'étapes de débruitage effectuées par le modèle (défaut : 50). | INT | Oui | 20 à 50 | +| `modération` | Paramètres de modération. La sélection de `"true"` révèle des options de modération supplémentaires. | DYNAMIC_COMBO | Oui | `"false"`
`"true"` | +| `masque` | S'il est omis, la modification s'applique à l'image entière. | MASK | Non | - | ### Entrées de modération @@ -39,7 +39,7 @@ Lorsque `moderation` est défini sur `"true"`, ces entrées supplémentaires dev | Nom de sortie | Description | Type de données | |---------------|-------------|-----------------| | `IMAGE` | L'image modifiée renvoyée par l'API Bria. | IMAGE | -| `structured_prompt` | Le prompt structuré utilisé ou généré lors du processus de modification. | STRING | +| `invite structurée` | Le prompt structuré utilisé ou généré lors du processus de modification. | STRING | > Cette documentation a été générée par IA. Si vous trouvez des erreurs ou avez des suggestions d'amélioration, n'hésitez pas à contribuer ! [Modifier sur GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BriaImageEditNode/fr.md) diff --git a/comfyui_embedded_docs/docs/BriaImageEditNode/ja.md b/comfyui_embedded_docs/docs/BriaImageEditNode/ja.md index a0730353d..ba75813e2 100644 --- a/comfyui_embedded_docs/docs/BriaImageEditNode/ja.md +++ b/comfyui_embedded_docs/docs/BriaImageEditNode/ja.md @@ -9,15 +9,15 @@ Bria FIBO Image Edit ノードは、テキストによる指示で既存の画 | パラメータ | 説明 | データ型 | 必須 | 範囲 | |-----------|-------------|-----------|----------|-------| | `model` | 画像編集に使用するモデルバージョン。 | COMBO | 必須 | `"FIBO"` | -| `image` | 編集する入力画像。 | IMAGE | 必須 | - | -| `prompt` | 画像を編集するための指示(デフォルト:空)。 | STRING | 必須 | - | -| `negative_prompt` | 編集後の画像に表示させたくない内容を説明するテキスト(デフォルト:空)。 | STRING | 必須 | - | -| `structured_prompt` | JSON 形式の構造化編集プロンプトを含む文字列。通常のプロンプトの代わりにこれを使用すると、正確でプログラム的な制御が可能です(デフォルト:空)。 | STRING | 必須 | - | -| `seed` | ランダム生成を初期化するために使用する数値。再現可能な結果を保証します(デフォルト:1)。 | INT | 必須 | 1 から 2147483647 | -| `guidance_scale` | 値を大きくすると、画像がプロンプトにより忠実に従うようになります(デフォルト:3)。 | FLOAT | 必須 | 3.0 から 5.0 | -| `steps` | モデルが実行するノイズ除去ステップ数(デフォルト:50)。 | INT | 必須 | 20 から 50 | -| `moderation` | モデレーション設定。`"true"` を選択すると、追加のモデレーションオプションが表示されます。 | DYNAMIC_COMBO | 必須 | `"false"`
`"true"` | -| `mask` | 省略した場合、編集は画像全体に適用されます。 | MASK | 任意 | - | +| `画像` | 編集する入力画像。 | IMAGE | 必須 | - | +| `プロンプト` | 画像を編集するための指示(デフォルト:空)。 | STRING | 必須 | - | +| `ネガティブプロンプト` | 編集後の画像に表示させたくない内容を説明するテキスト(デフォルト:空)。 | STRING | 必須 | - | +| `構造化プロンプト` | JSON 形式の構造化編集プロンプトを含む文字列。通常のプロンプトの代わりにこれを使用すると、正確でプログラム的な制御が可能です(デフォルト:空)。 | STRING | 必須 | - | +| `シード` | ランダム生成を初期化するために使用する数値。再現可能な結果を保証します(デフォルト:1)。 | INT | 必須 | 1 から 2147483647 | +| `ガイダンススケール` | 値を大きくすると、画像がプロンプトにより忠実に従うようになります(デフォルト:3)。 | FLOAT | 必須 | 3.0 から 5.0 | +| `ステップ数` | モデルが実行するノイズ除去ステップ数(デフォルト:50)。 | INT | 必須 | 20 から 50 | +| `モデレーション` | モデレーション設定。`"true"` を選択すると、追加のモデレーションオプションが表示されます。 | DYNAMIC_COMBO | 必須 | `"false"`
`"true"` | +| `マスク` | 省略した場合、編集は画像全体に適用されます。 | MASK | 任意 | - | ### モデレーション入力 @@ -39,7 +39,7 @@ Bria FIBO Image Edit ノードは、テキストによる指示で既存の画 | 出力名 | 説明 | データ型 | |-------------|-------------|-----------| | `IMAGE` | Bria API によって返された編集後の画像。 | IMAGE | -| `structured_prompt` | 編集処理中に使用または生成された構造化プロンプト。 | STRING | +| `構造化プロンプト` | 編集処理中に使用または生成された構造化プロンプト。 | STRING | > このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BriaImageEditNode/ja.md) diff --git a/comfyui_embedded_docs/docs/BriaImageEditNode/ko.md b/comfyui_embedded_docs/docs/BriaImageEditNode/ko.md index 4d03b60f4..31fc19735 100644 --- a/comfyui_embedded_docs/docs/BriaImageEditNode/ko.md +++ b/comfyui_embedded_docs/docs/BriaImageEditNode/ko.md @@ -10,14 +10,14 @@ Bria FIBO 이미지 편집 노드를 사용하면 텍스트 지시문으로 기 |-----------|-------------|-----------|----------|-------| | `model` | 이미지 편집에 사용할 모델 버전입니다. | COMBO | 예 | `"FIBO"` | | `image` | 편집하려는 입력 이미지입니다. | IMAGE | 예 | - | -| `prompt` | 이미지 편집 지시문입니다 (기본값: 비어 있음). | STRING | 예 | - | -| `negative_prompt` | 편집된 이미지에 나타나지 않아야 할 내용을 설명하는 텍스트입니다 (기본값: 비어 있음). | STRING | 예 | - | -| `structured_prompt` | JSON 형식의 구조화된 편집 프롬프트가 포함된 문자열입니다. 정밀하고 프로그래밍 방식의 제어를 위해 일반 프롬프트 대신 이 값을 사용합니다 (기본값: 비어 있음). | STRING | 예 | - | -| `seed` | 무작위 생성을 초기화하는 데 사용되는 숫자로, 재현 가능한 결과를 보장합니다 (기본값: 1). | INT | 예 | 1 ~ 2147483647 | -| `guidance_scale` | 값이 높을수록 이미지가 프롬프트를 더 밀접하게 따릅니다 (기본값: 3). | FLOAT | 예 | 3.0 ~ 5.0 | -| `steps` | 모델이 수행하는 노이즈 제거 단계 수입니다 (기본값: 50). | INT | 예 | 20 ~ 50 | -| `moderation` | 콘텐츠 검열 설정입니다. `"true"`를 선택하면 추가 검열 옵션이 표시됩니다. | DYNAMIC_COMBO | 예 | `"false"`
`"true"` | -| `mask` | 생략하면 편집이 전체 이미지에 적용됩니다. | MASK | 아니요 | - | +| `프롬프트` | 이미지 편집 지시문입니다 (기본값: 비어 있음). | STRING | 예 | - | +| `네거티브 프롬프트` | 편집된 이미지에 나타나지 않아야 할 내용을 설명하는 텍스트입니다 (기본값: 비어 있음). | STRING | 예 | - | +| `구조화된 프롬프트` | JSON 형식의 구조화된 편집 프롬프트가 포함된 문자열입니다. 정밀하고 프로그래밍 방식의 제어를 위해 일반 프롬프트 대신 이 값을 사용합니다 (기본값: 비어 있음). | STRING | 예 | - | +| `시드` | 무작위 생성을 초기화하는 데 사용되는 숫자로, 재현 가능한 결과를 보장합니다 (기본값: 1). | INT | 예 | 1 ~ 2147483647 | +| `가이던스 스케일` | 값이 높을수록 이미지가 프롬프트를 더 밀접하게 따릅니다 (기본값: 3). | FLOAT | 예 | 3.0 ~ 5.0 | +| `스텝` | 모델이 수행하는 노이즈 제거 단계 수입니다 (기본값: 50). | INT | 예 | 20 ~ 50 | +| `모더레이션` | 콘텐츠 검열 설정입니다. `"true"`를 선택하면 추가 검열 옵션이 표시됩니다. | DYNAMIC_COMBO | 예 | `"false"`
`"true"` | +| `마스크` | 생략하면 편집이 전체 이미지에 적용됩니다. | MASK | 아니요 | - | ### 검열 입력 @@ -39,7 +39,7 @@ Bria FIBO 이미지 편집 노드를 사용하면 텍스트 지시문으로 기 | 출력 이름 | 설명 | 데이터 타입 | |-------------|-------------|-----------| | `IMAGE` | Bria API에서 반환된 편집된 이미지입니다. | IMAGE | -| `structured_prompt` | 편집 과정에서 사용되거나 생성된 구조화된 프롬프트입니다. | STRING | +| `구조화된 프롬프트` | 편집 과정에서 사용되거나 생성된 구조화된 프롬프트입니다. | STRING | > 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BriaImageEditNode/ko.md) diff --git a/comfyui_embedded_docs/docs/BriaImageEditNode/pt-BR.md b/comfyui_embedded_docs/docs/BriaImageEditNode/pt-BR.md index ca6b8de01..ec6c67a0a 100644 --- a/comfyui_embedded_docs/docs/BriaImageEditNode/pt-BR.md +++ b/comfyui_embedded_docs/docs/BriaImageEditNode/pt-BR.md @@ -7,16 +7,16 @@ O nó Bria FIBO Image Edit permite modificar uma imagem existente usando uma ins | Parâmetro | Descrição | Tipo de dados | Obrigatório | Intervalo | |---|---|---|---|---| -| `model` | A versão do modelo a ser usada para edição de imagem. | COMBO | Sim | `"FIBO"` | -| `image` | A imagem de entrada que você deseja editar. | IMAGE | Sim | - | +| `modelo` | A versão do modelo a ser usada para edição de imagem. | COMBO | Sim | `"FIBO"` | +| `imagem` | A imagem de entrada que você deseja editar. | IMAGE | Sim | - | | `prompt` | Instrução para editar a imagem (padrão: vazio). | STRING | Sim | - | -| `negative_prompt` | Texto descrevendo o que você não deseja que apareça na imagem editada (padrão: vazio). | STRING | Sim | - | -| `structured_prompt` | Uma string contendo o prompt de edição estruturado em formato JSON. Use este em vez do prompt usual para controle preciso e programático (padrão: vazio). | STRING | Sim | - | -| `seed` | Um número usado para inicializar a geração aleatória, garantindo resultados reproduzíveis (padrão: 1). | INT | Sim | 1 to 2147483647 | -| `guidance_scale` | Valores mais altos fazem a imagem seguir o prompt mais fielmente (padrão: 3.0). | FLOAT | Sim | 3.0 to 5.0 | -| `steps` | O número de etapas de remoção de ruído que o modelo executará (padrão: 50). | INT | Sim | 20 to 50 | -| `moderation` | Configurações de moderação. Selecionar `"true"` revela opções adicionais de moderação para conteúdo do prompt, entrada visual e saída visual. | DYNAMIC_COMBO | Sim | `"false"`
`"true"` | -| `mask` | Se omitida, a edição se aplica a toda a imagem. | MASK | Não | - | +| `prompt_negativo` | Texto descrevendo o que você não deseja que apareça na imagem editada (padrão: vazio). | STRING | Sim | - | +| `prompt_estruturado` | Uma string contendo o prompt de edição estruturado em formato JSON. Use este em vez do prompt usual para controle preciso e programático (padrão: vazio). | STRING | Sim | - | +| `semente` | Um número usado para inicializar a geração aleatória, garantindo resultados reproduzíveis (padrão: 1). | INT | Sim | 1 to 2147483647 | +| `escala_de_guia` | Valores mais altos fazem a imagem seguir o prompt mais fielmente (padrão: 3.0). | FLOAT | Sim | 3.0 to 5.0 | +| `passos` | O número de etapas de remoção de ruído que o modelo executará (padrão: 50). | INT | Sim | 20 to 50 | +| `moderação` | Configurações de moderação. Selecionar `"true"` revela opções adicionais de moderação para conteúdo do prompt, entrada visual e saída visual. | DYNAMIC_COMBO | Sim | `"false"`
`"true"` | +| `máscara` | Se omitida, a edição se aplica a toda a imagem. | MASK | Não | - | ### Entradas de moderação diff --git a/comfyui_embedded_docs/docs/BriaImageEditNode/ru.md b/comfyui_embedded_docs/docs/BriaImageEditNode/ru.md index 778e00bd4..456a00011 100644 --- a/comfyui_embedded_docs/docs/BriaImageEditNode/ru.md +++ b/comfyui_embedded_docs/docs/BriaImageEditNode/ru.md @@ -8,15 +8,15 @@ | Параметр | Описание | Тип данных | Обязательный | Диапазон | |---|---|---|---|---| | `model` | Версия модели для использования при редактировании изображения. | COMBO | Да | `"FIBO"` | -| `image` | Входное изображение, которое вы хотите отредактировать. | IMAGE | Да | - | -| `prompt` | Инструкция для редактирования изображения (по умолчанию: пусто). | STRING | Да | - | -| `negative_prompt` | Текст, описывающий то, что вы не хотите видеть в отредактированном изображении (по умолчанию: пусто). | STRING | Да | - | -| `structured_prompt` | Строка, содержащая структурированный запрос на редактирование в формате JSON. Используйте это вместо обычного запроса для точного программного управления (по умолчанию: пусто). | STRING | Да | - | +| `изображение` | Входное изображение, которое вы хотите отредактировать. | IMAGE | Да | - | +| `промпт` | Инструкция для редактирования изображения (по умолчанию: пусто). | STRING | Да | - | +| `негативный_промпт` | Текст, описывающий то, что вы не хотите видеть в отредактированном изображении (по умолчанию: пусто). | STRING | Да | - | +| `структурированный_промпт` | Строка, содержащая структурированный запрос на редактирование в формате JSON. Используйте это вместо обычного запроса для точного программного управления (по умолчанию: пусто). | STRING | Да | - | | `seed` | Число, используемое для инициализации случайной генерации, обеспечивающее воспроизводимые результаты (по умолчанию: 1). | INT | Да | 1 to 2147483647 | | `guidance_scale` | Более высокое значение заставляет изображение более точно следовать запросу (по умолчанию: 3.0). | FLOAT | Да | 3.0 to 5.0 | -| `steps` | Количество шагов денойзинга, которые выполнит модель (по умолчанию: 50). | INT | Да | 20 to 50 | -| `moderation` | Настройки модерации. Выбор `"true"` открывает дополнительные параметры модерации для содержимого запроса, визуального ввода и визуального вывода. | DYNAMIC_COMBO | Да | `"false"`
`"true"` | -| `mask` | Если не указана, редактирование применяется ко всему изображению. | MASK | Нет | - | +| `шаги` | Количество шагов денойзинга, которые выполнит модель (по умолчанию: 50). | INT | Да | 20 to 50 | +| `модерация` | Настройки модерации. Выбор `"true"` открывает дополнительные параметры модерации для содержимого запроса, визуального ввода и визуального вывода. | DYNAMIC_COMBO | Да | `"false"`
`"true"` | +| `маска` | Если не указана, редактирование применяется ко всему изображению. | MASK | Нет | - | ### Входы модерации @@ -31,7 +31,7 @@ | Имя выхода | Описание | Тип данных | |---|---|---| | `IMAGE` | The edited image returned by the Bria API. | IMAGE | -| `structured_prompt` | The structured prompt used or generated during the editing process. | STRING | +| `структурированный_промпт` | The structured prompt used or generated during the editing process. | STRING | > Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BriaImageEditNode/ru.md) diff --git a/comfyui_embedded_docs/docs/BriaImageEditNode/tr.md b/comfyui_embedded_docs/docs/BriaImageEditNode/tr.md index 1ec95d059..5f1b9bf5a 100644 --- a/comfyui_embedded_docs/docs/BriaImageEditNode/tr.md +++ b/comfyui_embedded_docs/docs/BriaImageEditNode/tr.md @@ -31,7 +31,7 @@ Bria FIBO Image Edit düğümü, mevcut bir görseli metin talimatı kullanarak | Çıktı Adı | Açıklama | Veri Türü | |---|---|---| | `IMAGE` | The edited image returned by the Bria API. | IMAGE | -| `structured_prompt` | The structured prompt used or generated during the editing process. | STRING | +| `yapılandırılmış_istem` | The structured prompt used or generated during the editing process. | STRING | > Bu belge yapay zeka tarafından oluşturulmuştur. Herhangi bir hata bulursanız veya iyileştirme önerileriniz varsa, katkıda bulunmaktan çekinmeyin! [GitHub'da Düzenle](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BriaImageEditNode/tr.md) diff --git a/comfyui_embedded_docs/docs/BriaImageEditNode/zh-TW.md b/comfyui_embedded_docs/docs/BriaImageEditNode/zh-TW.md index 21732643e..1693af2c1 100644 --- a/comfyui_embedded_docs/docs/BriaImageEditNode/zh-TW.md +++ b/comfyui_embedded_docs/docs/BriaImageEditNode/zh-TW.md @@ -9,15 +9,15 @@ Bria FIBO 影像編輯節點可讓您透過文字指令編輯現有影像。它 | 參數 | 說明 | 資料類型 | 必填 | 範圍 | |-----------|-------------|-----------|----------|-------| | `model` | 用於影像編輯的模型版本。 | COMBO | 是 | `"FIBO"` | -| `image` | 您想要編輯的輸入影像。 | IMAGE | 是 | - | -| `prompt` | 編輯影像的指示(預設:空白)。 | STRING | 是 | - | -| `negative_prompt` | 描述您不希望出現在編輯後影像中的文字(預設:空白)。 | STRING | 是 | - | -| `structured_prompt` | 包含 JSON 格式結構化編輯提示詞的字串。若需要精確、程式化的控制,請使用此參數取代一般提示詞(預設:空白)。 | STRING | 是 | - | -| `seed` | 用於初始化隨機生成的數字,確保結果可重現(預設:1)。 | INT | 是 | 1 至 2147483647 | -| `guidance_scale` | 數值越高,影像越貼近提示詞(預設:3)。 | FLOAT | 是 | 3.0 至 5.0 | -| `steps` | 模型執行的去噪步驟數(預設:50)。 | INT | 是 | 20 至 50 | -| `moderation` | 審核設定。選取 `"true"` 會顯示額外的審核選項。 | DYNAMIC_COMBO | 是 | `"false"`
`"true"` | -| `mask` | 若未提供,編輯將套用至整個影像。 | MASK | 否 | - | +| `圖像` | 您想要編輯的輸入影像。 | IMAGE | 是 | - | +| `提示詞` | 編輯影像的指示(預設:空白)。 | STRING | 是 | - | +| `負面提示詞` | 描述您不希望出現在編輯後影像中的文字(預設:空白)。 | STRING | 是 | - | +| `結構化提示詞` | 包含 JSON 格式結構化編輯提示詞的字串。若需要精確、程式化的控制,請使用此參數取代一般提示詞(預設:空白)。 | STRING | 是 | - | +| `種子` | 用於初始化隨機生成的數字,確保結果可重現(預設:1)。 | INT | 是 | 1 至 2147483647 | +| `指引強度` | 數值越高,影像越貼近提示詞(預設:3)。 | FLOAT | 是 | 3.0 至 5.0 | +| `步數` | 模型執行的去噪步驟數(預設:50)。 | INT | 是 | 20 至 50 | +| `審核` | 審核設定。選取 `"true"` 會顯示額外的審核選項。 | DYNAMIC_COMBO | 是 | `"false"`
`"true"` | +| `遮罩` | 若未提供,編輯將套用至整個影像。 | MASK | 否 | - | ### 審核輸入 @@ -39,7 +39,7 @@ Bria FIBO 影像編輯節點可讓您透過文字指令編輯現有影像。它 | 輸出名稱 | 說明 | 資料類型 | |-------------|-------------|-----------| | `IMAGE` | Bria API 回傳的編輯後影像。 | IMAGE | -| `structured_prompt` | 在編輯過程中使用或產生的結構化提示詞。 | STRING | +| `結構化提示詞` | 在編輯過程中使用或產生的結構化提示詞。 | STRING | > 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BriaImageEditNode/zh-TW.md) diff --git a/comfyui_embedded_docs/docs/BriaIncreaseResolution/en.md b/comfyui_embedded_docs/docs/BriaIncreaseResolution/en.md index 0ebd7c34c..9e5d7e6ed 100644 --- a/comfyui_embedded_docs/docs/BriaIncreaseResolution/en.md +++ b/comfyui_embedded_docs/docs/BriaIncreaseResolution/en.md @@ -1,6 +1,6 @@ # BriaIncreaseResolution -Bria Increase Resolution upscales an input image by 2x or 4x using Bria's image upscaling API, preserving the original content. It uploads the image, processes it on the Bria service, and returns the upscaled result as an image. +Bria Increase Resolution upscales an input image by 2x or 4x using Bria's image upscaling service, preserving the original content. It uploads the image, processes it on the Bria service, and returns the upscaled result as an image. ## Inputs @@ -9,9 +9,10 @@ Bria Increase Resolution upscales an input image by 2x or 4x using Bria's image | `image` | The input image to upscale. | IMAGE | Yes | Single image | | `desired_increase` | Resolution multiplier. The output must fit within 8192 pixels on each side. | COMBO | Yes | "2"
"4" | | `auto_downscale` | Automatically lower the multiplier, and downscale the input image if that is still not enough, when the output would exceed the limit. (default: False) | BOOLEAN | Yes | True
False | -| `moderation` | Moderation settings. When set to "true", enables the `visual_input_moderation` and `visual_output_moderation` sub-options, both defaulting to False. | COMBO | Yes | "false"
"true" | +| `moderation` | Moderation settings. When set to "true", enables the `visual_input_moderation` and `visual_output_moderation` sub-options, both defaulting to False. | DYNAMIC_COMBO | Yes | "false"
"true" | Notes: +- When `moderation` is set to "true", the sub-options `visual_input_moderation` and `visual_output_moderation` become available, both defaulting to False. They control moderation of the input image and the output image content. - The node enforces a maximum output side of 8192 pixels. If the selected multiplier would exceed this limit and `auto_downscale` is disabled, an error is raised. Enabling `auto_downscale` allows the node to automatically use a lower multiplier or downscale the input image instead. - Bria first enlarges the short side of the input image to at least 224 pixels before upscaling. Images that are too elongated may trigger an error asking to crop them to a squarer shape. diff --git a/comfyui_embedded_docs/docs/BriaRemoveImageBackground/ar.md b/comfyui_embedded_docs/docs/BriaRemoveImageBackground/ar.md index 77dd5a143..dafdabe1a 100644 --- a/comfyui_embedded_docs/docs/BriaRemoveImageBackground/ar.md +++ b/comfyui_embedded_docs/docs/BriaRemoveImageBackground/ar.md @@ -7,9 +7,9 @@ | المعامل | الوصف | نوع البيانات | إلزامي | النطاق | |---|---|---|---|---| -| `moderation` | إعدادات الإشراف على المحتوى. عند تعيينها على `"true"`، تتوفر خيارات إشراف إضافية. | DYNAMIC_COMBO | نعم | `"false"`
`"true"` | -| `image` | الصورة المدخلة التي سيتم إزالة الخلفية منها. | IMAGE | نعم | - | -| `seed` | تتحكم البذرة (Seed) في ما إذا كان يجب إعادة تشغيل العقدة؛ النتائج غير حتمية بغض النظر عن البذرة. الافتراضي: `0`. | INT | نعم | 0 to 2147483647 | +| `الإشراف` | إعدادات الإشراف على المحتوى. عند تعيينها على `"true"`، تتوفر خيارات إشراف إضافية. | DYNAMIC_COMBO | نعم | `"false"`
`"true"` | +| `صورة` | الصورة المدخلة التي سيتم إزالة الخلفية منها. | IMAGE | نعم | - | +| `البذرة` | تتحكم البذرة (Seed) في ما إذا كان يجب إعادة تشغيل العقدة؛ النتائج غير حتمية بغض النظر عن البذرة. الافتراضي: `0`. | INT | نعم | 0 to 2147483647 | ### مدخلات الإشراف diff --git a/comfyui_embedded_docs/docs/BriaRemoveImageBackground/es.md b/comfyui_embedded_docs/docs/BriaRemoveImageBackground/es.md index 925f27067..4e71c434d 100644 --- a/comfyui_embedded_docs/docs/BriaRemoveImageBackground/es.md +++ b/comfyui_embedded_docs/docs/BriaRemoveImageBackground/es.md @@ -10,9 +10,9 @@ El selector `moderation` revela opciones de moderación adicionales cuando se es | Parámetro | Descripción | Tipo de dato | Obligatorio | Rango | |-----------|-------------|--------------|-------------|-------| -| `moderation` | Configuración de moderación. Cuando se establece en `"true"`, opciones de moderación adicionales quedan disponibles. | DYNAMIC_COMBO | Sí | `"false"`
`"true"` | -| `image` | La imagen de entrada de la que se eliminará el fondo. | IMAGE | Sí | - | -| `seed` | La semilla controla si el nodo debe volver a ejecutarse; los resultados no son deterministas independientemente de la semilla. Por defecto: `0`. | INT | Sí | 0 a 2147483647 | +| `moderación` | Configuración de moderación. Cuando se establece en `"true"`, opciones de moderación adicionales quedan disponibles. | DYNAMIC_COMBO | Sí | `"false"`
`"true"` | +| `imagen` | La imagen de entrada de la que se eliminará el fondo. | IMAGE | Sí | - | +| `semilla` | La semilla controla si el nodo debe volver a ejecutarse; los resultados no son deterministas independientemente de la semilla. Por defecto: `0`. | INT | Sí | 0 a 2147483647 | ### Entradas de moderación "true" diff --git a/comfyui_embedded_docs/docs/BriaRemoveImageBackground/fr.md b/comfyui_embedded_docs/docs/BriaRemoveImageBackground/fr.md index 05338a093..086cbc436 100644 --- a/comfyui_embedded_docs/docs/BriaRemoveImageBackground/fr.md +++ b/comfyui_embedded_docs/docs/BriaRemoveImageBackground/fr.md @@ -10,9 +10,9 @@ Le sélecteur `moderation` révèle des options de modération supplémentaires | Paramètre | Description | Type de données | Requis | Plage | |-----------|-------------|-----------------|--------|-------| -| `moderation` | Paramètres de modération. Lorsqu'il est défini sur `"true"`, des options de modération supplémentaires deviennent disponibles. | DYNAMIC_COMBO | Oui | `"false"`
`"true"` | +| `modération` | Paramètres de modération. Lorsqu'il est défini sur `"true"`, des options de modération supplémentaires deviennent disponibles. | DYNAMIC_COMBO | Oui | `"false"`
`"true"` | | `image` | L'image d'entrée dont l'arrière-plan sera supprimé. | IMAGE | Oui | - | -| `seed` | La graine contrôle si le nœud doit se réexécuter ; les résultats sont non déterministes quelle que soit la graine. Par défaut : `0`. | INT | Oui | 0 à 2147483647 | +| `graine` | La graine contrôle si le nœud doit se réexécuter ; les résultats sont non déterministes quelle que soit la graine. Par défaut : `0`. | INT | Oui | 0 à 2147483647 | ### Entrées de modération « true » diff --git a/comfyui_embedded_docs/docs/BriaRemoveImageBackground/ja.md b/comfyui_embedded_docs/docs/BriaRemoveImageBackground/ja.md index 0ee410217..ff19d3bc4 100644 --- a/comfyui_embedded_docs/docs/BriaRemoveImageBackground/ja.md +++ b/comfyui_embedded_docs/docs/BriaRemoveImageBackground/ja.md @@ -10,9 +10,9 @@ | パラメータ | 説明 | データ型 | 必須 | 範囲 | |-----------|-------------|-----------|----------|-------| -| `moderation` | モデレーション設定。`"true"` に設定すると、追加のモデレーションオプションが利用可能になります。 | DYNAMIC_COMBO | 必須 | `"false"`
`"true"` | -| `image` | 背景を除去する入力画像。 | IMAGE | 必須 | - | -| `seed` | シードはノードを再実行するかどうかを制御します。シードに関係なく結果は非決定的です。デフォルト: `0`。 | INT | 必須 | 0 から 2147483647 | +| `モデレーション` | モデレーション設定。`"true"` に設定すると、追加のモデレーションオプションが利用可能になります。 | DYNAMIC_COMBO | 必須 | `"false"`
`"true"` | +| `画像` | 背景を除去する入力画像。 | IMAGE | 必須 | - | +| `シード` | シードはノードを再実行するかどうかを制御します。シードに関係なく結果は非決定的です。デフォルト: `0`。 | INT | 必須 | 0 から 2147483647 | ### モデレーション "true" 入力 diff --git a/comfyui_embedded_docs/docs/BriaRemoveImageBackground/pt-BR.md b/comfyui_embedded_docs/docs/BriaRemoveImageBackground/pt-BR.md index 4a6df93f5..2ad925ad0 100644 --- a/comfyui_embedded_docs/docs/BriaRemoveImageBackground/pt-BR.md +++ b/comfyui_embedded_docs/docs/BriaRemoveImageBackground/pt-BR.md @@ -7,9 +7,9 @@ Este nó remove o fundo de uma imagem usando o serviço Bria RMBG 2.0. Ele envia | Parâmetro | Descrição | Tipo de dados | Obrigatório | Intervalo | |---|---|---|---|---| -| `moderation` | Configurações de moderação. Quando definido como `"true"`, opções adicionais de moderação ficam disponíveis. | DYNAMIC_COMBO | Sim | `"false"`
`"true"` | -| `image` | A imagem de entrada da qual o fundo será removido. | IMAGE | Sim | - | -| `seed` | A semente controla se o nó deve ser executado novamente; os resultados são não determinísticos independentemente da semente. Padrão: `0`. | INT | Sim | 0 to 2147483647 | +| `moderação` | Configurações de moderação. Quando definido como `"true"`, opções adicionais de moderação ficam disponíveis. | DYNAMIC_COMBO | Sim | `"false"`
`"true"` | +| `imagem` | A imagem de entrada da qual o fundo será removido. | IMAGE | Sim | - | +| `semente` | A semente controla se o nó deve ser executado novamente; os resultados são não determinísticos independentemente da semente. Padrão: `0`. | INT | Sim | 0 to 2147483647 | ### Entradas de moderação diff --git a/comfyui_embedded_docs/docs/BriaRemoveImageBackground/ru.md b/comfyui_embedded_docs/docs/BriaRemoveImageBackground/ru.md index cfd60edb0..85bf8a57a 100644 --- a/comfyui_embedded_docs/docs/BriaRemoveImageBackground/ru.md +++ b/comfyui_embedded_docs/docs/BriaRemoveImageBackground/ru.md @@ -7,8 +7,8 @@ | Параметр | Описание | Тип данных | Обязательный | Диапазон | |---|---|---|---|---| -| `moderation` | Настройки модерации. Если установлено значение `"true"`, становятся доступны дополнительные параметры модерации. | DYNAMIC_COMBO | Да | `"false"`
`"true"` | -| `image` | Входное изображение, с которого будет удалён фон. | IMAGE | Да | - | +| `модерация` | Настройки модерации. Если установлено значение `"true"`, становятся доступны дополнительные параметры модерации. | DYNAMIC_COMBO | Да | `"false"`
`"true"` | +| `изображение` | Входное изображение, с которого будет удалён фон. | IMAGE | Да | - | | `seed` | Сид управляет тем, должен ли узел выполняться повторно; результаты недетерминированы независимо от сида. По умолчанию: `0`. | INT | Да | 0 to 2147483647 | ### Входы модерации diff --git a/comfyui_embedded_docs/docs/BriaRemoveImageBackground/zh-TW.md b/comfyui_embedded_docs/docs/BriaRemoveImageBackground/zh-TW.md index af8b56ed3..57ecd12a4 100644 --- a/comfyui_embedded_docs/docs/BriaRemoveImageBackground/zh-TW.md +++ b/comfyui_embedded_docs/docs/BriaRemoveImageBackground/zh-TW.md @@ -9,9 +9,9 @@ | 參數 | 描述 | 資料類型 | 必要 | 範圍 | |-----------|-------------|-----------|----------|-------| -| `moderation` | 審核設定。當設定為 `"true"` 時,會提供額外的審核選項。 | DYNAMIC_COMBO | 是 | `"false"`
`"true"` | -| `image` | 要移除背景的輸入影像。 | IMAGE | 是 | - | -| `seed` | 種子控制節點是否應重新執行;無論種子為何,結果皆非確定性。預設值:`0`。 | INT | 是 | 0 至 2147483647 | +| `審核` | 審核設定。當設定為 `"true"` 時,會提供額外的審核選項。 | DYNAMIC_COMBO | 是 | `"false"`
`"true"` | +| `影像` | 要移除背景的輸入影像。 | IMAGE | 是 | - | +| `種子` | 種子控制節點是否應重新執行;無論種子為何,結果皆非確定性。預設值:`0`。 | INT | 是 | 0 至 2147483647 | ### Moderation "true" 輸入 diff --git a/comfyui_embedded_docs/docs/BriaRemoveImageBackground/zh.md b/comfyui_embedded_docs/docs/BriaRemoveImageBackground/zh.md index 38a7a5e89..e996060a4 100644 --- a/comfyui_embedded_docs/docs/BriaRemoveImageBackground/zh.md +++ b/comfyui_embedded_docs/docs/BriaRemoveImageBackground/zh.md @@ -10,9 +10,9 @@ | 参数 | 描述 | 数据类型 | 是否必需 | 范围 | |-----------|-------------|-----------|----------|-------| -| `moderation` | 审核设置。当设置为 `"true"` 时,额外的审核选项将变为可用。 | DYNAMIC_COMBO | 是 | `"false"`
`"true"` | -| `image` | 要移除背景的输入图像。 | IMAGE | 是 | - | -| `seed` | 种子控制节点是否应重新运行;无论种子如何,结果都是非确定性的。默认值:`0`。 | INT | 是 | 0 到 2147483647 | +| `内容审核` | 审核设置。当设置为 `"true"` 时,额外的审核选项将变为可用。 | DYNAMIC_COMBO | 是 | `"false"`
`"true"` | +| `图像` | 要移除背景的输入图像。 | IMAGE | 是 | - | +| `种子` | 种子控制节点是否应重新运行;无论种子如何,结果都是非确定性的。默认值:`0`。 | INT | 是 | 0 到 2147483647 | ### `moderation` 为 `"true"` 时的输入 diff --git a/comfyui_embedded_docs/docs/BriaRemoveVideoBackground/en.md b/comfyui_embedded_docs/docs/BriaRemoveVideoBackground/en.md index 140fb0729..95b9fc735 100644 --- a/comfyui_embedded_docs/docs/BriaRemoveVideoBackground/en.md +++ b/comfyui_embedded_docs/docs/BriaRemoveVideoBackground/en.md @@ -7,8 +7,8 @@ This node removes the background from a video using the Bria AI service. It proc | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| | `video` | The input video file from which the background will be removed. | VIDEO | Yes | N/A | -| `background_color` | Background color for the output video. | STRING | Yes | `"Black"`
`"White"`
`"Gray"`
`"Red"`
`"Green"`
`"Blue"`
`"Yellow"`
`"Cyan"`
`"Magenta"`
`"Orange"` | -| `seed` | Seed controls whether the node should re-run; results are non-deterministic regardless of seed. (default: 0) | INT | No | 0 to 2147483647 | +| `background_color` | Background color for the output video. | COMBO | Yes | `"Black"`
`"White"`
`"Gray"`
`"Red"`
`"Green"`
`"Blue"`
`"Yellow"`
`"Cyan"`
`"Magenta"`
`"Orange"` | +| `seed` | Seed controls whether the node should re-run; results are non-deterministic regardless of seed. (default: 0) | INT | Yes | 0 to 2147483647 | **Note:** The input video must have a duration of 60 seconds or less. @@ -16,9 +16,9 @@ This node removes the background from a video using the Bria AI service. It proc | Output Name | Description | Data Type | |-------------|-------------|-----------| -| `output` | The processed video file with the background removed and replaced by the selected color. | VIDEO | +| `output` | The processed video file with the background removed and replaced by the selected color, encoded as MP4 with H.264 codec. | VIDEO | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BriaRemoveVideoBackground/en.md) --- -**Source fingerprint (SHA-256):** `7a6b357f104b14cce55f68a84b07970566db8c835703dd2fd6ca7d3216dec561` +**Source fingerprint (SHA-256):** `dbd6b7393f893be5a40322fc96b90bb3d5f1818bdda7b8109b28f48baac44d59` diff --git a/comfyui_embedded_docs/docs/BriaTransparentVideoBackground/en.md b/comfyui_embedded_docs/docs/BriaTransparentVideoBackground/en.md index 3d551a4a5..963ffe290 100644 --- a/comfyui_embedded_docs/docs/BriaTransparentVideoBackground/en.md +++ b/comfyui_embedded_docs/docs/BriaTransparentVideoBackground/en.md @@ -6,17 +6,17 @@ This node removes the background from a video using Bria's AI service and output | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `video` | The input video to process | VIDEO | Yes | - | +| `video` | The input video to process. The video must be 60 seconds or shorter. | VIDEO | Yes | - | | `seed` | Seed controls whether the node should re-run; results are non-deterministic regardless of seed (default: 0) | INT | Yes | 0 to 2147483647 | ## Outputs | Output Name | Description | Data Type | |-------------|-------------|-----------| -| `images` | The video frames with the background removed | IMAGE | -| `mask` | The alpha mask for the video frames | MASK | +| `images` | The video frames with the background removed, as RGB images in the range 0.0 to 1.0 | IMAGE | +| `mask` | The alpha mask for the video frames, following the Load Image convention where 1 means transparent | MASK | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BriaTransparentVideoBackground/en.md) --- -**Source fingerprint (SHA-256):** `45fb3fc185b5c6420d6ac2b87f2403566e1ef6dcdc57791fb833b6ccb2a64cd9` +**Source fingerprint (SHA-256):** `536bd52af29218d2a342086e92799d3d9310da5ae5cbf02d705ba7503a4d73c8` diff --git a/comfyui_embedded_docs/docs/BriaVideoGreenScreen/en.md b/comfyui_embedded_docs/docs/BriaVideoGreenScreen/en.md index f7adb7baf..b73c1528b 100644 --- a/comfyui_embedded_docs/docs/BriaVideoGreenScreen/en.md +++ b/comfyui_embedded_docs/docs/BriaVideoGreenScreen/en.md @@ -7,7 +7,7 @@ This node replaces a video's background with a solid chroma-key screen using the | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| | `video` | The input video to process | VIDEO | Yes | Video file | -| `green_shade` | Solid chroma-key shade applied behind the foreground: broadcast_green (#00B140), chroma_green (#00FF00), or blue_screen (#0000FF) | STRING | Yes | `"broadcast_green"`
`"chroma_green"`
`"blue_screen"` | +| `green_shade` | Solid chroma-key shade applied behind the foreground: broadcast_green (#00B140), chroma_green (#00FF00), or blue_screen (#0000FF). | COMBO | Yes | `"broadcast_green"`
`"chroma_green"`
`"blue_screen"` | | `seed` | Seed controls whether the node should re-run; results are non-deterministic regardless of seed (default: 0) | INT | Yes | 0 to 2147483647 | **Note:** The input video must not exceed 60 seconds in duration. @@ -16,9 +16,9 @@ This node replaces a video's background with a solid chroma-key screen using the | Output Name | Description | Data Type | |-------------|-------------|-----------| -| `video` | The processed video with the original background replaced by the selected chroma-key shade | VIDEO | +| `video` | The processed video (MP4, H.264) with the original background replaced by the selected chroma-key shade | VIDEO | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BriaVideoGreenScreen/en.md) --- -**Source fingerprint (SHA-256):** `663b41bf51bd8d871a59e756f226e4bf6244bb616ebcd2e8ccfa426137f2a05b` +**Source fingerprint (SHA-256):** `70d2951d0adbbe7492b2bc97d04be6591b65f040ca4b414754ad6365c5db45cf` diff --git a/comfyui_embedded_docs/docs/BriaVideoReplaceBackground/en.md b/comfyui_embedded_docs/docs/BriaVideoReplaceBackground/en.md index d795acfc6..4b4607f97 100644 --- a/comfyui_embedded_docs/docs/BriaVideoReplaceBackground/en.md +++ b/comfyui_embedded_docs/docs/BriaVideoReplaceBackground/en.md @@ -11,15 +11,15 @@ This node replaces the background of a video with a supplied image or video usin | `background_video` | Background video to composite behind the foreground. Provide either a background image or a background video, not both. | VIDEO | No | - | | `seed` | Seed controls whether the node should re-run; results are non-deterministic regardless of seed. (default: 0) | INT | Yes | 0 to 2147483647 | -**Note:** You must provide exactly one of `background_image` or `background_video` — not both and not neither. The foreground video must be 60 seconds or shorter. +**Note:** You must provide exactly one of `background_image` or `background_video` — not both and not neither. The foreground video and the background video (if used) must each be 60 seconds or shorter. When `background_image` is used, its alpha channel is removed before processing. ## Outputs | Output Name | Description | Data Type | |-------------|-------------|-----------| -| `video` | The resulting video with the background replaced. | VIDEO | +| `video` | The resulting video with the background replaced, encoded as MP4 (H.264). | VIDEO | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BriaVideoReplaceBackground/en.md) --- -**Source fingerprint (SHA-256):** `4eb9650e5ca88baf2a91a9309b87936b3d18b88e314a56ab4c73d06a9143c645` +**Source fingerprint (SHA-256):** `c487cf7dd434b8523ce64f241c2171c82bb5e0abdc5c3ca3e8b1a1259aeab490` diff --git a/comfyui_embedded_docs/docs/ByteDance2FirstLastFrameNode/en.md b/comfyui_embedded_docs/docs/ByteDance2FirstLastFrameNode/en.md index cb43ff22d..a5c40d637 100644 --- a/comfyui_embedded_docs/docs/ByteDance2FirstLastFrameNode/en.md +++ b/comfyui_embedded_docs/docs/ByteDance2FirstLastFrameNode/en.md @@ -1,25 +1,66 @@ -# ByteDance Seedance 2.0 First-Last-Frame to Video +# ByteDance Seedance 2.5 First-Last-Frame to Video -This node uses ByteDance's Seedance 2.0 model to generate a video from a required first frame image and an optional last frame image. It creates the video based on a text prompt and the provided frames, with the first frame guiding the start and the last frame guiding the end of the video sequence. +This node generates a video from a required first frame image and an optional last frame image using ByteDance Seedance models. You describe the video with a text prompt; the first frame guides the start of the video and the last frame guides the end. It supports Seedance 2.5 and the Seedance 2.0 family (Seedance 2.0, Seedance 2.0 Fast, and Seedance 2.0 Mini). ## Inputs +### Common Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `model` | Seedance 2.5 for the newest model, videos up to 30 seconds and mp4/mov output; Seedance 2.0 for maximum quality and 4k; Fast for speed optimization; Mini for the fastest, lowest-cost generation. Selecting a model reveals model-specific inputs below. | DYNAMIC_COMBO | Yes | `"Seedance 2.5"`
`"Seedance 2.0"`
`"Seedance 2.0 Fast"`
`"Seedance 2.0 Mini"` | +| `first_frame` | First frame image for the video. | IMAGE | No | - | +| `last_frame` | Last frame image for the video. | IMAGE | No | - | +| `first_frame_asset_id` | Seedance asset_id to use as the first frame. Mutually exclusive with the `first_frame` image input. Default is an empty string. | STRING | No | - | +| `last_frame_asset_id` | Seedance asset_id to use as the last frame. Mutually exclusive with the `last_frame` image input. Default is an empty string. | STRING | No | - | +| `seed` | Seed controls whether the node should re-run; results are non-deterministic regardless of seed. Default is 0. | INT | Yes | 0 to 2147483647 | +| `watermark` | Whether to add a watermark to the video. Default is False. | BOOLEAN | Yes | False
True | + +### Seedance 2.5 Inputs + +These inputs appear when `Seedance 2.5` is selected. + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `prompt` | Text prompt for video generation. Put spoken lines in double quotes to steer the generated dialogue. | STRING | Yes | - | +| `resolution` | Resolution of the output video. Default is 720p. | COMBO | Yes | `"480p"`
`"720p"`
`"1080p"` | +| `duration` | Duration of the output video in seconds (4-30). Default is 5. | INT | Yes | 4 to 30 | +| `generate_audio` | Enable audio generation for the output video. Default is True. | BOOLEAN | Yes | False
True | +| `output_format` | Container format of the output video. Default is mp4. | COMBO | Yes | `"mp4"` | + +### Seedance 2.0 Inputs + +These inputs appear when `Seedance 2.0` is selected. + | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `model` | The model to use for video generation. Seedance 2.0 is for maximum quality, while Seedance 2.0 Fast is optimized for speed. Selecting a model will reveal additional inputs for `prompt`, `resolution`, `ratio`, `duration`, and `generate_audio`. | COMBO | Yes | `"Seedance 2.0"`
`"Seedance 2.0 Fast"` | -| `first_frame` | The image to use as the first frame of the video. | IMAGE | No | - | -| `last_frame` | The image to use as the last frame of the video. | IMAGE | No | - | -| `first_frame_asset_id` | A Seedance asset_id to use as the first frame. This cannot be used at the same time as the `first_frame` image input. Default is an empty string. | STRING | No | - | -| `last_frame_asset_id` | A Seedance asset_id to use as the last frame. This cannot be used at the same time as the `last_frame` image input. Default is an empty string. | STRING | No | - | -| `seed` | A seed value. Changing this seed will cause the node to re-run, but the results are non-deterministic regardless of seed value. Default is 0. | INT | No | 0 to 2147483647 | -| `watermark` | Whether to add a watermark to the generated video. Default is False. | BOOLEAN | No | - | - -**Parameter Constraints:** -* You must provide **either** a `first_frame` image **or** a `first_frame_asset_id`. Providing both will cause an error. -* You must provide at least one of `first_frame` or `first_frame_asset_id` — at least one is required. -* You cannot provide both a `last_frame` image and a `last_frame_asset_id` for the same frame. -* The `model` input is a dynamic combo. After selecting a model, you must also fill in the revealed `prompt` field (a text description) and configure the other revealed parameters (`resolution`, `ratio`, `duration`, `generate_audio`). -* When using local image inputs (not asset IDs), the images must have an aspect ratio between 0.4 and 2.5, and minimum dimensions of 300x300 pixels. +| `prompt` | Text prompt for video generation. | STRING | Yes | - | +| `resolution` | Resolution of the output video. | COMBO | Yes | `"480p"`
`"720p"`
`"1080p"`
`"4k"` | +| `ratio` | Aspect ratio of the output video. Default is `adaptive`, which uses the nearest supported ratio to the input frame's aspect ratio. | COMBO | Yes | `"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"`
`"adaptive"` | +| `duration` | Duration of the output video in seconds (4-15). Default is 7. | INT | Yes | 4 to 15 | +| `generate_audio` | Enable audio generation for the output video. Default is True. | BOOLEAN | Yes | False
True | + +### Seedance 2.0 Fast and Seedance 2.0 Mini Inputs + +Shared by `Seedance 2.0 Fast` and `Seedance 2.0 Mini`. + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `prompt` | Text prompt for video generation. | STRING | Yes | - | +| `resolution` | Resolution of the output video. | COMBO | Yes | `"480p"`
`"720p"` | +| `ratio` | Aspect ratio of the output video. Default is `adaptive`, which uses the nearest supported ratio to the input frame's aspect ratio. | COMBO | Yes | `"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"`
`"adaptive"` | +| `duration` | Duration of the output video in seconds (4-15). Default is 7. | INT | Yes | 4 to 15 | +| `generate_audio` | Enable audio generation for the output video. Default is True. | BOOLEAN | Yes | False
True | + +**Parameter Constraints** + +- You must provide the first frame either as a `first_frame` image or as a `first_frame_asset_id`. Providing both raises an error; providing neither also raises an error. +- The `last_frame` and `last_frame_asset_id` inputs are optional, but you cannot provide both for the same frame. +- Asset IDs must reference existing, active Seedance Image assets. +- The `prompt` input is required and cannot be empty. +- With `Seedance 2.5`, the output aspect ratio is always adaptive and follows the first frame's own aspect ratio, so no `ratio` input is shown. +- With Seedance 2.0 family models and local frame images, the images are center-cropped and resized to the target output resolution and ratio before generation. When `ratio` is `adaptive`, the nearest supported ratio to the input image is used. +- Local frame images are validated for supported aspect ratio and dimensions; oversized images are downscaled. ## Outputs @@ -30,4 +71,4 @@ This node uses ByteDance's Seedance 2.0 model to generate a video from a require > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDance2FirstLastFrameNode/en.md) --- -**Source fingerprint (SHA-256):** `74953cfc8f474a1b5ba7e4765682fd86693e43df87ba59e6d3e615e51293ab07` +**Source fingerprint (SHA-256):** `bc2eb5f43c935986ad870703cfbc92dd99a53d6f0ac91cf0cad46bee33ff2cc0` diff --git a/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/ar.md b/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/ar.md index fcc37e8e7..475a179f0 100644 --- a/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/ar.md +++ b/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/ar.md @@ -11,9 +11,9 @@ | المعامل | الوصف | نوع البيانات | مطلوب | النطاق | |-----------|-------------|-----------|----------|-------| -| `model` | النموذج المستخدم لتوليد الفيديو. Seedance 2.5 لأحدث نموذج، وفيديوهات تصل إلى 30 ثانية وإخراج mp4؛ Seedance 2.0 لأقصى جودة و1080p/4k؛ Fast لتحسين السرعة؛ Mini للأسرع والأقل تكلفة. اختيار النموذج يعرض المدخلات الخاصة به المدرجة أدناه. | COMBO | نعم | `"Seedance 2.5"`
`"Seedance 2.0"`
`"Seedance 2.0 Fast"`
`"Seedance 2.0 Mini"` | -| `seed` | تتحكم البذرة في ما إذا كان ينبغي إعادة تشغيل العقدة؛ النتائج غير حتمية بغض النظر عن البذرة (الافتراضي: 0). | INT | نعم | 0 إلى 2147483647 | -| `watermark` | ما إذا كان سيتم إضافة علامة مائية إلى الفيديو (الافتراضي: False). | BOOLEAN | نعم | `True`
`False` | +| `النموذج` | النموذج المستخدم لتوليد الفيديو. Seedance 2.5 لأحدث نموذج، وفيديوهات تصل إلى 30 ثانية وإخراج mp4؛ Seedance 2.0 لأقصى جودة و1080p/4k؛ Fast لتحسين السرعة؛ Mini للأسرع والأقل تكلفة. اختيار النموذج يعرض المدخلات الخاصة به المدرجة أدناه. | COMBO | نعم | `"Seedance 2.5"`
`"Seedance 2.0"`
`"Seedance 2.0 Fast"`
`"Seedance 2.0 Mini"` | +| `البذرة` | تتحكم البذرة في ما إذا كان ينبغي إعادة تشغيل العقدة؛ النتائج غير حتمية بغض النظر عن البذرة (الافتراضي: 0). | INT | نعم | 0 إلى 2147483647 | +| `علامة مائية` | ما إذا كان سيتم إضافة علامة مائية إلى الفيديو (الافتراضي: False). | BOOLEAN | نعم | `True`
`False` | ### مدخلات Seedance 2.5 diff --git a/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/en.md b/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/en.md index 17d49e35c..8f49845c5 100644 --- a/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/en.md +++ b/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/en.md @@ -1,6 +1,6 @@ -# ByteDance Seedance 2.0 Reference to Video +# ByteDance Seedance 2.5 Reference to Video -This node generates, edits, or extends videos using ByteDance's Seedance 2.5 or 2.0 AI models. You describe the video in a text prompt and can add reference images, videos, and audio to guide the result. It supports multimodal reference inputs, video editing, and video extension. +This node generates, edits, or extends videos using ByteDance's Seedance 2.5 or 2.0 AI models. You describe the video in a text prompt and can add reference images, videos, and audio to guide the result. It supports multimodal reference inputs, video editing, and video extension. This is the legacy, deprecated version of the Seedance reference-to-video node. ## Inputs @@ -10,16 +10,16 @@ Selecting a `model` determines which of the parameters below are available. `vid | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `model` | The AI model used to generate the video. Seedance 2.5 for the newest model, videos up to 30 seconds and mp4 output; Seedance 2.0 for maximum quality and 1080p/4k; Fast for speed optimization; Mini for the fastest, lowest-cost generation. Selecting a model reveals the model-specific inputs listed below. | COMBO | Yes | `"Seedance 2.5"`
`"Seedance 2.0"`
`"Seedance 2.0 Fast"`
`"Seedance 2.0 Mini"` | -| `seed` | Seed controls whether the node should re-run; results are non-deterministic regardless of seed (default: 0). | INT | Yes | 0 to 2147483647 | -| `watermark` | Whether to add a watermark to the video (default: False). | BOOLEAN | Yes | `True`
`False` | +| `model` | The AI model used to generate the video. Seedance 2.5 for the newest model, videos up to 30 seconds and mp4/mov output; Seedance 2.0 for maximum quality and 4k; Fast for speed optimization; Mini for the fastest, lowest-cost generation. Selecting a model reveals the model-specific inputs listed below. | DYNAMIC_COMBO | Yes | `"Seedance 2.5"`
`"Seedance 2.0"`
`"Seedance 2.0 Fast"`
`"Seedance 2.0 Mini"` | +| `seed` | Seed controls whether the node should re-run; results are non-deterministic regardless of seed (default: 0). | INT | Yes | 0 to 2147483647
Step: 1 | +| `watermark` | Whether to add a watermark to the video (default: False). Advanced setting. | BOOLEAN | Yes | `True`
`False` | ### Seedance 2.5 Inputs | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| | `prompt` | Text prompt for video generation. Put spoken lines in double quotes to steer the generated dialogue. Must contain at least one non-whitespace character (default: empty). | STRING | Yes | Any text | -| `resolution` | Resolution of the output video (default: `"720p"`). | COMBO | Yes | `"480p"`
`"720p"` | +| `resolution` | Resolution of the output video (default: `"720p"`). | COMBO | Yes | `"480p"`
`"720p"`
`"1080p"` | | `ratio` | Aspect ratio of the output video (default: `"16:9"`). | COMBO | Yes | `"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"`
`"adaptive"` | | `duration` | Duration of the output video in seconds (default: 5). | INT | Yes | 4 to 30
Step: 1 | | `generate_audio` | Enable audio generation for the output video (default: True). | BOOLEAN | Yes | `True`
`False` | @@ -58,7 +58,7 @@ Available for all models. The maximum number of slots depends on the selected mo | `reference_videos` | Growable slot: connect one or more reference videos (`video_1`, `video_2`, ...) that guide the video generation; used for video editing and extension. | VIDEO | No | Up to 10 (Seedance 2.5)
Up to 3 (Seedance 2.0 models) | | `reference_audios` | Growable slot: connect one or more reference audio clips (`audio_1`, `audio_2`, ...) that guide the video generation. | AUDIO | No | Up to 10 (Seedance 2.5)
Up to 3 (Seedance 2.0 models) | | `auto_downscale` | Automatically downscale reference videos that exceed the model's pixel budget for the selected resolution. Aspect ratio is preserved; videos already within limits are untouched (default: True). | BOOLEAN | No | `True`
`False` | -| `auto_upscale` | Automatically upscale reference videos that are below the model's minimum pixel count for the selected resolution. Aspect ratio is preserved; videos already meeting the minimum are untouched. Note: upscaling a low-resolution source does not add real detail and may produce lower-quality generations (default: False). | BOOLEAN | No | `True`
`False` | +| `auto_upscale` | Advanced setting. Automatically upscale reference videos that are below the model's minimum pixel count for the selected resolution. Aspect ratio is preserved; videos already meeting the minimum are untouched. Note: upscaling a low-resolution source does not add real detail and may produce lower-quality generations (default: False). | BOOLEAN | No | `True`
`False` | | `reference_assets` | Growable slot: IDs of previously created Seedance virtual-library assets (Image, Video, or Audio) to use as references (`asset_1`, `asset_2`, ...). Each asset must exist and have an Active status. In the prompt, assets can be referred to as `asset1`, `asset 1`, etc.; the node replaces these tokens with labels such as "Image 2". | STRING | No | Up to 30 (Seedance 2.5)
Up to 9 (Seedance 2.0 models) | **Important Constraints:** @@ -79,4 +79,4 @@ Available for all models. The maximum number of slots depends on the selected mo > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/en.md) --- -**Source fingerprint (SHA-256):** `4429306ac40b0f04ce7176cd805b34164de5e4e2b7204b008ea076b57663c200` +**Source fingerprint (SHA-256):** `4a1b62f65ff3515cdb749c9b3916e631e53523fe144e8cdf71ca020825196ae6` diff --git a/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/es.md b/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/es.md index be849bb42..9ff9f4779 100644 --- a/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/es.md +++ b/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/es.md @@ -10,9 +10,9 @@ Seleccionar un `model` determina cuáles de los parámetros siguientes están di | Parámetro | Descripción | Tipo de datos | Obligatorio | Rango | |-----------|-------------|-----------|----------|-------| -| `model` | El modelo de IA utilizado para generar el video. Seedance 2.5 para el modelo más nuevo, videos de hasta 30 segundos y salida mp4; Seedance 2.0 para máxima calidad y 1080p/4k; Fast para optimizar la velocidad; Mini para la generación más rápida y de menor costo. Seleccionar un modelo revela las entradas específicas del modelo que se enumeran a continuación. | COMBO | Sí | `"Seedance 2.5"`
`"Seedance 2.0"`
`"Seedance 2.0 Fast"`
`"Seedance 2.0 Mini"` | -| `seed` | La semilla controla si el nodo debe volver a ejecutarse; los resultados no son deterministas independientemente de la semilla (por defecto: 0). | INT | Sí | 0 a 2147483647 | -| `watermark` | Si se debe añadir una marca de agua al video (por defecto: False). | BOOLEAN | Sí | `True`
`False` | +| `modelo` | El modelo de IA utilizado para generar el video. Seedance 2.5 para el modelo más nuevo, videos de hasta 30 segundos y salida mp4; Seedance 2.0 para máxima calidad y 1080p/4k; Fast para optimizar la velocidad; Mini para la generación más rápida y de menor costo. Seleccionar un modelo revela las entradas específicas del modelo que se enumeran a continuación. | COMBO | Sí | `"Seedance 2.5"`
`"Seedance 2.0"`
`"Seedance 2.0 Fast"`
`"Seedance 2.0 Mini"` | +| `semilla` | La semilla controla si el nodo debe volver a ejecutarse; los resultados no son deterministas independientemente de la semilla (por defecto: 0). | INT | Sí | 0 a 2147483647 | +| `marca_de_agua` | Si se debe añadir una marca de agua al video (por defecto: False). | BOOLEAN | Sí | `True`
`False` | ### Entradas de Seedance 2.5 diff --git a/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/fa.md b/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/fa.md index a6d739511..d8a71d1d6 100644 --- a/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/fa.md +++ b/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/fa.md @@ -10,9 +10,9 @@ | پارامتر | توضیحات | نوع داده | الزامی | محدوده | |-----------|-------------|-----------|----------|-------| -| `model` | مدل هوش مصنوعی مورد استفاده برای تولید ویدیو. Seedance 2.5 برای جدیدترین مدل، ویدیوهای تا ۳۰ ثانیه و خروجی mp4؛ Seedance 2.0 برای حداکثر کیفیت و 1080p/4k؛ Fast برای بهینه‌سازی سرعت؛ Mini برای سریع‌ترین و کم‌هزینه‌ترین تولید. انتخاب یک مدل، ورودی‌های مخصوص همان مدل را که در زیر فهرست شده‌اند نمایان می‌کند. | COMBO | بله | `"Seedance 2.5"`
`"Seedance 2.0"`
`"Seedance 2.0 Fast"`
`"Seedance 2.0 Mini"` | +| `مدل` | مدل هوش مصنوعی مورد استفاده برای تولید ویدیو. Seedance 2.5 برای جدیدترین مدل، ویدیوهای تا ۳۰ ثانیه و خروجی mp4؛ Seedance 2.0 برای حداکثر کیفیت و 1080p/4k؛ Fast برای بهینه‌سازی سرعت؛ Mini برای سریع‌ترین و کم‌هزینه‌ترین تولید. انتخاب یک مدل، ورودی‌های مخصوص همان مدل را که در زیر فهرست شده‌اند نمایان می‌کند. | COMBO | بله | `"Seedance 2.5"`
`"Seedance 2.0"`
`"Seedance 2.0 Fast"`
`"Seedance 2.0 Mini"` | | `seed` | seed تعیین می‌کند که آیا گره باید دوباره اجرا شود؛ نتایج بدون توجه به seed غیرقطعی هستند (پیش‌فرض: 0). | INT | بله | 0 تا 2147483647 | -| `watermark` | آیا به ویدیو واترمارک اضافه شود (پیش‌فرض: False). | BOOLEAN | بله | `True`
`False` | +| `واترمارک` | آیا به ویدیو واترمارک اضافه شود (پیش‌فرض: False). | BOOLEAN | بله | `True`
`False` | ### ورودی‌های Seedance 2.5 diff --git a/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/fr.md b/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/fr.md index f904d3b5a..ee4fa7425 100644 --- a/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/fr.md +++ b/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/fr.md @@ -10,9 +10,9 @@ La sélection d'un `model` détermine quels paramètres ci-dessous sont disponib | Paramètre | Description | Type de données | Requis | Plage | |-----------|-------------|-----------|----------|-------| -| `model` | Le modèle d'IA utilisé pour générer la vidéo. Seedance 2.5 pour le modèle le plus récent, vidéos jusqu'à 30 secondes et sortie mp4 ; Seedance 2.0 pour une qualité maximale et 1080p/4k ; Fast pour une optimisation de la vitesse ; Mini pour la génération la plus rapide et la moins coûteuse. La sélection d'un modèle révèle les entrées spécifiques au modèle listées ci-dessous. | COMBO | Oui | `"Seedance 2.5"`
`"Seedance 2.0"`
`"Seedance 2.0 Fast"`
`"Seedance 2.0 Mini"` | +| `modèle` | Le modèle d'IA utilisé pour générer la vidéo. Seedance 2.5 pour le modèle le plus récent, vidéos jusqu'à 30 secondes et sortie mp4 ; Seedance 2.0 pour une qualité maximale et 1080p/4k ; Fast pour une optimisation de la vitesse ; Mini pour la génération la plus rapide et la moins coûteuse. La sélection d'un modèle révèle les entrées spécifiques au modèle listées ci-dessous. | COMBO | Oui | `"Seedance 2.5"`
`"Seedance 2.0"`
`"Seedance 2.0 Fast"`
`"Seedance 2.0 Mini"` | | `seed` | Le `seed` contrôle si le nœud doit s'exécuter à nouveau ; les résultats sont non déterministes quel que soit le seed (par défaut : 0). | INT | Oui | 0 à 2147483647 | -| `watermark` | Indique s'il faut ajouter un filigrane à la vidéo (par défaut : False). | BOOLEAN | Oui | `True`
`False` | +| `filigrane` | Indique s'il faut ajouter un filigrane à la vidéo (par défaut : False). | BOOLEAN | Oui | `True`
`False` | ### Entrées Seedance 2.5 diff --git a/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/ja.md b/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/ja.md index 664ec1377..4505989c2 100644 --- a/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/ja.md +++ b/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/ja.md @@ -10,9 +10,9 @@ | パラメータ | 説明 | データ型 | 必須 | 範囲 | |-----------|-------------|-----------|----------|-------| -| `model` | 動画の生成に使用する AI モデル。Seedance 2.5 は最新モデルで、最大30秒の動画と mp4 出力に対応します。Seedance 2.0 は最高品質で、1080p/4k に対応します。Fast は速度最適化用です。Mini は最速かつ低コストの生成用です。モデルを選択すると、下記のモデル固有の入力が表示されます。 | COMBO | はい | `"Seedance 2.5"`
`"Seedance 2.0"`
`"Seedance 2.0 Fast"`
`"Seedance 2.0 Mini"` | -| `seed` | シードは、ノードを再実行するかどうかを制御します。シードに関係なく、結果は非決定的です(デフォルト: 0)。 | INT | はい | 0〜2147483647 | -| `watermark` | 動画に透かしを追加するかどうか(デフォルト: False)。 | BOOLEAN | はい | `True`
`False` | +| `モデル` | 動画の生成に使用する AI モデル。Seedance 2.5 は最新モデルで、最大30秒の動画と mp4 出力に対応します。Seedance 2.0 は最高品質で、1080p/4k に対応します。Fast は速度最適化用です。Mini は最速かつ低コストの生成用です。モデルを選択すると、下記のモデル固有の入力が表示されます。 | COMBO | はい | `"Seedance 2.5"`
`"Seedance 2.0"`
`"Seedance 2.0 Fast"`
`"Seedance 2.0 Mini"` | +| `シード` | シードは、ノードを再実行するかどうかを制御します。シードに関係なく、結果は非決定的です(デフォルト: 0)。 | INT | はい | 0〜2147483647 | +| `ウォーターマーク` | 動画に透かしを追加するかどうか(デフォルト: False)。 | BOOLEAN | はい | `True`
`False` | ### Seedance 2.5 入力 diff --git a/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/pt-BR.md b/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/pt-BR.md index 7bb5f6210..9215f9e95 100644 --- a/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/pt-BR.md +++ b/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/pt-BR.md @@ -10,9 +10,9 @@ Selecionar um `model` determina quais dos parâmetros abaixo estão disponíveis | Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | |-----------|-------------|-----------|----------|-------| -| `model` | O modelo de IA usado para gerar o vídeo. Seedance 2.5 para o modelo mais novo, vídeos de até 30 segundos e saída em mp4; Seedance 2.0 para máxima qualidade e 1080p/4k; Fast para otimização de velocidade; Mini para a geração mais rápida e de menor custo. Selecionar um modelo revela as entradas específicas do modelo listadas abaixo. | COMBO | Sim | `"Seedance 2.5"`
`"Seedance 2.0"`
`"Seedance 2.0 Fast"`
`"Seedance 2.0 Mini"` | -| `seed` | A `seed` controla se o nó deve ser executado novamente; os resultados são não determinísticos independentemente do valor da semente (padrão: 0). | INT | Sim | 0 a 2147483647 | -| `watermark` | Se deve adicionar uma marca d'água ao vídeo (padrão: False). | BOOLEAN | Sim | `True`
`False` | +| `modelo` | O modelo de IA usado para gerar o vídeo. Seedance 2.5 para o modelo mais novo, vídeos de até 30 segundos e saída em mp4; Seedance 2.0 para máxima qualidade e 1080p/4k; Fast para otimização de velocidade; Mini para a geração mais rápida e de menor custo. Selecionar um modelo revela as entradas específicas do modelo listadas abaixo. | COMBO | Sim | `"Seedance 2.5"`
`"Seedance 2.0"`
`"Seedance 2.0 Fast"`
`"Seedance 2.0 Mini"` | +| `semente` | A `seed` controla se o nó deve ser executado novamente; os resultados são não determinísticos independentemente do valor da semente (padrão: 0). | INT | Sim | 0 a 2147483647 | +| `marca_d'água` | Se deve adicionar uma marca d'água ao vídeo (padrão: False). | BOOLEAN | Sim | `True`
`False` | ### Entradas do Seedance 2.5 diff --git a/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/ru.md b/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/ru.md index 3bdb9a0b3..1c95fc273 100644 --- a/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/ru.md +++ b/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/ru.md @@ -10,9 +10,9 @@ | Параметр | Описание | Тип данных | Обязательность | Диапазон | |-----------|-------------|-----------|----------|-------| -| `model` | ИИ-модель, используемая для генерации видео. Seedance 2.5 — новейшая модель, видео до 30 секунд и выход в формате mp4; Seedance 2.0 — максимальное качество и 1080p/4k; Fast — оптимизация скорости; Mini — самая быстрая и недорогая генерация. Выбор модели отображает специфичные для модели входы, перечисленные ниже. | COMBO | Да | `"Seedance 2.5"`
`"Seedance 2.0"`
`"Seedance 2.0 Fast"`
`"Seedance 2.0 Mini"` | +| `модель` | ИИ-модель, используемая для генерации видео. Seedance 2.5 — новейшая модель, видео до 30 секунд и выход в формате mp4; Seedance 2.0 — максимальное качество и 1080p/4k; Fast — оптимизация скорости; Mini — самая быстрая и недорогая генерация. Выбор модели отображает специфичные для модели входы, перечисленные ниже. | COMBO | Да | `"Seedance 2.5"`
`"Seedance 2.0"`
`"Seedance 2.0 Fast"`
`"Seedance 2.0 Mini"` | | `seed` | Значение `seed` управляет тем, должен ли узел перезапускаться; результаты недетерминированы независимо от seed (по умолчанию: 0). | INT | Да | 0 до 2147483647 | -| `watermark` | Нужно ли добавлять водяной знак к видео (по умолчанию: False). | BOOLEAN | Да | `True`
`False` | +| `водяной знак` | Нужно ли добавлять водяной знак к видео (по умолчанию: False). | BOOLEAN | Да | `True`
`False` | ### Seedance 2.5 Входы diff --git a/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/zh-TW.md b/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/zh-TW.md index eef2b7e5c..1b34836e1 100644 --- a/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/zh-TW.md +++ b/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/zh-TW.md @@ -10,9 +10,9 @@ | 參數 | 說明 | 資料型別 | 必填 | 範圍 | |-----------|-------------|-----------|----------|-------| -| `model` | 用於生成影片的 AI 模型。Seedance 2.5 為最新模型,影片可達 30 秒,並支援 mp4 輸出;Seedance 2.0 提供最高品質與 1080p/4k;Fast 為速度最佳化;Mini 為最快且成本最低的生成。選取模型後,會顯示下列該模型專屬的輸入。 | COMBO | 是 | `"Seedance 2.5"`
`"Seedance 2.0"`
`"Seedance 2.0 Fast"`
`"Seedance 2.0 Mini"` | -| `seed` | 種子值控制節點是否應重新執行;無論種子為何,結果都是非確定性的(預設:0)。 | INT | 是 | 0 至 2147483647 | -| `watermark` | 是否在影片中加入浮水印(預設:False)。 | BOOLEAN | 是 | `True`
`False` | +| `模型` | 用於生成影片的 AI 模型。Seedance 2.5 為最新模型,影片可達 30 秒,並支援 mp4 輸出;Seedance 2.0 提供最高品質與 1080p/4k;Fast 為速度最佳化;Mini 為最快且成本最低的生成。選取模型後,會顯示下列該模型專屬的輸入。 | COMBO | 是 | `"Seedance 2.5"`
`"Seedance 2.0"`
`"Seedance 2.0 Fast"`
`"Seedance 2.0 Mini"` | +| `種子` | 種子值控制節點是否應重新執行;無論種子為何,結果都是非確定性的(預設:0)。 | INT | 是 | 0 至 2147483647 | +| `浮水印` | 是否在影片中加入浮水印(預設:False)。 | BOOLEAN | 是 | `True`
`False` | ### Seedance 2.5 輸入 diff --git a/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/zh.md b/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/zh.md index eb4e180ea..3a789a769 100644 --- a/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/zh.md +++ b/comfyui_embedded_docs/docs/ByteDance2ReferenceNode/zh.md @@ -10,9 +10,9 @@ | 参数 | 描述 | 数据类型 | 必填 | Range | |-----------|-------------|-----------|----------|-------| -| `model` | 用于生成视频的 AI 模型。Seedance 2.5 为最新模型,视频最长 30 秒,支持 mp4 输出;Seedance 2.0 提供最高质量和 1080p/4k;Fast 针对速度优化;Mini 提供最快、最低成本的生成。选择模型后会显示下方列出的对应模型特有输入。 | COMBO | 是 | `"Seedance 2.5"`
`"Seedance 2.0"`
`"Seedance 2.0 Fast"`
`"Seedance 2.0 Mini"` | -| `seed` | `seed` 控制节点是否应重新运行;无论 seed 为何,结果都不具有确定性(默认:0)。 | INT | 是 | 0 到 2147483647 | -| `watermark` | 是否向视频添加水印(默认:False)。 | BOOLEAN | 是 | `True`
`False` | +| `模型` | 用于生成视频的 AI 模型。Seedance 2.5 为最新模型,视频最长 30 秒,支持 mp4 输出;Seedance 2.0 提供最高质量和 1080p/4k;Fast 针对速度优化;Mini 提供最快、最低成本的生成。选择模型后会显示下方列出的对应模型特有输入。 | COMBO | 是 | `"Seedance 2.5"`
`"Seedance 2.0"`
`"Seedance 2.0 Fast"`
`"Seedance 2.0 Mini"` | +| `种子` | `seed` 控制节点是否应重新运行;无论 seed 为何,结果都不具有确定性(默认:0)。 | INT | 是 | 0 到 2147483647 | +| `水印` | 是否向视频添加水印(默认:False)。 | BOOLEAN | 是 | `True`
`False` | ### Seedance 2.5 输入 diff --git a/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/ar.md b/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/ar.md new file mode 100644 index 000000000..55d7d9365 --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/ar.md @@ -0,0 +1,77 @@ +# ByteDance2ReferenceNodeV2 + +ByteDance Seedance 2.5 Reference to Video تنشئ مقاطع فيديو أو تعدّلها أو تمدّدها باستخدام نماذج ByteDance Seedance (Seedance 2.5 و2.0 و2.0 Fast و2.0 Mini) وفقًا لموجه نصي وصور وفيديوهات وصوتيات مرجعية اختيارية، أو أصول مكتبية مرفوعة مسبقًا. تقوم الأداة برفع المراجع، وتقديم مهمة التوليد، والانتظار حتى اكتمالها، ثم إرجاع ملف الفيديو النهائي. + +## المدخلات + +### المدخلات المشتركة + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|-----------|-------------|-----------|----------|-------| +| `model` | محدد النموذج. استخدم Seedance 2.5 للحصول على أحدث نموذج، مع دعم فيديوهات تصل مدتها إلى 30 ثانية وإخراج mp4/mov؛ وSeedance 2.0 لأقصى جودة ودقة 4k؛ وFast لتحسين السرعة؛ وMini للتوليد الأسرع والأقل تكلفة. يؤدي تحديد نموذج إلى تغيير عناصر الإدخال المعروضة أدناه. | DYNAMIC_COMBO | نعم | "Seedance 2.5"
"Seedance 2.0"
"Seedance 2.0 Fast"
"Seedance 2.0 Mini" | +| `seed` | يتحكم Seed في ما إذا كان يجب إعادة تشغيل العقدة؛ والنتائج غير حتمية بغض النظر عن قيمة seed. الافتراضي: 0. | INT | نعم | 0 إلى 2147483647 | +| `watermark` | ما إذا كان يجب إضافة علامة مائية إلى الفيديو. الافتراضي: False. إعداد متقدم. | BOOLEAN | نعم | true
false | + +### مدخلات Seedance 2.5 + +تظهر هذه المدخلات عندما يتم تعيين `model` إلى "Seedance 2.5". + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|-----------|-------------|-----------|----------|-------| +| `prompt` | موجه نصي لتوليد الفيديو. ضع العبارات المنطوقة بين علامتي اقتباس لتوجيه الحوار المُولّد. الافتراضي: سلسلة فارغة. | STRING | نعم | Multiline text | +| `resolution` | دقة الفيديو الناتج. الافتراضي: 720p. | COMBO | نعم | "480p"
"720p"
"1080p" | +| `ratio` | نسبة العرض إلى الارتفاع للفيديو الناتج. الافتراضي: 16:9. | COMBO | نعم | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | مدة الفيديو الناتج بالثواني (4-30). الافتراضي: 5. | INT | نعم | 4 إلى 30 | +| `generate_audio` | تفعيل توليد الصوت للفيديو الناتج. الافتراضي: True. | BOOLEAN | نعم | true
false | +| `task_type` | ما الذي يجب فعله بالوسائط المرجعية. يتم التحقق من كل قيمة باستثناء auto عند تقديم المهمة، لذلك تفشل الإعدادات غير المتطابقة قبل بدء التوليد.
auto: يستنتج النموذج المهمة من الموجه والمدخلات، وتفشل الإعدادات التي تتعارض مع قراءته فقط بعد بدء التوليد.
reference: توليد فيديو جديد وفقًا للصور والفيديوهات والصوتيات المرجعية.
edit: تغيير فيديو مرجعي متصل (إضافة، إزالة، استبدال)؛ يحتفظ الإخراج بالمدة ونسبة العرض إلى الارتفاع الأصليين للمقطع المصدر، ويتم تجاهل حقلي المدة والنسبة.
extend: مواصلة فيديو مرجعي متصل للأمام أو للخلف؛ يجب أن يقول الموجه "extend forward" أو "extend backward" أو "continue"، وتتبع نسبة العرض إلى الارتفاع المقطع المصدر، ويحتوي الإخراج فقط على المقطع المُولّد حديثًا بالمدة التي تحدّدها، وليس المقطع المصدر. الافتراضي: auto. | COMBO | نعم | "auto"
"reference"
"edit"
"extend" | +| `output_format` | تنسيق الحاوية للفيديو الناتج. الافتراضي: mp4. | COMBO | نعم | "mp4" | + +### مدخلات Seedance 2.0 + +تظهر هذه المدخلات عندما يتم تعيين `model` إلى "Seedance 2.0". + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|-----------|-------------|-----------|----------|-------| +| `prompt` | موجه نصي لتوليد الفيديو. الافتراضي: سلسلة فارغة. | STRING | نعم | Multiline text | +| `resolution` | دقة الفيديو الناتج. | COMBO | نعم | "480p"
"720p"
"1080p"
"4k" | +| `ratio` | نسبة العرض إلى الارتفاع للفيديو الناتج. الافتراضي: adaptive. | COMBO | نعم | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | مدة الفيديو الناتج بالثواني (4-15). الافتراضي: 7. | INT | نعم | 4 إلى 15 | +| `generate_audio` | تفعيل توليد الصوت للفيديو الناتج. الافتراضي: True. | BOOLEAN | نعم | true
false | + +### مدخلات Seedance 2.0 Fast وSeedance 2.0 Mini + +تظهر هذه المدخلات عندما يتم تعيين `model` إلى "Seedance 2.0 Fast" أو "Seedance 2.0 Mini". يتشارك كلا النموذجين في نفس مجموعة المدخلات. + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|-----------|-------------|-----------|----------|-------| +| `prompt` | موجه نصي لتوليد الفيديو. الافتراضي: سلسلة فارغة. | STRING | نعم | Multiline text | +| `resolution` | دقة الفيديو الناتج. | COMBO | نعم | "480p"
"720p" | +| `ratio` | نسبة العرض إلى الارتفاع للفيديو الناتج. الافتراضي: adaptive. | COMBO | نعم | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | مدة الفيديو الناتج بالثواني (4-15). الافتراضي: 7. | INT | نعم | 4 إلى 15 | +| `generate_audio` | تفعيل توليد الصوت للفيديو الناتج. الافتراضي: True. | BOOLEAN | نعم | true
false | + +### المدخلات المرجعية + +هذه الفتحات المرجعية القابلة للتوسيع متاحة لجميع النماذج. يختلف العدد الأقصى للفتحات حسب النموذج: يدعم Seedance 2.5 حتى 30 صورة، و10 فيديوهات، و10 صوتيات، و30 أصلًا؛ بينما يدعم Seedance 2.0 و2.0 Fast و2.0 Mini حتى 9 صور، و3 فيديوهات، و3 صوتيات، و9 أصول. + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|-----------|-------------|-----------|----------|-------| +| `reference_images` | فتحة قابلة للتوسيع: قم بتوصيل 1..N صورة مرجعية لتوجيه الإخراج. حد العدد يعتمد على النموذج (انظر أقسام النماذج). يتم التحقق من الصور للتأكد من نسبة العرض إلى الارتفاع (0.4 إلى 2.5) ويتم تصغيرها تلقائيًا إلى حد أقصى يبلغ 6000 بكسل على الجانب. | IMAGE | لا | 1..9 slots (Seedance 2.0 family)
1..30 slots (Seedance 2.5) | +| `reference_videos` | فتحة قابلة للتوسيع: قم بتوصيل 1..N فيديو مرجعي. حد العدد يعتمد على النموذج (انظر أقسام النماذج). يجب أن تبلغ مدة كل فيديو 1.8 ثانية على الأقل وأن يتوافق مع حدود البكسل للنموذج والدقة المحددين. | VIDEO | لا | 1..3 slots (Seedance 2.0 family)
1..10 slots (Seedance 2.5) | +| `reference_audios` | فتحة قابلة للتوسيع: قم بتوصيل 1..N مسار صوتي مرجعي. حد العدد يعتمد على النموذج (انظر أقسام النماذج). يجب أن تكون مدة كل صوت 1.8 ثانية على الأقل. | AUDIO | لا | 1..3 slots (Seedance 2.0 family)
1..10 slots (Seedance 2.5) | +| `reference_assets` | فتحة قابلة للتوسيع: قم بتوصيل 1..N من سلاسل معرّفات الأصول للوسائط المرفوعة بالفعل إلى المكتبة الافتراضية Seedance. يجب أن يكون كل أصل في حالة Active. يمكنك الإشارة إلى أحد الأصول في الموجه باستخدام رموز مثل `asset1` أو `asset 1`؛ وتستبدلها العقدة بالتسمية الموضعية للأصل (على سبيل المثال "Image 2" أو "Video 1"). | STRING | لا | 1..9 slots (Seedance 2.0 family)
1..30 slots (Seedance 2.5) | +| `auto_downscale` | يتم تصغير الفيديوهات المرجعية تلقائيًا التي تتجاوز ميزانية البكسل الخاصة بالنموذج للدقة المحددة. يتم الحفاظ على نسبة العرض إلى الارتفاع؛ ولا يتم تعديل الفيديوهات التي تكون بالفعل ضمن الحدود. الافتراضي: True. | BOOLEAN | لا | true
false | +| `auto_upscale` | يتم تكبير الفيديوهات المرجعية تلقائيًا التي تكون أقل من الحد الأدنى لعدد البكسل للنموذج للدقة المحددة. يتم الحفاظ على نسبة العرض إلى الارتفاع؛ ولا يتم تعديل الفيديوهات التي تلبي الحد الأدنى بالفعل. ملاحظة: تكبير مصدر منخفض الدقة لا يضيف تفاصيل حقيقية وقد ينتج توليدات بجودة أقل. الافتراضي: False. إعداد متقدم. | BOOLEAN | لا | true
false | + +**ملاحظة:** يلزم وجود صورة مرجعية واحدة على الأقل أو فيديو مرجعي أو أصل مرجعي لتشغيل العقدة (يقبل Seedance 2.5 أيضًا مراجع صوتية فقط). يجب أن تبلغ مدة كل فيديو مرجعي وصوت مرجعي 1.8 ثانية على الأقل، ويجب ألا تتجاوز المدة الإجمالية لجميع الفيديوهات المرجعية (وبشكل منفصل، جميع الصوتيات المرجعية) الحد الأقصى لإجمالي الثواني للنموذج المحدد. يجب أن تكون نسبة العرض إلى الارتفاع للصور المرجعية بين 2:5 و5:2 تقريبًا (0.4 إلى 2.5)، وأن تكون بدقة 300x300 بكسل على الأقل، ويتم تصغيرها تلقائيًا إلى حد أقصى يبلغ 6000 بكسل على الجانب. خيارا `task_type` "edit" و"extend" متاحان فقط مع Seedance 2.5 وكلاهما يتطلب فيديو مرجعيًا واحدًا على الأقل؛ عند استخدام "edit"، يحتفظ الإخراج بالمدة ونسبة العرض إلى الارتفاع الأصليين للمقطع المصدر، ويتم تجاهل حقلي `duration` و`ratio`؛ وعند استخدام "extend"، يحتوي الإخراج فقط على المقطع المُولّد حديثًا بالمدة التي تحدّدها. يجب أن تكون الأصول المرجعية في حالة Active، وإلا تفشل المهمة. + +## المخرجات + +| اسم المخرج | الوصف | نوع البيانات | +|-------------|-------------|-----------| +| `video` | الفيديو المُولّد، ويتم تنزيله من المزوّد بمجرد اكتمال مهمة التوليد. يحتوي على صوت عند تفعيل توليد الصوت. | VIDEO | + +> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/ar.md) + +--- +**Source fingerprint (SHA-256):** `3a6bba12e719204ba5dba9d7d5f2b4c5285ed68974ee015b6e4a7892a1cf0933` diff --git a/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/en.md b/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/en.md new file mode 100644 index 000000000..715b0c41b --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/en.md @@ -0,0 +1,77 @@ +# ByteDance2ReferenceNodeV2 + +ByteDance Seedance 2.5 Reference to Video generates, edits, or extends videos using ByteDance Seedance models (Seedance 2.5, 2.0, 2.0 Fast, and 2.0 Mini) guided by a text prompt and optional reference images, videos, audio, or previously uploaded library assets. It uploads the references, submits a generation task, waits for completion, and returns the finished video file. + +## Inputs + +### Common Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `model` | Model selector. Seedance 2.5 for the newest model, videos up to 30 seconds and mp4/mov output; Seedance 2.0 for maximum quality and 4k; Fast for speed optimization; Mini for the fastest, lowest-cost generation. Selecting a model changes the input widgets shown below. | DYNAMIC_COMBO | Yes | "Seedance 2.5"
"Seedance 2.0"
"Seedance 2.0 Fast"
"Seedance 2.0 Mini" | +| `seed` | Seed controls whether the node should re-run; results are non-deterministic regardless of seed. Default: 0. | INT | Yes | 0 to 2147483647 | +| `watermark` | Whether to add a watermark to the video. Default: False. Advanced setting. | BOOLEAN | Yes | true
false | + +### Seedance 2.5 Inputs + +These inputs appear when `model` is set to "Seedance 2.5". + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `prompt` | Text prompt for video generation. Put spoken lines in double quotes to steer the generated dialogue. Default: empty string. | STRING | Yes | Multiline text | +| `resolution` | Resolution of the output video. Default: 720p. | COMBO | Yes | "480p"
"720p"
"1080p" | +| `ratio` | Aspect ratio of the output video. Default: 16:9. | COMBO | Yes | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | Duration of the output video in seconds (4-30). Default: 5. | INT | Yes | 4 to 30 | +| `generate_audio` | Enable audio generation for the output video. Default: True. | BOOLEAN | Yes | true
false | +| `task_type` | What to do with the reference media. Every value except auto is validated when the task is submitted, so mismatched settings fail before generation starts.
auto: the model infers the task from the prompt and inputs, and settings that conflict with its reading fail only after generation has started.
reference: generate a new video guided by the reference images, videos, and audio.
edit: change a connected reference video (add, remove, replace); the output keeps the source clip's own length and aspect ratio, and the duration and ratio widgets are ignored.
extend: continue a connected reference video forward or backward; the prompt should say "extend forward", "extend backward", or "continue", the aspect ratio follows the source clip, and the output contains only the newly generated segment of the duration you set, not the source clip. Default: auto. | COMBO | Yes | "auto"
"reference"
"edit"
"extend" | +| `output_format` | Container format of the output video. Default: mp4. | COMBO | Yes | "mp4" | + +### Seedance 2.0 Inputs + +These inputs appear when `model` is set to "Seedance 2.0". + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `prompt` | Text prompt for video generation. Default: empty string. | STRING | Yes | Multiline text | +| `resolution` | Resolution of the output video. | COMBO | Yes | "480p"
"720p"
"1080p"
"4k" | +| `ratio` | Aspect ratio of the output video. Default: adaptive. | COMBO | Yes | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | Duration of the output video in seconds (4-15). Default: 7. | INT | Yes | 4 to 15 | +| `generate_audio` | Enable audio generation for the output video. Default: True. | BOOLEAN | Yes | true
false | + +### Seedance 2.0 Fast and Seedance 2.0 Mini Inputs + +These inputs appear when `model` is set to "Seedance 2.0 Fast" or "Seedance 2.0 Mini". Both models share the same input set. + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `prompt` | Text prompt for video generation. Default: empty string. | STRING | Yes | Multiline text | +| `resolution` | Resolution of the output video. | COMBO | Yes | "480p"
"720p" | +| `ratio` | Aspect ratio of the output video. Default: adaptive. | COMBO | Yes | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | Duration of the output video in seconds (4-15). Default: 7. | INT | Yes | 4 to 15 | +| `generate_audio` | Enable audio generation for the output video. Default: True. | BOOLEAN | Yes | true
false | + +### Reference Inputs + +These growable reference slots are available for all models. The maximum number of slots differs per model: Seedance 2.5 supports up to 30 images, 10 videos, 10 audios, and 30 assets; Seedance 2.0, 2.0 Fast, and 2.0 Mini support up to 9 images, 3 videos, 3 audios, and 9 assets. + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `reference_images` | Growable slot: connect 1..N reference images that guide the output. The count limit is per model (see model sections). Images are validated for aspect ratio (0.4 to 2.5) and auto-downscaled to a maximum side of 6000 pixels. | IMAGE | No | 1..9 slots (Seedance 2.0 family)
1..30 slots (Seedance 2.5) | +| `reference_videos` | Growable slot: connect 1..N reference videos. The count limit is per model (see model sections). Each video must be at least 1.8 seconds long and must fit the pixel limits for the selected model and resolution. | VIDEO | No | 1..3 slots (Seedance 2.0 family)
1..10 slots (Seedance 2.5) | +| `reference_audios` | Growable slot: connect 1..N reference audio tracks. The count limit is per model (see model sections). Each audio must be at least 1.8 seconds long. | AUDIO | No | 1..3 slots (Seedance 2.0 family)
1..10 slots (Seedance 2.5) | +| `reference_assets` | Growable slot: connect 1..N asset ID strings for media already uploaded to the Seedance virtual library. Each asset must be Active. You can refer to an asset in the prompt with tokens such as `asset1` or `asset 1`; the node replaces them with the asset's positional label (for example "Image 2" or "Video 1"). | STRING | No | 1..9 slots (Seedance 2.0 family)
1..30 slots (Seedance 2.5) | +| `auto_downscale` | Automatically downscale reference videos that exceed the model's pixel budget for the selected resolution. Aspect ratio is preserved; videos already within limits are untouched. Default: True. | BOOLEAN | No | true
false | +| `auto_upscale` | Automatically upscale reference videos that are below the model's minimum pixel count for the selected resolution. Aspect ratio is preserved; videos already meeting the minimum are untouched. Note: upscaling a low-resolution source does not add real detail and may produce lower-quality generations. Default: False. Advanced setting. | BOOLEAN | No | true
false | + +**Note:** At least one reference image, video, or asset is required to run the node (Seedance 2.5 also accepts audio-only references). Reference videos and audios must each be at least 1.8 seconds long, and the combined duration of all reference videos (and separately, all reference audios) must not exceed the selected model's maximum total seconds. Reference images must have an aspect ratio between roughly 2:5 and 5:2 (0.4 to 2.5), be at least 300x300 pixels, and are automatically downscaled to a maximum side of 6000 pixels. The `task_type` "edit" and "extend" options are only available with Seedance 2.5 and both require at least one reference video; when "edit" is used, the output keeps the source clip's own length and aspect ratio and the `duration` and `ratio` widgets are ignored, and when "extend" is used, the output contains only the newly generated segment at the duration you set. Referenced assets must be in Active status, otherwise the task fails. + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `video` | The generated video, downloaded from the provider once the generation task completes. Contains audio when audio generation is enabled. | VIDEO | + +> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/en.md) + +--- +**Source fingerprint (SHA-256):** `3a6bba12e719204ba5dba9d7d5f2b4c5285ed68974ee015b6e4a7892a1cf0933` diff --git a/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/es.md b/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/es.md new file mode 100644 index 000000000..df84d7e0f --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/es.md @@ -0,0 +1,77 @@ +# ByteDance2ReferenceNodeV2 + +ByteDance Seedance 2.5 Reference to Video genera, edita o extiende videos utilizando los modelos ByteDance Seedance (Seedance 2.5, 2.0, 2.0 Fast y 2.0 Mini) guiados por un prompt de texto e imágenes, videos, audio o activos de biblioteca previamente subidos opcionales. Sube las referencias, envía una tarea de generación, espera a que se complete y devuelve el archivo de video final. + +## Entradas + +### Entradas comunes + +| Parámetro | Descripción | Tipo de dato | Requerido | Rango | +|-----------|-------------|--------------|-----------|-------| +| `model` | Selector de modelo. Seedance 2.5 para el modelo más reciente, videos de hasta 30 segundos y salida mp4/mov; Seedance 2.0 para máxima calidad y 4K; Fast para optimizar la velocidad; Mini para la generación más rápida y de menor costo. Seleccionar un modelo cambia los widgets de entrada que se muestran a continuación. | DYNAMIC_COMBO | Sí | "Seedance 2.5"
"Seedance 2.0"
"Seedance 2.0 Fast"
"Seedance 2.0 Mini" | +| `seed` | La semilla controla si el nodo debe volver a ejecutarse; los resultados son no deterministas independientemente de la semilla. Predeterminado: 0. | INT | Sí | 0 a 2147483647 | +| `watermark` | Si se debe añadir una marca de agua al video. Predeterminado: False. Configuración avanzada. | BOOLEAN | Sí | true
false | + +### Entradas de Seedance 2.5 + +Estas entradas aparecen cuando `model` está configurado en "Seedance 2.5". + +| Parámetro | Descripción | Tipo de dato | Requerido | Rango | +|-----------|-------------|--------------|-----------|-------| +| `prompt` | Prompt de texto para la generación de video. Pon las líneas habladas entre comillas dobles para dirigir el diálogo generado. Predeterminado: cadena vacía. | STRING | Sí | Texto multilínea | +| `resolution` | Resolución del video de salida. Predeterminado: 720p. | COMBO | Sí | "480p"
"720p"
"1080p" | +| `ratio` | Relación de aspecto del video de salida. Predeterminado: 16:9. | COMBO | Sí | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | Duración del video de salida en segundos (4-30). Predeterminado: 5. | INT | Sí | 4 a 30 | +| `generate_audio` | Habilitar la generación de audio para el video de salida. Predeterminado: True. | BOOLEAN | Sí | true
false | +| `task_type` | Qué hacer con el material de referencia. Todos los valores excepto auto se validan cuando se envía la tarea, por lo que los ajustes incompatibles fallan antes de que comience la generación.
auto: el modelo infiere la tarea a partir del prompt y las entradas, y los ajustes que contradicen su interpretación solo fallan después de que la generación haya comenzado.
reference: genera un video nuevo guiado por las imágenes, videos y audio de referencia.
edit: modifica un video de referencia conectado (añadir, eliminar, reemplazar); la salida conserva la duración y la relación de aspecto del clip de origen, y los widgets de duración y relación de aspecto se ignoran.
extend: continúa un video de referencia conectado hacia adelante o hacia atrás; el prompt debe decir "extend forward", "extend backward" o "continue", la relación de aspecto sigue al clip de origen, y la salida contiene solo el segmento recién generado con la duración que establezcas, no el clip de origen. Predeterminado: auto. | COMBO | Sí | "auto"
"reference"
"edit"
"extend" | +| `output_format` | Formato de contenedor del video de salida. Predeterminado: mp4. | COMBO | Sí | "mp4" | + +### Entradas de Seedance 2.0 + +Estas entradas aparecen cuando `model` está configurado en "Seedance 2.0". + +| Parámetro | Descripción | Tipo de dato | Requerido | Rango | +|-----------|-------------|--------------|-----------|-------| +| `prompt` | Prompt de texto para la generación de video. Predeterminado: cadena vacía. | STRING | Sí | Texto multilínea | +| `resolution` | Resolución del video de salida. | COMBO | Sí | "480p"
"720p"
"1080p"
"4k" | +| `ratio` | Relación de aspecto del video de salida. Predeterminado: adaptive. | COMBO | Sí | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | Duración del video de salida en segundos (4-15). Predeterminado: 7. | INT | Sí | 4 a 15 | +| `generate_audio` | Habilitar la generación de audio para el video de salida. Predeterminado: True. | BOOLEAN | Sí | true
false | + +### Entradas de Seedance 2.0 Fast y Seedance 2.0 Mini + +Estas entradas aparecen cuando `model` está configurado en "Seedance 2.0 Fast" o "Seedance 2.0 Mini". Ambos modelos comparten el mismo conjunto de entradas. + +| Parámetro | Descripción | Tipo de dato | Requerido | Rango | +|-----------|-------------|--------------|-----------|-------| +| `prompt` | Prompt de texto para la generación de video. Predeterminado: cadena vacía. | STRING | Sí | Texto multilínea | +| `resolution` | Resolución del video de salida. | COMBO | Sí | "480p"
"720p" | +| `ratio` | Relación de aspecto del video de salida. Predeterminado: adaptive. | COMBO | Sí | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | Duración del video de salida en segundos (4-15). Predeterminado: 7. | INT | Sí | 4 a 15 | +| `generate_audio` | Habilitar la generación de audio para el video de salida. Predeterminado: True. | BOOLEAN | Sí | true
false | + +### Entradas de referencia + +Estas ranuras de referencia ampliables están disponibles para todos los modelos. El número máximo de ranuras difiere según el modelo: Seedance 2.5 admite hasta 30 imágenes, 10 videos, 10 audios y 30 activos; Seedance 2.0, 2.0 Fast y 2.0 Mini admiten hasta 9 imágenes, 3 videos, 3 audios y 9 activos. + +| Parámetro | Descripción | Tipo de dato | Requerido | Rango | +|-----------|-------------|--------------|-----------|-------| +| `reference_images` | Ranura ampliable: conecta de 1 a N imágenes de referencia que guían la salida. El límite de cantidad es por modelo (consulta las secciones de modelos). Las imágenes se validan por relación de aspecto (0.4 a 2.5) y se reducen automáticamente a un lado máximo de 6000 píxeles. | IMAGE | No | 1..9 ranuras (familia Seedance 2.0)
1..30 ranuras (Seedance 2.5) | +| `reference_videos` | Ranura ampliable: conecta de 1 a N videos de referencia. El límite de cantidad es por modelo (consulta las secciones de modelos). Cada video debe tener al menos 1.8 segundos de duración y debe ajustarse a los límites de píxeles del modelo y la resolución seleccionados. | VIDEO | No | 1..3 ranuras (familia Seedance 2.0)
1..10 ranuras (Seedance 2.5) | +| `reference_audios` | Ranura ampliable: conecta de 1 a N pistas de audio de referencia. El límite de cantidad es por modelo (consulta las secciones de modelos). Cada audio debe tener al menos 1.8 segundos de duración. | AUDIO | No | 1..3 ranuras (familia Seedance 2.0)
1..10 ranuras (Seedance 2.5) | +| `reference_assets` | Ranura ampliable: conecta de 1 a N cadenas de ID de activo para medios ya subidos a la biblioteca virtual de Seedance. Cada activo debe estar activo. Puedes referirte a un activo en el prompt con tokens como `asset1` o `asset 1`; el nodo los reemplaza con la etiqueta posicional del activo (por ejemplo "Image 2" o "Video 1"). | STRING | No | 1..9 ranuras (familia Seedance 2.0)
1..30 ranuras (Seedance 2.5) | +| `auto_downscale` | Reducir automáticamente la escala de los videos de referencia que superen el presupuesto de píxeles del modelo para la resolución seleccionada. Se conserva la relación de aspecto; los videos que ya están dentro de los límites no se modifican. Predeterminado: True. | BOOLEAN | No | true
false | +| `auto_upscale` | Ampliar automáticamente la escala de los videos de referencia que estén por debajo del recuento mínimo de píxeles del modelo para la resolución seleccionada. Se conserva la relación de aspecto; los videos que ya cumplen el mínimo no se modifican. Nota: ampliar una fuente de baja resolución no añade detalle real y puede producir generaciones de menor calidad. Predeterminado: False. Configuración avanzada. | BOOLEAN | No | true
false | + +**Nota:** Se requiere al menos una imagen, video o activo de referencia para ejecutar el nodo (Seedance 2.5 también acepta referencias solo de audio). Los videos y audios de referencia deben tener cada uno al menos 1.8 segundos de duración, y la duración combinada de todos los videos de referencia (y, por separado, de todos los audios de referencia) no debe exceder el máximo de segundos totales del modelo seleccionado. Las imágenes de referencia deben tener una relación de aspecto entre aproximadamente 2:5 y 5:2 (0.4 a 2.5), tener al menos 300x300 píxeles, y se reducen automáticamente a un lado máximo de 6000 píxeles. Las opciones `task_type` "edit" y "extend" solo están disponibles con Seedance 2.5 y ambas requieren al menos un video de referencia; cuando se usa "edit", la salida conserva la duración y la relación de aspecto del clip de origen y los widgets `duration` y `ratio` se ignoran, y cuando se usa "extend", la salida contiene solo el segmento recién generado con la duración que establezcas. Los activos referenciados deben estar en estado activo; de lo contrario, la tarea falla. + +## Salidas + +| Nombre de salida | Descripción | Tipo de dato | +|------------------|-------------|--------------| +| `video` | El video generado, descargado del proveedor una vez que se completa la tarea de generación. Contiene audio cuando la generación de audio está habilitada. | VIDEO | + +> Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/es.md) + +--- +**Source fingerprint (SHA-256):** `3a6bba12e719204ba5dba9d7d5f2b4c5285ed68974ee015b6e4a7892a1cf0933` diff --git a/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/fa.md b/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/fa.md new file mode 100644 index 000000000..e9cce7cf4 --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/fa.md @@ -0,0 +1,77 @@ +# ByteDance2ReferenceNodeV2 + +ByteDance Seedance 2.5 Reference to Video با استفاده از مدل‌های ByteDance Seedance (نسخه‌های 2.5، 2.0، 2.0 Fast و 2.0 Mini) و با هدایت یک پرامپت متنی و تصاویر، ویدیوها، صداها یا دارایی‌های کتابخانه‌ای آپلودشدهٔ قبلیِ اختیاری، ویدیو تولید، ویرایش یا تمدید می‌کند. این گره ارجاع‌ها را آپلود، یک وظیفهٔ تولید را ارسال، منتظر تکمیل آن می‌ماند و فایل ویدیوی نهایی را برمی‌گرداند. + +## ورودی‌ها + +### ورودی‌های مشترک + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `model` | انتخابگر مدل. Seedance 2.5 برای جدیدترین مدل، ویدیوهای تا 30 ثانیه و خروجی mp4/mov؛ Seedance 2.0 برای حداکثر کیفیت و 4k؛ Fast برای بهینه‌سازی سرعت؛ Mini برای سریع‌ترین و کم‌هزینه‌ترین تولید. انتخاب یک مدل، ویجت‌های ورودی نمایش‌داده‌شده در زیر را تغییر می‌دهد. | DYNAMIC_COMBO | بله | "Seedance 2.5"
"Seedance 2.0"
"Seedance 2.0 Fast"
"Seedance 2.0 Mini" | +| `seed` | سید تعیین می‌کند که آیا گره باید دوباره اجرا شود؛ نتایج بدون توجه به سید غیرقطعی هستند. پیش‌فرض: 0. | INT | بله | 0 to 2147483647 | +| `watermark` | آیا به ویدیو واترمارک اضافه شود یا نه. پیش‌فرض: False. تنظیم پیشرفته. | BOOLEAN | بله | true
false | + +### ورودی‌های Seedance 2.5 + +این ورودی‌ها زمانی ظاهر می‌شوند که `model` روی «Seedance 2.5» تنظیم شده باشد. + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `prompt` | پرامپت متنی برای تولید ویدیو. برای هدایت دیالوگ تولیدشده، خطوط گفتاری را در گیومه قرار دهید. پیش‌فرض: رشتهٔ خالی. | STRING | بله | Multiline text | +| `resolution` | رزولوشن ویدیوی خروجی. پیش‌فرض: 720p. | COMBO | بله | "480p"
"720p"
"1080p" | +| `ratio` | نسبت تصویر ویدیوی خروجی. پیش‌فرض: 16:9. | COMBO | بله | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | مدت ویدیوی خروجی به ثانیه (4-30). پیش‌فرض: 5. | INT | بله | 4 to 30 | +| `generate_audio` | فعال‌سازی تولید صدا برای ویدیوی خروجی. پیش‌فرض: True. | BOOLEAN | بله | true
false | +| `task_type` | تعیین می‌کند با رسانهٔ مرجع چه کاری انجام شود. هر مقدار به‌جز auto هنگام ارسال وظیفه اعتبارسنجی می‌شود، بنابراین تنظیمات ناسازگار پیش از شروع تولید شکست می‌خورند.
auto: مدل وظیفه را از روی پرامپت و ورودی‌ها استنباط می‌کند، و تنظیماتی که با برداشت آن مغایرت دارند تنها پس از شروع تولید شکست می‌خورند.
reference: تولید یک ویدیوی جدید با هدایت تصاویر، ویدیوها و صداهای مرجع.
edit: تغییر یک ویدیوی مرجع متصل (افزودن، حذف، جایگزینی)؛ خروجی طول و نسبت تصویر خودِ کلیپ منبع را حفظ می‌کند و ویجت‌های duration و ratio نادیده گرفته می‌شوند.
extend: ادامه دادن یک ویدیوی مرجع متصل به جلو یا عقب؛ پرامپت باید شامل «extend forward»، «extend backward» یا «continue» باشد، نسبت تصویر از کلیپ منبع پیروی می‌کند، و خروجی فقط شامل بخش تازه‌تولیدشده با مدتی که تعیین کرده‌اید است، نه کلیپ منبع. پیش‌فرض: auto. | COMBO | بله | "auto"
"reference"
"edit"
"extend" | +| `output_format` | فرمت ظرف ویدیوی خروجی. پیش‌فرض: mp4. | COMBO | بله | "mp4" | + +### ورودی‌های Seedance 2.0 + +این ورودی‌ها زمانی ظاهر می‌شوند که `model` روی «Seedance 2.0» تنظیم شده باشد. + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `prompt` | پرامپت متنی برای تولید ویدیو. پیش‌فرض: رشتهٔ خالی. | STRING | بله | Multiline text | +| `resolution` | رزولوشن ویدیوی خروجی. | COMBO | بله | "480p"
"720p"
"1080p"
"4k" | +| `ratio` | نسبت تصویر ویدیوی خروجی. پیش‌فرض: adaptive. | COMBO | بله | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | مدت ویدیوی خروجی به ثانیه (4-15). پیش‌فرض: 7. | INT | بله | 4 to 15 | +| `generate_audio` | فعال‌سازی تولید صدا برای ویدیوی خروجی. پیش‌فرض: True. | BOOLEAN | بله | true
false | + +### ورودی‌های Seedance 2.0 Fast و Seedance 2.0 Mini + +این ورودی‌ها زمانی ظاهر می‌شوند که `model` روی «Seedance 2.0 Fast» یا «Seedance 2.0 Mini» تنظیم شده باشد. هر دو مدل مجموعه ورودی یکسانی دارند. + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `prompt` | پرامپت متنی برای تولید ویدیو. پیش‌فرض: رشتهٔ خالی. | STRING | بله | Multiline text | +| `resolution` | رزولوشن ویدیوی خروجی. | COMBO | بله | "480p"
"720p" | +| `ratio` | نسبت تصویر ویدیوی خروجی. پیش‌فرض: adaptive. | COMBO | بله | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | مدت ویدیوی خروجی به ثانیه (4-15). پیش‌فرض: 7. | INT | بله | 4 to 15 | +| `generate_audio` | فعال‌سازی تولید صدا برای ویدیوی خروجی. پیش‌فرض: True. | BOOLEAN | بله | true
false | + +### ورودی‌های مرجع + +این اسلات‌های مرجع قابل‌افزودن برای همهٔ مدل‌ها در دسترس هستند. حداکثر تعداد اسلات‌ها بسته به مدل متفاوت است: Seedance 2.5 تا 30 تصویر، 10 ویدیو، 10 صدا و 30 دارایی را پشتیبانی می‌کند؛ Seedance 2.0، 2.0 Fast و 2.0 Mini تا 9 تصویر، 3 ویدیو، 3 صدا و 9 دارایی را پشتیبانی می‌کنند. + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `reference_images` | اسلات قابل‌افزودن: 1..N تصویر مرجع که خروجی را هدایت می‌کنند متصل کنید. محدودیت تعداد به‌ازای مدل است (به بخش‌های مدل مراجعه کنید). تصاویر از نظر نسبت تصویر (0.4 تا 2.5) اعتبارسنجی و به‌صورت خودکار به حداکثر ضلع 6000 پیکسل کاهش مقیاس می‌یابند. | IMAGE | خیر | 1..9 slots (Seedance 2.0 family)
1..30 slots (Seedance 2.5) | +| `reference_videos` | اسلات قابل‌افزودن: 1..N ویدیوی مرجع متصل کنید. محدودیت تعداد به‌ازای مدل است (به بخش‌های مدل مراجعه کنید). هر ویدیو باید حداقل 1.8 ثانیه طول داشته باشد و باید در محدودهٔ پیکسلی مدل و رزولوشن انتخابی بگنجد. | VIDEO | خیر | 1..3 slots (Seedance 2.0 family)
1..10 slots (Seedance 2.5) | +| `reference_audios` | اسلات قابل‌افزودن: 1..N آهنگ صوتی مرجع متصل کنید. محدودیت تعداد به‌ازای مدل است (به بخش‌های مدل مراجعه کنید). هر صدا باید حداقل 1.8 ثانیه طول داشته باشد. | AUDIO | خیر | 1..3 slots (Seedance 2.0 family)
1..10 slots (Seedance 2.5) | +| `reference_assets` | اسلات قابل‌افزودن: 1..N رشتهٔ شناسهٔ دارایی برای رسانه‌هایی که قبلاً در کتابخانهٔ مجازی Seedance آپلود شده‌اند متصل کنید. هر دارایی باید وضعیت Active داشته باشد. می‌توانید در پرامپت با نشانه‌هایی مانند `asset1` یا `asset 1` به یک دارایی ارجاع دهید؛ گره آن‌ها را با برچسب موقعیتی دارایی (مثلاً «Image 2» یا «Video 1») جایگزین می‌کند. | STRING | خیر | 1..9 slots (Seedance 2.0 family)
1..30 slots (Seedance 2.5) | +| `auto_downscale` | به‌صورت خودکار ویدیوهای مرجعی را که از بودجهٔ پیکسلی مدل برای رزولوشن انتخابی فراتر می‌روند، کاهش مقیاس می‌دهد. نسبت تصویر حفظ می‌شود؛ ویدیوهایی که در محدوده هستند دست‌نخورده می‌مانند. پیش‌فرض: True. | BOOLEAN | خیر | true
false | +| `auto_upscale` | به‌صورت خودکار ویدیوهای مرجعی را که کمتر از حداقل تعداد پیکسل مدل برای رزولوشن انتخابی هستند، افزایش مقیاس می‌دهد. نسبت تصویر حفظ می‌شود؛ ویدیوهایی که حداقل را برآورده می‌کنند دست‌نخورده می‌مانند. توجه: افزایش مقیاس یک منبع کم‌رزولوشن جزئیات واقعی اضافه نمی‌کند و ممکن است تولیدهایی با کیفیت پایین‌تر ایجاد کند. پیش‌فرض: False. تنظیم پیشرفته. | BOOLEAN | خیر | true
false | + +**توجه:** برای اجرای گره حداقل به یک تصویر، ویدیو یا دارایی مرجع نیاز است (Seedance 2.5 ارجاع‌های فقط‌صوتی را نیز می‌پذیرد). ویدیوها و صداهای مرجع باید هر یک حداقل 1.8 ثانیه طول داشته باشند و مدت ترکیبی همهٔ ویدیوهای مرجع (و به‌طور جداگانه، همهٔ صداهای مرجع) نباید از حداکثر مجموع ثانیه‌های مدل انتخابی بیشتر شود. تصاویر مرجع باید نسبت تصویری تقریباً بین 2:5 و 5:2 (0.4 تا 2.5) داشته باشند، حداقل 300x300 پیکسل باشند و به‌صورت خودکار به حداکثر ضلع 6000 پیکسل کاهش مقیاس یابند. گزینه‌های `task_type` یعنی «edit» و «extend» فقط با Seedance 2.5 در دسترس هستند و هر دو حداقل به یک ویدیوی مرجع نیاز دارند؛ وقتی «edit» استفاده می‌شود، خروجی طول و نسبت تصویر خودِ کلیپ منبع را حفظ می‌کند و ویجت‌های `duration` و `ratio` نادیده گرفته می‌شوند، و وقتی «extend» استفاده می‌شود، خروجی فقط شامل بخش تازه‌تولیدشده با مدتی که تعیین کرده‌اید است. دارایی‌های ارجاع‌شده باید در وضعیت Active باشند، در غیر این صورت وظیفه شکست می‌خورد. + +## خروجی‌ها + +| نام خروجی | توضیحات | نوع داده | +|-------------|-------------|-----------| +| `video` | ویدیوی تولیدشده که پس از تکمیل وظیفهٔ تولید از ارائه‌دهنده دانلود می‌شود. هنگامی که تولید صدا فعال باشد، شامل صدا نیز هست. | VIDEO | + +> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/fa.md) + +--- +**Source fingerprint (SHA-256):** `3a6bba12e719204ba5dba9d7d5f2b4c5285ed68974ee015b6e4a7892a1cf0933` diff --git a/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/fr.md b/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/fr.md new file mode 100644 index 000000000..a5303d3f1 --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/fr.md @@ -0,0 +1,77 @@ +# ByteDance2ReferenceNodeV2 + +ByteDance Seedance 2.5 Reference to Video génère, édite ou étend des vidéos à l’aide des modèles ByteDance Seedance (Seedance 2.5, 2.0, 2.0 Fast et 2.0 Mini) guidé par une invite textuelle et des images, vidéos, audios ou ressources de bibliothèque téléversés précédemment en option. Il téléverse les références, soumet une tâche de génération, attend son achèvement et renvoie le fichier vidéo final. + +## Entrées + +### Entrées communes + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `model` | Sélecteur de modèle. Seedance 2.5 pour le modèle le plus récent, des vidéos jusqu’à 30 secondes et une sortie mp4/mov ; Seedance 2.0 pour une qualité maximale et la 4K ; Fast pour l’optimisation de la vitesse ; Mini pour la génération la plus rapide et la moins coûteuse. La sélection d’un modèle modifie les widgets d’entrée affichés ci-dessous. | DYNAMIC_COMBO | Oui | "Seedance 2.5"
"Seedance 2.0"
"Seedance 2.0 Fast"
"Seedance 2.0 Mini" | +| `seed` | Le seed contrôle si le nœud doit s’exécuter à nouveau ; les résultats sont non déterministes quel que soit le seed. Par défaut : 0. | INT | Oui | 0 à 2147483647 | +| `watermark` | Indique s’il faut ajouter un filigrane à la vidéo. Par défaut : False. Paramètre avancé. | BOOLEAN | Oui | true
false | + +### Entrées Seedance 2.5 + +Ces entrées apparaissent lorsque `model` est défini sur « Seedance 2.5 ». + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `prompt` | Invite textuelle pour la génération de vidéos. Mettez les répliques entre guillemets pour orienter le dialogue généré. Par défaut : chaîne vide. | STRING | Oui | Texte multiligne | +| `resolution` | Résolution de la vidéo de sortie. Par défaut : 720p. | COMBO | Oui | "480p"
"720p"
"1080p" | +| `ratio` | Rapport d’aspect de la vidéo de sortie. Par défaut : 16:9. | COMBO | Oui | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | Durée de la vidéo de sortie en secondes (4-30). Par défaut : 5. | INT | Oui | 4 à 30 | +| `generate_audio` | Active la génération audio pour la vidéo de sortie. Par défaut : True. | BOOLEAN | Oui | true
false | +| `task_type` | Détermine quoi faire avec les médias de référence. Chaque valeur sauf auto est validée lors de la soumission de la tâche, de sorte que les paramètres incompatibles échouent avant le début de la génération.
auto : le modèle déduit la tâche à partir du prompt et des entrées, et les paramètres qui contredisent son interprétation n’échouent qu’après le début de la génération.
reference : générer une nouvelle vidéo guidée par les images, vidéos et audios de référence.
edit : modifier une vidéo de référence connectée (ajouter, supprimer, remplacer) ; la sortie conserve la durée et le format de la source, et les widgets duration et ratio sont ignorés.
extend : continuer une vidéo de référence connectée vers l’avant ou vers l’arrière ; le prompt doit contenir « extend forward », « extend backward » ou « continue », le format suit la source, et la sortie ne contient que le segment nouvellement généré de la durée définie, pas la source. Par défaut : auto. | COMBO | Oui | "auto"
"reference"
"edit"
"extend" | +| `output_format` | Format de conteneur de la vidéo de sortie. Par défaut : mp4. | COMBO | Oui | "mp4" | + +### Entrées Seedance 2.0 + +Ces entrées apparaissent lorsque `model` est défini sur « Seedance 2.0 ». + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `prompt` | Invite textuelle pour la génération de vidéos. Par défaut : chaîne vide. | STRING | Oui | Texte multiligne | +| `resolution` | Résolution de la vidéo de sortie. | COMBO | Oui | "480p"
"720p"
"1080p"
"4k" | +| `ratio` | Rapport d’aspect de la vidéo de sortie. Par défaut : adaptive. | COMBO | Oui | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | Durée de la vidéo de sortie en secondes (4-15). Par défaut : 7. | INT | Oui | 4 à 15 | +| `generate_audio` | Active la génération audio pour la vidéo de sortie. Par défaut : True. | BOOLEAN | Oui | true
false | + +### Entrées Seedance 2.0 Fast et Seedance 2.0 Mini + +Ces entrées apparaissent lorsque `model` est défini sur « Seedance 2.0 Fast » ou « Seedance 2.0 Mini ». Les deux modèles partagent le même ensemble d’entrées. + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `prompt` | Invite textuelle pour la génération de vidéos. Par défaut : chaîne vide. | STRING | Oui | Texte multiligne | +| `resolution` | Résolution de la vidéo de sortie. | COMBO | Oui | "480p"
"720p" | +| `ratio` | Rapport d’aspect de la vidéo de sortie. Par défaut : adaptive. | COMBO | Oui | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | Durée de la vidéo de sortie en secondes (4-15). Par défaut : 7. | INT | Oui | 4 à 15 | +| `generate_audio` | Active la génération audio pour la vidéo de sortie. Par défaut : True. | BOOLEAN | Oui | true
false | + +### Entrées de référence + +Ces emplacements de référence extensibles sont disponibles pour tous les modèles. Le nombre maximal d’emplacements diffère selon le modèle : Seedance 2.5 prend en charge jusqu’à 30 images, 10 vidéos, 10 audios et 30 ressources ; Seedance 2.0, 2.0 Fast et 2.0 Mini prennent en charge jusqu’à 9 images, 3 vidéos, 3 audios et 9 ressources. + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `reference_images` | Emplacement extensible : connectez 1 à N images de référence qui guident la sortie. La limite de nombre dépend du modèle (voir les sections sur les modèles). Les images sont validées pour leur rapport d’aspect (0,4 à 2,5) et automatiquement réduites à un côté maximal de 6000 pixels. | IMAGE | Non | 1..9 emplacements (famille Seedance 2.0)
1..30 emplacements (Seedance 2.5) | +| `reference_videos` | Emplacement extensible : connectez 1 à N vidéos de référence. La limite de nombre dépend du modèle (voir les sections sur les modèles). Chaque vidéo doit durer au moins 1,8 seconde et respecter les limites de pixels du modèle et de la résolution sélectionnés. | VIDEO | Non | 1..3 emplacements (famille Seedance 2.0)
1..10 emplacements (Seedance 2.5) | +| `reference_audios` | Emplacement extensible : connectez 1 à N pistes audio de référence. La limite de nombre dépend du modèle (voir les sections sur les modèles). Chaque audio doit durer au moins 1,8 seconde. | AUDIO | Non | 1..3 emplacements (famille Seedance 2.0)
1..10 emplacements (Seedance 2.5) | +| `reference_assets` | Emplacement extensible : connectez 1 à N chaînes d’identifiant de ressource pour des médias déjà téléversés dans la bibliothèque virtuelle Seedance. Chaque ressource doit être Active. Vous pouvez faire référence à une ressource dans le prompt avec des jetons tels que `asset1` ou `asset 1` ; le nœud les remplace par l’étiquette positionnelle de la ressource (par exemple « Image 2 » ou « Vidéo 1 »). | STRING | Non | 1..9 emplacements (famille Seedance 2.0)
1..30 emplacements (Seedance 2.5) | +| `auto_downscale` | Réduit automatiquement les vidéos de référence qui dépassent le budget de pixels du modèle pour la résolution sélectionnée. Le rapport d’aspect est préservé ; les vidéos déjà dans les limites ne sont pas modifiées. Par défaut : True. | BOOLEAN | Non | true
false | +| `auto_upscale` | Augmente automatiquement la résolution des vidéos de référence qui sont en dessous du nombre minimal de pixels du modèle pour la résolution sélectionnée. Le rapport d’aspect est préservé ; les vidéos qui respectent déjà le minimum ne sont pas modifiées. Remarque : augmenter la résolution d’une source en basse résolution n’ajoute pas de vrai détail et peut produire des générations de qualité inférieure. Par défaut : False. Paramètre avancé. | BOOLEAN | Non | true
false | + +**Remarque :** Au moins une image, une vidéo ou une ressource de référence est requise pour exécuter le nœud (Seedance 2.5 accepte également les références audio uniquement). Les vidéos et audios de référence doivent durer chacun au moins 1,8 seconde, et la durée combinée de toutes les vidéos de référence (et séparément, celle de tous les audios de référence) ne doit pas dépasser le nombre total maximal de secondes du modèle sélectionné. Les images de référence doivent avoir un rapport d’aspect compris entre environ 2:5 et 5:2 (0,4 à 2,5), faire au moins 300x300 pixels, et sont automatiquement réduites à un côté maximal de 6000 pixels. Les options « edit » et « extend » de `task_type` ne sont disponibles qu’avec Seedance 2.5 et nécessitent toutes deux au moins une vidéo de référence ; lorsque « edit » est utilisé, la sortie conserve la durée et le format de la source, et les widgets `duration` et `ratio` sont ignorés ; lorsque « extend » est utilisé, la sortie ne contient que le segment nouvellement généré à la durée définie. Les ressources référencées doivent être au statut Active, sinon la tâche échoue. + +## Sorties + +| Nom de sortie | Description | Type de données | +|---------------|-------------|-----------------| +| `video` | La vidéo générée, téléchargée depuis le fournisseur une fois la tâche de génération terminée. Contient de l’audio lorsque la génération audio est activée. | VIDEO | + +> Cette documentation a été générée par IA. Si vous trouvez des erreurs ou avez des suggestions d'amélioration, n'hésitez pas à contribuer ! [Modifier sur GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/fr.md) + +--- +**Source fingerprint (SHA-256):** `3a6bba12e719204ba5dba9d7d5f2b4c5285ed68974ee015b6e4a7892a1cf0933` diff --git a/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/ja.md b/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/ja.md new file mode 100644 index 000000000..90a5911de --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/ja.md @@ -0,0 +1,77 @@ +# ByteDance2ReferenceNodeV2 + +ByteDance Seedance 2.5 Reference to Video は、テキストプロンプトと、必要に応じて参照画像・動画・音声・以前にアップロードしたライブラリアセットに基づいて、ByteDance Seedance モデル(Seedance 2.5、2.0、2.0 Fast、2.0 Mini)を使用して動画を生成、編集、または延長します。参照をアップロードし、生成タスクを送信して完了を待ち、完成した動画ファイルを返します。 + +## 入力 + +### 共通入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `model` | モデルセレクター。最新モデルの Seedance 2.5 は最大 30 秒の動画と mp4/mov 出力に対応し、Seedance 2.0 は最高品質と 4k に対応、Fast は速度最適化向け、Mini は最速かつ低コストの生成向けです。モデルを選択すると、以下に表示される入力ウィジェットが変わります。 | DYNAMIC_COMBO | 必須 | "Seedance 2.5"
"Seedance 2.0"
"Seedance 2.0 Fast"
"Seedance 2.0 Mini" | +| `seed` | シードはノードを再実行するかどうかを制御します。シードに関係なく結果は非決定的です。デフォルト: 0。 | INT | 必須 | 0 to 2147483647 | +| `watermark` | 動画に透かしを追加するかどうか。デフォルト: False。詳細設定。 | BOOLEAN | 必須 | true
false | + +### Seedance 2.5 入力 + +これらの入力は、`model` が "Seedance 2.5" に設定されている場合に表示されます。 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `prompt` | 動画生成のためのテキストプロンプト。台詞を二重引用符で囲むと、生成される会話を誘導できます。デフォルト: 空文字列。 | STRING | 必須 | 複数行テキスト | +| `resolution` | 出力動画の解像度。デフォルト: 720p。 | COMBO | 必須 | "480p"
"720p"
"1080p" | +| `ratio` | 出力動画のアスペクト比。デフォルト: 16:9。 | COMBO | 必須 | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | 出力動画の長さ(秒)(4〜30)。デフォルト: 5。 | INT | 必須 | 4 to 30 | +| `generate_audio` | 出力動画の音声生成を有効にします。デフォルト: True。 | BOOLEAN | 必須 | true
false | +| `task_type` | 参照メディアの扱いを指定します。auto 以外の値はタスク送信時に検証されるため、設定が一致しない場合は生成開始前に失敗します。
auto: モデルがプロンプトと入力からタスクを推測します。モデルの解釈と矛盾する設定は、生成開始後にのみ失敗します。
reference: 参照画像・動画・音声に基づいて新しい動画を生成します。
edit: 接続された参照動画を変更(追加、削除、置換)します。出力はソースクリップの長さとアスペクト比を維持し、duration と ratio ウィジェットは無視されます。
extend: 接続された参照動画を前方または後方に延長します。プロンプトに「extend forward」「extend backward」「continue」のいずれかを指定してください。アスペクト比はソースクリップに従い、出力にはソースクリップではなく、指定した長さで新しく生成された部分のみが含まれます。デフォルト: auto。 | COMBO | 必須 | "auto"
"reference"
"edit"
"extend" | +| `output_format` | 出力動画のコンテナ形式。デフォルト: mp4。 | COMBO | 必須 | "mp4" | + +### Seedance 2.0 入力 + +これらの入力は、`model` が "Seedance 2.0" に設定されている場合に表示されます。 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `prompt` | 動画生成のためのテキストプロンプト。デフォルト: 空文字列。 | STRING | 必須 | 複数行テキスト | +| `resolution` | 出力動画の解像度。 | COMBO | 必須 | "480p"
"720p"
"1080p"
"4k" | +| `ratio` | 出力動画のアスペクト比。デフォルト: adaptive。 | COMBO | 必須 | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | 出力動画の長さ(秒)(4〜15)。デフォルト: 7。 | INT | 必須 | 4 to 15 | +| `generate_audio` | 出力動画の音声生成を有効にします。デフォルト: True。 | BOOLEAN | 必須 | true
false | + +### Seedance 2.0 Fast および Seedance 2.0 Mini 入力 + +これらの入力は、`model` が "Seedance 2.0 Fast" または "Seedance 2.0 Mini" に設定されている場合に表示されます。両モデルとも同じ入力セットです。 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `prompt` | 動画生成のためのテキストプロンプト。デフォルト: 空文字列。 | STRING | 必須 | 複数行テキスト | +| `resolution` | 出力動画の解像度。 | COMBO | 必須 | "480p"
"720p" | +| `ratio` | 出力動画のアスペクト比。デフォルト: adaptive。 | COMBO | 必須 | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | 出力動画の長さ(秒)(4〜15)。デフォルト: 7。 | INT | 必須 | 4 to 15 | +| `generate_audio` | 出力動画の音声生成を有効にします。デフォルト: True。 | BOOLEAN | 必須 | true
false | + +### 参照入力 + +これらの追加可能な参照スロットは、すべてのモデルで利用できます。スロットの最大数はモデルごとに異なります。Seedance 2.5 は最大 30 個の画像、10 個の動画、10 個の音声、30 個のアセットに対応し、Seedance 2.0、2.0 Fast、2.0 Mini は最大 9 個の画像、3 個の動画、3 個の音声、9 個のアセットに対応します。 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `reference_images` | 追加可能スロット: 出力をガイドする参照画像を 1..N 個接続します。数の上限はモデルごとに異なります(各モデルのセクションを参照)。画像はアスペクト比(0.4〜2.5)が検証され、長辺が最大 6000 ピクセルになるように自動的に縮小されます。 | IMAGE | 任意 | 1..9 スロット(Seedance 2.0 ファミリー)
1..30 スロット(Seedance 2.5) | +| `reference_videos` | 追加可能スロット: 参照動画を 1..N 個接続します。数の上限はモデルごとに異なります(各モデルのセクションを参照)。各動画は 1.8 秒以上であり、選択したモデルと解像度のピクセル制限内である必要があります。 | VIDEO | 任意 | 1..3 スロット(Seedance 2.0 ファミリー)
1..10 スロット(Seedance 2.5) | +| `reference_audios` | 追加可能スロット: 参照音声トラックを 1..N 個接続します。数の上限はモデルごとに異なります(各モデルのセクションを参照)。各音声は 1.8 秒以上である必要があります。 | AUDIO | 任意 | 1..3 スロット(Seedance 2.0 ファミリー)
1..10 スロット(Seedance 2.5) | +| `reference_assets` | 追加可能スロット: Seedance 仮想ライブラリにアップロード済みのメディアのアセット ID 文字列を 1..N 個接続します。各アセットは Active 状態である必要があります。プロンプト内で `asset1` や `asset 1` などのトークンを使用してアセットを参照できます。ノードはこれらのトークンを、アセットの位置ラベル(例:「Image 2」または「Video 1」)に置き換えます。 | STRING | 任意 | 1..9 スロット(Seedance 2.0 ファミリー)
1..30 スロット(Seedance 2.5) | +| `auto_downscale` | 選択した解像度におけるモデルのピクセル上限を超える参照動画を自動的に縮小します。アスペクト比は維持され、制限内の動画は変更されません。デフォルト: True。 | BOOLEAN | 任意 | true
false | +| `auto_upscale` | 選択した解像度におけるモデルの最小ピクセル数に満たない参照動画を自動的に拡大します。アスペクト比は維持され、最小要件を満たす動画は変更されません。注: 低解像度のソースを拡大しても実際のディテールは追加されず、生成品質が低下する可能性があります。デフォルト: False。詳細設定。 | BOOLEAN | 任意 | true
false | + +**注記:** ノードを実行するには、少なくとも 1 つの参照画像、動画、またはアセットが必要です(Seedance 2.5 は音声のみの参照も受け付けます)。参照動画と参照音声はそれぞれ 1.8 秒以上である必要があり、すべての参照動画の合計時間(および参照音声の合計時間)は、選択したモデルの最大合計秒数を超えてはなりません。参照画像のアスペクト比はおよそ 2:5 から 5:2(0.4〜2.5)の範囲内で、少なくとも 300x300 ピクセルである必要があり、長辺が最大 6000 ピクセルになるように自動的に縮小されます。`task_type` の "edit" と "extend" オプションは Seedance 2.5 でのみ利用可能で、どちらも少なくとも 1 つの参照動画が必要です。"edit" を使用すると、出力はソースクリップの長さとアスペクト比を維持し、`duration` と `ratio` ウィジェットは無視されます。"extend" を使用すると、出力には指定した長さで新しく生成されたセグメントのみが含まれます。参照するアセットは Active 状態である必要があります。そうでない場合、タスクは失敗します。 + +## 出力 + +| 出力名 | 説明 | データ型 | +|-----------|-------------|-----------| +| `video` | 生成された動画。生成タスク完了後にプロバイダーからダウンロードされます。音声生成が有効な場合は音声を含みます。 | VIDEO | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/ja.md) + +--- +**Source fingerprint (SHA-256):** `3a6bba12e719204ba5dba9d7d5f2b4c5285ed68974ee015b6e4a7892a1cf0933` diff --git a/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/ko.md b/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/ko.md new file mode 100644 index 000000000..62ff79632 --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/ko.md @@ -0,0 +1,77 @@ +# ByteDance2ReferenceNodeV2 + +ByteDance Seedance 2.5 Reference to Video 노드는 ByteDance Seedance 모델(Seedance 2.5, 2.0, 2.0 Fast 및 2.0 Mini)을 사용하여 텍스트 프롬프트와 선택적 참조 이미지, 비디오, 오디오 또는 이전에 업로드한 라이브러리 자산을 기반으로 비디오를 생성, 편집 또는 확장합니다. 참조를 업로드하고 생성 작업을 제출한 후 완료를 기다렸다가 완성된 비디오 파일을 반환합니다. + +## 입력 + +### 공통 입력 + +| 매개변수 | 설명 | 데이터 유형 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `model` | 모델 선택기. 최신 모델은 Seedance 2.5로 최대 30초 비디오와 mp4/mov 출력을 지원합니다. Seedance 2.0은 최고 품질과 4K를 지원합니다. Fast는 속도 최적화용, Mini는 가장 빠르고 저렴한 생성용입니다. 모델을 선택하면 아래 표시되는 입력 위젯이 변경됩니다. | DYNAMIC_COMBO | 예 | "Seedance 2.5"
"Seedance 2.0"
"Seedance 2.0 Fast"
"Seedance 2.0 Mini" | +| `seed` | 시드는 노드 재실행 여부를 제어합니다. 시드와 관계없이 결과는 비결정적입니다. 기본값: 0. | INT | 예 | 0 to 2147483647 | +| `watermark` | 비디오에 워터마크를 추가할지 여부. 기본값: False. 고급 설정. | BOOLEAN | 예 | true
false | + +### Seedance 2.5 입력 + +이 입력들은 `model`이 "Seedance 2.5"로 설정된 경우 표시됩니다. + +| 매개변수 | 설명 | 데이터 유형 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `prompt` | 비디오 생성용 텍스트 프롬프트. 대사는 큰따옴표로 묶어 생성될 대화를 유도하세요. 기본값: 빈 문자열. | STRING | 예 | Multiline text | +| `resolution` | 출력 비디오의 해상도. 기본값: 720p. | COMBO | 예 | "480p"
"720p"
"1080p" | +| `ratio` | 출력 비디오의 화면 비율. 기본값: 16:9. | COMBO | 예 | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | 출력 비디오의 길이(초, 4-30). 기본값: 5. | INT | 예 | 4 to 30 | +| `generate_audio` | 출력 비디오에 오디오 생성을 활성화합니다. 기본값: True. | BOOLEAN | 예 | true
false | +| `task_type` | 참조 미디어로 수행할 작업. auto를 제외한 모든 값은 작업 제출 시 검증되므로, 일치하지 않는 설정은 생성 시작 전에 실패합니다.
auto: 모델이 프롬프트와 입력에서 작업을 추론하며, 모델의 해석과 충돌하는 설정은 생성이 시작된 후에만 실패합니다.
reference: 참조 이미지, 비디오, 오디오를 기반으로 새 비디오를 생성합니다.
edit: 연결된 참조 비디오를 변경합니다(추가, 제거, 교체). 출력은 소스 클립의 자체 길이와 화면 비율을 유지하며 `duration` 및 `ratio` 위젯은 무시됩니다.
extend: 연결된 참조 비디오를 앞이나 뒤로 계속 확장합니다. 프롬프트에 "extend forward", "extend backward" 또는 "continue"라고 입력해야 하며, 화면 비율은 소스 클립을 따르고 출력에는 설정한 길이의 새로 생성된 세그먼트만 포함되고 소스 클립은 포함되지 않습니다. 기본값: auto. | COMBO | 예 | "auto"
"reference"
"edit"
"extend" | +| `output_format` | 출력 비디오의 컨테이너 형식. 기본값: mp4. | COMBO | 예 | "mp4" | + +### Seedance 2.0 입력 + +이 입력들은 `model`이 "Seedance 2.0"으로 설정된 경우 표시됩니다. + +| 매개변수 | 설명 | 데이터 유형 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `prompt` | 비디오 생성용 텍스트 프롬프트. 기본값: 빈 문자열. | STRING | 예 | Multiline text | +| `resolution` | 출력 비디오의 해상도. | COMBO | 예 | "480p"
"720p"
"1080p"
"4k" | +| `ratio` | 출력 비디오의 화면 비율. 기본값: adaptive. | COMBO | 예 | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | 출력 비디오의 길이(초, 4-15). 기본값: 7. | INT | 예 | 4 to 15 | +| `generate_audio` | 출력 비디오에 오디오 생성을 활성화합니다. 기본값: True. | BOOLEAN | 예 | true
false | + +### Seedance 2.0 Fast 및 Seedance 2.0 Mini 입력 + +이 입력들은 `model`이 "Seedance 2.0 Fast" 또는 "Seedance 2.0 Mini"로 설정된 경우 표시됩니다. 두 모델은 동일한 입력 세트를 공유합니다. + +| 매개변수 | 설명 | 데이터 유형 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `prompt` | 비디오 생성용 텍스트 프롬프트. 기본값: 빈 문자열. | STRING | 예 | Multiline text | +| `resolution` | 출력 비디오의 해상도. | COMBO | 예 | "480p"
"720p" | +| `ratio` | 출력 비디오의 화면 비율. 기본값: adaptive. | COMBO | 예 | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | 출력 비디오의 길이(초, 4-15). 기본값: 7. | INT | 예 | 4 to 15 | +| `generate_audio` | 출력 비디오에 오디오 생성을 활성화합니다. 기본값: True. | BOOLEAN | 예 | true
false | + +### 참조 입력 + +이 확장 가능한 참조 슬롯은 모든 모델에 사용할 수 있습니다. 최대 슬롯 수는 모델마다 다릅니다. Seedance 2.5는 이미지 최대 30개, 비디오 10개, 오디오 10개, 자산 30개를 지원하며, Seedance 2.0, 2.0 Fast 및 2.0 Mini는 이미지 9개, 비디오 3개, 오디오 3개, 자산 9개를 지원합니다. + +| 매개변수 | 설명 | 데이터 유형 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `reference_images` | 확장 가능한 슬롯: 출력을 안내하는 참조 이미지 1..N개를 연결합니다. 개수 제한은 모델별로 다릅니다(모델 섹션 참조). 이미지는 화면 비율(0.4~2.5)을 검증하고 최대 변 길이 6000픽셀로 자동 축소됩니다. | IMAGE | 아니요 | 1..9개 슬롯 (Seedance 2.0 계열)
1..30개 슬롯 (Seedance 2.5) | +| `reference_videos` | 확장 가능한 슬롯: 참조 비디오 1..N개를 연결합니다. 개수 제한은 모델별로 다릅니다(모델 섹션 참조). 각 비디오는 최소 1.8초 이상이어야 하며 선택한 모델 및 해상도에 대한 픽셀 제한을 충족해야 합니다. | VIDEO | 아니요 | 1..3개 슬롯 (Seedance 2.0 계열)
1..10개 슬롯 (Seedance 2.5) | +| `reference_audios` | 확장 가능한 슬롯: 참조 오디오 트랙 1..N개를 연결합니다. 개수 제한은 모델별로 다릅니다(모델 섹션 참조). 각 오디오는 최소 1.8초 이상이어야 합니다. | AUDIO | 아니요 | 1..3개 슬롯 (Seedance 2.0 계열)
1..10개 슬롯 (Seedance 2.5) | +| `reference_assets` | 확장 가능한 슬롯: Seedance 가상 라이브러리에 이미 업로드된 미디어의 자산 ID 문자열 1..N개를 연결합니다. 각 자산은 Active 상태여야 합니다. 프롬프트에서 `asset1` 또는 `asset 1` 같은 토큰으로 자산을 참조할 수 있습니다. 노드는 이를 자산의 위치 레이블(예: "Image 2" 또는 "Video 1")로 대체합니다. | STRING | 아니요 | 1..9개 슬롯 (Seedance 2.0 계열)
1..30개 슬롯 (Seedance 2.5) | +| `auto_downscale` | 선택한 해상도에 대한 모델의 픽셀 예산을 초과하는 참조 비디오를 자동으로 축소합니다. 화면 비율은 유지되며, 이미 제한 내에 있는 비디오는 변경되지 않습니다. 기본값: True. | BOOLEAN | 아니요 | true
false | +| `auto_upscale` | 선택한 해상도에 대한 모델의 최소 픽셀 수보다 낮은 참조 비디오를 자동으로 확대합니다. 화면 비율은 유지되며, 이미 최소 조건을 충족하는 비디오는 변경되지 않습니다. 참고: 저해상도 소스를 확대해도 실제 디테일이 추가되지는 않으며, 품질이 낮은 생성 결과가 나올 수 있습니다. 기본값: False. 고급 설정. | BOOLEAN | 아니요 | true
false | + +**참고:** 노드를 실행하려면 최소한 하나의 참조 이미지, 비디오 또는 자산이 필요합니다(Seedance 2.5는 오디오 전용 참조도 허용). 참조 비디오와 오디오는 각각 최소 1.8초 이상이어야 하며, 모든 참조 비디오의 총 길이(및 별도로 모든 참조 오디오의 총 길이)는 선택한 모델의 최대 총 초 수를 초과할 수 없습니다. 참조 이미지의 화면 비율은 대략 2:5~5:2(0.4~2.5) 사이여야 하고, 최소 300x300픽셀이어야 하며, 최대 변 길이 6000픽셀로 자동 축소됩니다. `task_type`의 "edit" 및 "extend" 옵션은 Seedance 2.5에서만 사용할 수 있으며 둘 다 최소 하나의 참조 비디오가 필요합니다. "edit"를 사용하면 출력이 소스 클립의 자체 길이와 화면 비율을 유지하고 `duration` 및 `ratio` 위젯은 무시되며, "extend"를 사용하면 출력에는 설정한 길이의 새로 생성된 세그먼트만 포함됩니다. 참조된 자산은 Active 상태여야 하며, 그렇지 않으면 작업이 실패합니다. + +## 출력 + +| 출력 이름 | 설명 | 데이터 유형 | +|-------------|-------------|-----------| +| `video` | 생성된 비디오. 생성 작업이 완료되면 공급자로부터 다운로드됩니다. 오디오 생성이 활성화된 경우 오디오가 포함됩니다. | VIDEO | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/ko.md) + +--- +**Source fingerprint (SHA-256):** `3a6bba12e719204ba5dba9d7d5f2b4c5285ed68974ee015b6e4a7892a1cf0933` diff --git a/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/pt-BR.md b/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/pt-BR.md new file mode 100644 index 000000000..f7272b80a --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/pt-BR.md @@ -0,0 +1,77 @@ +# ByteDance2ReferenceNodeV2 + +O ByteDance Seedance 2.5 Reference to Video gera, edita ou estende vídeos usando os modelos ByteDance Seedance (Seedance 2.5, 2.0, 2.0 Fast e 2.0 Mini) guiados por um prompt de texto e imagens, vídeos, áudio ou assets de biblioteca opcionais enviados anteriormente. Ele envia as referências, submete uma tarefa de geração, aguarda a conclusão e retorna o arquivo de vídeo finalizado. + +## Entradas + +### Entradas Comuns + +| Parâmetro | Descrição | Tipo de Dado | Obrigatório | Intervalo | +|-----------|-------------|--------------|-------------|-----------| +| `model` | Seletor de modelo. Seedance 2.5 para o modelo mais recente, vídeos de até 30 segundos e saída em mp4/mov; Seedance 2.0 para máxima qualidade e 4k; Fast para otimização de velocidade; Mini para a geração mais rápida e de menor custo. Selecionar um modelo altera os widgets de entrada exibidos abaixo. | DYNAMIC_COMBO | Sim | "Seedance 2.5"
"Seedance 2.0"
"Seedance 2.0 Fast"
"Seedance 2.0 Mini" | +| `seed` | O seed controla se o nó deve ser executado novamente; os resultados são não determinísticos independentemente do seed. Padrão: 0. | INT | Sim | 0 a 2147483647 | +| `watermark` | Se deve adicionar uma marca d'água ao vídeo. Padrão: False. Configuração avançada. | BOOLEAN | Sim | true
false | + +### Entradas do Seedance 2.5 + +Estas entradas aparecem quando `model` está definido como "Seedance 2.5". + +| Parâmetro | Descrição | Tipo de Dado | Obrigatório | Intervalo | +|-----------|-------------|--------------|-------------|-----------| +| `prompt` | Prompt de texto para geração de vídeo. Coloque falas entre aspas duplas para orientar o diálogo gerado. Padrão: string vazia. | STRING | Sim | Texto multilinha | +| `resolution` | Resolução do vídeo de saída. Padrão: 720p. | COMBO | Sim | "480p"
"720p"
"1080p" | +| `ratio` | Proporção de aspecto do vídeo de saída. Padrão: 16:9. | COMBO | Sim | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | Duração do vídeo de saída em segundos (4-30). Padrão: 5. | INT | Sim | 4 a 30 | +| `generate_audio` | Ativa a geração de áudio para o vídeo de saída. Padrão: True. | BOOLEAN | Sim | true
false | +| `task_type` | O que fazer com a mídia de referência. Todos os valores, exceto auto, são validados quando a tarefa é submetida, portanto configurações incompatíveis falham antes do início da geração.
auto: o modelo infere a tarefa a partir do prompt e das entradas, e configurações que conflitam com a leitura dele falham somente depois que a geração começa.
reference: gera um novo vídeo guiado pelas imagens, vídeos e áudios de referência.
edit: altera um vídeo de referência conectado (adicionar, remover, substituir); a saída mantém a duração e a proporção de aspecto do clipe original, e os widgets de duração e proporção são ignorados.
extend: continua um vídeo de referência conectado para frente ou para trás; o prompt deve dizer "extend forward", "extend backward" ou "continue", a proporção de aspecto segue o clipe original, e a saída contém apenas o segmento recém-gerado com a duração definida, não o clipe original. Padrão: auto. | COMBO | Sim | "auto"
"reference"
"edit"
"extend" | +| `output_format` | Formato de contêiner do vídeo de saída. Padrão: mp4. | COMBO | Sim | "mp4" | + +### Entradas do Seedance 2.0 + +Estas entradas aparecem quando `model` está definido como "Seedance 2.0". + +| Parâmetro | Descrição | Tipo de Dado | Obrigatório | Intervalo | +|-----------|-------------|--------------|-------------|-----------| +| `prompt` | Prompt de texto para geração de vídeo. Padrão: string vazia. | STRING | Sim | Texto multilinha | +| `resolution` | Resolução do vídeo de saída. | COMBO | Sim | "480p"
"720p"
"1080p"
"4k" | +| `ratio` | Proporção de aspecto do vídeo de saída. Padrão: adaptive. | COMBO | Sim | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | Duração do vídeo de saída em segundos (4-15). Padrão: 7. | INT | Sim | 4 a 15 | +| `generate_audio` | Ativa a geração de áudio para o vídeo de saída. Padrão: True. | BOOLEAN | Sim | true
false | + +### Entradas do Seedance 2.0 Fast e Seedance 2.0 Mini + +Estas entradas aparecem quando `model` está definido como "Seedance 2.0 Fast" ou "Seedance 2.0 Mini". Ambos os modelos compartilham o mesmo conjunto de entradas. + +| Parâmetro | Descrição | Tipo de Dado | Obrigatório | Intervalo | +|-----------|-------------|--------------|-------------|-----------| +| `prompt` | Prompt de texto para geração de vídeo. Padrão: string vazia. | STRING | Sim | Texto multilinha | +| `resolution` | Resolução do vídeo de saída. | COMBO | Sim | "480p"
"720p" | +| `ratio` | Proporção de aspecto do vídeo de saída. Padrão: adaptive. | COMBO | Sim | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | Duração do vídeo de saída em segundos (4-15). Padrão: 7. | INT | Sim | 4 a 15 | +| `generate_audio` | Ativa a geração de áudio para o vídeo de saída. Padrão: True. | BOOLEAN | Sim | true
false | + +### Entradas de Referência + +Estes slots de referência expansíveis estão disponíveis para todos os modelos. O número máximo de slots varia por modelo: Seedance 2.5 suporta até 30 imagens, 10 vídeos, 10 áudios e 30 assets; Seedance 2.0, 2.0 Fast e 2.0 Mini suportam até 9 imagens, 3 vídeos, 3 áudios e 9 assets. + +| Parâmetro | Descrição | Tipo de Dado | Obrigatório | Intervalo | +|-----------|-------------|--------------|-------------|-----------| +| `reference_images` | Slot expansível: conecte de 1 a N imagens de referência que guiam a saída. O limite de contagem é por modelo (consulte as seções dos modelos). As imagens são validadas quanto à proporção de aspecto (0,4 a 2,5) e reduzidas automaticamente para um lado máximo de 6000 pixels. | IMAGE | Não | 1..9 slots (família Seedance 2.0)
1..30 slots (Seedance 2.5) | +| `reference_videos` | Slot expansível: conecte de 1 a N vídeos de referência. O limite de contagem é por modelo (consulte as seções dos modelos). Cada vídeo deve ter pelo menos 1,8 segundo de duração e deve caber nos limites de pixels do modelo e da resolução selecionados. | VIDEO | Não | 1..3 slots (família Seedance 2.0)
1..10 slots (Seedance 2.5) | +| `reference_audios` | Slot expansível: conecte de 1 a N faixas de áudio de referência. O limite de contagem é por modelo (consulte as seções dos modelos). Cada áudio deve ter pelo menos 1,8 segundo de duração. | AUDIO | Não | 1..3 slots (família Seedance 2.0)
1..10 slots (Seedance 2.5) | +| `reference_assets` | Slot expansível: conecte de 1 a N strings de ID de asset para mídias já enviadas à biblioteca virtual Seedance. Cada asset deve estar ativo. Você pode se referir a um asset no prompt com tokens como `asset1` ou `asset 1`; o nó os substitui pelo rótulo posicional do asset (por exemplo, "Image 2" ou "Video 1"). | STRING | Não | 1..9 slots (família Seedance 2.0)
1..30 slots (Seedance 2.5) | +| `auto_downscale` | Reduzir automaticamente a escala de vídeos de referência que excedem o orçamento de pixels do modelo para a resolução selecionada. A proporção de aspecto é preservada; vídeos que já estão dentro dos limites não são alterados. Padrão: True. | BOOLEAN | Não | true
false | +| `auto_upscale` | Aumentar automaticamente a escala de vídeos de referência que estão abaixo da contagem mínima de pixels do modelo para a resolução selecionada. A proporção de aspecto é preservada; vídeos que já atendem ao mínimo não são alterados. Observação: aumentar a escala de uma fonte de baixa resolução não adiciona detalhes reais e pode gerar resultados de qualidade inferior. Padrão: False. Configuração avançada. | BOOLEAN | Não | true
false | + +**Observação:** É necessário pelo menos uma imagem de referência, um vídeo ou um asset para executar o nó (o Seedance 2.5 também aceita apenas referências de áudio). Vídeos e áudios de referência devem ter pelo menos 1,8 segundo de duração cada, e a duração combinada de todos os vídeos de referência (e, separadamente, todos os áudios de referência) não deve exceder o total máximo de segundos do modelo selecionado. As imagens de referência devem ter uma proporção de aspecto entre aproximadamente 2:5 e 5:2 (0,4 a 2,5), ter pelo menos 300x300 pixels e são reduzidas automaticamente para um lado máximo de 6000 pixels. As opções `task_type` "edit" e "extend" estão disponíveis apenas com o Seedance 2.5 e ambas exigem pelo menos um vídeo de referência; quando "edit" é usado, a saída mantém a duração e a proporção de aspecto do clipe original e os widgets `duration` e `ratio` são ignorados, e quando "extend" é usado, a saída contém apenas o segmento recém-gerado com a duração definida. Os assets referenciados devem estar com status Ativo; caso contrário, a tarefa falha. + +## Saídas + +| Nome da Saída | Descrição | Tipo de Dado | +|---------------|-------------|--------------| +| `video` | O vídeo gerado, baixado do provedor assim que a tarefa de geração for concluída. Contém áudio quando a geração de áudio está ativada. | VIDEO | + +> Esta documentação foi gerada por IA. Se você encontrar erros ou tiver sugestões de melhoria, sinta-se à vontade para contribuir! [Editar no GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/pt-BR.md) + +--- +**Source fingerprint (SHA-256):** `3a6bba12e719204ba5dba9d7d5f2b4c5285ed68974ee015b6e4a7892a1cf0933` diff --git a/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/ru.md b/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/ru.md new file mode 100644 index 000000000..d5eeafaad --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/ru.md @@ -0,0 +1,77 @@ +# ByteDance2ReferenceNodeV2 + +ByteDance Seedance 2.5 Reference to Video генерирует, редактирует или продлевает видео с помощью моделей ByteDance Seedance (Seedance 2.5, 2.0, 2.0 Fast и 2.0 Mini) на основе текстового запроса и необязательных референсных изображений, видео, аудио или ранее загруженных библиотечных ассетов. Узел загружает референсы, отправляет задачу генерации, ожидает её завершения и возвращает готовый видеофайл. + +## Входы + +### Общие входы + +| Параметр | Описание | Тип данных | Обязательный | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `model` | Выбор модели. Seedance 2.5 — новейшая модель, видео до 30 секунд и вывод в формате mp4/mov; Seedance 2.0 — для максимального качества и 4k; Fast — для оптимизации скорости; Mini — для самой быстрой и недорогой генерации. При выборе модели меняются входные виджеты, показанные ниже. | DYNAMIC_COMBO | Да | "Seedance 2.5"
"Seedance 2.0"
"Seedance 2.0 Fast"
"Seedance 2.0 Mini" | +| `seed` | `seed` управляет тем, должен ли узел перезапускаться; результаты недетерминированы независимо от сида. По умолчанию: 0. | INT | Да | от 0 до 2147483647 | +| `watermark` | Добавлять ли водяной знак на видео. По умолчанию: False. Дополнительная настройка. | BOOLEAN | Да | true
false | + +### Входы Seedance 2.5 + +Эти входы появляются, когда параметр `model` имеет значение «Seedance 2.5». + +| Параметр | Описание | Тип данных | Обязательный | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `prompt` | Текстовый запрос для генерации видео. Помещайте произносимые реплики в двойные кавычки, чтобы управлять генерируемым диалогом. По умолчанию: пустая строка. | STRING | Да | Многострочный текст | +| `resolution` | Разрешение выходного видео. По умолчанию: 720p. | COMBO | Да | "480p"
"720p"
"1080p" | +| `ratio` | Соотношение сторон выходного видео. По умолчанию: 16:9. | COMBO | Да | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | Длительность выходного видео в секундах (от 4 до 30). По умолчанию: 5. | INT | Да | от 4 до 30 | +| `generate_audio` | Включить генерацию аудио для выходного видео. По умолчанию: True. | BOOLEAN | Да | true
false | +| `task_type` | Действие с референсными медиафайлами. Каждое значение, кроме auto, проверяется при отправке задачи, поэтому несоответствующие настройки приводят к ошибке до начала генерации.
auto: модель определяет задачу по запросу и входным данным; настройки, противоречащие её интерпретации, приводят к ошибке только после начала генерации.
reference: создание нового видео на основе референсных изображений, видео и аудио.
edit: изменение подключённого референсного видео (добавление, удаление, замена); выход сохраняет собственную длительность и соотношение сторон исходного клипа, а виджеты `duration` и `ratio` игнорируются.
extend: продолжение подключённого референсного видео вперёд или назад; в запросе следует указать «extend forward», «extend backward» или «continue»; соотношение сторон берётся из исходного клипа, а выход содержит только вновь созданный сегмент указанной вами длительности, а не исходный клип. По умолчанию: auto. | COMBO | Да | "auto"
"reference"
"edit"
"extend" | +| `output_format` | Формат контейнера выходного видео. По умолчанию: mp4. | COMBO | Да | "mp4" | + +### Входы Seedance 2.0 + +Эти входы появляются, когда параметр `model` имеет значение «Seedance 2.0». + +| Параметр | Описание | Тип данных | Обязательный | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `prompt` | Текстовый запрос для генерации видео. По умолчанию: пустая строка. | STRING | Да | Многострочный текст | +| `resolution` | Разрешение выходного видео. | COMBO | Да | "480p"
"720p"
"1080p"
"4k" | +| `ratio` | Соотношение сторон выходного видео. По умолчанию: adaptive. | COMBO | Да | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | Длительность выходного видео в секундах (от 4 до 15). По умолчанию: 7. | INT | Да | от 4 до 15 | +| `generate_audio` | Включить генерацию аудио для выходного видео. По умолчанию: True. | BOOLEAN | Да | true
false | + +### Входы Seedance 2.0 Fast и Seedance 2.0 Mini + +Эти входы появляются, когда параметр `model` имеет значение «Seedance 2.0 Fast» или «Seedance 2.0 Mini». Обе модели используют одинаковый набор входов. + +| Параметр | Описание | Тип данных | Обязательный | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `prompt` | Текстовый запрос для генерации видео. По умолчанию: пустая строка. | STRING | Да | Многострочный текст | +| `resolution` | Разрешение выходного видео. | COMBO | Да | "480p"
"720p" | +| `ratio` | Соотношение сторон выходного видео. По умолчанию: adaptive. | COMBO | Да | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | Длительность выходного видео в секундах (от 4 до 15). По умолчанию: 7. | INT | Да | от 4 до 15 | +| `generate_audio` | Включить генерацию аудио для выходного видео. По умолчанию: True. | BOOLEAN | Да | true
false | + +### Референсные входы + +Эти расширяемые референсные слоты доступны для всех моделей. Максимальное количество слотов зависит от модели: Seedance 2.5 поддерживает до 30 изображений, 10 видео, 10 аудио и 30 ассетов; Seedance 2.0, 2.0 Fast и 2.0 Mini — до 9 изображений, 3 видео, 3 аудио и 9 ассетов. + +| Параметр | Описание | Тип данных | Обязательный | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `reference_images` | Расширяемый слот: подключите от 1 до N референсных изображений, управляющих выходным результатом. Ограничение по количеству зависит от модели (см. разделы моделей). Изображения проверяются на соответствие соотношению сторон (0,4–2,5) и автоматически уменьшаются до максимальной стороны 6000 пикселей. | IMAGE | Нет | 1..9 слотов (семейство Seedance 2.0)
1..30 слотов (Seedance 2.5) | +| `reference_videos` | Расширяемый слот: подключите от 1 до N референсных видео. Ограничение по количеству зависит от модели (см. разделы моделей). Каждое видео должно быть не короче 1,8 секунды и соответствовать пиксельным ограничениям для выбранной модели и разрешения. | VIDEO | Нет | 1..3 слота (семейство Seedance 2.0)
1..10 слотов (Seedance 2.5) | +| `reference_audios` | Расширяемый слот: подключите от 1 до N референсных аудиодорожек. Ограничение по количеству зависит от модели (см. разделы моделей). Каждая аудиодорожка должна быть не короче 1,8 секунды. | AUDIO | Нет | 1..3 слота (семейство Seedance 2.0)
1..10 слотов (Seedance 2.5) | +| `reference_assets` | Расширяемый слот: подключите от 1 до N строк с идентификаторами ассетов для медиафайлов, уже загруженных в виртуальную библиотеку Seedance. Каждый ассет должен иметь статус Active. Вы можете ссылаться на ассет в запросе с помощью токенов, например `asset1` или `asset 1`; узел заменяет их позиционной меткой ассета (например, «Image 2» или «Video 1»). | STRING | Нет | 1..9 слотов (семейство Seedance 2.0)
1..30 слотов (Seedance 2.5) | +| `auto_downscale` | Автоматически уменьшать референсные видео, превышающие лимит по пикселям модели для выбранного разрешения. Соотношение сторон сохраняется; видео, уже укладывающиеся в лимиты, не изменяются. По умолчанию: True. | BOOLEAN | Нет | true
false | +| `auto_upscale` | Автоматически увеличивать референсные видео, которые не достигают минимального количества пикселей, требуемого моделью для выбранного разрешения. Соотношение сторон сохраняется; видео, уже соответствующие минимуму, не изменяются. Примечание: увеличение источника с низким разрешением не добавляет реальных деталей и может привести к генерации более низкого качества. По умолчанию: False. Дополнительная настройка. | BOOLEAN | Нет | true
false | + +**Примечание:** Для работы узла требуется хотя бы одно референсное изображение, видео или ассет (Seedance 2.5 также принимает только аудиореференсы). Референсные видео и аудиодорожки должны иметь длительность не менее 1,8 секунды каждая, а суммарная длительность всех референсных видео (и отдельно — всех референсных аудио) не должна превышать максимальное суммарное количество секунд для выбранной модели. Референсные изображения должны иметь соотношение сторон примерно от 2:5 до 5:2 (0,4–2,5), быть не менее 300×300 пикселей и автоматически уменьшаться до максимальной стороны 6000 пикселей. Варианты `task_type` «edit» и «extend» доступны только с Seedance 2.5, и оба требуют хотя бы одного референсного видео; при использовании «edit» выход сохраняет собственную длительность и соотношение сторон исходного клипа, а виджеты `duration` и `ratio` игнорируются; при использовании «extend» выход содержит только вновь созданный сегмент заданной вами длительности. Используемые ассеты должны иметь статус Active, иначе задача завершится ошибкой. + +## Выходы + +| Имя выхода | Описание | Тип данных | +|-------------|-------------|-----------| +| `video` | Сгенерированное видео, которое скачивается от провайдера после завершения задачи генерации. Содержит аудио, если включена генерация аудио. | VIDEO | + +> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/ru.md) + +--- +**Source fingerprint (SHA-256):** `3a6bba12e719204ba5dba9d7d5f2b4c5285ed68974ee015b6e4a7892a1cf0933` diff --git a/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/tr.md b/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/tr.md new file mode 100644 index 000000000..9a60d9614 --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/tr.md @@ -0,0 +1,77 @@ +# ByteDance2ReferenceNodeV2 + +ByteDance Seedance 2.5 Reference to Video, ByteDance Seedance modellerini (Seedance 2.5, 2.0, 2.0 Fast ve 2.0 Mini) kullanarak, bir metin istemi ve isteğe bağlı referans görseller, videolar, sesler veya daha önce yüklenmiş kütüphane varlıkları rehberliğinde videolar üretir, düzenler veya genişletir. Referansları yükler, bir üretim görevi gönderir, tamamlanmasını bekler ve tamamlanmış video dosyasını döndürür. + +## Girdiler + +### Ortak Girdiler + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +|-----------|-------------|-----------|----------|-------| +| `model` | Model seçici. En yeni model için Seedance 2.5, 30 saniyeye kadar videolar ve mp4/mov çıktısı; maksimum kalite ve 4k için Seedance 2.0; hız optimizasyonu için Fast; en hızlı, en düşük maliyetli üretim için Mini. Bir model seçmek, aşağıda gösterilen girdi widget'larını değiştirir. | DYNAMIC_COMBO | Evet | "Seedance 2.5"
"Seedance 2.0"
"Seedance 2.0 Fast"
"Seedance 2.0 Mini" | +| `seed` | Seed, düğümün yeniden çalıştırılıp çalıştırılmayacağını kontrol eder; sonuçlar seed'den bağımsız olarak deterministik değildir. Varsayılan: 0. | INT | Evet | 0-2147483647 | +| `watermark` | Videoya filigran eklenip eklenmeyeceği. Varsayılan: False. Gelişmiş ayar. | BOOLEAN | Evet | true
false | + +### Seedance 2.5 Girdileri + +Bu girdiler, `model` "Seedance 2.5" olarak ayarlandığında görünür. + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +|-----------|-------------|-----------|----------|-------| +| `prompt` | Video üretimi için metin istemi. Konuşma satırlarını, oluşturulan diyaloğu yönlendirmek için çift tırnak içine alın. Varsayılan: boş dize. | STRING | Evet | Çok satırlı metin | +| `resolution` | Çıktı videosunun çözünürlüğü. Varsayılan: 720p. | COMBO | Evet | "480p"
"720p"
"1080p" | +| `ratio` | Çıktı videosunun en-boy oranı. Varsayılan: 16:9. | COMBO | Evet | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | Çıktı videosunun saniye cinsinden süresi (4-30). Varsayılan: 5. | INT | Evet | 4-30 | +| `generate_audio` | Çıktı videosu için ses üretimini etkinleştirir. Varsayılan: True. | BOOLEAN | Evet | true
false | +| `task_type` | Referans medyayla ne yapılacağı. auto dışındaki her değer, görev gönderildiğinde doğrulanır; bu nedenle uyumsuz ayarlar, üretim başlamadan önce başarısız olur.
auto: model görevi istemden ve girdilerden çıkarır; modelin yorumuyla çelişen ayarlar yalnızca üretim başladıktan sonra başarısız olur.
reference: referans görseller, videolar ve seslerle yönlendirilen yeni bir video üretir.
edit: bağlı bir referans videoyu değiştirir (ekle, kaldır, değiştir); çıktı, kaynak klibin kendi uzunluğunu ve en-boy oranını korur ve `duration` ile `ratio` widget'ları dikkate alınmaz.
extend: bağlı bir referans videoyu ileri veya geri doğru genişletir; istem "extend forward", "extend backward" veya "continue" demelidir, en-boy oranı kaynak klibe uyar ve çıktı, kaynak klibi değil, yalnızca ayarladığınız süre uzunluğundaki yeni oluşturulan bölümü içerir. Varsayılan: auto. | COMBO | Evet | "auto"
"reference"
"edit"
"extend" | +| `output_format` | Çıktı videosunun kapsayıcı formatı. Varsayılan: mp4. | COMBO | Evet | "mp4" | + +### Seedance 2.0 Girdileri + +Bu girdiler, `model` "Seedance 2.0" olarak ayarlandığında görünür. + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +|-----------|-------------|-----------|----------|-------| +| `prompt` | Video üretimi için metin istemi. Varsayılan: boş dize. | STRING | Evet | Çok satırlı metin | +| `resolution` | Çıktı videosunun çözünürlüğü. | COMBO | Evet | "480p"
"720p"
"1080p"
"4k" | +| `ratio` | Çıktı videosunun en-boy oranı. Varsayılan: adaptive. | COMBO | Evet | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | Çıktı videosunun saniye cinsinden süresi (4-15). Varsayılan: 7. | INT | Evet | 4-15 | +| `generate_audio` | Çıktı videosu için ses üretimini etkinleştirir. Varsayılan: True. | BOOLEAN | Evet | true
false | + +### Seedance 2.0 Fast ve Seedance 2.0 Mini Girdileri + +Bu girdiler, `model` "Seedance 2.0 Fast" veya "Seedance 2.0 Mini" olarak ayarlandığında görünür. Her iki model de aynı girdi kümesini paylaşır. + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +|-----------|-------------|-----------|----------|-------| +| `prompt` | Video üretimi için metin istemi. Varsayılan: boş dize. | STRING | Evet | Çok satırlı metin | +| `resolution` | Çıktı videosunun çözünürlüğü. | COMBO | Evet | "480p"
"720p" | +| `ratio` | Çıktı videosunun en-boy oranı. Varsayılan: adaptive. | COMBO | Evet | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | Çıktı videosunun saniye cinsinden süresi (4-15). Varsayılan: 7. | INT | Evet | 4-15 | +| `generate_audio` | Çıktı videosu için ses üretimini etkinleştirir. Varsayılan: True. | BOOLEAN | Evet | true
false | + +### Referans Girdileri + +Bu genişletilebilir referans yuvaları tüm modeller için kullanılabilir. Maksimum yuva sayısı modele göre değişir: Seedance 2.5, 30 görsele, 10 videoya, 10 sese ve 30 varlığa kadar; Seedance 2.0, 2.0 Fast ve 2.0 Mini ise 9 görsele, 3 videoya, 3 sese ve 9 varlığa kadar destekler. + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +|-----------|-------------|-----------|----------|-------| +| `reference_images` | Genişletilebilir yuva: çıktıya yön veren 1..N referans görseli bağlayın. Sayı sınırı modele göredir (model bölümlerine bakın). Görseller en-boy oranı (0,4 ile 2,5) açısından doğrulanır ve maksimum kenarı 6000 piksele otomatik olarak küçültülür. | IMAGE | Hayır | 1..9 yuva (Seedance 2.0 ailesi)
1..30 yuva (Seedance 2.5) | +| `reference_videos` | Genişletilebilir yuva: 1..N referans video bağlayın. Sayı sınırı modele göredir (model bölümlerine bakın). Her video en az 1,8 saniye uzunluğunda olmalı ve seçilen model ile çözünürlüğün piksel sınırlarına uymalıdır. | VIDEO | Hayır | 1..3 yuva (Seedance 2.0 ailesi)
1..10 yuva (Seedance 2.5) | +| `reference_audios` | Genişletilebilir yuva: 1..N referans ses parçası bağlayın. Sayı sınırı modele göredir (model bölümlerine bakın). Her ses en az 1,8 saniye uzunluğunda olmalıdır. | AUDIO | Hayır | 1..3 yuva (Seedance 2.0 ailesi)
1..10 yuva (Seedance 2.5) | +| `reference_assets` | Genişletilebilir yuva: Seedance sanal kütüphanesine zaten yüklenmiş medya için 1..N varlık kimliği dizesi bağlayın. Her varlık Etkin olmalıdır. İstemde bir varlığa `asset1` veya `asset 1` gibi belirteçlerle başvurabilirsiniz; düğüm bunları varlığın konum etiketiyle (örneğin "Image 2" veya "Video 1") değiştirir. | STRING | Hayır | 1..9 yuva (Seedance 2.0 ailesi)
1..30 yuva (Seedance 2.5) | +| `auto_downscale` | Seçilen çözünürlük için modelin piksel bütçesini aşan referans videoları otomatik olarak küçültür. En-boy oranı korunur; sınırlar içindeki videolara dokunulmaz. Varsayılan: True. | BOOLEAN | Hayır | true
false | +| `auto_upscale` | Seçilen çözünürlük için modelin minimum piksel sayısının altındaki referans videoları otomatik olarak büyütür. En-boy oranı korunur; minimumu zaten karşılayan videolara dokunulmaz. Not: Düşük çözünürlüklü bir kaynağı büyütmek gerçek ayrıntı eklemez ve daha düşük kaliteli sonuçlar üretebilir. Varsayılan: False. Gelişmiş ayar. | BOOLEAN | Hayır | true
false | + +**Not:** Düğümü çalıştırmak için en az bir referans görsel, video veya varlık gerekir (Seedance 2.5, yalnızca sesten oluşan referansları da kabul eder). Referans videoların ve seslerin her biri en az 1,8 saniye uzunluğunda olmalıdır ve tüm referans videolarının (ayrıca tüm referans seslerinin) birleşik süresi, seçilen modelin maksimum toplam saniyesini aşmamalıdır. Referans görsellerin en-boy oranı yaklaşık 2:5 ile 5:2 (0,4 ile 2,5) arasında olmalı, en az 300x300 piksel olmalı ve maksimum kenarı 6000 piksele otomatik olarak küçültülmelidir. `task_type` için "edit" ve "extend" seçenekleri yalnızca Seedance 2.5 ile kullanılabilir ve her ikisi de en az bir referans video gerektirir; "edit" kullanıldığında çıktı, kaynak klibin kendi uzunluğunu ve en-boy oranını korur ve `duration` ile `ratio` widget'ları dikkate alınmaz; "extend" kullanıldığında çıktı, ayarladığınız süre uzunluğundaki yeni oluşturulan bölümü içerir. Referans verilen varlıklar Etkin durumda olmalıdır, aksi takdirde görev başarısız olur. + +## Çıktılar + +| Çıktı Adı | Açıklama | Veri Türü | +|-------------|-------------|-----------| +| `video` | Üretilen video; üretim görevi tamamlandığında sağlayıcıdan indirilir. Ses üretimi etkinleştirildiğinde ses içerir. | VIDEO | + +> Bu belge yapay zeka tarafından oluşturulmuştur. Herhangi bir hata bulursanız veya iyileştirme önerileriniz varsa, katkıda bulunmaktan çekinmeyin! [GitHub'da Düzenle](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/tr.md) + +--- +**Source fingerprint (SHA-256):** `3a6bba12e719204ba5dba9d7d5f2b4c5285ed68974ee015b6e4a7892a1cf0933` diff --git a/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/zh-TW.md b/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/zh-TW.md new file mode 100644 index 000000000..89099bebb --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/zh-TW.md @@ -0,0 +1,77 @@ +# ByteDance2ReferenceNodeV2 + +ByteDance Seedance 2.5 Reference to Video 使用 ByteDance Seedance 模型(Seedance 2.5、2.0、2.0 Fast 與 2.0 Mini),根據文字提示以及可選的參考圖片、影片、音訊或先前上傳的素材庫資產,來生成、編輯或延伸影片。此節點會上傳參考內容、提交生成任務、等待完成,然後回傳最終的影片檔案。 + +## 輸入 + +### 通用輸入 + +| 參數 | 說明 | 資料類型 | 必要 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `model` | 模型選擇器。Seedance 2.5 為最新模型,影片最長 30 秒,輸出 mp4/mov;Seedance 2.0 提供最高品質與 4k;Fast 為速度最佳化;Mini 為最快且成本最低的生成。選擇模型會改變下方顯示的輸入元件。 | DYNAMIC_COMBO | 是 | "Seedance 2.5"
"Seedance 2.0"
"Seedance 2.0 Fast"
"Seedance 2.0 Mini" | +| `seed` | 種子控制節點是否應重新執行;無論種子為何,結果皆非確定性。預設值:0。 | INT | 是 | 0 至 2147483647 | +| `watermark` | 是否在影片中加入浮水印。預設值:False。進階設定。 | BOOLEAN | 是 | true
false | + +### Seedance 2.5 輸入 + +當 `model` 設定為「Seedance 2.5」時,會顯示這些輸入。 + +| 參數 | 說明 | 資料類型 | 必要 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `prompt` | 用於影片生成的文字提示。若要引導生成的對話,請將口語台詞放在雙引號中。預設值:空字串。 | STRING | 是 | 多行文字 | +| `resolution` | 輸出影片的解析度。預設值:720p。 | COMBO | 是 | "480p"
"720p"
"1080p" | +| `ratio` | 輸出影片的畫面比例。預設值:16:9。 | COMBO | 是 | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | 輸出影片的持續時間(秒)(4-30)。預設值:5。 | INT | 是 | 4 至 30 | +| `generate_audio` | 是否為輸出影片啟用音訊生成。預設值:True。 | BOOLEAN | 是 | true
false | +| `task_type` | 對參考媒體進行什麼操作。除了 auto 以外的每個值都會在提交任務時驗證,因此不匹配的設定會在生成開始前失敗。
auto:模型會從提示與輸入推斷任務,與其解讀衝突的設定只會在生成開始後才失敗。
reference:依據參考圖片、影片與音訊生成新的影片。
edit:變更已連接的參考影片(新增、移除、替換);輸出會保留來源剪輯本身的長度與畫面比例,且 duration 與 ratio 元件會被忽略。
extend:向前或向後延伸已連接的參考影片;提示中應包含「extend forward」、「extend backward」或「continue」,畫面比例會跟隨來源剪輯,而輸出僅包含你設定的持續時間內新生成的片段,不包含來源剪輯。預設值:auto。 | COMBO | 是 | "auto"
"reference"
"edit"
"extend" | +| `output_format` | 輸出影片的容器格式。預設值:mp4。 | COMBO | 是 | "mp4" | + +### Seedance 2.0 輸入 + +當 `model` 設定為「Seedance 2.0」時,會顯示這些輸入。 + +| 參數 | 說明 | 資料類型 | 必要 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `prompt` | 用於影片生成的文字提示。預設值:空字串。 | STRING | 是 | 多行文字 | +| `resolution` | 輸出影片的解析度。 | COMBO | 是 | "480p"
"720p"
"1080p"
"4k" | +| `ratio` | 輸出影片的畫面比例。預設值:adaptive。 | COMBO | 是 | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | 輸出影片的持續時間(秒)(4-15)。預設值:7。 | INT | 是 | 4 至 15 | +| `generate_audio` | 是否為輸出影片啟用音訊生成。預設值:True。 | BOOLEAN | 是 | true
false | + +### Seedance 2.0 Fast 與 Seedance 2.0 Mini 輸入 + +當 `model` 設定為「Seedance 2.0 Fast」或「Seedance 2.0 Mini」時,會顯示這些輸入。兩個模型共用相同的輸入集合。 + +| 參數 | 說明 | 資料類型 | 必要 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `prompt` | 用於影片生成的文字提示。預設值:空字串。 | STRING | 是 | 多行文字 | +| `resolution` | 輸出影片的解析度。 | COMBO | 是 | "480p"
"720p" | +| `ratio` | 輸出影片的畫面比例。預設值:adaptive。 | COMBO | 是 | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | 輸出影片的持續時間(秒)(4-15)。預設值:7。 | INT | 是 | 4 至 15 | +| `generate_audio` | 是否為輸出影片啟用音訊生成。預設值:True。 | BOOLEAN | 是 | true
false | + +### 參考輸入 + +這些可擴充的參考插槽適用於所有模型。插槽數量上限依模型而異:Seedance 2.5 支援最多 30 張圖片、10 部影片、10 段音訊與 30 個資產;Seedance 2.0、2.0 Fast 與 2.0 Mini 則支援最多 9 張圖片、3 部影片、3 段音訊與 9 個資產。 + +| 參數 | 說明 | 資料類型 | 必要 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `reference_images` | 可擴充插槽:連接 1..N 個參考圖片以引導輸出。數量限制依模型而定(參見各模型小節)。圖片會驗證畫面比例(0.4 至 2.5),並自動縮小至最長邊 6000 像素。 | IMAGE | 否 | 1..9 個插槽(Seedance 2.0 系列)
1..30 個插槽(Seedance 2.5) | +| `reference_videos` | 可擴充插槽:連接 1..N 個參考影片。數量限制依模型而定(參見各模型小節)。每部影片長度至少須為 1.8 秒,且必須符合所選模型與解析度的像素限制。 | VIDEO | 否 | 1..3 個插槽(Seedance 2.0 系列)
1..10 個插槽(Seedance 2.5) | +| `reference_audios` | 可擴充插槽:連接 1..N 條參考音訊。數量限制依模型而定(參見各模型小節)。每段音訊長度至少須為 1.8 秒。 | AUDIO | 否 | 1..3 個插槽(Seedance 2.0 系列)
1..10 個插槽(Seedance 2.5) | +| `reference_assets` | 可擴充插槽:連接 1..N 個資產 ID 字串,對應已上傳至 Seedance 虛擬素材庫的媒體。每個資產必須為 Active 狀態。你可以在提示中以 `asset1` 或 `asset 1` 這類代號引用資產;節點會將這些代號替換為資產的位置標籤(例如「Image 2」或「Video 1」)。 | STRING | 否 | 1..9 個插槽(Seedance 2.0 系列)
1..30 個插槽(Seedance 2.5) | +| `auto_downscale` | 自動縮小超出所選解析度像素預算的參考影片。會保留畫面比例;已在限制內的影片則不受影響。預設值:True。 | BOOLEAN | 否 | true
false | +| `auto_upscale` | 自動放大低於所選解析度最小像素數的參考影片。會保留畫面比例;已符合最小像素數的影片則不受影響。注意:放大低解析度來源不會增加真實細節,且可能產生較低品質的生成結果。預設值:False。進階設定。 | BOOLEAN | 否 | true
false | + +**注意:** 至少需要一個參考圖片、影片或資產才能執行此節點(Seedance 2.5 也接受僅含音訊的參考)。參考影片與音訊的長度都必須至少為 1.8 秒,且所有參考影片(以及所有參考音訊,分別計算)的總持續時間不得超過所選模型的最大總秒數。參考圖片的畫面比例必須約在 2:5 至 5:2(0.4 至 2.5)之間,至少為 300x300 像素,並會自動縮小至最長邊 6000 像素。`task_type` 的「edit」與「extend」選項僅適用於 Seedance 2.5,且兩者都至少需要一部參考影片;使用「edit」時,輸出會保留來源剪輯本身的長度與畫面比例,且 `duration` 與 `ratio` 元件會被忽略;使用「extend」時,輸出僅包含你設定的持續時間內新生成的片段。引用的資產必須處於 Active 狀態,否則任務會失敗。 + +## 輸出 + +| 輸出名稱 | 說明 | 資料類型 | +|-------------|-------------|-----------| +| `video` | 生成的影片,會在生成任務完成後從提供者下載。若已啟用音訊生成,則包含音訊。 | VIDEO | + +> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/zh-TW.md) + +--- +**Source fingerprint (SHA-256):** `3a6bba12e719204ba5dba9d7d5f2b4c5285ed68974ee015b6e4a7892a1cf0933` diff --git a/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/zh.md b/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/zh.md new file mode 100644 index 000000000..c1cc42f21 --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/zh.md @@ -0,0 +1,77 @@ +# ByteDance2ReferenceNodeV2 + +ByteDance Seedance 2.5 Reference to Video 节点利用 ByteDance Seedance 模型(Seedance 2.5、2.0、2.0 Fast 和 2.0 Mini)来生成、编辑或扩展视频,通过文本提示以及可选的参考图像、视频、音频或先前上传的库资源进行引导。它会上传参考内容,提交生成任务,等待完成,然后返回最终视频文件。 + +## 输入 + +### 通用输入 + +| 参数 | 描述 | 数据类型 | 必需 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `model` | 模型选择器。选择 Seedance 2.5 可使用最新模型,视频最长 30 秒且输出 mp4/mov;Seedance 2.0 用于最高质量和 4k;Fast 用于速度优化;Mini 用于最快、最低成本的生成。选择模型会更改下方显示的输入控件。 | DYNAMIC_COMBO | 是 | "Seedance 2.5"
"Seedance 2.0"
"Seedance 2.0 Fast"
"Seedance 2.0 Mini" | +| `seed` | 种子控制节点是否应重新运行;无论种子如何,结果都是非确定性的。默认值:0。 | INT | 是 | 0 to 2147483647 | +| `watermark` | 是否在视频中添加水印。默认值:False。高级设置。 | BOOLEAN | 是 | true
false | + +### Seedance 2.5 输入 + +这些输入在 `model` 设置为 "Seedance 2.5" 时显示。 + +| 参数 | 描述 | 数据类型 | 必需 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `prompt` | 用于视频生成的文本提示。将口语台词放在双引号中,以引导生成的对话。默认值:空字符串。 | STRING | 是 | Multiline text | +| `resolution` | 输出视频的分辨率。默认值:720p。 | COMBO | 是 | "480p"
"720p"
"1080p" | +| `ratio` | 输出视频的宽高比。默认值:16:9。 | COMBO | 是 | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | 输出视频的持续时间(秒)(4-30)。默认值:5。 | INT | 是 | 4 to 30 | +| `generate_audio` | 为输出视频启用音频生成。默认值:True。 | BOOLEAN | 是 | true
false | +| `task_type` | 如何处理参考媒体。除 auto 以外的每个值都会在提交任务时进行验证,因此不匹配的设置会在生成开始前失败。
auto:模型根据提示和输入推断任务,与其推断相冲突的设置仅在生成开始后失败。
reference:根据参考图像、视频和音频生成新视频。
edit:更改已连接的参考视频(添加、删除、替换);输出保持源剪辑自身的长度和宽高比,`duration` 和 `ratio` 控件会被忽略。
extend:向前或向后延续已连接的参考视频;提示应包含 "extend forward"、"extend backward" 或 "continue",宽高比遵循源剪辑,输出仅包含您设置的持续时间内新生成的片段,而不包含源剪辑。默认值:auto。 | COMBO | 是 | "auto"
"reference"
"edit"
"extend" | +| `output_format` | 输出视频的容器格式。默认值:mp4。 | COMBO | 是 | "mp4" | + +### Seedance 2.0 输入 + +这些输入在 `model` 设置为 "Seedance 2.0" 时显示。 + +| 参数 | 描述 | 数据类型 | 必需 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `prompt` | 用于视频生成的文本提示。默认值:空字符串。 | STRING | 是 | Multiline text | +| `resolution` | 输出视频的分辨率。 | COMBO | 是 | "480p"
"720p"
"1080p"
"4k" | +| `ratio` | 输出视频的宽高比。默认值:adaptive。 | COMBO | 是 | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | 输出视频的持续时间(秒)(4-15)。默认值:7。 | INT | 是 | 4 to 15 | +| `generate_audio` | 为输出视频启用音频生成。默认值:True。 | BOOLEAN | 是 | true
false | + +### Seedance 2.0 Fast 和 Seedance 2.0 Mini 输入 + +这些输入在 `model` 设置为 "Seedance 2.0 Fast" 或 "Seedance 2.0 Mini" 时显示。两个模型共享相同的输入集。 + +| 参数 | 描述 | 数据类型 | 必需 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `prompt` | 用于视频生成的文本提示。默认值:空字符串。 | STRING | 是 | Multiline text | +| `resolution` | 输出视频的分辨率。 | COMBO | 是 | "480p"
"720p" | +| `ratio` | 输出视频的宽高比。默认值:adaptive。 | COMBO | 是 | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | +| `duration` | 输出视频的持续时间(秒)(4-15)。默认值:7。 | INT | 是 | 4 to 15 | +| `generate_audio` | 为输出视频启用音频生成。默认值:True。 | BOOLEAN | 是 | true
false | + +### 参考输入 + +以下可扩展的参考槽位适用于所有模型。最大槽位数因模型而异:Seedance 2.5 最多支持 30 个图像、10 个视频、10 个音频和 30 个资源;Seedance 2.0、2.0 Fast 和 2.0 Mini 最多支持 9 个图像、3 个视频、3 个音频和 9 个资源。 + +| 参数 | 描述 | 数据类型 | 必需 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `reference_images` | 可扩展槽位:连接 1..N 个参考图像以引导输出。数量限制因模型而异(参见各模型部分)。图像会针对宽高比(0.4 至 2.5)进行验证,并自动缩小至最大边长为 6000 像素。 | IMAGE | 否 | 1..9 个槽位(Seedance 2.0 系列)
1..30 个槽位(Seedance 2.5) | +| `reference_videos` | 可扩展槽位:连接 1..N 个参考视频。数量限制因模型而异(参见各模型部分)。每个视频必须至少 1.8 秒长,并且必须符合所选模型和分辨率的像素限制。 | VIDEO | 否 | 1..3 个槽位(Seedance 2.0 系列)
1..10 个槽位(Seedance 2.5) | +| `reference_audios` | 可扩展槽位:连接 1..N 个参考音轨。数量限制因模型而异(参见各模型部分)。每个音频必须至少 1.8 秒长。 | AUDIO | 否 | 1..3 个槽位(Seedance 2.0 系列)
1..10 个槽位(Seedance 2.5) | +| `reference_assets` | 可扩展槽位:连接 1..N 个资源 ID 字符串,用于已上传到 Seedance 虚拟库的媒体。每个资源必须处于 Active 状态。您可以在提示中使用 `asset1` 或 `asset 1` 等令牌引用资源;节点会将其替换为资产的位置标签(例如 "Image 2" 或 "Video 1")。 | STRING | 否 | 1..9 个槽位(Seedance 2.0 系列)
1..30 个槽位(Seedance 2.5) | +| `auto_downscale` | 自动将超出所选分辨率下模型像素预算的参考视频缩小。保持宽高比;已处于限制内的视频保持不变。默认值:True。 | BOOLEAN | 否 | true
false | +| `auto_upscale` | 自动将低于所选分辨率下模型最小像素数的参考视频放大。保持宽高比;已满足最小值的视频保持不变。注意:放大低分辨率源不会增加真实细节,并可能产生较低质量的生成结果。默认值:False。高级设置。 | BOOLEAN | 否 | true
false | + +**注意:** 运行节点至少需要一个参考图像、视频或资源(Seedance 2.5 还接受仅音频参考)。参考视频和音频必须各至少 1.8 秒长,且所有参考视频的总时长(以及所有参考音频的总时长,分别计算)不得超过所选模型的最大总秒数。参考图像的宽高比必须介于约 2:5 和 5:2(0.4 至 2.5)之间,至少为 300x300 像素,并会自动缩小至最大边长为 6000 像素。`task_type` 的 "edit" 和 "extend" 选项仅在 Seedance 2.5 下可用,且两者都至少需要一个参考视频;使用 "edit" 时,输出保持源剪辑自身的长度和宽高比,`duration` 和 `ratio` 控件会被忽略;使用 "extend" 时,输出仅包含您设置的持续时间内新生成的片段。引用的资产必须处于 Active 状态,否则任务失败。 + +## 输出 + +| 输出名称 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `video` | 生成的视频,在生成任务完成后从提供方下载。启用音频生成时包含音频。 | VIDEO | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/zh.md) + +--- +**Source fingerprint (SHA-256):** `3a6bba12e719204ba5dba9d7d5f2b4c5285ed68974ee015b6e4a7892a1cf0933` diff --git a/comfyui_embedded_docs/docs/ByteDance2TextToVideoNode/en.md b/comfyui_embedded_docs/docs/ByteDance2TextToVideoNode/en.md index deb9b4d60..b38becb0c 100644 --- a/comfyui_embedded_docs/docs/ByteDance2TextToVideoNode/en.md +++ b/comfyui_embedded_docs/docs/ByteDance2TextToVideoNode/en.md @@ -1,16 +1,51 @@ -# ByteDance Seedance 2.0 Text to Video +# ByteDance Seedance 2.5 Text to Video -This node uses ByteDance's Seedance 2.0 API to generate a video from a text description. It sends your prompt to the selected model, waits for the video to be processed, and returns the final result. +This node generates a video from a text prompt using ByteDance's Seedance 2.5 or 2.0 models. It sends the prompt to the selected model, waits for the video to finish processing, and returns the resulting video file. ## Inputs +### Common Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `model` | The Seedance model to use for video generation. Seedance 2.5 is the newest model, supporting videos up to 30 seconds and mp4/mov output; Seedance 2.0 is for maximum quality and 4k; Seedance 2.0 Fast is for speed optimization; Seedance 2.0 Mini is for the fastest, lowest-cost generation. Selecting a model reveals additional inputs for the prompt, resolution, aspect ratio, duration, and audio generation. | DYNAMIC_COMBO | Yes | `"Seedance 2.5"`
`"Seedance 2.0"`
`"Seedance 2.0 Fast"`
`"Seedance 2.0 Mini"` | +| `seed` | Controls whether the node should re-run; results are non-deterministic regardless of seed. (default: 0) | INT | No | 0 to 2147483647 | +| `watermark` | Whether to add a watermark to the video. (default: False) This is an advanced setting. | BOOLEAN | No | True / False | + +### Seedance 2.5 Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `prompt` | Text prompt for video generation. Put spoken lines in double quotes to steer the generated dialogue. | STRING | Yes | — | +| `resolution` | Resolution of the output video. (default: `"720p"`) | COMBO | Yes | `"480p"`
`"720p"`
`"1080p"` | +| `ratio` | Aspect ratio of the output video. (default: `"16:9"`) | COMBO | Yes | `"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"`
`"adaptive"` | +| `duration` | Duration of the output video in seconds. (default: 5) | INT | Yes | 4 to 30 | +| `generate_audio` | Enable audio generation for the output video. (default: True) | BOOLEAN | Yes | True / False | +| `output_format` | Container format of the output video. (default: `"mp4"`) | COMBO | Yes | `"mp4"` | + +### Seedance 2.0 Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `prompt` | Text prompt for video generation. | STRING | Yes | — | +| `resolution` | Resolution of the output video. | COMBO | Yes | `"480p"`
`"720p"`
`"1080p"`
`"4k"` | +| `ratio` | Aspect ratio of the output video. (default: `"16:9"`) | COMBO | Yes | `"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"`
`"adaptive"` | +| `duration` | Duration of the output video in seconds. (default: 7) | INT | Yes | 4 to 15 | +| `generate_audio` | Enable audio generation for the output video. (default: True) | BOOLEAN | Yes | True / False | + +### Seedance 2.0 Fast and Seedance 2.0 Mini Inputs + +Shared by Seedance 2.0 Fast and Seedance 2.0 Mini; both models expose the same parameters. + | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `model` | The model to use for video generation. Selecting a model will reveal additional required inputs for the prompt, resolution, aspect ratio, duration, and audio generation. "Seedance 2.0" is for maximum quality; "Seedance 2.0 Fast" is for speed optimization. | COMBO | Yes | `"Seedance 2.0"`
`"Seedance 2.0 Fast"` | -| `seed` | A seed value (default: 0). The node will re-run if this value changes, but the results are non-deterministic regardless of the seed. | INT | No | 0 to 2147483647 | -| `watermark` | Whether to add a watermark to the video (default: False). This is an advanced setting. | BOOLEAN | No | True / False | +| `prompt` | Text prompt for video generation. | STRING | Yes | — | +| `resolution` | Resolution of the output video. | COMBO | Yes | `"480p"`
`"720p"` | +| `ratio` | Aspect ratio of the output video. (default: `"16:9"`) | COMBO | Yes | `"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"`
`"adaptive"` | +| `duration` | Duration of the output video in seconds. (default: 7) | INT | Yes | 4 to 15 | +| `generate_audio` | Enable audio generation for the output video. (default: True) | BOOLEAN | Yes | True / False | -**Note:** The `model` parameter is a dynamic combo. When you select a model, it will reveal several required sub-parameters that must be filled in, including the text prompt, resolution, aspect ratio, duration, and whether to generate audio. The prompt text must be at least 1 character long after removing whitespace. The "Seedance 2.0" model supports 480p, 720p, and 1080p resolutions, while "Seedance 2.0 Fast" supports 480p and 720p resolutions. +**Note:** The `model` selector is dynamic; the inputs shown under each model section appear when that model is selected. The prompt must be at least 1 character long after removing whitespace. Resolution and duration limits depend on the selected model: Seedance 2.5 supports 480p/720p/1080p and 4 to 30 seconds, Seedance 2.0 supports 480p/720p/1080p/4k and 4 to 15 seconds, and Seedance 2.0 Fast and Seedance 2.0 Mini support only 480p/720p and 4 to 15 seconds. The `seed` value only controls whether the node re-runs; it does not make results deterministic. ## Outputs @@ -21,4 +56,4 @@ This node uses ByteDance's Seedance 2.0 API to generate a video from a text desc > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDance2TextToVideoNode/en.md) --- -**Source fingerprint (SHA-256):** `a540b96cf204f2af751da90cbbee30be9588069794ef833ccb0218a4ff0c2af5` +**Source fingerprint (SHA-256):** `e3b11f5a538d4b9b7e49f651d3939651edfe85000e02e66a8d7700c3389c4b9c` diff --git a/comfyui_embedded_docs/docs/ByteDanceSeedNode/en.md b/comfyui_embedded_docs/docs/ByteDanceSeedNode/en.md index 672463499..4edf2a16f 100644 --- a/comfyui_embedded_docs/docs/ByteDanceSeedNode/en.md +++ b/comfyui_embedded_docs/docs/ByteDanceSeedNode/en.md @@ -1,19 +1,34 @@ -# ComfyUI Node Documentation: ByteDance Seed - -## Overview +# ByteDance Seed Generate text responses using ByteDance's Seed 2.0 models. Provide a text prompt and optionally include images or videos for multimodal context. ## Inputs +### Common Inputs + | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `prompt` | Text input to the model. | STRING | Yes | N/A | -| `model` | The Seed model used to generate the response. | COMBO | Yes | `"Seed 2.0 Pro"`
`"Seed 2.0 Lite"`
`"Seed 2.0 Mini"` | +| `model` | The Seed model used to generate the response. | DYNAMIC_COMBO | Yes | `"Seed 2.0 Pro"`
`"Seed 2.0 Lite"`
`"Seed 2.0 Mini"` | +| `prompt` | Text input to the model. (default: "") | STRING | Yes | N/A | | `seed` | Seed controls whether the node should re-run; results are non-deterministic regardless of seed. (default: 0) | INT | Yes | 0 to 2147483647 | | `system_prompt` | Foundational instructions that dictate the model's behavior. (default: "") | STRING | No | N/A | -**Note on `model` parameter:** The `model` parameter is a dynamic combo that also accepts images and videos. You can connect image and video inputs to this parameter to provide multimodal context. A maximum of 20 images and 4 videos are supported per request. +### Model Inputs (Shared by Seed 2.0 Pro, Seed 2.0 Lite, and Seed 2.0 Mini) + +All three Seed models expose the same sub-parameters when selected. + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `temperature` | Controls randomness. 0.0 is deterministic, higher values are more random. (default: 1.0) | FLOAT | Yes | 0.0 to 2.0 (step: 0.01) | + +### Reference Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `images` | Optional image(s) to use as context for the model. Up to 20 images. Growable slot: connect 1..20 items, e.g. `image_1` through `image_20`. | IMAGE | No | 0 to 20 images | +| `videos` | Optional video(s) to use as context for the model. Up to 4 videos. Growable slot: connect 1..4 items, e.g. `video_1` through `video_4`. | VIDEO | No | 0 to 4 videos | + +**Note:** The `model` parameter is a dynamic combo that exposes the reference and temperature sub-parameters when a model is selected. You can connect image and video inputs to this parameter to provide multimodal context. A maximum of 20 images and 4 videos are supported per request, and `prompt` is required and must contain at least one non-whitespace character. ## Outputs @@ -24,4 +39,4 @@ Generate text responses using ByteDance's Seed 2.0 models. Provide a text prompt > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceSeedNode/en.md) --- -**Source fingerprint (SHA-256):** `676c53f00c5368e145a1241f376d2c1624a11e4c06f691c3416ae5e2e46d5c71` +**Source fingerprint (SHA-256):** `23c9b0e9983a65ce859e2e92acfe71604297f16d711fa094a6617a9915a46020` diff --git a/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/en.md b/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/en.md index aea193897..a7153a9d7 100644 --- a/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/en.md +++ b/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/en.md @@ -1,4 +1,4 @@ -# ByteDanceSeedreamLayerSeparationNode +# ByteDance Seedream 5.0 Pro Layer Separation ByteDance Seedream 5.0 Pro Layer Separation decomposes an image into a background plate plus up to 16 transparent layers, each with its own stacking order, bounding box, name, and description. It returns the background, per-layer images with masks, placement boxes, and a ready-to-edit layer stack. @@ -8,13 +8,13 @@ ByteDance Seedream 5.0 Pro Layer Separation decomposes an image into a backgroun |-----------|-------------|-----------|----------|-------| | `image` | The image to separate. Exactly one image, at least 512x512 pixels, aspect ratio between 1:16 and 16:1. Inputs larger than about 4MP are downscaled before upload. | IMAGE | Yes | Single image | | `prompt` | How to separate the image. Leave empty to auto-detect and separate all major elements. Describe elements in natural language to control the separation, or target exact regions with `left top right bottom` tags (0-1000 per-mille coordinates). Default: empty string. | STRING | Yes | Multiline text | -| `size` | Output resolution level. "auto" follows the input image size (clamped to the 1K-2K range). Default: "auto". | STRING | Yes | "auto"
"1K"
"1.5K"
"2K" | +| `size` | Output resolution level. "auto" follows the input image size (clamped to the 1K-2K range). Default: "auto". | COMBO | Yes | "auto"
"1K"
"1.5K"
"2K" | | `seed` | Seed to use for generation. Default: 0. | INT | Yes | 0 to 2147483647 | -| `prompt_optimization` | Prompt-optimization mode: "standard" gives higher quality, "fast" shorter generation time. Default: "standard". | STRING | No | "standard"
"fast" | +| `prompt_optimization` | Prompt-optimization mode: "standard" gives higher quality, "fast" shorter generation time. Default: "standard". | COMBO | No | "standard"
"fast" | | `watermark` | Whether to add an "AI generated" watermark to the images. Default: false. | BOOLEAN | No | false
true | | `crop_layers` | Geometry of the layers/masks batch outputs (layer_stack is unaffected and always tight). Full canvas: each layer on a base-sized canvas at its bounding-box position - recompose directly with ImageCompositeMasked. Minimal size: each layer cropped to its bounding box (padded to the largest layer for batching) - much smaller tensors; rebuild placement with Layers From Bounding Boxes using the bboxes output. Default: false (full canvas). | BOOLEAN | No | false (full canvas)
true (minimal size) | -Note: The input image must be a single image; batches are not supported. The image must be at least 512x512 pixels with an aspect ratio between 1:16 and 16:1. +Note: The input `image` must be a single image; batches are not supported. The image must be at least 512x512 pixels with an aspect ratio between 1:16 and 16:1. ## Outputs @@ -30,4 +30,4 @@ Note: The input image must be a single image; batches are not supported. The ima > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/en.md) --- -**Source fingerprint (SHA-256):** `059d0a1a5f5793aadda72f50b549b8b10e2ecae3ce003f82c0c28191c3460954` +**Source fingerprint (SHA-256):** `5062760f2930333f8ed7d8b09dff2492c23fdf906ef71b111348687bef572821` diff --git a/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/es.md b/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/es.md index f35d18ceb..f70a74389 100644 --- a/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/es.md +++ b/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/es.md @@ -6,13 +6,13 @@ ByteDance Seedream 5.0 Pro Layer Separation descompone una imagen en una capa de | Parámetro | Descripción | Tipo de dato | Obligatorio | Rango | |-----------|-------------|--------------|-------------|-------| -| `image` | La imagen a separar. Exactamente una sola imagen, de al menos 512x512 píxeles, con una relación de aspecto entre 1:16 y 16:1. Las imágenes de entrada de más de aproximadamente 4 MP se reducen de escala antes de subirse. | IMAGE | Sí | Imagen única | +| `imagen` | La imagen a separar. Exactamente una sola imagen, de al menos 512x512 píxeles, con una relación de aspecto entre 1:16 y 16:1. Las imágenes de entrada de más de aproximadamente 4 MP se reducen de escala antes de subirse. | IMAGE | Sí | Imagen única | | `prompt` | Cómo separar la imagen. Déjelo vacío para detectar automáticamente y separar todos los elementos principales. Describa los elementos en lenguaje natural para controlar la separación, o apunte a regiones exactas con las etiquetas `left top right bottom` (coordenadas por mil de 0 a 1000). Predeterminado: cadena vacía. | STRING | Sí | Texto multilínea | -| `size` | Nivel de resolución de salida. «auto» sigue el tamaño de la imagen de entrada (limitado al rango de 1K a 2K). Predeterminado: «auto». | STRING | Sí | "auto"
"1K"
"1.5K"
"2K" | -| `seed` | Semilla que se utilizará para la generación. Predeterminado: 0. | INT | Sí | 0 a 2147483647 | -| `prompt_optimization` | Modo de optimización del prompt: «standard» ofrece mayor calidad, «fast» un tiempo de generación más corto. Predeterminado: «standard». | STRING | No | "standard"
"fast" | -| `watermark` | Indica si se debe añadir una marca de agua «generado por IA» a las imágenes. Predeterminado: false. | BOOLEAN | No | false
true | -| `crop_layers` | Geometría de las salidas por lotes de capas/máscaras (layer_stack no se ve afectada y siempre está ajustada). Lienzo completo: cada capa se coloca en un lienzo del tamaño de la base en la posición de su cuadro delimitador; recomponga directamente con ImageCompositeMasked. Tamaño mínimo: cada capa se recorta a su cuadro delimitador (con relleno hasta la capa más grande para el procesamiento por lotes), lo que genera tensores mucho más pequeños; reconstruya la colocación con Layers From Bounding Boxes usando la salida bboxes. Predeterminado: false (lienzo completo). | BOOLEAN | No | false (lienzo completo)
true (tamaño mínimo) | +| `tamaño` | Nivel de resolución de salida. «auto» sigue el tamaño de la imagen de entrada (limitado al rango de 1K a 2K). Predeterminado: «auto». | STRING | Sí | "auto"
"1K"
"1.5K"
"2K" | +| `semilla` | Semilla que se utilizará para la generación. Predeterminado: 0. | INT | Sí | 0 a 2147483647 | +| `optimización_prompt` | Modo de optimización del prompt: «standard» ofrece mayor calidad, «fast» un tiempo de generación más corto. Predeterminado: «standard». | STRING | No | "standard"
"fast" | +| `marca_de_agua` | Indica si se debe añadir una marca de agua «generado por IA» a las imágenes. Predeterminado: false. | BOOLEAN | No | false
true | +| `recortar_capas` | Geometría de las salidas por lotes de capas/máscaras (layer_stack no se ve afectada y siempre está ajustada). Lienzo completo: cada capa se coloca en un lienzo del tamaño de la base en la posición de su cuadro delimitador; recomponga directamente con ImageCompositeMasked. Tamaño mínimo: cada capa se recorta a su cuadro delimitador (con relleno hasta la capa más grande para el procesamiento por lotes), lo que genera tensores mucho más pequeños; reconstruya la colocación con Layers From Bounding Boxes usando la salida bboxes. Predeterminado: false (lienzo completo). | BOOLEAN | No | false (lienzo completo)
true (tamaño mínimo) | Nota: La imagen de entrada debe ser una sola imagen; no se admiten lotes. La imagen debe tener al menos 512x512 píxeles con una relación de aspecto entre 1:16 y 16:1. @@ -20,12 +20,12 @@ Nota: La imagen de entrada debe ser una sola imagen; no se admiten lotes. La ima | Nombre de salida | Descripción | Tipo de dato | |------------------|-------------|--------------| -| `base_image` | La imagen base (placa de fondo) sobre la que se apilan las capas. | IMAGE | -| `base_mask` | Transparencia de la imagen base (1 = transparente, convención de LoadImage); actualmente siempre totalmente opaca. | MASK | -| `layers` | Capas transparentes ordenadas de abajo hacia arriba. Modo de lienzo completo: colocadas en un lienzo negro del tamaño de la base en la posición de su cuadro delimitador. Modo de tamaño mínimo: recortadas a su cuadro delimitador, ancladas en la esquina superior izquierda y rellenadas hasta la capa más grande. | IMAGE | -| `masks` | Transparencia por capa, alineada por índice con el lote de capas (1 = transparente, convención de LoadImage). Para la composición estilo ImageCompositeMasked, agregue InvertMask primero. | MASK | +| `imagen_base` | La imagen base (placa de fondo) sobre la que se apilan las capas. | IMAGE | +| `máscara_base` | Transparencia de la imagen base (1 = transparente, convención de LoadImage); actualmente siempre totalmente opaca. | MASK | +| `capas` | Capas transparentes ordenadas de abajo hacia arriba. Modo de lienzo completo: colocadas en un lienzo negro del tamaño de la base en la posición de su cuadro delimitador. Modo de tamaño mínimo: recortadas a su cuadro delimitador, ancladas en la esquina superior izquierda y rellenadas hasta la capa más grande. | IMAGE | +| `máscaras` | Transparencia por capa, alineada por índice con el lote de capas (1 = transparente, convención de LoadImage). Para la composición estilo ImageCompositeMasked, agregue InvertMask primero. | MASK | | `bboxes` | Un cuadro de ubicación por capa, alineado por índice con el lote de capas (introduzca ambos, junto con las máscaras, en Layers From Bounding Boxes para reconstruir la ubicación de cada capa): `{x, y, width, height, metadata: {name, desc, z_index, native_size, content_rect, flags}}`. `content_rect = [left, top, width, height]` es la región de contenido de la capa dentro de su propio marco; se coloca en el lienzo en la posición del cuadro más ese desplazamiento. | BOUNDING_BOX | -| `layer_stack` | Documento de capas listo para editar para Create Layered Image: la placa de fondo más cada elemento como su propia capa con nombre y recorte ajustado, en su posición real y orden de apilamiento. Conéctelo directamente o amplíelo con Add Layer. | LAYERS | +| `pila_de_capas` | Documento de capas listo para editar para Create Layered Image: la placa de fondo más cada elemento como su propia capa con nombre y recorte ajustado, en su posición real y orden de apilamiento. Conéctelo directamente o amplíelo con Add Layer. | LAYERS | > Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/es.md) diff --git a/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/fa.md b/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/fa.md index c7a870dea..0422daaa4 100644 --- a/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/fa.md +++ b/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/fa.md @@ -6,13 +6,13 @@ ByteDance Seedream 5.0 Pro Layer Separation تصویری را به یک صفحه | پارامتر | توضیحات | نوع داده | الزامی | محدوده | |-----------|-------------|-----------|----------|-------| -| `image` | تصویری که باید جداسازی شود. دقیقاً یک تصویر، حداقل ۵۱۲×۵۱۲ پیکسل، با نسبت ابعاد بین ۱:۱۶ و ۱۶:۱. ورودی‌های بزرگ‌تر از حدود ۴ مگاپیکسل قبل از آپلود کوچک‌سازی می‌شوند. | IMAGE | بله | Single image | -| `prompt` | نحوه جداسازی تصویر. برای تشخیص خودکار و جداسازی همه‌ی عناصر اصلی، آن را خالی بگذارید. برای کنترل جداسازی، عناصر را به زبان طبیعی توصیف کنید، یا با تگ‌های `left top right bottom` مناطق دقیق را هدف بگیرید (مختصات ۰ تا ۱۰۰۰ در هزار). پیش‌فرض: رشته‌ی خالی. | STRING | بله | Multiline text | -| `size` | سطح وضوح خروجی. «auto» از اندازه‌ی تصویر ورودی پیروی می‌کند (به بازه‌ی ۱K تا ۲K محدود می‌شود). پیش‌فرض: «auto». | STRING | بله | "auto"
"1K"
"1.5K"
"2K" | -| `seed` | seed مورد استفاده برای تولید. پیش‌فرض: 0. | INT | بله | 0 تا 2147483647 | -| `prompt_optimization` | حالت بهینه‌سازی prompt: «standard» کیفیت بالاتری می‌دهد و «fast» زمان تولید کوتاه‌تری. پیش‌فرض: «standard». | STRING | خیر | "standard"
"fast" | -| `watermark` | آیا واترمارک «AI generated» به تصاویر اضافه شود. پیش‌فرض: false. | BOOLEAN | خیر | false
true | -| `crop_layers` | هندسه‌ی خروجی‌های دسته‌ای layers/masks (خروجی layer_stack تحت تأثیر قرار نمی‌گیرد و همیشه دقیق/بدون حاشیه‌ی اضافه است). حالت تمام‌بوم (full canvas): هر لایه روی بومی به اندازه‌ی بوم پایه، در موقعیت کادر محدودکننده‌ی خودش قرار می‌گیرد؛ می‌توانید مستقیماً با ImageCompositeMasked دوباره ترکیب کنید. حالت اندازه‌ی حداقل (minimal size): هر لایه به کادر محدودکننده‌ی خودش برش می‌خورد (برای دسته‌بندی تا بزرگ‌ترین لایه padding می‌شود)؛ تنسورها بسیار کوچک‌ترند؛ با استفاده از خروجی `bboxes` و گره Layers From Bounding Boxes جای‌گذاری را بازسازی کنید. پیش‌فرض: false (full canvas). | BOOLEAN | خیر | false (full canvas)
true (minimal size) | +| `تصویر` | تصویری که باید جداسازی شود. دقیقاً یک تصویر، حداقل ۵۱۲×۵۱۲ پیکسل، با نسبت ابعاد بین ۱:۱۶ و ۱۶:۱. ورودی‌های بزرگ‌تر از حدود ۴ مگاپیکسل قبل از آپلود کوچک‌سازی می‌شوند. | IMAGE | بله | Single image | +| `پرامپت` | نحوه جداسازی تصویر. برای تشخیص خودکار و جداسازی همه‌ی عناصر اصلی، آن را خالی بگذارید. برای کنترل جداسازی، عناصر را به زبان طبیعی توصیف کنید، یا با تگ‌های `left top right bottom` مناطق دقیق را هدف بگیرید (مختصات ۰ تا ۱۰۰۰ در هزار). پیش‌فرض: رشته‌ی خالی. | STRING | بله | Multiline text | +| `اندازه` | سطح وضوح خروجی. «auto» از اندازه‌ی تصویر ورودی پیروی می‌کند (به بازه‌ی ۱K تا ۲K محدود می‌شود). پیش‌فرض: «auto». | STRING | بله | "auto"
"1K"
"1.5K"
"2K" | +| `بذر` | seed مورد استفاده برای تولید. پیش‌فرض: 0. | INT | بله | 0 تا 2147483647 | +| `بهینه‌سازی پرامپت` | حالت بهینه‌سازی prompt: «standard» کیفیت بالاتری می‌دهد و «fast» زمان تولید کوتاه‌تری. پیش‌فرض: «standard». | STRING | خیر | "standard"
"fast" | +| `واترمارک` | آیا واترمارک «AI generated» به تصاویر اضافه شود. پیش‌فرض: false. | BOOLEAN | خیر | false
true | +| `برش لایه‌ها` | هندسه‌ی خروجی‌های دسته‌ای layers/masks (خروجی layer_stack تحت تأثیر قرار نمی‌گیرد و همیشه دقیق/بدون حاشیه‌ی اضافه است). حالت تمام‌بوم (full canvas): هر لایه روی بومی به اندازه‌ی بوم پایه، در موقعیت کادر محدودکننده‌ی خودش قرار می‌گیرد؛ می‌توانید مستقیماً با ImageCompositeMasked دوباره ترکیب کنید. حالت اندازه‌ی حداقل (minimal size): هر لایه به کادر محدودکننده‌ی خودش برش می‌خورد (برای دسته‌بندی تا بزرگ‌ترین لایه padding می‌شود)؛ تنسورها بسیار کوچک‌ترند؛ با استفاده از خروجی `bboxes` و گره Layers From Bounding Boxes جای‌گذاری را بازسازی کنید. پیش‌فرض: false (full canvas). | BOOLEAN | خیر | false (full canvas)
true (minimal size) | توجه: تصویر ورودی باید یک تصویر واحد باشد؛ حالت دسته‌ای (batch) پشتیبانی نمی‌شود. تصویر باید حداقل ۵۱۲×۵۱۲ پیکسل باشد و نسبت ابعاد آن بین ۱:۱۶ و ۱۶:۱ قرار داشته باشد. diff --git a/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/fr.md b/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/fr.md index 4cdba42ae..034e563a4 100644 --- a/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/fr.md +++ b/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/fr.md @@ -10,11 +10,11 @@ ByteDance Seedream 5.0 Pro Layer Separation décompose une image en une couche d |-----------|-------------|-----------|----------|-------| | `image` | L'image à séparer. Exactement une image, d'au moins 512x512 pixels, avec un rapport d'aspect compris entre 1:16 et 16:1. Les entrées de plus d'environ 4 mégapixels sont réduites avant l'envoi. | IMAGE | Oui | Image unique | | `prompt` | Comment séparer l'image. Laisser vide pour une détection automatique et la séparation de tous les éléments principaux. Décrivez les éléments en langage naturel pour contrôler la séparation, ou ciblez des régions précises avec les balises `left top right bottom` (coordonnées en millièmes de 0 à 1000). Par défaut : chaîne vide. | STRING | Oui | Texte multiligne | -| `size` | Niveau de résolution de sortie. « auto » suit la taille de l'image d'entrée (bornée à la plage 1K-2K). Par défaut : « auto ». | STRING | Oui | « auto »
« 1K »
« 1.5K »
« 2K » | +| `taille` | Niveau de résolution de sortie. « auto » suit la taille de l'image d'entrée (bornée à la plage 1K-2K). Par défaut : « auto ». | STRING | Oui | « auto »
« 1K »
« 1.5K »
« 2K » | | `seed` | Graine à utiliser pour la génération. Par défaut : 0. | INT | Oui | 0 à 2147483647 | -| `prompt_optimization` | Mode d'optimisation du prompt : « standard » offre une qualité supérieure, « fast » un temps de génération plus court. Par défaut : « standard ». | STRING | Non | « standard »
« fast » | -| `watermark` | Indique s'il faut ajouter un filigrane « généré par IA » aux images. Par défaut : false. | BOOLEAN | Non | false
true | -| `crop_layers` | Géométrie des sorties par lots de calques/masques (layer_stack n'est pas affecté et est toujours recadré au plus près). Toile pleine : chaque calque est placé sur une toile de taille de base à sa position de boîte englobante – recomposez directement avec ImageCompositeMasked. Taille minimale : chaque calque est recadré selon sa boîte englobante (avec un remplissage jusqu'au plus grand calque pour le traitement par lots) – des tenseurs beaucoup plus petits ; reconstruisez le placement avec Layers From Bounding Boxes en utilisant la sortie bboxes. Par défaut : false (toile pleine). | BOOLEAN | Non | false (toile pleine)
true (taille minimale) | +| `optimisation du prompt` | Mode d'optimisation du prompt : « standard » offre une qualité supérieure, « fast » un temps de génération plus court. Par défaut : « standard ». | STRING | Non | « standard »
« fast » | +| `filigrane` | Indique s'il faut ajouter un filigrane « généré par IA » aux images. Par défaut : false. | BOOLEAN | Non | false
true | +| `découper les couches` | Géométrie des sorties par lots de calques/masques (layer_stack n'est pas affecté et est toujours recadré au plus près). Toile pleine : chaque calque est placé sur une toile de taille de base à sa position de boîte englobante – recomposez directement avec ImageCompositeMasked. Taille minimale : chaque calque est recadré selon sa boîte englobante (avec un remplissage jusqu'au plus grand calque pour le traitement par lots) – des tenseurs beaucoup plus petits ; reconstruisez le placement avec Layers From Bounding Boxes en utilisant la sortie bboxes. Par défaut : false (toile pleine). | BOOLEAN | Non | false (toile pleine)
true (taille minimale) | Remarque : L'image d'entrée doit être une image unique ; les lots ne sont pas pris en charge. L'image doit faire au moins 512x512 pixels avec un rapport d'aspect compris entre 1:16 et 16:1. @@ -22,12 +22,12 @@ Remarque : L'image d'entrée doit être une image unique ; les lots ne sont pas | Nom de sortie | Description | Type de données | |-------------|-------------|-----------| -| `base_image` | L'image de base (couche de fond) sur laquelle les calques s'empilent. | IMAGE | -| `base_mask` | Transparence de l'image de base (1 = transparent, convention LoadImage) ; actuellement toujours entièrement opaque. | MASK | -| `layers` | Calques transparents ordonnés de bas en haut. Mode toile pleine : placés sur une toile noire de taille de base à leur position de boîte englobante. Mode taille minimale : recadrés selon leur boîte englobante, ancrés en haut à gauche, avec un remplissage jusqu'au plus grand calque. | IMAGE | -| `masks` | Transparence par calque, alignée sur l'index du lot de calques (1 = transparent, convention LoadImage). Pour un compositing de type ImageCompositeMasked, ajoutez d'abord InvertMask. | MASK | +| `image_de_base` | L'image de base (couche de fond) sur laquelle les calques s'empilent. | IMAGE | +| `masque_de_base` | Transparence de l'image de base (1 = transparent, convention LoadImage) ; actuellement toujours entièrement opaque. | MASK | +| `couches` | Calques transparents ordonnés de bas en haut. Mode toile pleine : placés sur une toile noire de taille de base à leur position de boîte englobante. Mode taille minimale : recadrés selon leur boîte englobante, ancrés en haut à gauche, avec un remplissage jusqu'au plus grand calque. | IMAGE | +| `masques` | Transparence par calque, alignée sur l'index du lot de calques (1 = transparent, convention LoadImage). Pour un compositing de type ImageCompositeMasked, ajoutez d'abord InvertMask. | MASK | | `bboxes` | Une boîte de placement par calque, alignée sur l'index du lot de calques (alimentez les deux, ainsi que les masques, dans Layers From Bounding Boxes pour reconstruire le placement par calque) : `{x, y, width, height, metadata: {name, desc, z_index, native_size, content_rect, flags}}`. `content_rect = [left, top, width, height]` est la région de contenu du calque dans son propre cadre ; elle se place sur la toile à la position de la boîte plus ce décalage. | BOUNDING_BOX | -| `layer_stack` | Document de calques prêt à modifier pour Create Layered Image : la couche de fond plus chaque élément en tant que calque nommé et recadré au plus près, à sa position réelle et dans son ordre d'empilement. Connectez-le directement, ou étendez-le avec Add Layer. | LAYERS | +| `pile_de_couches` | Document de calques prêt à modifier pour Create Layered Image : la couche de fond plus chaque élément en tant que calque nommé et recadré au plus près, à sa position réelle et dans son ordre d'empilement. Connectez-le directement, ou étendez-le avec Add Layer. | LAYERS | > Cette documentation a été générée par IA. Si vous trouvez des erreurs ou avez des suggestions d'amélioration, n'hésitez pas à contribuer ! [Modifier sur GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/fr.md) diff --git a/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/pt-BR.md b/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/pt-BR.md index 5481d799f..49ae869eb 100644 --- a/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/pt-BR.md +++ b/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/pt-BR.md @@ -6,13 +6,13 @@ ByteDance Seedream 5.0 Pro Layer Separation decompõe uma imagem em um plano de | Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | |-----------|-------------|-----------|----------|-------| -| `image` | A imagem a ser separada. Exatamente uma imagem, com pelo menos 512x512 pixels, proporção entre 1:16 e 16:1. Entradas maiores que cerca de 4MP são reduzidas antes do envio. | IMAGE | Sim | Imagem única | +| `imagem` | A imagem a ser separada. Exatamente uma imagem, com pelo menos 512x512 pixels, proporção entre 1:16 e 16:1. Entradas maiores que cerca de 4MP são reduzidas antes do envio. | IMAGE | Sim | Imagem única | | `prompt` | Como separar a imagem. Deixe vazio para detectar automaticamente e separar todos os elementos principais. Descreva elementos em linguagem natural para controlar a separação, ou mire regiões exatas com tags `left top right bottom` (coordenadas de 0 a 1000 por milhar). Padrão: string vazia. | STRING | Sim | Texto multilinha | -| `size` | Nível de resolução da saída. "auto" segue o tamanho da imagem de entrada (limitado ao intervalo de 1K a 2K). Padrão: "auto". | STRING | Sim | "auto"
"1K"
"1.5K"
"2K" | +| `tamanho` | Nível de resolução da saída. "auto" segue o tamanho da imagem de entrada (limitado ao intervalo de 1K a 2K). Padrão: "auto". | STRING | Sim | "auto"
"1K"
"1.5K"
"2K" | | `seed` | Semente a ser usada para a geração. Padrão: 0. | INT | Sim | 0 a 2147483647 | -| `prompt_optimization` | Modo de otimização do prompt: "standard" oferece maior qualidade, "fast" menor tempo de geração. Padrão: "standard". | STRING | Não | "standard"
"fast" | -| `watermark` | Se deve adicionar uma marca d'água "AI generated" às imagens. Padrão: false. | BOOLEAN | Não | false
true | -| `crop_layers` | Geometria das saídas em lote de camadas/máscaras (layer_stack não é afetado e está sempre com recorte exato). Canvas completo: cada camada em um canvas do tamanho da base na posição de sua caixa delimitadora — recomponha diretamente com ImageCompositeMasked. Tamanho mínimo: cada camada recortada para sua caixa delimitadora (preenchida até a maior camada para formação de lote) — tensores muito menores; reconstrua o posicionamento com Layers From Bounding Boxes usando a saída bboxes. Padrão: false (canvas completo). | BOOLEAN | Não | false (full canvas)
true (minimal size) | +| `otimização do prompt` | Modo de otimização do prompt: "standard" oferece maior qualidade, "fast" menor tempo de geração. Padrão: "standard". | STRING | Não | "standard"
"fast" | +| `marca d'água` | Se deve adicionar uma marca d'água "AI generated" às imagens. Padrão: false. | BOOLEAN | Não | false
true | +| `recortar camadas` | Geometria das saídas em lote de camadas/máscaras (layer_stack não é afetado e está sempre com recorte exato). Canvas completo: cada camada em um canvas do tamanho da base na posição de sua caixa delimitadora — recomponha diretamente com ImageCompositeMasked. Tamanho mínimo: cada camada recortada para sua caixa delimitadora (preenchida até a maior camada para formação de lote) — tensores muito menores; reconstrua o posicionamento com Layers From Bounding Boxes usando a saída bboxes. Padrão: false (canvas completo). | BOOLEAN | Não | false (full canvas)
true (minimal size) | Nota: A imagem de entrada deve ser uma única imagem; lotes não são suportados. A imagem deve ter pelo menos 512x512 pixels com proporção entre 1:16 e 16:1. diff --git a/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/tr.md b/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/tr.md index 1bf2eb4e5..ffe542f36 100644 --- a/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/tr.md +++ b/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/tr.md @@ -6,13 +6,13 @@ ByteDance Seedream 5.0 Pro Layer Separation, bir görüntüyü bir arka plan kat | Parametre | Açıklama | Veri Türü | Zorunlu | Aralık | |-----------|-------------|-----------|----------|-------| -| `image` | Ayrıştırılacak görüntü. Tam olarak bir görüntü, en az 512x512 piksel, 1:16 ile 16:1 arasında en-boy oranı. Yaklaşık 4MP'den büyük girdiler yüklemeden önce küçültülür. | IMAGE | Evet | Tek görüntü | -| `prompt` | Görüntünün nasıl ayrıştırılacağı. Otomatik algılama ve tüm ana öğeleri ayırma için boş bırakın. Ayrıştırmayı kontrol etmek için öğeleri doğal dilde tanımlayın veya `left top right bottom` etiketleriyle (0-1000 bindelik koordinatlar) belirli bölgeleri hedefleyin. Varsayılan: boş dize. | STRING | Evet | Çok satırlı metin | -| `size` | Çıktı çözünürlük seviyesi. "auto", girdi görüntü boyutunu takip eder (1K-2K aralığına sınırlandırılmıştır). Varsayılan: "auto". | STRING | Evet | "auto"
"1K"
"1.5K"
"2K" | -| `seed` | Üretim için kullanılacak seed değeri. Varsayılan: 0. | INT | Evet | 0 ile 2147483647 arası | -| `prompt_optimization` | Prompt optimizasyon modu: "standard" daha yüksek kalite sağlar, "fast" daha kısa üretim süresi sağlar. Varsayılan: "standard". | STRING | Hayır | "standard"
"fast" | -| `watermark` | Görüntülere "AI generated" filigranı eklenip eklenmeyeceği. Varsayılan: false. | BOOLEAN | Hayır | false
true | -| `crop_layers` | Katman/mask toplu çıktılarının geometrisi (layer_stack bundan etkilenmez ve her zaman sıkıdır). Full canvas modu: her katman, sınırlayıcı kutu konumunda temel boyutunda bir tuval üzerinde - ImageCompositeMasked ile doğrudan yeniden birleştirin. Minimal size modu: her katman sınırlayıcı kutusuna kırpılır (toplu işleme için en büyük katmana dolgulanır) - çok daha küçük tensörler; yerleşimi, bboxes çıktısını kullanarak Layers From Bounding Boxes ile yeniden oluşturun. Varsayılan: false (full canvas). | BOOLEAN | Hayır | false (full canvas)
true (minimal size) | +| `görüntü` | Ayrıştırılacak görüntü. Tam olarak bir görüntü, en az 512x512 piksel, 1:16 ile 16:1 arasında en-boy oranı. Yaklaşık 4MP'den büyük girdiler yüklemeden önce küçültülür. | IMAGE | Evet | Tek görüntü | +| `istem` | Görüntünün nasıl ayrıştırılacağı. Otomatik algılama ve tüm ana öğeleri ayırma için boş bırakın. Ayrıştırmayı kontrol etmek için öğeleri doğal dilde tanımlayın veya `left top right bottom` etiketleriyle (0-1000 bindelik koordinatlar) belirli bölgeleri hedefleyin. Varsayılan: boş dize. | STRING | Evet | Çok satırlı metin | +| `boyut` | Çıktı çözünürlük seviyesi. "auto", girdi görüntü boyutunu takip eder (1K-2K aralığına sınırlandırılmıştır). Varsayılan: "auto". | STRING | Evet | "auto"
"1K"
"1.5K"
"2K" | +| `tohum` | Üretim için kullanılacak seed değeri. Varsayılan: 0. | INT | Evet | 0 ile 2147483647 arası | +| `istem_optimizasyonu` | Prompt optimizasyon modu: "standard" daha yüksek kalite sağlar, "fast" daha kısa üretim süresi sağlar. Varsayılan: "standard". | STRING | Hayır | "standard"
"fast" | +| `filigran` | Görüntülere "AI generated" filigranı eklenip eklenmeyeceği. Varsayılan: false. | BOOLEAN | Hayır | false
true | +| `katmanları_kırp` | Katman/mask toplu çıktılarının geometrisi (layer_stack bundan etkilenmez ve her zaman sıkıdır). Full canvas modu: her katman, sınırlayıcı kutu konumunda temel boyutunda bir tuval üzerinde - ImageCompositeMasked ile doğrudan yeniden birleştirin. Minimal size modu: her katman sınırlayıcı kutusuna kırpılır (toplu işleme için en büyük katmana dolgulanır) - çok daha küçük tensörler; yerleşimi, bboxes çıktısını kullanarak Layers From Bounding Boxes ile yeniden oluşturun. Varsayılan: false (full canvas). | BOOLEAN | Hayır | false (full canvas)
true (minimal size) | Not: Girdi görüntüsü tek bir görüntü olmalıdır; batch girişleri desteklenmez. Görüntü en az 512x512 piksel olmalı ve en-boy oranı 1:16 ile 16:1 arasında olmalıdır. @@ -20,12 +20,12 @@ Not: Girdi görüntüsü tek bir görüntü olmalıdır; batch girişleri destek | Çıktı Adı | Açıklama | Veri Türü | |-------------|-------------|-----------| -| `base_image` | Katmanların üzerine istiflendiği temel görüntü (arka plan katmanı). | IMAGE | -| `base_mask` | Temel görüntünün şeffaflığı (1 = şeffaf, LoadImage kuralı); şu anda her zaman tamamen opak. | MASK | -| `layers` | Alttan üste doğru sıralanmış şeffaf katmanlar. Full canvas modu: sınırlayıcı kutu konumlarında temel boyutunda siyah bir tuval üzerine yerleştirilir. Minimal size modu: sınırlayıcı kutularına kırpılır, sol üstten hizalanır, en büyük katman boyutuna dolgulanır. | IMAGE | -| `masks` | Katman başına şeffaflık, katman batch'iyle dizin uyumlu (1 = şeffaf, LoadImage kuralı). ImageCompositeMasked tarzı birleştirme için önce InvertMask ekleyin. | MASK | +| `taban_görüntü` | Katmanların üzerine istiflendiği temel görüntü (arka plan katmanı). | IMAGE | +| `taban_maske` | Temel görüntünün şeffaflığı (1 = şeffaf, LoadImage kuralı); şu anda her zaman tamamen opak. | MASK | +| `katmanlar` | Alttan üste doğru sıralanmış şeffaf katmanlar. Full canvas modu: sınırlayıcı kutu konumlarında temel boyutunda siyah bir tuval üzerine yerleştirilir. Minimal size modu: sınırlayıcı kutularına kırpılır, sol üstten hizalanır, en büyük katman boyutuna dolgulanır. | IMAGE | +| `maskeler` | Katman başına şeffaflık, katman batch'iyle dizin uyumlu (1 = şeffaf, LoadImage kuralı). ImageCompositeMasked tarzı birleştirme için önce InvertMask ekleyin. | MASK | | `bboxes` | Katman başına bir yerleştirme kutusu, katman batch'iyle dizin uyumlu (katman başına yerleşimi yeniden oluşturmak için her ikisini ve maskeleri Layers From Bounding Boxes'a besleyin): `{x, y, width, height, metadata: {name, desc, z_index, native_size, content_rect, flags}}`. `content_rect = [left, top, width, height]`, katmanın kendi çerçevesi içindeki içerik bölgesidir; tuvale kutu konumu artı bu uzaklıkta yerleşir. | BOUNDING_BOX | -| `layer_stack` | Create Layered Image için düzenlemeye hazır katman belgesi: temel katman artı her öğenin, kendi adlandırılmış, sıkı kırpılmış katmanı olarak gerçek konumunda ve istifleme sırasında yer alması. Doğrudan bağlayın veya Add Layer ile genişletin. | LAYERS | +| `katman_yığını` | Create Layered Image için düzenlemeye hazır katman belgesi: temel katman artı her öğenin, kendi adlandırılmış, sıkı kırpılmış katmanı olarak gerçek konumunda ve istifleme sırasında yer alması. Doğrudan bağlayın veya Add Layer ile genişletin. | LAYERS | > Bu belge yapay zeka tarafından oluşturulmuştur. Herhangi bir hata bulursanız veya iyileştirme önerileriniz varsa, katkıda bulunmaktan çekinmeyin! [GitHub'da Düzenle](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/tr.md) diff --git a/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/zh-TW.md b/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/zh-TW.md index 946b81d8a..97508c8a7 100644 --- a/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/zh-TW.md +++ b/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/zh-TW.md @@ -6,13 +6,13 @@ ByteDance Seedream 5.0 Pro 圖層分離會將影像分解為一個背景圖層 | 參數 | 說明 | 資料類型 | 必要 | 範圍 | |-----------|-------------|-----------|----------|-------| -| `image` | 要分離的影像。必須是單一影像,至少 512x512 像素,長寬比介於 1:16 和 16:1 之間。大於約 4MP 的輸入會在上傳前縮小。 | IMAGE | 是 | 單一影像 | -| `prompt` | 影像分離的方式。留空則自動偵測並分離所有主要元素。以自然語言描述元素來控制分離,或使用 `left top right bottom` 標記(0-1000 千分比座標)鎖定特定區域。預設值:空字串。 | STRING | 是 | 多行文字 | -| `size` | 輸出解析度等級。"auto" 會跟隨輸入影像尺寸(限制在 1K-2K 範圍內)。預設值:"auto"。 | STRING | 是 | "auto"
"1K"
"1.5K"
"2K" | -| `seed` | 用於生成隨機種子。預設值:0。 | INT | 是 | 0 到 2147483647 | -| `prompt_optimization` | 提示詞最佳化模式:"standard" 提供較高品質,"fast" 縮短生成時間。預設值:"standard"。 | STRING | 否 | "standard"
"fast" | -| `watermark` | 是否在影像上加入「AI 生成」浮水印。預設值:false。 | BOOLEAN | 否 | false
true | -| `crop_layers` | 圖層/遮罩批次輸出的幾何形狀(layer_stack 不受影響,永遠是緊密裁切)。完整畫布:每個圖層位於基底尺寸畫布上其邊界框位置——可直接使用 ImageCompositeMasked 重新合成。最小尺寸:每個圖層裁切至其邊界框(為了批次統一而補邊至最大圖層)——張量小得多;使用 Layers From Bounding Boxes 搭配 bboxes 輸出重建放置。預設值:false(完整畫布)。 | BOOLEAN | 否 | false (full canvas)
true (minimal size) | +| `圖片` | 要分離的影像。必須是單一影像,至少 512x512 像素,長寬比介於 1:16 和 16:1 之間。大於約 4MP 的輸入會在上傳前縮小。 | IMAGE | 是 | 單一影像 | +| `提示詞` | 影像分離的方式。留空則自動偵測並分離所有主要元素。以自然語言描述元素來控制分離,或使用 `left top right bottom` 標記(0-1000 千分比座標)鎖定特定區域。預設值:空字串。 | STRING | 是 | 多行文字 | +| `尺寸` | 輸出解析度等級。"auto" 會跟隨輸入影像尺寸(限制在 1K-2K 範圍內)。預設值:"auto"。 | STRING | 是 | "auto"
"1K"
"1.5K"
"2K" | +| `種子` | 用於生成隨機種子。預設值:0。 | INT | 是 | 0 到 2147483647 | +| `提示詞優化` | 提示詞最佳化模式:"standard" 提供較高品質,"fast" 縮短生成時間。預設值:"standard"。 | STRING | 否 | "standard"
"fast" | +| `浮水印` | 是否在影像上加入「AI 生成」浮水印。預設值:false。 | BOOLEAN | 否 | false
true | +| `裁切圖層` | 圖層/遮罩批次輸出的幾何形狀(layer_stack 不受影響,永遠是緊密裁切)。完整畫布:每個圖層位於基底尺寸畫布上其邊界框位置——可直接使用 ImageCompositeMasked 重新合成。最小尺寸:每個圖層裁切至其邊界框(為了批次統一而補邊至最大圖層)——張量小得多;使用 Layers From Bounding Boxes 搭配 bboxes 輸出重建放置。預設值:false(完整畫布)。 | BOOLEAN | 否 | false (full canvas)
true (minimal size) | 注意:輸入影像必須是單一影像;不支援批次。影像至少需為 512x512 像素,且長寬比介於 1:16 和 16:1 之間。 @@ -20,12 +20,12 @@ ByteDance Seedream 5.0 Pro 圖層分離會將影像分解為一個背景圖層 | 輸出名稱 | 說明 | 資料類型 | |-------------|-------------|-----------| -| `base_image` | 圖層堆疊所在的基底影像(背景圖層)。 | IMAGE | -| `base_mask` | 基底影像的透明度(1 = 透明,採用 LoadImage 慣例);目前永遠是完全不透明。 | MASK | -| `layers` | 由下到上排序的透明圖層。完整畫布模式:放置在黑色基底尺寸畫布上的邊界框位置。最小尺寸模式:裁切至其邊界框,錨定於左上角,並補邊至最大圖層。 | IMAGE | -| `masks` | 每個圖層的透明度,與 layers 批次索引對齊(1 = 透明,採用 LoadImage 慣例)。若要使用 ImageCompositeMasked 風格合成,請先加入 InvertMask。 | MASK | -| `bboxes` | 每個圖層的放置方框,與 layers 批次索引對齊(將兩者及 masks 一起送入 Layers From Bounding Boxes 以重建每個圖層的放置):`{x, y, width, height, metadata: {name, desc, z_index, native_size, content_rect, flags}}`。`content_rect = [left, top, width, height]` 是圖層在其自身框架內的內容區域;它會落在畫布上,位置為方框座標加上該偏移量。 | BOUNDING_BOX | -| `layer_stack` | 可供 Create Layered Image 直接編輯的圖層文件:基底圖層加上每個元素作為獨立、具名稱、緊密裁切的圖層,位於其真實位置與堆疊順序。可直接連接,或使用 Add Layer 擴充。 | LAYERS | +| `基底圖片` | 圖層堆疊所在的基底影像(背景圖層)。 | IMAGE | +| `基底遮罩` | 基底影像的透明度(1 = 透明,採用 LoadImage 慣例);目前永遠是完全不透明。 | MASK | +| `圖層` | 由下到上排序的透明圖層。完整畫布模式:放置在黑色基底尺寸畫布上的邊界框位置。最小尺寸模式:裁切至其邊界框,錨定於左上角,並補邊至最大圖層。 | IMAGE | +| `遮罩` | 每個圖層的透明度,與 layers 批次索引對齊(1 = 透明,採用 LoadImage 慣例)。若要使用 ImageCompositeMasked 風格合成,請先加入 InvertMask。 | MASK | +| `邊界框` | 每個圖層的放置方框,與 layers 批次索引對齊(將兩者及 masks 一起送入 Layers From Bounding Boxes 以重建每個圖層的放置):`{x, y, width, height, metadata: {name, desc, z_index, native_size, content_rect, flags}}`。`content_rect = [left, top, width, height]` 是圖層在其自身框架內的內容區域;它會落在畫布上,位置為方框座標加上該偏移量。 | BOUNDING_BOX | +| `圖層堆疊` | 可供 Create Layered Image 直接編輯的圖層文件:基底圖層加上每個元素作為獨立、具名稱、緊密裁切的圖層,位於其真實位置與堆疊順序。可直接連接,或使用 Add Layer 擴充。 | LAYERS | > 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceSeedreamLayerSeparationNode/zh-TW.md) diff --git a/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV2/en.md b/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV2/en.md index c5e50616a..5535b6036 100644 --- a/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV2/en.md +++ b/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV2/en.md @@ -1,38 +1,69 @@ -# ByteDance Seedream 4.5 & 5.0 Node +# ByteDance Seedream 4.5 & 5.0 -This node generates or edits images using ByteDance's Seedream models (versions 4.0, 4.5, and 5.0 Lite). It can create new images from a text prompt or edit existing images by providing reference images, supporting resolutions up to 4K. +This node generates or edits images using ByteDance's Seedream models (versions 4.0, 4.5, 5.0 Lite, and 5.0 Pro). It provides unified text-to-image generation and precise single-sentence image editing at up to 4K resolution. This is the legacy (V2) version of the Seedream node. ## Inputs +### Common Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `model` | The Seedream model version to use for generation. Each model has different capabilities and pricing. | DYNAMIC_COMBO | Yes | `"seedream 5.0 pro"`
`"seedream 5.0 lite"`
`"seedream-4-5-251128"`
`"seedream-4-0-250828"` | +| `prompt` | Text prompt for creating or editing an image (default: empty string). | STRING | Yes | N/A | +| `seed` | Seed to use for generation (default: 0). | INT | Yes | 0 to 2147483647 | +| `watermark` | Whether to add an "AI generated" watermark to the image (default: False). | BOOLEAN | Yes | True / False | +| `thinking` | Enable the model's prompt-optimization reasoning ('thinking') for better adherence. Can substantially increase generation time — notably on Seedream 5.0 Pro. Can only be disabled for text-to-image (not when reference images are provided) (default: True). | BOOLEAN | No | True / False | + +### `seedream 5.0 pro` Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | Pick a recommended size. Select Custom to use the width and height below. | COMBO | Yes | Multiple model-specific presets available, includes `Custom` | +| `width` | Custom width for image. Value is working only if `size_preset` is set to `Custom` (default: 2048). | INT | Yes | 1024 to 3136 (step 2) | +| `height` | Custom height for image. Value is working only if `size_preset` is set to `Custom` (default: 2048). | INT | Yes | 1024 to 2496 (step 2) | + +### `seedream 5.0 lite` Inputs + | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `prompt` | Text prompt for creating or editing an image. | STRING | Yes | N/A | -| `model` | The Seedream model version to use for generation. Each model has different capabilities and pricing. | COMBO | Yes | `"seedream 5.0 lite"`
`"seedream-4-5-251128"`
`"seedream-4-0-250828"` | -| `seed` | Seed to use for generation (default: 0). | INT | No | 0 to 2147483647 | -| `watermark` | Whether to add an "AI generated" watermark to the image (default: False). | BOOLEAN | No | True / False | +| `size_preset` | Pick a recommended size. Select Custom to use the width and height below. | COMBO | Yes | Multiple model-specific presets available, includes `Custom` | +| `width` | Custom width for image. Value is working only if `size_preset` is set to `Custom` (default: 2048). | INT | Yes | 1024 to 6240 (step 2) | +| `height` | Custom height for image. Value is working only if `size_preset` is set to `Custom` (default: 2048). | INT | Yes | 1024 to 4992 (step 2) | +| `max_images` | Maximum number of images to generate. With 1, exactly one image is produced. With >1, the model generates between 1 and max_images related images (e.g., story scenes, character variations). Total images (input + generated) cannot exceed 15. (default: 1) | INT | Yes | 1 to 14 | +| `fail_on_partial` | If enabled, abort execution if any requested images are missing or return an error. (default: False) | BOOLEAN | Yes | True / False | + +### `seedream-4-5-251128` Inputs -### Model-Specific Parameters +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | Pick a recommended size. Select Custom to use the width and height below. | COMBO | Yes | Multiple model-specific presets available, includes `Custom` | +| `width` | Custom width for image. Value is working only if `size_preset` is set to `Custom` (default: 2048). | INT | Yes | 1024 to 6240 (step 2) | +| `height` | Custom height for image. Value is working only if `size_preset` is set to `Custom` (default: 2048). | INT | Yes | 1024 to 4992 (step 2) | +| `max_images` | Maximum number of images to generate. With 1, exactly one image is produced. With >1, the model generates between 1 and max_images related images (e.g., story scenes, character variations). Total images (input + generated) cannot exceed 15. (default: 1) | INT | Yes | 1 to 10 | +| `fail_on_partial` | If enabled, abort execution if any requested images are missing or return an error. (default: False) | BOOLEAN | Yes | True / False | -When you select a model, additional parameters become available: +### `seedream-4-0-250828` Inputs -- **Size Preset**: A dropdown to select a predefined image resolution. The available presets depend on the selected model. -- **Width**: The width of the generated image in pixels (default: 2048). -- **Height**: The height of the generated image in pixels (default: 2048). -- **Max Images**: The maximum number of images to generate (default: 1). When set to 1, sequential image generation is disabled. -- **Reference Images**: Up to 10 (for Seedream 4.0 and 4.5) or 14 (for Seedream 5.0 Lite) reference images for editing. Images must have an aspect ratio between 1:3 and 3:1. -- **Fail on Partial**: If enabled, the node will raise an error if not all requested images are generated successfully (default: False). +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | Pick a recommended size. Select Custom to use the width and height below. | COMBO | Yes | Multiple model-specific presets available, includes `Custom` | +| `width` | Custom width for image. Value is working only if `size_preset` is set to `Custom` (default: 2048). | INT | Yes | 1024 to 6240 (step 2) | +| `height` | Custom height for image. Value is working only if `size_preset` is set to `Custom` (default: 2048). | INT | Yes | 1024 to 4992 (step 2) | +| `max_images` | Maximum number of images to generate. With 1, exactly one image is produced. With >1, the model generates between 1 and max_images related images (e.g., story scenes, character variations). Total images (input + generated) cannot exceed 15. (default: 1) | INT | Yes | 1 to 10 | +| `fail_on_partial` | If enabled, abort execution if any requested images are missing or return an error. (default: False) | BOOLEAN | Yes | True / False | -### Resolution Constraints +### Reference Inputs -- **Seedream 5.0 Lite and 4.5**: Minimum resolution is 3.68 megapixels (e.g., 1920x1920). -- **Seedream 4.0**: Minimum resolution is 0.92 megapixels (e.g., 960x960). -- **All models**: Maximum resolution is 16.78 megapixels (e.g., 4096x4096). +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `images` | Growable slot: connect 1..N items (e.g. `image_1`, `image_2`, ...); the count limit depends on the selected model (see model sections). Optional reference image(s) for image-to-image or multi-reference generation. With no reference images, the node works in text-to-image mode. | IMAGE | No | 0 to 10 images (`seedream 5.0 pro`, `seedream-4-5-251128`, `seedream-4-0-250828`)
0 to 14 images (`seedream 5.0 lite`) | -### Image Count Constraints +### Notes on constraints +- `width` and `height` only take effect when `size_preset` is set to `Custom`. - The total number of reference images plus generated images cannot exceed 15. -- For Seedream 5.0 Lite, a maximum of 14 reference images are supported. -- For Seedream 4.0 and 4.5, a maximum of 10 reference images are supported. +- `thinking` can only be disabled for text-to-image generation, not when reference images are provided. +- Seedream 5.0 Pro does not support batch generation: it always produces a single image, so `max_images` and `fail_on_partial` are not available for this model. ## Outputs @@ -43,4 +74,4 @@ When you select a model, additional parameters become available: > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV2/en.md) --- -**Source fingerprint (SHA-256):** `a5d58211c716f916b7920ee454d3f2aa3e2af6de666e783bb25d44700ba83569` +**Source fingerprint (SHA-256):** `f1a84171d94c602ec5417e43857ddf511ab1e54caa089b1928f740d3a38423f8` diff --git a/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/ar.md b/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/ar.md new file mode 100644 index 000000000..b1a09ca79 --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/ar.md @@ -0,0 +1,96 @@ +# ByteDanceSeedreamNodeV3 + +**ByteDance Seedream 4.5 و5.0** تولّد الصور من موجه نصي (نص إلى صورة) أو تولّد/تحرّر الصور بإرشاد من صور مرجعية اختيارية، باستخدام نماذج ByteDance Seedream 4.0 و4.5 و5.0 بدقة تصل إلى 4K. ترسل العقدة الموجه وأي صور مرجعية إلى واجهة برمجة تطبيقات ByteDance، وتنتظر اكتمال مهمة التوليد، ثم تُرجع موتر الصورة أو الموترات الناتجة. + +## المدخلات + +### المدخلات الشائعة + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|---------|--------|--------------|-------|--------| +| `prompt` | الموجه النصي لإنشاء صورة أو تحريرها. يجب ألا يكون فارغًا بعد إزالة المسافات البيضاء. | STRING | نعم | نص متعدد الأسطر | +| `model` | يحدد نموذج Seedream الذي سيتم استخدامه. يعرض كل نموذج مجموعته الخاصة من المعاملات الفرعية والحدود أدناه. | DYNAMIC_COMBO | نعم | "seedream 5.0 pro"
"seedream 5.0 lite"
"seedream-4-5-251128"
"seedream-4-0-250828" | + +### مدخلات Seedream 5.0 Pro (seedream 5.0 pro) + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|---------|--------|--------------|-------|--------| +| `size_preset` | اختر حجمًا موصى به. حدد Custom لاستخدام العرض والارتفاع أدناه. الافتراضي: أول إعداد مسبق موصى به لهذا النموذج. | COMBO | لا | إعدادات الحجم الموصى بها الخاصة بالنموذج
"Custom" | +| `width` | العرض المخصص للصورة. تكون القيمة فعالة فقط إذا تم تعيين `size_preset` إلى `Custom`. الافتراضي: 2048. | INT | لا | 1024 إلى 3136 (خطوة 2) | +| `height` | الارتفاع المخصص للصورة. تكون القيمة فعالة فقط إذا تم تعيين `size_preset` إلى `Custom`. الافتراضي: 2048. | INT | لا | 1024 إلى 2496 (خطوة 2) | +| `prompt_optimization` | وضع تحسين الموجه عند توفير صور مرجعية: 'standard' يعطي جودة أعلى، و'fast' وقت توليد أقصر. الافتراضي: "standard". | COMBO | لا | "standard"
"fast" | +| `seed` | البذرة المستخدمة في التوليد. الافتراضي: 42. | INT | لا | 0 إلى 2147483647 | +| `watermark` | ما إذا كان سيتم إضافة علامة مائية "AI generated" إلى الصورة. الافتراضي: false. | BOOLEAN | لا | true / false | +| `thinking` | تمكين تفكير تحسين الموجه في النموذج ('thinking') لتحسين الالتزام. قد يزيد وقت التوليد بشكل كبير — خاصة على Seedream 5.0 Pro. يمكن تعطيله فقط للتوليد من نص إلى صورة (وليس عند توفير صور مرجعية). الافتراضي: true. | BOOLEAN | لا | true / false | + +### مدخلات Seedream 5.0 Lite (seedream 5.0 lite) + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|---------|--------|--------------|-------|--------| +| `size_preset` | اختر حجمًا موصى به. حدد Custom لاستخدام العرض والارتفاع أدناه. الافتراضي: أول إعداد مسبق موصى به لهذا النموذج. | COMBO | لا | إعدادات الحجم الموصى بها الخاصة بالنموذج
"Custom" | +| `width` | العرض المخصص للصورة. تكون القيمة فعالة فقط إذا تم تعيين `size_preset` إلى `Custom`. الافتراضي: 2048. | INT | لا | 1024 إلى 6240 (خطوة 2) | +| `height` | الارتفاع المخصص للصورة. تكون القيمة فعالة فقط إذا تم تعيين `size_preset` إلى `Custom`. الافتراضي: 2048. | INT | لا | 1024 إلى 4992 (خطوة 2) | +| `max_images` | الحد الأقصى لعدد الصور المولدة. عند القيمة 1، يتم إنتاج صورة واحدة بالضبط. وعند القيمة >1، يولد النموذج ما بين 1 وmax_images صورة مرتبطة (مثل مشاهد القصة، وتنويعات الشخصيات). لا يمكن أن يتجاوز إجمالي الصور (المدخلة + المولدة) 15. الافتراضي: 1. | INT | لا | 1 إلى 14 | +| `fail_on_partial` | عند التمكين، إحباط التنفيذ إذا كانت أي صورة مطلوبة مفقودة أو إرجاع خطأ. الافتراضي: false. | BOOLEAN | لا | true / false | +| `seed` | البذرة المستخدمة في التوليد. الافتراضي: 42. | INT | لا | 0 إلى 2147483647 | +| `watermark` | ما إذا كان سيتم إضافة علامة مائية "AI generated" إلى الصورة. الافتراضي: false. | BOOLEAN | لا | true / false | +| `thinking` | تمكين تفكير تحسين الموجه في النموذج ('thinking') لتحسين الالتزام. قد يزيد وقت التوليد بشكل كبير — خاصة على Seedream 5.0 Pro. يمكن تعطيله فقط للتوليد من نص إلى صورة (وليس عند توفير صور مرجعية). الافتراضي: true. | BOOLEAN | لا | true / false | + +### مدخلات Seedream 4.5 (seedream-4-5-251128) + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|---------|--------|--------------|-------|--------| +| `size_preset` | اختر حجمًا موصى به. حدد Custom لاستخدام العرض والارتفاع أدناه. الافتراضي: أول إعداد مسبق موصى به لهذا النموذج. | COMBO | لا | إعدادات الحجم الموصى بها الخاصة بالنموذج
"Custom" | +| `width` | العرض المخصص للصورة. تكون القيمة فعالة فقط إذا تم تعيين `size_preset` إلى `Custom`. الافتراضي: 2048. | INT | لا | 1024 إلى 6240 (خطوة 2) | +| `height` | الارتفاع المخصص للصورة. تكون القيمة فعالة فقط إذا تم تعيين `size_preset` إلى `Custom`. الافتراضي: 2048. | INT | لا | 1024 إلى 4992 (خطوة 2) | +| `max_images` | الحد الأقصى لعدد الصور المولدة. عند القيمة 1، يتم إنتاج صورة واحدة بالضبط. وعند القيمة >1، يولد النموذج ما بين 1 وmax_images صورة مرتبطة (مثل مشاهد القصة، وتنويعات الشخصيات). لا يمكن أن يتجاوز إجمالي الصور (المدخلة + المولدة) 15. الافتراضي: 1. | INT | لا | 1 إلى 10 | +| `fail_on_partial` | عند التمكين، إحباط التنفيذ إذا كانت أي صورة مطلوبة مفقودة أو إرجاع خطأ. الافتراضي: false. | BOOLEAN | لا | true / false | +| `seed` | البذرة المستخدمة في التوليد. الافتراضي: 42. | INT | لا | 0 إلى 2147483647 | +| `watermark` | ما إذا كان سيتم إضافة علامة مائية "AI generated" إلى الصورة. الافتراضي: false. | BOOLEAN | لا | true / false | +| `thinking` | تمكين تفكير تحسين الموجه في النموذج ('thinking') لتحسين الالتزام. قد يزيد وقت التوليد بشكل كبير — خاصة على Seedream 5.0 Pro. يمكن تعطيله فقط للتوليد من نص إلى صورة (وليس عند توفير صور مرجعية). الافتراضي: true. | BOOLEAN | لا | true / false | + +### مدخلات Seedream 4.0 (seedream-4-0-250828) + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|---------|--------|--------------|-------|--------| +| `size_preset` | اختر حجمًا موصى به. حدد Custom لاستخدام العرض والارتفاع أدناه. الافتراضي: أول إعداد مسبق موصى به لهذا النموذج. | COMBO | لا | إعدادات الحجم الموصى بها الخاصة بالنموذج
"Custom" | +| `width` | العرض المخصص للصورة. تكون القيمة فعالة فقط إذا تم تعيين `size_preset` إلى `Custom`. الافتراضي: 2048. | INT | لا | 1024 إلى 6240 (خطوة 2) | +| `height` | الارتفاع المخصص للصورة. تكون القيمة فعالة فقط إذا تم تعيين `size_preset` إلى `Custom`. الافتراضي: 2048. | INT | لا | 1024 إلى 4992 (خطوة 2) | +| `max_images` | الحد الأقصى لعدد الصور المولدة. عند القيمة 1، يتم إنتاج صورة واحدة بالضبط. وعند القيمة >1، يولد النموذج ما بين 1 وmax_images صورة مرتبطة (مثل مشاهد القصة، وتنويعات الشخصيات). لا يمكن أن يتجاوز إجمالي الصور (المدخلة + المولدة) 15. الافتراضي: 1. | INT | لا | 1 إلى 10 | +| `fail_on_partial` | عند التمكين، إحباط التنفيذ إذا كانت أي صورة مطلوبة مفقودة أو إرجاع خطأ. الافتراضي: false. | BOOLEAN | لا | true / false | +| `seed` | البذرة المستخدمة في التوليد. الافتراضي: 42. | INT | لا | 0 إلى 2147483647 | +| `watermark` | ما إذا كان سيتم إضافة علامة مائية "AI generated" إلى الصورة. الافتراضي: false. | BOOLEAN | لا | true / false | +| `thinking` | تمكين تفكير تحسين الموجه في النموذج ('thinking') لتحسين الالتزام. قد يزيد وقت التوليد بشكل كبير — خاصة على Seedream 5.0 Pro. يمكن تعطيله فقط للتوليد من نص إلى صورة (وليس عند توفير صور مرجعية). الافتراضي: true. | BOOLEAN | لا | true / false | + +### المدخلات المرجعية + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|---------|--------|--------------|-------|--------| +| `images` | فتحة قابلة للتوسيع: صور مرجعية اختيارية للتوليد من صورة إلى صورة أو التوليد متعدد المراجع. اربط من 1 إلى N صورة (مثل `image_1`, `image_2`, ...)؛ حد العدد يعتمد على النموذج (انظر الملاحظات أدناه). إذا كانت الصورة المرتبطة تحتوي على مجموعة صور، فإن كل صورة في المجموعة تُحتسب ضمن الحد. | IMAGE | لا | 0 إلى 10 (Seedream 5.0 Pro, Seedream 4.5, Seedream 4.0)
0 إلى 14 (Seedream 5.0 Lite) | + +**ملاحظات:** + +- يجب ألا يكون `prompt` فارغًا بعد إزالة المسافات البيضاء. +- الحد الأقصى لعدد الصور المرجعية: 10 لنماذج Seedream 5.0 Pro وSeedream 4.5 وSeedream 4.0؛ و14 لـSeedream 5.0 Lite. +- يجب أن تكون نسبة العرض إلى الارتفاع لكل صورة مرجعية بين 1:3 و3:1. +- عندما تكون قيمة `max_images` أكبر من 1 (غير متاحة على Seedream 5.0 Pro)، لا يمكن أن يتجاوز إجمالي عدد الصور المرجعية مضافًا إليها الصور المولدة 15. +- يمكن تعطيل `thinking` فقط لتوليد نص إلى صورة. عند تقديم صور مرجعية، يجب تمكين `thinking`. +- يتم استخدام `width` و`height` فقط عندما يكون `size_preset` مضبوطًا على "Custom". +- يتوفر `prompt_optimization` فقط على Seedream 5.0 Pro. +- يتوفر `max_images` و`fail_on_partial` فقط على Seedream 5.0 Lite وSeedream 4.5 وSeedream 4.0؛ بينما يطلب Seedream 5.0 Pro دائمًا صورة واحدة. +- متطلبات الدقة (العرض × الارتفاع): + - Seedream 5.0 Pro: بين 0.92 ميجابكسل (921,600 بكسل) و4.19 ميجابكسل (4,194,304 بكسل). + - Seedream 5.0 Lite وSeedream 4.5: على الأقل 3.68 ميجابكسل (3,686,400 بكسل). + - Seedream 4.0: على الأقل 0.92 ميجابكسل (921,600 بكسل). + - جميع النماذج غير Pro: على الأكثر 16.78 ميجابكسل (16,777,216 بكسل). + +## المخرجات + +| اسم المخرج | الوصف | نوع البيانات | +|------------|--------|--------------| +| `image` | موتر الصورة المولدة. عند توليد صور متعددة، يتم دمجها في موتر IMAGE واحد مجمّع. | IMAGE | + +> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/ar.md) + +--- +**Source fingerprint (SHA-256):** `68dd23afdb5720491cef784b22ad66ff0baf80984ea652ea4c13e6c264c029ac` diff --git a/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/en.md b/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/en.md new file mode 100644 index 000000000..7edd7e23e --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/en.md @@ -0,0 +1,96 @@ +# ByteDanceSeedreamNodeV3 + +ByteDance Seedream 4.5 & 5.0 generates images from a text prompt (text-to-image) or generates/edits images guided by optional reference images, using ByteDance Seedream 4.0, 4.5, and 5.0 models at up to 4K resolution. The node sends the prompt and any reference images to the ByteDance API, waits for the generation task to complete, and returns the resulting image tensor or tensors. + +## Inputs + +### Common Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `prompt` | Text prompt for creating or editing an image. Must not be empty after trimming whitespace. | STRING | Yes | Multiline text | +| `model` | Selects the Seedream model to use. Each model exposes its own set of sub-parameters and limits below. | DYNAMIC_COMBO | Yes | "seedream 5.0 pro"
"seedream 5.0 lite"
"seedream-4-5-251128"
"seedream-4-0-250828" | + +### Seedream 5.0 Pro Inputs (seedream 5.0 pro) + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | Pick a recommended size. Select Custom to use the width and height below. Default: first recommended preset for this model. | COMBO | No | Model-specific recommended size presets
"Custom" | +| `width` | Custom width for image. Value is working only if `size_preset` is set to `Custom`. Default: 2048. | INT | No | 1024 to 3136 (step 2) | +| `height` | Custom height for image. Value is working only if `size_preset` is set to `Custom`. Default: 2048. | INT | No | 1024 to 2496 (step 2) | +| `prompt_optimization` | Prompt-optimization mode when reference images are provided: 'standard' gives higher quality, 'fast' shorter generation time. Default: "standard". | COMBO | No | "standard"
"fast" | +| `seed` | Seed to use for generation. Default: 42. | INT | No | 0 to 2147483647 | +| `watermark` | Whether to add an "AI generated" watermark to the image. Default: false. | BOOLEAN | No | true / false | +| `thinking` | Enable the model's prompt-optimization reasoning ('thinking') for better adherence. Can substantially increase generation time — notably on Seedream 5.0 Pro. Can only be disabled for text-to-image (not when reference images are provided). Default: true. | BOOLEAN | No | true / false | + +### Seedream 5.0 Lite Inputs (seedream 5.0 lite) + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | Pick a recommended size. Select Custom to use the width and height below. Default: first recommended preset for this model. | COMBO | No | Model-specific recommended size presets
"Custom" | +| `width` | Custom width for image. Value is working only if `size_preset` is set to `Custom`. Default: 2048. | INT | No | 1024 to 6240 (step 2) | +| `height` | Custom height for image. Value is working only if `size_preset` is set to `Custom`. Default: 2048. | INT | No | 1024 to 4992 (step 2) | +| `max_images` | Maximum number of images to generate. With 1, exactly one image is produced. With >1, the model generates between 1 and max_images related images (e.g., story scenes, character variations). Total images (input + generated) cannot exceed 15. Default: 1. | INT | No | 1 to 14 | +| `fail_on_partial` | If enabled, abort execution if any requested images are missing or return an error. Default: false. | BOOLEAN | No | true / false | +| `seed` | Seed to use for generation. Default: 42. | INT | No | 0 to 2147483647 | +| `watermark` | Whether to add an "AI generated" watermark to the image. Default: false. | BOOLEAN | No | true / false | +| `thinking` | Enable the model's prompt-optimization reasoning ('thinking') for better adherence. Can substantially increase generation time — notably on Seedream 5.0 Pro. Can only be disabled for text-to-image (not when reference images are provided). Default: true. | BOOLEAN | No | true / false | + +### Seedream 4.5 Inputs (seedream-4-5-251128) + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | Pick a recommended size. Select Custom to use the width and height below. Default: first recommended preset for this model. | COMBO | No | Model-specific recommended size presets
"Custom" | +| `width` | Custom width for image. Value is working only if `size_preset` is set to `Custom`. Default: 2048. | INT | No | 1024 to 6240 (step 2) | +| `height` | Custom height for image. Value is working only if `size_preset` is set to `Custom`. Default: 2048. | INT | No | 1024 to 4992 (step 2) | +| `max_images` | Maximum number of images to generate. With 1, exactly one image is produced. With >1, the model generates between 1 and max_images related images (e.g., story scenes, character variations). Total images (input + generated) cannot exceed 15. Default: 1. | INT | No | 1 to 10 | +| `fail_on_partial` | If enabled, abort execution if any requested images are missing or return an error. Default: false. | BOOLEAN | No | true / false | +| `seed` | Seed to use for generation. Default: 42. | INT | No | 0 to 2147483647 | +| `watermark` | Whether to add an "AI generated" watermark to the image. Default: false. | BOOLEAN | No | true / false | +| `thinking` | Enable the model's prompt-optimization reasoning ('thinking') for better adherence. Can substantially increase generation time — notably on Seedream 5.0 Pro. Can only be disabled for text-to-image (not when reference images are provided). Default: true. | BOOLEAN | No | true / false | + +### Seedream 4.0 Inputs (seedream-4-0-250828) + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | Pick a recommended size. Select Custom to use the width and height below. Default: first recommended preset for this model. | COMBO | No | Model-specific recommended size presets
"Custom" | +| `width` | Custom width for image. Value is working only if `size_preset` is set to `Custom`. Default: 2048. | INT | No | 1024 to 6240 (step 2) | +| `height` | Custom height for image. Value is working only if `size_preset` is set to `Custom`. Default: 2048. | INT | No | 1024 to 4992 (step 2) | +| `max_images` | Maximum number of images to generate. With 1, exactly one image is produced. With >1, the model generates between 1 and max_images related images (e.g., story scenes, character variations). Total images (input + generated) cannot exceed 15. Default: 1. | INT | No | 1 to 10 | +| `fail_on_partial` | If enabled, abort execution if any requested images are missing or return an error. Default: false. | BOOLEAN | No | true / false | +| `seed` | Seed to use for generation. Default: 42. | INT | No | 0 to 2147483647 | +| `watermark` | Whether to add an "AI generated" watermark to the image. Default: false. | BOOLEAN | No | true / false | +| `thinking` | Enable the model's prompt-optimization reasoning ('thinking') for better adherence. Can substantially increase generation time — notably on Seedream 5.0 Pro. Can only be disabled for text-to-image (not when reference images are provided). Default: true. | BOOLEAN | No | true / false | + +### Reference Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `images` | Growable slot: optional reference image(s) for image-to-image or multi-reference generation. Connect 1..N images (e.g., `image_1`, `image_2`, ...); the count limit is per model (see notes below). If a connected image contains a batch of images, every image in the batch counts toward the limit. | IMAGE | No | 0 to 10 (Seedream 5.0 Pro, Seedream 4.5, Seedream 4.0)
0 to 14 (Seedream 5.0 Lite) | + +**Notes:** + +- The `prompt` must not be empty after trimming whitespace. +- Maximum number of reference images: 10 for Seedream 5.0 Pro, Seedream 4.5, and Seedream 4.0; 14 for Seedream 5.0 Lite. +- Each reference image must have an aspect ratio between 1:3 and 3:1. +- When `max_images` is greater than 1 (not available on Seedream 5.0 Pro), the total number of reference images plus generated images cannot exceed 15. +- `thinking` can only be disabled for text-to-image generation. When reference images are provided, `thinking` must be enabled. +- `width` and `height` are only used when `size_preset` is set to "Custom". +- `prompt_optimization` is only available on Seedream 5.0 Pro. +- `max_images` and `fail_on_partial` are only available on Seedream 5.0 Lite, Seedream 4.5, and Seedream 4.0; Seedream 5.0 Pro always requests a single image. +- Resolution requirements (width x height): + - Seedream 5.0 Pro: between 0.92MP (921,600 pixels) and 4.19MP (4,194,304 pixels). + - Seedream 5.0 Lite and Seedream 4.5: at least 3.68MP (3,686,400 pixels). + - Seedream 4.0: at least 0.92MP (921,600 pixels). + - All non-Pro models: at most 16.78MP (16,777,216 pixels). + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `image` | The generated image tensor. When multiple images are generated, they are concatenated into a single batched IMAGE tensor. | IMAGE | + +> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/en.md) + +--- +**Source fingerprint (SHA-256):** `68dd23afdb5720491cef784b22ad66ff0baf80984ea652ea4c13e6c264c029ac` diff --git a/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/es.md b/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/es.md new file mode 100644 index 000000000..2a666dbe5 --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/es.md @@ -0,0 +1,96 @@ +# ByteDanceSeedreamNodeV3 + +ByteDance Seedream 4.5 y 5.0 genera imágenes a partir de un prompt de texto (texto a imagen) o genera/edita imágenes guiadas por imágenes de referencia opcionales, utilizando los modelos ByteDance Seedream 4.0, 4.5 y 5.0 con una resolución de hasta 4K. El nodo envía el prompt y las imágenes de referencia, si las hay, a la API de ByteDance, espera a que se complete la tarea de generación y devuelve el tensor o los tensores de imagen resultantes. + +## Entradas + +### Entradas comunes + +| Parámetro | Descripción | Tipo de datos | Requerido | Rango | +|-----------|-------------|---------------|-----------|-------| +| `prompt` | Prompt de texto para crear o editar una imagen. No debe estar vacío después de recortar los espacios en blanco. | STRING | Sí | Texto multilínea | +| `model` | Selecciona el modelo Seedream a utilizar. Cada modelo expone su propio conjunto de subparámetros y límites a continuación. | DYNAMIC_COMBO | Sí | "seedream 5.0 pro"
"seedream 5.0 lite"
"seedream-4-5-251128"
"seedream-4-0-250828" | + +### Entradas de Seedream 5.0 Pro (seedream 5.0 pro) + +| Parámetro | Descripción | Tipo de datos | Requerido | Rango | +|-----------|-------------|---------------|-----------|-------| +| `size_preset` | Elija un tamaño recomendado. Seleccione Custom para usar el ancho y el alto indicados abajo. Predeterminado: el primer ajuste preestablecido recomendado para este modelo. | COMBO | No | Ajustes preestablecidos de tamaño recomendados específicos del modelo
"Custom" | +| `width` | Ancho personalizado de la imagen. El valor solo se aplica si `size_preset` está configurado en `Custom`. Predeterminado: 2048. | INT | No | 1024 a 3136 (paso 2) | +| `height` | Alto personalizado de la imagen. El valor solo se aplica si `size_preset` está configurado en `Custom`. Predeterminado: 2048. | INT | No | 1024 a 2496 (paso 2) | +| `prompt_optimization` | Modo de optimización del prompt cuando se proporcionan imágenes de referencia: 'standard' ofrece mayor calidad, 'fast' reduce el tiempo de generación. Predeterminado: "standard". | COMBO | No | "standard"
"fast" | +| `seed` | Semilla (seed) para la generación. Predeterminado: 42. | INT | No | 0 a 2147483647 | +| `watermark` | Indica si se debe añadir una marca de agua "AI generated" a la imagen. Predeterminado: false. | BOOLEAN | No | true / false | +| `thinking` | Habilita el razonamiento de optimización del prompt ('thinking') del modelo para un mejor cumplimiento. Puede aumentar considerablemente el tiempo de generación, especialmente en Seedream 5.0 Pro. Solo se puede deshabilitar para generación de texto a imagen (no cuando se proporcionan imágenes de referencia). Predeterminado: true. | BOOLEAN | No | true / false | + +### Entradas de Seedream 5.0 Lite (seedream 5.0 lite) + +| Parámetro | Descripción | Tipo de datos | Requerido | Rango | +|-----------|-------------|---------------|-----------|-------| +| `size_preset` | Elija un tamaño recomendado. Seleccione Custom para usar el ancho y el alto indicados abajo. Predeterminado: el primer ajuste preestablecido recomendado para este modelo. | COMBO | No | Ajustes preestablecidos de tamaño recomendados específicos del modelo
"Custom" | +| `width` | Ancho personalizado de la imagen. El valor solo se aplica si `size_preset` está configurado en `Custom`. Predeterminado: 2048. | INT | No | 1024 a 6240 (paso 2) | +| `height` | Alto personalizado de la imagen. El valor solo se aplica si `size_preset` está configurado en `Custom`. Predeterminado: 2048. | INT | No | 1024 a 4992 (paso 2) | +| `max_images` | Número máximo de imágenes a generar. Con 1, se produce exactamente una imagen. Con >1, el modelo genera entre 1 y max_images imágenes relacionadas (p. ej., escenas narrativas, variaciones de personajes). El total de imágenes (entrada + generadas) no puede superar 15. Predeterminado: 1. | INT | No | 1 a 14 | +| `fail_on_partial` | Si está habilitado, aborta la ejecución si falta alguna de las imágenes solicitadas o si se devuelve un error. Predeterminado: false. | BOOLEAN | No | true / false | +| `seed` | Semilla (seed) para la generación. Predeterminado: 42. | INT | No | 0 a 2147483647 | +| `watermark` | Indica si se debe añadir una marca de agua "AI generated" a la imagen. Predeterminado: false. | BOOLEAN | No | true / false | +| `thinking` | Habilita el razonamiento de optimización del prompt ('thinking') del modelo para un mejor cumplimiento. Puede aumentar considerablemente el tiempo de generación, especialmente en Seedream 5.0 Pro. Solo se puede deshabilitar para generación de texto a imagen (no cuando se proporcionan imágenes de referencia). Predeterminado: true. | BOOLEAN | No | true / false | + +### Entradas de Seedream 4.5 (seedream-4-5-251128) + +| Parámetro | Descripción | Tipo de datos | Requerido | Rango | +|-----------|-------------|---------------|-----------|-------| +| `size_preset` | Elija un tamaño recomendado. Seleccione Custom para usar el ancho y el alto indicados abajo. Predeterminado: el primer ajuste preestablecido recomendado para este modelo. | COMBO | No | Ajustes preestablecidos de tamaño recomendados específicos del modelo
"Custom" | +| `width` | Ancho personalizado de la imagen. El valor solo se aplica si `size_preset` está configurado en `Custom`. Predeterminado: 2048. | INT | No | 1024 a 6240 (paso 2) | +| `height` | Alto personalizado de la imagen. El valor solo se aplica si `size_preset` está configurado en `Custom`. Predeterminado: 2048. | INT | No | 1024 a 4992 (paso 2) | +| `max_images` | Número máximo de imágenes a generar. Con 1, se produce exactamente una imagen. Con >1, el modelo genera entre 1 y max_images imágenes relacionadas (p. ej., escenas narrativas, variaciones de personajes). El total de imágenes (entrada + generadas) no puede superar 15. Predeterminado: 1. | INT | No | 1 a 10 | +| `fail_on_partial` | Si está habilitado, aborta la ejecución si falta alguna de las imágenes solicitadas o si se devuelve un error. Predeterminado: false. | BOOLEAN | No | true / false | +| `seed` | Semilla (seed) para la generación. Predeterminado: 42. | INT | No | 0 a 2147483647 | +| `watermark` | Indica si se debe añadir una marca de agua "AI generated" a la imagen. Predeterminado: false. | BOOLEAN | No | true / false | +| `thinking` | Habilita el razonamiento de optimización del prompt ('thinking') del modelo para un mejor cumplimiento. Puede aumentar considerablemente el tiempo de generación, especialmente en Seedream 5.0 Pro. Solo se puede deshabilitar para generación de texto a imagen (no cuando se proporcionan imágenes de referencia). Predeterminado: true. | BOOLEAN | No | true / false | + +### Entradas de Seedream 4.0 (seedream-4-0-250828) + +| Parámetro | Descripción | Tipo de datos | Requerido | Rango | +|-----------|-------------|---------------|-----------|-------| +| `size_preset` | Elija un tamaño recomendado. Seleccione Custom para usar el ancho y el alto indicados abajo. Predeterminado: el primer ajuste preestablecido recomendado para este modelo. | COMBO | No | Ajustes preestablecidos de tamaño recomendados específicos del modelo
"Custom" | +| `width` | Ancho personalizado de la imagen. El valor solo se aplica si `size_preset` está configurado en `Custom`. Predeterminado: 2048. | INT | No | 1024 a 6240 (paso 2) | +| `height` | Alto personalizado de la imagen. El valor solo se aplica si `size_preset` está configurado en `Custom`. Predeterminado: 2048. | INT | No | 1024 a 4992 (paso 2) | +| `max_images` | Número máximo de imágenes a generar. Con 1, se produce exactamente una imagen. Con >1, el modelo genera entre 1 y max_images imágenes relacionadas (p. ej., escenas narrativas, variaciones de personajes). El total de imágenes (entrada + generadas) no puede superar 15. Predeterminado: 1. | INT | No | 1 a 10 | +| `fail_on_partial` | Si está habilitado, aborta la ejecución si falta alguna de las imágenes solicitadas o si se devuelve un error. Predeterminado: false. | BOOLEAN | No | true / false | +| `seed` | Semilla (seed) para la generación. Predeterminado: 42. | INT | No | 0 a 2147483647 | +| `watermark` | Indica si se debe añadir una marca de agua "AI generated" a la imagen. Predeterminado: false. | BOOLEAN | No | true / false | +| `thinking` | Habilita el razonamiento de optimización del prompt ('thinking') del modelo para un mejor cumplimiento. Puede aumentar considerablemente el tiempo de generación, especialmente en Seedream 5.0 Pro. Solo se puede deshabilitar para generación de texto a imagen (no cuando se proporcionan imágenes de referencia). Predeterminado: true. | BOOLEAN | No | true / false | + +### Entradas de referencia + +| Parámetro | Descripción | Tipo de datos | Requerido | Rango | +|-----------|-------------|---------------|-----------|-------| +| `images` | Slot ampliable: imagen o imágenes de referencia opcionales para generación de imagen a imagen o con múltiples referencias. Conecte de 1 a N imágenes (p. ej., `image_1`, `image_2`, ...); el límite de cantidad es por modelo (consulte las notas a continuación). Si una imagen conectada contiene un lote de imágenes, cada imagen del lote cuenta para el límite. | IMAGE | No | 0 a 10 (Seedream 5.0 Pro, Seedream 4.5, Seedream 4.0)
0 a 14 (Seedream 5.0 Lite) | + +**Notas:** + +- El `prompt` no debe estar vacío después de recortar los espacios en blanco. +- Número máximo de imágenes de referencia: 10 para Seedream 5.0 Pro, Seedream 4.5 y Seedream 4.0; 14 para Seedream 5.0 Lite. +- Cada imagen de referencia debe tener una relación de aspecto entre 1:3 y 3:1. +- Cuando `max_images` es mayor que 1 (no disponible en Seedream 5.0 Pro), el número total de imágenes de referencia más las imágenes generadas no puede superar 15. +- `thinking` solo se puede deshabilitar para la generación de texto a imagen. Cuando se proporcionan imágenes de referencia, `thinking` debe estar habilitado. +- `width` y `height` solo se utilizan cuando `size_preset` está configurado en "Custom". +- `prompt_optimization` solo está disponible en Seedream 5.0 Pro. +- `max_images` y `fail_on_partial` solo están disponibles en Seedream 5.0 Lite, Seedream 4.5 y Seedream 4.0; Seedream 5.0 Pro siempre solicita una sola imagen. +- Requisitos de resolución (ancho x alto): + - Seedream 5.0 Pro: entre 0.92 MP (921,600 píxeles) y 4.19 MP (4,194,304 píxeles). + - Seedream 5.0 Lite y Seedream 4.5: al menos 3.68 MP (3,686,400 píxeles). + - Seedream 4.0: al menos 0.92 MP (921,600 píxeles). + - Todos los modelos no Pro: como máximo 16.78 MP (16,777,216 píxeles). + +## Salidas + +| Nombre de salida | Descripción | Tipo de datos | +|------------------|-------------|---------------| +| `image` | El tensor de imagen generado. Cuando se generan varias imágenes, se concatenan en un único tensor IMAGE agrupado en lote. | IMAGE | + +> Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/es.md) + +--- +**Source fingerprint (SHA-256):** `68dd23afdb5720491cef784b22ad66ff0baf80984ea652ea4c13e6c264c029ac` diff --git a/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/fa.md b/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/fa.md new file mode 100644 index 000000000..0baa70a21 --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/fa.md @@ -0,0 +1,96 @@ +# ByteDanceSeedreamNodeV3 + +ByteDance Seedream 4.5 & 5.0 تصاویری را از یک پرامپت متنی تولید می‌کند (text-to-image) یا با هدایت تصاویر مرجع اختیاری، تصاویر را تولید/ویرایش می‌کند. این گره با استفاده از مدل‌های ByteDance Seedream 4.0، 4.5 و 5.0 در وضوح تا 4K کار می‌کند. گره پرامپت و هر تصویر مرجع را به API ByteDance ارسال می‌کند، منتظر تکمیل وظیفه تولید می‌ماند و تانسور یا تانسورهای تصویر حاصل را برمی‌گرداند. + +## ورودی‌ها + +### ورودی‌های مشترک + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `prompt` | پرامپت متنی برای ایجاد یا ویرایش تصویر. پس از حذف فاصله‌های ابتدا و انتها نباید خالی باشد. | STRING | بله | متن چندخطی | +| `model` | مدل Seedream مورد استفاده را انتخاب می‌کند. هر مدل مجموعه‌ای از زیرپارامترها و محدودیت‌های خاص خود را در ادامه ارائه می‌دهد. | DYNAMIC_COMBO | بله | "seedream 5.0 pro"
"seedream 5.0 lite"
"seedream-4-5-251128"
"seedream-4-0-250828" | + +### ورودی‌های Seedream 5.0 Pro (seedream 5.0 pro) + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | یک اندازه پیشنهادی انتخاب کنید. برای استفاده از عرض و ارتفاع زیر، گزینه Custom را انتخاب کنید. پیش‌فرض: اولین پیش‌تنظیم پیشنهادی برای این مدل. | COMBO | خیر | پیش‌تنظیم‌های اندازه پیشنهادی مخصوص مدل
"Custom" | +| `width` | عرض سفارشی برای تصویر. این مقدار فقط زمانی اعمال می‌شود که `size_preset` روی `Custom` تنظیم شده باشد. پیش‌فرض: 2048. | INT | خیر | 1024 تا 3136 (گام 2) | +| `height` | ارتفاع سفارشی برای تصویر. این مقدار فقط زمانی اعمال می‌شود که `size_preset` روی `Custom` تنظیم شده باشد. پیش‌فرض: 2048. | INT | خیر | 1024 تا 2496 (گام 2) | +| `prompt_optimization` | حالت بهینه‌سازی پرامپت هنگام ارائه تصاویر مرجع: «standard» کیفیت بالاتر و «fast» زمان تولید کوتاه‌تری می‌دهد. پیش‌فرض: «standard». | COMBO | خیر | "standard"
"fast" | +| `seed` | seed مورد استفاده برای تولید. پیش‌فرض: 42. | INT | خیر | 0 تا 2147483647 | +| `watermark` | آیا واترمارک «AI generated» به تصویر اضافه شود یا نه. پیش‌فرض: false. | BOOLEAN | خیر | true / false | +| `thinking` | استدلال بهینه‌سازی پرامپت مدل («thinking») را برای پایبندی بهتر فعال کنید. می‌تواند زمان تولید را به‌طور قابل توجهی افزایش دهد — به‌ویژه در Seedream 5.0 Pro. فقط برای تولید متن به تصویر (text-to-image) می‌توان آن را غیرفعال کرد (نه وقتی تصاویر مرجع ارائه می‌شوند). پیش‌فرض: true. | BOOLEAN | خیر | true / false | + +### ورودی‌های Seedream 5.0 Lite (seedream 5.0 lite) + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | یک اندازه پیشنهادی انتخاب کنید. برای استفاده از عرض و ارتفاع زیر، گزینه Custom را انتخاب کنید. پیش‌فرض: اولین پیش‌تنظیم پیشنهادی برای این مدل. | COMBO | خیر | پیش‌تنظیم‌های اندازه پیشنهادی مخصوص مدل
"Custom" | +| `width` | عرض سفارشی برای تصویر. این مقدار فقط زمانی اعمال می‌شود که `size_preset` روی `Custom` تنظیم شده باشد. پیش‌فرض: 2048. | INT | خیر | 1024 تا 6240 (گام 2) | +| `height` | ارتفاع سفارشی برای تصویر. این مقدار فقط زمانی اعمال می‌شود که `size_preset` روی `Custom` تنظیم شده باشد. پیش‌فرض: 2048. | INT | خیر | 1024 تا 4992 (گام 2) | +| `max_images` | حداکثر تعداد تصاویری که تولید می‌شود. با مقدار 1، دقیقاً یک تصویر تولید می‌شود. با مقدار بیشتر از 1، مدل بین 1 تا `max_images` تصویر مرتبط تولید می‌کند (مثلاً صحنه‌های داستانی، تغییرات شخصیت). مجموع تصاویر (ورودی + تولیدشده) نمی‌تواند از 15 بیشتر شود. پیش‌فرض: 1. | INT | خیر | 1 تا 14 | +| `fail_on_partial` | در صورت فعال بودن، اگر هر یک از تصاویر درخواستی موجود نباشد، اجرا را متوقف کند یا خطا برگرداند. پیش‌فرض: false. | BOOLEAN | خیر | true / false | +| `seed` | seed مورد استفاده برای تولید. پیش‌فرض: 42. | INT | خیر | 0 تا 2147483647 | +| `watermark` | آیا واترمارک «AI generated» به تصویر اضافه شود یا نه. پیش‌فرض: false. | BOOLEAN | خیر | true / false | +| `thinking` | استدلال بهینه‌سازی پرامپت مدل («thinking») را برای پایبندی بهتر فعال کنید. می‌تواند زمان تولید را به‌طور قابل توجهی افزایش دهد — به‌ویژه در Seedream 5.0 Pro. فقط برای تولید متن به تصویر (text-to-image) می‌توان آن را غیرفعال کرد (نه وقتی تصاویر مرجع ارائه می‌شوند). پیش‌فرض: true. | BOOLEAN | خیر | true / false | + +### ورودی‌های Seedream 4.5 (seedream-4-5-251128) + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | یک اندازه پیشنهادی انتخاب کنید. برای استفاده از عرض و ارتفاع زیر، گزینه Custom را انتخاب کنید. پیش‌فرض: اولین پیش‌تنظیم پیشنهادی برای این مدل. | COMBO | خیر | پیش‌تنظیم‌های اندازه پیشنهادی مخصوص مدل
"Custom" | +| `width` | عرض سفارشی برای تصویر. این مقدار فقط زمانی اعمال می‌شود که `size_preset` روی `Custom` تنظیم شده باشد. پیش‌فرض: 2048. | INT | خیر | 1024 تا 6240 (گام 2) | +| `height` | ارتفاع سفارشی برای تصویر. این مقدار فقط زمانی اعمال می‌شود که `size_preset` روی `Custom` تنظیم شده باشد. پیش‌فرض: 2048. | INT | خیر | 1024 تا 4992 (گام 2) | +| `max_images` | حداکثر تعداد تصاویری که تولید می‌شود. با مقدار 1، دقیقاً یک تصویر تولید می‌شود. با مقدار بیشتر از 1، مدل بین 1 تا `max_images` تصویر مرتبط تولید می‌کند (مثلاً صحنه‌های داستانی، تغییرات شخصیت). مجموع تصاویر (ورودی + تولیدشده) نمی‌تواند از 15 بیشتر شود. پیش‌فرض: 1. | INT | خیر | 1 تا 10 | +| `fail_on_partial` | در صورت فعال بودن، اگر هر یک از تصاویر درخواستی موجود نباشد، اجرا را متوقف کند یا خطا برگرداند. پیش‌فرض: false. | BOOLEAN | خیر | true / false | +| `seed` | seed مورد استفاده برای تولید. پیش‌فرض: 42. | INT | خیر | 0 تا 2147483647 | +| `watermark` | آیا واترمارک «AI generated» به تصویر اضافه شود یا نه. پیش‌فرض: false. | BOOLEAN | خیر | true / false | +| `thinking` | استدلال بهینه‌سازی پرامپت مدل («thinking») را برای پایبندی بهتر فعال کنید. می‌تواند زمان تولید را به‌طور قابل توجهی افزایش دهد — به‌ویژه در Seedream 5.0 Pro. فقط برای تولید متن به تصویر (text-to-image) می‌توان آن را غیرفعال کرد (نه وقتی تصاویر مرجع ارائه می‌شوند). پیش‌فرض: true. | BOOLEAN | خیر | true / false | + +### ورودی‌های Seedream 4.0 (seedream-4-0-250828) + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | یک اندازه پیشنهادی انتخاب کنید. برای استفاده از عرض و ارتفاع زیر، گزینه Custom را انتخاب کنید. پیش‌فرض: اولین پیش‌تنظیم پیشنهادی برای این مدل. | COMBO | خیر | پیش‌تنظیم‌های اندازه پیشنهادی مخصوص مدل
"Custom" | +| `width` | عرض سفارشی برای تصویر. این مقدار فقط زمانی اعمال می‌شود که `size_preset` روی `Custom` تنظیم شده باشد. پیش‌فرض: 2048. | INT | خیر | 1024 تا 6240 (گام 2) | +| `height` | ارتفاع سفارشی برای تصویر. این مقدار فقط زمانی اعمال می‌شود که `size_preset` روی `Custom` تنظیم شده باشد. پیش‌فرض: 2048. | INT | خیر | 1024 تا 4992 (گام 2) | +| `max_images` | حداکثر تعداد تصاویری که تولید می‌شود. با مقدار 1، دقیقاً یک تصویر تولید می‌شود. با مقدار بیشتر از 1، مدل بین 1 تا `max_images` تصویر مرتبط تولید می‌کند (مثلاً صحنه‌های داستانی، تغییرات شخصیت). مجموع تصاویر (ورودی + تولیدشده) نمی‌تواند از 15 بیشتر شود. پیش‌فرض: 1. | INT | خیر | 1 تا 10 | +| `fail_on_partial` | در صورت فعال بودن، اگر هر یک از تصاویر درخواستی موجود نباشد، اجرا را متوقف کند یا خطا برگرداند. پیش‌فرض: false. | BOOLEAN | خیر | true / false | +| `seed` | seed مورد استفاده برای تولید. پیش‌فرض: 42. | INT | خیر | 0 تا 2147483647 | +| `watermark` | آیا واترمارک «AI generated» به تصویر اضافه شود یا نه. پیش‌فرض: false. | BOOLEAN | خیر | true / false | +| `thinking` | استدلال بهینه‌سازی پرامپت مدل («thinking») را برای پایبندی بهتر فعال کنید. می‌تواند زمان تولید را به‌طور قابل توجهی افزایش دهد — به‌ویژه در Seedream 5.0 Pro. فقط برای تولید متن به تصویر (text-to-image) می‌توان آن را غیرفعال کرد (نه وقتی تصاویر مرجع ارائه می‌شوند). پیش‌فرض: true. | BOOLEAN | خیر | true / false | + +### ورودی‌های مرجع + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `images` | اسلات قابل افزایش: تصویر(های) مرجع اختیاری برای تولید image-to-image یا تولید با چند مرجع. ۱..N تصویر را متصل کنید (مثلاً `image_1`، `image_2` و ...)؛ محدودیت تعداد به مدل بستگی دارد (به نکات زیر مراجعه کنید). اگر یک تصویر متصل شامل یک دسته (batch) از تصاویر باشد، هر تصویر در آن دسته در محاسبه محدودیت به حساب می‌آید. | IMAGE | خیر | 0 تا 10 (Seedream 5.0 Pro, Seedream 4.5, Seedream 4.0)
0 تا 14 (Seedream 5.0 Lite) | + +**نکات:** + +- پرامپت (`prompt`) پس از حذف فاصله‌های ابتدا و انتها نباید خالی باشد. +- حداکثر تعداد تصاویر مرجع: 10 برای Seedream 5.0 Pro، Seedream 4.5 و Seedream 4.0؛ 14 برای Seedream 5.0 Lite. +- نسبت ابعاد هر تصویر مرجع باید بین 1:3 و 3:1 باشد. +- وقتی `max_images` بزرگ‌تر از 1 است (در Seedream 5.0 Pro در دسترس نیست)، مجموع تعداد تصاویر مرجع و تصاویر تولیدشده نمی‌تواند از 15 بیشتر شود. +- `thinking` فقط برای تولید متن به تصویر (text-to-image) قابل غیرفعال‌سازی است. وقتی تصاویر مرجع ارائه می‌شوند، `thinking` باید فعال باشد. +- `width` و `height` فقط زمانی استفاده می‌شوند که `size_preset` روی «Custom» تنظیم شده باشد. +- `prompt_optimization` فقط در Seedream 5.0 Pro در دسترس است. +- `max_images` و `fail_on_partial` فقط در Seedream 5.0 Lite، Seedream 4.5 و Seedream 4.0 در دسترس هستند؛ Seedream 5.0 Pro همیشه یک تصویر واحد درخواست می‌کند. +- الزامات وضوح (عرض × ارتفاع): + - Seedream 5.0 Pro: بین 0.92MP (921,600 پیکسل) و 4.19MP (4,194,304 پیکسل). + - Seedream 5.0 Lite و Seedream 4.5: حداقل 3.68MP (3,686,400 پیکسل). + - Seedream 4.0: حداقل 0.92MP (921,600 پیکسل). + - همه مدل‌های غیر Pro: حداکثر 16.78MP (16,777,216 پیکسل). + +## خروجی‌ها + +| نام خروجی | توضیحات | نوع داده | +|-------------|-------------|-----------| +| `image` | تانسور تصویر تولیدشده. وقتی چند تصویر تولید می‌شود، در یک تانسور IMAGE دسته‌ای واحد ترکیب می‌شوند. | IMAGE | + +> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/fa.md) + +--- +**Source fingerprint (SHA-256):** `68dd23afdb5720491cef784b22ad66ff0baf80984ea652ea4c13e6c264c029ac` diff --git a/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/fr.md b/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/fr.md new file mode 100644 index 000000000..57fb707d6 --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/fr.md @@ -0,0 +1,96 @@ +# ByteDanceSeedreamNodeV3 + +ByteDance Seedream 4.5 & 5.0 génère des images à partir d'une invite de texte (texte-à-image) ou génère/modifie des images guidées par des images de référence facultatives, en utilisant les modèles ByteDance Seedream 4.0, 4.5 et 5.0 jusqu'à une résolution 4K. Le nœud envoie l'invite et les éventuelles images de référence à l'API ByteDance, attend que la tâche de génération soit terminée, puis renvoie le ou les tenseurs d'image résultants. + +## Entrées + +### Entrées communes + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `prompt` | Invite de texte pour créer ou éditer une image. Ne doit pas être vide après suppression des espaces. | STRING | Oui | Texte multiligne | +| `model` | Sélectionne le modèle Seedream à utiliser. Chaque modèle expose son propre ensemble de sous-paramètres et de limites ci-dessous. | DYNAMIC_COMBO | Oui | "seedream 5.0 pro"
"seedream 5.0 lite"
"seedream-4-5-251128"
"seedream-4-0-250828" | + +### Seedream 5.0 Pro Entrées (seedream 5.0 pro) + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `size_preset` | Choisissez une taille recommandée. Sélectionnez Custom pour utiliser la largeur et la hauteur ci-dessous. Défaut : premier préréglage recommandé pour ce modèle. | COMBO | Non | Préréglages de taille recommandés selon le modèle
"Custom" | +| `width` | Largeur personnalisée de l'image. La valeur n'est prise en compte que si `size_preset` est défini sur `Custom`. Défaut : 2048. | INT | Non | 1024 à 3136 (pas de 2) | +| `height` | Hauteur personnalisée de l'image. La valeur n'est prise en compte que si `size_preset` est défini sur `Custom`. Défaut : 2048. | INT | Non | 1024 à 2496 (pas de 2) | +| `prompt_optimization` | Mode d'optimisation du prompt lorsque des images de référence sont fournies : 'standard' offre une qualité supérieure, 'fast' un temps de génération plus court. Défaut : "standard". | COMBO | Non | "standard"
"fast" | +| `seed` | Graine (seed) à utiliser pour la génération. Défaut : 42. | INT | Non | 0 à 2147483647 | +| `watermark` | Indique s'il faut ajouter un filigrane « généré par IA » à l'image. Défaut : false. | BOOLEAN | Non | true / false | +| `thinking` | Active le raisonnement d'optimisation du prompt du modèle (« thinking ») pour un meilleur respect du prompt. Peut augmenter considérablement le temps de génération, notamment sur Seedream 5.0 Pro. Ne peut être désactivé que pour la génération texte-à-image (pas lorsque des images de référence sont fournies). Défaut : true. | BOOLEAN | Non | true / false | + +### Seedream 5.0 Lite Entrées (seedream 5.0 lite) + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `size_preset` | Choisissez une taille recommandée. Sélectionnez Custom pour utiliser la largeur et la hauteur ci-dessous. Défaut : premier préréglage recommandé pour ce modèle. | COMBO | Non | Préréglages de taille recommandés selon le modèle
"Custom" | +| `width` | Largeur personnalisée de l'image. La valeur n'est prise en compte que si `size_preset` est défini sur `Custom`. Défaut : 2048. | INT | Non | 1024 à 6240 (pas de 2) | +| `height` | Hauteur personnalisée de l'image. La valeur n'est prise en compte que si `size_preset` est défini sur `Custom`. Défaut : 2048. | INT | Non | 1024 à 4992 (pas de 2) | +| `max_images` | Nombre maximal d'images à générer. Avec 1, une seule image est produite. Avec >1, le modèle génère entre 1 et max_images images liées (par exemple, scènes d'histoire, variations de personnage). Le nombre total d'images (entrée + générées) ne peut pas dépasser 15. Défaut : 1. | INT | Non | 1 à 14 | +| `fail_on_partial` | Si activé, interrompt l'exécution et renvoie une erreur si des images demandées sont manquantes. Défaut : false. | BOOLEAN | Non | true / false | +| `seed` | Graine (seed) à utiliser pour la génération. Défaut : 42. | INT | Non | 0 à 2147483647 | +| `watermark` | Indique s'il faut ajouter un filigrane « généré par IA » à l'image. Défaut : false. | BOOLEAN | Non | true / false | +| `thinking` | Active le raisonnement d'optimisation du prompt du modèle (« thinking ») pour un meilleur respect du prompt. Peut augmenter considérablement le temps de génération, notamment sur Seedream 5.0 Pro. Ne peut être désactivé que pour la génération texte-à-image (pas lorsque des images de référence sont fournies). Défaut : true. | BOOLEAN | Non | true / false | + +### Seedream 4.5 Entrées (seedream-4-5-251128) + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `size_preset` | Choisissez une taille recommandée. Sélectionnez Custom pour utiliser la largeur et la hauteur ci-dessous. Défaut : premier préréglage recommandé pour ce modèle. | COMBO | Non | Préréglages de taille recommandés selon le modèle
"Custom" | +| `width` | Largeur personnalisée de l'image. La valeur n'est prise en compte que si `size_preset` est défini sur `Custom`. Défaut : 2048. | INT | Non | 1024 à 6240 (pas de 2) | +| `height` | Hauteur personnalisée de l'image. La valeur n'est prise en compte que si `size_preset` est défini sur `Custom`. Défaut : 2048. | INT | Non | 1024 à 4992 (pas de 2) | +| `max_images` | Nombre maximal d'images à générer. Avec 1, une seule image est produite. Avec >1, le modèle génère entre 1 et max_images images liées (par exemple, scènes d'histoire, variations de personnage). Le nombre total d'images (entrée + générées) ne peut pas dépasser 15. Défaut : 1. | INT | Non | 1 à 10 | +| `fail_on_partial` | Si activé, interrompt l'exécution et renvoie une erreur si des images demandées sont manquantes. Défaut : false. | BOOLEAN | Non | true / false | +| `seed` | Graine (seed) à utiliser pour la génération. Défaut : 42. | INT | Non | 0 à 2147483647 | +| `watermark` | Indique s'il faut ajouter un filigrane « généré par IA » à l'image. Défaut : false. | BOOLEAN | Non | true / false | +| `thinking` | Active le raisonnement d'optimisation du prompt du modèle (« thinking ») pour un meilleur respect du prompt. Peut augmenter considérablement le temps de génération, notamment sur Seedream 5.0 Pro. Ne peut être désactivé que pour la génération texte-à-image (pas lorsque des images de référence sont fournies). Défaut : true. | BOOLEAN | Non | true / false | + +### Seedream 4.0 Entrées (seedream-4-0-250828) + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `size_preset` | Choisissez une taille recommandée. Sélectionnez Custom pour utiliser la largeur et la hauteur ci-dessous. Défaut : premier préréglage recommandé pour ce modèle. | COMBO | Non | Préréglages de taille recommandés selon le modèle
"Custom" | +| `width` | Largeur personnalisée de l'image. La valeur n'est prise en compte que si `size_preset` est défini sur `Custom`. Défaut : 2048. | INT | Non | 1024 à 6240 (pas de 2) | +| `height` | Hauteur personnalisée de l'image. La valeur n'est prise en compte que si `size_preset` est défini sur `Custom`. Défaut : 2048. | INT | Non | 1024 à 4992 (pas de 2) | +| `max_images` | Nombre maximal d'images à générer. Avec 1, une seule image est produite. Avec >1, le modèle génère entre 1 et max_images images liées (par exemple, scènes d'histoire, variations de personnage). Le nombre total d'images (entrée + générées) ne peut pas dépasser 15. Défaut : 1. | INT | Non | 1 à 10 | +| `fail_on_partial` | Si activé, interrompt l'exécution et renvoie une erreur si des images demandées sont manquantes. Défaut : false. | BOOLEAN | Non | true / false | +| `seed` | Graine (seed) à utiliser pour la génération. Défaut : 42. | INT | Non | 0 à 2147483647 | +| `watermark` | Indique s'il faut ajouter un filigrane « généré par IA » à l'image. Défaut : false. | BOOLEAN | Non | true / false | +| `thinking` | Active le raisonnement d'optimisation du prompt du modèle (« thinking ») pour un meilleur respect du prompt. Peut augmenter considérablement le temps de génération, notamment sur Seedream 5.0 Pro. Ne peut être désactivé que pour la génération texte-à-image (pas lorsque des images de référence sont fournies). Défaut : true. | BOOLEAN | Non | true / false | + +### Entrées de référence + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `images` | Emplacement extensible : image(s) de référence facultative(s) pour la génération image-à-image ou multi-référence. Connectez 1..N images (par exemple, `image_1`, `image_2`, ...) ; la limite de comptage dépend du modèle (voir remarques ci-dessous). Si une image connectée contient un lot d'images, chaque image du lot compte dans la limite. | IMAGE | Non | 0 à 10 (Seedream 5.0 Pro, Seedream 4.5, Seedream 4.0)
0 à 14 (Seedream 5.0 Lite) | + +**Remarques :** + +- Le `prompt` ne doit pas être vide après suppression des espaces. +- Nombre maximal d'images de référence : 10 pour Seedream 5.0 Pro, Seedream 4.5 et Seedream 4.0 ; 14 pour Seedream 5.0 Lite. +- Chaque image de référence doit avoir un rapport d'aspect compris entre 1:3 et 3:1. +- Lorsque `max_images` est supérieur à 1 (non disponible sur Seedream 5.0 Pro), le nombre total d'images de référence plus les images générées ne peut pas dépasser 15. +- `thinking` ne peut être désactivé que pour la génération texte-à-image. Lorsque des images de référence sont fournies, `thinking` doit être activé. +- `width` et `height` ne sont utilisés que lorsque `size_preset` est défini sur « Custom ». +- `prompt_optimization` n'est disponible que sur Seedream 5.0 Pro. +- `max_images` et `fail_on_partial` ne sont disponibles que sur Seedream 5.0 Lite, Seedream 4.5 et Seedream 4.0 ; Seedream 5.0 Pro demande toujours une seule image. +- Exigences de résolution (largeur x hauteur) : + - Seedream 5.0 Pro : entre 0,92 Mpx (921 600 pixels) et 4,19 Mpx (4 194 304 pixels). + - Seedream 5.0 Lite et Seedream 4.5 : au moins 3,68 Mpx (3 686 400 pixels). + - Seedream 4.0 : au moins 0,92 Mpx (921 600 pixels). + - Tous les modèles non Pro : au maximum 16,78 Mpx (16 777 216 pixels). + +## Sorties + +| Nom de sortie | Description | Type de données | +|---------------|-------------|-----------------| +| `image` | Le tenseur d'image généré. Lorsque plusieurs images sont générées, elles sont concaténées en un seul tenseur IMAGE par lot. | IMAGE | + +> Cette documentation a été générée par IA. Si vous trouvez des erreurs ou avez des suggestions d'amélioration, n'hésitez pas à contribuer ! [Modifier sur GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/fr.md) + +--- +**Source fingerprint (SHA-256):** `68dd23afdb5720491cef784b22ad66ff0baf80984ea652ea4c13e6c264c029ac` diff --git a/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/ja.md b/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/ja.md new file mode 100644 index 000000000..20402c836 --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/ja.md @@ -0,0 +1,96 @@ +# ByteDanceSeedreamNodeV3 + +ByteDance Seedream 4.5 & 5.0 は、テキストプロンプトからの画像生成(text-to-image)や、オプションの参照画像に基づく画像生成・編集を、ByteDance Seedream 4.0、4.5、5.0 モデルを使用して最大 4K 解像度で行います。このノードは、プロンプトと参照画像を ByteDance API に送信し、生成タスクの完了を待って、結果の画像テンソルを返します。 + +## 入力 + +### 共通入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `prompt` | 画像を作成または編集するためのテキストプロンプト。前後の空白を除去した後も空であってはなりません。 | STRING | はい | Multiline text | +| `model` | 使用する Seedream モデルを選択します。各モデルには、以下の独自のサブパラメータと制限があります。 | DYNAMIC_COMBO | はい | "seedream 5.0 pro"
"seedream 5.0 lite"
"seedream-4-5-251128"
"seedream-4-0-250828" | + +### Seedream 5.0 Pro 入力 (seedream 5.0 pro) + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | 推奨サイズを選択します。下の幅と高さを使用するには「Custom」を選択します。デフォルト: このモデルの最初の推奨プリセット。 | COMBO | いいえ | Model-specific recommended size presets
"Custom" | +| `width` | 画像のカスタム幅。この値は `size_preset` が `Custom` に設定されている場合にのみ有効です。デフォルト: 2048。 | INT | いいえ | 1024 to 3136 (step 2) | +| `height` | 画像のカスタム高さ。この値は `size_preset` が `Custom` に設定されている場合にのみ有効です。デフォルト: 2048。 | INT | いいえ | 1024 to 2496 (step 2) | +| `prompt_optimization` | 参照画像が提供された場合のプロンプト最適化モード。「standard」は高品質、「fast」は短い生成時間になります。デフォルト: "standard"。 | COMBO | いいえ | "standard"
"fast" | +| `seed` | 生成に使用するシード。デフォルト: 42。 | INT | いいえ | 0 to 2147483647 | +| `watermark` | 画像に「AI生成」の透かしを追加するかどうか。デフォルト: false。 | BOOLEAN | いいえ | true / false | +| `thinking` | モデルのプロンプト最適化推論('thinking')を有効にして、プロンプトへの適合性を高めます。生成時間が大幅に増加する可能性があります(特に Seedream 5.0 Pro)。テキストから画像を生成する場合にのみ無効にできます(参照画像が提供されている場合は無効にできません)。デフォルト: true。 | BOOLEAN | いいえ | true / false | + +### Seedream 5.0 Lite 入力 (seedream 5.0 lite) + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | 推奨サイズを選択します。下の幅と高さを使用するには「Custom」を選択します。デフォルト: このモデルの最初の推奨プリセット。 | COMBO | いいえ | Model-specific recommended size presets
"Custom" | +| `width` | 画像のカスタム幅。この値は `size_preset` が `Custom` に設定されている場合にのみ有効です。デフォルト: 2048。 | INT | いいえ | 1024 to 6240 (step 2) | +| `height` | 画像のカスタム高さ。この値は `size_preset` が `Custom` に設定されている場合にのみ有効です。デフォルト: 2048。 | INT | いいえ | 1024 to 4992 (step 2) | +| `max_images` | 生成する画像の最大数。1 の場合は正確に 1 枚の画像が生成されます。1 より大きい場合は、モデルは 1 枚から max_images 枚までの関連画像(例: ストーリーシーン、キャラクターのバリエーション)を生成します。画像の合計(入力 + 生成)は 15 を超えることはできません。デフォルト: 1。 | INT | いいえ | 1 to 14 | +| `fail_on_partial` | 有効にすると、要求された画像のいずれかが欠落している場合やエラーが返された場合に実行を中止します。デフォルト: false。 | BOOLEAN | いいえ | true / false | +| `seed` | 生成に使用するシード。デフォルト: 42。 | INT | いいえ | 0 to 2147483647 | +| `watermark` | 画像に「AI生成」の透かしを追加するかどうか。デフォルト: false。 | BOOLEAN | いいえ | true / false | +| `thinking` | モデルのプロンプト最適化推論('thinking')を有効にして、プロンプトへの適合性を高めます。生成時間が大幅に増加する可能性があります(特に Seedream 5.0 Pro)。テキストから画像を生成する場合にのみ無効にできます(参照画像が提供されている場合は無効にできません)。デフォルト: true。 | BOOLEAN | いいえ | true / false | + +### Seedream 4.5 入力 (seedream-4-5-251128) + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | 推奨サイズを選択します。下の幅と高さを使用するには「Custom」を選択します。デフォルト: このモデルの最初の推奨プリセット。 | COMBO | いいえ | Model-specific recommended size presets
"Custom" | +| `width` | 画像のカスタム幅。この値は `size_preset` が `Custom` に設定されている場合にのみ有効です。デフォルト: 2048。 | INT | いいえ | 1024 to 6240 (step 2) | +| `height` | 画像のカスタム高さ。この値は `size_preset` が `Custom` に設定されている場合にのみ有効です。デフォルト: 2048。 | INT | いいえ | 1024 to 4992 (step 2) | +| `max_images` | 生成する画像の最大数。1 の場合は正確に 1 枚の画像が生成されます。1 より大きい場合は、モデルは 1 枚から max_images 枚までの関連画像(例: ストーリーシーン、キャラクターのバリエーション)を生成します。画像の合計(入力 + 生成)は 15 を超えることはできません。デフォルト: 1。 | INT | いいえ | 1 to 10 | +| `fail_on_partial` | 有効にすると、要求された画像のいずれかが欠落している場合やエラーが返された場合に実行を中止します。デフォルト: false。 | BOOLEAN | いいえ | true / false | +| `seed` | 生成に使用するシード。デフォルト: 42。 | INT | いいえ | 0 to 2147483647 | +| `watermark` | 画像に「AI生成」の透かしを追加するかどうか。デフォルト: false。 | BOOLEAN | いいえ | true / false | +| `thinking` | モデルのプロンプト最適化推論('thinking')を有効にして、プロンプトへの適合性を高めます。生成時間が大幅に増加する可能性があります(特に Seedream 5.0 Pro)。テキストから画像を生成する場合にのみ無効にできます(参照画像が提供されている場合は無効にできません)。デフォルト: true。 | BOOLEAN | いいえ | true / false | + +### Seedream 4.0 入力 (seedream-4-0-250828) + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | 推奨サイズを選択します。下の幅と高さを使用するには「Custom」を選択します。デフォルト: このモデルの最初の推奨プリセット。 | COMBO | いいえ | Model-specific recommended size presets
"Custom" | +| `width` | 画像のカスタム幅。この値は `size_preset` が `Custom` に設定されている場合にのみ有効です。デフォルト: 2048。 | INT | いいえ | 1024 to 6240 (step 2) | +| `height` | 画像のカスタム高さ。この値は `size_preset` が `Custom` に設定されている場合にのみ有効です。デフォルト: 2048。 | INT | いいえ | 1024 to 4992 (step 2) | +| `max_images` | 生成する画像の最大数。1 の場合は正確に 1 枚の画像が生成されます。1 より大きい場合は、モデルは 1 枚から max_images 枚までの関連画像(例: ストーリーシーン、キャラクターのバリエーション)を生成します。画像の合計(入力 + 生成)は 15 を超えることはできません。デフォルト: 1。 | INT | いいえ | 1 to 10 | +| `fail_on_partial` | 有効にすると、要求された画像のいずれかが欠落している場合やエラーが返された場合に実行を中止します。デフォルト: false。 | BOOLEAN | いいえ | true / false | +| `seed` | 生成に使用するシード。デフォルト: 42。 | INT | いいえ | 0 to 2147483647 | +| `watermark` | 画像に「AI生成」の透かしを追加するかどうか。デフォルト: false。 | BOOLEAN | いいえ | true / false | +| `thinking` | モデルのプロンプト最適化推論('thinking')を有効にして、プロンプトへの適合性を高めます。生成時間が大幅に増加する可能性があります(特に Seedream 5.0 Pro)。テキストから画像を生成する場合にのみ無効にできます(参照画像が提供されている場合は無効にできません)。デフォルト: true。 | BOOLEAN | いいえ | true / false | + +### 参照入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `images` | 拡張可能スロット: 画像間変換(image-to-image)または複数参照生成用のオプションの参照画像。1..N 枚の画像を接続します(例: `image_1`、`image_2`、...)。枚数の上限はモデルごとに異なります(下記の注記を参照)。接続した画像が画像のバッチを含む場合、そのバッチ内のすべての画像が上限にカウントされます。 | IMAGE | いいえ | 0 to 10 (Seedream 5.0 Pro, Seedream 4.5, Seedream 4.0)
0 to 14 (Seedream 5.0 Lite) | + +**注記:** + +- `prompt` は、前後の空白を除去した後も空であってはなりません。 +- 参照画像の最大数: Seedream 5.0 Pro、Seedream 4.5、Seedream 4.0 では 10、Seedream 5.0 Lite では 14。 +- 各参照画像のアスペクト比は 1:3 から 3:1 の間である必要があります。 +- `max_images` が 1 より大きい場合(Seedream 5.0 Pro では使用不可)、参照画像と生成画像の合計は 15 を超えることはできません。 +- `thinking` は、テキストから画像を生成する場合にのみ無効にできます。参照画像が提供されている場合、`thinking` は有効である必要があります。 +- `width` と `height` は、`size_preset` が "Custom" に設定されている場合にのみ使用されます。 +- `prompt_optimization` は Seedream 5.0 Pro でのみ使用できます。 +- `max_images` と `fail_on_partial` は Seedream 5.0 Lite、Seedream 4.5、Seedream 4.0 でのみ使用できます。Seedream 5.0 Pro は常に単一の画像を要求します。 +- 解像度の要件(幅 × 高さ): + - Seedream 5.0 Pro: 0.92MP(921,600 ピクセル)から 4.19MP(4,194,304 ピクセル)の間。 + - Seedream 5.0 Lite と Seedream 4.5: 最低 3.68MP(3,686,400 ピクセル)。 + - Seedream 4.0: 最低 0.92MP(921,600 ピクセル)。 + - Pro 以外のすべてのモデル: 最大 16.78MP(16,777,216 ピクセル)。 + +## 出力 + +| 出力名 | 説明 | データ型 | +|-------------|-------------|-----------| +| `image` | 生成された画像テンソル。複数の画像が生成された場合、単一のバッチ化された IMAGE テンソルに連結されます。 | IMAGE | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/ja.md) + +--- +**Source fingerprint (SHA-256):** `68dd23afdb5720491cef784b22ad66ff0baf80984ea652ea4c13e6c264c029ac` diff --git a/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/ko.md b/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/ko.md new file mode 100644 index 000000000..531cf88e5 --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/ko.md @@ -0,0 +1,96 @@ +# ByteDanceSeedreamNodeV3 + +ByteDance Seedream 4.5 & 5.0은 텍스트 프롬프트에서 이미지를 생성하거나(텍스트-이미지), 선택적 참조 이미지를 활용하여 이미지를 생성/편집합니다. ByteDance Seedream 4.0, 4.5 및 5.0 모델을 사용하며 최대 4K 해상도를 지원합니다. 이 노드는 프롬프트와 참조 이미지를 ByteDance API로 전송하고, 생성 작업이 완료될 때까지 대기한 후 결과 이미지 텐서(들)을 반환합니다. + +## 입력 + +### 공통 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `prompt` | 이미지를 생성하거나 편집하기 위한 텍스트 프롬프트입니다. 앞뒤 공백을 제거한 후 비어 있지 않아야 합니다. | STRING | 예 | 여러 줄 텍스트 | +| `model` | 사용할 Seedream 모델을 선택합니다. 각 모델은 아래에 고유한 하위 매개변수 및 제한 사항을 제공합니다. | DYNAMIC_COMBO | 예 | "seedream 5.0 pro"
"seedream 5.0 lite"
"seedream-4-5-251128"
"seedream-4-0-250828" | + +### Seedream 5.0 Pro 입력 (seedream 5.0 pro) + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | 권장 크기를 선택합니다. 아래의 width 및 height를 사용하려면 Custom을 선택하십시오. 기본값: 이 모델의 첫 번째 권장 프리셋. | COMBO | 아니오 | 모델별 권장 크기 프리셋
"Custom" | +| `width` | 이미지의 사용자 지정 너비입니다. 이 값은 `size_preset`이 `Custom`으로 설정된 경우에만 적용됩니다. 기본값: 2048. | INT | 아니오 | 1024 to 3136 (간격 2) | +| `height` | 이미지의 사용자 지정 높이입니다. 이 값은 `size_preset`이 `Custom`으로 설정된 경우에만 적용됩니다. 기본값: 2048. | INT | 아니오 | 1024 to 2496 (간격 2) | +| `prompt_optimization` | 참조 이미지가 제공될 때의 프롬프트 최적화 모드입니다. 'standard'는 더 높은 품질을, 'fast'는 더 짧은 생성 시간을 제공합니다. 기본값: "standard". | COMBO | 아니오 | "standard"
"fast" | +| `seed` | 생성에 사용할 시드입니다. 기본값: 42. | INT | 아니오 | 0 to 2147483647 | +| `watermark` | 이미지에 "AI generated" 워터마크를 추가할지 여부입니다. 기본값: false. | BOOLEAN | 아니오 | true / false | +| `thinking` | 모델의 프롬프트 최적화 추론('thinking')을 활성화하여 프롬프트 준수도를 높입니다. 생성 시간이 크게 늘어날 수 있으며, 특히 Seedream 5.0 Pro에서 두드러집니다. 텍스트-이미지 생성에서만 비활성화할 수 있습니다(참조 이미지가 제공되는 경우에는 비활성화할 수 없음). 기본값: true. | BOOLEAN | 아니오 | true / false | + +### Seedream 5.0 Lite 입력 (seedream 5.0 lite) + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | 권장 크기를 선택합니다. 아래의 width 및 height를 사용하려면 Custom을 선택하십시오. 기본값: 이 모델의 첫 번째 권장 프리셋. | COMBO | 아니오 | 모델별 권장 크기 프리셋
"Custom" | +| `width` | 이미지의 사용자 지정 너비입니다. 이 값은 `size_preset`이 `Custom`으로 설정된 경우에만 적용됩니다. 기본값: 2048. | INT | 아니오 | 1024 to 6240 (간격 2) | +| `height` | 이미지의 사용자 지정 높이입니다. 이 값은 `size_preset`이 `Custom`으로 설정된 경우에만 적용됩니다. 기본값: 2048. | INT | 아니오 | 1024 to 4992 (간격 2) | +| `max_images` | 생성할 최대 이미지 수입니다. 1로 설정하면 정확히 하나의 이미지가 생성됩니다. 1보다 크게 설정하면 모델은 1~max_images개의 관련 이미지(예: 스토리 장면, 캐릭터 변형)를 생성합니다. 총 이미지 수(입력 + 생성)는 15개를 초과할 수 없습니다. 기본값: 1. | INT | 아니오 | 1 to 14 | +| `fail_on_partial` | 활성화하면 요청한 이미지 중 일부가 누락되거나 오류가 반환되는 경우 실행을 중단합니다. 기본값: false. | BOOLEAN | 아니오 | true / false | +| `seed` | 생성에 사용할 시드입니다. 기본값: 42. | INT | 아니오 | 0 to 2147483647 | +| `watermark` | 이미지에 "AI generated" 워터마크를 추가할지 여부입니다. 기본값: false. | BOOLEAN | 아니오 | true / false | +| `thinking` | 모델의 프롬프트 최적화 추론('thinking')을 활성화하여 프롬프트 준수도를 높입니다. 생성 시간이 크게 늘어날 수 있으며, 특히 Seedream 5.0 Pro에서 두드러집니다. 텍스트-이미지 생성에서만 비활성화할 수 있습니다(참조 이미지가 제공되는 경우에는 비활성화할 수 없음). 기본값: true. | BOOLEAN | 아니오 | true / false | + +### Seedream 4.5 입력 (seedream-4-5-251128) + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | 권장 크기를 선택합니다. 아래의 width 및 height를 사용하려면 Custom을 선택하십시오. 기본값: 이 모델의 첫 번째 권장 프리셋. | COMBO | 아니오 | 모델별 권장 크기 프리셋
"Custom" | +| `width` | 이미지의 사용자 지정 너비입니다. 이 값은 `size_preset`이 `Custom`으로 설정된 경우에만 적용됩니다. 기본값: 2048. | INT | 아니오 | 1024 to 6240 (간격 2) | +| `height` | 이미지의 사용자 지정 높이입니다. 이 값은 `size_preset`이 `Custom`으로 설정된 경우에만 적용됩니다. 기본값: 2048. | INT | 아니오 | 1024 to 4992 (간격 2) | +| `max_images` | 생성할 최대 이미지 수입니다. 1로 설정하면 정확히 하나의 이미지가 생성됩니다. 1보다 크게 설정하면 모델은 1~max_images개의 관련 이미지(예: 스토리 장면, 캐릭터 변형)를 생성합니다. 총 이미지 수(입력 + 생성)는 15개를 초과할 수 없습니다. 기본값: 1. | INT | 아니오 | 1 to 10 | +| `fail_on_partial` | 활성화하면 요청한 이미지 중 일부가 누락되거나 오류가 반환되는 경우 실행을 중단합니다. 기본값: false. | BOOLEAN | 아니오 | true / false | +| `seed` | 생성에 사용할 시드입니다. 기본값: 42. | INT | 아니오 | 0 to 2147483647 | +| `watermark` | 이미지에 "AI generated" 워터마크를 추가할지 여부입니다. 기본값: false. | BOOLEAN | 아니오 | true / false | +| `thinking` | 모델의 프롬프트 최적화 추론('thinking')을 활성화하여 프롬프트 준수도를 높입니다. 생성 시간이 크게 늘어날 수 있으며, 특히 Seedream 5.0 Pro에서 두드러집니다. 텍스트-이미지 생성에서만 비활성화할 수 있습니다(참조 이미지가 제공되는 경우에는 비활성화할 수 없음). 기본값: true. | BOOLEAN | 아니오 | true / false | + +### Seedream 4.0 입력 (seedream-4-0-250828) + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | 권장 크기를 선택합니다. 아래의 width 및 height를 사용하려면 Custom을 선택하십시오. 기본값: 이 모델의 첫 번째 권장 프리셋. | COMBO | 아니오 | 모델별 권장 크기 프리셋
"Custom" | +| `width` | 이미지의 사용자 지정 너비입니다. 이 값은 `size_preset`이 `Custom`으로 설정된 경우에만 적용됩니다. 기본값: 2048. | INT | 아니오 | 1024 to 6240 (간격 2) | +| `height` | 이미지의 사용자 지정 높이입니다. 이 값은 `size_preset`이 `Custom`으로 설정된 경우에만 적용됩니다. 기본값: 2048. | INT | 아니오 | 1024 to 4992 (간격 2) | +| `max_images` | 생성할 최대 이미지 수입니다. 1로 설정하면 정확히 하나의 이미지가 생성됩니다. 1보다 크게 설정하면 모델은 1~max_images개의 관련 이미지(예: 스토리 장면, 캐릭터 변형)를 생성합니다. 총 이미지 수(입력 + 생성)는 15개를 초과할 수 없습니다. 기본값: 1. | INT | 아니오 | 1 to 10 | +| `fail_on_partial` | 활성화하면 요청한 이미지 중 일부가 누락되거나 오류가 반환되는 경우 실행을 중단합니다. 기본값: false. | BOOLEAN | 아니오 | true / false | +| `seed` | 생성에 사용할 시드입니다. 기본값: 42. | INT | 아니오 | 0 to 2147483647 | +| `watermark` | 이미지에 "AI generated" 워터마크를 추가할지 여부입니다. 기본값: false. | BOOLEAN | 아니오 | true / false | +| `thinking` | 모델의 프롬프트 최적화 추론('thinking')을 활성화하여 프롬프트 준수도를 높입니다. 생성 시간이 크게 늘어날 수 있으며, 특히 Seedream 5.0 Pro에서 두드러집니다. 텍스트-이미지 생성에서만 비활성화할 수 있습니다(참조 이미지가 제공되는 경우에는 비활성화할 수 없음). 기본값: true. | BOOLEAN | 아니오 | true / false | + +### 참조 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `images` | 확장 가능한 슬롯: 이미지-이미지 또는 다중 참조 생성을 위한 선택적 참조 이미지입니다. 1..N개의 이미지(예: `image_1`, `image_2`, ...)를 연결할 수 있습니다. 제한 개수는 모델별로 다릅니다(아래 참고 참조). 연결된 이미지에 여러 이미지가 포함된 배치가 있으면 배치의 모든 이미지가 제한 개수에 포함됩니다. | IMAGE | 아니오 | 0 to 10 (Seedream 5.0 Pro, Seedream 4.5, Seedream 4.0)
0 to 14 (Seedream 5.0 Lite) | + +**참고 사항:** + +- `prompt`는 앞뒤 공백을 제거한 후 비어 있지 않아야 합니다. +- 참조 이미지 최대 개수: Seedream 5.0 Pro, Seedream 4.5 및 Seedream 4.0은 10개, Seedream 5.0 Lite는 14개입니다. +- 각 참조 이미지의 종횡비는 1:3에서 3:1 사이여야 합니다. +- `max_images`가 1보다 큰 경우(Seedream 5.0 Pro에서는 사용 불가) 참조 이미지와 생성 이미지의 총 개수는 15개를 초과할 수 없습니다. +- `thinking`은 텍스트-이미지 생성에서만 비활성화할 수 있습니다. 참조 이미지가 제공되는 경우 `thinking`을 활성화해야 합니다. +- `width` 및 `height`는 `size_preset`이 "Custom"으로 설정된 경우에만 사용됩니다. +- `prompt_optimization`은 Seedream 5.0 Pro에서만 사용할 수 있습니다. +- `max_images`와 `fail_on_partial`은 Seedream 5.0 Lite, Seedream 4.5 및 Seedream 4.0에서만 사용할 수 있습니다. Seedream 5.0 Pro는 항상 단일 이미지를 요청합니다. +- 해상도 요구 사항(너비 x 높이): + - Seedream 5.0 Pro: 0.92MP(921,600픽셀) ~ 4.19MP(4,194,304픽셀) 사이. + - Seedream 5.0 Lite 및 Seedream 4.5: 최소 3.68MP(3,686,400픽셀). + - Seedream 4.0: 최소 0.92MP(921,600픽셀). + - Pro가 아닌 모든 모델: 최대 16.78MP(16,777,216픽셀). + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `image` | 생성된 이미지 텐서입니다. 여러 이미지가 생성되면 단일 배치 IMAGE 텐서로 연결됩니다. | IMAGE | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/ko.md) + +--- +**Source fingerprint (SHA-256):** `68dd23afdb5720491cef784b22ad66ff0baf80984ea652ea4c13e6c264c029ac` diff --git a/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/pt-BR.md b/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/pt-BR.md new file mode 100644 index 000000000..c02e66cc4 --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/pt-BR.md @@ -0,0 +1,96 @@ +# ByteDanceSeedreamNodeV3 + +O ByteDance Seedream 4.5 & 5.0 gera imagens a partir de um prompt de texto (texto para imagem) ou gera/edita imagens guiadas por imagens de referência opcionais, usando os modelos ByteDance Seedream 4.0, 4.5 e 5.0 em resolução de até 4K. O nó envia o prompt e quaisquer imagens de referência para a API da ByteDance, aguarda a conclusão da tarefa de geração e retorna o tensor ou os tensores de imagem resultantes. + +## Entradas + +### Entradas Comuns + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Faixa | +|-----------|-------------|-----------|----------|-------| +| `prompt` | Prompt de texto para criar ou editar uma imagem. Não pode ficar vazio após a remoção de espaços em branco. | STRING | Sim | Texto de múltiplas linhas | +| `model` | Seleciona o modelo Seedream a ser usado. Cada modelo expõe seu próprio conjunto de subparâmetros e limites nas seções abaixo. | DYNAMIC_COMBO | Sim | "seedream 5.0 pro"
"seedream 5.0 lite"
"seedream-4-5-251128"
"seedream-4-0-250828" | + +### Entradas do Seedream 5.0 Pro (seedream 5.0 pro) + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Faixa | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | Escolha um tamanho recomendado. Selecione Custom para usar a largura e a altura abaixo. Padrão: primeira predefinição recomendada para este modelo. | COMBO | Não | Predefinições de tamanho recomendadas específicas do modelo
"Custom" | +| `width` | Largura personalizada da imagem. O valor só é aplicado se `size_preset` estiver definido como `Custom`. Padrão: 2048. | INT | Não | 1024 a 3136 (passo 2) | +| `height` | Altura personalizada da imagem. O valor só é aplicado se `size_preset` estiver definido como `Custom`. Padrão: 2048. | INT | Não | 1024 a 2496 (passo 2) | +| `prompt_optimization` | Modo de otimização do prompt quando imagens de referência são fornecidas: 'standard' oferece maior qualidade, 'fast' menor tempo de geração. Padrão: "standard". | COMBO | Não | "standard"
"fast" | +| `seed` | Semente a ser usada na geração. Padrão: 42. | INT | Não | 0 a 2147483647 | +| `watermark` | Se deve adicionar uma marca d'água "gerado por IA" à imagem. Padrão: false. | BOOLEAN | Não | true / false | +| `thinking` | Ativa o raciocínio de otimização do prompt do modelo ('thinking') para melhor aderência. Pode aumentar substancialmente o tempo de geração — especialmente no Seedream 5.0 Pro. Só pode ser desativado para geração de texto para imagem (não quando imagens de referência são fornecidas). Padrão: true. | BOOLEAN | Não | true / false | + +### Entradas do Seedream 5.0 Lite (seedream 5.0 lite) + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Faixa | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | Escolha um tamanho recomendado. Selecione Custom para usar a largura e a altura abaixo. Padrão: primeira predefinição recomendada para este modelo. | COMBO | Não | Predefinições de tamanho recomendadas específicas do modelo
"Custom" | +| `width` | Largura personalizada da imagem. O valor só é aplicado se `size_preset` estiver definido como `Custom`. Padrão: 2048. | INT | Não | 1024 a 6240 (passo 2) | +| `height` | Altura personalizada da imagem. O valor só é aplicado se `size_preset` estiver definido como `Custom`. Padrão: 2048. | INT | Não | 1024 a 4992 (passo 2) | +| `max_images` | Número máximo de imagens a gerar. Com 1, exatamente uma imagem é produzida. Com mais de 1, o modelo gera entre 1 e max_images imagens relacionadas (ex.: cenas de história, variações de personagem). O total de imagens (entrada + geradas) não pode exceder 15. Padrão: 1. | INT | Não | 1 a 14 | +| `fail_on_partial` | Se ativado, aborta a execução se alguma imagem solicitada estiver ausente ou retornar erro. Padrão: false. | BOOLEAN | Não | true / false | +| `seed` | Semente a ser usada na geração. Padrão: 42. | INT | Não | 0 a 2147483647 | +| `watermark` | Se deve adicionar uma marca d'água "gerado por IA" à imagem. Padrão: false. | BOOLEAN | Não | true / false | +| `thinking` | Ativa o raciocínio de otimização do prompt do modelo ('thinking') para melhor aderência. Pode aumentar substancialmente o tempo de geração — especialmente no Seedream 5.0 Pro. Só pode ser desativado para geração de texto para imagem (não quando imagens de referência são fornecidas). Padrão: true. | BOOLEAN | Não | true / false | + +### Entradas do Seedream 4.5 (seedream-4-5-251128) + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Faixa | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | Escolha um tamanho recomendado. Selecione Custom para usar a largura e a altura abaixo. Padrão: primeira predefinição recomendada para este modelo. | COMBO | Não | Predefinições de tamanho recomendadas específicas do modelo
"Custom" | +| `width` | Largura personalizada da imagem. O valor só é aplicado se `size_preset` estiver definido como `Custom`. Padrão: 2048. | INT | Não | 1024 a 6240 (passo 2) | +| `height` | Altura personalizada da imagem. O valor só é aplicado se `size_preset` estiver definido como `Custom`. Padrão: 2048. | INT | Não | 1024 a 4992 (passo 2) | +| `max_images` | Número máximo de imagens a gerar. Com 1, exatamente uma imagem é produzida. Com mais de 1, o modelo gera entre 1 e max_images imagens relacionadas (ex.: cenas de história, variações de personagem). O total de imagens (entrada + geradas) não pode exceder 15. Padrão: 1. | INT | Não | 1 a 10 | +| `fail_on_partial` | Se ativado, aborta a execução se alguma imagem solicitada estiver ausente ou retornar erro. Padrão: false. | BOOLEAN | Não | true / false | +| `seed` | Semente a ser usada na geração. Padrão: 42. | INT | Não | 0 a 2147483647 | +| `watermark` | Se deve adicionar uma marca d'água "gerado por IA" à imagem. Padrão: false. | BOOLEAN | Não | true / false | +| `thinking` | Ativa o raciocínio de otimização do prompt do modelo ('thinking') para melhor aderência. Pode aumentar substancialmente o tempo de geração — especialmente no Seedream 5.0 Pro. Só pode ser desativado para geração de texto para imagem (não quando imagens de referência são fornecidas). Padrão: true. | BOOLEAN | Não | true / false | + +### Entradas do Seedream 4.0 (seedream-4-0-250828) + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Faixa | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | Escolha um tamanho recomendado. Selecione Custom para usar a largura e a altura abaixo. Padrão: primeira predefinição recomendada para este modelo. | COMBO | Não | Predefinições de tamanho recomendadas específicas do modelo
"Custom" | +| `width` | Largura personalizada da imagem. O valor só é aplicado se `size_preset` estiver definido como `Custom`. Padrão: 2048. | INT | Não | 1024 a 6240 (passo 2) | +| `height` | Altura personalizada da imagem. O valor só é aplicado se `size_preset` estiver definido como `Custom`. Padrão: 2048. | INT | Não | 1024 a 4992 (passo 2) | +| `max_images` | Número máximo de imagens a gerar. Com 1, exatamente uma imagem é produzida. Com mais de 1, o modelo gera entre 1 e max_images imagens relacionadas (ex.: cenas de história, variações de personagem). O total de imagens (entrada + geradas) não pode exceder 15. Padrão: 1. | INT | Não | 1 a 10 | +| `fail_on_partial` | Se ativado, aborta a execução se alguma imagem solicitada estiver ausente ou retornar erro. Padrão: false. | BOOLEAN | Não | true / false | +| `seed` | Semente a ser usada na geração. Padrão: 42. | INT | Não | 0 a 2147483647 | +| `watermark` | Se deve adicionar uma marca d'água "gerado por IA" à imagem. Padrão: false. | BOOLEAN | Não | true / false | +| `thinking` | Ativa o raciocínio de otimização do prompt do modelo ('thinking') para melhor aderência. Pode aumentar substancialmente o tempo de geração — especialmente no Seedream 5.0 Pro. Só pode ser desativado para geração de texto para imagem (não quando imagens de referência são fornecidas). Padrão: true. | BOOLEAN | Não | true / false | + +### Entradas de Referência + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Faixa | +|-----------|-------------|-----------|----------|-------| +| `images` | Slot expansível: imagem(ns) de referência opcional(is) para geração de imagem para imagem ou com múltiplas referências. Conecte de 1 a N imagens (por exemplo, `image_1`, `image_2`, ...); o limite de contagem é por modelo (consulte as notas abaixo). Se uma imagem conectada contiver um lote de imagens, cada imagem do lote conta para o limite. | IMAGE | Não | 0 a 10 (Seedream 5.0 Pro, Seedream 4.5, Seedream 4.0)
0 a 14 (Seedream 5.0 Lite) | + +**Notas:** + +- O `prompt` não pode ficar vazio após a remoção de espaços em branco. +- Número máximo de imagens de referência: 10 para Seedream 5.0 Pro, Seedream 4.5 e Seedream 4.0; 14 para Seedream 5.0 Lite. +- Cada imagem de referência deve ter uma proporção de aspecto entre 1:3 e 3:1. +- Quando `max_images` for maior que 1 (não disponível no Seedream 5.0 Pro), o número total de imagens de referência mais as imagens geradas não pode exceder 15. +- `thinking` só pode ser desativado para geração de texto para imagem. Quando imagens de referência são fornecidas, `thinking` deve estar ativado. +- `width` e `height` são usados somente quando `size_preset` está definido como "Custom". +- `prompt_optimization` está disponível somente no Seedream 5.0 Pro. +- `max_images` e `fail_on_partial` estão disponíveis somente no Seedream 5.0 Lite, Seedream 4.5 e Seedream 4.0; o Seedream 5.0 Pro sempre solicita uma única imagem. +- Requisitos de resolução (largura x altura): + - Seedream 5.0 Pro: entre 0,92 MP (921.600 pixels) e 4,19 MP (4.194.304 pixels). + - Seedream 5.0 Lite e Seedream 4.5: pelo menos 3,68 MP (3.686.400 pixels). + - Seedream 4.0: pelo menos 0,92 MP (921.600 pixels). + - Todos os modelos não Pro: no máximo 16,78 MP (16.777.216 pixels). + +## Saídas + +| Nome da Saída | Descrição | Tipo de Dados | +|-------------|-------------|-----------| +| `image` | O tensor de imagem gerado. Quando várias imagens são geradas, elas são concatenadas em um único tensor IMAGE em lote. | IMAGE | + +> Esta documentação foi gerada por IA. Se você encontrar erros ou tiver sugestões de melhoria, sinta-se à vontade para contribuir! [Editar no GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/pt-BR.md) + +--- +**Source fingerprint (SHA-256):** `68dd23afdb5720491cef784b22ad66ff0baf80984ea652ea4c13e6c264c029ac` diff --git a/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/ru.md b/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/ru.md new file mode 100644 index 000000000..e4d25edf0 --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/ru.md @@ -0,0 +1,96 @@ +# ByteDanceSeedreamNodeV3 + +ByteDance Seedream 4.5 и 5.0 создаёт изображения по текстовому запросу (text-to-image) или создаёт/редактирует изображения с учётом необязательных референсных изображений, используя модели ByteDance Seedream 4.0, 4.5 и 5.0 с разрешением до 4K. Узел отправляет запрос и все референсные изображения в ByteDance API, ожидает завершения задачи генерации и возвращает итоговый тензор или тензоры изображения. + +## Входные параметры + +### Общие входные параметры + +| Параметр | Описание | Тип данных | Обязательность | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `prompt` | Текстовый запрос для создания или редактирования изображения. Не должен быть пустым после обрезки пробелов по краям. | STRING | Да | Многострочный текст | +| `model` | Выбирает используемую модель Seedream. Каждая модель имеет собственный набор подпараметров и ограничений, указанных ниже. | DYNAMIC_COMBO | Да | "seedream 5.0 pro"
"seedream 5.0 lite"
"seedream-4-5-251128"
"seedream-4-0-250828" | + +### Входные параметры Seedream 5.0 Pro (seedream 5.0 pro) + +| Параметр | Описание | Тип данных | Обязательность | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | Выберите рекомендуемый размер. Выберите Custom, чтобы использовать указанные ниже значения `width` и `height`. По умолчанию: первый рекомендуемый пресет для этой модели. | COMBO | Нет | Рекомендуемые пресеты размеров для данной модели
«Custom» | +| `width` | Произвольная ширина изображения. Значение используется только если `size_preset` установлен в `Custom`. По умолчанию: 2048. | INT | Нет | от 1024 до 3136 (шаг 2) | +| `height` | Произвольная высота изображения. Значение используется только если `size_preset` установлен в `Custom`. По умолчанию: 2048. | INT | Нет | от 1024 до 2496 (шаг 2) | +| `prompt_optimization` | Режим оптимизации запроса при наличии референсных изображений: 'standard' даёт более высокое качество, 'fast' — меньшее время генерации. По умолчанию: "standard". | COMBO | Нет | "standard"
"fast" | +| `seed` | Сид для генерации. По умолчанию: 42. | INT | Нет | от 0 до 2147483647 | +| `watermark` | Определяет, нужно ли добавлять на изображение водяной знак «AI generated». По умолчанию: false. | BOOLEAN | Нет | true / false | +| `thinking` | Включает механизм рассуждений модели для оптимизации запроса («thinking»), обеспечивающий лучшее соответствие запросу. Может существенно увеличить время генерации — особенно на Seedream 5.0 Pro. Его можно отключить только для генерации text-to-image (не при наличии референсных изображений). По умолчанию: true. | BOOLEAN | Нет | true / false | + +### Входные параметры Seedream 5.0 Lite (seedream 5.0 lite) + +| Параметр | Описание | Тип данных | Обязательность | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | Выберите рекомендуемый размер. Выберите Custom, чтобы использовать указанные ниже значения `width` и `height`. По умолчанию: первый рекомендуемый пресет для этой модели. | COMBO | Нет | Рекомендуемые пресеты размеров для данной модели
«Custom» | +| `width` | Произвольная ширина изображения. Значение используется только если `size_preset` установлен в `Custom`. По умолчанию: 2048. | INT | Нет | от 1024 до 6240 (шаг 2) | +| `height` | Произвольная высота изображения. Значение используется только если `size_preset` установлен в `Custom`. По умолчанию: 2048. | INT | Нет | от 1024 до 4992 (шаг 2) | +| `max_images` | Максимальное количество изображений для генерации. При значении 1 создаётся ровно одно изображение. При значении >1 модель генерирует от 1 до max_images связанных изображений (например, сюжетные сцены, вариации персонажей). Общее количество изображений (входные + сгенерированные) не может превышать 15. По умолчанию: 1. | INT | Нет | от 1 до 14 | +| `fail_on_partial` | Если включено, выполнение прерывается при отсутствии каких-либо запрошенных изображений или при возврате ошибки. По умолчанию: false. | BOOLEAN | Нет | true / false | +| `seed` | Сид для генерации. По умолчанию: 42. | INT | Нет | от 0 до 2147483647 | +| `watermark` | Определяет, нужно ли добавлять на изображение водяной знак «AI generated». По умолчанию: false. | BOOLEAN | Нет | true / false | +| `thinking` | Включает механизм рассуждений модели для оптимизации запроса («thinking»), обеспечивающий лучшее соответствие запросу. Может существенно увеличить время генерации — особенно на Seedream 5.0 Pro. Его можно отключить только для генерации text-to-image (не при наличии референсных изображений). По умолчанию: true. | BOOLEAN | Нет | true / false | + +### Входные параметры Seedream 4.5 (seedream-4-5-251128) + +| Параметр | Описание | Тип данных | Обязательность | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | Выберите рекомендуемый размер. Выберите Custom, чтобы использовать указанные ниже значения `width` и `height`. По умолчанию: первый рекомендуемый пресет для этой модели. | COMBO | Нет | Рекомендуемые пресеты размеров для данной модели
«Custom» | +| `width` | Произвольная ширина изображения. Значение используется только если `size_preset` установлен в `Custom`. По умолчанию: 2048. | INT | Нет | от 1024 до 6240 (шаг 2) | +| `height` | Произвольная высота изображения. Значение используется только если `size_preset` установлен в `Custom`. По умолчанию: 2048. | INT | Нет | от 1024 до 4992 (шаг 2) | +| `max_images` | Максимальное количество изображений для генерации. При значении 1 создаётся ровно одно изображение. При значении >1 модель генерирует от 1 до max_images связанных изображений (например, сюжетные сцены, вариации персонажей). Общее количество изображений (входные + сгенерированные) не может превышать 15. По умолчанию: 1. | INT | Нет | от 1 до 10 | +| `fail_on_partial` | Если включено, выполнение прерывается при отсутствии каких-либо запрошенных изображений или при возврате ошибки. По умолчанию: false. | BOOLEAN | Нет | true / false | +| `seed` | Сид для генерации. По умолчанию: 42. | INT | Нет | от 0 до 2147483647 | +| `watermark` | Определяет, нужно ли добавлять на изображение водяной знак «AI generated». По умолчанию: false. | BOOLEAN | Нет | true / false | +| `thinking` | Включает механизм рассуждений модели для оптимизации запроса («thinking»), обеспечивающий лучшее соответствие запросу. Может существенно увеличить время генерации — особенно на Seedream 5.0 Pro. Его можно отключить только для генерации text-to-image (не при наличии референсных изображений). По умолчанию: true. | BOOLEAN | Нет | true / false | + +### Входные параметры Seedream 4.0 (seedream-4-0-250828) + +| Параметр | Описание | Тип данных | Обязательность | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | Выберите рекомендуемый размер. Выберите Custom, чтобы использовать указанные ниже значения `width` и `height`. По умолчанию: первый рекомендуемый пресет для этой модели. | COMBO | Нет | Рекомендуемые пресеты размеров для данной модели
«Custom» | +| `width` | Произвольная ширина изображения. Значение используется только если `size_preset` установлен в `Custom`. По умолчанию: 2048. | INT | Нет | от 1024 до 6240 (шаг 2) | +| `height` | Произвольная высота изображения. Значение используется только если `size_preset` установлен в `Custom`. По умолчанию: 2048. | INT | Нет | от 1024 до 4992 (шаг 2) | +| `max_images` | Максимальное количество изображений для генерации. При значении 1 создаётся ровно одно изображение. При значении >1 модель генерирует от 1 до max_images связанных изображений (например, сюжетные сцены, вариации персонажей). Общее количество изображений (входные + сгенерированные) не может превышать 15. По умолчанию: 1. | INT | Нет | от 1 до 10 | +| `fail_on_partial` | Если включено, выполнение прерывается при отсутствии каких-либо запрошенных изображений или при возврате ошибки. По умолчанию: false. | BOOLEAN | Нет | true / false | +| `seed` | Сид для генерации. По умолчанию: 42. | INT | Нет | от 0 до 2147483647 | +| `watermark` | Определяет, нужно ли добавлять на изображение водяной знак «AI generated». По умолчанию: false. | BOOLEAN | Нет | true / false | +| `thinking` | Включает механизм рассуждений модели для оптимизации запроса («thinking»), обеспечивающий лучшее соответствие запросу. Может существенно увеличить время генерации — особенно на Seedream 5.0 Pro. Его можно отключить только для генерации text-to-image (не при наличии референсных изображений). По умолчанию: true. | BOOLEAN | Нет | true / false | + +### Входные параметры для референсных изображений + +| Параметр | Описание | Тип данных | Обязательность | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `images` | Расширяемый слот: необязательные референсные изображения для генерации image-to-image или с несколькими референсами. Подключите от 1 до N изображений (например, `image_1`, `image_2`, ...); ограничение количества зависит от модели (см. примечания ниже). Если подключённое изображение содержит пакет изображений, каждое изображение в пакете учитывается в лимите. | IMAGE | Нет | от 0 до 10 (Seedream 5.0 Pro, Seedream 4.5, Seedream 4.0)
от 0 до 14 (Seedream 5.0 Lite) | + +**Примечания:** + +- Параметр `prompt` не должен быть пустым после обрезки пробелов по краям. +- Максимальное количество референсных изображений: 10 для Seedream 5.0 Pro, Seedream 4.5 и Seedream 4.0; 14 для Seedream 5.0 Lite. +- Каждое референсное изображение должно иметь соотношение сторон от 1:3 до 3:1. +- Если `max_images` больше 1 (недоступно на Seedream 5.0 Pro), общее количество референсных и сгенерированных изображений не может превышать 15. +- Параметр `thinking` можно отключить только для генерации text-to-image. При наличии референсных изображений параметр `thinking` должен быть включён. +- Параметры `width` и `height` используются только когда `size_preset` установлен в «Custom». +- Параметр `prompt_optimization` доступен только на Seedream 5.0 Pro. +- Параметры `max_images` и `fail_on_partial` доступны только на Seedream 5.0 Lite, Seedream 4.5 и Seedream 4.0; Seedream 5.0 Pro всегда запрашивает одно изображение. +- Требования к разрешению (ширина x высота): + - Seedream 5.0 Pro: от 0.92MP (921,600 пикселей) до 4.19MP (4,194,304 пикселей). + - Seedream 5.0 Lite и Seedream 4.5: не менее 3.68MP (3,686,400 пикселей). + - Seedream 4.0: не менее 0.92MP (921,600 пикселей). + - Все модели, кроме Pro: не более 16.78MP (16,777,216 пикселей). + +## Выходные параметры + +| Имя выхода | Описание | Тип данных | +|-------------|-------------|-----------| +| `image` | Сгенерированный тензор изображения. При генерации нескольких изображений они объединяются в один пакетный тензор IMAGE. | IMAGE | + +> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/ru.md) + +--- +**Source fingerprint (SHA-256):** `68dd23afdb5720491cef784b22ad66ff0baf80984ea652ea4c13e6c264c029ac` diff --git a/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/tr.md b/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/tr.md new file mode 100644 index 000000000..b7ff99629 --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/tr.md @@ -0,0 +1,96 @@ +# ByteDanceSeedreamNodeV3 + +ByteDance Seedream 4.5 & 5.0; ByteDance Seedream 4.0, 4.5 ve 5.0 modellerini 4K çözünürlüğe kadar kullanarak, bir metin isteminden (metinden görüntüye) görüntü üretir veya isteğe bağlı referans görüntülerinin rehberliğinde görüntü üretir/düzenler. Düğüm, istemi ve varsa referans görüntülerini ByteDance API'sine gönderir, üretim görevinin tamamlanmasını bekler ve sonuçta oluşan görüntü tensörünü veya tensörlerini döndürür. + +## Girdiler + +### Genel Girdiler + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +|-----------|-------------|-----------|----------|-------| +| `prompt` | Görüntü oluşturma veya düzenleme için metin istemi. Baştaki ve sondaki boşluklar silindikten sonra boş olmamalıdır. | STRING | Evet | Multiline text | +| `model` | Kullanılacak Seedream modelini seçer. Her model, aşağıda kendi alt parametrelerini ve sınırlarını sunar. | DYNAMIC_COMBO | Evet | "seedream 5.0 pro"
"seedream 5.0 lite"
"seedream-4-5-251128"
"seedream-4-0-250828" | + +### Seedream 5.0 Pro Girdileri (seedream 5.0 pro) + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | Önerilen bir boyut seçin. Aşağıdaki genişlik ve yüksekliği kullanmak için Custom seçeneğini belirleyin. Varsayılan: bu model için önerilen ilk hazır ayar. | COMBO | Hayır | Model-specific recommended size presets
"Custom" | +| `width` | Görüntü için özel genişlik. Değer yalnızca `size_preset` "Custom" olarak ayarlandığında çalışır. Varsayılan: 2048. | INT | Hayır | 1024 to 3136 (step 2) | +| `height` | Görüntü için özel yükseklik. Değer yalnızca `size_preset` "Custom" olarak ayarlandığında çalışır. Varsayılan: 2048. | INT | Hayır | 1024 to 2496 (step 2) | +| `prompt_optimization` | Referans görüntüler sağlandığında istem iyileştirme modu: 'standard' daha yüksek kalite, 'fast' daha kısa üretim süresi sağlar. Varsayılan: "standard". | COMBO | Hayır | "standard"
"fast" | +| `seed` | Üretim için kullanılacak seed değeri. Varsayılan: 42. | INT | Hayır | 0 to 2147483647 | +| `watermark` | Görüntüye "AI generated" filigranı eklenip eklenmeyeceği. Varsayılan: false. | BOOLEAN | Hayır | true / false | +| `thinking` | Daha iyi uyum için modelin istem iyileştirme muhakemesini ('thinking') etkinleştirir. Üretim süresini önemli ölçüde artırabilir — özellikle Seedream 5.0 Pro'da. Yalnızca metinden görüntüye üretimde devre dışı bırakılabilir (referans görüntüler sağlandığında değil). Varsayılan: true. | BOOLEAN | Hayır | true / false | + +### Seedream 5.0 Lite Girdileri (seedream 5.0 lite) + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | Önerilen bir boyut seçin. Aşağıdaki genişlik ve yüksekliği kullanmak için Custom seçeneğini belirleyin. Varsayılan: bu model için önerilen ilk hazır ayar. | COMBO | Hayır | Model-specific recommended size presets
"Custom" | +| `width` | Görüntü için özel genişlik. Değer yalnızca `size_preset` "Custom" olarak ayarlandığında çalışır. Varsayılan: 2048. | INT | Hayır | 1024 to 6240 (step 2) | +| `height` | Görüntü için özel yükseklik. Değer yalnızca `size_preset` "Custom" olarak ayarlandığında çalışır. Varsayılan: 2048. | INT | Hayır | 1024 to 4992 (step 2) | +| `max_images` | Üretilecek maksimum görüntü sayısı. 1 ile tam olarak bir görüntü üretilir. >1 ile model, 1 ile max_images arasında ilişkili görüntü üretir (örn. hikaye sahneleri, karakter varyasyonları). Toplam görüntü (girdi + üretilen) 15'i aşamaz. Varsayılan: 1. | INT | Hayır | 1 to 14 | +| `fail_on_partial` | Etkinleştirilirse, istenen görüntülerden herhangi biri eksikse veya bir hata dönerse yürütmeyi durdurur. Varsayılan: false. | BOOLEAN | Hayır | true / false | +| `seed` | Üretim için kullanılacak seed değeri. Varsayılan: 42. | INT | Hayır | 0 to 2147483647 | +| `watermark` | Görüntüye "AI generated" filigranı eklenip eklenmeyeceği. Varsayılan: false. | BOOLEAN | Hayır | true / false | +| `thinking` | Daha iyi uyum için modelin istem iyileştirme muhakemesini ('thinking') etkinleştirir. Üretim süresini önemli ölçüde artırabilir — özellikle Seedream 5.0 Pro'da. Yalnızca metinden görüntüye üretimde devre dışı bırakılabilir (referans görüntüler sağlandığında değil). Varsayılan: true. | BOOLEAN | Hayır | true / false | + +### Seedream 4.5 Girdileri (seedream-4-5-251128) + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | Önerilen bir boyut seçin. Aşağıdaki genişlik ve yüksekliği kullanmak için Custom seçeneğini belirleyin. Varsayılan: bu model için önerilen ilk hazır ayar. | COMBO | Hayır | Model-specific recommended size presets
"Custom" | +| `width` | Görüntü için özel genişlik. Değer yalnızca `size_preset` "Custom" olarak ayarlandığında çalışır. Varsayılan: 2048. | INT | Hayır | 1024 to 6240 (step 2) | +| `height` | Görüntü için özel yükseklik. Değer yalnızca `size_preset` "Custom" olarak ayarlandığında çalışır. Varsayılan: 2048. | INT | Hayır | 1024 to 4992 (step 2) | +| `max_images` | Üretilecek maksimum görüntü sayısı. 1 ile tam olarak bir görüntü üretilir. >1 ile model, 1 ile max_images arasında ilişkili görüntü üretir (örn. hikaye sahneleri, karakter varyasyonları). Toplam görüntü (girdi + üretilen) 15'i aşamaz. Varsayılan: 1. | INT | Hayır | 1 to 10 | +| `fail_on_partial` | Etkinleştirilirse, istenen görüntülerden herhangi biri eksikse veya bir hata dönerse yürütmeyi durdurur. Varsayılan: false. | BOOLEAN | Hayır | true / false | +| `seed` | Üretim için kullanılacak seed değeri. Varsayılan: 42. | INT | Hayır | 0 to 2147483647 | +| `watermark` | Görüntüye "AI generated" filigranı eklenip eklenmeyeceği. Varsayılan: false. | BOOLEAN | Hayır | true / false | +| `thinking` | Daha iyi uyum için modelin istem iyileştirme muhakemesini ('thinking') etkinleştirir. Üretim süresini önemli ölçüde artırabilir — özellikle Seedream 5.0 Pro'da. Yalnızca metinden görüntüye üretimde devre dışı bırakılabilir (referans görüntüler sağlandığında değil). Varsayılan: true. | BOOLEAN | Hayır | true / false | + +### Seedream 4.0 Girdileri (seedream-4-0-250828) + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | Önerilen bir boyut seçin. Aşağıdaki genişlik ve yüksekliği kullanmak için Custom seçeneğini belirleyin. Varsayılan: bu model için önerilen ilk hazır ayar. | COMBO | Hayır | Model-specific recommended size presets
"Custom" | +| `width` | Görüntü için özel genişlik. Değer yalnızca `size_preset` "Custom" olarak ayarlandığında çalışır. Varsayılan: 2048. | INT | Hayır | 1024 to 6240 (step 2) | +| `height` | Görüntü için özel yükseklik. Değer yalnızca `size_preset` "Custom" olarak ayarlandığında çalışır. Varsayılan: 2048. | INT | Hayır | 1024 to 4992 (step 2) | +| `max_images` | Üretilecek maksimum görüntü sayısı. 1 ile tam olarak bir görüntü üretilir. >1 ile model, 1 ile max_images arasında ilişkili görüntü üretir (örn. hikaye sahneleri, karakter varyasyonları). Toplam görüntü (girdi + üretilen) 15'i aşamaz. Varsayılan: 1. | INT | Hayır | 1 to 10 | +| `fail_on_partial` | Etkinleştirilirse, istenen görüntülerden herhangi biri eksikse veya bir hata dönerse yürütmeyi durdurur. Varsayılan: false. | BOOLEAN | Hayır | true / false | +| `seed` | Üretim için kullanılacak seed değeri. Varsayılan: 42. | INT | Hayır | 0 to 2147483647 | +| `watermark` | Görüntüye "AI generated" filigranı eklenip eklenmeyeceği. Varsayılan: false. | BOOLEAN | Hayır | true / false | +| `thinking` | Daha iyi uyum için modelin istem iyileştirme muhakemesini ('thinking') etkinleştirir. Üretim süresini önemli ölçüde artırabilir — özellikle Seedream 5.0 Pro'da. Yalnızca metinden görüntüye üretimde devre dışı bırakılabilir (referans görüntüler sağlandığında değil). Varsayılan: true. | BOOLEAN | Hayır | true / false | + +### Referans Girdileri + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +|-----------|-------------|-----------|----------|-------| +| `images` | Büyüyebilir yuva: görüntüden görüntüye veya çoklu referans üretimi için isteğe bağlı referans görüntüsü/görüntüleri. 1..N görüntü bağlayın (örn. `image_1`, `image_2`, ...); sayı sınırı modele göredir (aşağıdaki notlara bakın). Bağlı bir görüntü bir görüntü kümesi içeriyorsa, kümedeki her görüntü sınıra dahil sayılır. | IMAGE | Hayır | 0 to 10 (Seedream 5.0 Pro, Seedream 4.5, Seedream 4.0)
0 to 14 (Seedream 5.0 Lite) | + +**Notlar:** + +- `prompt` boşluk karakterleri silindikten sonra boş olmamalıdır. +- Maksimum referans görüntü sayısı: Seedream 5.0 Pro, Seedream 4.5 ve Seedream 4.0 için 10; Seedream 5.0 Lite için 14. +- Her referans görüntüsünün en-boy oranı 1:3 ile 3:1 arasında olmalıdır. +- `max_images` değeri 1'den büyük olduğunda (Seedream 5.0 Pro'da kullanılamaz), referans görüntüleri ile üretilen görüntülerin toplam sayısı 15'i aşamaz. +- `thinking` yalnızca metinden görüntüye üretimde devre dışı bırakılabilir. Referans görüntüler sağlandığında `thinking` etkinleştirilmiş olmalıdır. +- `width` ve `height` yalnızca `size_preset` "Custom" olarak ayarlandığında kullanılır. +- `prompt_optimization` yalnızca Seedream 5.0 Pro'da kullanılabilir. +- `max_images` ve `fail_on_partial` yalnızca Seedream 5.0 Lite, Seedream 4.5 ve Seedream 4.0'da kullanılabilir; Seedream 5.0 Pro her zaman tek bir görüntü ister. +- Çözünürlük gereksinimleri (genişlik x yükseklik): + - Seedream 5.0 Pro: 0.92MP (921,600 piksel) ile 4.19MP (4,194,304 piksel) arasında. + - Seedream 5.0 Lite ve Seedream 4.5: en az 3.68MP (3,686,400 piksel). + - Seedream 4.0: en az 0.92MP (921,600 piksel). + - Pro olmayan tüm modeller: en fazla 16.78MP (16,777,216 piksel). + +## Çıktılar + +| Çıktı Adı | Açıklama | Veri Türü | +|-------------|-------------|-----------| +| `image` | Üretilen görüntü tensörü. Birden çok görüntü üretildiğinde, bunlar tek bir toplu (batched) IMAGE tensöründe birleştirilir. | IMAGE | + +> Bu belge yapay zeka tarafından oluşturulmuştur. Herhangi bir hata bulursanız veya iyileştirme önerileriniz varsa, katkıda bulunmaktan çekinmeyin! [GitHub'da Düzenle](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/tr.md) + +--- +**Source fingerprint (SHA-256):** `68dd23afdb5720491cef784b22ad66ff0baf80984ea652ea4c13e6c264c029ac` diff --git a/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/zh-TW.md b/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/zh-TW.md new file mode 100644 index 000000000..a6cd310d6 --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/zh-TW.md @@ -0,0 +1,96 @@ +# ByteDanceSeedreamNodeV3 + +ByteDance Seedream 4.5 & 5.0 可根據文字提示(文字轉影像)生成影像,或在可選參考影像的引導下生成/編輯影像,使用 ByteDance Seedream 4.0、4.5 和 5.0 模型,最高可達 4K 解析度。此節點會將提示與任何參考影像傳送至 ByteDance API,等待生成任務完成,並回傳產生的影像張量(或張量群)。 + +## 輸入 + +### 通用輸入 + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `prompt` | 用於建立或編輯影像的文字提示。去除前後空白後不得為空。 | STRING | 是 | 多行文字 | +| `model` | 選擇要使用的 Seedream 模型。每個模型都會在下方顯示各自的子參數與限制。 | DYNAMIC_COMBO | 是 | "seedream 5.0 pro"
"seedream 5.0 lite"
"seedream-4-5-251128"
"seedream-4-0-250828" | + +### Seedream 5.0 Pro 輸入(seedream 5.0 pro) + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | 選擇建議的尺寸。選取 Custom 以使用下方的寬度與高度。預設值:此模型的第一個建議尺寸預設。 | COMBO | 否 | 模型專屬的建議尺寸預設
"Custom" | +| `width` | 自訂影像寬度。僅當 `size_preset` 設為 `Custom` 時此值才生效。預設值:2048。 | INT | 否 | 1024 to 3136 (step 2) | +| `height` | 自訂影像高度。僅當 `size_preset` 設為 `Custom` 時此值才生效。預設值:2048。 | INT | 否 | 1024 to 2496 (step 2) | +| `prompt_optimization` | 提供參考影像時的提示最佳化模式:「standard」提供較高品質,「fast」縮短生成時間。預設值:"standard"。 | COMBO | 否 | "standard"
"fast" | +| `seed` | 用於生成的種子(seed)。預設值:42。 | INT | 否 | 0 to 2147483647 | +| `watermark` | 是否在影像上加入「AI 生成」浮水印。預設值:false。 | BOOLEAN | 否 | true / false | +| `thinking` | 啟用模型的提示最佳化推理(「thinking」)以提升指令遵循度。可能會大幅增加生成時間——尤其是 Seedream 5.0 Pro。僅在文字轉影像時可停用(提供參考影像時不可停用)。預設值:true。 | BOOLEAN | 否 | true / false | + +### Seedream 5.0 Lite 輸入(seedream 5.0 lite) + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | 選擇建議的尺寸。選取 Custom 以使用下方的寬度與高度。預設值:此模型的第一個建議尺寸預設。 | COMBO | 否 | 模型專屬的建議尺寸預設
"Custom" | +| `width` | 自訂影像寬度。僅當 `size_preset` 設為 `Custom` 時此值才生效。預設值:2048。 | INT | 否 | 1024 to 6240 (step 2) | +| `height` | 自訂影像高度。僅當 `size_preset` 設為 `Custom` 時此值才生效。預設值:2048。 | INT | 否 | 1024 to 4992 (step 2) | +| `max_images` | 要生成的影像數量上限。設為 1 時,恰好生成一張影像。設為 >1 時,模型會生成 1 到 `max_images` 張相關影像(例如故事場景、角色變化)。總影像數(輸入 + 生成)不得超過 15。預設值:1。 | INT | 否 | 1 to 14 | +| `fail_on_partial` | 若啟用,當任何要求的影像缺失或回傳錯誤時,中止執行。預設值:false。 | BOOLEAN | 否 | true / false | +| `seed` | 用於生成的種子(seed)。預設值:42。 | INT | 否 | 0 to 2147483647 | +| `watermark` | 是否在影像上加入「AI 生成」浮水印。預設值:false。 | BOOLEAN | 否 | true / false | +| `thinking` | 啟用模型的提示最佳化推理(「thinking」)以提升指令遵循度。可能會大幅增加生成時間——尤其是 Seedream 5.0 Pro。僅在文字轉影像時可停用(提供參考影像時不可停用)。預設值:true。 | BOOLEAN | 否 | true / false | + +### Seedream 4.5 輸入(seedream-4-5-251128) + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | 選擇建議的尺寸。選取 Custom 以使用下方的寬度與高度。預設值:此模型的第一個建議尺寸預設。 | COMBO | 否 | 模型專屬的建議尺寸預設
"Custom" | +| `width` | 自訂影像寬度。僅當 `size_preset` 設為 `Custom` 時此值才生效。預設值:2048。 | INT | 否 | 1024 to 6240 (step 2) | +| `height` | 自訂影像高度。僅當 `size_preset` 設為 `Custom` 時此值才生效。預設值:2048。 | INT | 否 | 1024 to 4992 (step 2) | +| `max_images` | 要生成的影像數量上限。設為 1 時,恰好生成一張影像。設為 >1 時,模型會生成 1 到 `max_images` 張相關影像(例如故事場景、角色變化)。總影像數(輸入 + 生成)不得超過 15。預設值:1。 | INT | 否 | 1 to 10 | +| `fail_on_partial` | 若啟用,當任何要求的影像缺失或回傳錯誤時,中止執行。預設值:false。 | BOOLEAN | 否 | true / false | +| `seed` | 用於生成的種子(seed)。預設值:42。 | INT | 否 | 0 to 2147483647 | +| `watermark` | 是否在影像上加入「AI 生成」浮水印。預設值:false。 | BOOLEAN | 否 | true / false | +| `thinking` | 啟用模型的提示最佳化推理(「thinking」)以提升指令遵循度。可能會大幅增加生成時間——尤其是 Seedream 5.0 Pro。僅在文字轉影像時可停用(提供參考影像時不可停用)。預設值:true。 | BOOLEAN | 否 | true / false | + +### Seedream 4.0 輸入(seedream-4-0-250828) + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | 選擇建議的尺寸。選取 Custom 以使用下方的寬度與高度。預設值:此模型的第一個建議尺寸預設。 | COMBO | 否 | 模型專屬的建議尺寸預設
"Custom" | +| `width` | 自訂影像寬度。僅當 `size_preset` 設為 `Custom` 時此值才生效。預設值:2048。 | INT | 否 | 1024 to 6240 (step 2) | +| `height` | 自訂影像高度。僅當 `size_preset` 設為 `Custom` 時此值才生效。預設值:2048。 | INT | 否 | 1024 to 4992 (step 2) | +| `max_images` | 要生成的影像數量上限。設為 1 時,恰好生成一張影像。設為 >1 時,模型會生成 1 到 `max_images` 張相關影像(例如故事場景、角色變化)。總影像數(輸入 + 生成)不得超過 15。預設值:1。 | INT | 否 | 1 to 10 | +| `fail_on_partial` | 若啟用,當任何要求的影像缺失或回傳錯誤時,中止執行。預設值:false。 | BOOLEAN | 否 | true / false | +| `seed` | 用於生成的種子(seed)。預設值:42。 | INT | 否 | 0 to 2147483647 | +| `watermark` | 是否在影像上加入「AI 生成」浮水印。預設值:false。 | BOOLEAN | 否 | true / false | +| `thinking` | 啟用模型的提示最佳化推理(「thinking」)以提升指令遵循度。可能會大幅增加生成時間——尤其是 Seedream 5.0 Pro。僅在文字轉影像時可停用(提供參考影像時不可停用)。預設值:true。 | BOOLEAN | 否 | true / false | + +### 參考輸入 + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `images` | 可擴充插槽(Growable slot):用於影像轉影像或多參考影像生成的可選參考影像。可連接 1..N 張影像(例如 `image_1`、`image_2`……);數量限制依模型而定(見下方注意事項)。若連接的影像包含一批影像,則該批次中的每一張影像都會計入限制。 | IMAGE | 否 | 0 to 10 (Seedream 5.0 Pro, Seedream 4.5, Seedream 4.0)
0 to 14 (Seedream 5.0 Lite) | + +**注意事項:** + +- `prompt` 去除前後空白後不得為空。 +- 參考影像數量上限:Seedream 5.0 Pro、Seedream 4.5 和 Seedream 4.0 為 10 張;Seedream 5.0 Lite 為 14 張。 +- 每張參考影像的長寬比必須介於 1:3 和 3:1 之間。 +- 當 `max_images` 大於 1 時(Seedream 5.0 Pro 不支援此選項),參考影像加上生成影像的總數不得超過 15。 +- `thinking` 僅可在文字轉影像生成時停用。提供參考影像時,必須啟用 `thinking`。 +- `width` 和 `height` 僅在 `size_preset` 設為 "Custom" 時使用。 +- `prompt_optimization` 僅適用於 Seedream 5.0 Pro。 +- `max_images` 和 `fail_on_partial` 僅適用於 Seedream 5.0 Lite、Seedream 4.5 和 Seedream 4.0;Seedream 5.0 Pro 一律只請求單張影像。 +- 解析度要求(寬度 x 高度): + - Seedream 5.0 Pro:介於 0.92MP(921,600 像素)與 4.19MP(4,194,304 像素)之間。 + - Seedream 5.0 Lite 和 Seedream 4.5:至少 3.68MP(3,686,400 像素)。 + - Seedream 4.0:至少 0.92MP(921,600 像素)。 + - 所有非 Pro 模型:最多 16.78MP(16,777,216 像素)。 + +## 輸出 + +| 輸出名稱 | 描述 | 資料類型 | +|-------------|-------------|-----------| +| `image` | 生成的影像張量。當生成多張影像時,會將其串接成單一批次(batched)的 IMAGE 張量。 | IMAGE | + +> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/zh-TW.md) + +--- +**Source fingerprint (SHA-256):** `68dd23afdb5720491cef784b22ad66ff0baf80984ea652ea4c13e6c264c029ac` diff --git a/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/zh.md b/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/zh.md new file mode 100644 index 000000000..12695a398 --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/zh.md @@ -0,0 +1,96 @@ +# ByteDanceSeedreamNodeV3 + +ByteDance Seedream 4.5 和 5.0 节点可根据文本提示生成图像(文生图),或借助可选的参考图像进行图像生成/编辑,使用 ByteDance Seedream 4.0、4.5 和 5.0 模型,最高支持 4K 分辨率。该节点会将提示词及任何参考图像发送到 ByteDance API,等待生成任务完成后,返回生成的图像张量(单个或多个)。 + +## 输入 + +### 通用输入 + +| 参数 | 描述 | 数据类型 | 必填 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `prompt` | 用于创建或编辑图像的文本提示词。去除首尾空格后不能为空。 | STRING | 是 | Multiline text | +| `model` | 选择要使用的 Seedream 模型。每个模型都有自己的一组子参数和下方列出的限制。 | DYNAMIC_COMBO | 是 | "seedream 5.0 pro"
"seedream 5.0 lite"
"seedream-4-5-251128"
"seedream-4-0-250828" | + +### Seedream 5.0 Pro 输入 (seedream 5.0 pro) + +| 参数 | 描述 | 数据类型 | 必填 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | 选择推荐的尺寸。选择 Custom 以使用下面的宽度和高度。默认值:此模型的第一个推荐预设。 | COMBO | 否 | Model-specific recommended size presets
"Custom" | +| `width` | 图像的自定义宽度。仅当 `size_preset` 设置为 `Custom` 时生效。默认值:2048。 | INT | 否 | 1024 to 3136 (step 2) | +| `height` | 图像的自定义高度。仅当 `size_preset` 设置为 `Custom` 时生效。默认值:2048。 | INT | 否 | 1024 to 2496 (step 2) | +| `prompt_optimization` | 提供参考图像时的提示词优化模式:'standard' 质量更高,'fast' 生成时间更短。默认值:"standard"。 | COMBO | 否 | "standard"
"fast" | +| `seed` | 用于生成的随机种子。默认值:42。 | INT | 否 | 0 to 2147483647 | +| `watermark` | 是否在图像上添加“AI 生成”水印。默认值:false。 | BOOLEAN | 否 | true / false | +| `thinking` | 启用模型的提示词优化推理('thinking')以获得更好的提示遵循度。可能会显著增加生成时间——尤其是在 Seedream 5.0 Pro 上。仅在文生图模式下可以禁用(提供参考图像时不可禁用)。默认值:true。 | BOOLEAN | 否 | true / false | + +### Seedream 5.0 Lite 输入 (seedream 5.0 lite) + +| 参数 | 描述 | 数据类型 | 必填 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | 选择推荐的尺寸。选择 Custom 以使用下面的宽度和高度。默认值:此模型的第一个推荐预设。 | COMBO | 否 | Model-specific recommended size presets
"Custom" | +| `width` | 图像的自定义宽度。仅当 `size_preset` 设置为 `Custom` 时生效。默认值:2048。 | INT | 否 | 1024 to 6240 (step 2) | +| `height` | 图像的自定义高度。仅当 `size_preset` 设置为 `Custom` 时生效。默认值:2048。 | INT | 否 | 1024 to 4992 (step 2) | +| `max_images` | 生成图像的最大数量。设为 1 时,恰好生成一张图像。设为 >1 时,模型会生成 1 到 max_images 张相关图像(例如故事场景、角色变体)。图像总数(输入 + 生成)不能超过 15。默认值:1。 | INT | 否 | 1 to 14 | +| `fail_on_partial` | 如果启用,当任何请求的图像缺失或返回错误时中止执行。默认值:false。 | BOOLEAN | 否 | true / false | +| `seed` | 用于生成的随机种子。默认值:42。 | INT | 否 | 0 to 2147483647 | +| `watermark` | 是否在图像上添加“AI 生成”水印。默认值:false。 | BOOLEAN | 否 | true / false | +| `thinking` | 启用模型的提示词优化推理('thinking')以获得更好的提示遵循度。可能会显著增加生成时间——尤其是在 Seedream 5.0 Pro 上。仅在文生图模式下可以禁用(提供参考图像时不可禁用)。默认值:true。 | BOOLEAN | 否 | true / false | + +### Seedream 4.5 输入 (seedream-4-5-251128) + +| 参数 | 描述 | 数据类型 | 必填 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | 选择推荐的尺寸。选择 Custom 以使用下面的宽度和高度。默认值:此模型的第一个推荐预设。 | COMBO | 否 | Model-specific recommended size presets
"Custom" | +| `width` | 图像的自定义宽度。仅当 `size_preset` 设置为 `Custom` 时生效。默认值:2048。 | INT | 否 | 1024 to 6240 (step 2) | +| `height` | 图像的自定义高度。仅当 `size_preset` 设置为 `Custom` 时生效。默认值:2048。 | INT | 否 | 1024 to 4992 (step 2) | +| `max_images` | 生成图像的最大数量。设为 1 时,恰好生成一张图像。设为 >1 时,模型会生成 1 到 max_images 张相关图像(例如故事场景、角色变体)。图像总数(输入 + 生成)不能超过 15。默认值:1。 | INT | 否 | 1 to 10 | +| `fail_on_partial` | 如果启用,当任何请求的图像缺失或返回错误时中止执行。默认值:false。 | BOOLEAN | 否 | true / false | +| `seed` | 用于生成的随机种子。默认值:42。 | INT | 否 | 0 to 2147483647 | +| `watermark` | 是否在图像上添加“AI 生成”水印。默认值:false。 | BOOLEAN | 否 | true / false | +| `thinking` | 启用模型的提示词优化推理('thinking')以获得更好的提示遵循度。可能会显著增加生成时间——尤其是在 Seedream 5.0 Pro 上。仅在文生图模式下可以禁用(提供参考图像时不可禁用)。默认值:true。 | BOOLEAN | 否 | true / false | + +### Seedream 4.0 输入 (seedream-4-0-250828) + +| 参数 | 描述 | 数据类型 | 必填 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `size_preset` | 选择推荐的尺寸。选择 Custom 以使用下面的宽度和高度。默认值:此模型的第一个推荐预设。 | COMBO | 否 | Model-specific recommended size presets
"Custom" | +| `width` | 图像的自定义宽度。仅当 `size_preset` 设置为 `Custom` 时生效。默认值:2048。 | INT | 否 | 1024 to 6240 (step 2) | +| `height` | 图像的自定义高度。仅当 `size_preset` 设置为 `Custom` 时生效。默认值:2048。 | INT | 否 | 1024 to 4992 (step 2) | +| `max_images` | 生成图像的最大数量。设为 1 时,恰好生成一张图像。设为 >1 时,模型会生成 1 到 max_images 张相关图像(例如故事场景、角色变体)。图像总数(输入 + 生成)不能超过 15。默认值:1。 | INT | 否 | 1 to 10 | +| `fail_on_partial` | 如果启用,当任何请求的图像缺失或返回错误时中止执行。默认值:false。 | BOOLEAN | 否 | true / false | +| `seed` | 用于生成的随机种子。默认值:42。 | INT | 否 | 0 to 2147483647 | +| `watermark` | 是否在图像上添加“AI 生成”水印。默认值:false。 | BOOLEAN | 否 | true / false | +| `thinking` | 启用模型的提示词优化推理('thinking')以获得更好的提示遵循度。可能会显著增加生成时间——尤其是在 Seedream 5.0 Pro 上。仅在文生图模式下可以禁用(提供参考图像时不可禁用)。默认值:true。 | BOOLEAN | 否 | true / false | + +### 参考输入 + +| 参数 | 描述 | 数据类型 | 必填 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `images` | 可增长插槽:用于图生图或多参考生成的可选参考图像。可连接 1..N 张图像(例如 `image_1`、`image_2` ……);数量上限取决于具体模型(见下方注意事项)。如果连接的图像包含一个批次的多张图像,则批次中的每一张图像都计入数量上限。 | IMAGE | 否 | 0 to 10 (Seedream 5.0 Pro, Seedream 4.5, Seedream 4.0)
0 to 14 (Seedream 5.0 Lite) | + +**注意:** + +- `prompt` 去除首尾空格后不能为空。 +- 参考图像的最大数量:Seedream 5.0 Pro、Seedream 4.5 和 Seedream 4.0 为 10 张;Seedream 5.0 Lite 为 14 张。 +- 每张参考图像的宽高比必须在 1:3 到 3:1 之间。 +- 当 `max_images` 大于 1 时(Seedream 5.0 Pro 不可用),参考图像与生成图像的总数不能超过 15。 +- `thinking` 仅在文生图生成时可以禁用。提供参考图像时,必须启用 `thinking`。 +- 仅当 `size_preset` 设置为 "Custom" 时,`width` 和 `height` 才会生效。 +- `prompt_optimization` 仅在 Seedream 5.0 Pro 上可用。 +- `max_images` 和 `fail_on_partial` 仅在 Seedream 5.0 Lite、Seedream 4.5 和 Seedream 4.0 上可用;Seedream 5.0 Pro 始终只请求生成一张图像。 +- 分辨率要求(宽度 x 高度): + - Seedream 5.0 Pro:介于 0.92MP(921,600 像素)和 4.19MP(4,194,304 像素)之间。 + - Seedream 5.0 Lite 和 Seedream 4.5:至少 3.68MP(3,686,400 像素)。 + - Seedream 4.0:至少 0.92MP(921,600 像素)。 + - 所有非 Pro 模型:最多 16.78MP(16,777,216 像素)。 + +## 输出 + +| 输出名称 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `image` | 生成的图像张量。当生成多张图像时,它们会被拼接为一个单独的批处理 IMAGE 张量。 | IMAGE | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceSeedreamNodeV3/zh.md) + +--- +**Source fingerprint (SHA-256):** `68dd23afdb5720491cef784b22ad66ff0baf80984ea652ea4c13e6c264c029ac` diff --git a/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/ar.md b/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/ar.md new file mode 100644 index 000000000..dd7899f02 --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/ar.md @@ -0,0 +1,62 @@ +# ByteDanceVideoEnhanceNode + +تقوم هذه العقدة بترقية الدقة واستعادة جودة الفيديوهات باستخدام ByteDance vCube. يمكنها رفع الدقة حتى 8K، وإزالة تشوهات الضغط والضوضاء، وتحسين الألوان والحدة، مع إمكانية استيفاء الإطارات اختياريًا للحصول على معدل إطارات أعلى. يتم رفع الفيديو إلى خدمة vCube، ومعالجته باستخدام الإعداد المسبق للتحسين المحدد، ثم إرجاعه كملف فيديو محسّن. + +## المدخلات + +### المدخلات العامة + +هذه المدخلات تظهر دائمًا. + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|-----------|-------------|-----------|----------|-------| +| `video` | الفيديو المراد تحسينه. يجب أن تكون دقة المصدر على الأكثر 2560×1440 (2K)؛ يتم تحديد حجم الإخراج من خلال مدخل الدقة. | VIDEO | نعم | بحد أقصى 2560×1440 (2K) | +| `tool_version` | 'standard' يوازن بين السرعة والجودة مع أكثر من 10 خوارزميات تحسين. 'professional' يستخدم أكثر من 30 خوارزمية لترميم بجودة السينما، ويستغرق حوالي 3 أضعاف الوقت ويكلف 10 أضعاف. | DYNAMIC_COMBO | نعم | "standard"
"professional" | +| `resolution` | دقة الإخراج. يتم ضبط الجانب القصير على المستوى المختار ويتبع الجانب الطويل نسبة العرض إلى الارتفاع للمصدر. 'source' يحافظ على حجم المصدر، و'custom' يضبط الجانب القصير بالبكسل. المصادر الأعرض أو الأطول من حوالي 2.2:1 تُحسب بمستوى دقة أعلى. | DYNAMIC_COMBO | نعم | "720p"
"1080p"
"2k"
"4k"
"8k"
"source"
"custom" | +| `fps` | معدل إطارات الإخراج. معدل أعلى من المصدر يتيح استيفاء الإطارات بالذكاء الاصطناعي؛ ومعدل أقل يحذف الإطارات. 'source' يحافظ على معدل المصدر، حتى 120 إطارًا في الثانية. المعدلات فوق 30 إطارًا في الثانية تكلف ضعفين، وفوق 60 إطارًا تكلف 4 أضعاف. (الافتراضي: "source") | COMBO | نعم | "source" (الافتراضي)
معدلات إطارات رقمية حتى 120 إطارًا في الثانية | +| `bitrate_level` | معدل البت المستهدف للملف المُسلَّم، مقياسًا إلى دقة الإخراج ومعدل الإطارات. (الافتراضي: "medium") | COMBO | نعم | "low"
"medium"
"high" | + +### المدخلات القياسية + +تظهر عندما يتم تعيين `tool_version` على "standard". + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|-----------|-------------|-----------|----------|-------| +| `scene` | إعداد مسبق مضبوط حسب المحتوى: 'aigc' للقطات المُولّدة بالذكاء الاصطناعي، و'common' للفيديو العام، و'ugc' لمقاطع الهاتف المضغوطة، و'short_series' للمسلسلات الدرامية التي تحتوي على وجوه، و'old_film' للقطات الأرشيفية المخدوشة أو المتقطعة. (الافتراضي: "aigc") | COMBO | نعم | "aigc"
"common"
"ugc"
"short_series"
"old_film" | +| `enhance_style` | 'hd' يطبق تحسينًا أكثر حدة؛ 'natural' يقلل القوة لمظهر أنعم وأقل حدة. (الافتراضي: "hd") | COMBO | نعم | "hd"
"natural" | + +### المدخلات الاحترافية + +تظهر عندما يتم تعيين `tool_version` على "professional". + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|-----------|-------------|-----------|----------|-------| +| `enhance_style` | 'hd' يطبق تحسينًا أكثر حدة؛ 'natural' يقلل القوة لمظهر أنعم وأقل حدة. (الافتراضي: "hd") | COMBO | نعم | "hd"
"natural" | + +### مدخلات الدقة المخصصة + +تظهر عندما يتم تعيين `resolution` على "custom". + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|-----------|-------------|-----------|----------|-------| +| `short_side` | الجانب القصير من الإخراج بالبكسل؛ يتبع الجانب الطويل نسبة العرض إلى الارتفاع للمصدر. (الافتراضي: 1080) | INT | نعم | الافتراضي 1080؛ محدود بحدود الجانب القصير الدنيا والقصوى في vCube | + +### ملاحظات + +- يجب أن يكون الفيديو المصدر بحجم أقصى 2560×1440 (2K). يتم رفض الفيديوهات الأكبر من ذلك، ويجب تصغيرها قبل التحسين. +- مدة الفيديو المصدر محدودة بالحد الأقصى للمدة التي تدعمها خدمة vCube. +- عندما تكون `tool_version` على "standard"، يتوفر كل من `scene` و`enhance_style`. وعندما تكون "professional"، يتوفر `enhance_style` فقط. +- عندما تكون `resolution` على "custom"، تكون قيمة `short_side` مطلوبة. الإعدادات المسبقة للدقة و"source" لا تستخدم `short_side`. +- عندما تكون `resolution` على "source"، يحافظ الإخراج على دقة المصدر. +- عندما تكون `fps` على "source"، يتطابق معدل إطارات الإخراج مع معدل إطارات المصدر، حتى 120 إطارًا في الثانية. + +## المخرجات + +| اسم المخرج | الوصف | نوع البيانات | +|-------------|-------------|-----------| +| `video` | الفيديو المحسّن، المرفوع دقته والمستعاد جودته بالدقة ومعدل الإطارات المطلوبين. | VIDEO | + +> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/ar.md) + +--- +**Source fingerprint (SHA-256):** `bfdd55ce12cabd6e6504129084e86dcf96abd8db4ff64abbe5974c0da7a42bda` diff --git a/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/en.md b/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/en.md new file mode 100644 index 000000000..6b1e672d1 --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/en.md @@ -0,0 +1,62 @@ +# ByteDanceVideoEnhanceNode + +This node upscales and restores videos using ByteDance vCube. It can increase resolution up to 8K, remove compression artifacts and noise, enhance colour and sharpness, and optionally interpolate frames for a higher frame rate. The video is uploaded to the vCube service, processed with the selected enhancement preset, and returned as an enhanced video file. + +## Inputs + +### Common Inputs + +These inputs are always visible. + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `video` | Video to enhance. The source resolution must be at most 2560x1440 (2K); the output size is set by the resolution input. | VIDEO | Yes | At most 2560x1440 (2K) | +| `tool_version` | 'standard' balances speed and quality with 10+ enhancement algorithms. 'professional' uses 30+ algorithms for cinema-grade restoration, takes about 3x longer and costs 10x more. | DYNAMIC_COMBO | Yes | "standard"
"professional" | +| `resolution` | Output resolution. The short side is set to the chosen level and the long side follows the source aspect ratio. 'source' keeps the source size, 'custom' sets the short side in pixels. Sources wider or taller than about 2.2:1 are billed one resolution tier higher. | DYNAMIC_COMBO | Yes | "720p"
"1080p"
"2k"
"4k"
"8k"
"source"
"custom" | +| `fps` | Output frame rate. A higher rate than the source enables AI frame interpolation; a lower one drops frames. 'source' keeps the source rate, up to 120 fps. Rates above 30 fps cost 2x, above 60 fps 4x. (default: "source") | COMBO | Yes | "source" (default)
Numeric frame rates up to 120 fps | +| `bitrate_level` | Target bitrate of the delivered file, scaled to the output resolution and frame rate. (default: "medium") | COMBO | Yes | "low"
"medium"
"high" | + +### Standard Inputs + +Shown when `tool_version` is set to "standard". + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `scene` | Preset tuned to the content: 'aigc' for AI-generated footage, 'common' for general video, 'ugc' for compressed phone clips, 'short_series' for drama with faces, 'old_film' for scratched or flickering archive footage. (default: "aigc") | COMBO | Yes | "aigc"
"common"
"ugc"
"short_series"
"old_film" | +| `enhance_style` | 'hd' applies a sharper enhancement; 'natural' reduces the strength for a softer, less sharpened look. (default: "hd") | COMBO | Yes | "hd"
"natural" | + +### Professional Inputs + +Shown when `tool_version` is set to "professional". + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `enhance_style` | 'hd' applies a sharper enhancement; 'natural' reduces the strength for a softer, less sharpened look. (default: "hd") | COMBO | Yes | "hd"
"natural" | + +### Custom Resolution Inputs + +Shown when `resolution` is set to "custom". + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `short_side` | Short side of the output in pixels; the long side follows the source aspect ratio. (default: 1080) | INT | Yes | Default 1080; bounded by vCube minimum and maximum short-side limits | + +### Notes + +- The source video must be at most 2560x1440 (2K). Videos larger than this are rejected and must be scaled down before enhancing. +- The source video duration is limited to the maximum duration supported by the vCube service. +- When `tool_version` is "standard", both `scene` and `enhance_style` are available. When it is "professional", only `enhance_style` is available. +- When `resolution` is "custom", the `short_side` value is required. The resolution presets and "source" do not use `short_side`. +- When `resolution` is "source", the output keeps the source resolution. +- When `fps` is "source", the output frame rate matches the source frame rate, up to 120 fps. + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `video` | The enhanced video, upscaled and restored at the requested resolution and frame rate. | VIDEO | + +> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/en.md) + +--- +**Source fingerprint (SHA-256):** `bfdd55ce12cabd6e6504129084e86dcf96abd8db4ff64abbe5974c0da7a42bda` diff --git a/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/es.md b/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/es.md new file mode 100644 index 000000000..eca8beb9a --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/es.md @@ -0,0 +1,62 @@ +# ByteDanceVideoEnhanceNode + +Este nodo amplía y restaura videos mediante ByteDance vCube. Puede aumentar la resolución hasta 8K, eliminar artefactos de compresión y ruido, mejorar el color y la nitidez y, opcionalmente, interpolar fotogramas para obtener una frecuencia de imagen más alta. El video se carga en el servicio vCube, se procesa con el preset de mejora seleccionado y se devuelve como un archivo de video mejorado. + +## Entradas + +### Entradas comunes + +Estas entradas están siempre visibles. + +| Parámetro | Descripción | Tipo de datos | Requerido | Rango | +|-----------|-------------|---------------|-----------|-------| +| `video` | Video a mejorar. La resolución de origen debe ser como máximo 2560x1440 (2K); el tamaño de salida lo define el parámetro de resolución. | VIDEO | Sí | Como máximo 2560x1440 (2K) | +| `tool_version` | 'standard' equilibra velocidad y calidad con más de 10 algoritmos de mejora. 'professional' utiliza más de 30 algoritmos para una restauración de calidad cinematográfica, tarda aproximadamente 3 veces más y cuesta 10 veces más. | DYNAMIC_COMBO | Sí | "standard"
"professional" | +| `resolution` | Resolución de salida. El lado corto se ajusta al nivel elegido y el lado largo sigue la relación de aspecto del origen. 'source' mantiene el tamaño de origen, 'custom' define el lado corto en píxeles. Los orígenes más anchos o altos que aproximadamente 2.2:1 se facturan un nivel de resolución superior. | DYNAMIC_COMBO | Sí | "720p"
"1080p"
"2k"
"4k"
"8k"
"source"
"custom" | +| `fps` | Frecuencia de imagen de salida. Una frecuencia mayor que la del origen permite la interpolación de fotogramas por IA; una menor elimina fotogramas. 'source' mantiene la frecuencia de origen, hasta 120 fps. Las frecuencias superiores a 30 fps cuestan 2 veces más; las superiores a 60 fps, 4 veces más. (por defecto: "source") | COMBO | Sí | "source" (por defecto)
Frecuencias de imagen numéricas de hasta 120 fps | +| `bitrate_level` | Tasa de bits objetivo del archivo entregado, ajustada a la resolución y frecuencia de imagen de salida. (por defecto: "medium") | COMBO | Sí | "low"
"medium"
"high" | + +### Entradas estándar + +Se muestran cuando `tool_version` está configurado en "standard". + +| Parámetro | Descripción | Tipo de datos | Requerido | Rango | +|-----------|-------------|---------------|-----------|-------| +| `scene` | Preset ajustado al contenido: 'aigc' para material generado por IA, 'common' para video general, 'ugc' para clips de teléfono comprimidos, 'short_series' para dramas con rostros, 'old_film' para material de archivo rayado o con parpadeo. (por defecto: "aigc") | COMBO | Sí | "aigc"
"common"
"ugc"
"short_series"
"old_film" | +| `enhance_style` | 'hd' aplica una mejora más nítida; 'natural' reduce la intensidad para obtener un aspecto más suave y menos afilado. (por defecto: "hd") | COMBO | Sí | "hd"
"natural" | + +### Entradas profesionales + +Se muestran cuando `tool_version` está configurado en "professional". + +| Parámetro | Descripción | Tipo de datos | Requerido | Rango | +|-----------|-------------|---------------|-----------|-------| +| `enhance_style` | 'hd' aplica una mejora más nítida; 'natural' reduce la intensidad para obtener un aspecto más suave y menos afilado. (por defecto: "hd") | COMBO | Sí | "hd"
"natural" | + +### Entradas de resolución personalizada + +Se muestran cuando `resolution` está configurado en "custom". + +| Parámetro | Descripción | Tipo de datos | Requerido | Rango | +|-----------|-------------|---------------|-----------|-------| +| `short_side` | Lado corto de la salida en píxeles; el lado largo sigue la relación de aspecto del origen. (por defecto: 1080) | INT | Sí | Por defecto 1080; limitado por los límites mínimo y máximo de lado corto de vCube | + +### Notas + +- El video de origen debe ser como máximo 2560x1440 (2K). Los videos de mayor tamaño se rechazan y deben reducirse antes de mejorar. +- La duración del video de origen está limitada a la duración máxima admitida por el servicio vCube. +- Cuando `tool_version` es "standard", tanto `scene` como `enhance_style` están disponibles. Cuando es "professional", solo está disponible `enhance_style`. +- Cuando `resolution` es "custom", se requiere el valor de `short_side`. Los presets de resolución y "source" no utilizan `short_side`. +- Cuando `resolution` es "source", la salida mantiene la resolución de origen. +- Cuando `fps` es "source", la frecuencia de imagen de salida coincide con la del origen, hasta 120 fps. + +## Salidas + +| Nombre de salida | Descripción | Tipo de datos | +|------------------|-------------|---------------| +| `video` | El video mejorado, ampliado y restaurado con la resolución y frecuencia de imagen solicitadas. | VIDEO | + +> Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/es.md) + +--- +**Source fingerprint (SHA-256):** `bfdd55ce12cabd6e6504129084e86dcf96abd8db4ff64abbe5974c0da7a42bda` diff --git a/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/fa.md b/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/fa.md new file mode 100644 index 000000000..b92b8e1bf --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/fa.md @@ -0,0 +1,62 @@ +# ByteDanceVideoEnhanceNode + +این گره ویدیوها را با استفاده از ByteDance vCube بزرگ‌نمایی و بازیابی می‌کند. می‌تواند وضوح را تا 8K افزایش دهد، مصنوعات فشرده‌سازی و نویز را حذف کند، رنگ و شفافیت را بهبود بخشد و به‌صورت اختیاری فریم‌های میانی را برای نرخ فریم بالاتر تولید کند. ویدیو به سرویس vCube ارسال می‌شود، با پیش‌تنظیم بهبود انتخاب‌شده پردازش می‌گردد و به‌صورت یک فایل ویدیویی بهبودیافته بازگردانده می‌شود. + +## ورودی‌ها + +### ورودی‌های عمومی + +این ورودی‌ها همیشه قابل مشاهده هستند. + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `video` | ویدیویی که باید بهبود یابد. وضوح منبع باید حداکثر 2560x1440 (2K) باشد؛ اندازه خروجی توسط ورودی resolution تعیین می‌شود. | VIDEO | بله | حداکثر 2560x1440 (2K) | +| `tool_version` | «standard» با ۱۰+ الگوریتم بهبود، سرعت و کیفیت را متعادل می‌کند. «professional» از ۳۰+ الگوریتم برای بازیابی سینمایی استفاده می‌کند، حدود ۳ برابر بیشتر زمان می‌برد و ۱۰ برابر بیشتر هزینه دارد. | DYNAMIC_COMBO | بله | "standard"
"professional" | +| `resolution` | وضوح خروجی. ضلع کوتاه روی سطح انتخابی تنظیم می‌شود و ضلع بلند نسبت ابعاد منبع را دنبال می‌کند. «source» اندازه منبع را حفظ می‌کند، «custom» ضلع کوتاه را بر حسب پیکسل تنظیم می‌کند. منابع عریض‌تر یا بلندتر از حدود 2.2:1 یک سطح وضوح بالاتر محاسبه می‌شوند. | DYNAMIC_COMBO | بله | "720p"
"1080p"
"2k"
"4k"
"8k"
"source"
"custom" | +| `fps` | نرخ فریم خروجی. نرخ بالاتر از منبع باعث درون‌یابی فریم با هوش مصنوعی می‌شود؛ نرخ پایین‌تر فریم‌ها را حذف می‌کند. «source» نرخ منبع را تا ۱۲۰ فریم بر ثانیه حفظ می‌کند. نرخ‌های بالای ۳۰ فریم بر ثانیه ۲ برابر و بالای ۶۰ فریم بر ثانیه ۴ برابر هزینه دارند. (پیش‌فرض: "source") | COMBO | بله | "source" (پیش‌فرض)
نرخ‌های فریم عددی تا ۱۲۰ فریم بر ثانیه | +| `bitrate_level` | نرخ بیت هدف فایل تحویل‌شده، متناسب با وضوح و نرخ فریم خروجی. (پیش‌فرض: "medium") | COMBO | بله | "low"
"medium"
"high" | + +### ورودی‌های استاندارد + +زمانی نمایش داده می‌شود که `tool_version` روی "standard" تنظیم شده باشد. + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `scene` | پیش‌تنظیم تنظیم‌شده برای محتوا: «aigc» برای تصاویر تولیدشده با هوش مصنوعی، «common» برای ویدیوی عمومی، «ugc» برای کلیپ‌های فشرده‌شده گوشی، «short_series» برای درام با چهره‌های انسانی، «old_film» برای تصاویر آرشیوی خط‌خورده یا چشمک‌زن. (پیش‌فرض: "aigc") | COMBO | بله | "aigc"
"common"
"ugc"
"short_series"
"old_film" | +| `enhance_style` | «hd» بهبودی شارپ‌تر اعمال می‌کند؛ «natural» شدت را کاهش می‌دهد تا ظاهری نرم‌تر و کمتر شارپ‌شده ایجاد کند. (پیش‌فرض: "hd") | COMBO | بله | "hd"
"natural" | + +### ورودی‌های حرفه‌ای + +زمانی نمایش داده می‌شود که `tool_version` روی "professional" تنظیم شده باشد. + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `enhance_style` | «hd» بهبودی شارپ‌تر اعمال می‌کند؛ «natural» شدت را کاهش می‌دهد تا ظاهری نرم‌تر و کمتر شارپ‌شده ایجاد کند. (پیش‌فرض: "hd") | COMBO | بله | "hd"
"natural" | + +### ورودی‌های وضوح سفارشی + +زمانی نمایش داده می‌شود که `resolution` روی "custom" تنظیم شده باشد. + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `short_side` | ضلع کوتاه خروجی بر حسب پیکسل؛ ضلع بلند نسبت ابعاد منبع را دنبال می‌کند. (پیش‌فرض: ۱۰۸۰) | INT | بله | پیش‌فرض ۱۰۸۰؛ محدود به حداقل و حداکثر ضلع کوتاه تعیین‌شده توسط vCube | + +### نکات + +- ویدیوی منبع باید حداکثر 2560x1440 (2K) باشد. ویدیوهای بزرگ‌تر از این مقدار رد می‌شوند و باید قبل از بهبود، کوچک‌سازی شوند. +- مدت‌زمان ویدیوی منبع به حداکثر مدت پشتیبانی‌شده توسط سرویس vCube محدود است. +- وقتی `tool_version` روی "standard" باشد، هر دو پارامتر `scene` و `enhance_style` در دسترس هستند. وقتی روی "professional" باشد، فقط `enhance_style` در دسترس است. +- وقتی `resolution` روی "custom" باشد، مقدار `short_side` الزامی است. پیش‌تنظیم‌های وضوح و «source» از `short_side` استفاده نمی‌کنند. +- وقتی `resolution` روی "source" باشد، خروجی وضوح منبع را حفظ می‌کند. +- وقتی `fps` روی "source" باشد، نرخ فریم خروجی با نرخ فریم منبع، تا ۱۲۰ فریم بر ثانیه، مطابقت دارد. + +## خروجی‌ها + +| نام خروجی | توضیحات | نوع داده | +|-------------|-------------|-----------| +| `video` | ویدیوی بهبودیافته، بزرگ‌نمایی‌شده و بازیابی‌شده با وضوح و نرخ فریم درخواستی. | VIDEO | + +> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/fa.md) + +--- +**Source fingerprint (SHA-256):** `bfdd55ce12cabd6e6504129084e86dcf96abd8db4ff64abbe5974c0da7a42bda` diff --git a/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/fr.md b/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/fr.md new file mode 100644 index 000000000..b56fe402a --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/fr.md @@ -0,0 +1,62 @@ +# ByteDanceVideoEnhanceNode + +Ce nœud agrandit et restaure des vidéos à l’aide de ByteDance vCube. Il peut augmenter la résolution jusqu’à 8K, supprimer les artefacts de compression et le bruit, améliorer la couleur et la netteté, et éventuellement interpoler les images pour obtenir une cadence plus élevée. La vidéo est téléversée sur le service vCube, traitée avec le préréglage d’amélioration sélectionné, puis renvoyée sous forme de fichier vidéo amélioré. + +## Entrées + +### Entrées communes + +Ces entrées sont toujours visibles. + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `video` | Vidéo à améliorer. La résolution source doit être au maximum de 2560x1440 (2K) ; la taille de sortie est définie par l’entrée de résolution. | VIDEO | Oui | Au maximum 2560x1440 (2K) | +| `tool_version` | « standard » équilibre vitesse et qualité avec 10+ algorithmes d’amélioration. « professional » utilise 30+ algorithmes pour une restauration de qualité cinéma, prend environ 3x plus de temps et coûte 10x plus cher. | DYNAMIC_COMBO | Oui | "standard"
"professional" | +| `resolution` | Résolution de sortie. Le petit côté est défini au niveau choisi et le grand côté suit le ratio d’aspect de la source. « source » conserve la taille source, « custom » définit le petit côté en pixels. Les sources plus larges ou plus hautes qu’environ 2.2:1 sont facturées un palier de résolution au-dessus. | DYNAMIC_COMBO | Oui | "720p"
"1080p"
"2k"
"4k"
"8k"
"source"
"custom" | +| `fps` | Cadence de sortie. Une cadence supérieure à la source permet l’interpolation d’images par IA ; une cadence inférieure supprime des images. « source » conserve la cadence source, jusqu’à 120 fps. Les cadences au-dessus de 30 fps coûtent 2x, au-dessus de 60 fps 4x. (défaut : "source") | COMBO | Oui | "source" (défaut)
Cadences numériques jusqu’à 120 fps | +| `bitrate_level` | Débit binaire cible du fichier livré, adapté à la résolution et à la cadence de sortie. (défaut : "medium") | COMBO | Oui | "low"
"medium"
"high" | + +### Entrées standard + +Affichées lorsque `tool_version` est défini sur « standard ». + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `scene` | Préréglage adapté au contenu : « aigc » pour les séquences générées par IA, « common » pour les vidéos générales, « ugc » pour les clips téléphoniques compressés, « short_series » pour les drames avec visages, « old_film » pour les images d’archives rayées ou papillotantes. (défaut : "aigc") | COMBO | Oui | "aigc"
"common"
"ugc"
"short_series"
"old_film" | +| `enhance_style` | « hd » applique une amélioration plus nette ; « natural » réduit l’intensité pour un rendu plus doux et moins accentué. (défaut : "hd") | COMBO | Oui | "hd"
"natural" | + +### Entrées professionnelles + +Affichées lorsque `tool_version` est défini sur « professional ». + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `enhance_style` | « hd » applique une amélioration plus nette ; « natural » réduit l’intensité pour un rendu plus doux et moins accentué. (défaut : "hd") | COMBO | Oui | "hd"
"natural" | + +### Entrées de résolution personnalisée + +Affichées lorsque `resolution` est défini sur « custom ». + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `short_side` | Petit côté de la sortie en pixels ; le grand côté suit le ratio d’aspect de la source. (défaut : 1080) | INT | Oui | Défaut 1080 ; limité par les limites minimale et maximale du petit côté de vCube | + +### Remarques + +- La vidéo source doit être au maximum de 2560x1440 (2K). Les vidéos plus grandes sont rejetées et doivent être réduites avant l’amélioration. +- La durée de la vidéo source est limitée à la durée maximale prise en charge par le service vCube. +- Lorsque `tool_version` est défini sur « standard », `scene` et `enhance_style` sont tous deux disponibles. Lorsqu’il est défini sur « professional », seul `enhance_style` est disponible. +- Lorsque `resolution` est défini sur « custom », la valeur `short_side` est requise. Les préréglages de résolution et « source » n’utilisent pas `short_side`. +- Lorsque `resolution` est défini sur « source », la sortie conserve la résolution source. +- Lorsque `fps` est défini sur « source », la cadence de sortie correspond à la cadence source, jusqu’à 120 fps. + +## Sorties + +| Nom de sortie | Description | Type de données | +|---------------|-------------|-----------------| +| `video` | La vidéo améliorée, agrandie et restaurée à la résolution et à la cadence demandées. | VIDEO | + +> Cette documentation a été générée par IA. Si vous trouvez des erreurs ou avez des suggestions d'amélioration, n'hésitez pas à contribuer ! [Modifier sur GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/fr.md) + +--- +**Source fingerprint (SHA-256):** `bfdd55ce12cabd6e6504129084e86dcf96abd8db4ff64abbe5974c0da7a42bda` diff --git a/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/ja.md b/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/ja.md new file mode 100644 index 000000000..89a18da84 --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/ja.md @@ -0,0 +1,62 @@ +# ByteDanceVideoEnhanceNode + +このノードは、ByteDance vCube を使用して動画をアップスケールおよび復元します。最大8Kまでの解像度向上、圧縮アーティファクトとノイズの除去、色とシャープネスの向上、さらに任意でフレーム補間による高フレームレート化が可能です。動画は vCube サービスにアップロードされ、選択した高画質化プリセットで処理された後、高画質化された動画ファイルとして返されます。 + +## 入力 + +### 共通入力 + +これらの入力は常に表示されます。 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `video` | 高画質化する動画。ソース解像度は最大2560x1440(2K)である必要があります。出力サイズは解像度入力によって設定されます。 | VIDEO | はい | 最大2560x1440(2K) | +| `tool_version` | 'standard' は、10以上の高画質化アルゴリズムを使用して速度と品質のバランスを取ります。'professional' は、30以上のアルゴリズムを使用してシネマグレードの復元を行い、約3倍の時間がかかり、コストは10倍になります。 | DYNAMIC_COMBO | はい | "standard"
"professional" | +| `resolution` | 出力解像度。短辺が選択したレベルに設定され、長辺は元のアスペクト比に従います。'source' は元のサイズを維持し、'custom' は短辺をピクセル単位で設定します。約2.2:1より横長または縦長のソースは、解像度ランクが1段階高いものとして課金されます。 | DYNAMIC_COMBO | はい | "720p"
"1080p"
"2k"
"4k"
"8k"
"source"
"custom" | +| `fps` | 出力フレームレート。ソースより高いレートにするとAIフレーム補間が有効になり、低いレートにするとフレームが間引かれます。'source' はソースのレート(最大120 fps)を維持します。30 fpsを超えるレートは2倍、60 fpsを超えるレートは4倍のコストがかかります。(デフォルト: "source") | COMBO | はい | "source" (デフォルト)
最大120 fpsの数値フレームレート | +| `bitrate_level` | 納品ファイルの目標ビットレート。出力解像度とフレームレートに応じて調整されます。(デフォルト: "medium") | COMBO | はい | "low"
"medium"
"high" | + +### 標準入力 + +`tool_version` が "standard" に設定されている場合に表示されます。 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `scene` | コンテンツに合わせたプリセット。'aigc' はAI生成映像、'common' は一般的な動画、'ugc' は圧縮されたスマートフォン動画、'short_series' は人物が登場するドラマ、'old_film' は傷やフリッカーがあるアーカイブ映像用です。(デフォルト: "aigc") | COMBO | はい | "aigc"
"common"
"ugc"
"short_series"
"old_film" | +| `enhance_style` | 'hd' はよりシャープな高画質化を適用します。'natural' は強度を抑え、ソフトでシャープネスを抑えた仕上がりにします。(デフォルト: "hd") | COMBO | はい | "hd"
"natural" | + +### プロフェッショナル入力 + +`tool_version` が "professional" に設定されている場合に表示されます。 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `enhance_style` | 'hd' はよりシャープな高画質化を適用します。'natural' は強度を抑え、ソフトでシャープネスを抑えた仕上がりにします。(デフォルト: "hd") | COMBO | はい | "hd"
"natural" | + +### カスタム解像度入力 + +`resolution` が "custom" に設定されている場合に表示されます。 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `short_side` | 出力の短辺(ピクセル単位)。長辺は元のアスペクト比に従います。(デフォルト: 1080) | INT | はい | デフォルトは1080。vCubeの短辺の最小値と最大値の制限に従います。 | + +### 注記 + +- 元の動画は最大2560x1440(2K)である必要があります。これより大きい動画は拒否されるため、高画質化の前に縮小する必要があります。 +- 元の動画の長さは、vCubeサービスがサポートする最大長に制限されます。 +- `tool_version` が "standard" の場合は、`scene` と `enhance_style` の両方が使用できます。"professional" の場合は、`enhance_style` のみ使用できます。 +- `resolution` が "custom" の場合は、`short_side` の値が必須です。解像度プリセットと "source" では `short_side` は使用されません。 +- `resolution` が "source" の場合、出力は元の解像度を維持します。 +- `fps` が "source" の場合、出力フレームレートは元のフレームレート(最大120 fps)に一致します。 + +## 出力 + +| 出力名 | 説明 | データ型 | +|-------------|-------------|-----------| +| `video` | 要求された解像度とフレームレートにアップスケールおよび復元された高画質化済み動画。 | VIDEO | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/ja.md) + +--- +**Source fingerprint (SHA-256):** `bfdd55ce12cabd6e6504129084e86dcf96abd8db4ff64abbe5974c0da7a42bda` diff --git a/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/ko.md b/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/ko.md new file mode 100644 index 000000000..bec92eac8 --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/ko.md @@ -0,0 +1,62 @@ +# ByteDanceVideoEnhanceNode + +이 노드는 ByteDance vCube를 사용하여 비디오를 업스케일링하고 복원합니다. 최대 8K 해상도로 높이고, 압축 아티팩트와 노이즈를 제거하며, 색상과 선명도를 향상시키고, 선택적으로 프레임 보간을 적용하여 더 높은 프레임 레이트를 얻을 수 있습니다. 비디오는 vCube 서비스에 업로드되어 선택된 향상 프리셋으로 처리된 후 향상된 비디오 파일로 반환됩니다. + +## 입력 + +### 공통 입력 + +이 입력은 항상 표시됩니다. + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `video` | 향상할 비디오입니다. 소스 해상도는 최대 2560x1440(2K)이어야 하며, 출력 크기는 해상도 입력에 의해 설정됩니다. | VIDEO | 예 | 최대 2560x1440 (2K) | +| `tool_version` | 'standard'는 10개 이상의 향상 알고리즘으로 속도와 품질의 균형을 맞춥니다. 'professional'는 30개 이상의 알고리즘을 사용하여 시네마급 복원을 수행하며, 약 3배 더 오래 걸리고 비용은 10배 더 높습니다. | DYNAMIC_COMBO | 예 | "standard"
"professional" | +| `resolution` | 출력 해상도입니다. 짧은 변이 선택한 레벨로 설정되고 긴 변은 소스 종횡비를 따릅니다. 'source'는 소스 크기를 유지하고, 'custom'은 짧은 변을 픽셀 단위로 설정합니다. 약 2.2:1보다 넓거나 높은 소스는 해상도 등급이 한 단계 더 높게 청구됩니다. | DYNAMIC_COMBO | 예 | "720p"
"1080p"
"2k"
"4k"
"8k"
"source"
"custom" | +| `fps` | 출력 프레임 레이트입니다. 소스보다 높은 값은 AI 프레임 보간을 활성화하고, 낮은 값은 프레임을 드롭합니다. 'source'는 소스 프레임 레이트를 유지하며 최대 120fps입니다. 30fps를 초과하면 비용이 2배, 60fps를 초과하면 4배가 됩니다. (기본값: "source") | COMBO | 예 | "source" (기본값)
최대 120fps의 숫자 프레임 레이트 | +| `bitrate_level` | 출력 해상도와 프레임 레이트에 맞춰 조정된 전달 파일의 대상 비트레이트입니다. (기본값: "medium") | COMBO | 예 | "low"
"medium"
"high" | + +### 표준 입력 + +`tool_version`이(가) "standard"로 설정된 경우 표시됩니다. + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `scene` | 콘텐츠에 맞게 조정된 프리셋: 'aigc'는 AI 생성 영상, 'common'은 일반 비디오, 'ugc'는 압축된 휴대폰 클립, 'short_series'는 얼굴이 있는 드라마, 'old_film'은 스크래치나 깜빡임이 있는 아카이브 영상입니다. (기본값: "aigc") | COMBO | 예 | "aigc"
"common"
"ugc"
"short_series"
"old_film" | +| `enhance_style` | 'hd'는 더 선명한 향상을 적용하고, 'natural'은 강도를 낮추어 더 부드럽고 덜 선명한 느낌을 줍니다. (기본값: "hd") | COMBO | 예 | "hd"
"natural" | + +### 전문 입력 + +`tool_version`이(가) "professional"로 설정된 경우 표시됩니다. + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `enhance_style` | 'hd'는 더 선명한 향상을 적용하고, 'natural'은 강도를 낮추어 더 부드럽고 덜 선명한 느낌을 줍니다. (기본값: "hd") | COMBO | 예 | "hd"
"natural" | + +### 사용자 지정 해상도 입력 + +`resolution`이(가) "custom"으로 설정된 경우 표시됩니다. + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `short_side` | 출력의 짧은 변(픽셀)입니다. 긴 변은 소스 종횡비를 따릅니다. (기본값: 1080) | INT | 예 | 기본값 1080, vCube 최소/최대 짧은 변 제한에 따름 | + +### 참고 사항 + +- 소스 비디오는 최대 2560x1440(2K)이어야 합니다. 이보다 큰 비디오는 거부되며 향상 전에 크기를 줄여야 합니다. +- 소스 비디오 길이는 vCube 서비스에서 지원하는 최대 길이로 제한됩니다. +- `tool_version`이(가) "standard"인 경우 `scene`과 `enhance_style`을 모두 사용할 수 있습니다. "professional"인 경우 `enhance_style`만 사용할 수 있습니다. +- `resolution`이(가) "custom"인 경우 `short_side` 값이 필요합니다. 해상도 프리셋과 "source"는 `short_side`를 사용하지 않습니다. +- `resolution`이(가) "source"인 경우 출력은 소스 해상도를 유지합니다. +- `fps`이(가) "source"인 경우 출력 프레임 레이트는 소스 프레임 레이트와 일치하며 최대 120fps입니다. + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `video` | 요청된 해상도와 프레임 레이트로 업스케일링 및 복원된 향상된 비디오입니다. | VIDEO | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/ko.md) + +--- +**Source fingerprint (SHA-256):** `bfdd55ce12cabd6e6504129084e86dcf96abd8db4ff64abbe5974c0da7a42bda` diff --git a/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/pt-BR.md b/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/pt-BR.md new file mode 100644 index 000000000..4465a5bb2 --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/pt-BR.md @@ -0,0 +1,62 @@ +# ByteDanceVideoEnhanceNode + +Este nó amplia e restaura vídeos usando o ByteDance vCube. Ele pode aumentar a resolução até 8K, remover artefatos de compressão e ruído, melhorar cor e nitidez e, opcionalmente, interpolar quadros para uma taxa de quadros mais alta. O vídeo é enviado ao serviço vCube, processado com a predefinição de aprimoramento selecionada e retornado como um arquivo de vídeo aprimorado. + +## Entradas + +### Entradas Comuns + +Estas entradas estão sempre visíveis. + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | +|-----------|-------------|-----------|----------|-------| +| `video` | Vídeo a ser aprimorado. A resolução de origem deve ser de no máximo 2560x1440 (2K); o tamanho da saída é definido pela entrada de resolução. | VIDEO | Sim | No máximo 2560x1440 (2K) | +| `tool_version` | 'standard' equilibra velocidade e qualidade com 10+ algoritmos de aprimoramento. 'professional' usa 30+ algoritmos para restauração com qualidade de cinema, levando cerca de 3x mais tempo e custando 10x mais. | DYNAMIC_COMBO | Sim | "standard"
"professional" | +| `resolution` | Resolução de saída. O lado menor é definido para o nível escolhido e o lado maior segue a proporção de aspecto da origem. 'source' mantém o tamanho da origem, 'custom' define o lado menor em pixels. Origens mais largas ou mais altas que cerca de 2.2:1 são cobradas um nível de resolução acima. | DYNAMIC_COMBO | Sim | "720p"
"1080p"
"2k"
"4k"
"8k"
"source"
"custom" | +| `fps` | Taxa de quadros de saída. Uma taxa maior que a da origem permite interpolação de quadros por IA; uma menor descarta quadros. 'source' mantém a taxa da origem, até 120 fps. Taxas acima de 30 fps custam 2x, acima de 60 fps, 4x. (padrão: "source") | COMBO | Sim | "source" (padrão)
Taxas de quadros numéricas até 120 fps | +| `bitrate_level` | Taxa de bits alvo do arquivo entregue, dimensionada para a resolução de saída e a taxa de quadros. (padrão: "medium") | COMBO | Sim | "low"
"medium"
"high" | + +### Entradas Padrão + +Exibidas quando `tool_version` está definido como "standard". + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | +|-----------|-------------|-----------|----------|-------| +| `scene` | Predefinição ajustada ao conteúdo: 'aigc' para material gerado por IA, 'common' para vídeo geral, 'ugc' para clipes de celular comprimidos, 'short_series' para dramas com rostos, 'old_film' para material de arquivo arranhado ou com cintilação. (padrão: "aigc") | COMBO | Sim | "aigc"
"common"
"ugc"
"short_series"
"old_film" | +| `enhance_style` | 'hd' aplica um aprimoramento mais nítido; 'natural' reduz a intensidade para uma aparência mais suave e menos nítida. (padrão: "hd") | COMBO | Sim | "hd"
"natural" | + +### Entradas Profissionais + +Exibidas quando `tool_version` está definido como "professional". + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | +|-----------|-------------|-----------|----------|-------| +| `enhance_style` | 'hd' aplica um aprimoramento mais nítido; 'natural' reduz a intensidade para uma aparência mais suave e menos nítida. (padrão: "hd") | COMBO | Sim | "hd"
"natural" | + +### Entradas de Resolução Personalizada + +Exibidas quando `resolution` está definido como "custom". + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | +|-----------|-------------|-----------|----------|-------| +| `short_side` | Lado menor da saída em pixels; o lado maior segue a proporção de aspecto da origem. (padrão: 1080) | INT | Sim | Padrão 1080; limitado pelos limites mínimo e máximo de lado menor do vCube | + +### Notas + +- O vídeo de origem deve ter no máximo 2560x1440 (2K). Vídeos maiores que isso são rejeitados e devem ser reduzidos antes do aprimoramento. +- A duração do vídeo de origem é limitada à duração máxima suportada pelo serviço vCube. +- Quando `tool_version` é "standard", tanto `scene` quanto `enhance_style` estão disponíveis. Quando é "professional", apenas `enhance_style` está disponível. +- Quando `resolution` é "custom", o valor de `short_side` é obrigatório. As predefinições de resolução e "source" não usam `short_side`. +- Quando `resolution` é "source", a saída mantém a resolução da origem. +- Quando `fps` é "source", a taxa de quadros de saída corresponde à taxa de quadros da origem, até 120 fps. + +## Saídas + +| Nome da Saída | Descrição | Tipo de Dados | +|-------------|-------------|-----------| +| `video` | O vídeo aprimorado, ampliado e restaurado na resolução e taxa de quadros solicitadas. | VIDEO | + +> Esta documentação foi gerada por IA. Se você encontrar erros ou tiver sugestões de melhoria, sinta-se à vontade para contribuir! [Editar no GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/pt-BR.md) + +--- +**Source fingerprint (SHA-256):** `bfdd55ce12cabd6e6504129084e86dcf96abd8db4ff64abbe5974c0da7a42bda` diff --git a/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/ru.md b/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/ru.md new file mode 100644 index 000000000..f95978317 --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/ru.md @@ -0,0 +1,62 @@ +# ByteDanceVideoEnhanceNode + +Этот узел масштабирует и восстанавливает видео с помощью ByteDance vCube. Он может увеличивать разрешение до 8K, удалять артефакты сжатия и шум, улучшать цвет и резкость, а также опционально интерполировать кадры для более высокой частоты кадров. Видео загружается в сервис vCube, обрабатывается с выбранным пресетом улучшения и возвращается в виде улучшенного видеофайла. + +## Входные параметры + +### Общие входные параметры + +Эти входные параметры отображаются всегда. + +| Параметр | Описание | Тип данных | Обязательный | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `video` | Видео для улучшения. Исходное разрешение должно быть не более 2560x1440 (2K); размер выходного файла задаётся входным параметром `resolution`. | VIDEO | Да | Не более 2560x1440 (2K) | +| `tool_version` | Режим 'standard' обеспечивает баланс скорости и качества с использованием более 10 алгоритмов улучшения. Режим 'professional' использует более 30 алгоритмов для восстановления кинематографического качества, требует примерно в 3 раза больше времени и стоит в 10 раз дороже. | DYNAMIC_COMBO | Да | "standard"
"professional" | +| `resolution` | Выходное разрешение. Короткая сторона устанавливается в соответствии с выбранным уровнем, а длинная сторона сохраняет исходное соотношение сторон. Значение 'source' сохраняет исходный размер, 'custom' задаёт короткую сторону в пикселях. Исходные видео, у которых соотношение сторон более широкое или более высокое, чем примерно 2.2:1, тарифицируются на один уровень разрешения выше. | DYNAMIC_COMBO | Да | "720p"
"1080p"
"2k"
"4k"
"8k"
"source"
"custom" | +| `fps` | Выходная частота кадров. Значение выше исходной включает AI-интерполяцию кадров; ниже — удаляет кадры. Значение 'source' сохраняет исходную частоту, до 120 кадров/с. Частота выше 30 кадров/с стоит в 2 раза дороже, выше 60 кадров/с — в 4 раза. (по умолчанию: 'source') | COMBO | Да | "source" (default)
Числовые значения частоты кадров до 120 fps | +| `bitrate_level` | Целевой битрейт итогового файла, масштабируемый в соответствии с выходным разрешением и частотой кадров. (по умолчанию: 'medium') | COMBO | Да | "low"
"medium"
"high" | + +### Стандартные входные параметры + +Отображается, когда `tool_version` имеет значение 'standard'. + +| Параметр | Описание | Тип данных | Обязательный | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `scene` | Пресет, подобранный под содержимое: 'aigc' — для видео, сгенерированных ИИ, 'common' — для обычного видео, 'ugc' — для сжатых клипов с телефона, 'short_series' — для драматических сцен с лицами, 'old_film' — для повреждённых или мерцающих архивных материалов. (по умолчанию: 'aigc') | COMBO | Да | "aigc"
"common"
"ugc"
"short_series"
"old_film" | +| `enhance_style` | Режим 'hd' применяет более резкое улучшение; 'natural' снижает интенсивность для более мягкого, менее резкого вида. (по умолчанию: 'hd') | COMBO | Да | "hd"
"natural" | + +### Профессиональные входные параметры + +Отображается, когда `tool_version` имеет значение 'professional'. + +| Параметр | Описание | Тип данных | Обязательный | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `enhance_style` | Режим 'hd' применяет более резкое улучшение; 'natural' снижает интенсивность для более мягкого, менее резкого вида. (по умолчанию: 'hd') | COMBO | Да | "hd"
"natural" | + +### Входные параметры пользовательского разрешения + +Отображается, когда `resolution` имеет значение 'custom'. + +| Параметр | Описание | Тип данных | Обязательный | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `short_side` | Короткая сторона выходного видео в пикселях; длинная сторона сохраняет исходное соотношение сторон. (по умолчанию: 1080) | INT | Да | По умолчанию 1080; ограничено минимальным и максимальным допустимыми значениями короткой стороны в vCube | + +### Примечания + +- Исходное видео должно быть не более 2560x1440 (2K). Видео большего размера отклоняется; его необходимо уменьшить перед улучшением. +- Длительность исходного видео ограничена максимальной длительностью, поддерживаемой сервисом vCube. +- Когда `tool_version` имеет значение 'standard', доступны оба параметра `scene` и `enhance_style`. Когда `tool_version` имеет значение 'professional', доступен только `enhance_style`. +- Когда `resolution` имеет значение 'custom', параметр `short_side` обязателен. Пресеты разрешения и значение 'source' не используют `short_side`. +- Когда `resolution` имеет значение 'source', выходное разрешение сохраняет исходное. +- Когда `fps` имеет значение 'source', выходная частота кадров соответствует исходной, до 120 кадров/с. + +## Выходные параметры + +| Имя выхода | Описание | Тип данных | +|-------------|-------------|-----------| +| `video` | Улучшенное видео, масштабированное и восстановленное в запрошенном разрешении и с запрошенной частотой кадров. | VIDEO | + +> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/ru.md) + +--- +**Source fingerprint (SHA-256):** `bfdd55ce12cabd6e6504129084e86dcf96abd8db4ff64abbe5974c0da7a42bda` diff --git a/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/tr.md b/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/tr.md new file mode 100644 index 000000000..5c3f7a314 --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/tr.md @@ -0,0 +1,62 @@ +# ByteDanceVideoEnhanceNode + +Bu düğüm, ByteDance vCube kullanarak videoları yükseltir ve onarır. Çözünürlüğü 8K'ya kadar artırabilir, sıkıştırma artefaktlarını ve gürültüyü giderir, renk ve keskinliği iyileştirir ve isteğe bağlı olarak daha yüksek bir kare hızı için kare interpolasyonu yapar. Video vCube hizmetine yüklenir, seçilen iyileştirme ön ayarıyla işlenir ve iyileştirilmiş bir video dosyası olarak döndürülür. + +## Girdiler + +### Genel Girdiler + +Bu girdiler her zaman görünür. + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +|-----------|-------------|-----------|----------|-------| +| `video` | İyileştirilecek video. Kaynak çözünürlük en fazla 2560x1440 (2K) olmalıdır; çıktı boyutu, çözünürlük girdisi tarafından belirlenir. | VIDEO | Evet | En fazla 2560x1440 (2K) | +| `tool_version` | 'standard', 10+ iyileştirme algoritmasıyla hız ve kaliteyi dengeler. 'professional', sinema kalitesinde restorasyon için 30+ algoritma kullanır, yaklaşık 3 kat daha uzun sürer ve 10 kat daha pahalıdır. | DYNAMIC_COMBO | Evet | "standard"
"professional" | +| `resolution` | Çıktı çözünürlüğü. Kısa kenar seçilen seviyeye ayarlanır ve uzun kenar kaynak en-boy oranını takip eder. 'source' kaynak boyutunu korur, 'custom' kısa kenarı piksel cinsinden ayarlar. Yaklaşık 2.2:1'den daha geniş veya daha uzun kaynaklar, bir çözünürlük kademesi daha yüksekten faturalandırılır. | DYNAMIC_COMBO | Evet | "720p"
"1080p"
"2k"
"4k"
"8k"
"source"
"custom" | +| `fps` | Çıktı kare hızı. Kaynaktan daha yüksek bir hız, AI kare interpolasyonunu etkinleştirir; daha düşük bir hız kareleri düşürür. 'source' kaynak hızını korur, 120 fps'ye kadar. 30 fps'nin üzerindeki hızlar 2 kat, 60 fps'nin üzerindekiler 4 kat maliyetlidir. (varsayılan: "source") | COMBO | Evet | "source" (varsayılan)
120 fps'ye kadar sayısal kare hızları | +| `bitrate_level` | Teslim edilen dosyanın hedef bit hızı; çıktı çözünürlüğüne ve kare hızına göre ölçeklenir. (varsayılan: "medium") | COMBO | Evet | "low"
"medium"
"high" | + +### Standart Girdiler + +`tool_version` "standard" olarak ayarlandığında gösterilir. + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +|-----------|-------------|-----------|----------|-------| +| `scene` | İçeriğe göre ayarlanmış ön ayar: 'aigc' yapay zeka ile üretilmiş görüntüler için, 'common' genel video için, 'ugc' sıkıştırılmış telefon klipleri için, 'short_series' yüz içeren dramalar için, 'old_film' çizilmiş veya titreyen arşiv görüntüleri için. (varsayılan: "aigc") | COMBO | Evet | "aigc"
"common"
"ugc"
"short_series"
"old_film" | +| `enhance_style` | 'hd' daha keskin bir iyileştirme uygular; 'natural' daha yumuşak, daha az keskinleştirilmiş bir görünüm için gücü azaltır. (varsayılan: "hd") | COMBO | Evet | "hd"
"natural" | + +### Profesyonel Girdiler + +`tool_version` "professional" olarak ayarlandığında gösterilir. + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +|-----------|-------------|-----------|----------|-------| +| `enhance_style` | 'hd' daha keskin bir iyileştirme uygular; 'natural' daha yumuşak, daha az keskinleştirilmiş bir görünüm için gücü azaltır. (varsayılan: "hd") | COMBO | Evet | "hd"
"natural" | + +### Özel Çözünürlük Girdileri + +`resolution` "custom" olarak ayarlandığında gösterilir. + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +|-----------|-------------|-----------|----------|-------| +| `short_side` | Çıktının piksel cinsinden kısa kenarı; uzun kenar kaynak en-boy oranını takip eder. (varsayılan: 1080) | INT | Evet | Varsayılan 1080; vCube minimum ve maksimum kısa kenar sınırlarıyla sınırlıdır | + +### Notlar + +- Kaynak video en fazla 2560x1440 (2K) olmalıdır. Bundan daha büyük videolar reddedilir ve iyileştirmeden önce küçültülmesi gerekir. +- Kaynak video süresi, vCube hizmeti tarafından desteklenen maksimum süre ile sınırlıdır. +- `tool_version` "standard" olduğunda hem `scene` hem de `enhance_style` kullanılabilir. "professional" olduğunda yalnızca `enhance_style` kullanılabilir. +- `resolution` "custom" olduğunda, `short_side` değeri gereklidir. Çözünürlük ön ayarları ve "source", `short_side` kullanmaz. +- `resolution` "source" olduğunda, çıktı kaynak çözünürlüğünü korur. +- `fps` "source" olduğunda, çıktı kare hızı kaynak kare hızıyla eşleşir, 120 fps'ye kadar. + +## Çıktılar + +| Çıktı Adı | Açıklama | Veri Türü | +|-------------|-------------|-----------| +| `video` | İyileştirilmiş video; istenen çözünürlük ve kare hızında yükseltilmiş ve onarılmıştır. | VIDEO | + +> Bu belge yapay zeka tarafından oluşturulmuştur. Herhangi bir hata bulursanız veya iyileştirme önerileriniz varsa, katkıda bulunmaktan çekinmeyin! [GitHub'da Düzenle](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/tr.md) + +--- +**Source fingerprint (SHA-256):** `bfdd55ce12cabd6e6504129084e86dcf96abd8db4ff64abbe5974c0da7a42bda` diff --git a/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/zh-TW.md b/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/zh-TW.md new file mode 100644 index 000000000..352849073 --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/zh-TW.md @@ -0,0 +1,62 @@ +# ByteDanceVideoEnhanceNode + +此節點使用 ByteDance vCube 對影片進行放大與修復。可將解析度提升至 8K,移除壓縮偽影與雜訊、增強色彩與銳利度,並可選擇進行影格補插以獲得更高的幀率。影片會上傳至 vCube 服務,以所選的增強預設進行處理,最後回傳增強後的影片檔案。 + +## 輸入 + +### 通用輸入 + +這些輸入參數一律可見。 + +| 參數 | 說明 | 資料類型 | 必要 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `video` | 要增強的影片。來源解析度最高必須為 2560x1440(2K);輸出尺寸由解析度輸入決定。 | VIDEO | 是 | 最高 2560x1440(2K) | +| `tool_version` | 「standard」在速度與品質之間取得平衡,搭載 10 種以上的增強演算法;「professional」則使用 30 種以上演算法進行電影級修復,耗時約 3 倍,成本為 10 倍。 | DYNAMIC_COMBO | 是 | "standard"
"professional" | +| `resolution` | 輸出解析度。短邊設為所選等級,長邊依來源影片長寬比自動決定。「source」保留來源尺寸,「custom」以像素設定短邊。來源影片的寬高比若超過約 2.2:1,將以更高一個解析度等級計費。 | DYNAMIC_COMBO | 是 | "720p"
"1080p"
"2k"
"4k"
"8k"
"source"
"custom" | +| `fps` | 輸出幀率。高於來源幀率時會啟用 AI 影格補插;低於來源幀率時則會捨棄影格。「source」保留來源幀率,最高可達 120 fps。幀率高於 30 fps 費用為 2 倍,高於 60 fps 費用為 4 倍。(預設值:"source") | COMBO | 是 | "source" (default)
數值幀率,最高 120 fps | +| `bitrate_level` | 輸出檔案的目標位元率,會依輸出解析度與幀率進行縮放。(預設值:"medium") | COMBO | 是 | "low"
"medium"
"high" | + +### 標準輸入 + +當 `tool_version` 設為「standard」時顯示。 + +| 參數 | 說明 | 資料類型 | 必要 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `scene` | 依內容調校的預設模式:「aigc」適用於 AI 生成素材,「common」適用於一般影片,「ugc」適用於壓縮過的手機片段,「short_series」適用於包含人臉的戲劇,「old_film」適用於有刮痕或閃爍的檔案素材。(預設值:"aigc") | COMBO | 是 | "aigc"
"common"
"ugc"
"short_series"
"old_film" | +| `enhance_style` | 「hd」套用較銳利的增強效果;「natural」降低強度,呈現較柔和、較少銳利化的外觀。(預設值:"hd") | COMBO | 是 | "hd"
"natural" | + +### 專業輸入 + +當 `tool_version` 設為「professional」時顯示。 + +| 參數 | 說明 | 資料類型 | 必要 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `enhance_style` | 「hd」套用較銳利的增強效果;「natural」降低強度,呈現較柔和、較少銳利化的外觀。(預設值:"hd") | COMBO | 是 | "hd"
"natural" | + +### 自訂解析度輸入 + +當 `resolution` 設為「custom」時顯示。 + +| 參數 | 說明 | 資料類型 | 必要 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `short_side` | 輸出短邊的像素長度;長邊依來源影片長寬比自動決定。(預設值:1080) | INT | 是 | 預設值 1080;受限於 vCube 的最小與最大短邊限制 | + +### 注意事項 + +- 來源影片最高必須為 2560x1440(2K)。大於此尺寸的影片會被拒絕,必須先縮小尺寸再進行增強。 +- 來源影片的時長不得超過 vCube 服務支援的最大時長。 +- 當 `tool_version` 為「standard」時,`scene` 與 `enhance_style` 皆可使用;當其為「professional」時,僅 `enhance_style` 可使用。 +- 當 `resolution` 為「custom」時,必須提供 `short_side` 值。解析度預設選項與「source」不使用 `short_side`。 +- 當 `resolution` 為「source」時,輸出將保持來源解析度。 +- 當 `fps` 為「source」時,輸出幀率與來源幀率相同,最高可達 120 fps。 + +## 輸出 + +| 輸出名稱 | 說明 | 資料類型 | +|-------------|-------------|-----------| +| `video` | 增強後的影片,已按要求的解析度與幀率進行放大與修復。 | VIDEO | + +> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/zh-TW.md) + +--- +**Source fingerprint (SHA-256):** `bfdd55ce12cabd6e6504129084e86dcf96abd8db4ff64abbe5974c0da7a42bda` diff --git a/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/zh.md b/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/zh.md new file mode 100644 index 000000000..33ead07db --- /dev/null +++ b/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/zh.md @@ -0,0 +1,62 @@ +# ByteDanceVideoEnhanceNode + +此节点使用 ByteDance vCube 对视频进行放大和修复。它可以将分辨率提升至 8K,去除压缩伪影和噪点,增强色彩和清晰度,并可选择进行帧插值以获得更高帧率。视频将上传到 vCube 服务,使用所选增强预设进行处理,并作为增强后的视频文件返回。 + +## 输入 + +### 通用输入 + +始终显示以下输入。 + +| 参数 | 描述 | 数据类型 | 必填 | 范围 | +|------|------|---------|------|------| +| `video` | 要增强的视频。源分辨率最高必须为 2560x1440(2K);输出大小由分辨率输入设置。 | VIDEO | 是 | 最大 2560x1440(2K) | +| `tool_version` | 'standard' 在速度和质量之间取得平衡,包含 10 多种增强算法。'professional' 使用 30 多种算法进行电影级修复,耗时约 3 倍,费用高 10 倍。 | DYNAMIC_COMBO | 是 | "standard"
"professional" | +| `resolution` | 输出分辨率。短边设置为所选级别,长边保持源纵横比。'source' 保持源大小,'custom' 以像素为单位设置短边。宽高比超过约 2.2:1 的源按高一档分辨率计费。 | DYNAMIC_COMBO | 是 | "720p"
"1080p"
"2k"
"4k"
"8k"
"source"
"custom" | +| `fps` | 输出帧率。高于源帧率可启用 AI 帧插值;低于源帧率则丢帧。'source' 保持源帧率,最高 120 fps。超过 30 fps 费用为 2 倍,超过 60 fps 为 4 倍。(默认值:"source") | COMBO | 是 | "source"(默认)
最高 120 fps 的数字帧率 | +| `bitrate_level` | 交付文件的目标比特率,按输出分辨率和帧率缩放。(默认值:"medium") | COMBO | 是 | "low"
"medium"
"high" | + +### 标准输入 + +当 `tool_version` 设置为 "standard" 时显示。 + +| 参数 | 描述 | 数据类型 | 必填 | 范围 | +|------|------|---------|------|------| +| `scene` | 针对内容调校的预设:'aigc' 用于 AI 生成片段,'common' 用于普通视频,'ugc' 用于压缩的手机短片,'short_series' 用于含人脸剧集,'old_film' 用于有划痕或闪烁的档案素材。(默认值:"aigc") | COMBO | 是 | "aigc"
"common"
"ugc"
"short_series"
"old_film" | +| `enhance_style` | 'hd' 应用更锐利的增强效果;'natural' 降低强度,呈现更柔和、更少锐化的外观。(默认值:"hd") | COMBO | 是 | "hd"
"natural" | + +### 专业输入 + +当 `tool_version` 设置为 "professional" 时显示。 + +| 参数 | 描述 | 数据类型 | 必填 | 范围 | +|------|------|---------|------|------| +| `enhance_style` | 'hd' 应用更锐利的增强效果;'natural' 降低强度,呈现更柔和、更少锐化的外观。(默认值:"hd") | COMBO | 是 | "hd"
"natural" | + +### 自定义分辨率输入 + +当 `resolution` 设置为 "custom" 时显示。 + +| 参数 | 描述 | 数据类型 | 必填 | 范围 | +|------|------|---------|------|------| +| `short_side` | 输出短边的像素值;长边保持源纵横比。(默认值:1080) | INT | 是 | 默认 1080;受 vCube 最小和最大短边限制约束 | + +### 注意事项 + +- 源视频最大必须为 2560x1440(2K)。大于此分辨率的视频将被拒绝,必须在增强前缩小。 +- 源视频时长受 vCube 服务支持的最大时长限制。 +- 当 `tool_version` 为 "standard" 时,`scene` 和 `enhance_style` 均可用。为 "professional" 时,仅 `enhance_style` 可用。 +- 当 `resolution` 为 "custom" 时,必须提供 `short_side` 值。分辨率预设和 "source" 不使用 `short_side`。 +- 当 `resolution` 为 "source" 时,输出保持源分辨率。 +- 当 `fps` 为 "source" 时,输出帧率与源帧率一致,最高 120 fps。 + +## 输出 + +| 输出名称 | 描述 | 数据类型 | +|---------|------|---------| +| `video` | 增强后的视频,已按请求的分辨率和帧率进行放大和修复。 | VIDEO | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceVideoEnhanceNode/zh.md) + +--- +**Source fingerprint (SHA-256):** `bfdd55ce12cabd6e6504129084e86dcf96abd8db4ff64abbe5974c0da7a42bda` diff --git a/comfyui_embedded_docs/docs/CFGGuider/en.md b/comfyui_embedded_docs/docs/CFGGuider/en.md index a231fa47a..6a0b383fb 100644 --- a/comfyui_embedded_docs/docs/CFGGuider/en.md +++ b/comfyui_embedded_docs/docs/CFGGuider/en.md @@ -1,6 +1,6 @@ # CFG Guider -The CFGGuider node creates a guidance system for controlling the sampling process in image generation. It takes a model along with positive and negative conditioning inputs, then applies a classifier-free guidance scale to steer the generation toward desired content while avoiding unwanted elements. This node outputs a guider object that can be used by sampling nodes to control the image generation direction. +The CFG Guider node creates a guidance system for controlling the sampling process in image generation. It takes a model along with positive and negative conditioning inputs, then applies a classifier-free guidance scale to steer the generation toward desired content while avoiding unwanted elements. This node outputs a guider object that can be used by sampling nodes to control the image generation direction. ## Inputs @@ -20,4 +20,4 @@ The CFGGuider node creates a guidance system for controlling the sampling proces > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/CFGGuider/en.md) --- -**Source fingerprint (SHA-256):** `a723a359d0e0ac6ae83dc59d9eb459444b0c4a5361d54d54e22fb03ea34c16be` +**Source fingerprint (SHA-256):** `73b57bfbb6d4fc083a8089bc0f786f82d03e0d7b2faeeb7a42b3d87e38047b9e` diff --git a/comfyui_embedded_docs/docs/CFGNorm/en.md b/comfyui_embedded_docs/docs/CFGNorm/en.md index 751defebf..796ce58eb 100644 --- a/comfyui_embedded_docs/docs/CFGNorm/en.md +++ b/comfyui_embedded_docs/docs/CFGNorm/en.md @@ -1,6 +1,6 @@ # CFGNorm -The CFGNorm node applies a normalization technique to the classifier-free guidance (CFG) process in diffusion models. It adjusts the scale of the denoised prediction by comparing the norms of the conditional and unconditional outputs, then applies a strength multiplier to control the effect. This helps stabilize the generation process by preventing extreme values in the guidance scaling. +CFGNorm applies a normalization technique to the classifier-free guidance (CFG) process in diffusion models. It adjusts the scale of the denoised prediction by comparing the norms of the conditional and unconditional outputs, then applies a strength multiplier to control the effect. By default the normalization only attenuates the guidance output, but enabling `pre_cfg` rescales the combined noise before the sampler's CFG combine without clamping, which can amplify. ## Inputs @@ -8,6 +8,9 @@ The CFGNorm node applies a normalization technique to the classifier-free guidan | --- | --- | --- | --- | --- | | `model` | The diffusion model to apply CFG normalization to | MODEL | Yes | - | | `strength` | Controls the intensity of the normalization effect applied to the CFG scaling (default: 1.0) | FLOAT | Yes | 0.0 to 100.0 | +| `pre_cfg` | If true, rescale the combined noise BEFORE the sampler's CFG combine, without clamping (can amplify). Matches the norm-scaled CFG used by models like Lens. Default false keeps the original post-CFG x0-space attenuate-only behavior. (default: False) | BOOLEAN | No | true / false | + +Note: This node is marked as experimental. ## Outputs @@ -18,4 +21,4 @@ The CFGNorm node applies a normalization technique to the classifier-free guidan > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/CFGNorm/en.md) --- -**Source fingerprint (SHA-256):** `adbcea5c02277a7bd93866eaae75fe150b5b310dbc6e0a3a31c4e4ee0f71e57c` +**Source fingerprint (SHA-256):** `427dda498ebda2642489aa2591f063355a77b1e064e0dc7fa8570ed8200c2734` diff --git a/comfyui_embedded_docs/docs/CFGOverride/en.md b/comfyui_embedded_docs/docs/CFGOverride/en.md index 993a7fde5..bdde2ff8d 100644 --- a/comfyui_embedded_docs/docs/CFGOverride/en.md +++ b/comfyui_embedded_docs/docs/CFGOverride/en.md @@ -1,6 +1,6 @@ # CFG Override -The CFG Override node allows you to set a fixed CFG (Classifier-Free Guidance) scale value for a specific range of the sampling process, defined as a percentage of the total steps. When multiple CFG Override nodes are connected, the one closest to the sampler in the chain takes priority for overlapping ranges. +The CFG Override node lets you set a fixed CFG (Classifier-Free Guidance) scale value for a specific range of the sampling process, defined as a percentage of the total steps. When multiple CFG Override nodes are connected, the one closest to the sampler in the chain takes priority for overlapping ranges. ## Inputs @@ -20,4 +20,4 @@ The CFG Override node allows you to set a fixed CFG (Classifier-Free Guidance) s > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/CFGOverride/en.md) --- -**Source fingerprint (SHA-256):** `1fe57a4e78a2f18c4e7da49fa7a6c473d64dc0ebf6662535dfb5379c37936662` +**Source fingerprint (SHA-256):** `94c7d3751d90b42479f9cec4bdb3c95eeda405f51224f85d313ff12ec071ec58` diff --git a/comfyui_embedded_docs/docs/CLIPMergeAdd/en.md b/comfyui_embedded_docs/docs/CLIPMergeAdd/en.md index 21679fe9c..2eb58c28b 100644 --- a/comfyui_embedded_docs/docs/CLIPMergeAdd/en.md +++ b/comfyui_embedded_docs/docs/CLIPMergeAdd/en.md @@ -18,4 +18,4 @@ The CLIPMergeAdd node combines two CLIP models by adding patches from the second > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/CLIPMergeAdd/en.md) --- -**Source fingerprint (SHA-256):** `f212c2750f317ad51516a10a1a03a838b75bc878333381348d5eb388a2faf516` +**Source fingerprint (SHA-256):** `e6271ea9139598eb580f79ce63ff5d92307d7ed93f57cdc666c5e022b671a0dd` diff --git a/comfyui_embedded_docs/docs/CLIPMergeSubtract/en.md b/comfyui_embedded_docs/docs/CLIPMergeSubtract/en.md index e25450e64..c61a31850 100644 --- a/comfyui_embedded_docs/docs/CLIPMergeSubtract/en.md +++ b/comfyui_embedded_docs/docs/CLIPMergeSubtract/en.md @@ -8,7 +8,7 @@ The CLIPMergeSubtract node performs model merging by subtracting the weights of | --- | --- | --- | --- | --- | | `clip1` | The base CLIP model that will be cloned and modified | CLIP | Yes | - | | `clip2` | The CLIP model whose key patches will be subtracted from the base model | CLIP | Yes | - | -| `multiplier` | Controls the strength of the subtraction operation (default: 1.0) | FLOAT | Yes | -10.0 to 10.0 | +| `multiplier` | Controls the strength of the subtraction operation (default: 1.0) | FLOAT | Yes | -10.0 to 10.0 (step: 0.01) | **Note:** The node excludes `.position_ids` and `.logit_scale` parameters from the subtraction operation, regardless of the multiplier value. @@ -21,4 +21,4 @@ The CLIPMergeSubtract node performs model merging by subtracting the weights of > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/CLIPMergeSubtract/en.md) --- -**Source fingerprint (SHA-256):** `3136cf509fcbfa291af8f820928a6cc14de7a586f953af0ada9bea949b437d86` +**Source fingerprint (SHA-256):** `62a8cf719c34d9e2b7321f6eeb03c881f0767fd36b80e25e74feff4c0a29045e` diff --git a/comfyui_embedded_docs/docs/CLIPTextEncodeControlnet/en.md b/comfyui_embedded_docs/docs/CLIPTextEncodeControlnet/en.md index 9368943a0..e8acf2352 100644 --- a/comfyui_embedded_docs/docs/CLIPTextEncodeControlnet/en.md +++ b/comfyui_embedded_docs/docs/CLIPTextEncodeControlnet/en.md @@ -1,24 +1,24 @@ -# CLIPTextEncodeControlnet +# CLIP Text Encode (Controlnet) -The CLIPTextEncodeControlnet node processes text input using a CLIP model and combines it with existing conditioning data to create enhanced conditioning output for controlnet applications. It tokenizes the input text, encodes it through the CLIP model, and adds the resulting embeddings to the provided conditioning data as cross-attention controlnet parameters. +The CLIPTextEncodeControlnet node processes a text prompt using a CLIP model and combines the resulting text encoding with existing conditioning data. It adds the text-derived embeddings to each conditioning entry as controlnet cross-attention parameters, producing enhanced conditioning output for controlnet applications. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | | `clip` | The CLIP model used for text tokenization and encoding | CLIP | Yes | - | -| `conditioning` | Existing conditioning data to be enhanced with controlnet parameters | CONDITIONING | Yes | - | -| `text` | Text input to be processed by the CLIP model. Supports multiline text and dynamic prompts | STRING | Yes | - | +| `conditioning` | Existing conditioning data to be combined with the CLIP text encoding | CONDITIONING | Yes | - | +| `text` | The text prompt to be processed by the CLIP model. Supports multiline text and dynamic prompts | STRING | Yes | - | -**Note:** This node requires all three inputs (`clip`, `conditioning`, and `text`) to function properly. The `text` input supports dynamic prompts and multiline text for flexible text processing. +**Note:** All three inputs (`clip`, `conditioning`, and `text`) are required for this node to function. The `text` input supports multiline text and dynamic prompts for flexible text processing. This node is marked as experimental in the source code. ## Outputs | Output Name | Description | Data Type | | --- | --- | --- | -| `CONDITIONING` | Enhanced conditioning data with added controlnet cross-attention parameters (`cross_attn_controlnet` and `pooled_output_controlnet`) derived from the CLIP text encoding | CONDITIONING | +| `CONDITIONING` | Enhanced conditioning data with the added controlnet cross-attention parameters (`cross_attn_controlnet` and `pooled_output_controlnet`) derived from the CLIP text encoding | CONDITIONING | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/CLIPTextEncodeControlnet/en.md) --- -**Source fingerprint (SHA-256):** `36f0c9b7d3f3187bcf794c71e8a261d456972a41c079ddaca0cb5117912e9685` +**Source fingerprint (SHA-256):** `95a798684ca8734bfff53c7b979b320f6834dc1a9553163d0e567243761000f1` diff --git a/comfyui_embedded_docs/docs/CLIPTextEncodeHiDream/en.md b/comfyui_embedded_docs/docs/CLIPTextEncodeHiDream/en.md index 9175eba55..041f10cd3 100644 --- a/comfyui_embedded_docs/docs/CLIPTextEncodeHiDream/en.md +++ b/comfyui_embedded_docs/docs/CLIPTextEncodeHiDream/en.md @@ -23,4 +23,4 @@ The CLIPTextEncodeHiDream node processes four separate text inputs using differe > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/CLIPTextEncodeHiDream/en.md) --- -**Source fingerprint (SHA-256):** `4d0febcfc7fa8035d817a6b36ec80b9bdf176ede8446b49f291efd96b9d1371c` +**Source fingerprint (SHA-256):** `c5e269c17bd2dd7d7171c02598a87983a988d953dd7df285978fc25a9c896e46` diff --git a/comfyui_embedded_docs/docs/CLIPTextEncodeKandinsky5/en.md b/comfyui_embedded_docs/docs/CLIPTextEncodeKandinsky5/en.md index 1c8175218..769977b71 100644 --- a/comfyui_embedded_docs/docs/CLIPTextEncodeKandinsky5/en.md +++ b/comfyui_embedded_docs/docs/CLIPTextEncodeKandinsky5/en.md @@ -1,6 +1,6 @@ # CLIP Text Encode (Kandinsky 5) -The CLIPTextEncodeKandinsky5 node prepares text prompts for use with the Kandinsky 5 model. It takes two separate text inputs, tokenizes them using a provided CLIP model, and combines them into a single conditioning output. This output is used to guide the image generation process. +The CLIP Text Encode (Kandinsky 5) node prepares text prompts for use with the Kandinsky 5 model. It takes two separate text inputs, tokenizes them using a provided CLIP model, and combines them into a single conditioning output. This output is used to guide the image generation process. ## Inputs @@ -8,7 +8,7 @@ The CLIPTextEncodeKandinsky5 node prepares text prompts for use with the Kandins | --- | --- | --- | --- | --- | | `clip` | The CLIP model used to tokenize and encode the text prompts. | CLIP | Yes | | | `clip_l` | The primary text prompt. This input supports multiline text and dynamic prompts. | STRING | Yes | | -| `qwen25_7b` | A secondary text prompt. This input supports multiline text and dynamic prompts. | STRING | Yes | | +| `qwen25_7b` | The secondary text prompt. This input supports multiline text and dynamic prompts. | STRING | Yes | | ## Outputs @@ -19,4 +19,4 @@ The CLIPTextEncodeKandinsky5 node prepares text prompts for use with the Kandins > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/CLIPTextEncodeKandinsky5/en.md) --- -**Source fingerprint (SHA-256):** `f033b1924336ccb15d300eb713e859f9f08f48552b409c45b0a8a168d1ba51c2` +**Source fingerprint (SHA-256):** `d988c47ab9a5f01549a3ae01b365d39e9fa2464bb69ea018ec20151939dcfc56` diff --git a/comfyui_embedded_docs/docs/CLIPTextEncodeLumina2/en.md b/comfyui_embedded_docs/docs/CLIPTextEncodeLumina2/en.md index f4a27d40c..3b8d386dd 100644 --- a/comfyui_embedded_docs/docs/CLIPTextEncodeLumina2/en.md +++ b/comfyui_embedded_docs/docs/CLIPTextEncodeLumina2/en.md @@ -1,12 +1,12 @@ # CLIP Text Encode (Lumina 2) -The CLIP Text Encode for Lumina2 node encodes a system prompt and a user prompt using a CLIP model into an embedding that can guide the diffusion model to generate specific images. It combines a pre-defined system prompt with your custom text prompt and processes them through the CLIP model to create conditioning data for image generation. +This node encodes a system prompt and a user prompt using a CLIP model into an embedding that can be used to guide the diffusion model towards generating specific images. It combines a pre-defined Lumina 2 system prompt with your custom text prompt and processes them through the CLIP model to create conditioning data for image generation. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `system_prompt` | Lumina2 provides two types of system prompts: "superior" generates images with superior image-text alignment; "alignment" generates high-quality images with the highest degree of image-text alignment. | STRING | Yes | `"superior"`
`"alignment"` | +| `system_prompt` | Lumina2 provide two types of system prompts: Superior: You are an assistant designed to generate superior images with the superior degree of image-text alignment based on textual prompts or user prompts. Alignment: You are an assistant designed to generate high-quality images with the highest degree of image-text alignment based on textual prompts. | COMBO | Yes | `"superior"`
`"alignment"` | | `user_prompt` | The text to be encoded. Supports multiline input and dynamic prompts. | STRING | Yes | N/A | | `clip` | The CLIP model used for encoding the text. | CLIP | Yes | N/A | @@ -21,4 +21,4 @@ The CLIP Text Encode for Lumina2 node encodes a system prompt and a user prompt > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/CLIPTextEncodeLumina2/en.md) --- -**Source fingerprint (SHA-256):** `e9d5f685a666a4f0737739e56afa3eb854a4abcbd8a76480c7a050cd503b53b2` +**Source fingerprint (SHA-256):** `0c7540e6232c93b0f76c4903f5646e00a639ccb0b7720f70b5ac727513358a02` diff --git a/comfyui_embedded_docs/docs/CLIPTextEncodePixArtAlpha/en.md b/comfyui_embedded_docs/docs/CLIPTextEncodePixArtAlpha/en.md index 7ef704ed1..d36374803 100644 --- a/comfyui_embedded_docs/docs/CLIPTextEncodePixArtAlpha/en.md +++ b/comfyui_embedded_docs/docs/CLIPTextEncodePixArtAlpha/en.md @@ -5,19 +5,19 @@ Encodes text and sets the resolution conditioning for PixArt Alpha. This node pr ## Inputs | Parameter | Description | Data Type | Required | Range | -| --- | --- | --- | --- | --- | +|-----------|-------------|-----------|----------|-------| | `width` | The width dimension for resolution conditioning (default: 1024) | INT | Yes | 0 to MAX_RESOLUTION | | `height` | The height dimension for resolution conditioning (default: 1024) | INT | Yes | 0 to MAX_RESOLUTION | -| `text` | Text input to be encoded, supports multiline input and dynamic prompts | STRING | Yes | - | +| `text` | Text input to be encoded. Supports multiline input and dynamic prompts. | STRING | Yes | - | | `clip` | CLIP model used for tokenization and encoding | CLIP | Yes | - | ## Outputs | Output Name | Description | Data Type | -| --- | --- | --- | +|-------------|-------------|-----------| | `CONDITIONING` | Encoded conditioning data with text tokens and resolution information | CONDITIONING | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/CLIPTextEncodePixArtAlpha/en.md) --- -**Source fingerprint (SHA-256):** `d2ed9de57b9b9579162687e1ffaf859e18a0585bbe75888496a42772337b6746` +**Source fingerprint (SHA-256):** `d25a4117d39e3528cd0f64bc34462cd7b4076c67cb4e454c77fcc66490f89be6` diff --git a/comfyui_embedded_docs/docs/CLIPTextEncodeSD3/en.md b/comfyui_embedded_docs/docs/CLIPTextEncodeSD3/en.md index 85ed86bda..f0e12f739 100644 --- a/comfyui_embedded_docs/docs/CLIPTextEncodeSD3/en.md +++ b/comfyui_embedded_docs/docs/CLIPTextEncodeSD3/en.md @@ -1,6 +1,6 @@ # CLIP Text Encode (SD3) -The CLIPTextEncodeSD3 node processes text inputs for Stable Diffusion 3 models by encoding multiple text prompts using different CLIP models. It handles three separate text inputs (clip_g, clip_l, and t5xxl) and provides options for managing empty text padding. The node ensures proper token alignment between different text inputs and returns conditioning data suitable for SD3 generation pipelines. +CLIPTextEncodeSD3 processes text inputs for Stable Diffusion 3 models by encoding multiple text prompts using different CLIP models. It handles three separate text inputs (`clip_g`, `clip_l`, and `t5xxl`) and provides options for managing empty text padding. The node ensures proper token alignment between different text inputs and returns conditioning data suitable for SD3 generation pipelines. ## Inputs @@ -10,11 +10,11 @@ The CLIPTextEncodeSD3 node processes text inputs for Stable Diffusion 3 models b | `clip_l` | Text input for the local CLIP model. Supports multiline text and dynamic prompts. | STRING | Yes | - | | `clip_g` | Text input for the global CLIP model. Supports multiline text and dynamic prompts. | STRING | Yes | - | | `t5xxl` | Text input for the T5-XXL model. Supports multiline text and dynamic prompts. | STRING | Yes | - | -| `empty_padding` | Controls how empty text inputs are handled. When set to "none", empty text inputs for `clip_g`, `clip_l`, or `t5xxl` will result in empty token lists instead of padding. This is an advanced parameter (default: "none"). | COMBO | Yes | `"none"`
`"empty_prompt"` | +| `empty_padding` | Controls how empty text inputs are handled. When set to "none", empty text inputs for `clip_g`, `clip_l`, or `t5xxl` result in empty token lists instead of padding. When set to "empty_prompt", empty inputs are tokenized as empty prompts (standard padding behavior). This is an advanced parameter (default: "none"). | COMBO | Yes | `"none"`
`"empty_prompt"` | **Parameter Constraints:** -- When `empty_padding` is set to "none", empty text inputs for `clip_g`, `clip_l`, or `t5xxl` will result in empty token lists instead of padding +- When `empty_padding` is set to "none", empty text inputs for `clip_g`, `clip_l`, or `t5xxl` result in empty token lists instead of padding - The node automatically balances token lengths between `clip_l` and `clip_g` inputs by padding the shorter one with empty tokens when lengths differ - All text inputs support dynamic prompts and multiline text entry @@ -27,4 +27,4 @@ The CLIPTextEncodeSD3 node processes text inputs for Stable Diffusion 3 models b > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/CLIPTextEncodeSD3/en.md) --- -**Source fingerprint (SHA-256):** `2086e7c0fe910a94c04173ecfe35a2e04ecb306526b9089c527bb874e97b20c4` +**Source fingerprint (SHA-256):** `874869bac024e6b5ac6b4bf4f79c31bb750e54f7096f6638647aac6b95bb202f` diff --git a/comfyui_embedded_docs/docs/CheckpointLoader/en.md b/comfyui_embedded_docs/docs/CheckpointLoader/en.md index a8e4434bc..0656259a8 100644 --- a/comfyui_embedded_docs/docs/CheckpointLoader/en.md +++ b/comfyui_embedded_docs/docs/CheckpointLoader/en.md @@ -1,13 +1,13 @@ # Load Checkpoint With Config (DEPRECATED) -The CheckpointLoader node loads a pre-trained model checkpoint along with its configuration file. It takes a configuration file and a checkpoint file as inputs and returns the loaded model components including the main model, CLIP model, and VAE model for use in the workflow. +The CheckpointLoader node loads a pre-trained model checkpoint together with its configuration file. It takes a configuration file and a checkpoint file as inputs and returns the loaded model components — the main model, CLIP model, and VAE model — for use in the workflow. This node is deprecated. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `config_name` | The configuration file that defines the model architecture and settings | STRING | Yes | Available config files | -| `ckpt_name` | The checkpoint file containing the trained model weights and parameters | STRING | Yes | Available checkpoint files | +| `config_name` | The configuration file that defines the model architecture and settings | COMBO | Yes | Available config files | +| `ckpt_name` | The checkpoint file containing the trained model weights and parameters | COMBO | Yes | Available checkpoint files | **Note:** This node requires both a configuration file and a checkpoint file to be selected. The configuration file must match the architecture of the checkpoint file being loaded. @@ -24,4 +24,4 @@ The CheckpointLoader node loads a pre-trained model checkpoint along with its co > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/CheckpointLoader/en.md) --- -**Source fingerprint (SHA-256):** `9977bda5e124a9d10566839cbee868c74fab120c454141f27ce145efa60105e9` +**Source fingerprint (SHA-256):** `820cd9f7a5ccd5a70d2b29906c8deca3632d2ccba84ca51022717e061afb72b3` diff --git a/comfyui_embedded_docs/docs/CheckpointLoaderSimple/en.md b/comfyui_embedded_docs/docs/CheckpointLoaderSimple/en.md index 5d455be8b..9b5d80770 100755 --- a/comfyui_embedded_docs/docs/CheckpointLoaderSimple/en.md +++ b/comfyui_embedded_docs/docs/CheckpointLoaderSimple/en.md @@ -1,14 +1,12 @@ # Load Checkpoint -## Overview - Loads a diffusion model checkpoint file and decomposes it into three core components: the main model used for denoising latents, the CLIP text encoder, and the VAE image encoder/decoder. This node automatically detects all model files in the `ComfyUI/models/checkpoints` folder and any additional paths configured in your `extra_model_paths.yaml` file. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `ckpt_name` | The name of the checkpoint (model) to load. Select the checkpoint model file name, which determines the AI model used for subsequent image generation. | STRING | Yes | All model files in the checkpoints folder | +| `ckpt_name` | The name of the checkpoint (model) to load. Select the checkpoint model file name, which determines the AI model used for subsequent image generation. | COMBO | Yes | All model files in the checkpoints folder | **Note:** If new model files are added while ComfyUI is running, you need to refresh the browser (Ctrl+R) to see the new files in the dropdown list. @@ -23,4 +21,4 @@ Loads a diffusion model checkpoint file and decomposes it into three core compon > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/CheckpointLoaderSimple/en.md) --- -**Source fingerprint (SHA-256):** `2fd8866ae659f8080f46c16d3a9864fa563d2090815d897ea2f42ba8d66d9b39` +**Source fingerprint (SHA-256):** `db99a8ba83a586491463df0d4e99ba5f77d4511c6d8337a721d76edd3450f310` diff --git a/comfyui_embedded_docs/docs/ChromaRadianceOptions/en.md b/comfyui_embedded_docs/docs/ChromaRadianceOptions/en.md index dab632afe..ae39429ca 100644 --- a/comfyui_embedded_docs/docs/ChromaRadianceOptions/en.md +++ b/comfyui_embedded_docs/docs/ChromaRadianceOptions/en.md @@ -13,15 +13,15 @@ The ChromaRadianceOptions node allows you to configure advanced settings for the | `nerf_tile_size` | Allows overriding the default NeRF tile size. -1 means use the default (32). 0 means use non-tiling mode (may require a lot of VRAM). (default: -1) | INT | No | -1 and above | | `force_sequential_txt_ids` | Force usage of sequential text token IDs instead of zeroes. Should be used for checkpoints from 2026-05-22 to 2026-06-01 that are trained in this way but do not contain the __sequential__ key in the state dict. (default: False) | BOOLEAN | No | - | -**Note:** The Chroma Radiance options only take effect when the current sigma value falls between `end_sigma` and `start_sigma` (inclusive). The `nerf_tile_size` parameter is only applied when set to 0 or higher values. The `force_sequential_txt_ids` parameter is only applied when set to True. +**Note:** The Chroma Radiance options only take effect when the current sigma value falls between `end_sigma` and `start_sigma` (inclusive). The `nerf_tile_size` parameter is only applied when set to 0 or higher values. The `force_sequential_txt_ids` parameter is only applied when set to True. When `nerf_tile_size` is -1 and `force_sequential_txt_ids` is False, no options are configured and the model is returned unchanged without any wrapper applied. ## Outputs | Output Name | Description | Data Type | |-------------|-------------|-----------| -| `model` | The modified model with Chroma Radiance options applied | MODEL | +| `model` | The model with Chroma Radiance options applied, or the unchanged model if no options are active | MODEL | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ChromaRadianceOptions/en.md) --- -**Source fingerprint (SHA-256):** `4c93e4809e2948d633ccfc00460de470bdb125f7a2e9c3407f7dda178dd899b5` +**Source fingerprint (SHA-256):** `761f1946fe1fd77158e97f6f34d002e2445cc00e008741f8c37cde5673900409` diff --git a/comfyui_embedded_docs/docs/ClaudeNode/en.md b/comfyui_embedded_docs/docs/ClaudeNode/en.md index d14374843..e50e64639 100644 --- a/comfyui_embedded_docs/docs/ClaudeNode/en.md +++ b/comfyui_embedded_docs/docs/ClaudeNode/en.md @@ -1,32 +1,79 @@ -# ComfyUI Node Documentation +# Anthropic Claude -## Overview - -Generate text responses from an Anthropic Claude model. This node sends a text prompt and optional images to a Claude model and returns the generated text response. +Generate text responses from Anthropic's Claude models. Provide a text prompt and optionally one or more images for multimodal context, and the node returns the model's generated text response. ## Inputs +Inputs are grouped into common settings, model-specific settings that appear when a model is selected, and optional reference images. + +### Common Inputs + | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| +| `model` | The Claude model used to generate the response. Selecting a model reveals model-specific settings below. | DYNAMIC_COMBO | Yes | `"Opus 5"`
`"Opus 4.8"`
`"Fable 5"`
`"Sonnet 5"`
`"Opus 4.7"`
`"Opus 4.6"`
`"Sonnet 4.6"`
`"Sonnet 4.5"`
`"Haiku 4.5"` | | `prompt` | Text input to the model. (default: empty string) | STRING | Yes | N/A | -| `model` | The Claude model used to generate the response. | COMBO | Yes | `"Opus 4.7"`
`"Opus 4.6"`
`"Sonnet 4.6"`
`"Sonnet 4.5"`
`"Haiku 4.5"` | | `seed` | Seed controls whether the node should re-run; results are non-deterministic regardless of seed. (default: 0) | INT | Yes | 0 to 2147483647 | -| `images` | Optional image(s) to use as context for the model. Up to 20 images. | IMAGE | No | 0 to 20 images | | `system_prompt` | Foundational instructions that dictate the model's behavior. (default: empty string) | STRING | No | N/A | +### Opus 5 and Fable 5 Inputs + +These two models share the same settings. They do not expose a temperature setting, and reasoning is always enabled. + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `max_tokens` | Maximum number of tokens to generate (includes reasoning tokens when enabled). (default: 32768) | INT | Yes | 4096 to 64000 | +| `reasoning_effort` | Extended thinking effort. Reasoning is always enabled for this model. (default: "high") | COMBO | Yes | `"low"`
`"medium"`
`"high"` | + +### Opus 4.8 and Sonnet 5 Inputs + +These two models share the same settings. They do not expose a temperature setting. + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `max_tokens` | Maximum number of tokens to generate (includes reasoning tokens when enabled). (default: 32768) | INT | Yes | 4096 to 64000 | +| `reasoning_effort` | Extended thinking effort. `"off"` disables reasoning. (default: "off") | COMBO | Yes | `"off"`
`"low"`
`"medium"`
`"high"` | + +### Opus 4.7, Opus 4.6, Sonnet 4.6, and Sonnet 4.5 Inputs + +These four models share the same settings. + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `max_tokens` | Maximum number of tokens to generate (includes reasoning tokens when enabled). (default: 32768) | INT | Yes | 4096 to 64000 | +| `temperature` | Controls randomness. 0.0 is deterministic, 1.0 is most random. Ignored for Opus 4.7 and any model when `reasoning_effort` is set. (default: 1.0) | FLOAT | Yes | 0.0 to 1.0 (step: 0.01) | +| `reasoning_effort` | Extended thinking effort. `"off"` disables reasoning. (default: "off") | COMBO | Yes | `"off"`
`"low"`
`"medium"`
`"high"` | + +### Haiku 4.5 Inputs + +This model does not expose a `reasoning_effort` setting. + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `max_tokens` | Maximum number of tokens to generate (includes reasoning tokens when enabled). (default: 32768) | INT | Yes | 4096 to 64000 | +| `temperature` | Controls randomness. 0.0 is deterministic, 1.0 is most random. Ignored for Opus 4.7 and any model when `reasoning_effort` is set. (default: 1.0) | FLOAT | Yes | 0.0 to 1.0 (step: 0.01) | + +### Reference Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `images` | Optional image(s) to use as context for the model. Up to 20 images. Growable slot: connect 1 to 20 items (`image_1` ... `image_20`). | IMAGE | No | 0 to 20 images | + ### Parameter Constraints -- **Image Limit**: A maximum of 20 images can be provided per request. -- **Temperature Handling**: When thinking is enabled or when using the "Opus 4.7" model, the temperature parameter is automatically unset (defaults to 1.0) as required by the Anthropic API. For other models, temperature can be set via the model configuration. -- **Thinking/Reasoning**: The model configuration includes a `reasoning_effort` setting that controls whether thinking is enabled. When enabled, the node automatically configures the appropriate thinking mode (adaptive or budget-based) depending on the selected model. +- **Image limit:** A maximum of 20 images can be provided per request. Connecting more than 20 images raises an error. +- **Prompt required:** The prompt must contain at least one non-whitespace character. An empty prompt raises a validation error. +- **Temperature handling:** When thinking is enabled, the Anthropic API requires temperature to be unset (it defaults to 1.0). Opus 5, Opus 4.8, Fable 5, and Sonnet 5 do not expose a temperature setting. Opus 4.7 ignores `temperature`, and any model with `reasoning_effort` set to `"low"`, `"medium"`, or `"high"` also ignores it. +- **Reasoning/thinking behavior:** The `reasoning_effort` setting controls whether thinking is enabled. Opus 5 and Fable 5 always have reasoning enabled. Haiku 4.5 does not support reasoning. When thinking is enabled, the node uses the appropriate thinking mode for the selected model, either adaptive or budget-based. In budget mode, the reasoning token budget is capped to leave at least 1024 tokens for the actual response. +- **Safety refusal:** If Claude declines to answer the request for safety reasons, the node raises an error asking you to rephrase the prompt or try a different model. +- **Output text:** Thinking and reasoning blocks are not included in the output; only generated text is returned. ## Outputs | Output Name | Description | Data Type | |-------------|-------------|-----------| -| `output` | The generated text response from the Claude model. Returns "Empty response from Claude model." if no text is generated. | STRING | +| `output` | The generated text response from the Claude model. Thinking/reasoning blocks are not included. If no text is generated, returns "Empty response from Claude model." | STRING | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ClaudeNode/en.md) --- -**Source fingerprint (SHA-256):** `70fad3044edf9d1bc7cc82f3f6d89ca2d24857b039b829e7cc81265a7670430c` +**Source fingerprint (SHA-256):** `b0381e7981e5886d66b6976c7ddcad3f142bdd803271a6ac8567293dcddaa98a` diff --git a/comfyui_embedded_docs/docs/ClipLoader/en.md b/comfyui_embedded_docs/docs/ClipLoader/en.md index f0cc88a4b..89a531dc5 100755 --- a/comfyui_embedded_docs/docs/ClipLoader/en.md +++ b/comfyui_embedded_docs/docs/ClipLoader/en.md @@ -1,4 +1,4 @@ -# CLIPLoader +# Load CLIP The CLIPLoader node loads a text encoder model (CLIP, T5, or similar) from a file, making it available for use in other nodes that need to convert text prompts into numerical representations. It supports a wide variety of model architectures, each requiring a specific encoder type. @@ -7,8 +7,8 @@ The CLIPLoader node loads a text encoder model (CLIP, T5, or similar) from a fil | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| | `clip_name` | The filename of the text encoder model to load. This must be a file located in the `ComfyUI/models/text_encoders/` directory. | STRING | Yes | List of files found in the `text_encoders` folder | -| `type` | The architecture type of the model being loaded. This determines which specific encoder variant to use (default: `"stable_diffusion"`). | STRING | Yes | `"stable_diffusion"`
`"stable_cascade"`
`"sd3"`
`"stable_audio"`
`"mochi"`
`"ltxv"`
`"pixart"`
`"cosmos"`
`"lumina2"`
`"wan"`
`"hidream"`
`"chroma"`
`"ace"`
`"omnigen2"`
`"qwen_image"`
`"hunyuan_image"`
`"flux2"`
`"ovis"`
`"longcat_image"`
`"cogvideox"`
`"lens"`
`"pixeldit"`
`"ideogram4"` | -| `device` | The device to load the model onto. `"default"` uses the GPU if available, while `"cpu"` forces CPU loading. This is an advanced option (default: `"default"`). | STRING | No | `"default"`
`"cpu"` | +| `type` | The architecture type of the model being loaded. This determines which specific encoder variant to use (default: `"stable_diffusion"`). | COMBO | Yes | `"stable_diffusion"`
`"stable_cascade"`
`"sd3"`
`"stable_audio"`
`"mochi"`
`"ltxv"`
`"pixart"`
`"cosmos"`
`"lumina2"`
`"wan"`
`"hidream"`
`"chroma"`
`"ace"`
`"omnigen2"`
`"qwen_image"`
`"hunyuan_image"`
`"flux2"`
`"ovis"`
`"longcat_image"`
`"cogvideox"`
`"lens"`
`"pixeldit"`
`"ideogram4"`
`"boogu"`
`"krea2"`
`"joyimage"`
`"mage"`
`"minimax"` | +| `device` | The device to load the model onto. `"default"` uses the GPU if available, while `"cpu"` forces CPU loading. This is an advanced option (default: `"default"`). | COMBO | No | `"default"`
`"cpu"` | ### Supported Type-to-Encoder Mappings @@ -27,8 +27,10 @@ The `type` parameter selects the correct encoder for a given model architecture. | wan | umt5 xxl | | hidream | llama-3.1 (recommended) or t5 | | omnigen2 | qwen vl 2.5 3B | +| joyimage | qwen3-vl 8B | | lens | gpt-oss-20b | | pixeldit | gemma 2 2B elm | +| minimax | MiniMax H3 Qwen3-VL or Music3 Qwen/RVQ | ## Outputs @@ -39,4 +41,4 @@ The `type` parameter selects the correct encoder for a given model architecture. > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/CLIPLoader/en.md) --- -**Source fingerprint (SHA-256):** `c6101104b4616b867ad228142bd758d1a3efa6c28deaf609a8d7bccdf8b2a6be` +**Source fingerprint (SHA-256):** `7c1586d01410d319468f7c8c153ef0717280804add868ba57bff0c6539fb5dd9` diff --git a/comfyui_embedded_docs/docs/ClipMergeSimple/en.md b/comfyui_embedded_docs/docs/ClipMergeSimple/en.md index 652512e47..65a758ce4 100755 --- a/comfyui_embedded_docs/docs/ClipMergeSimple/en.md +++ b/comfyui_embedded_docs/docs/ClipMergeSimple/en.md @@ -1,16 +1,14 @@ # CLIPMergeSimple -`CLIPMergeSimple` is an advanced model merging node used to combine two CLIP text encoder models based on a specified ratio. - -This node specializes in merging two CLIP models based on a specified ratio, effectively blending their characteristics. It selectively applies patches from one model to another, excluding specific components like position IDs and logit scale, to create a hybrid model that combines features from both source models. +`CLIPMergeSimple` is a model merging node that combines two CLIP text encoder models based on a specified ratio. It clones the first CLIP model and applies weighted patches from the second CLIP model, skipping position IDs and logit scale components, to produce a hybrid model that blends features from both sources. ## Inputs -| Parameter | Description | Data Type | Input Type | Default | Range | -| --- | --- | --- | --- | --- | --- | -| `clip1` | The first CLIP model to be merged. It serves as the base model for the merging process. | CLIP | REQUIRED | - | - | -| `clip2` | The second CLIP model to be merged. Its key patches, except for position IDs and logit scale, are applied to the first model based on the specified ratio. | CLIP | REQUIRED | - | - | -| `ratio` | Determines the proportion of features from the second model to blend into the first model. A ratio of 1.0 means fully adopting the second model's features, while 0.0 retains only the first model's features. | FLOAT | REQUIRED | 1.0 | 0.0 - 1.0 (step: 0.01) | +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `clip1` | The first CLIP model to be merged. It serves as the base model for the merging process. | CLIP | Yes | - | +| `clip2` | The second CLIP model to be merged. Its key patches, except for position IDs and logit scale, are applied to the first model based on the specified ratio. | CLIP | Yes | - | +| `ratio` | Determines the proportion of features from the second model to blend into the first model. A ratio of 1.0 means fully adopting the second model's features, while 0.0 retains only the first model's features. Default: 1.0. | FLOAT | Yes | 0.0 - 1.0 (step: 0.01) | ## Outputs @@ -44,4 +42,4 @@ The node uses weighted averaging to merge the two models: > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/CLIPMergeSimple/en.md) --- -**Source fingerprint (SHA-256):** `0d3c8388dbe88675ea7fb51161ab41ce898bcf63983b3d2817b16ec5bfa613e5` +**Source fingerprint (SHA-256):** `42c4b2042c56c3f21a9416aa577e2d41fef1dcc749c4e5c7953851110a4fb6bc` diff --git a/comfyui_embedded_docs/docs/ClipSave/en.md b/comfyui_embedded_docs/docs/ClipSave/en.md index 61280de9d..359dc94d4 100755 --- a/comfyui_embedded_docs/docs/ClipSave/en.md +++ b/comfyui_embedded_docs/docs/ClipSave/en.md @@ -13,7 +13,7 @@ The `CLIPSave` node saves a CLIP text encoder model to disk in SafeTensors forma ## Outputs -This node has no output connections. It saves the processed files directly to the `ComfyUI/output/` directory. +This node has no output connections. It saves the processed files directly to the `ComfyUI/output/` directory. The saved files include metadata (the format is set to "pt", plus the workflow prompt and any extra PNG info) unless ComfyUI is started with the `--disable-metadata` argument. ### Saved File Details @@ -37,4 +37,4 @@ For each detected component, the node creates a file with the name `{filename_pr > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/CLIPSave/en.md) --- -**Source fingerprint (SHA-256):** `65a5856b0cbf8765b380887741d52af8ad50d2d5d36145c994a8cbf93ebc9807` +**Source fingerprint (SHA-256):** `4ab9171e4245b10f738f78bac8a5b564c0957dde352e207ec3f9865e4fac0cab` diff --git a/comfyui_embedded_docs/docs/ClipSetLastLayer/en.md b/comfyui_embedded_docs/docs/ClipSetLastLayer/en.md index 5a3b51154..b3e84fadd 100755 --- a/comfyui_embedded_docs/docs/ClipSetLastLayer/en.md +++ b/comfyui_embedded_docs/docs/ClipSetLastLayer/en.md @@ -10,23 +10,23 @@ Imagine the CLIP model as a 24-layer intelligent brain: `CLIP Set Last Layer` works like a **"thinking depth controller"**: --1: Use all 24 layers (complete understanding) --2: Stop at layer 23 (slightly simplified) --12: Stop at layer 13 (medium understanding) --24: Use only layer 1 (basic understanding) +- -1: Use all 24 layers (complete understanding) +- -2: Stop at layer 23 (slightly simplified) +- -12: Stop at layer 13 (medium understanding) +- -24: Use only layer 1 (basic understanding) ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | | `clip` | The CLIP model to be modified | CLIP | Yes | - | -| `stop_at_clip_layer` | Specifies which layer to stop at. A value of -1 uses all layers, while -24 uses only the first layer (default: -1) | INT | Yes | -24 to -1 | +| `stop_at_clip_layer` | Specifies which layer to stop at. A value of -1 uses all layers, while -24 uses only the first layer (default: -1). This is an advanced parameter. | INT | Yes | -24 to -1 (step: 1) | ## Outputs | Output Name | Description | Data Type | | --- | --- | --- | -| `clip` | The modified CLIP model with the specified layer set as the last one | CLIP | +| `clip` | The modified CLIP model (a clone of the input; the original CLIP model is not changed) with the specified layer set as the last one | CLIP | ## Why Set the Last Layer @@ -37,4 +37,4 @@ Imagine the CLIP model as a 24-layer intelligent brain: > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/CLIPSetLastLayer/en.md) --- -**Source fingerprint (SHA-256):** `82f3e7fb1d4c0bdd2b242a449085a5497ba8af8616d1800c5c0ee7a85ab42c15` +**Source fingerprint (SHA-256):** `41a7feb9729dbb2a987a15a53c56641eae2a5611db8762ef2ce14b58970752fe` diff --git a/comfyui_embedded_docs/docs/ClipTextEncode/en.md b/comfyui_embedded_docs/docs/ClipTextEncode/en.md index 84f84552d..bab877b28 100755 --- a/comfyui_embedded_docs/docs/ClipTextEncode/en.md +++ b/comfyui_embedded_docs/docs/ClipTextEncode/en.md @@ -11,6 +11,8 @@ Think of it as communicating with an artist who speaks a different language. The | `text` | The text to be encoded. Supports multi-line input and dynamic prompts. | STRING | Yes | Any text | | `clip` | The CLIP model used for encoding the text. | CLIP | Yes | Loaded CLIP models | +Note: If the `clip` input is None (for example, when it comes from a checkpoint loader whose checkpoint does not contain a valid CLIP or text encoder model), the node raises an error. + ## Outputs | Output Name | Description | Data Type | @@ -55,5 +57,4 @@ If you want to include literal curly braces in your prompt without triggering dy > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/CLIPTextEncode/en.md) --- - -**Source fingerprint (SHA-256):** `e8f286cdec879c529270e110ccf5959ed6df77737cfb5a8019379afac9266118` +**Source fingerprint (SHA-256):** `ace7988df7aaa3ac26419b16a9bd8908a327da6e82c21c2b2704af091d2e76e7` diff --git a/comfyui_embedded_docs/docs/ClipTextEncodeFlux/en.md b/comfyui_embedded_docs/docs/ClipTextEncodeFlux/en.md index 34f0762ad..3bd75bce4 100644 --- a/comfyui_embedded_docs/docs/ClipTextEncodeFlux/en.md +++ b/comfyui_embedded_docs/docs/ClipTextEncodeFlux/en.md @@ -9,7 +9,7 @@ | `clip` | A CLIP model that supports the Flux architecture, including both CLIP-L and T5XXL encoders. | CLIP | Yes | - | | `clip_l` | Text input processed by the CLIP-L encoder. Suitable for concise keyword descriptions, such as style or theme. Supports multiline input and dynamic prompts. | STRING | Yes | - | | `t5xxl` | Text input processed by the T5XXL encoder. Suitable for detailed natural language descriptions, expressing complex scenes and details. Supports multiline input and dynamic prompts. | STRING | Yes | - | -| `guidance` | Controls the influence of text conditions on the generation process. Higher values mean stricter adherence to the text. Default: 3.5. | FLOAT | Yes | 0.0 - 100.0 | +| `guidance` | Controls the influence of text conditions on the generation process. Higher values mean stricter adherence to the text. Default: 3.5. Adjustable in increments of 0.1. | FLOAT | Yes | 0.0 - 100.0 | ## Outputs @@ -20,4 +20,4 @@ > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/CLIPTextEncodeFlux/en.md) --- -**Source fingerprint (SHA-256):** `63027b4a7c1868da27fb2644b0d6599d241fa0206a78d169110ce57f0cebf148` +**Source fingerprint (SHA-256):** `022928fa6917102f5dc599364df9541b2451b42eb36a11813931b5fd71990b74` diff --git a/comfyui_embedded_docs/docs/ClipTextEncodeHunyuanDit/en.md b/comfyui_embedded_docs/docs/ClipTextEncodeHunyuanDit/en.md index 4c1727611..c840b08bb 100644 --- a/comfyui_embedded_docs/docs/ClipTextEncodeHunyuanDit/en.md +++ b/comfyui_embedded_docs/docs/ClipTextEncodeHunyuanDit/en.md @@ -1,6 +1,6 @@ # CLIP Text Encode (Hunyuan Image) -The `CLIPTextEncodeHunyuanDiT` node converts text descriptions into a format that the HunyuanDiT model can understand. It is an advanced conditioning node designed for the dual text encoder architecture of HunyuanDiT, processing two separate text inputs through different tokenizers. +The `CLIPTextEncodeHunyuanDiT` node converts text descriptions into a format that the HunyuanDiT model can understand. It is an advanced conditioning node designed for the dual text encoder architecture of HunyuanDiT, processing two separate text inputs through different tokenizers and combining their results into a single conditioning output. ## Inputs @@ -19,4 +19,4 @@ The `CLIPTextEncodeHunyuanDiT` node converts text descriptions into a format tha > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/CLIPTextEncodeHunyuanDiT/en.md) --- -**Source fingerprint (SHA-256):** `bde7c884f72829491090965bd9af34ad59ec326f96e88bb7cdb9ddc47592137e` +**Source fingerprint (SHA-256):** `550e8c09b8b74974576a852a9b690a87a0156ef49fe7ec1050b10415c6af78aa` diff --git a/comfyui_embedded_docs/docs/ColorToRGBInt/en.md b/comfyui_embedded_docs/docs/ColorToRGBInt/en.md index 4180e2170..9187faded 100644 --- a/comfyui_embedded_docs/docs/ColorToRGBInt/en.md +++ b/comfyui_embedded_docs/docs/ColorToRGBInt/en.md @@ -1,23 +1,24 @@ -# ColorToRGBInt +# Color Picker -The **ColorToRGBInt** node converts a color specified in hexadecimal format (like `#FF5733`) into a single integer value. It takes the red, green, and blue components from the color string and combines them into one RGB integer, while also returning the original hexadecimal representation. +The **ColorToRGBInt** node converts a color given in hexadecimal format (like `#FF5733`) into a single RGB integer value. It extracts the red, green, and blue components from the color string, combines them into one integer, and also returns the original hexadecimal representation and the alpha (opacity) value. ## Inputs | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `color` | A color value in the hexadecimal format `#RRGGBB`. Must be exactly 7 characters long and start with `#`. | STRING | Yes | N/A | +| `color` | A color value in the hexadecimal format `#RRGGBB` or `#RRGGBBAA`. Must be 7 or 9 characters long and start with `#`. | COLOR | Yes | `#RRGGBB`
`#RRGGBBAA` | -**Note:** The input `color` string must follow the format `#RRGGBB` exactly. If the string is not 7 characters long or does not start with `#`, the node will raise an error. +**Note:** The input `color` string must follow the format `#RRGGBB` or `#RRGGBBAA`. If it is not 7 or 9 characters long, does not start with `#`, or contains invalid hexadecimal characters, the node raises an error. ## Outputs | Output Name | Description | Data Type | |-------------|-------------|-----------| -| `rgb_int` | The calculated RGB integer value. This is derived from the formula: `(Red * 65536) + (Green * 256) + Blue`. | INT | -| `hex` | The original hexadecimal color string in the format `#RRGGBB`. | STRING | +| `rgb_int` | The calculated RGB integer value, derived from the formula: `(Red * 65536) + (Green * 256) + Blue`. | INT | +| `hex` | The hexadecimal color string in the format `#RRGGBB`. If the input included an alpha channel, it is removed from this output. | COLOR | +| `alpha` | The alpha (opacity) value between 0.0 and 1.0. Equals 1.0 when the input is `#RRGGBB`, or the alpha channel value divided by 255 when the input is `#RRGGBBAA`. | FLOAT | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ColorToRGBInt/en.md) --- -**Source fingerprint (SHA-256):** `7ab6b8452b71d47e5b38d75c9b60d90d73c6b24e02d2c7d3694e05e1b2818edc` +**Source fingerprint (SHA-256):** `4e64616d168beee73bca4364d47e2a089418b5046a76bfcfa061dfab9a5e49ed` diff --git a/comfyui_embedded_docs/docs/ComboOptionTestNode/en.md b/comfyui_embedded_docs/docs/ComboOptionTestNode/en.md index c4c8a426b..706b96ac8 100644 --- a/comfyui_embedded_docs/docs/ComboOptionTestNode/en.md +++ b/comfyui_embedded_docs/docs/ComboOptionTestNode/en.md @@ -19,4 +19,4 @@ The ComboOptionTestNode is a logic node designed to test and pass through combo > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ComboOptionTestNode/en.md) --- -**Source fingerprint (SHA-256):** `efa45d1310ff9c623afb858b6f561739c3d7ee9fc84b57c64746693a27906bec` +**Source fingerprint (SHA-256):** `fe0b6a35680de55767af2c0d8a293010ddb4c4282cfdde7f9dff7a3a11ff1e5c` diff --git a/comfyui_embedded_docs/docs/ComfyAndNode/en.md b/comfyui_embedded_docs/docs/ComfyAndNode/en.md index 99d2af7f3..f8f3ec3b7 100644 --- a/comfyui_embedded_docs/docs/ComfyAndNode/en.md +++ b/comfyui_embedded_docs/docs/ComfyAndNode/en.md @@ -1,14 +1,12 @@ # And -## Overview - The And node performs a logical AND operation on a set of input values. It returns `true` only if all of the provided values are considered truthy according to Python's truthiness rules. This node is useful for checking that multiple conditions are all met before proceeding. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `values` | A list of values to evaluate. The node accepts at least one value, and you can add more by clicking the "+" button on the node. | ANY | Yes | 1 or more values | +| `values` | A value to evaluate. The node accepts at least one value, and you can add more by clicking the "+" button on the node. Accepts any data type. | ANY | Yes | 1 or more (no maximum) | **Note:** The node uses Python's truthiness rules to determine if a value is `true` or `false`. For example, an empty string, the number 0, an empty list, and `None` are all considered `false`. All other values are considered `true`. @@ -21,4 +19,4 @@ The And node performs a logical AND operation on a set of input values. It retur > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ComfyAndNode/en.md) --- -**Source fingerprint (SHA-256):** `fd9d18ce698472a7e35ad3082f2ccff8ae264b11bd887a498f929cd877ff38c4` +**Source fingerprint (SHA-256):** `e7359c46da62f9859ea4f4a239cf20c565b5f7de22d280afc00c7ca321f1c89d` diff --git a/comfyui_embedded_docs/docs/ComfyNotNode/en.md b/comfyui_embedded_docs/docs/ComfyNotNode/en.md index bb524a3de..6e6c339a8 100644 --- a/comfyui_embedded_docs/docs/ComfyNotNode/en.md +++ b/comfyui_embedded_docs/docs/ComfyNotNode/en.md @@ -1,7 +1,5 @@ # Not -## Overview - The Not node performs a logical NOT operation on any input value. It returns True if the input value is considered falsy (like 0, empty string, None, False), and returns False if the input value is truthy. It uses Python's standard rules for determining truthiness. ## Inputs @@ -19,4 +17,4 @@ The Not node performs a logical NOT operation on any input value. It returns Tru > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ComfyNotNode/en.md) --- -**Source fingerprint (SHA-256):** `fd8f940218538fce28079bc836379703c0e3c04f80351520497855c464176877` +**Source fingerprint (SHA-256):** `24bbe667a0800b187d991b24894794e2ce710256200a2667ff391c1e644963a5` diff --git a/comfyui_embedded_docs/docs/ComfyNumberConvert/en.md b/comfyui_embedded_docs/docs/ComfyNumberConvert/en.md index 4959d117c..38ee3dfc8 100644 --- a/comfyui_embedded_docs/docs/ComfyNumberConvert/en.md +++ b/comfyui_embedded_docs/docs/ComfyNumberConvert/en.md @@ -8,7 +8,7 @@ The Number Convert node transforms various input data types into numeric values. | --- | --- | --- | --- | --- | | `value` | The value to be converted into numeric outputs. Accepts an integer, a floating-point number, a text string, or a true/false boolean. | INT, FLOAT, STRING, BOOLEAN | Yes | N/A | -**Note:** When the input is a string, it must not be empty and must contain a valid representation of a number (e.g., `"123"`, `"3.14"`). The node will raise an error for empty strings, text that cannot be parsed as a number, or values that are not finite (like `"inf"` or `"nan"`). For boolean inputs, `true` converts to 1.0 (FLOAT) and 1 (INT), while `false` converts to 0.0 (FLOAT) and 0 (INT). For float inputs, the integer output is obtained by truncating the decimal portion. +**Note:** When the input is a string, it must not be empty and must contain a valid representation of a number (e.g., `"123"`, `"3.14"`). The node will raise an error for empty strings, text that cannot be parsed as a number, or values that are not finite (like `"inf"` or `"nan"`). For boolean inputs, `true` converts to 1.0 (FLOAT) and 1 (INT), while `false` converts to 0.0 (FLOAT) and 0 (INT). For float inputs and for strings that contain a decimal number, the integer output is obtained by truncating the decimal portion. ## Outputs @@ -20,4 +20,4 @@ The Number Convert node transforms various input data types into numeric values. > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ComfyNumberConvert/en.md) --- -**Source fingerprint (SHA-256):** `3a5501a3916df827b0376e4ba9c8b9972a91485cca38e067b683bb5f96c1d53c` +**Source fingerprint (SHA-256):** `d6a774bf7c3ad9482b2275adc6ccc9e47c82b1f35f11c5a241b00efd29526f94` diff --git a/comfyui_embedded_docs/docs/ComfyOrNode/en.md b/comfyui_embedded_docs/docs/ComfyOrNode/en.md index 1790a6da3..659c1966d 100644 --- a/comfyui_embedded_docs/docs/ComfyOrNode/en.md +++ b/comfyui_embedded_docs/docs/ComfyOrNode/en.md @@ -1,12 +1,12 @@ # Or -The ComfyOrNode performs a logical OR operation on a set of input values. It returns `true` if any of the provided values are considered truthy according to Python's standard truthiness rules. +The Or node performs a logical OR operation on a set of input values. It returns `true` if any of the provided values are considered truthy according to Python's standard truthiness rules. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `value` | A value to evaluate for truthiness. You can provide multiple values by adding more inputs. The node returns `true` if any of these values is truthy. | ANY | Yes | Multiple values accepted | +| `values` | A growable collection of values to evaluate for truthiness. Each added input slot is named `value_1`, `value_2`, and so on. The node returns `true` if any of these values is truthy. | ANY | Yes | 1 or more values | **Note:** The node accepts a minimum of 1 input value. You can add more inputs as needed using the autogrow feature. @@ -19,4 +19,4 @@ The ComfyOrNode performs a logical OR operation on a set of input values. It ret > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ComfyOrNode/en.md) --- -**Source fingerprint (SHA-256):** `00c60d5c80bbddc993af0bcd92e35dc77f153731329c23a6e4e9a980709111b1` +**Source fingerprint (SHA-256):** `f673aa2b0d754f55c51ba9c9ceea7d9de9a21d2e7308bd1281b4d4461243e4ad` diff --git a/comfyui_embedded_docs/docs/ComfySoftSwitchNode/en.md b/comfyui_embedded_docs/docs/ComfySoftSwitchNode/en.md index 0888e97a0..80fc5b139 100644 --- a/comfyui_embedded_docs/docs/ComfySoftSwitchNode/en.md +++ b/comfyui_embedded_docs/docs/ComfySoftSwitchNode/en.md @@ -6,19 +6,19 @@ The Soft Switch node selects between two possible input values based on a boolea | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `switch` | The boolean condition that determines which input to pass through. When true, the `on_true` input is selected. When false, the `on_false` input is selected. | BOOLEAN | Yes | | -| `on_false` | The value to output when the `switch` condition is false. This input is optional, but at least one of `on_false` or `on_true` must be connected. | MATCH_TYPE | No | | -| `on_true` | The value to output when the `switch` condition is true. This input is optional, but at least one of `on_false` or `on_true` must be connected. | MATCH_TYPE | No | | +| `switch` | The boolean condition that determines which input to pass through. When true, the `on_true` input is selected. When false, the `on_false` input is selected. | BOOLEAN | Yes | True or False | +| `on_false` | The value to output when the `switch` condition is false. This input is optional, but at least one of `on_false` or `on_true` must be connected. | MATCH_TYPE | No | Same data type as `on_true` | +| `on_true` | The value to output when the `switch` condition is true. This input is optional, but at least one of `on_false` or `on_true` must be connected. | MATCH_TYPE | No | Same data type as `on_false` | -**Note:** The `on_false` and `on_true` inputs must be of the same data type, as defined by the node's internal template. At least one of these two inputs must be connected for the node to function. +**Note:** The `on_false` and `on_true` inputs must be of the same data type, as defined by the node's internal template. At least one of these two inputs must be connected for the node to function. Because the node is lazy, when only one input is connected, the node always outputs that input's value regardless of the `switch` state. ## Outputs | Output Name | Description | Data Type | | --- | --- | --- | -| `output` | The selected value. It will match the data type of the connected `on_false` or `on_true` input. | MATCH_TYPE | +| `output` | The selected value. It matches the data type of the connected `on_false` or `on_true` input. When both inputs are connected, it outputs `on_true` if `switch` is true, and `on_false` if `switch` is false. | MATCH_TYPE | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ComfySoftSwitchNode/en.md) --- -**Source fingerprint (SHA-256):** `3ddfebaf67642f5bd79b0de38605f93507ede00d95e98cd78ec295f8de98d743` +**Source fingerprint (SHA-256):** `7bf4bed69d8fd8c360e971ab8068382cd8ebaa02004d5df44312977a7309ae00` diff --git a/comfyui_embedded_docs/docs/ComfySwitchNode/en.md b/comfyui_embedded_docs/docs/ComfySwitchNode/en.md index 61f9f7a69..ecd123a22 100644 --- a/comfyui_embedded_docs/docs/ComfySwitchNode/en.md +++ b/comfyui_embedded_docs/docs/ComfySwitchNode/en.md @@ -1,6 +1,6 @@ -# Switch +# If/Else Switch -The Switch node selects between two possible inputs based on a boolean condition. It outputs the `on_true` input when the `switch` is enabled, and the `on_false` input when the `switch` is disabled. This allows you to create conditional logic and choose different data paths in your workflow. +The Switch node selects between two possible inputs based on a boolean condition. It outputs the `on_true` input when the `switch` is enabled, and the `on_false` input when the `switch` is disabled. Only the selected branch is evaluated, so the other input is not required. This allows you to create conditional logic and choose different data paths in your workflow. ## Inputs @@ -10,7 +10,7 @@ The Switch node selects between two possible inputs based on a boolean condition | `on_false` | The data to be passed to the output when the `switch` is disabled (false). This input is only required when the `switch` is false. | MATCH_TYPE | No | | | `on_true` | The data to be passed to the output when the `switch` is enabled (true). This input is only required when the `switch` is true. | MATCH_TYPE | No | | -**Note on Input Requirements:** The `on_false` and `on_true` inputs are conditionally required. The node will request the `on_true` input only when the `switch` is true, and the `on_false` input only when the `switch` is false. Both inputs must be of the same data type. +**Note on Input Requirements:** The `on_false` and `on_true` inputs are conditionally required. The node will request the `on_true` input only when the `switch` is true, and the `on_false` input only when the `switch` is false. Both inputs must be of the same data type and must match the output data type. ## Outputs @@ -21,4 +21,4 @@ The Switch node selects between two possible inputs based on a boolean condition > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ComfySwitchNode/en.md) --- -**Source fingerprint (SHA-256):** `6709dc66cf1c52bb31bde2cccd70324691261a03dfbab813b7196e20c0a4cb63` +**Source fingerprint (SHA-256):** `d0adda02e7f997f27182cb26e11e934660ae5bd80f3091bed2fed7c981632ce5` diff --git a/comfyui_embedded_docs/docs/ConditioningSetAreaPercentageVideo/en.md b/comfyui_embedded_docs/docs/ConditioningSetAreaPercentageVideo/en.md index 3263612af..ee96c7141 100644 --- a/comfyui_embedded_docs/docs/ConditioningSetAreaPercentageVideo/en.md +++ b/comfyui_embedded_docs/docs/ConditioningSetAreaPercentageVideo/en.md @@ -1,27 +1,27 @@ # Conditioning (Set Area with Percentage for Video) -The ConditioningSetAreaPercentageVideo node modifies conditioning data by defining a specific area and temporal region for video generation. It allows you to set the position, size, and duration of the area where the conditioning will be applied using percentage values relative to the overall dimensions. This is useful for focusing the generation on specific parts of a video sequence. +The ConditioningSetAreaPercentageVideo node modifies conditioning data by defining a specific area and temporal region for video generation. It uses percentage values relative to the overall dimensions to set the position, size, and duration of the area where the conditioning is applied. This is useful for focusing the generation on specific parts of a video sequence. ## Inputs -| Parameter | Description | Data Type | Input Type | Default | Range | -| --- | --- | --- | --- | --- | --- | -| `conditioning` | The conditioning data to be modified | CONDITIONING | Required | - | - | -| `width` | The width of the area as a percentage of the total width | FLOAT | Required | 1.0 | 0.0 - 1.0 | -| `height` | The height of the area as a percentage of the total height | FLOAT | Required | 1.0 | 0.0 - 1.0 | -| `temporal` | The temporal duration of the area as a percentage of the total video length | FLOAT | Required | 1.0 | 0.0 - 1.0 | -| `x` | The horizontal starting position of the area as a percentage | FLOAT | Required | 0.0 | 0.0 - 1.0 | -| `y` | The vertical starting position of the area as a percentage | FLOAT | Required | 0.0 | 0.0 - 1.0 | -| `z` | The temporal starting position of the area as a percentage of the video timeline | FLOAT | Required | 0.0 | 0.0 - 1.0 | -| `strength` | The strength multiplier applied to the conditioning within the defined area | FLOAT | Required | 1.0 | 0.0 - 10.0 | +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `conditioning` | The conditioning data to be modified | CONDITIONING | Yes | - | +| `width` | The width of the area as a percentage of the total width (default: 1.0) | FLOAT | Yes | 0.0 - 1.0 (step 0.01) | +| `height` | The height of the area as a percentage of the total height (default: 1.0) | FLOAT | Yes | 0.0 - 1.0 (step 0.01) | +| `temporal` | The temporal duration of the area as a percentage of the total video length (default: 1.0) | FLOAT | Yes | 0.0 - 1.0 (step 0.01) | +| `x` | The horizontal starting position of the area as a percentage (default: 0.0) | FLOAT | Yes | 0.0 - 1.0 (step 0.01) | +| `y` | The vertical starting position of the area as a percentage (default: 0.0) | FLOAT | Yes | 0.0 - 1.0 (step 0.01) | +| `z` | The temporal starting position of the area as a percentage of the video timeline (default: 0.0) | FLOAT | Yes | 0.0 - 1.0 (step 0.01) | +| `strength` | The strength multiplier applied to the conditioning within the defined area (default: 1.0) | FLOAT | Yes | 0.0 - 10.0 (step 0.01) | ## Outputs | Output Name | Description | Data Type | -| --- | --- | --- | +|-------------|-------------|-----------| | `conditioning` | The modified conditioning data with the specified area and strength settings applied | CONDITIONING | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ConditioningSetAreaPercentageVideo/en.md) --- -**Source fingerprint (SHA-256):** `72d4bef4f8ddc4765cf69863f7ad03d34992f0ff30a963dbe2dc1b7d69815410` +**Source fingerprint (SHA-256):** `9c5ddae6a2b1da5907fb52ef625eefb12b0b228fd3bd52c3033b5c4226d76150` diff --git a/comfyui_embedded_docs/docs/ConditioningStableAudio/en.md b/comfyui_embedded_docs/docs/ConditioningStableAudio/en.md index 744980df1..dc5372f95 100644 --- a/comfyui_embedded_docs/docs/ConditioningStableAudio/en.md +++ b/comfyui_embedded_docs/docs/ConditioningStableAudio/en.md @@ -21,4 +21,4 @@ The ConditioningStableAudio node adds timing information to both positive and ne > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ConditioningStableAudio/en.md) --- -**Source fingerprint (SHA-256):** `16ad6c3f133df718bf05a1e55a2faf0b840570fd42dc177e1474d0d3e4837b79` +**Source fingerprint (SHA-256):** `8bdf29514002837090c549b9921e8cb19c07d385881fe09a58885fcbfe968261` diff --git a/comfyui_embedded_docs/docs/ContextWindowsManual/en.md b/comfyui_embedded_docs/docs/ContextWindowsManual/en.md index 959ed3827..73162e76f 100644 --- a/comfyui_embedded_docs/docs/ContextWindowsManual/en.md +++ b/comfyui_embedded_docs/docs/ContextWindowsManual/en.md @@ -1,30 +1,32 @@ # Context Windows (Manual) -The Context Windows (Manual) node allows you to manually configure context windows for models during sampling. It creates overlapping context segments with specified length, overlap, and scheduling patterns to process data in manageable chunks while maintaining continuity between segments. This node provides advanced options for controlling how context windows are applied, including noise shuffling, conditioning retention, and causal window fixes. +The Context Windows (Manual) node allows you to manually configure context windows for a model during sampling, creating overlapping context segments with a specified length, overlap, and scheduling pattern so data is processed in manageable chunks while maintaining continuity between segments. It provides advanced options for controlling how context windows are applied, including noise shuffling, conditioning retention, and causal window fixes. This node is experimental. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | | `model` | The model to apply context windows to during sampling. | MODEL | Yes | - | -| `context_length` | The length of the context window (default: 16). | INT | No | 1+ | -| `context_overlap` | The overlap of the context window (default: 4). | INT | No | 0+ | -| `context_schedule` | The stride of the context window. | COMBO | No | `STATIC_STANDARD`
`UNIFORM_STANDARD`
`UNIFORM_LOOPED`
`BATCHED` | -| `context_stride` | The stride of the context window; only applicable to uniform schedules (default: 1). | INT | No | 1+ | -| `closed_loop` | Whether to close the context window loop; only applicable to looped schedules (default: False). | BOOLEAN | No | - | -| `fuse_method` | The method to use to fuse the context windows (default: PYRAMID). | COMBO | No | `PYRAMID`
`LIST_STATIC` | -| `dim` | The dimension to apply the context windows to (default: 0). | INT | No | 0-5 | -| `freenoise` | Whether to apply FreeNoise noise shuffling, improves window blending (default: False). | BOOLEAN | No | - | -| `cond_retain_index_list` | List of latent indices to retain in the conditioning tensors for each window, for example setting this to '0' will use the initial start image for each window (default: ""). | STRING | No | - | +| `context_length` | The length of the context window (default: 16). | INT | Yes | 1+ | +| `context_overlap` | The overlap of the context window (default: 4). | INT | Yes | 0+ | +| `context_schedule` | Step-dependent scheduling algorithm for context windows (default: STATIC_STANDARD). | COMBO | Yes | `STATIC_STANDARD`
`UNIFORM_STANDARD`
`UNIFORM_LOOPED`
`BATCHED` | +| `context_stride` | The stride of the context window; only applicable to uniform schedules (default: 1). | INT | Yes | 1+ | +| `closed_loop` | Whether to close the context window loop; only applicable to looped schedules (default: False). | BOOLEAN | Yes | - | +| `fuse_method` | The method to use to fuse the context windows (default: PYRAMID). | COMBO | Yes | Static fuse methods (see `ContextFuseMethods.LIST_STATIC`) | +| `dim` | The dimension to apply the context windows to (default: 0). | INT | Yes | 0-5 | +| `freenoise` | Whether to apply FreeNoise noise shuffling, improves window blending (default: False). | BOOLEAN | Yes | - | +| `cond_retain_index_list` | List of latent indices to retain in the conditioning tensors for each window. For concat-style I2V models (e.g. Wan I2V, HunyuanVideo I2V, Cosmos I2V, SVD) the encoded start image lives in the c_concat conditioning channels; setting this to '0' will retain that start image content at sub-pos 0 of every window (default: ""). | STRING | No | - | | `split_conds_to_windows` | Whether to split multiple conditionings (created by ConditionCombine) to each window based on region index (default: False). | BOOLEAN | No | - | +| `latent_retain_index_list` | List of latent indices to retain in the noise latent itself for each window. Use for workflows where reference content (e.g. a start image) lives directly in the noise latent rather than in separate conditioning channels (e.g. inplace-style I2V like LTXV, AnimateDiff). Independent of cond_retain_index_list (default: ""). | STRING | No | - | | `causal_window_fix` | Whether to add a causal fix frame to non-0-indexed context windows (default: True). | BOOLEAN | No | - | **Parameter Constraints:** -- `context_stride` is only used when uniform schedules are selected -- `closed_loop` is only applicable to looped schedules -- `dim` must be between 0 and 5 inclusive -- `cond_retain_index_list` expects a comma-separated list of integer indices as a string (e.g., "0,1,2") +- `context_stride` is only used when a uniform schedule is selected (`UNIFORM_STANDARD` or `UNIFORM_LOOPED`). +- `closed_loop` is only applicable to looped schedules (`UNIFORM_LOOPED`). +- `dim` must be between 0 and 5 inclusive. +- `cond_retain_index_list` and `latent_retain_index_list` expect a comma-separated list of integer indices as a string (e.g., "0,1,2"). +- `latent_retain_index_list` is independent of `cond_retain_index_list`. ## Outputs @@ -35,4 +37,4 @@ The Context Windows (Manual) node allows you to manually configure context windo > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ContextWindowsManual/en.md) --- -**Source fingerprint (SHA-256):** `1351789e54e6b4013331014a49b98c6f8b79692ddabed7a64eeb7463cda03cc5` +**Source fingerprint (SHA-256):** `39dc39ece3d3c10c13ca8c4b85af4fbbebbcaba8a019145a6d4727c3df7b302b` diff --git a/comfyui_embedded_docs/docs/ControlNetApplySD3/en.md b/comfyui_embedded_docs/docs/ControlNetApplySD3/en.md index 247092af4..04ba46cbc 100644 --- a/comfyui_embedded_docs/docs/ControlNetApplySD3/en.md +++ b/comfyui_embedded_docs/docs/ControlNetApplySD3/en.md @@ -1,6 +1,6 @@ # Apply Controlnet with VAE -This node applies ControlNet guidance to Stable Diffusion 3 conditioning. It takes positive and negative conditioning inputs along with a ControlNet model and image, then applies the control guidance with adjustable strength and timing parameters to influence the generation process. +This node applies ControlNet guidance to Stable Diffusion 3 conditioning. It takes positive and negative conditioning inputs along with a ControlNet model and an image, then applies the control guidance with adjustable strength and timing parameters to influence the generation process. **Note:** This node has been marked as deprecated and may be removed in future versions. @@ -13,10 +13,14 @@ This node applies ControlNet guidance to Stable Diffusion 3 conditioning. It tak | `control_net` | The ControlNet model to use for guidance | CONTROL_NET | Yes | - | | `vae` | The VAE model used in the process | VAE | Yes | - | | `image` | The input image that ControlNet will use as guidance | IMAGE | Yes | - | -| `strength` | The strength of the ControlNet effect (default: 1.0) | FLOAT | Yes | 0.0 - 10.0 | +| `strength` | The strength of the ControlNet effect (default: 1.0). When set to 0.0, the node skips ControlNet application and returns the conditioning unchanged. | FLOAT | Yes | 0.0 - 10.0 | | `start_percent` | The starting point in the generation process where ControlNet begins to apply (default: 0.0) | FLOAT | Yes | 0.0 - 1.0 | | `end_percent` | The ending point in the generation process where ControlNet stops applying (default: 1.0) | FLOAT | Yes | 0.0 - 1.0 | +**Note:** When `strength` is set to 0.0, no ControlNet guidance is applied and the input conditioning is passed through unchanged to both outputs. + +**Note:** If the same conditioning is reused elsewhere and already contains control information, the new ControlNet is linked after the previous one, so multiple ControlNets can be applied in sequence. + ## Outputs | Output Name | Description | Data Type | @@ -27,4 +31,4 @@ This node applies ControlNet guidance to Stable Diffusion 3 conditioning. It tak > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ControlNetApplySD3/en.md) --- -**Source fingerprint (SHA-256):** `b79f03a85250f8eda6786fbdb6a96712f5fc60c9ede3b073a1cc8aef31a3f6b0` +**Source fingerprint (SHA-256):** `b76b0683c05e38102280ca8b0bd23f39a9b9b1b4f52125c77c95686c0a06f398` diff --git a/comfyui_embedded_docs/docs/ControlNetInpaintingAliMamaApply/en.md b/comfyui_embedded_docs/docs/ControlNetInpaintingAliMamaApply/en.md index 6c83cbbbf..7b7cca2c3 100644 --- a/comfyui_embedded_docs/docs/ControlNetInpaintingAliMamaApply/en.md +++ b/comfyui_embedded_docs/docs/ControlNetInpaintingAliMamaApply/en.md @@ -12,11 +12,11 @@ The ControlNetInpaintingAliMamaApply node applies ControlNet conditioning for in | `vae` | The VAE (Variational Autoencoder) used for encoding and decoding images | VAE | Yes | - | | `image` | The input image that serves as control guidance for the ControlNet | IMAGE | Yes | - | | `mask` | The mask that defines which areas of the image should be inpainted | MASK | Yes | - | -| `strength` | The strength of the ControlNet effect (default: 1.0) | FLOAT | Yes | 0.0 to 10.0 | -| `start_percent` | The starting point (as percentage) of when ControlNet influence begins during generation (default: 0.0) | FLOAT | Yes | 0.0 to 1.0 | -| `end_percent` | The ending point (as percentage) of when ControlNet influence stops during generation (default: 1.0) | FLOAT | Yes | 0.0 to 1.0 | +| `strength` | The strength of the ControlNet effect (default: 1.0, step: 0.01) | FLOAT | Yes | 0.0 to 10.0 | +| `start_percent` | Advanced parameter. The starting point (as percentage) of when ControlNet influence begins during generation (default: 0.0, step: 0.001) | FLOAT | Yes | 0.0 to 1.0 | +| `end_percent` | Advanced parameter. The ending point (as percentage) of when ControlNet influence stops during generation (default: 1.0, step: 0.001) | FLOAT | Yes | 0.0 to 1.0 | -**Note:** When the ControlNet has `concat_mask` enabled, the mask is inverted and applied to the image before processing, and the mask is included in the extra concatenation data sent to the ControlNet. +**Note:** When the ControlNet has `concat_mask` enabled, the mask is inverted and applied to the image before processing, and the inverted mask is included in the extra concatenation data sent to the ControlNet. ## Outputs @@ -28,4 +28,4 @@ The ControlNetInpaintingAliMamaApply node applies ControlNet conditioning for in > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ControlNetInpaintingAliMamaApply/en.md) --- -**Source fingerprint (SHA-256):** `bd44dcff4f0d06b3b81a66dd45ae57e54b72374308f75b3089e50db8de1398cd` +**Source fingerprint (SHA-256):** `307b55c7b4936826b9e4424c172248fa4b41921c2362de724e5cfa2f1c25de68` diff --git a/comfyui_embedded_docs/docs/ConvertStringToComboNode/en.md b/comfyui_embedded_docs/docs/ConvertStringToComboNode/en.md index 88da58091..250be87ad 100644 --- a/comfyui_embedded_docs/docs/ConvertStringToComboNode/en.md +++ b/comfyui_embedded_docs/docs/ConvertStringToComboNode/en.md @@ -17,4 +17,4 @@ The Convert String to Combo node takes a text string as input and converts it in > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ConvertStringToComboNode/en.md) --- -**Source fingerprint (SHA-256):** `46ca4f38a4b1054bc6c5ff5c54551fe6c8061cfb8740a3ef46b64a30a05cec05` +**Source fingerprint (SHA-256):** `39bec69dccf4598aff0ae76ad5d68ae60d352ca464cfe54858fc1592ac923f13` diff --git a/comfyui_embedded_docs/docs/CosmosImageToVideoLatent/en.md b/comfyui_embedded_docs/docs/CosmosImageToVideoLatent/en.md index 391e662eb..9198313df 100644 --- a/comfyui_embedded_docs/docs/CosmosImageToVideoLatent/en.md +++ b/comfyui_embedded_docs/docs/CosmosImageToVideoLatent/en.md @@ -1,28 +1,32 @@ # CosmosImageToVideoLatent -The CosmosImageToVideoLatent node creates video latent representations from input images. It generates a blank video latent and optionally encodes start and/or end images into the beginning and/or end frames of the video sequence. When images are provided, it also creates corresponding noise masks to indicate which parts of the latent should be preserved during generation. +The CosmosImageToVideoLatent node creates a video latent representation from input images. It builds a blank video latent with the requested width, height, and number of frames, then optionally encodes a start image into the beginning frames and/or an end image into the end frames. When images are provided, it also generates a noise mask so the encoded frames remain fixed during generation. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `vae` | The VAE model used for encoding images into latent space | VAE | Yes | - | -| `width` | The width of the output video in pixels (default: 1280) | INT | Yes | 16 to MAX_RESOLUTION | -| `height` | The height of the output video in pixels (default: 704) | INT | Yes | 16 to MAX_RESOLUTION | -| `length` | The number of frames in the video sequence (default: 121) | INT | Yes | 1 to MAX_RESOLUTION | -| `batch_size` | The number of latent batches to generate (default: 1) | INT | Yes | 1 to 4096 | -| `start_image` | Optional image to encode at the beginning of the video sequence | IMAGE | No | - | -| `end_image` | Optional image to encode at the end of the video sequence | IMAGE | No | - | - -**Note:** When neither `start_image` nor `end_image` are provided, the node returns a blank latent without any noise mask. When either image is provided, the corresponding sections of the latent are encoded and masked accordingly. +| `vae` | The VAE model used to encode the images into the video latent space. | VAE | Yes | - | +| `width` | The width of the output video in pixels (default: 1280). | INT | Yes | 16 to MAX_RESOLUTION (step: 16) | +| `height` | The height of the output video in pixels (default: 704). | INT | Yes | 16 to MAX_RESOLUTION (step: 16) | +| `length` | The total number of frames in the video (default: 121). | INT | Yes | 1 to MAX_RESOLUTION (step: 8) | +| `batch_size` | The number of video latents to generate (default: 1). | INT | Yes | 1 to 4096 | +| `start_image` | Optional image or image sequence to encode at the beginning of the video. | IMAGE | No | - | +| `end_image` | Optional image or image sequence to encode at the end of the video. | IMAGE | No | - | + +**Note:** +- When neither `start_image` nor `end_image` is provided, the node returns a blank latent without a noise mask. +- When `start_image` is provided, it is encoded into the first frames of the latent and those frames are marked with noise mask value 0 (preserved). When `end_image` is provided, it is encoded into the last frames and those frames are marked with noise mask value 0. The remaining frames keep a mask value of 1. +- The latent has 16 channels and its spatial dimensions are `height / 8` by `width / 8`. The number of latent frames is `((length - 1) // 8) + 1`. +- `batch_size` repeats the latent and, when present, the noise mask. ## Outputs | Output Name | Description | Data Type | | --- | --- | --- | -| `latent` | The generated video latent representation with optional encoded images and corresponding noise masks | LATENT | +| `latent` | The generated video latent containing the optional encoded start and/or end images and, when images are provided, a matching noise mask with value 0 on the preserved frames. | LATENT | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/CosmosImageToVideoLatent/en.md) --- -**Source fingerprint (SHA-256):** `4fefd1b6c38c93c260ef8376e8d69ba610a556b3c8555863016a1afd45885eaf` +**Source fingerprint (SHA-256):** `0b06ccfcb14c27c81eeebbbff519da1e187970d4cfc19c8796fc3da20688245c` diff --git a/comfyui_embedded_docs/docs/CosmosPredict2ImageToVideoLatent/en.md b/comfyui_embedded_docs/docs/CosmosPredict2ImageToVideoLatent/en.md index 85961b788..826bb7458 100644 --- a/comfyui_embedded_docs/docs/CosmosPredict2ImageToVideoLatent/en.md +++ b/comfyui_embedded_docs/docs/CosmosPredict2ImageToVideoLatent/en.md @@ -1,6 +1,6 @@ # CosmosPredict2ImageToVideoLatent -The CosmosPredict2ImageToVideoLatent node creates video latent representations from images for video generation. It can generate a blank video latent or incorporate start and end images to create video sequences with specified dimensions and duration. The node handles the encoding of images into the appropriate latent space format for video processing. +CosmosPredict2ImageToVideoLatent creates video latent representations from images for video generation. It can generate a blank video latent or incorporate start and end images to create video sequences with specified dimensions and duration. The node handles the encoding of images into the appropriate latent space format for video processing. ## Inputs @@ -14,16 +14,16 @@ The CosmosPredict2ImageToVideoLatent node creates video latent representations f | `start_image` | Optional starting image for the video sequence | IMAGE | No | - | | `end_image` | Optional ending image for the video sequence | IMAGE | No | - | -**Note:** When neither `start_image` nor `end_image` are provided, the node generates a blank video latent. When images are provided, they are encoded and positioned at the beginning and/or end of the video sequence with appropriate masking. +**Note:** When neither `start_image` nor `end_image` are provided, the node generates a blank video latent. When one or both images are provided, they are resized to `width` and `height`, encoded into latent space, and positioned at the beginning and/or end of the video sequence, with the corresponding regions marked in the noise mask so they are preserved during generation. The resulting latent and mask are repeated `batch_size` times. ## Outputs | Output Name | Description | Data Type | | --- | --- | --- | | `samples` | The generated video latent representation containing the encoded video sequence | LATENT | -| `noise_mask` | A mask indicating which parts of the latent should be preserved during generation | LATENT | +| `noise_mask` | A mask indicating which parts of the latent should be preserved during generation. Only present when at least one of `start_image` or `end_image` is provided. | LATENT | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/CosmosPredict2ImageToVideoLatent/en.md) --- -**Source fingerprint (SHA-256):** `5c470c35afaa9b994b431f0a8655e108da420182ec5c223fa54ec2c233ba9fd3` +**Source fingerprint (SHA-256):** `842bd2b8cda438e7b938439d4eba280478939e3302dc1846d52595d40082ff05` diff --git a/comfyui_embedded_docs/docs/CreateList/en.md b/comfyui_embedded_docs/docs/CreateList/en.md index 63e384a8a..63104ead3 100644 --- a/comfyui_embedded_docs/docs/CreateList/en.md +++ b/comfyui_embedded_docs/docs/CreateList/en.md @@ -6,9 +6,9 @@ The Create List node combines multiple inputs into a single, sequential list. It | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `inputs` | A variable number of input slots. You can add more inputs by clicking the plus (+) icon. All inputs must be of the same data type (e.g., all IMAGE or all STRING). | Varies | Yes | Any | +| `inputs` | A variable number of input slots named `input`, `input_2`, `input_3`, and so on. Each slot accepts a list of items of the same data type. You can add more slots by clicking the plus (+) icon. All slots must use the same data type (e.g., all IMAGE or all STRING). | Varies | Yes | Any number of slots; each slot accepts any number of items | -**Note:** The node will automatically create new input slots as you connect items. All connected inputs must share the same data type for the node to function correctly. +**Note:** The node automatically creates new input slots as you connect items. All connected inputs must share the same data type for the node to function correctly. Each connected slot provides a list of items, and the node combines the lists in slot order (`input`, then `input_2`, then `input_3`, ...). The node is also searchable under the aliases "Image Iterator", "Text Iterator", and "Iterator". ## Outputs @@ -19,4 +19,4 @@ The Create List node combines multiple inputs into a single, sequential list. It > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/CreateList/en.md) --- -**Source fingerprint (SHA-256):** `54a099948853f76f4f9c9918e4fef8a8eff96ad66d35ab9eeefd2a419670e867` +**Source fingerprint (SHA-256):** `457d17da815ef9cee000d9e8dc8768f19ddfe247feae4b2ff4ce3c6cc0fd564e` diff --git a/comfyui_embedded_docs/docs/CurveEditor/en.md b/comfyui_embedded_docs/docs/CurveEditor/en.md index 4b50a39f3..232d080bd 100644 --- a/comfyui_embedded_docs/docs/CurveEditor/en.md +++ b/comfyui_embedded_docs/docs/CurveEditor/en.md @@ -1,6 +1,6 @@ # Curve Editor -The Curve Editor node provides a visual interface for adjusting and fine-tuning a curve. It allows you to modify the shape of an input curve and optionally visualize its distribution with a histogram. The node outputs the modified curve for use in other parts of your workflow. +The Curve Editor node provides a visual interface for adjusting and fine-tuning a curve. You can modify the shape of an input curve directly in the node's interface and optionally display a histogram alongside it for visual reference. The node supports intermediate output during editing, allowing you to see live results as you make changes, and outputs the modified curve for use in other parts of your workflow. ## Inputs @@ -18,4 +18,4 @@ The Curve Editor node provides a visual interface for adjusting and fine-tuning > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/CurveEditor/en.md) --- -**Source fingerprint (SHA-256):** `7cd265b724f4b80bd6838b665254b54f1ca16f32ed0b4e072fabf856d769e11c` +**Source fingerprint (SHA-256):** `6c4459998b1a3dd3a53f84cb1c231c448c64aa55b96444bc4ac7470556a3b915` diff --git a/comfyui_embedded_docs/docs/CustomCombo/en.md b/comfyui_embedded_docs/docs/CustomCombo/en.md index 5e40ecff0..c6f2b9129 100644 --- a/comfyui_embedded_docs/docs/CustomCombo/en.md +++ b/comfyui_embedded_docs/docs/CustomCombo/en.md @@ -1,24 +1,24 @@ # Custom Combo -The Custom Combo node allows you to create a custom dropdown menu with your own list of text options. It is a frontend-focused node that provides a backend representation to ensure compatibility within your workflow. When you select an option from the dropdown, the node outputs that text as a string and its index position. +The Custom Combo node allows you to create a custom dropdown menu with your own list of text options. It is a frontend-focused node that includes a backend representation to keep your workflow compatible. When you select an option from the dropdown, the node outputs that text as a string and its index position. ## Inputs | Parameter | Description | Data Type | Required | Range | -| --- | --- | --- | --- | --- | +|-----------|-------------|-----------|----------|-------| | `choice` | The text option selected from the custom dropdown. The list of available options is defined by the user in the node's frontend interface. | COMBO | Yes | User-defined | -| `index` | An integer value that can be used to specify an index. Default: 0. | INT | No | 0 | +| `index` | An integer value that can be used to specify an index. Default: 0. | INT | No | Any integer (default: 0) | -**Note:** The validation for this node's input is intentionally disabled. This allows you to define any custom text options you want in the frontend without the backend checking if your selection is from a predefined list. +**Note:** Validation for this node's inputs is intentionally disabled. This allows you to write any custom text options in the frontend without the backend checking whether your selection matches a predefined list. Widgets other than the combo dropdown are fully defined in the frontend. This node is marked as experimental. ## Outputs | Output Name | Description | Data Type | -| --- | --- | --- | +|-------------|-------------|-----------| | `STRING` | The text string of the option selected from the custom combo box. | STRING | | `INDEX` | The index position of the selected option in the dropdown list. | INT | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/CustomCombo/en.md) --- -**Source fingerprint (SHA-256):** `1c68db3a71526d52d21f79abae146ffa235b4927961ff45db3aa075bba4e910a` +**Source fingerprint (SHA-256):** `143eafcf32de7ebaf72b5387537154b5deee7d3e3a520a0b2c12ac4fb67890f8` diff --git a/comfyui_embedded_docs/docs/DCTestNode/en.md b/comfyui_embedded_docs/docs/DCTestNode/en.md index 132dbc50c..c26fbb8ab 100644 --- a/comfyui_embedded_docs/docs/DCTestNode/en.md +++ b/comfyui_embedded_docs/docs/DCTestNode/en.md @@ -1,18 +1,44 @@ # DCTestNode -The DCTestNode is a logic node that returns different types of data based on a user's selection from a dynamic combo box. It acts as a conditional router, where the chosen option determines which input field is active and what type of value the node will output. +DCTestNode is a logic node that returns different types of data based on a user's selection from a dynamic combo box. It acts as a conditional router, where the chosen option determines which input field is active and what type of value the node will output. ## Inputs +The node uses a dynamic combo selector: the `combo` parameter is always visible, and the other input fields appear only when their corresponding option is selected. + +### Common Inputs + +| Parameter | Description | Data Type | Required | Range | +| --- | --- | --- | --- | --- | +| `combo` | The main selection that determines which input field is active and what the node will output. | DYNAMIC_COMBO | Yes | `"option1"`
`"option2"`
`"option3"`
`"option4"` | + +### option1 Inputs + +| Parameter | Description | Data Type | Required | Range | +| --- | --- | --- | --- | --- | +| `string` | A text input field. This field is only active and required when `combo` is set to `"option1"`. | STRING | Yes | - | + +### option2 Inputs + +| Parameter | Description | Data Type | Required | Range | +| --- | --- | --- | --- | --- | +| `integer` | A whole number input field. This field is only active and required when `combo` is set to `"option2"`. | INT | Yes | - | + +### option3 Inputs + +| Parameter | Description | Data Type | Required | Range | +| --- | --- | --- | --- | --- | +| `image` | An image input field. This field is only active and required when `combo` is set to `"option3"`. | IMAGE | Yes | - | + +### option4 Inputs + +When `combo` is set to `"option4"`, the node shows a second dynamic combo selector (`subcombo`) that controls a nested set of input fields. + | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `combo` | The main selection that determines which input field is active and what the node will output. | COMBO | Yes | `"option1"`
`"option2"`
`"option3"`
`"option4"` | -| `string` | A text input field. This field is only active and required when `combo` is set to `"option1"`. | STRING | No | - | -| `integer` | A whole number input field. This field is only active and required when `combo` is set to `"option2"`. | INT | No | - | -| `image` | An image input field. This field is only active and required when `combo` is set to `"option3"`. | IMAGE | No | - | -| `subcombo` | A secondary selection that appears when `combo` is set to `"option4"`. It determines which nested input fields are active. | COMBO | No | `"opt1"`
`"opt2"` | -| `float_x` | A decimal number input. This field is only active and required when `combo` is set to `"option4"` and `subcombo` is set to `"opt1"`. | FLOAT | No | - | -| `float_y` | A decimal number input. This field is only active and required when `combo` is set to `"option4"` and `subcombo` is set to `"opt1"`. | FLOAT | No | - | +| `subcombo` | A secondary dynamic combo selection that appears when `combo` is set to `"option4"`. It determines which nested input fields are active. | DYNAMIC_COMBO | Yes | `"opt1"`
`"opt2"` | +| `float_x` | A decimal number input. This field is only active and required when `combo` is set to `"option4"` and `subcombo` is set to `"opt1"`. | FLOAT | Yes | - | +| `float_y` | A decimal number input. This field is only active and required when `combo` is set to `"option4"` and `subcombo` is set to `"opt1"`. | FLOAT | Yes | - | | `mask1` | A mask input field. This field is only active when `combo` is set to `"option4"` and `subcombo` is set to `"opt2"`. It is optional. | MASK | No | - | **Parameter Constraints:** @@ -29,4 +55,4 @@ The DCTestNode is a logic node that returns different types of data based on a u > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/DCTestNode/en.md) --- -**Source fingerprint (SHA-256):** `3a307bad068ef0721fff622c94337ca36fdca981c35b246ae9d5beb183be1620` +**Source fingerprint (SHA-256):** `9dd616a427a56eddb78b48d6eea6f71419b7097d417afae5557132b333641e69` diff --git a/comfyui_embedded_docs/docs/DecimateMesh/ar.md b/comfyui_embedded_docs/docs/DecimateMesh/ar.md new file mode 100644 index 000000000..5ad500a2d --- /dev/null +++ b/comfyui_embedded_docs/docs/DecimateMesh/ar.md @@ -0,0 +1,41 @@ +# DecimateMesh + +تقوم عقدة DecimateMesh بتبسيط شبكة ثلاثية الأبعاد إلى عدد مستهدف من الأسطح باستخدام مقياس الخطأ التربيعي (QEM)، وتنفيذ العملية الحسابية على جهاز الحوسبة النشط. وضع الإحداثيات `"midpoint"` هو الإعداد المسبق المطابق لـ cumesh والذي يوفّر أفضل جودة مع الحفاظ على الملامح الرقيقة مثل الشعر، بينما يضع `"qem"` الرؤوس في الموضع الأمثل وفقًا لـ QEM مع تحكم اختياري في الخطوط وحواف المعالم. تبقى الشبكة الناتجة ملحومة (welded). + +## المدخلات + +### المدخلات المشتركة + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|-----------|-------------|-----------|----------|-------| +| `mesh` | الشبكة ثلاثية الأبعاد المراد تبسيطها. | MESH | نعم | - | +| `target_face_count` | الحد الأقصى المستهدف لعدد الأسطح. القيمة 0 تعطيل. (الافتراضي: 200000) | INT | نعم | 0 إلى 50000000 | +| `placement_mode` | midpoint: مطابق لـ cumesh (موصى به). qem: الموضع الأمثل وفقًا لـ QEM. (الافتراضي: `"midpoint"`) | DYNAMIC_COMBO | نعم | `"midpoint"`
`"qem"` | + +### مدخلات Midpoint + +لا يكشف وضع الإحداثيات `"midpoint"` عن معاملات فرعية إضافية؛ فهو يستخدم الإعداد المسبق الافتراضي لموضع midpoint. + +### مدخلات QEM + +تظهر المعاملات الفرعية التالية في الواجهة فقط عندما يتم تعيين `placement_mode` على `"qem"`. + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|-----------|-------------|-----------|----------|-------| +| `line_quadric_weight` | وزن الخط-التربيعي لكل حافة؛ يحافظ على الحواف/الوديان الحادة. 0 = معطل. (الافتراضي: 0.0) | FLOAT | لا | 0.0 إلى 100.0 | +| `feature_edge_quadric_weight` | وزن تربيعي إضافي على حواف المعالم ثنائية السطح (الانثناءات). 0 = معطل. (الافتراضي: 0.0) | FLOAT | لا | 0.0 إلى 1000.0 | +| `feature_edge_min_dihedral_deg` | الحد الأدنى للزاوية ثنائية السطح (بالدرجات) لاعتبار الحافة حافة معلم. (الافتراضي: 30.0) | FLOAT | لا | 0.0 إلى 180.0 | +| `clamp_v_to_edge` | إسقاط الموضع الأمثل وفقًا لـ QEM على قطعة الحافة المُدمجة. (الافتراضي: true) | BOOLEAN | لا | `true`
`false` | + +ملاحظة: يتم تخطي عملية الاختزال عندما تكون قيمة `target_face_count` هي 0 أو عندما تحتوي الشبكة بالفعل على أسطح أقل من الهدف. تعرض العقدة ملخصًا لتقليل الأسطح على نفسها، على سبيل المثال `faces: 1.23M → 200K (-84%)`. + +## المخرجات + +| اسم المخرج | الوصف | نوع البيانات | +|-------------|-------------|-----------| +| `mesh` | الشبكة المبسطة بعدد أسطح مخفّض؛ تبقى الاتصالات ملحومة. | MESH | + +> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/DecimateMesh/ar.md) + +--- +**Source fingerprint (SHA-256):** `55336e5b52e27d940e5402ecd74fd0ac847a1c6acd35955eccf72aab8ed940f9` diff --git a/comfyui_embedded_docs/docs/DecimateMesh/en.md b/comfyui_embedded_docs/docs/DecimateMesh/en.md new file mode 100644 index 000000000..05f6a0283 --- /dev/null +++ b/comfyui_embedded_docs/docs/DecimateMesh/en.md @@ -0,0 +1,41 @@ +# DecimateMesh + +DecimateMesh simplifies a 3D mesh to a target face count using quadric error metric (QEM) simplification, running the computation on the active compute device. The `"midpoint"` placement mode is the cumesh-faithful preset providing the best quality while preserving thin features such as hair, whereas `"qem"` places vertices at the QEM-optimal position with optional line and feature-edge controls. The output mesh stays welded. + +## Inputs + +### Common Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `mesh` | The 3D mesh to simplify. | MESH | Yes | - | +| `target_face_count` | Target max faces. 0 disables. (default: 200000) | INT | Yes | 0 to 50000000 | +| `placement_mode` | midpoint: cumesh-faithful (recommended). qem: QEM-optimal placement. (default: `"midpoint"`) | DYNAMIC_COMBO | Yes | `"midpoint"`
`"qem"` | + +### Midpoint Inputs + +The `"midpoint"` placement mode does not expose additional sub-parameters; it uses the default midpoint placement preset. + +### QEM Inputs + +The following sub-parameters appear in the interface only when `placement_mode` is set to `"qem"`. + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `line_quadric_weight` | Per-edge line-quadric weight; preserves sharp ridges/valleys. 0 = off. (default: 0.0) | FLOAT | No | 0.0 to 100.0 | +| `feature_edge_quadric_weight` | Extra quadric weight on dihedral feature edges (creases). 0 = off. (default: 0.0) | FLOAT | No | 0.0 to 1000.0 | +| `feature_edge_min_dihedral_deg` | Minimum dihedral angle (degree) to count an edge as a feature edge. (default: 30.0) | FLOAT | No | 0.0 to 180.0 | +| `clamp_v_to_edge` | Project the QEM-optimal position onto the collapsed edge segment. (default: true) | BOOLEAN | No | `true`
`false` | + +Note: Decimation is skipped when `target_face_count` is 0 or when the mesh already has fewer faces than the target. The node displays a face reduction summary on itself, for example `faces: 1.23M → 200K (-84%)`. + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `mesh` | The simplified mesh with the reduced face count; connectivity stays welded. | MESH | + +> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/DecimateMesh/en.md) + +--- +**Source fingerprint (SHA-256):** `55336e5b52e27d940e5402ecd74fd0ac847a1c6acd35955eccf72aab8ed940f9` diff --git a/comfyui_embedded_docs/docs/DecimateMesh/es.md b/comfyui_embedded_docs/docs/DecimateMesh/es.md new file mode 100644 index 000000000..8ce9f0d4b --- /dev/null +++ b/comfyui_embedded_docs/docs/DecimateMesh/es.md @@ -0,0 +1,41 @@ +# DecimateMesh + +DecimateMesh simplifica una malla 3D a un número de caras objetivo mediante simplificación por métrica de error cuadrático (QEM), ejecutando el cálculo en el dispositivo de cómputo activo. El modo de colocación `"midpoint"` es el preajuste fiel a cumesh que ofrece la mejor calidad y preserva rasgos finos como el cabello, mientras que `"qem"` coloca los vértices en la posición óptima según QEM con controles opcionales de línea y aristas de características. La malla de salida permanece soldada. + +## Entradas + +### Entradas comunes + +| Parámetro | Descripción | Tipo de dato | Requerido | Rango | +|-----------|-------------|--------------|-----------|-------| +| `mesh` | La malla 3D a simplificar. | MESH | Sí | - | +| `target_face_count` | Número máximo de caras objetivo. 0 lo desactiva. (por defecto: 200000) | INT | Sí | 0 a 50000000 | +| `placement_mode` | midpoint: fiel a cumesh (recomendado). qem: colocación óptima según QEM. (por defecto: `"midpoint"`) | DYNAMIC_COMBO | Sí | `"midpoint"`
`"qem"` | + +### Entradas de Midpoint + +El modo de colocación `"midpoint"` no expone subparámetros adicionales; utiliza el preajuste de colocación de punto medio predeterminado. + +### Entradas de QEM + +Los siguientes subparámetros aparecen en la interfaz solo cuando `placement_mode` está configurado como `"qem"`. + +| Parámetro | Descripción | Tipo de dato | Requerido | Rango | +|-----------|-------------|--------------|-----------|-------| +| `line_quadric_weight` | Peso de cuádrica de línea por arista; preserva crestas y valles marcados. 0 = desactivado. (por defecto: 0.0) | FLOAT | No | 0.0 a 100.0 | +| `feature_edge_quadric_weight` | Peso de cuádrica adicional en aristas de características con ángulo diedro (pliegues). 0 = desactivado. (por defecto: 0.0) | FLOAT | No | 0.0 a 1000.0 | +| `feature_edge_min_dihedral_deg` | Ángulo diedro mínimo (en grados) para considerar una arista como arista de característica. (por defecto: 30.0) | FLOAT | No | 0.0 a 180.0 | +| `clamp_v_to_edge` | Proyecta la posición óptima de QEM sobre el segmento de la arista colapsada. (por defecto: true) | BOOLEAN | No | `true`
`false` | + +Nota: La decimación se omite cuando `target_face_count` es 0 o cuando la malla ya tiene menos caras que el objetivo. El nodo muestra un resumen de reducción de caras en sí mismo, por ejemplo `faces: 1.23M → 200K (-84%)`. + +## Salidas + +| Nombre de salida | Descripción | Tipo de dato | +|------------------|-------------|--------------| +| `mesh` | La malla simplificada con el número de caras reducido; la conectividad permanece soldada. | MESH | + +> Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/DecimateMesh/es.md) + +--- +**Source fingerprint (SHA-256):** `55336e5b52e27d940e5402ecd74fd0ac847a1c6acd35955eccf72aab8ed940f9` diff --git a/comfyui_embedded_docs/docs/DecimateMesh/fa.md b/comfyui_embedded_docs/docs/DecimateMesh/fa.md new file mode 100644 index 000000000..77dcb52ee --- /dev/null +++ b/comfyui_embedded_docs/docs/DecimateMesh/fa.md @@ -0,0 +1,41 @@ +# DecimateMesh + +DecimateMesh یک مش سه‌بعدی را با استفاده از ساده‌سازی معیار خطای درجه دوم (QEM) به تعداد وجه هدف ساده می‌کند و محاسبات را روی دستگاه محاسباتی فعال اجرا می‌نماید. حالت جای‌گذاری `"midpoint"` یک پیش‌تنظیم وفادار به cumesh است که بهترین کیفیت را ارائه می‌دهد و ویژگی‌های باریک مانند مو را حفظ می‌کند، در حالی که `"qem"` رئوس را در موقعیت بهینه QEM با کنترل‌های اختیاری خط و لبه‌های ویژگی قرار می‌دهد. مش خروجی جوش‌خورده باقی می‌ماند. + +## ورودی‌ها + +### ورودی‌های عمومی + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `mesh` | مش سه‌بعدی برای ساده‌سازی. | MESH | بله | - | +| `target_face_count` | حداکثر وجه هدف. 0 به معنای غیرفعال بودن است. (پیش‌فرض: 200000) | INT | بله | 0 تا 50000000 | +| `placement_mode` | midpoint: وفادار به cumesh (توصیه‌شده). qem: جای‌گذاری بهینه QEM. (پیش‌فرض: `"midpoint"`) | DYNAMIC_COMBO | بله | `"midpoint"`
`"qem"` | + +### ورودی‌های Midpoint + +حالت جای‌گذاری `"midpoint"` زیرپارامتر اضافی را نمایش نمی‌دهد؛ از پیش‌تنظیم پیش‌فرض جای‌گذاری midpoint استفاده می‌کند. + +### ورودی‌های QEM + +زیرپارامترهای زیر تنها زمانی در رابط کاربری ظاهر می‌شوند که `placement_mode` روی `"qem"` تنظیم شده باشد. + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `line_quadric_weight` | وزن خط-کوادریک برای هر یال؛ خط‌الرأس‌ها و دره‌های تیز را حفظ می‌کند. 0 = خاموش. (پیش‌فرض: 0.0) | FLOAT | خیر | 0.0 تا 100.0 | +| `feature_edge_quadric_weight` | وزن کوادریک اضافی روی یال‌های ویژگی دووجهی (چین‌ها). 0 = خاموش. (پیش‌فرض: 0.0) | FLOAT | خیر | 0.0 تا 1000.0 | +| `feature_edge_min_dihedral_deg` | حداقل زاویه دووجهی (بر حسب درجه) برای در نظر گرفتن یک یال به‌عنوان یال ویژگی. (پیش‌فرض: 30.0) | FLOAT | خیر | 0.0 تا 180.0 | +| `clamp_v_to_edge` | موقعیت بهینه QEM را بر روی پاره‌خط یال جمع‌شده تصویر کن. (پیش‌فرض: true) | BOOLEAN | خیر | `true`
`false` | + +نکته: ساده‌سازی زمانی نادیده گرفته می‌شود که `target_face_count` برابر 0 باشد یا مش از قبل وجه‌های کمتری نسبت به هدف داشته باشد. گره خلاصه‌ای از کاهش وجه را روی خود نمایش می‌دهد، برای مثال `faces: 1.23M → 200K (-84%)`. + +## خروجی‌ها + +| نام خروجی | توضیحات | نوع داده | +|-------------|-------------|-----------| +| `mesh` | مش ساده‌شده با تعداد وجه کاهش‌یافته؛ اتصال همچنان جوش‌خورده باقی می‌ماند. | MESH | + +> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/DecimateMesh/fa.md) + +--- +**Source fingerprint (SHA-256):** `55336e5b52e27d940e5402ecd74fd0ac847a1c6acd35955eccf72aab8ed940f9` diff --git a/comfyui_embedded_docs/docs/DecimateMesh/fr.md b/comfyui_embedded_docs/docs/DecimateMesh/fr.md new file mode 100644 index 000000000..c15c9a5ba --- /dev/null +++ b/comfyui_embedded_docs/docs/DecimateMesh/fr.md @@ -0,0 +1,41 @@ +# DecimateMesh + +DecimateMesh simplifie un maillage 3D pour atteindre un nombre de faces cible en utilisant la simplification par métrique d'erreur quadrique (QEM), en exécutant le calcul sur le périphérique de calcul actif. Le mode de placement `"midpoint"` est le préréglage fidèle à cumesh offrant la meilleure qualité tout en préservant les détails fins tels que les cheveux, tandis que `"qem"` place les sommets à la position optimale selon QEM avec des contrôles facultatifs de ligne et d'arête de caractéristique. Le maillage de sortie reste soudé. + +## Entrées + +### Entrées communes + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `mesh` | Le maillage 3D à simplifier. | MESH | Oui | - | +| `target_face_count` | Nombre maximal de faces cible. 0 désactive. (défaut : 200000) | INT | Oui | 0 à 50000000 | +| `placement_mode` | midpoint : fidèle à cumesh (recommandé). qem : placement optimal selon QEM. (défaut : `"midpoint"`) | DYNAMIC_COMBO | Oui | `"midpoint"`
`"qem"` | + +### Entrées Midpoint + +Le mode de placement `"midpoint"` n'expose pas de sous-paramètres supplémentaires ; il utilise le préréglage de placement midpoint par défaut. + +### Entrées QEM + +Les sous-paramètres suivants n'apparaissent dans l'interface que lorsque `placement_mode` est défini sur `"qem"`. + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `line_quadric_weight` | Poids de quadrique de ligne par arête ; préserve les crêtes/vallées nettes. 0 = désactivé. (défaut : 0.0) | FLOAT | Non | 0.0 à 100.0 | +| `feature_edge_quadric_weight` | Poids de quadrique supplémentaire sur les arêtes de caractéristiques dièdres (plis). 0 = désactivé. (défaut : 0.0) | FLOAT | Non | 0.0 à 1000.0 | +| `feature_edge_min_dihedral_deg` | Angle dièdre minimal (en degrés) pour qu'une arête soit considérée comme une arête de caractéristique. (défaut : 30.0) | FLOAT | Non | 0.0 à 180.0 | +| `clamp_v_to_edge` | Projeter la position optimale selon QEM sur le segment de l'arête contractée. (défaut : true) | BOOLEAN | Non | `true`
`false` | + +Remarque : La décimation est ignorée lorsque `target_face_count` est 0 ou lorsque le maillage a déjà moins de faces que la cible. Le nœud affiche un résumé de la réduction du nombre de faces sur lui-même, par exemple `faces: 1.23M → 200K (-84%)`. + +## Sorties + +| Nom de sortie | Description | Type de données | +|---------------|-------------|-----------------| +| `mesh` | Le maillage simplifié avec le nombre de faces réduit ; la connectivité reste soudée. | MESH | + +> Cette documentation a été générée par IA. Si vous trouvez des erreurs ou avez des suggestions d'amélioration, n'hésitez pas à contribuer ! [Modifier sur GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/DecimateMesh/fr.md) + +--- +**Source fingerprint (SHA-256):** `55336e5b52e27d940e5402ecd74fd0ac847a1c6acd35955eccf72aab8ed940f9` diff --git a/comfyui_embedded_docs/docs/DecimateMesh/ja.md b/comfyui_embedded_docs/docs/DecimateMesh/ja.md new file mode 100644 index 000000000..e5fdf4e11 --- /dev/null +++ b/comfyui_embedded_docs/docs/DecimateMesh/ja.md @@ -0,0 +1,41 @@ +# DecimateMesh + +DecimateMesh は、四辺形誤差メトリック(QEM)簡略化を使用して3Dメッシュを目標の面数に簡略化し、計算をアクティブな計算デバイス上で実行します。`"midpoint"` 配置モードは、髪の毛などの細い特徴を保持しながら最高品質を提供する cumesh 準拠のプリセットです。一方、`"qem"` は、オプションのラインおよびフィーチャエッジのコントロールを備えて、QEM 最適位置に頂点を配置します。出力メッシュはウェルドされた状態を維持します。 + +## 入力 + +### 共通入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `mesh` | 簡略化する3Dメッシュ。 | MESH | はい | - | +| `target_face_count` | 目標の最大面数。0 は無効。(デフォルト: 200000) | INT | はい | 0 から 50000000 | +| `placement_mode` | midpoint: cumesh 準拠(推奨)。qem: QEM 最適配置。(デフォルト: `"midpoint"`) | DYNAMIC_COMBO | はい | `"midpoint"`
`"qem"` | + +### Midpoint 入力 + +`"midpoint"` 配置モードでは、追加のサブパラメータは公開されません。デフォルトのミッドポイント配置プリセットを使用します。 + +### QEM 入力 + +以下のサブパラメータは、`placement_mode` が `"qem"` に設定されている場合にのみインターフェースに表示されます。 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `line_quadric_weight` | エッジごとのライン四辺形ウェイト。鋭い稜線・谷線を保持します。0 = オフ。(デフォルト: 0.0) | FLOAT | いいえ | 0.0 から 100.0 | +| `feature_edge_quadric_weight` | 二面角フィーチャエッジ(折り目)に対する追加の四辺形ウェイト。0 = オフ。(デフォルト: 0.0) | FLOAT | いいえ | 0.0 から 1000.0 | +| `feature_edge_min_dihedral_deg` | エッジをフィーチャエッジとみなす最小二面角(度)。(デフォルト: 30.0) | FLOAT | いいえ | 0.0 から 180.0 | +| `clamp_v_to_edge` | QEM 最適位置を、崩縮したエッジセグメント上に投影します。(デフォルト: true) | BOOLEAN | いいえ | `true`
`false` | + +注: `target_face_count` が 0 の場合、またはメッシュがすでに目標面数よりも少ない場合、デシメーションはスキップされます。ノードは自身の上に面数削減の概要を表示します。例: `faces: 1.23M → 200K (-84%)`。 + +## 出力 + +| 出力名 | 説明 | データ型 | +|-------------|-------------|-----------| +| `mesh` | 面数が削減された簡略化メッシュ。接続性はウェルドされた状態を維持します。 | MESH | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/DecimateMesh/ja.md) + +--- +**Source fingerprint (SHA-256):** `55336e5b52e27d940e5402ecd74fd0ac847a1c6acd35955eccf72aab8ed940f9` diff --git a/comfyui_embedded_docs/docs/DecimateMesh/ko.md b/comfyui_embedded_docs/docs/DecimateMesh/ko.md new file mode 100644 index 000000000..ece03341e --- /dev/null +++ b/comfyui_embedded_docs/docs/DecimateMesh/ko.md @@ -0,0 +1,41 @@ +# DecimateMesh + +DecimateMesh는 활성 계산 장치에서 계산을 실행하면서 QEM(Quadric Error Metric) 단순화를 사용하여 3D 메시를 목표 면 수로 단순화합니다. `"midpoint"` 배치 모드는 머리카락과 같은 얇은 특징을 보존하면서 최상의 품질을 제공하는 cumesh에 충실한 사전 설정이며, `"qem"`은 선택적 라인 및 특징 가장자리 제어와 함께 QEM 최적 위치에 정점을 배치합니다. 출력 메시는 용접된 상태를 유지합니다. + +## 입력 + +### 공통 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `mesh` | 단순화할 3D 메시입니다. | MESH | 예 | - | +| `target_face_count` | 최대 목표 면 수입니다. 0이면 비활성화됩니다. (기본값: 200000) | INT | 예 | 0 to 50000000 | +| `placement_mode` | midpoint: cumesh에 충실한 (권장). qem: QEM 최적 배치. (기본값: `"midpoint"`) | DYNAMIC_COMBO | 예 | `"midpoint"`
`"qem"` | + +### Midpoint 입력 + +`"midpoint"` 배치 모드는 추가 하위 매개변수를 노출하지 않으며 기본 미드포인트 배치 사전 설정을 사용합니다. + +### QEM 입력 + +다음 하위 매개변수는 `placement_mode`가 `"qem"`으로 설정된 경우에만 인터페이스에 나타납니다. + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `line_quadric_weight` | 가장자리별 라인 쿼드릭 가중치입니다. 날카로운 능선/골짜기를 보존합니다. 0 = 비활성화. (기본값: 0.0) | FLOAT | 아니오 | 0.0 to 100.0 | +| `feature_edge_quadric_weight` | 이면각 특징 가장자리(주름)에 대한 추가 쿼드릭 가중치입니다. 0 = 비활성화. (기본값: 0.0) | FLOAT | 아니오 | 0.0 to 1000.0 | +| `feature_edge_min_dihedral_deg` | 가장자리를 특징 가장자리로 간주하기 위한 최소 이면각(도)입니다. (기본값: 30.0) | FLOAT | 아니오 | 0.0 to 180.0 | +| `clamp_v_to_edge` | QEM 최적 위치를 축약된 가장자리 세그먼트에 투영합니다. (기본값: true) | BOOLEAN | 아니오 | `true`
`false` | + +참고: `target_face_count`가 0이거나 메시에 이미 대상보다 적은 면이 있는 경우 데시메이션은 건너뜁니다. 노드는 자체적으로 면 감소 요약을 표시합니다(예: `faces: 1.23M → 200K (-84%)`). + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `mesh` | 면 수가 줄어든 단순화된 메시입니다. 연결성은 용접된 상태로 유지됩니다. | MESH | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/DecimateMesh/ko.md) + +--- +**Source fingerprint (SHA-256):** `55336e5b52e27d940e5402ecd74fd0ac847a1c6acd35955eccf72aab8ed940f9` diff --git a/comfyui_embedded_docs/docs/DecimateMesh/pt-BR.md b/comfyui_embedded_docs/docs/DecimateMesh/pt-BR.md new file mode 100644 index 000000000..91a4ca17b --- /dev/null +++ b/comfyui_embedded_docs/docs/DecimateMesh/pt-BR.md @@ -0,0 +1,41 @@ +# DecimateMesh + +DecimateMesh simplifica uma malha 3D para uma contagem alvo de faces usando simplificação por métrica de erro quadrático (QEM), executando o cálculo no dispositivo de computação ativo. O modo de posicionamento `"midpoint"` é a predefinição fiel ao cumesh, que oferece a melhor qualidade ao preservar características finas, como cabelos, enquanto `"qem"` posiciona vértices na posição ótima por QEM, com controles opcionais de linhas e arestas de características. A malha de saída permanece soldada. + +## Entradas + +### Entradas Comuns + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | +|-----------|-------------|-----------|----------|-------| +| `mesh` | A malha 3D a ser simplificada. | MESH | Sim | - | +| `target_face_count` | Número máximo de faces alvo. 0 desativa. (padrão: 200000) | INT | Sim | 0 a 50000000 | +| `placement_mode` | midpoint: fiel ao cumesh (recomendado). qem: posicionamento ótimo por QEM. (padrão: `"midpoint"`) | DYNAMIC_COMBO | Sim | `"midpoint"`
`"qem"` | + +### Entradas do Midpoint + +O modo de posicionamento `"midpoint"` não expõe subparâmetros adicionais; ele usa a predefinição padrão de posicionamento midpoint. + +### Entradas do QEM + +Os seguintes subparâmetros aparecem na interface somente quando `placement_mode` está definido como `"qem"`. + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | +|-----------|-------------|-----------|----------|-------| +| `line_quadric_weight` | Peso da quadrática de linha por aresta; preserva cristas/vales acentuados. 0 = desativado. (padrão: 0.0) | FLOAT | Não | 0.0 a 100.0 | +| `feature_edge_quadric_weight` | Peso quadrático extra em arestas de características diedrais (vincos). 0 = desativado. (padrão: 0.0) | FLOAT | Não | 0.0 a 1000.0 | +| `feature_edge_min_dihedral_deg` | Ângulo diedral mínimo (em graus) para uma aresta ser considerada aresta de característica. (padrão: 30.0) | FLOAT | Não | 0.0 a 180.0 | +| `clamp_v_to_edge` | Projeta a posição ótima por QEM no segmento de aresta colapsado. (padrão: true) | BOOLEAN | Não | `true`
`false` | + +Observação: a decimação é ignorada quando `target_face_count` é 0 ou quando a malha já tem menos faces que o alvo. O nó exibe um resumo da redução de faces nele mesmo, por exemplo `faces: 1.23M → 200K (-84%)`. + +## Saídas + +| Nome da Saída | Descrição | Tipo de Dados | +|-------------|-------------|-----------| +| `mesh` | A malha simplificada com a contagem reduzida de faces; a conectividade permanece soldada. | MESH | + +> Esta documentação foi gerada por IA. Se você encontrar erros ou tiver sugestões de melhoria, sinta-se à vontade para contribuir! [Editar no GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/DecimateMesh/pt-BR.md) + +--- +**Source fingerprint (SHA-256):** `55336e5b52e27d940e5402ecd74fd0ac847a1c6acd35955eccf72aab8ed940f9` diff --git a/comfyui_embedded_docs/docs/DecimateMesh/ru.md b/comfyui_embedded_docs/docs/DecimateMesh/ru.md new file mode 100644 index 000000000..fcdc95b3a --- /dev/null +++ b/comfyui_embedded_docs/docs/DecimateMesh/ru.md @@ -0,0 +1,41 @@ +# DecimateMesh + +DecimateMesh упрощает 3D-сетку до целевого количества граней, используя упрощение на основе квадричной метрики ошибок (QEM), и выполняет вычисления на активном вычислительном устройстве. Режим размещения `"midpoint"` — это точный пресет cumesh, обеспечивающий наилучшее качество при сохранении тонких деталей, таких как волосы, тогда как `"qem"` размещает вершины в оптимальной позиции QEM с дополнительными опциями для линий и рёбер признаков. Выходная сетка остаётся целостной (welded). + +## Входы + +### Общие входы + +| Параметр | Описание | Тип данных | Обязательный | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `mesh` | 3D-сетка для упрощения. | MESH | Да | - | +| `target_face_count` | Целевое максимальное количество граней. 0 отключает. (по умолчанию: 200000) | INT | Да | от 0 до 50000000 | +| `placement_mode` | midpoint: точный режим cumesh (рекомендуется). qem: оптимальное размещение QEM. (по умолчанию: `"midpoint"`) | DYNAMIC_COMBO | Да | `"midpoint"`
`"qem"` | + +### Входы Midpoint + +Режим размещения `"midpoint"` не предоставляет дополнительных подпараметров; он использует стандартный пресет размещения midpoint. + +### Входы QEM + +Следующие подпараметры появляются в интерфейсе только когда `placement_mode` установлен в `"qem"`. + +| Параметр | Описание | Тип данных | Обязательный | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `line_quadric_weight` | Вес линейной квадрики на ребро; сохраняет острые гребни/впадины. 0 = выкл. (по умолчанию: 0.0) | FLOAT | Нет | от 0.0 до 100.0 | +| `feature_edge_quadric_weight` | Дополнительный вес квадрики на двугранных рёбрах признаков (изломах). 0 = выкл. (по умолчанию: 0.0) | FLOAT | Нет | от 0.0 до 1000.0 | +| `feature_edge_min_dihedral_deg` | Минимальный двугранный угол (в градусах), чтобы считать ребро ребром признака. (по умолчанию: 30.0) | FLOAT | Нет | от 0.0 до 180.0 | +| `clamp_v_to_edge` | Проецировать оптимальную позицию QEM на сегмент схлопнутого ребра. (по умолчанию: true) | BOOLEAN | Нет | `true`
`false` | + +Примечание: Децимация пропускается, когда `target_face_count` равен 0 или когда сетка уже имеет меньше граней, чем цель. Узел отображает на себе сводку по сокращению граней, например `faces: 1.23M → 200K (-84%)`. + +## Выходы + +| Имя выхода | Описание | Тип данных | +|-------------|-------------|-----------| +| `mesh` | Упрощённая сетка с уменьшенным количеством граней; связность остаётся целостной. | MESH | + +> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/DecimateMesh/ru.md) + +--- +**Source fingerprint (SHA-256):** `55336e5b52e27d940e5402ecd74fd0ac847a1c6acd35955eccf72aab8ed940f9` diff --git a/comfyui_embedded_docs/docs/DecimateMesh/tr.md b/comfyui_embedded_docs/docs/DecimateMesh/tr.md new file mode 100644 index 000000000..8eeec7b8b --- /dev/null +++ b/comfyui_embedded_docs/docs/DecimateMesh/tr.md @@ -0,0 +1,41 @@ +# DecimateMesh + +DecimateMesh, kuadrik hata metriği (QEM) sadeleştirmesi kullanarak bir 3B ağı hedef yüz sayısına sadeleştirir ve hesaplamayı etkin hesaplama aygıtında çalıştırır. `"midpoint"` yerleştirme modu, saç gibi ince özellikleri korurken en iyi kaliteyi sağlayan cumesh-faithful ön ayarıdır; `"qem"` ise köşeleri QEM-optimal konumuna yerleştirir ve isteğe bağlı çizgi ile özellik kenarı kontrolleri sunar. Çıktı ağı kaynaklı (welded) kalır. + +## Girdiler + +### Genel Girdiler + +| Parametre | Açıklama | Veri Türü | Zorunlu | Aralık | +|-----------|-------------|-----------|----------|-------| +| `mesh` | Sadeleştirilecek 3B ağ. | MESH | Evet | - | +| `target_face_count` | Hedef maksimum yüz sayısı. 0 devre dışı bırakır. (varsayılan: 200000) | INT | Evet | 0 ila 50000000 | +| `placement_mode` | midpoint: cumesh-faithful (önerilir). qem: QEM-optimal yerleştirme. (varsayılan: `"midpoint"`) | DYNAMIC_COMBO | Evet | `"midpoint"`
`"qem"` | + +### Midpoint Girdileri + +`"midpoint"` yerleştirme modu ek alt parametreler sunmaz; varsayılan midpoint yerleştirme ön ayarını kullanır. + +### QEM Girdileri + +Aşağıdaki alt parametreler, yalnızca `placement_mode` `"qem"` olarak ayarlandığında arayüzde görünür. + +| Parametre | Açıklama | Veri Türü | Zorunlu | Aralık | +|-----------|-------------|-----------|----------|-------| +| `line_quadric_weight` | Kenar başına çizgi-kuadrik ağırlığı; keskin sırtları/vadileri korur. 0 = kapalı. (varsayılan: 0.0) | FLOAT | Hayır | 0.0 ila 100.0 | +| `feature_edge_quadric_weight` | Dihedral özellik kenarlarına (kıvrımlar) ek kuadrik ağırlığı. 0 = kapalı. (varsayılan: 0.0) | FLOAT | Hayır | 0.0 ila 1000.0 | +| `feature_edge_min_dihedral_deg` | Bir kenarın özellik kenarı sayılması için minimum dihedral açı (derece). (varsayılan: 30.0) | FLOAT | Hayır | 0.0 ila 180.0 | +| `clamp_v_to_edge` | QEM-optimal konumunu daraltılmış kenar parçasına yansıt. (varsayılan: true) | BOOLEAN | Hayır | `true`
`false` | + +Not: `target_face_count` 0 olduğunda veya ağ zaten hedeften daha az yüze sahip olduğunda sadeleştirme atlanır. Düğüm, üzerinde yüz azaltma özetini görüntüler, örneğin `faces: 1.23M → 200K (-84%)`. + +## Çıktılar + +| Çıktı Adı | Açıklama | Veri Türü | +|-------------|-------------|-----------| +| `mesh` | Azaltılmış yüz sayısına sahip sadeleştirilmiş ağ; bağlantı kaynaklı kalır. | MESH | + +> Bu belge yapay zeka tarafından oluşturulmuştur. Herhangi bir hata bulursanız veya iyileştirme önerileriniz varsa, katkıda bulunmaktan çekinmeyin! [GitHub'da Düzenle](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/DecimateMesh/tr.md) + +--- +**Source fingerprint (SHA-256):** `55336e5b52e27d940e5402ecd74fd0ac847a1c6acd35955eccf72aab8ed940f9` diff --git a/comfyui_embedded_docs/docs/DecimateMesh/zh-TW.md b/comfyui_embedded_docs/docs/DecimateMesh/zh-TW.md new file mode 100644 index 000000000..d9785b363 --- /dev/null +++ b/comfyui_embedded_docs/docs/DecimateMesh/zh-TW.md @@ -0,0 +1,41 @@ +# DecimateMesh + +DecimateMesh 會使用二次誤差度量(QEM)簡化方式,將 3D 網格簡化至目標面數,並在作用中的運算裝置上執行。`"midpoint"` 放置模式是 cumesh-faithful 預設,能在保留頭髮等纖細特徵的同時提供最佳品質;而 `"qem"` 則會將頂點放置在 QEM 最佳位置,並可選用線與特徵邊控制。輸出網格會維持焊接狀態。 + +## 輸入 + +### 通用輸入 + +| 參數 | 描述 | 資料類型 | 必填 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `mesh` | 要簡化的 3D 網格。 | MESH | 是 | - | +| `target_face_count` | 目標最大面數。設為 0 則停用簡化。(預設:200000) | INT | 是 | 0 到 50000000 | +| `placement_mode` | midpoint:cumesh-faithful(建議)。qem:QEM 最佳位置放置。(預設:`"midpoint"`) | DYNAMIC_COMBO | 是 | `"midpoint"`
`"qem"` | + +### Midpoint 輸入 + +`"midpoint"` 放置模式不會顯示額外的子參數,而是使用預設的 midpoint 放置預設。 + +### QEM 輸入 + +以下子參數僅在 `placement_mode` 設定為 `"qem"` 時才會出現在介面中。 + +| 參數 | 描述 | 資料類型 | 必填 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `line_quadric_weight` | 每條邊的線性二次型權重;保留銳利的稜線與谷線。0 為關閉。(預設:0.0) | FLOAT | 否 | 0.0 到 100.0 | +| `feature_edge_quadric_weight` | 二面角特徵邊(摺痕)上的額外二次型權重。0 為關閉。(預設:0.0) | FLOAT | 否 | 0.0 到 1000.0 | +| `feature_edge_min_dihedral_deg` | 將邊視為特徵邊所需的最小二面角(度數)。(預設:30.0) | FLOAT | 否 | 0.0 到 180.0 | +| `clamp_v_to_edge` | 將 QEM 最佳位置投影到坍縮後的邊線段上。(預設:true) | BOOLEAN | 否 | `true`
`false` | + +注意:當 `target_face_count` 為 0,或網格的面數已少於目標值時,將跳過簡化。節點會顯示面數減少的摘要,例如 `faces: 1.23M → 200K (-84%)`。 + +## 輸出 + +| 輸出名 | 描述 | 資料類型 | +|-------------|-------------|-----------| +| `mesh` | 簡化後的網格,面數已減少;連通性保持焊接狀態。 | MESH | + +> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/DecimateMesh/zh-TW.md) + +--- +**Source fingerprint (SHA-256):** `55336e5b52e27d940e5402ecd74fd0ac847a1c6acd35955eccf72aab8ed940f9` diff --git a/comfyui_embedded_docs/docs/DecimateMesh/zh.md b/comfyui_embedded_docs/docs/DecimateMesh/zh.md new file mode 100644 index 000000000..a2470e289 --- /dev/null +++ b/comfyui_embedded_docs/docs/DecimateMesh/zh.md @@ -0,0 +1,41 @@ +# DecimateMesh + +DecimateMesh 使用二次误差度量(QEM)简化方法将 3D 网格简化为目标面数,并在当前计算设备上执行计算。`"midpoint"` 放置模式是 cumesh-faithful 预设,在保留头发等细小特征的同时提供最佳质量;而 `"qem"` 模式则将顶点放置在 QEM 最优位置,并提供可选的线条和特征边缘控制。输出网格保持焊接状态。 + +## 输入 + +### 通用输入 + +| 参数 | 描述 | 数据类型 | 必填 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `mesh` | 要简化的 3D 网格。 | MESH | 是 | - | +| `target_face_count` | 目标最大面数。0 表示禁用。(默认:200000) | INT | 是 | 0 到 50000000 | +| `placement_mode` | midpoint:cumesh-faithful(推荐)。qem:QEM 最优放置。(默认:`"midpoint"`) | DYNAMIC_COMBO | 是 | `"midpoint"`
`"qem"` | + +### Midpoint 输入 + +`"midpoint"` 放置模式不暴露额外的子参数;它使用默认的 midpoint 放置预设。 + +### QEM 输入 + +仅当 `placement_mode` 设置为 `"qem"` 时,以下子参数才会出现在界面中。 + +| 参数 | 描述 | 数据类型 | 必填 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `line_quadric_weight` | 每条边的线二次误差加权值;保留清晰的锐利边缘/谷线。0 表示关闭。(默认:0.0) | FLOAT | 否 | 0.0 到 100.0 | +| `feature_edge_quadric_weight` | 二面角特征边缘(折痕)上的额外二次误差加权值。0 表示关闭。(默认:0.0) | FLOAT | 否 | 0.0 到 1000.0 | +| `feature_edge_min_dihedral_deg` | 将一条边视为特征边缘的最小二面角(度)。(默认:30.0) | FLOAT | 否 | 0.0 到 180.0 | +| `clamp_v_to_edge` | 将 QEM 最优位置投影到折叠后的边段上。(默认:true) | BOOLEAN | 否 | `true`
`false` | + +注意:当 `target_face_count` 为 0 或网格的面数已经少于目标时,将跳过简化。节点会显示面数减少摘要,例如 `faces: 1.23M → 200K (-84%)`。 + +## 输出 + +| 输出名称 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `mesh` | 面数减少后的简化网格;连接性保持焊接状态。 | MESH | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/DecimateMesh/zh.md) + +--- +**Source fingerprint (SHA-256):** `55336e5b52e27d940e5402ecd74fd0ac847a1c6acd35955eccf72aab8ed940f9` diff --git a/comfyui_embedded_docs/docs/DiffusersLoader/en.md b/comfyui_embedded_docs/docs/DiffusersLoader/en.md index 7c07dd074..d192261ad 100644 --- a/comfyui_embedded_docs/docs/DiffusersLoader/en.md +++ b/comfyui_embedded_docs/docs/DiffusersLoader/en.md @@ -1,22 +1,22 @@ # Load Diffusers Model (DEPRECATED) -The DiffusersLoader node loads pre-trained models from the diffusers format. It searches for valid diffusers model directories containing a `model_index.json` file and loads them as MODEL, CLIP, and VAE components for use in the pipeline. This node is part of the deprecated loaders category and provides compatibility with Hugging Face diffusers models. +The DiffusersLoader node loads pre-trained models saved in the diffusers format. It searches the configured `diffusers` folders for directories that contain a `model_index.json` file, lets you select one, and loads it as the MODEL, CLIP, and VAE components used in the pipeline. This node is deprecated, but remains available for compatibility with Hugging Face diffusers models. ## Inputs | Parameter | Description | Data Type | Required | Range | -| --- | --- | --- | --- | --- | -| `model_path` | The path to the diffusers model directory to load. The node automatically scans for valid diffusers models in the configured diffusers folders and lists available options. | STRING | Yes | Multiple options available
(auto-populated from diffusers folders) | +|-----------|-------------|-----------|----------|-------| +| `model_path` | The path to the diffusers model directory to load. The node automatically scans the configured diffusers folders for valid models and lists the available options. | COMBO | Yes | Multiple options available
(auto-populated from diffusers folders) | ## Outputs | Output Name | Description | Data Type | -| --- | --- | --- | -| `MODEL` | The loaded model component from the diffusers format | MODEL | -| `CLIP` | The loaded CLIP model component from the diffusers format | CLIP | -| `VAE` | The loaded VAE (Variational Autoencoder) component from the diffusers format | VAE | +|-----------|-------------|-----------| +| `MODEL` | The loaded model component from the diffusers format. | MODEL | +| `CLIP` | The loaded CLIP model component from the diffusers format. | CLIP | +| `VAE` | The loaded VAE (Variational Autoencoder) component from the diffusers format. | VAE | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/DiffusersLoader/en.md) --- -**Source fingerprint (SHA-256):** `59be9923ed76d4859d5f7217a802c43297cb5af3d895eb6713edea97a32c3db2` +**Source fingerprint (SHA-256):** `75238342d05eac7528f981a2d4544accb6053891cd078a77751cc838054225d4` diff --git a/comfyui_embedded_docs/docs/DisableNoise/en.md b/comfyui_embedded_docs/docs/DisableNoise/en.md index d77d793a2..3a0a173aa 100644 --- a/comfyui_embedded_docs/docs/DisableNoise/en.md +++ b/comfyui_embedded_docs/docs/DisableNoise/en.md @@ -1,6 +1,6 @@ # DisableNoise -The DisableNoise node provides an empty noise configuration that can be used to disable noise generation in sampling processes. It returns a special noise object that contains no noise data, allowing other nodes to skip noise-related operations when connected to this output. +The DisableNoise node provides an empty noise configuration that can be used to disable noise generation in sampling processes. It returns a special noise object that contains no noise data, allowing other nodes to skip noise-related operations when connected to this output. The node is also searchable under the alias "zero noise". ## Inputs @@ -17,4 +17,4 @@ The DisableNoise node provides an empty noise configuration that can be used to > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/DisableNoise/en.md) --- -**Source fingerprint (SHA-256):** `2453a37e98083b879a91c23d6342b9420a16783b78719117a38de627800381b4` +**Source fingerprint (SHA-256):** `b9edcda655dab3196233b6c66fdb41eb0585b153616b793016d532992b922934` diff --git a/comfyui_embedded_docs/docs/DualCFGGuider/en.md b/comfyui_embedded_docs/docs/DualCFGGuider/en.md index 136212e32..f605bddcb 100644 --- a/comfyui_embedded_docs/docs/DualCFGGuider/en.md +++ b/comfyui_embedded_docs/docs/DualCFGGuider/en.md @@ -1,6 +1,6 @@ # Dual CFG Guider -The DualCFGGuider node creates a guidance system for dual classifier-free guidance sampling. It combines two positive conditioning inputs with one negative conditioning input, applying different guidance scales to each conditioning pair to control the influence of each prompt on the generated output. +The DualCFGGuider node creates a guidance system for dual classifier-free guidance sampling. It combines two conditioning inputs with one negative conditioning input and applies two separate guidance scales to control how strongly each conditioning influences the generated output. It supports two styles of combining these guidance scales, "regular" and "nested". ## Inputs @@ -8,12 +8,14 @@ The DualCFGGuider node creates a guidance system for dual classifier-free guidan | --- | --- | --- | --- | --- | | `model` | The model to use for guidance | MODEL | Yes | - | | `cond1` | The first positive conditioning input | CONDITIONING | Yes | - | -| `cond2` | The second positive conditioning input | CONDITIONING | Yes | - | +| `cond2` | The second conditioning input, used as the reference between the first positive conditioning and the negative conditioning | CONDITIONING | Yes | - | | `negative` | The negative conditioning input | CONDITIONING | Yes | - | -| `cfg_conds` | Guidance scale for the first positive conditioning (default: 8.0) | FLOAT | Yes | 0.0 - 100.0 | -| `cfg_cond2_negative` | Guidance scale for the second positive and negative conditioning (default: 8.0) | FLOAT | Yes | 0.0 - 100.0 | +| `cfg_conds` | Guidance scale applied to the first positive conditioning (default: 8.0) | FLOAT | Yes | 0.0 - 100.0 | +| `cfg_cond2_negative` | Guidance scale applied between the second conditioning and the negative conditioning (default: 8.0) | FLOAT | Yes | 0.0 - 100.0 | | `style` | The guidance style to apply (default: "regular"). When set to "nested", the guidance is applied in a nested fashion | COMBO | Yes | "regular"
"nested" | +Note: In `regular` style, `cfg_cond2_negative` is applied between `cond2` and `negative`, and `cfg_conds` is applied between `cond1` and `cond2`. In `nested` style, `cfg_conds` is applied first between `cond1` and `cond2`, and the resulting prediction is then guided away from `negative` using `cfg_cond2_negative`. + ## Outputs | Output Name | Description | Data Type | @@ -23,4 +25,4 @@ The DualCFGGuider node creates a guidance system for dual classifier-free guidan > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/DualCFGGuider/en.md) --- -**Source fingerprint (SHA-256):** `5440fb55429b8c30ef88ee0eff74c8a54916b1ce644f93d5d0d5742b5056637d` +**Source fingerprint (SHA-256):** `ef28d109149cb545bcd76215fd99535905c1d395222149a029c1c210e2912e97` diff --git a/comfyui_embedded_docs/docs/EasyCache/en.md b/comfyui_embedded_docs/docs/EasyCache/en.md index ce62d5df9..ab38b3943 100644 --- a/comfyui_embedded_docs/docs/EasyCache/en.md +++ b/comfyui_embedded_docs/docs/EasyCache/en.md @@ -1,16 +1,16 @@ # EasyCache -The EasyCache node implements a native caching system for models to improve performance by reusing previously computed steps during the sampling process. It adds EasyCache functionality to a model with configurable thresholds for when to start and stop using the cache during the sampling timeline. +The EasyCache node adds a native caching system to a diffusion model that speeds up sampling by reusing results from previously computed steps instead of recomputing every step. It activates only between a configurable start and end point of the sampling process, and skips steps when the estimated output change stays below a user-defined threshold. This is an experimental node intended for advanced debugging use. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | | `model` | The model to add EasyCache to. | MODEL | Yes | - | -| `reuse_threshold` | The threshold for reusing cached steps (default: 0.2). | FLOAT | No | 0.0 - 3.0 | -| `start_percent` | The relative sampling step to begin use of EasyCache (default: 0.15). | FLOAT | No | 0.0 - 1.0 | -| `end_percent` | The relative sampling step to end use of EasyCache (default: 0.95). | FLOAT | No | 0.0 - 1.0 | -| `verbose` | Whether to log verbose information (default: False). | BOOLEAN | No | - | +| `reuse_threshold` | The threshold for reusing cached steps (default: 0.2). | FLOAT | Yes | 0.0 - 3.0 | +| `start_percent` | The relative sampling step to begin use of EasyCache (default: 0.15). | FLOAT | Yes | 0.0 - 1.0 | +| `end_percent` | The relative sampling step to end use of EasyCache (default: 0.95). | FLOAT | Yes | 0.0 - 1.0 | +| `verbose` | Whether to log verbose information (default: False). | BOOLEAN | Yes | - | ## Outputs @@ -21,4 +21,4 @@ The EasyCache node implements a native caching system for models to improve perf > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/EasyCache/en.md) --- -**Source fingerprint (SHA-256):** `c94867faae0005743a593a20d432fe3a3d01624148d0dbd1f2576df54026b2ab` +**Source fingerprint (SHA-256):** `3e10ac65f8df58ce8649fdf599e62bfb86f2d4166840bed5622c0aa2c419cd38` diff --git a/comfyui_embedded_docs/docs/ElevenLabsSpeechToSpeech/en.md b/comfyui_embedded_docs/docs/ElevenLabsSpeechToSpeech/en.md index 1597b81d6..a707b5a62 100644 --- a/comfyui_embedded_docs/docs/ElevenLabsSpeechToSpeech/en.md +++ b/comfyui_embedded_docs/docs/ElevenLabsSpeechToSpeech/en.md @@ -4,15 +4,28 @@ The ElevenLabs Speech to Speech node transforms an input audio file from one voi ## Inputs +### Common Inputs + | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| +| `model` | Model to use for speech-to-speech transformation. The selected model determines the available voice settings listed below. | DYNAMIC_COMBO | Yes | `eleven_multilingual_sts_v2`
`eleven_english_sts_v2` | | `voice` | Target voice for the transformation. Connect from Voice Selector or Instant Voice Clone. | CUSTOM | Yes | - | | `audio` | Source audio to transform. | AUDIO | Yes | - | -| `stability` | Voice stability. Lower values give broader emotional range, higher values produce more consistent but potentially monotonous speech (default: 0.5). | FLOAT | No | 0.0 - 1.0 | -| `model` | Model to use for speech-to-speech transformation. Each option provides a specific set of voice settings (similarity_boost, style, use_speaker_boost, speed). | DYNAMICCOMBO | No | `eleven_multilingual_sts_v2`
`eleven_english_sts_v2` | -| `output_format` | Audio output format (default: "mp3_44100_192"). | COMBO | No | `"mp3_44100_192"`
`"opus_48000_192"` | -| `seed` | Seed for reproducibility (default: 0). | INT | No | 0 - 4294967295 | -| `remove_background_noise` | Remove background noise from input audio using audio isolation (default: False). | BOOLEAN | No | - | +| `stability` | Voice stability. Lower values give broader emotional range, higher values produce more consistent but potentially monotonous speech (default: 0.5). | FLOAT | Yes | 0.0 - 1.0 | +| `output_format` | Audio output format (default: "mp3_44100_192"). | COMBO | Yes | `"mp3_44100_192"`
`"opus_48000_192"` | +| `seed` | Seed for reproducibility (default: 0). | INT | Yes | 0 - 4294967295 | +| `remove_background_noise` | Remove background noise from input audio using audio isolation (default: False). | BOOLEAN | Yes | - | + +### eleven_multilingual_sts_v2 and eleven_english_sts_v2 Inputs + +Both models provide the same set of voice settings below. + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `speed` | Speech speed. 1.0 is normal, <1.0 slower, >1.0 faster (default: 1.0). | FLOAT | Yes | 0.7 - 1.3 | +| `similarity_boost` | Similarity boost. Higher values make the voice more similar to the original (default: 0.75). | FLOAT | Yes | 0.0 - 1.0 | +| `use_speaker_boost` | Boost similarity to the original speaker voice (default: False). | BOOLEAN | Yes | - | +| `style` | Style exaggeration. Higher values increase stylistic expression but may reduce stability (default: 0.0). | FLOAT | Yes | 0.0 - 0.2 | ## Outputs diff --git a/comfyui_embedded_docs/docs/ElevenLabsSpeechToText/en.md b/comfyui_embedded_docs/docs/ElevenLabsSpeechToText/en.md index 9a7b50c32..9da93d2ac 100644 --- a/comfyui_embedded_docs/docs/ElevenLabsSpeechToText/en.md +++ b/comfyui_embedded_docs/docs/ElevenLabsSpeechToText/en.md @@ -1,23 +1,32 @@ # ElevenLabs Speech to Text -The ElevenLabs Speech to Text node transcribes audio files into text. It uses ElevenLabs' API to convert spoken words into a written transcript, supporting features like automatic language detection, identifying different speakers, and tagging non-speech sounds like music or laughter. +The ElevenLabs Speech to Text node transcribes audio into text using the ElevenLabs API. It supports automatic language detection, speaker diarization (identifying different speakers), and audio event tagging (annotating sounds like laughter or music in the transcript). ## Inputs +### Common Inputs + | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | +| `model` | Model to use for transcription. Selecting this model reveals additional parameters. | DYNAMIC_COMBO | Yes | `"scribe_v2"` | | `audio` | Audio to transcribe. | AUDIO | Yes | - | -| `model` | Model to use for transcription. Selecting this model reveals additional parameters. | COMBO | Yes | `"scribe_v2"` | -| `tag_audio_events` | Annotate sounds like (laughter), (music), etc. in transcript. This parameter is revealed when the `"scribe_v2"` model is selected. (default: False) | BOOLEAN | No | - | -| `diarize` | Annotate which speaker is talking. This parameter is revealed when the `"scribe_v2"` model is selected. (default: False) | BOOLEAN | No | - | -| `diarization_threshold` | Speaker separation sensitivity. Lower values are more sensitive to speaker changes. This parameter is revealed when the `"scribe_v2"` model is selected and `diarize` is enabled. (default: 0.22) | FLOAT | No | 0.1 - 0.4 | -| `temperature` | Randomness control. 0.0 uses model default. Higher values increase randomness. This parameter is revealed when the `"scribe_v2"` model is selected. (default: 0.0) | FLOAT | No | 0.0 - 2.0 | -| `timestamps_granularity` | Timing precision for transcript words. This parameter is revealed when the `"scribe_v2"` model is selected. (default: "word") | COMBO | No | `"word"`
`"character"`
`"none"` | | `language_code` | ISO-639-1 or ISO-639-3 language code (e.g., 'en', 'es', 'fra'). Leave empty for automatic detection. (default: "") | STRING | No | - | | `num_speakers` | Maximum number of speakers to predict. Set to 0 for automatic detection. (default: 0) | INT | No | 0 - 32 | | `seed` | Seed for reproducibility (determinism not guaranteed). (default: 1) | INT | No | 0 - 2147483647 | -**Note:** The `num_speakers` parameter cannot be set to a value greater than 0 when the `diarize` option is enabled. You must either disable `diarize` or set `num_speakers` to 0. +### Scribe v2 Inputs + +These parameters are shown when the `"scribe_v2"` model is selected. + +| Parameter | Description | Data Type | Required | Range | +| --- | --- | --- | --- | --- | +| `tag_audio_events` | Annotate sounds like (laughter), (music), etc. in transcript. (default: False) | BOOLEAN | No | - | +| `diarize` | Annotate which speaker is talking. (default: False) | BOOLEAN | No | - | +| `diarization_threshold` | Speaker separation sensitivity. Lower values are more sensitive to speaker changes. Only used when `diarize` is enabled. (default: 0.22) | FLOAT | No | 0.1 - 0.4 | +| `temperature` | Randomness control. 0.0 uses model default. Higher values increase randomness. (default: 0.0) | FLOAT | No | 0.0 - 2.0 | +| `timestamps_granularity` | Timing precision for transcript words. (default: "word") | COMBO | No | `"word"`
`"character"`
`"none"` | + +**Note:** `num_speakers` cannot be set to a value greater than 0 when `diarize` is enabled. You must either disable `diarize` or set `num_speakers` to 0. ## Outputs diff --git a/comfyui_embedded_docs/docs/ElevenLabsTextToDialogue/en.md b/comfyui_embedded_docs/docs/ElevenLabsTextToDialogue/en.md index 048bf17a2..d447947d4 100644 --- a/comfyui_embedded_docs/docs/ElevenLabsTextToDialogue/en.md +++ b/comfyui_embedded_docs/docs/ElevenLabsTextToDialogue/en.md @@ -9,12 +9,12 @@ The ElevenLabs Text to Dialogue node generates a multi-speaker audio dialogue fr | `stability` | Voice stability. Lower values give broader emotional range, higher values produce more consistent but potentially monotonous speech. (default: 0.5) | FLOAT | No | 0.0 - 1.0 | | `apply_text_normalization` | Text normalization mode. 'auto' lets the system decide, 'on' always applies normalization, 'off' skips it. | COMBO | No | `"auto"`
`"on"`
`"off"` | | `model` | Model to use for dialogue generation. | COMBO | No | `"eleven_v3"` | -| `inputs` | Number of dialogue entries. Selecting a number will generate that many text and voice input fields. | DYNAMICCOMBO | Yes | `"1"`
`"2"`
`"3"`
`"4"`
`"5"`
`"6"`
`"7"`
`"8"`
`"9"`
`"10"` | +| `inputs` | Number of dialogue entries. Selecting a number will generate that many text and voice input fields. | DYNAMIC_COMBO | Yes | `"1"`
`"2"`
`"3"`
`"4"`
`"5"`
`"6"`
`"7"`
`"8"`
`"9"`
`"10"` | | `language_code` | ISO-639-1 or ISO-639-3 language code (e.g., 'en', 'es', 'fra'). Leave empty for automatic detection. (default: empty) | STRING | No | - | | `seed` | Seed for reproducibility. (default: 1) | INT | No | 0 - 4294967295 | | `output_format` | Audio output format. | COMBO | No | `"mp3_44100_192"`
`"opus_48000_192"` | -**Note:** The `inputs` parameter is dynamic. When you select a number (e.g., "3"), the node will display three corresponding `text` and `voice` input fields (e.g., `text1`, `voice1`, `text2`, `voice2`, `text3`, `voice3`). Each `text` field must contain at least one character. +**Note:** The `inputs` parameter is dynamic. When you select a number (e.g., "3"), the node will display three corresponding `text` and `voice` input fields (e.g., `text1`, `voice1`, `text2`, `voice2`, `text3`, `voice3`). Each `text` field must contain at least one character. Each `voice` field expects a voice connected from a Voice Selector or Instant Voice Clone node. ## Outputs diff --git a/comfyui_embedded_docs/docs/ElevenLabsTextToSoundEffects/en.md b/comfyui_embedded_docs/docs/ElevenLabsTextToSoundEffects/en.md index 63c9e9a91..1f6c1c0fd 100644 --- a/comfyui_embedded_docs/docs/ElevenLabsTextToSoundEffects/en.md +++ b/comfyui_embedded_docs/docs/ElevenLabsTextToSoundEffects/en.md @@ -4,17 +4,25 @@ The ElevenLabs Text to Sound Effects node generates audio sound effects from a t ## Inputs +### Common Inputs + | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `text` | Text description of the sound effect to generate. | STRING | Yes | N/A | -| `model` | Model to use for sound effect generation. Selecting this model reveals additional parameters: `duration` (default: 5.0, range: 0.5 to 30.0 seconds), `loop` (default: False), and `prompt_influence` (default: 0.3, range: 0.0 to 1.0). | COMBO | Yes | `"eleven_sfx_v2"` | +| `model` | Model to use for sound effect generation. Only one model is currently available: `eleven_sfx_v2`. | DYNAMIC_COMBO | Yes | `"eleven_sfx_v2"` | +| `text` | Text description of the sound effect to generate. (default: empty) | STRING | Yes | N/A | | `output_format` | Audio output format. | COMBO | Yes | `"mp3_44100_192"`
`"opus_48000_192"` | -**Parameter Details:** +### eleven_sfx_v2 Inputs + +These parameters are shown when the `eleven_sfx_v2` model is selected. + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `duration` | Duration of generated sound in seconds. (default: 5.0) | FLOAT | Yes | 0.5 to 30.0 | +| `loop` | Create a smoothly looping sound effect. (default: False) | BOOLEAN | No | True
False | +| `prompt_influence` | How closely generation follows the prompt. Higher values make the sound follow the text more closely. (default: 0.3) | FLOAT | Yes | 0.0 to 1.0 | -* **`model["duration"]`**: Duration of the generated sound in seconds. Default is 5.0, with a minimum of 0.5 and a maximum of 30.0. -* **`model["loop"]`**: When enabled, creates a smoothly looping sound effect. Default is False. -* **`model["prompt_influence"]`**: Controls how closely the generation follows the text prompt. Higher values make the sound follow the text more closely. Default is 0.3, with a range from 0.0 to 1.0. +**Note:** The `text` parameter must not be empty; it is validated before the sound generation request is sent. ## Outputs diff --git a/comfyui_embedded_docs/docs/ElevenLabsTextToSpeech/en.md b/comfyui_embedded_docs/docs/ElevenLabsTextToSpeech/en.md index bc28f19c8..3de0ec07e 100644 --- a/comfyui_embedded_docs/docs/ElevenLabsTextToSpeech/en.md +++ b/comfyui_embedded_docs/docs/ElevenLabsTextToSpeech/en.md @@ -4,30 +4,38 @@ The ElevenLabs Text to Speech node converts written text into spoken audio using ## Inputs +### Common Inputs + | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| +| `model` | Model to use for text-to-speech. Selecting a model reveals its specific parameters. | DYNAMIC_COMBO | No | `"eleven_multilingual_v2"`
`"eleven_v3"` | | `voice` | Voice to use for speech synthesis. Connect from Voice Selector or Instant Voice Clone. | CUSTOM | Yes | N/A | -| `text` | The text to convert to speech. | STRING | Yes | N/A | +| `text` | The text to convert to speech. Must contain at least one character. | STRING | Yes | N/A | | `stability` | Voice stability. Lower values give broader emotional range, higher values produce more consistent but potentially monotonous speech (default: 0.5). | FLOAT | No | 0.0 - 1.0 | | `apply_text_normalization` | Text normalization mode. 'auto' lets the system decide, 'on' always applies normalization, 'off' skips it. | COMBO | No | `"auto"`
`"on"`
`"off"` | -| `model` | Model to use for text-to-speech. Selecting a model reveals its specific parameters. | DYNAMICCOMBO | No | `"eleven_multilingual_v2"`
`"eleven_v3"` | | `language_code` | ISO-639-1 or ISO-639-3 language code (e.g., 'en', 'es', 'fra'). Leave empty for automatic detection (default: ""). | STRING | No | N/A | | `seed` | Seed for reproducibility (determinism not guaranteed) (default: 1). | INT | No | 0 - 2147483647 | | `output_format` | Audio output format. | COMBO | No | `"mp3_44100_192"`
`"opus_48000_192"` | -**Model-Specific Parameters:** +### eleven_multilingual_v2 Inputs + +These parameters become available when `model` is set to `"eleven_multilingual_v2"`. -When the `model` parameter is set to `"eleven_multilingual_v2"`, the following additional parameters become available: +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `speed` | Speech speed. 1.0 is normal, <1.0 slower, >1.0 faster (default: 1.0). | FLOAT | No | 0.7 - 1.3 | +| `similarity_boost` | Similarity boost. Higher values make the voice more similar to the original (default: 0.75). | FLOAT | No | 0.0 - 1.0 | +| `use_speaker_boost` | Boost similarity to the original speaker voice (default: False). | BOOLEAN | No | True / False | +| `style` | Style exaggeration. Higher values increase stylistic expression but may reduce stability (default: 0.0). | FLOAT | No | 0.0 - 0.2 | -- `speed`: Speech speed. 1.0 is normal, <1.0 slower, >1.0 faster (default: 1.0, range: 0.7 - 1.3). -- `similarity_boost`: Similarity boost. Higher values make the voice more similar to the original (default: 0.75, range: 0.0 - 1.0). -- `use_speaker_boost`: Boost similarity to the original speaker voice (default: False). -- `style`: Style exaggeration. Higher values increase stylistic expression but may reduce stability (default: 0.0, range: 0.0 - 0.2). +### eleven_v3 Inputs -When the `model` parameter is set to `"eleven_v3"`, the following additional parameters become available: +These parameters become available when `model` is set to `"eleven_v3"`. -- `speed`: Speech speed. 1.0 is normal, <1.0 slower, >1.0 faster (default: 1.0, range: 0.7 - 1.3). -- `similarity_boost`: Similarity boost. Higher values make the voice more similar to the original (default: 0.75, range: 0.0 - 1.0). +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `speed` | Speech speed. 1.0 is normal, <1.0 slower, >1.0 faster (default: 1.0). | FLOAT | No | 0.7 - 1.3 | +| `similarity_boost` | Similarity boost. Higher values make the voice more similar to the original (default: 0.75). | FLOAT | No | 0.0 - 1.0 | ## Outputs diff --git a/comfyui_embedded_docs/docs/EmptyARVideoLatent/en.md b/comfyui_embedded_docs/docs/EmptyARVideoLatent/en.md index 6fa6c9d27..c111cb755 100644 --- a/comfyui_embedded_docs/docs/EmptyARVideoLatent/en.md +++ b/comfyui_embedded_docs/docs/EmptyARVideoLatent/en.md @@ -17,9 +17,9 @@ The EmptyARVideoLatent node creates a blank, empty latent representation for vid | Output Name | Description | Data Type | | --- | --- | --- | -| `LATENT` | A latent tensor filled with zeros, representing an empty video latent space with the specified dimensions, length, and batch size. The tensor shape is [batch_size, 16, lat_t, height/8, width/8], where lat_t is calculated from the length. | LATENT | +| `LATENT` | A latent tensor filled with zeros, representing an empty video latent space with the specified dimensions, length, and batch size. The tensor shape is [batch_size, 16, lat_t, height/8, width/8], where lat_t = ((length - 1) // 4) + 1 is the number of latent time steps derived from the requested length. | LATENT | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/EmptyARVideoLatent/en.md) --- -**Source fingerprint (SHA-256):** `b36c40d768e846bc67ed6a7bfb4145c6e2a4ca55824296250a88f52d5ae305cf` +**Source fingerprint (SHA-256):** `02ed3c96d94f2a3df9fb5315a5312e5280b9bee280369eb1218ba10bc122e609` diff --git a/comfyui_embedded_docs/docs/EmptyAceStep1.5LatentAudio/en.md b/comfyui_embedded_docs/docs/EmptyAceStep1.5LatentAudio/en.md index 2be88ccb1..9696071a9 100644 --- a/comfyui_embedded_docs/docs/EmptyAceStep1.5LatentAudio/en.md +++ b/comfyui_embedded_docs/docs/EmptyAceStep1.5LatentAudio/en.md @@ -18,4 +18,4 @@ The Empty Ace Step 1.5 Latent Audio node creates an empty latent tensor designed > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/EmptyAceStep1.5LatentAudio/en.md) --- -**Source fingerprint (SHA-256):** `dc87da02daa14d19afb0a1b421ee87fdcaf53d5a1e5f5175bfcc8e9fbcd7fa48` +**Source fingerprint (SHA-256):** `bb7120c91ce5d779147cb8553d6f96fa160d87468d4d87550fb6dd4ec89b1557` diff --git a/comfyui_embedded_docs/docs/EmptyAceStepLatentAudio/en.md b/comfyui_embedded_docs/docs/EmptyAceStepLatentAudio/en.md index 353c63163..699ea8ea8 100644 --- a/comfyui_embedded_docs/docs/EmptyAceStepLatentAudio/en.md +++ b/comfyui_embedded_docs/docs/EmptyAceStepLatentAudio/en.md @@ -1,12 +1,12 @@ # Empty Ace Step 1.0 Latent Audio -The EmptyAceStepLatentAudio node creates empty latent audio samples of a specified duration. It generates a batch of silent audio latents filled with zeros, where the length is calculated based on the input seconds and audio processing parameters. This node is useful for initializing audio processing workflows that require latent representations. +The Empty Ace Step 1.0 Latent Audio node creates empty latent audio samples of a specified duration. It generates a batch of silent audio latents filled with zeros, where the length is calculated based on the input seconds and audio processing parameters. This node is useful for initializing audio processing workflows that require latent representations. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `seconds` | The duration of the audio in seconds (default: 120.0) | FLOAT | Yes | 1.0 - 1000.0 | +| `seconds` | The duration of the audio in seconds (default: 120.0, step: 0.1) | FLOAT | Yes | 1.0 - 1000.0 | | `batch_size` | The number of latent images in the batch (default: 1) | INT | Yes | 1 - 4096 | ## Outputs @@ -18,4 +18,4 @@ The EmptyAceStepLatentAudio node creates empty latent audio samples of a specifi > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/EmptyAceStepLatentAudio/en.md) --- -**Source fingerprint (SHA-256):** `be20317ed22bf89eeb35a31de0177842f366105da8653e6d7af71241a84967a0` +**Source fingerprint (SHA-256):** `8268eb582a28c7acc495c52831cc6edd8f8fdd1b294857451ce94abc37ca0d14` diff --git a/comfyui_embedded_docs/docs/EmptyChromaRadianceLatentImage/en.md b/comfyui_embedded_docs/docs/EmptyChromaRadianceLatentImage/en.md index e450fb462..970677764 100644 --- a/comfyui_embedded_docs/docs/EmptyChromaRadianceLatentImage/en.md +++ b/comfyui_embedded_docs/docs/EmptyChromaRadianceLatentImage/en.md @@ -10,13 +10,15 @@ The EmptyChromaRadianceLatentImage node creates a blank latent image with specif | `height` | The height of the latent image in pixels (default: 1024, must be divisible by 16) | INT | Yes | 16 to MAX_RESOLUTION | | `batch_size` | The number of latent images to generate in a batch (default: 1) | INT | No | 1 to 4096 | +Note: `width` and `height` are defined with a step of 16, so they must be multiples of 16. + ## Outputs | Output Name | Description | Data Type | | --- | --- | --- | -| `samples` | The generated empty latent image tensor with specified dimensions | LATENT | +| `samples` | The generated empty latent image tensor filled with zeros, with the shape batch_size x 3 x height x width | LATENT | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/EmptyChromaRadianceLatentImage/en.md) --- -**Source fingerprint (SHA-256):** `15f4d3f9803aa3242b07ff4f49946e1f1f409512af07cffe5495e9ce09c587dd` +**Source fingerprint (SHA-256):** `870cc89fb021c258c214db153cda0a32a63da1b6bf92f09cbd3b8498c363096b` diff --git a/comfyui_embedded_docs/docs/EmptyCosmosLatentVideo/en.md b/comfyui_embedded_docs/docs/EmptyCosmosLatentVideo/en.md index b57e403fe..cd4d4692e 100644 --- a/comfyui_embedded_docs/docs/EmptyCosmosLatentVideo/en.md +++ b/comfyui_embedded_docs/docs/EmptyCosmosLatentVideo/en.md @@ -1,23 +1,25 @@ # EmptyCosmosLatentVideo -The EmptyCosmosLatentVideo node creates an empty latent video tensor with specified dimensions. It generates a zero-filled latent representation that can be used as a starting point for video generation workflows, with configurable width, height, length, and batch size parameters. +EmptyCosmosLatentVideo creates an empty latent video tensor with the specified dimensions. It generates a zero-filled latent representation that can be used as a starting point for video generation workflows, with configurable width, height, length, and batch size parameters. ## Inputs | Parameter | Description | Data Type | Required | Range | -| --- | --- | --- | --- | --- | -| `width` | The width of the latent video in pixels (default: 1280, must be divisible by 16) | INT | Yes | 16 to MAX_RESOLUTION | -| `height` | The height of the latent video in pixels (default: 704, must be divisible by 16) | INT | Yes | 16 to MAX_RESOLUTION | -| `length` | The number of frames in the latent video (default: 121, must be divisible by 8) | INT | Yes | 1 to MAX_RESOLUTION | +|-----------|-------------|-----------|----------|-------| +| `width` | The width of the latent video in pixels (default: 1280, increments of 16) | INT | Yes | 16 to MAX_RESOLUTION | +| `height` | The height of the latent video in pixels (default: 704, increments of 16) | INT | Yes | 16 to MAX_RESOLUTION | +| `length` | The number of frames in the latent video (default: 121, increments of 8) | INT | Yes | 1 to MAX_RESOLUTION | | `batch_size` | The number of latent videos to generate in a batch (default: 1) | INT | No | 1 to 4096 | +Note: The latent tensor is spatially downsampled by a factor of 8 in both height and width, and contains 16 channels. The number of latent temporal frames is calculated as `((length - 1) // 8) + 1`. + ## Outputs | Output Name | Description | Data Type | -| --- | --- | --- | +|-------------|-------------|-----------| | `samples` | The generated empty latent video tensor with zero values | LATENT | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/EmptyCosmosLatentVideo/en.md) --- -**Source fingerprint (SHA-256):** `ed7404f31b4b9fb2c098579f8e96e55befb3c8ed045d4175385d01a7b42035e2` +**Source fingerprint (SHA-256):** `7ee194324b02367ed853f6d36bc51742081bac6a9469c4a619586e0560a1b33b` diff --git a/comfyui_embedded_docs/docs/EmptyFlux2LatentImage/en.md b/comfyui_embedded_docs/docs/EmptyFlux2LatentImage/en.md index 620096552..0dac7d30a 100644 --- a/comfyui_embedded_docs/docs/EmptyFlux2LatentImage/en.md +++ b/comfyui_embedded_docs/docs/EmptyFlux2LatentImage/en.md @@ -1,6 +1,6 @@ # Empty Flux 2 Latent -The EmptyFlux2LatentImage node creates a blank, empty latent representation. It generates a tensor filled with zeros, which serves as a starting point for the Flux model's denoising process. The dimensions of the latent are determined by the input width and height, scaled down by a factor of 16. +The Empty Flux 2 Latent node creates a blank, empty latent representation. It generates a tensor filled with zeros, which serves as a starting point for the Flux model's denoising process. The dimensions of the latent are determined by the input width and height, scaled down by a factor of 16. ## Inputs @@ -21,4 +21,4 @@ The EmptyFlux2LatentImage node creates a blank, empty latent representation. It > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/EmptyFlux2LatentImage/en.md) --- -**Source fingerprint (SHA-256):** `337c687b6b3ebb8854618911ab966118940de369ed84bc9c4ed769289b397588` +**Source fingerprint (SHA-256):** `f8356568f0ab521a3f246d1f672492e74f9a2f449694961b913bd14a5f0f3878` diff --git a/comfyui_embedded_docs/docs/EmptyHiDreamO1LatentImage/en.md b/comfyui_embedded_docs/docs/EmptyHiDreamO1LatentImage/en.md index 1346414f8..622a915b1 100644 --- a/comfyui_embedded_docs/docs/EmptyHiDreamO1LatentImage/en.md +++ b/comfyui_embedded_docs/docs/EmptyHiDreamO1LatentImage/en.md @@ -1,7 +1,5 @@ # Empty HiDream-O1 Latent Image -## Overview - This node creates an empty latent image in pixel space, specifically designed for the HiDream-O1-Image model. It generates a blank tensor of zeros that serves as the starting point for image generation, with dimensions defined by the width, height, and batch size inputs. ## Inputs @@ -26,4 +24,4 @@ This node creates an empty latent image in pixel space, specifically designed fo > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/EmptyHiDreamO1LatentImage/en.md) --- -**Source fingerprint (SHA-256):** `fca32bbeddf120b4a7f9a9b88814f5345db133b35252c4d86079397be350c15e` +**Source fingerprint (SHA-256):** `7412639e261512d9174e60009143c8c06c354e2a20ada7271837d72053426be5` diff --git a/comfyui_embedded_docs/docs/EmptyHunyuanImageLatent/en.md b/comfyui_embedded_docs/docs/EmptyHunyuanImageLatent/en.md index 74a32915f..2be5d9afa 100644 --- a/comfyui_embedded_docs/docs/EmptyHunyuanImageLatent/en.md +++ b/comfyui_embedded_docs/docs/EmptyHunyuanImageLatent/en.md @@ -1,11 +1,11 @@ # EmptyHunyuanImageLatent -The EmptyHunyuanImageLatent node creates an empty latent tensor with specific dimensions for use with Hunyuan image generation models. It generates a blank starting point that can be processed through subsequent nodes in the workflow. The node allows you to specify the width, height, and batch size of the latent space. +The EmptyHunyuanImageLatent node creates an empty (zero-filled) latent space for Hunyuan image generation models. It generates a blank starting latent with the specified width, height, and batch size that can be passed to downstream nodes in the workflow. The latent tensor has 64 channels, and its spatial dimensions are the width and height each divided by 32. ## Inputs | Parameter | Description | Data Type | Required | Range | -| --- | --- | --- | --- | --- | +|-----------|-------------|-----------|----------|-------| | `width` | The width of the generated latent image in pixels (default: 2048, step: 32) | INT | Yes | 64 to MAX_RESOLUTION | | `height` | The height of the generated latent image in pixels (default: 2048, step: 32) | INT | Yes | 64 to MAX_RESOLUTION | | `batch_size` | The number of latent samples to generate in a batch (default: 1) | INT | Yes | 1 to 4096 | @@ -13,10 +13,10 @@ The EmptyHunyuanImageLatent node creates an empty latent tensor with specific di ## Outputs | Output Name | Description | Data Type | -| --- | --- | --- | -| `LATENT` | An empty latent tensor with the specified dimensions for Hunyuan image processing | LATENT | +|-------------|-------------|-----------| +| `LATENT` | An empty latent tensor with 64 channels and dimensions of height ÷ 32 by width ÷ 32, ready for Hunyuan image processing | LATENT | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/EmptyHunyuanImageLatent/en.md) --- -**Source fingerprint (SHA-256):** `990878294736fcc89f4435127a81e9eec390d58640694ab35789ed7f578692a1` +**Source fingerprint (SHA-256):** `31fc10d43c224810709870cf40256b6fccd4743445ea9d98d148d443bc591d7a` diff --git a/comfyui_embedded_docs/docs/EmptyHunyuanVideo15Latent/en.md b/comfyui_embedded_docs/docs/EmptyHunyuanVideo15Latent/en.md index 948891380..1137eac88 100644 --- a/comfyui_embedded_docs/docs/EmptyHunyuanVideo15Latent/en.md +++ b/comfyui_embedded_docs/docs/EmptyHunyuanVideo15Latent/en.md @@ -11,7 +11,7 @@ This node creates an empty latent tensor specifically formatted for use with the | `length` | The number of frames in the video sequence. | INT | Yes | - | | `batch_size` | The number of video samples to generate in a batch (default: 1). | INT | No | - | -**Note:** The spatial dimensions of the generated latent tensor are calculated by dividing the input `width` and `height` by 16. The temporal dimension (frames) is calculated as `((length - 1) // 4) + 1`. +**Note:** The spatial dimensions of the generated latent tensor are calculated by dividing the input `width` and `height` by 16. The temporal dimension (frames) is calculated as `((length - 1) // 4) + 1`. These calculations use integer division, so `width` and `height` should be multiples of 16 to avoid truncation. ## Outputs @@ -22,4 +22,4 @@ This node creates an empty latent tensor specifically formatted for use with the > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/EmptyHunyuanVideo15Latent/en.md) --- -**Source fingerprint (SHA-256):** `6f53c99967149dd7c92e4d20a4ee80bd23d856ebab0a14a8201c55db847a525e` +**Source fingerprint (SHA-256):** `ce7ec75e8433c778d175a3e2ea260a4397aa5507428908b9a32f50fbe9e184c6` diff --git a/comfyui_embedded_docs/docs/EmptyLTXVLatentVideo/en.md b/comfyui_embedded_docs/docs/EmptyLTXVLatentVideo/en.md index 0dc74992b..f720f673e 100644 --- a/comfyui_embedded_docs/docs/EmptyLTXVLatentVideo/en.md +++ b/comfyui_embedded_docs/docs/EmptyLTXVLatentVideo/en.md @@ -1,6 +1,6 @@ # EmptyLTXVLatentVideo -The EmptyLTXVLatentVideo node creates an empty latent tensor for video processing. It generates a blank starting point with specified dimensions that can be used as input for video generation workflows. The node produces a zero-filled latent representation with the configured width, height, length, and batch size. +The EmptyLTXVLatentVideo node creates an empty latent tensor for video processing. It generates a blank starting point with the specified width, height, length, and batch size, which can be used as an input for video generation workflows. The node produces a zero-filled latent representation whose spatial dimensions are 32 times smaller than the configured width and height, and whose frame count is compressed by a factor of 8. ## Inputs @@ -9,15 +9,17 @@ The EmptyLTXVLatentVideo node creates an empty latent tensor for video processin | `width` | The width of the latent video tensor (default: 768, step: 32) | INT | Yes | 64 to MAX_RESOLUTION | | `height` | The height of the latent video tensor (default: 512, step: 32) | INT | Yes | 64 to MAX_RESOLUTION | | `length` | The number of frames in the latent video (default: 97, step: 8) | INT | Yes | 1 to MAX_RESOLUTION | -| `batch_size` | The number of latent videos to generate in a batch (default: 1) | INT | No | 1 to 4096 | +| `batch_size` | The number of latent videos to generate in a batch (default: 1) | INT | Yes | 1 to 4096 | + +Note: The latent video is compressed compared to the input dimensions: the spatial dimensions (width and height) are divided by 32, and the frame count (length) is divided by 8 and rounded up to the nearest whole number. The step values for width, height, and length help keep these divisions even. ## Outputs | Output Name | Description | Data Type | | --- | --- | --- | -| `samples` | The generated empty latent tensor with zero values in the specified dimensions | LATENT | +| `samples` | The generated empty latent tensor with zero values in the specified dimensions, along with a spatial downscale ratio of 32 | LATENT | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/EmptyLTXVLatentVideo/en.md) --- -**Source fingerprint (SHA-256):** `177fa1014ba65feab06a6f7bafc72e1cc536d3dc01f5bebddceb9f15f8df99fd` +**Source fingerprint (SHA-256):** `0b1e57baf9730d852b03b6bccbb8a033e2be9b9cd2420a0aa3638c31f6d3cd26` diff --git a/comfyui_embedded_docs/docs/EmptyLatentAudio/en.md b/comfyui_embedded_docs/docs/EmptyLatentAudio/en.md index 13ce9c8e4..8f759c8f7 100644 --- a/comfyui_embedded_docs/docs/EmptyLatentAudio/en.md +++ b/comfyui_embedded_docs/docs/EmptyLatentAudio/en.md @@ -1,6 +1,6 @@ # Empty Latent Audio -The EmptyLatentAudio node creates an empty latent tensor for audio processing. It generates a blank audio latent representation with a specified duration and batch size, which can be used as a starting point for audio generation or processing workflows. The node automatically calculates the appropriate latent dimensions based on the audio duration and sample rate. +Empty Latent Audio creates an empty latent tensor for audio processing. It generates a blank audio latent representation with a specified duration and batch size, which can be used as a starting point for audio generation or processing workflows. The node automatically calculates the appropriate latent dimensions based on the audio duration and sample rate. ## Inputs @@ -18,4 +18,4 @@ The EmptyLatentAudio node creates an empty latent tensor for audio processing. I > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/EmptyLatentAudio/en.md) --- -**Source fingerprint (SHA-256):** `02d7623358a6cc8200e74ab36f6a83bcfa059abd6ef91e3fd1c3732706926033` +**Source fingerprint (SHA-256):** `6ca63d26febe2d87ff751a57044eb81b553b19756f4b3f9478ecb5a733ec0041` diff --git a/comfyui_embedded_docs/docs/EmptyLatentHunyuan3Dv2/en.md b/comfyui_embedded_docs/docs/EmptyLatentHunyuan3Dv2/en.md index e828fdf0b..ebc454e3f 100644 --- a/comfyui_embedded_docs/docs/EmptyLatentHunyuan3Dv2/en.md +++ b/comfyui_embedded_docs/docs/EmptyLatentHunyuan3Dv2/en.md @@ -13,9 +13,9 @@ The EmptyLatentHunyuan3Dv2 node creates blank latent tensors specifically format | Output Name | Description | Data Type | | --- | --- | --- | -| `LATENT` | Returns a latent tensor containing empty samples formatted for Hunyuan3Dv2 3D generation | LATENT | +| `LATENT` | Returns a latent tensor containing empty samples tagged with the type "hunyuan3dv2", formatted for Hunyuan3Dv2 3D generation | LATENT | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/EmptyLatentHunyuan3Dv2/en.md) --- -**Source fingerprint (SHA-256):** `39fa531f819e3fe5e835b79d4140956c30d26cf9627d639359df65a5d3c01c2b` +**Source fingerprint (SHA-256):** `e9061301341ab84290cd2b16d5307636310a0772562cf485e3444876e4786ddd` diff --git a/comfyui_embedded_docs/docs/EmptyMiniMaxMusic3LatentAudio/en.md b/comfyui_embedded_docs/docs/EmptyMiniMaxMusic3LatentAudio/en.md index ddc4ad909..f339ca2e7 100644 --- a/comfyui_embedded_docs/docs/EmptyMiniMaxMusic3LatentAudio/en.md +++ b/comfyui_embedded_docs/docs/EmptyMiniMaxMusic3LatentAudio/en.md @@ -1,12 +1,12 @@ # EmptyMiniMaxMusic3LatentAudio -This node creates an empty (zero-filled) latent audio tensor for the MiniMax Music3 model. It converts the requested duration in seconds into the corresponding audio frames and produces a blank latent of the correct size, ready to be used as the starting point for music generation. +This node creates an empty (zero-filled) audio latent for the MiniMax Music3 model. It converts the requested duration in seconds into the corresponding audio frames and produces a blank latent tensor of the correct size, ready to be used as the starting point for music generation. ## Inputs | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `seconds` | The duration of the audio latent in seconds (default: 120.0). The value is converted to audio frames and clamped to the model's supported duration limits. | FLOAT | Yes | 0.04 to model maximum (MAX_AUDIO_FRAMES / AUDIO_FRAMES_PER_SECOND), step 0.04 | +| `seconds` | The duration of the audio latent in seconds (default: 120.0). The value is converted to audio frames and clamped to the model's supported duration limits. | FLOAT | Yes | 0.04 to (MAX_AUDIO_FRAMES / AUDIO_FRAMES_PER_SECOND), step 0.04 | | `batch_size` | The number of audio latents to generate in one batch (default: 1). | INT | Yes | 1 to 4096 | Note: The `seconds` value is rounded to the nearest audio frame and clamped to a minimum of 1 frame and a maximum of `MAX_AUDIO_FRAMES` frames, so the actual latent length may differ slightly from the exact value entered. diff --git a/comfyui_embedded_docs/docs/EmptyMochiLatentVideo/en.md b/comfyui_embedded_docs/docs/EmptyMochiLatentVideo/en.md index 1dfc0581f..d5a07c195 100644 --- a/comfyui_embedded_docs/docs/EmptyMochiLatentVideo/en.md +++ b/comfyui_embedded_docs/docs/EmptyMochiLatentVideo/en.md @@ -1,6 +1,6 @@ # EmptyMochiLatentVideo -The EmptyMochiLatentVideo node creates an empty latent video tensor with specified dimensions. It generates a zero-filled latent representation that can be used as a starting point for video generation workflows. The node allows you to define the width, height, length, and batch size for the latent video tensor. +EmptyMochiLatentVideo creates an empty latent video tensor with the dimensions you specify. It generates a zero-filled latent representation that can be used as a starting point for video generation workflows. The node lets you define the width, height, length, and batch size of the latent video tensor. ## Inputs @@ -11,7 +11,7 @@ The EmptyMochiLatentVideo node creates an empty latent video tensor with specifi | `length` | The number of frames in the latent video (default: 25, must satisfy that `(length - 1)` is divisible by 6) | INT | Yes | 7 to MAX_RESOLUTION | | `batch_size` | The number of latent videos to generate in a batch (default: 1) | INT | No | 1 to 4096 | -**Note:** The actual latent dimensions are calculated as width/8 and height/8, and the temporal dimension is calculated as `((length - 1) // 6) + 1`. The `length` parameter must satisfy that `(length - 1)` is divisible by 6, meaning valid values are 7, 13, 19, 25, etc. +**Note:** The actual latent dimensions are calculated as width/8 and height/8, the temporal dimension is calculated as `((length - 1) // 6) + 1`, and the tensor has 12 channels. The `length` parameter must satisfy that `(length - 1)` is divisible by 6, meaning valid values are 7, 13, 19, 25, etc. ## Outputs @@ -22,4 +22,4 @@ The EmptyMochiLatentVideo node creates an empty latent video tensor with specifi > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/EmptyMochiLatentVideo/en.md) --- -**Source fingerprint (SHA-256):** `1e5f70821965a9c8607920554f50ae3b6a0b38643074f669e5b81d81c3e26302` +**Source fingerprint (SHA-256):** `1774e1b54b429a946172ba9f609b433d99c0ca2ced2d9e0e3b0b85c82e5141b2` diff --git a/comfyui_embedded_docs/docs/EmptyQwenImageLayeredLatentImage/en.md b/comfyui_embedded_docs/docs/EmptyQwenImageLayeredLatentImage/en.md index 2ddf112a4..6f85563c8 100644 --- a/comfyui_embedded_docs/docs/EmptyQwenImageLayeredLatentImage/en.md +++ b/comfyui_embedded_docs/docs/EmptyQwenImageLayeredLatentImage/en.md @@ -1,15 +1,15 @@ # Empty Qwen Image Layered Latent -The Empty Qwen Image Layered Latent node prepares the blank canvas that the Qwen-Image-Layered model paints onto. Think of it as a stack of clean tracing sheets clipped together in order: the model fills the first sheet with the complete picture, and each sheet after it with one part of that picture. This node decides how big the sheets are and how many of them there are. It does not draw anything itself. +Empty Qwen Image Layered Latent prepares the blank canvas that the Qwen-Image-Layered model paints onto. Think of it as a stack of clean tracing sheets clipped together in order: the model fills the first sheet with the complete picture, and each sheet after it with one part of that picture. This node decides how big the sheets are and how many of them there are. It does not draw anything itself. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `width` | The width of the latent image to create. The value must be divisible by 16. (default: 640) | INT | Yes | 16 to MAX_RESOLUTION | -| `height` | The height of the latent image to create. The value must be divisible by 16. (default: 640) | INT | Yes | 16 to MAX_RESOLUTION | -| `layers` | How many layers to separate the picture into. One extra sheet is always reserved for the complete picture, so you get `layers + 1` images back, not `layers`. Set it to 2 and you get the complete picture plus 2 layers. Set it to 0 and you get the complete picture on its own. (default: 3) | INT | Yes | 0 to MAX_RESOLUTION | -| `batch_size` | The number of latent samples to generate in a batch. (default: 1) | INT | No | 1 to 4096 | +| `width` | The width of the latent image to create. The value must be divisible by 16. (default: 640) | INT | Yes | 16 to MAX_RESOLUTION (step 16) | +| `height` | The height of the latent image to create. The value must be divisible by 16. (default: 640) | INT | Yes | 16 to MAX_RESOLUTION (step 16) | +| `layers` | How many layers to separate the picture into. One extra sheet is always reserved for the complete picture, so you get `layers + 1` images back, not `layers`. Set it to 2 and you get the complete picture plus 2 layers. Set it to 0 and you get the complete picture on its own. (default: 3) | INT | Yes | 0 to MAX_RESOLUTION (step 1) | +| `batch_size` | The number of latent samples to generate in a batch. (default: 1) | INT | Yes | 1 to 4096 | **Note:** The `width` and `height` parameters are internally divided by 8 to determine the spatial dimensions of the output latent tensor. @@ -37,4 +37,4 @@ Start with the default of 3 layers. Asking for more means a longer generation an > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/EmptyQwenImageLayeredLatentImage/en.md) --- -**Source fingerprint (SHA-256):** `fe97966663c534dd347aa49a908a8026f2c34716631f1d17be97d74eacc3574e` +**Source fingerprint (SHA-256):** `5ccac979fcbcefb65f28867a89401c095cb330e09c13270008c32feeeafb1287` diff --git a/comfyui_embedded_docs/docs/EmptySD3LatentImage/en.md b/comfyui_embedded_docs/docs/EmptySD3LatentImage/en.md index 8b6a8919c..ec80bbb44 100644 --- a/comfyui_embedded_docs/docs/EmptySD3LatentImage/en.md +++ b/comfyui_embedded_docs/docs/EmptySD3LatentImage/en.md @@ -1,6 +1,6 @@ # EmptySD3LatentImage -The EmptySD3LatentImage node creates a blank latent image tensor specifically formatted for Stable Diffusion 3 models. It generates a tensor filled with zeros that has the correct dimensions and structure expected by SD3 pipelines. This is commonly used as a starting point for image generation workflows. +EmptySD3LatentImage creates a blank latent image tensor specifically formatted for Stable Diffusion 3 models. It generates a tensor filled with zeros that has the correct dimensions and structure expected by SD3 pipelines. This is commonly used as a starting point for image generation workflows. ## Inputs @@ -19,4 +19,4 @@ The EmptySD3LatentImage node creates a blank latent image tensor specifically fo > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/EmptySD3LatentImage/en.md) --- -**Source fingerprint (SHA-256):** `7a4b2454807bc905f26b96c0ff98706fa3e248bbf2b3995d5d38ebc3c5663fd6` +**Source fingerprint (SHA-256):** `694ede56f43e3f3889b4d23e636fa6b33b490bcbd214584557f0dc883fa0a32d` diff --git a/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/ar.md b/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/ar.md new file mode 100644 index 000000000..4f74a8132 --- /dev/null +++ b/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/ar.md @@ -0,0 +1,20 @@ +# EmptyTrellis2LatentStructure + +ينشئ هذا العقد بنية كامنة فارغة لنموذج Trellis2، حيث يتم ضبط جميع القيم على الصفر. ينتج موترًا كامنًا ثلاثي الأبعاد فارغًا بعدد 32 قناة بدقة 16×16×16، بحجم يتوافق مع العدد المحدد للعناصر في الدفعة. + +## المدخلات + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|-----------|-------------|-----------|----------|-------| +| `batch_size` | عدد الصور الكامنة في الدفعة (الافتراضي: 1). | INT | نعم | 1 إلى 4096 | + +## المخرجات + +| اسم المخرج | الوصف | نوع البيانات | +|-------------|-------------|-----------| +| `LATENT` | بنية كامنة فارغة لنموذج Trellis2. العينات هي موتر مملوء بالأصفار بالشكل (batch_size, 32, 16, 16, 16)، ونوع الكامن مضبوط على "trellis2". | LATENT | + +> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/ar.md) + +--- +**Source fingerprint (SHA-256):** `a551f0e05e58b025df03a3babee36f57fd900b5e02926fbdbd67a512ebead078` diff --git a/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/en.md b/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/en.md new file mode 100644 index 000000000..5a8c690cd --- /dev/null +++ b/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/en.md @@ -0,0 +1,20 @@ +# EmptyTrellis2LatentStructure + +This node creates an empty latent structure for the Trellis2 model, where all values are set to zero. It produces a blank 3D latent tensor with 32 channels at a resolution of 16×16×16, sized for the specified number of items in the batch. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `batch_size` | The number of latent images in the batch (default: 1). | INT | Yes | 1 to 4096 | + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `LATENT` | An empty Trellis2 latent structure. The samples are a zero-filled tensor with the shape (batch_size, 32, 16, 16, 16), and the latent type is set to "trellis2". | LATENT | + +> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/en.md) + +--- +**Source fingerprint (SHA-256):** `a551f0e05e58b025df03a3babee36f57fd900b5e02926fbdbd67a512ebead078` diff --git a/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/es.md b/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/es.md new file mode 100644 index 000000000..f402852cf --- /dev/null +++ b/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/es.md @@ -0,0 +1,20 @@ +# EmptyTrellis2LatentStructure + +Este nodo crea una estructura latente vacía para el modelo Trellis2, donde todos los valores se establecen en cero. Produce un tensor latente tridimensional vacío con 32 canales a una resolución de 16×16×16, dimensionado para el número especificado de elementos en el lote. + +## Entradas + +| Parámetro | Descripción | Tipo de datos | Requerido | Rango | +|-----------|-------------|---------------|-----------|-------| +| `batch_size` | El número de imágenes latentes en el lote (predeterminado: 1). | INT | Sí | 1 a 4096 | + +## Salidas + +| Nombre de salida | Descripción | Tipo de datos | +|------------------|-------------|---------------| +| `LATENT` | Una estructura latente vacía de Trellis2. Las muestras son un tensor relleno de ceros con la forma (batch_size, 32, 16, 16, 16), y el tipo de latente se establece en «trellis2». | LATENT | + +> Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/es.md) + +--- +**Source fingerprint (SHA-256):** `a551f0e05e58b025df03a3babee36f57fd900b5e02926fbdbd67a512ebead078` diff --git a/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/fa.md b/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/fa.md new file mode 100644 index 000000000..96a96bb1b --- /dev/null +++ b/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/fa.md @@ -0,0 +1,20 @@ +# EmptyTrellis2LatentStructure + +این گره یک ساختار لاتنت خالی برای مدل Trellis2 ایجاد می‌کند که در آن تمام مقادیر صفر هستند. این گره یک تنسور لاتنت سه‌بعدی خالی با 32 کانال در وضوح 16×16×16 تولید می‌کند که اندازه آن برای تعداد مشخص‌شده آیتم‌ها در دسته تنظیم شده است. + +## ورودی‌ها + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `batch_size` | تعداد تصاویر لاتنت در دسته (پیش‌فرض: 1). | INT | بله | 1 تا 4096 | + +## خروجی‌ها + +| نام خروجی | توضیحات | نوع داده | +|-------------|-------------|-----------| +| `LATENT` | یک ساختار لاتنت خالی از نوع Trellis2. نمونه‌ها یک تنسور پر از صفر با شکل (batch_size, 32, 16, 16, 16) هستند و نوع لاتنت به "trellis2" تنظیم شده است. | LATENT | + +> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/fa.md) + +--- +**Source fingerprint (SHA-256):** `a551f0e05e58b025df03a3babee36f57fd900b5e02926fbdbd67a512ebead078` diff --git a/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/fr.md b/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/fr.md new file mode 100644 index 000000000..a4b779a8f --- /dev/null +++ b/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/fr.md @@ -0,0 +1,20 @@ +# EmptyTrellis2LatentStructure + +Ce nœud crée une structure latente vide pour le modèle Trellis2, où toutes les valeurs sont définies sur zéro. Il produit un tenseur latent 3D vierge avec 32 canaux à une résolution de 16×16×16, dimensionné pour le nombre d’éléments spécifié dans le lot. + +## Entrées + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `batch_size` | Le nombre d’images latentes dans le lot (défaut : 1). | INT | Oui | 1 à 4096 | + +## Sorties + +| Nom de sortie | Description | Type de données | +|---------------|-------------|-----------------| +| `LATENT` | Une structure latente Trellis2 vide. Les échantillons sont un tenseur rempli de zéros avec la forme (batch_size, 32, 16, 16, 16), et le type de latent est défini sur « trellis2 ». | LATENT | + +> Cette documentation a été générée par IA. Si vous trouvez des erreurs ou avez des suggestions d'amélioration, n'hésitez pas à contribuer ! [Modifier sur GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/fr.md) + +--- +**Source fingerprint (SHA-256):** `a551f0e05e58b025df03a3babee36f57fd900b5e02926fbdbd67a512ebead078` diff --git a/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/ja.md b/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/ja.md new file mode 100644 index 000000000..2d85df1f6 --- /dev/null +++ b/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/ja.md @@ -0,0 +1,20 @@ +# EmptyTrellis2LatentStructure + +このノードは、Trellis2モデル用の空の潜在構造を作成します。すべての値はゼロに設定されます。指定されたバッチ内のアイテム数に合わせた、32チャネル、解像度16×16×16の空白の3D潜在テンソルを生成します。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `batch_size` | バッチ内の潜在画像の数(デフォルト: 1)。 | INT | はい | 1 から 4096 | + +## 出力 + +| 出力名 | 説明 | データ型 | +|-------------|-------------|-----------| +| `LATENT` | 空のTrellis2潜在構造。サンプルは形状 (batch_size, 32, 16, 16, 16) のゼロで埋められたテンソルで、潜在タイプは "trellis2" に設定されています。 | LATENT | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/ja.md) + +--- +**Source fingerprint (SHA-256):** `a551f0e05e58b025df03a3babee36f57fd900b5e02926fbdbd67a512ebead078` diff --git a/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/ko.md b/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/ko.md new file mode 100644 index 000000000..3019bb7b4 --- /dev/null +++ b/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/ko.md @@ -0,0 +1,20 @@ +# EmptyTrellis2LatentStructure + +이 노드는 Trellis2 모델을 위한 빈 latent 구조를 생성하며, 모든 값은 0으로 설정됩니다. 배치에서 지정된 항목 수에 맞는 크기로 32개 채널과 16×16×16 해상도를 가진 빈 3D latent 텐서를 생성합니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 유형 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `batch_size` | 배치에서 latent 이미지의 수입니다 (기본값: 1). | INT | 예 | 1 to 4096 | + +## 출력 + +| 출력 이름 | 설명 | 데이터 유형 | +|-------------|-------------|-----------| +| `LATENT` | 빈 Trellis2 latent 구조입니다. samples는 (batch_size, 32, 16, 16, 16) 형태의 0으로 채워진 텐서이며, latent 유형은 "trellis2"로 설정됩니다. | LATENT | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/ko.md) + +--- +**Source fingerprint (SHA-256):** `a551f0e05e58b025df03a3babee36f57fd900b5e02926fbdbd67a512ebead078` diff --git a/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/pt-BR.md b/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/pt-BR.md new file mode 100644 index 000000000..8ea8bad39 --- /dev/null +++ b/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/pt-BR.md @@ -0,0 +1,20 @@ +# EmptyTrellis2LatentStructure + +Este nó cria uma estrutura latente vazia para o modelo Trellis2, onde todos os valores são definidos como zero. Ele produz um tensor latente 3D em branco com 32 canais em uma resolução de 16×16×16, dimensionado para o número especificado de itens no lote. + +## Entradas + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Faixa | +|-----------|-------------|-----------|----------|-------| +| `batch_size` | O número de imagens latentes no lote (padrão: 1). | INT | Sim | 1 a 4096 | + +## Saídas + +| Nome da Saída | Descrição | Tipo de Dados | +|-------------|-------------|-----------| +| `LATENT` | Uma estrutura latente Trellis2 vazia. As amostras são um tensor preenchido com zeros com a forma (batch_size, 32, 16, 16, 16), e o tipo latente é definido como "trellis2". | LATENT | + +> Esta documentação foi gerada por IA. Se você encontrar erros ou tiver sugestões de melhoria, sinta-se à vontade para contribuir! [Editar no GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/pt-BR.md) + +--- +**Source fingerprint (SHA-256):** `a551f0e05e58b025df03a3babee36f57fd900b5e02926fbdbd67a512ebead078` diff --git a/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/ru.md b/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/ru.md new file mode 100644 index 000000000..12fdb3b1d --- /dev/null +++ b/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/ru.md @@ -0,0 +1,20 @@ +# EmptyTrellis2LatentStructure + +Этот узел создаёт пустую структуру скрытого пространства (latent) для модели Trellis2, в которой все значения равны нулю. Он формирует пустой трёхмерный тензор скрытого пространства с 32 каналами и разрешением 16×16×16, размер которого соответствует указанному количеству элементов в пакете. + +## Входные параметры + +| Параметр | Описание | Тип данных | Обязательный | Диапазон | +|----------|----------|------------|--------------|----------| +| `batch_size` | Количество скрытых изображений в пакете (по умолчанию: 1). | INT | Да | 1 to 4096 | + +## Выходные данные + +| Имя выходного параметра | Описание | Тип данных | +|-------------------------|----------|------------| +| `LATENT` | Пустая структура скрытого пространства Trellis2. Образцы представляют собой тензор, заполненный нулями, с формой (batch_size, 32, 16, 16, 16), а тип скрытого пространства установлен в «trellis2». | LATENT | + +> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/ru.md) + +--- +**Source fingerprint (SHA-256):** `a551f0e05e58b025df03a3babee36f57fd900b5e02926fbdbd67a512ebead078` diff --git a/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/tr.md b/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/tr.md new file mode 100644 index 000000000..7c9710b57 --- /dev/null +++ b/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/tr.md @@ -0,0 +1,20 @@ +# EmptyTrellis2LatentStructure + +Bu düğüm, Trellis2 modeli için tüm değerleri sıfıra ayarlanmış boş bir latent yapı oluşturur. Belirtilen batch boyutuna göre, 32 kanallı ve 16×16×16 çözünürlüğünde boş bir 3B latent tensör üretir. + +## Girdiler + +| Parametre | Açıklama | Veri Türü | Zorunlu | Aralık | +|-----------|-------------|-----------|----------|-------| +| `batch_size` | Batch içindeki latent görüntü sayısı (varsayılan: 1). | INT | Evet | 1 to 4096 | + +## Çıktılar + +| Çıktı Adı | Açıklama | Veri Türü | +|-------------|-------------|-----------| +| `LATENT` | Boş bir Trellis2 latent yapısı. Örnekler, (batch_size, 32, 16, 16, 16) şeklinde sıfırlarla doldurulmuş bir tensördür ve latent türü "trellis2" olarak ayarlanmıştır. | LATENT | + +> Bu belge yapay zeka tarafından oluşturulmuştur. Herhangi bir hata bulursanız veya iyileştirme önerileriniz varsa, katkıda bulunmaktan çekinmeyin! [GitHub'da Düzenle](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/tr.md) + +--- +**Source fingerprint (SHA-256):** `a551f0e05e58b025df03a3babee36f57fd900b5e02926fbdbd67a512ebead078` diff --git a/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/zh-TW.md b/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/zh-TW.md new file mode 100644 index 000000000..c6879d3f6 --- /dev/null +++ b/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/zh-TW.md @@ -0,0 +1,20 @@ +# EmptyTrellis2LatentStructure + +此節點為 Trellis2 模型建立一個空的潛在結構,其中所有值皆設為零。它會產生一個具有 32 個通道、解析度為 16×16×16 的空白 3D 潛在張量,其大小適用於批次中指定的項目數量。 + +## 輸入 + +| 參數 | 描述 | 資料類型 | 必填 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `batch_size` | 批次中的潛在影像數量(預設值:1)。 | INT | 是 | 1 到 4096 | + +## 輸出 + +| 輸出名稱 | 描述 | 資料類型 | +|-------------|-------------|-----------| +| `LATENT` | 空的 Trellis2 潛在結構。樣本是一個以零填充的張量,形狀為 (batch_size, 32, 16, 16, 16),潛在類型設定為 "trellis2"。 | LATENT | + +> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/zh-TW.md) + +--- +**Source fingerprint (SHA-256):** `a551f0e05e58b025df03a3babee36f57fd900b5e02926fbdbd67a512ebead078` diff --git a/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/zh.md b/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/zh.md new file mode 100644 index 000000000..e0f774a6d --- /dev/null +++ b/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/zh.md @@ -0,0 +1,20 @@ +# EmptyTrellis2LatentStructure + +此节点为 Trellis2 模型创建一个空的潜空间结构,其中所有值均设为零。它生成一个具有 32 个通道、分辨率为 16×16×16 的空白 3D 潜空间张量,其大小根据批次中指定的项目数量而定。 + +## 输入 + +| 参数 | 描述 | 数据类型 | 是否必填 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `batch_size` | 批次中潜空间图像的数量(默认:1)。 | INT | 是 | 1 to 4096 | + +## 输出 + +| 输出名称 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `LATENT` | 一个空的 Trellis2 潜空间结构。samples 是一个零填充张量,形状为 (batch_size, 32, 16, 16, 16),潜空间类型设置为 "trellis2"。 | LATENT | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/EmptyTrellis2LatentStructure/zh.md) + +--- +**Source fingerprint (SHA-256):** `a551f0e05e58b025df03a3babee36f57fd900b5e02926fbdbd67a512ebead078` diff --git a/comfyui_embedded_docs/docs/Epsilon Scaling/en.md b/comfyui_embedded_docs/docs/Epsilon Scaling/en.md index 3bdba8551..58c488ef7 100644 --- a/comfyui_embedded_docs/docs/Epsilon Scaling/en.md +++ b/comfyui_embedded_docs/docs/Epsilon Scaling/en.md @@ -7,7 +7,9 @@ This node implements the Epsilon Scaling method from the research paper "Elucida | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | | `model` | The model to which the epsilon scaling patch will be applied. | MODEL | Yes | - | -| `scaling_factor` | The factor by which the predicted noise is scaled. A value greater than 1.0 reduces the noise, while a value less than 1.0 increases it (default: 1.005). | FLOAT | No | 0.5 - 1.5 | +| `scaling_factor` | The factor by which the predicted noise is scaled. A value greater than 1.0 reduces the noise, while a value less than 1.0 increases it (default: 1.005). This is an advanced parameter. | FLOAT | No | 0.5 - 1.5 (step: 0.001) | + +Note: If `scaling_factor` is set to 0, the node automatically replaces it with a very small value (1e-9) to prevent division by zero. The UI's minimum value of 0.5 normally prevents this from happening. ## Outputs @@ -18,4 +20,4 @@ This node implements the Epsilon Scaling method from the research paper "Elucida > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Epsilon Scaling/en.md) --- -**Source fingerprint (SHA-256):** `245d230ec2db7298493d4fbe58c3d96c15821985da3dc12aaccf64e2bf7922a1` +**Source fingerprint (SHA-256):** `8d258c7bb853940922402f1009d777bfc71e88704fd2f615f569c214ddbeac64` diff --git a/comfyui_embedded_docs/docs/ExtendIntermediateSigmas/en.md b/comfyui_embedded_docs/docs/ExtendIntermediateSigmas/en.md index 2315299c3..59fd0cef3 100644 --- a/comfyui_embedded_docs/docs/ExtendIntermediateSigmas/en.md +++ b/comfyui_embedded_docs/docs/ExtendIntermediateSigmas/en.md @@ -7,12 +7,12 @@ The ExtendIntermediateSigmas node takes an existing sequence of sigma values and | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | | `sigmas` | The input sigma sequence to extend with intermediate values | SIGMAS | Yes | - | -| `steps` | Number of intermediate steps to insert between existing sigmas (default: 2) | INT | Yes | 1 to 100 | +| `steps` | Controls the number of intermediate sigma values inserted between each pair of existing sigmas. The interval between two sigmas is divided into `steps` parts, producing `steps - 1` new values per pair (default: 2, which inserts one value per pair) | INT | Yes | 1 to 100 | | `start_at_sigma` | Upper sigma boundary for extension - only extend sigmas below this value (default: -1.0, which means infinity) | FLOAT | Yes | -1.0 to 20000.0 | | `end_at_sigma` | Lower sigma boundary for extension - only extend sigmas above this value (default: 12.0) | FLOAT | Yes | 0.0 to 20000.0 | | `spacing` | The interpolation method for spacing the intermediate sigma values (default: "linear") | COMBO | Yes | `"linear"`
`"cosine"`
`"sine"` | -**Note:** The node only inserts intermediate sigmas between existing sigma pairs where both the current sigma is less than or equal to `start_at_sigma` and greater than or equal to `end_at_sigma`. When `start_at_sigma` is set to -1.0, it's treated as infinity, meaning only the `end_at_sigma` lower boundary applies. +**Note:** The node only inserts intermediate sigmas between existing sigma pairs where the current sigma is less than or equal to `start_at_sigma` and greater than or equal to `end_at_sigma`. When `start_at_sigma` is set to -1.0, it is treated as infinity, meaning only the `end_at_sigma` lower boundary applies. ## Outputs @@ -23,4 +23,4 @@ The ExtendIntermediateSigmas node takes an existing sequence of sigma values and > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ExtendIntermediateSigmas/en.md) --- -**Source fingerprint (SHA-256):** `111cb74aad64d8d9b2bebd10406c0f4ce718367bde96102104d385d387cef8e5` +**Source fingerprint (SHA-256):** `d761e82ce055bc56a551d3e446117febb2cdbd6c0286ef620d0a078c96f047ba` diff --git a/comfyui_embedded_docs/docs/FillHoles/ar.md b/comfyui_embedded_docs/docs/FillHoles/ar.md new file mode 100644 index 000000000..d5af4fa89 --- /dev/null +++ b/comfyui_embedded_docs/docs/FillHoles/ar.md @@ -0,0 +1,26 @@ +# FillHoles + +يقوم هذا العقد بملء الثقوب في شبكة ثلاثية الأبعاد عن طريق اكتشاف الحواف الحدودية المفتوحة وإنشاء أوجه جديدة لإغلاقها. يعمل على وحدة معالجة الرسومات (GPU)، ويحافظ على الهندسة الحالية وخرائط UV، ويمكنه معالجة شبكة واحدة، أو قوائم من الشبكات، أو دفعات من الشبكات. + +## المدخلات + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|-----------|-------------|-----------|----------|-------| +| `mesh` | الشبكة ثلاثية الأبعاد المراد معالجتها. تقبل شبكة واحدة، أو قائمة من الشبكات، أو شبكة مجمعة. | MESH | نعم | - | +| `max_perimeter` | أقصى محيط ثقب يمكن ملؤه. القيمة 0 تعطيل. (الافتراضي: 0.03) | FLOAT | نعم | 0.0 to no upper limit | +| `weld_epsilon_rel` | تفاوت ما قبل اللحام (كسر من قطر الصندوق المحيط)؛ يحتاج اكتشاف الحدود إلى رؤوس ملحومة. القيمة 0 للتخطي. (الافتراضي: 1e-5) | FLOAT | نعم | 0.0 to no upper limit | +| `max_vertices` | الحد الأقصى لرؤوس الحدود في كل دورة؛ تعمل طريقة مروحة المركز فقط مع الثقوب الصغيرة شبه المستوية. أبقِ القيمة ≤16. (الافتراضي: 16) | INT | نعم | 3 to 1024 | +| `fill_chains` | املأ أيضًا السلاسل المفتوحة (وليس فقط الدورات). ينتج ضوضاء؛ إيقاف التشغيل يطابق سلوك cumesh. (الافتراضي: False) | BOOLEAN | نعم | True or False | + +ملاحظة: عندما تكون قيمة `weld_epsilon_rel` أكبر من 0، يقوم العقد بلحام الرؤوس المكررة مسبقًا قبل اكتشاف الثقوب. يبدأ تفاوت اللحام عند الكسر المعطى من قطر الصندوق المحيط ويزداد تلقائيًا بالمضاعفة حتى تُعتبر الشبكة ملحومة أو يصل التفاوت إلى الحد الأقصى 1e-2. الثقوب التي تحتوي على أكثر من 8 رؤوس حدودية تستخدم تعبئة مروحة المركز (إدخال رأس مركزي جديد)، بينما تستخدم الثقوب الأصغر تعبئة مروحة الرأس التي تعيد استخدام رأس حدودي موجود. + +## المخرجات + +| اسم المخرج | الوصف | نوع البيانات | +|-------------|-------------|-----------| +| `mesh` | الشبكة مع ملء الثقوب، بما يطابق تنسيق الدفعة المدخلة. | MESH | + +> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FillHoles/ar.md) + +--- +**Source fingerprint (SHA-256):** `c0fd7f0c2d6eea098efb1dcfd80eaa52997e185b9c442b483f75318eea082196` diff --git a/comfyui_embedded_docs/docs/FillHoles/en.md b/comfyui_embedded_docs/docs/FillHoles/en.md new file mode 100644 index 000000000..9f16724af --- /dev/null +++ b/comfyui_embedded_docs/docs/FillHoles/en.md @@ -0,0 +1,26 @@ +# FillHoles + +This node fills holes in a 3D mesh by detecting open boundary edges and creating new faces to close them. It runs on the GPU, preserves existing geometry and UVs, and can process single meshes, lists of meshes, or batches of meshes. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `mesh` | The 3D mesh to process. Accepts a single mesh, a list of meshes, or a batched mesh. | MESH | Yes | - | +| `max_perimeter` | Max hole perimeter to fill. 0 disables. (default: 0.03) | FLOAT | Yes | 0.0 to no upper limit | +| `weld_epsilon_rel` | Pre-weld tolerance (fraction of bounding box diagonal); boundary detection needs welded vertices. 0 skips. (default: 1e-5) | FLOAT | Yes | 0.0 to no upper limit | +| `max_vertices` | Cap boundary vertices per cycle; centroid-fan only works for small near-planar holes. Keep ≤16. (default: 16) | INT | Yes | 3 to 1024 | +| `fill_chains` | Also fill open chains (not just cycles). Noisy; OFF matches cumesh. (default: False) | BOOLEAN | Yes | True or False | + +Note: When `weld_epsilon_rel` is greater than 0, the node pre-welds duplicate vertices before detecting holes. The welding tolerance starts at the given fraction of the bounding box diagonal and automatically increases by doubling until the mesh is considered welded or the tolerance reaches a cap of 1e-2. Holes with more than 8 boundary vertices use a centroid-fan fill (inserting a new centroid vertex), while smaller holes use a vertex-fan fill that reuses an existing boundary vertex. + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `mesh` | The mesh with holes filled, matching the input batch format. | MESH | + +> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FillHoles/en.md) + +--- +**Source fingerprint (SHA-256):** `c0fd7f0c2d6eea098efb1dcfd80eaa52997e185b9c442b483f75318eea082196` diff --git a/comfyui_embedded_docs/docs/FillHoles/es.md b/comfyui_embedded_docs/docs/FillHoles/es.md new file mode 100644 index 000000000..c5bdc0c57 --- /dev/null +++ b/comfyui_embedded_docs/docs/FillHoles/es.md @@ -0,0 +1,26 @@ +# FillHoles + +Este nodo rellena agujeros en una malla 3D detectando bordes de contorno abiertos y creando nuevas caras para cerrarlos. Se ejecuta en la GPU, conserva la geometría y las UV existentes, y puede procesar mallas individuales, listas de mallas o lotes de mallas. + +## Entradas + +| Parámetro | Descripción | Tipo de dato | Requerido | Rango | +|-----------|-------------|--------------|-----------|-------| +| `mesh` | La malla 3D a procesar. Acepta una malla individual, una lista de mallas o una malla por lotes. | MESH | Sí | - | +| `max_perimeter` | Perímetro máximo de agujero a rellenar. 0 lo desactiva. (predeterminado: 0.03) | FLOAT | Sí | 0.0 to no upper limit | +| `weld_epsilon_rel` | Tolerancia de pre-soldadura (fracción de la diagonal de la caja delimitadora); la detección de contornos requiere vértices soldados. 0 la omite. (predeterminado: 1e-5) | FLOAT | Sí | 0.0 to no upper limit | +| `max_vertices` | Tope de vértices de contorno por ciclo; el abanico de centroide solo funciona para agujeros pequeños casi planos. Mantener ≤16. (predeterminado: 16) | INT | Sí | 3 to 1024 | +| `fill_chains` | También rellena cadenas abiertas (no solo ciclos). Genera ruido; OFF coincide con cumesh. (predeterminado: False) | BOOLEAN | Sí | True or False | + +Nota: Cuando `weld_epsilon_rel` es mayor que 0, el nodo pre-suelda los vértices duplicados antes de detectar agujeros. La tolerancia de soldadura comienza en la fracción indicada de la diagonal de la caja delimitadora y aumenta automáticamente duplicándose hasta que la malla se considere soldada o la tolerancia alcance un límite de 1e-2. Los agujeros con más de 8 vértices de contorno utilizan un relleno de abanico de centroide (insertando un nuevo vértice central), mientras que los agujeros más pequeños utilizan un relleno de abanico de vértice que reutiliza un vértice de contorno existente. + +## Salidas + +| Nombre de salida | Descripción | Tipo de dato | +|------------------|-------------|--------------| +| `mesh` | La malla con los agujeros rellenados, que coincide con el formato de lote de entrada. | MESH | + +> Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FillHoles/es.md) + +--- +**Source fingerprint (SHA-256):** `c0fd7f0c2d6eea098efb1dcfd80eaa52997e185b9c442b483f75318eea082196` diff --git a/comfyui_embedded_docs/docs/FillHoles/fa.md b/comfyui_embedded_docs/docs/FillHoles/fa.md new file mode 100644 index 000000000..063176bc8 --- /dev/null +++ b/comfyui_embedded_docs/docs/FillHoles/fa.md @@ -0,0 +1,26 @@ +# FillHoles + +این گره با شناسایی لبه‌های مرزی باز و ایجاد وجه‌های جدید برای بستن آن‌ها، سوراخ‌های یک مش سه‌بعدی را پر می‌کند. این گره روی GPU اجرا می‌شود، هندسه و UVهای موجود را حفظ می‌کند و می‌تواند مش‌های تکی، فهرست‌هایی از مش‌ها یا دسته‌هایی از مش‌ها را پردازش کند. + +## ورودی‌ها + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `mesh` | مش سه‌بعدی برای پردازش. یک مش تکی، فهرستی از مش‌ها یا یک مش دسته‌ای را می‌پذیرد. | MESH | بله | - | +| `max_perimeter` | حداکثر محیط سوراخ برای پر کردن. 0 به‌معنی غیرفعال بودن است. (پیش‌فرض: 0.03) | FLOAT | بله | 0.0 تا بدون حد بالایی | +| `weld_epsilon_rel` | تلورانس جوش پیش از پردازش (کسری از قطر جعبه محصور). تشخیص مرز به رئوس جوش‌خورده نیاز دارد. 0 رد می‌شود. (پیش‌فرض: 1e-5) | FLOAT | بله | 0.0 تا بدون حد بالایی | +| `max_vertices` | سقف رئوس مرزی در هر چرخه؛ پر کردن بادبزنی مرکز فقط برای سوراخ‌های کوچک نزدیک به صفحه کارایی دارد. ≤16 نگه دارید. (پیش‌فرض: 16) | INT | بله | 3 تا 1024 | +| `fill_chains` | همچنین زنجیره‌های باز (نه فقط چرخه‌ها) را پر می‌کند. نتایج نویزدار دارد. خاموش بودن معادل cumesh است. (پیش‌فرض: False) | BOOLEAN | بله | True or False | + +توجه: وقتی `weld_epsilon_rel` بزرگ‌تر از 0 باشد، گره قبل از تشخیص سوراخ‌ها، رئوس تکراری را پیش‌جوش می‌زند. تلورانس جوش از کسر معین قطر جعبه محصور شروع می‌شود و به‌طور خودکار با دو برابر شدن افزایش می‌یابد تا زمانی که مش جوش‌خورده در نظر گرفته شود یا تلورانس به سقف 1e-2 برسد. سوراخ‌هایی که بیش از 8 رأس مرزی دارند از پر کردن بادبزنی مرکز استفاده می‌کنند (درج یک رأس مرکز جدید)، در حالی که سوراخ‌های کوچکتر از پر کردن بادبزنی رأس استفاده می‌کنند که یک رأس مرزی موجود را دوباره استفاده می‌کند. + +## خروجی‌ها + +| نام خروجی | توضیحات | نوع داده | +|-------------|-------------|-----------| +| `mesh` | مش با سوراخ‌های پر شده، مطابق با قالب دسته‌ای ورودی. | MESH | + +> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FillHoles/fa.md) + +--- +**Source fingerprint (SHA-256):** `c0fd7f0c2d6eea098efb1dcfd80eaa52997e185b9c442b483f75318eea082196` diff --git a/comfyui_embedded_docs/docs/FillHoles/fr.md b/comfyui_embedded_docs/docs/FillHoles/fr.md new file mode 100644 index 000000000..b32882f51 --- /dev/null +++ b/comfyui_embedded_docs/docs/FillHoles/fr.md @@ -0,0 +1,26 @@ +# FillHoles + +Ce nœud comble les trous d'un maillage 3D en détectant les bords ouverts et en créant de nouvelles faces pour les fermer. Il s'exécute sur le GPU, préserve la géométrie et les UV existants, et peut traiter des maillages uniques, des listes de maillages ou des lots de maillages. + +## Entrées + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `mesh` | Le maillage 3D à traiter. Accepte un maillage unique, une liste de maillages ou un maillage par lot. | MESH | Oui | - | +| `max_perimeter` | Périmètre maximal de trou à combler. 0 désactive. (défaut : 0.03) | FLOAT | Oui | 0.0 à aucune limite supérieure | +| `weld_epsilon_rel` | Tolérance de pré-soudure (fraction de la diagonale de la boîte englobante) ; la détection des bords nécessite des sommets soudés. 0 ignore. (défaut : 1e-5) | FLOAT | Oui | 0.0 à aucune limite supérieure | +| `max_vertices` | Limite les sommets de bordure par cycle ; le remplissage en éventail centroïde ne fonctionne que pour les petits trous presque plans. Gardez ≤16. (défaut : 16) | INT | Oui | 3 à 1024 | +| `fill_chains` | Comble également les chaînes ouvertes (pas seulement les cycles). Bruité ; OFF correspond à cumesh. (défaut : False) | BOOLEAN | Oui | True ou False | + +Note : Lorsque `weld_epsilon_rel` est supérieur à 0, le nœud pré-soude les sommets en double avant de détecter les trous. La tolérance de soudure commence à la fraction donnée de la diagonale de la boîte englobante et augmente automatiquement en doublant jusqu'à ce que le maillage soit considéré comme soudé ou que la tolérance atteigne un plafond de 1e-2. Les trous de plus de 8 sommets de bordure utilisent un remplissage en éventail centroïde (insérant un nouveau sommet central), tandis que les trous plus petits utilisent un remplissage en éventail de sommets qui réutilise un sommet de bordure existant. + +## Sorties + +| Nom de sortie | Description | Type de données | +|---------------|-------------|-----------------| +| `mesh` | Le maillage avec les trous comblés, correspondant au format de lot d'entrée. | MESH | + +> Cette documentation a été générée par IA. Si vous trouvez des erreurs ou avez des suggestions d'amélioration, n'hésitez pas à contribuer ! [Modifier sur GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FillHoles/fr.md) + +--- +**Source fingerprint (SHA-256):** `c0fd7f0c2d6eea098efb1dcfd80eaa52997e185b9c442b483f75318eea082196` diff --git a/comfyui_embedded_docs/docs/FillHoles/ja.md b/comfyui_embedded_docs/docs/FillHoles/ja.md new file mode 100644 index 000000000..e4a1817a1 --- /dev/null +++ b/comfyui_embedded_docs/docs/FillHoles/ja.md @@ -0,0 +1,24 @@ +# FillHoles + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `mesh` | 処理する3Dメッシュ。単一メッシュ、メッシュのリスト、またはバッチ処理されたメッシュを受け入れます。 | MESH | はい | - | +| `max_perimeter` | 埋める穴の最大周長。0で無効化。(デフォルト: 0.03) | FLOAT | はい | 0.0 to no upper limit | +| `weld_epsilon_rel` | 事前溶接の許容値(バウンディングボックスの対角線に対する比率)。境界検出には溶接済み頂点が必要です。0でスキップ。(デフォルト: 1e-5) | FLOAT | はい | 0.0 to no upper limit | +| `max_vertices` | サイクルごとの境界頂点数の上限。セントロイドファンは小さくほぼ平面の穴にのみ機能します。16以下に保ってください。(デフォルト: 16) | INT | はい | 3 to 1024 | +| `fill_chains` | 開いたチェーンも埋めます(サイクルだけでなく)。ノイズが生じる場合があります。OFFはcumeshと一致します。(デフォルト: False) | BOOLEAN | はい | True or False | + +注:`weld_epsilon_rel` が0より大きい場合、ノードは穴を検出する前に重複した頂点を事前溶接します。溶接許容値は、バウンディングボックスの対角線の指定された比率から始まり、メッシュが溶接されたと見なされるか、許容値が1e-2の上限に達するまで、2倍に自動的に増加します。8を超える境界頂点を持つ穴はセントロイドファン充填(新しいセントロイド頂点を挿入)を使用し、より小さい穴は既存の境界頂点を再利用する頂点ファン充填を使用します。 + +## 出力 + +| 出力名 | 説明 | データ型 | +|-------------|-------------|-----------| +| `mesh` | 穴が埋められたメッシュ。入力されたバッチ形式に一致します。 | MESH | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FillHoles/ja.md) + +--- +**Source fingerprint (SHA-256):** `c0fd7f0c2d6eea098efb1dcfd80eaa52997e185b9c442b483f75318eea082196` diff --git a/comfyui_embedded_docs/docs/FillHoles/ko.md b/comfyui_embedded_docs/docs/FillHoles/ko.md new file mode 100644 index 000000000..fbdc1819f --- /dev/null +++ b/comfyui_embedded_docs/docs/FillHoles/ko.md @@ -0,0 +1,26 @@ +# FillHoles + +이 노드는 열린 경계 가장자리를 감지하고 이를 닫기 위한 새 면을 생성하여 3D 메시의 구멍을 채웁니다. GPU에서 실행되며 기존 지오메트리와 UV를 보존하고 단일 메시, 메시 목록 또는 배치 메시를 처리할 수 있습니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 유형 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `mesh` | 처리할 3D 메시입니다. 단일 메시, 메시 목록 또는 배치 메시를 허용합니다. | MESH | 예 | - | +| `max_perimeter` | 채울 최대 구멍 둘레입니다. 0이면 비활성화됩니다. (기본값: 0.03) | FLOAT | 예 | 0.0 to no upper limit | +| `weld_epsilon_rel` | 사전 용접 허용 오차(경계 상자 대각선의 비율)입니다. 경계 감지에는 용접된 정점이 필요합니다. 0이면 건너뜁니다. (기본값: 1e-5) | FLOAT | 예 | 0.0 to no upper limit | +| `max_vertices` | 주기당 경계 정점 상한입니다. 중심-팬 채우기는 작고 평면에 가까운 구멍에만 작동합니다. ≤16으로 유지하십시오. (기본값: 16) | INT | 예 | 3 to 1024 | +| `fill_chains` | 열린 체인도 채웁니다(주기뿐만 아니라). 노이즈가 많습니다. OFF는 cumesh와 일치합니다. (기본값: False) | BOOLEAN | 예 | True or False | + +참고: `weld_epsilon_rel`이 0보다 크면 노드는 구멍을 감지하기 전에 중복 정점을 사전 용접합니다. 용접 허용 오차는 경계 상자 대각선의 지정된 비율에서 시작하여 메시가 용접된 것으로 간주되거나 허용 오차가 1e-2 한도에 도달할 때까지 두 배로 자동 증가합니다. 경계 정점이 8개를 초과하는 구멍은 중심-팬 채우기(새 중심 정점 삽입)를 사용하고, 더 작은 구멍은 기존 경계 정점을 재사용하는 정점-팬 채우기를 사용합니다. + +## 출력 + +| 출력 이름 | 설명 | 데이터 유형 | +|-------------|-------------|-----------| +| `mesh` | 구멍이 채워진 메시로, 입력 배치 형식과 일치합니다. | MESH | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FillHoles/ko.md) + +--- +**Source fingerprint (SHA-256):** `c0fd7f0c2d6eea098efb1dcfd80eaa52997e185b9c442b483f75318eea082196` diff --git a/comfyui_embedded_docs/docs/FillHoles/pt-BR.md b/comfyui_embedded_docs/docs/FillHoles/pt-BR.md new file mode 100644 index 000000000..53317da01 --- /dev/null +++ b/comfyui_embedded_docs/docs/FillHoles/pt-BR.md @@ -0,0 +1,26 @@ +# FillHoles + +Este nó preenche buracos em uma malha 3D detectando bordas de limite abertas e criando novas faces para fechá-los. Ele executa na GPU, preserva a geometria e os UVs existentes e pode processar malhas individuais, listas de malhas ou lotes de malhas. + +## Entradas + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Faixa | +|-----------|-------------|-----------|----------|-------| +| `mesh` | A malha 3D a ser processada. Aceita uma malha individual, uma lista de malhas ou uma malha em lote. | MESH | Sim | - | +| `max_perimeter` | Perímetro máximo do buraco a preencher. 0 desativa. (padrão: 0.03) | FLOAT | Sim | 0.0 a sem limite superior | +| `weld_epsilon_rel` | Tolerância de pré-soldagem (fração da diagonal da caixa delimitadora); a detecção de bordas precisa de vértices soldados. 0 ignora. (padrão: 1e-5) | FLOAT | Sim | 0.0 a sem limite superior | +| `max_vertices` | Limite de vértices de borda por ciclo; o leque de centroide só funciona para buracos pequenos quase planares. Mantenha ≤16. (padrão: 16) | INT | Sim | 3 a 1024 | +| `fill_chains` | Também preenche cadeias abertas (não apenas ciclos). Ruidoso; DESLIGADO corresponde ao cumesh. (padrão: False) | BOOLEAN | Sim | True ou False | + +Nota: Quando `weld_epsilon_rel` é maior que 0, o nó pré-solda vértices duplicados antes de detectar buracos. A tolerância de soldagem começa na fração fornecida da diagonal da caixa delimitadora e aumenta automaticamente em dobro até que a malha seja considerada soldada ou a tolerância atinja um teto de 1e-2. Buracos com mais de 8 vértices de borda usam um preenchimento em leque de centroide (inserindo um novo vértice de centroide), enquanto buracos menores usam um preenchimento em leque de vértice que reutiliza um vértice de borda existente. + +## Saídas + +| Nome da Saída | Descrição | Tipo de Dados | +|-------------|-------------|-----------| +| `mesh` | A malha com buracos preenchidos, correspondendo ao formato de lote da entrada. | MESH | + +> Esta documentação foi gerada por IA. Se você encontrar erros ou tiver sugestões de melhoria, sinta-se à vontade para contribuir! [Editar no GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FillHoles/pt-BR.md) + +--- +**Source fingerprint (SHA-256):** `c0fd7f0c2d6eea098efb1dcfd80eaa52997e185b9c442b483f75318eea082196` diff --git a/comfyui_embedded_docs/docs/FillHoles/ru.md b/comfyui_embedded_docs/docs/FillHoles/ru.md new file mode 100644 index 000000000..013ed09d8 --- /dev/null +++ b/comfyui_embedded_docs/docs/FillHoles/ru.md @@ -0,0 +1,26 @@ +# FillHoles + +Этот узел заполняет отверстия в 3D-сетке, обнаруживая открытые граничные ребра и создавая новые грани для их закрытия. Он работает на GPU, сохраняет существующую геометрию и UV-развертку и может обрабатывать отдельные сетки, списки сеток или пакеты сеток. + +## Входы + +| Параметр | Описание | Тип данных | Обязательный | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `mesh` | 3D-сетка для обработки. Принимает отдельную сетку, список сеток или пакетную сетку. | MESH | Да | - | +| `max_perimeter` | Максимальный периметр отверстия для заполнения. 0 отключает. (по умолчанию: 0.03) | FLOAT | Да | 0.0 без верхнего предела | +| `weld_epsilon_rel` | Допуск предварительной сварки (доля диагонали ограничивающей рамки); для обнаружения границ нужны сваренные вершины. 0 пропускает. (по умолчанию: 1e-5) | FLOAT | Да | 0.0 без верхнего предела | +| `max_vertices` | Ограничение граничных вершин за цикл; веер от центроида работает только для небольших почти плоских отверстий. Оставляйте ≤16. (по умолчанию: 16) | INT | Да | 3 to 1024 | +| `fill_chains` | Также заполнять открытые цепочки (не только циклы). Шумно; OFF соответствует cumesh. (по умолчанию: False) | BOOLEAN | Да | True or False | + +Примечание: Когда `weld_epsilon_rel` больше 0, узел предварительно сваривает дублирующиеся вершины перед обнаружением отверстий. Допуск сварки начинается с указанной доли диагонали ограничивающей рамки и автоматически увеличивается удвоением, пока сетка не будет считаться сваренной или допуск не достигнет предела 1e-2. Отверстия с более чем 8 граничными вершинами заполняются веером от центроида (с вставкой новой центроидной вершины), а меньшие отверстия — веером от вершины, повторно использующим существующую граничную вершину. + +## Выходы + +| Имя выхода | Описание | Тип данных | +|-------------|-------------|-----------| +| `mesh` | Сетка с заполненными отверстиями, соответствующая формату входного пакета. | MESH | + +> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FillHoles/ru.md) + +--- +**Source fingerprint (SHA-256):** `c0fd7f0c2d6eea098efb1dcfd80eaa52997e185b9c442b483f75318eea082196` diff --git a/comfyui_embedded_docs/docs/FillHoles/tr.md b/comfyui_embedded_docs/docs/FillHoles/tr.md new file mode 100644 index 000000000..6f5b7cb81 --- /dev/null +++ b/comfyui_embedded_docs/docs/FillHoles/tr.md @@ -0,0 +1,26 @@ +# FillHoles + +Bu düğüm, açık sınır kenarlarını algılayarak ve bunları kapatmak için yeni yüzeyler oluşturarak 3B bir mesh'teki delikleri doldurur. GPU üzerinde çalışır, mevcut geometriyi ve UV'leri korur ve tek mesh'leri, mesh listelerini veya mesh batch'lerini işleyebilir. + +## Girdiler + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +|-----------|----------|-----------|---------|--------| +| `mesh` | İşlenecek 3B mesh. Tek bir mesh, mesh listesi veya batch mesh kabul eder. | MESH | Evet | - | +| `max_perimeter` | Doldurulacak maksimum delik çevresi. 0 devre dışı bırakır. (varsayılan: 0.03) | FLOAT | Evet | 0.0 to no upper limit | +| `weld_epsilon_rel` | Ön kaynak toleransı (sınırlayıcı kutu köşegeninin kesri); sınır algılama, kaynaklanmış köşeler gerektirir. 0 atlar. (varsayılan: 1e-5) | FLOAT | Evet | 0.0 to no upper limit | +| `max_vertices` | Döngü başına sınır köşe sayısını üst sınırlar; merkez-yelpaze (centroid-fan) yalnızca küçük, neredeyse düzlemsel delikler için çalışır. ≤16 tutun. (varsayılan: 16) | INT | Evet | 3 to 1024 | +| `fill_chains` | Ayrıca açık zincirleri de doldurur (yalnızca döngüleri değil). Gürültülüdür; OFF, cumesh ile eşleşir. (varsayılan: False) | BOOLEAN | Evet | True or False | + +Not: `weld_epsilon_rel` 0'dan büyük olduğunda, düğüm delikleri algılamadan önce yinelenen köşeleri ön kaynaklar. Kaynak toleransı, sınırlayıcı kutu köşegeninin verilen kesrinde başlar ve mesh kaynaklanmış kabul edilene veya tolerans 1e-2 üst sınırına ulaşana kadar ikiye katlanarak otomatik olarak artar. 8'den fazla sınır köşesi olan delikler, merkez-yelpaze dolgusu kullanır (yeni bir merkez köşesi ekleyerek); daha küçük delikler ise mevcut bir sınır köşesini yeniden kullanan köşe-yelpaze (vertex-fan) dolgusu kullanır. + +## Çıktılar + +| Çıktı Adı | Açıklama | Veri Türü | +|-----------|----------|-----------| +| `mesh` | Deliklerin doldurulduğu, giriş batch formatıyla eşleşen mesh. | MESH | + +> Bu belge yapay zeka tarafından oluşturulmuştur. Herhangi bir hata bulursanız veya iyileştirme önerileriniz varsa, katkıda bulunmaktan çekinmeyin! [GitHub'da Düzenle](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FillHoles/tr.md) + +--- +**Source fingerprint (SHA-256):** `c0fd7f0c2d6eea098efb1dcfd80eaa52997e185b9c442b483f75318eea082196` diff --git a/comfyui_embedded_docs/docs/FillHoles/zh-TW.md b/comfyui_embedded_docs/docs/FillHoles/zh-TW.md new file mode 100644 index 000000000..5241a8709 --- /dev/null +++ b/comfyui_embedded_docs/docs/FillHoles/zh-TW.md @@ -0,0 +1,26 @@ +# FillHoles + +此節點透過偵測開放的邊界邊緣並建立新面孔來封閉孔洞,從而填補 3D 網格中的孔洞。它可在 GPU 上執行,保留既有幾何形狀與 UV,並能處理單一網格、網格列表或網格批次。 + +## 輸入 + +| 參數 | 說明 | 資料類型 | 必填 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `mesh` | 要處理的 3D 網格。接受單一網格、網格列表或批次網格。 | MESH | 是 | - | +| `max_perimeter` | 要填補的最大孔洞周長。0 表示停用。(預設值:0.03) | FLOAT | 是 | 0.0 至無上限 | +| `weld_epsilon_rel` | 預先焊接容差(邊界框對角線的分數);邊界偵測需要已焊接的頂點。0 則跳過。(預設值:1e-5) | FLOAT | 是 | 0.0 至無上限 | +| `max_vertices` | 每個循環的邊界頂點上限;質心扇形僅適用於小型近平面孔洞。請保持 ≤16。(預設值:16) | INT | 是 | 3 至 1024 | +| `fill_chains` | 同時填補開放鏈(不僅是循環)。容易產生雜訊;關閉可對應 cumesh 的行為。(預設值:False) | BOOLEAN | 是 | True 或 False | + +注意:當 `weld_epsilon_rel` 大於 0 時,節點會在偵測孔洞前預先焊接重複頂點。焊接容差從給定的邊界框對角線分數開始,並透過倍增自動增加,直到網格被視為已焊接或容差達到 1e-2 的上限。具有超過 8 個邊界頂點的孔洞使用質心扇形填補(插入新的質心頂點),而較小的孔洞則使用頂點扇形填補,該方法會重用既有的邊界頂點。 + +## 輸出 + +| 輸出名稱 | 說明 | 資料類型 | +|-------------|-------------|-----------| +| `mesh` | 已填補孔洞的網格,並與輸入批次格式相符。 | MESH | + +> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FillHoles/zh-TW.md) + +--- +**Source fingerprint (SHA-256):** `c0fd7f0c2d6eea098efb1dcfd80eaa52997e185b9c442b483f75318eea082196` diff --git a/comfyui_embedded_docs/docs/FillHoles/zh.md b/comfyui_embedded_docs/docs/FillHoles/zh.md new file mode 100644 index 000000000..cd831d417 --- /dev/null +++ b/comfyui_embedded_docs/docs/FillHoles/zh.md @@ -0,0 +1,26 @@ +# FillHoles + +此节点通过检测开放边界边并创建新面来闭合孔洞,从而填充 3D 网格中的孔洞。它在 GPU 上运行,保留现有几何体和 UV,可处理单个网格、网格列表或批量网格。 + +## 输入 + +| 参数 | 描述 | 数据类型 | 是否必填 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `mesh` | 要处理的 3D 网格。接受单个网格、网格列表或批量网格。 | MESH | 是 | - | +| `max_perimeter` | 要填充的最大孔洞周长。0 表示禁用。(默认值:0.03) | FLOAT | 是 | 0.0 至无上限 | +| `weld_epsilon_rel` | 预焊接容差(边界框对角线长度的比例);边界检测需要顶点已焊接。0 表示跳过。(默认值:1e-5) | FLOAT | 是 | 0.0 至无上限 | +| `max_vertices` | 每个周期处理的边界顶点数量上限;质心扇形填充仅适用于较小的近平面孔洞。建议保持 ≤16。(默认值:16) | INT | 是 | 3 至 1024 | +| `fill_chains` | 同时填充开放链(而不仅仅是闭合环)。可能产生噪点;关闭时与 cumesh 行为一致。(默认值:False) | BOOLEAN | 是 | True 或 False | + +注意:当 `weld_epsilon_rel` 大于 0 时,此节点在检测孔洞之前会先预焊接重复顶点。焊接容差从指定的边界框对角线比例开始,并通过倍增自动增大,直到网格被视为已焊接或容差达到 1e-2 的上限。边界顶点超过 8 个的孔洞使用质心扇形填充(插入新的质心顶点),而较小的孔洞使用顶点扇形填充,复用现有的边界顶点。 + +## 输出 + +| 输出名称 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `mesh` | 已填充孔洞的网格,与输入的批处理格式一致。 | MESH | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FillHoles/zh.md) + +--- +**Source fingerprint (SHA-256):** `c0fd7f0c2d6eea098efb1dcfd80eaa52997e185b9c442b483f75318eea082196` diff --git a/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/ar.md b/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/ar.md new file mode 100644 index 000000000..3b672f156 --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/ar.md @@ -0,0 +1,23 @@ +# FishAudioInstantVoiceClone + +ينشئ هذا العقدة صوتًا مستنسخًا خاصًا من تسجيلاتك الصوتية باستخدام Fish Audio API. يمكنك توفير عيّنة صوتية واحدة أو أكثر، ويقوم العقدة ببناء صوت مخصص يمكن استخدامه فورًا لتحويل النص إلى كلام. يقبل العقدة من 1 إلى 20 تسجيلًا، بطول موصى به يتراوح بين 10 و30 ثانية لكل تسجيل، وبحد أقصى إجمالي يبلغ 270 ثانية. + +## المدخلات + +| المعامل | الوصف | نوع البيانات | إلزامي | النطاق | +|-----------|-------------|-----------|----------|-------| +| `files` | التسجيلات الصوتية لاستنساخ الصوت. هذا إدخال قابل للتوسيع: اربط عنصرًا صوتيًا واحدًا أو أكثر (مثل `audio_1`، `audio_2`، ...) لتوفير العينات الصوتية. | AUDIO | نعم | من 1 إلى 20 تسجيلًا | +| `enhance_audio_quality` | تحسين جودة الصوت المرجعي قبل التدريب (الافتراضي: True). | BOOLEAN | نعم | True
False | + +**ملاحظة:** يجب أن تكون المدة الإجمالية لجميع الصوتيات المرجعية مجتمعة أقل من 270 ثانية. إذا بلغت المدة المجتمعة 270 ثانية أو تجاوزتها، يُرجع العقدة خطأً. + +## المخرجات + +| اسم المخرج | الوصف | نوع البيانات | +|-------------|-------------|-----------| +| `voice` | الصوت المستنسخ المُنشأ حديثًا، ويتم تحديده بواسطة معرف صوتي فريد يُرجعه Fish Audio API. يمكن استخدام هذا الصوت لتحويل النص إلى كلام. | FISHAUDIO_VOICE | + +> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/ar.md) + +--- +**Source fingerprint (SHA-256):** `6c4f011a4611a076b2488152591efeb61c029d6dfae2b079ba74689891c84803` diff --git a/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/en.md b/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/en.md new file mode 100644 index 000000000..2a78072a9 --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/en.md @@ -0,0 +1,23 @@ +# FishAudioInstantVoiceClone + +This node creates a private cloned voice from your audio recordings using the Fish Audio API. You provide one or more audio samples, and the node builds a custom voice that can be immediately used for text-to-speech. It accepts 1 to 20 recordings, with a recommended length of 10 to 30 seconds each and a total limit of 270 seconds. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `files` | Audio recordings for voice cloning. This is a growable input: connect one or more audio items (for example `audio_1`, `audio_2`, ...) to provide the voice samples. | AUDIO | Yes | 1 to 20 recordings | +| `enhance_audio_quality` | Enhance reference audio quality before training (default: True). | BOOLEAN | Yes | True
False | + +**Note:** The total duration of all reference audio combined must be under 270 seconds. If the combined duration reaches or exceeds 270 seconds, the node returns an error. + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `voice` | The newly created cloned voice, identified by a unique voice ID returned by the Fish Audio API. This voice can be used for text-to-speech. | FISHAUDIO_VOICE | + +> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/en.md) + +--- +**Source fingerprint (SHA-256):** `6c4f011a4611a076b2488152591efeb61c029d6dfae2b079ba74689891c84803` diff --git a/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/es.md b/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/es.md new file mode 100644 index 000000000..bdd5b422d --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/es.md @@ -0,0 +1,23 @@ +# FishAudioInstantVoiceClone + +Este nodo crea una voz clonada privada a partir de tus grabaciones de audio utilizando la API de Fish Audio. Proporciona una o más muestras de audio y el nodo construye una voz personalizada que puede utilizarse inmediatamente para la conversión de texto a voz. Acepta de 1 a 20 grabaciones, con una longitud recomendada de 10 a 30 segundos cada una y un límite total de 270 segundos. + +## Entradas + +| Parámetro | Descripción | Tipo de datos | Requerido | Rango | +|-----------|-------------|---------------|-----------|-------| +| `files` | Grabaciones de audio para la clonación de voz. Esta es una entrada ampliable: conecta uno o más elementos de audio (por ejemplo `audio_1`, `audio_2`, ...) para proporcionar las muestras de voz. | AUDIO | Sí | 1 a 20 grabaciones | +| `enhance_audio_quality` | Mejora la calidad del audio de referencia antes del entrenamiento (valor predeterminado: True). | BOOLEAN | Sí | True
False | + +**Nota:** La duración total de todo el audio de referencia combinado debe ser inferior a 270 segundos. Si la duración combinada alcanza o supera los 270 segundos, el nodo devuelve un error. + +## Salidas + +| Nombre de salida | Descripción | Tipo de datos | +|------------------|-------------|---------------| +| `voice` | La voz clonada recién creada, identificada por un ID de voz único devuelto por la API de Fish Audio. Esta voz se puede utilizar para la conversión de texto a voz. | FISHAUDIO_VOICE | + +> Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/es.md) + +--- +**Source fingerprint (SHA-256):** `6c4f011a4611a076b2488152591efeb61c029d6dfae2b079ba74689891c84803` diff --git a/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/fa.md b/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/fa.md new file mode 100644 index 000000000..da104e04f --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/fa.md @@ -0,0 +1,23 @@ +# FishAudioInstantVoiceClone + +این گره با استفاده از API سرویس Fish Audio یک صدای شبیه‌سازی‌شده خصوصی از ضبط‌های صوتی شما می‌سازد. شما یک یا چند نمونه صوتی ارائه می‌دهید و گره یک صدای سفارشی می‌سازد که بلافاصله برای تبدیل متن به گفتار قابل استفاده است. این گره از 1 تا 20 ضبط را می‌پذیرد؛ طول پیشنهادی هر ضبط 10 تا 30 ثانیه و مجموع آن حداکثر 270 ثانیه است. + +## ورودی‌ها + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `files` | ضبط‌های صوتی برای شبیه‌سازی صدا. این یک ورودی قابل افزایش (growable) است: یک یا چند آیتم صوتی (مثلاً `audio_1`، `audio_2`، ...) را برای ارائه نمونه‌های صدا متصل کنید. | AUDIO | بله | 1 تا 20 ضبط | +| `enhance_audio_quality` | بهبود کیفیت صدای مرجع قبل از آموزش (پیش‌فرض: True). | BOOLEAN | بله | True
False | + +**توجه:** مجموع مدت‌زمان تمام صداهای مرجع ترکیب‌شده باید کمتر از 270 ثانیه باشد. اگر مجموع مدت‌زمان به 270 ثانیه برسد یا بیشتر شود، گره خطا برمی‌گرداند. + +## خروجی‌ها + +| نام خروجی | توضیحات | نوع داده | +|-------------|-------------|-----------| +| `voice` | صدای شبیه‌سازی‌شده تازه ایجاد شده که با شناسه یکتای صدا (voice ID) برگشتی از API سرویس Fish Audio مشخص می‌شود. این صدا می‌تواند برای تبدیل متن به گفتار استفاده شود. | FISHAUDIO_VOICE | + +> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/fa.md) + +--- +**Source fingerprint (SHA-256):** `6c4f011a4611a076b2488152591efeb61c029d6dfae2b079ba74689891c84803` diff --git a/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/fr.md b/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/fr.md new file mode 100644 index 000000000..1683a0a57 --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/fr.md @@ -0,0 +1,23 @@ +# FishAudioInstantVoiceClone + +Ce nœud crée une voix clonée privée à partir de vos enregistrements audio via l'API Fish Audio. Vous fournissez un ou plusieurs échantillons audio, et le nœud construit une voix personnalisée qui peut être immédiatement utilisée pour la synthèse vocale. Il accepte de 1 à 20 enregistrements, avec une durée recommandée de 10 à 30 secondes chacun et une limite totale de 270 secondes. + +## Entrées + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `files` | Enregistrements audio pour le clonage de voix. Il s'agit d'une entrée extensible : connectez un ou plusieurs éléments audio (par exemple `audio_1`, `audio_2`, ...) pour fournir les échantillons vocaux. | AUDIO | Oui | 1 à 20 enregistrements | +| `enhance_audio_quality` | Améliorer la qualité de l'audio de référence avant l'entraînement (par défaut : True). | BOOLEAN | Oui | True
False | + +**Remarque :** La durée totale de tous les audios de référence combinés doit être inférieure à 270 secondes. Si la durée combinée atteint ou dépasse 270 secondes, le nœud renvoie une erreur. + +## Sorties + +| Nom de sortie | Description | Type de données | +|---------------|-------------|-----------------| +| `voice` | La voix clonée nouvellement créée, identifiée par un identifiant de voix unique renvoyé par l'API Fish Audio. Cette voix peut être utilisée pour la synthèse vocale. | FISHAUDIO_VOICE | + +> Cette documentation a été générée par IA. Si vous trouvez des erreurs ou avez des suggestions d'amélioration, n'hésitez pas à contribuer ! [Modifier sur GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/fr.md) + +--- +**Source fingerprint (SHA-256):** `6c4f011a4611a076b2488152591efeb61c029d6dfae2b079ba74689891c84803` diff --git a/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/ja.md b/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/ja.md new file mode 100644 index 000000000..0f7a28e45 --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/ja.md @@ -0,0 +1,23 @@ +# FishAudioInstantVoiceClone + +このノードは、Fish Audio API を使用して、あなたの音声録音からプライベートなクローン音声を作成します。1つ以上の音声サンプルを提供すると、ノードはテキスト読み上げにすぐに使用できるカスタム音声を構築します。1〜20件の録音を受け付け、各録音は10〜30秒を推奨し、合計で270秒の制限があります。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `files` | 音声クローン用の録音データです。拡張可能な入力で、1つ以上のオーディオアイテム(例:`audio_1`、`audio_2` ...)を接続して音声サンプルを提供します。 | AUDIO | はい | 1〜20件の録音 | +| `enhance_audio_quality` | トレーニング前に参照音声の品質を向上させます(デフォルト: True)。 | BOOLEAN | はい | True
False | + +**注記:** すべての参照音声を合わせた合計時間は270秒未満である必要があります。合計時間が270秒以上になる場合、ノードはエラーを返します。 + +## 出力 + +| 出力名 | 説明 | データ型 | +|-------------|-------------|-----------| +| `voice` | 新しく作成されたクローン音声です。Fish Audio API によって返された一意の音声 ID で識別されます。この音声はテキスト読み上げに使用できます。 | FISHAUDIO_VOICE | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/ja.md) + +--- +**Source fingerprint (SHA-256):** `6c4f011a4611a076b2488152591efeb61c029d6dfae2b079ba74689891c84803` diff --git a/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/ko.md b/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/ko.md new file mode 100644 index 000000000..e7fda585c --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/ko.md @@ -0,0 +1,23 @@ +# FishAudioInstantVoiceClone + +이 노드는 Fish Audio API를 사용하여 사용자의 오디오 녹음에서 개인 복제 음성을 생성합니다. 하나 이상의 오디오 샘플을 제공하면 노드가 맞춤 음성을 구축하여 즉시 텍스트 음성 변환에 사용할 수 있습니다. 1~20개의 녹음을 허용하며, 각 녹음의 권장 길이는 10~30초이고 총 제한은 270초입니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 여부 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `files` | 음성 복제를 위한 오디오 녹음입니다. 확장 가능한 입력입니다. 하나 이상의 오디오 항목(예: `audio_1`, `audio_2`, ...)을 연결하여 음성 샘플을 제공합니다. | AUDIO | 예 | 1 to 20 recordings | +| `enhance_audio_quality` | 학습 전에 참조 오디오 품질을 향상시킵니다 (기본값: True). | BOOLEAN | 예 | True
False | + +**참고:** 모든 참조 오디오의 총 재생 시간은 270초 미만이어야 합니다. 결합된 재생 시간이 270초 이상이면 노드가 오류를 반환합니다. + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `voice` | 새로 생성된 복제 음성으로, Fish Audio API가 반환한 고유 음성 ID로 식별됩니다. 이 음성은 텍스트 음성 변환에 사용할 수 있습니다. | FISHAUDIO_VOICE | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/ko.md) + +--- +**Source fingerprint (SHA-256):** `6c4f011a4611a076b2488152591efeb61c029d6dfae2b079ba74689891c84803` diff --git a/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/pt-BR.md b/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/pt-BR.md new file mode 100644 index 000000000..cac879e0e --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/pt-BR.md @@ -0,0 +1,23 @@ +# FishAudioInstantVoiceClone + +Este nó cria uma voz clonada privada a partir das suas gravações de áudio usando a API Fish Audio. Você fornece uma ou mais amostras de áudio, e o nó constrói uma voz personalizada que pode ser usada imediatamente para conversão de texto em fala. Ele aceita de 1 a 20 gravações, com duração recomendada de 10 a 30 segundos cada e um limite total de 270 segundos. + +## Entradas + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | +|-----------|-------------|-----------|----------|-------| +| `files` | Gravações de áudio para clonagem de voz. Esta é uma entrada expansível: conecte um ou mais itens de áudio (por exemplo `audio_1`, `audio_2`, ...) para fornecer as amostras de voz. | AUDIO | Sim | 1 a 20 gravações | +| `enhance_audio_quality` | Melhora a qualidade do áudio de referência antes do treinamento (padrão: True). | BOOLEAN | Sim | True
False | + +**Observação:** A duração total de todo o áudio de referência combinado deve ser inferior a 270 segundos. Se a duração combinada atingir ou exceder 270 segundos, o nó retorna um erro. + +## Saídas + +| Nome da Saída | Descrição | Tipo de Dados | +|-------------|-------------|-----------| +| `voice` | A voz clonada recém-criada, identificada por um ID de voz exclusivo retornado pela API Fish Audio. Essa voz pode ser usada para conversão de texto em fala. | FISHAUDIO_VOICE | + +> Esta documentação foi gerada por IA. Se você encontrar erros ou tiver sugestões de melhoria, sinta-se à vontade para contribuir! [Editar no GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/pt-BR.md) + +--- +**Source fingerprint (SHA-256):** `6c4f011a4611a076b2488152591efeb61c029d6dfae2b079ba74689891c84803` diff --git a/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/ru.md b/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/ru.md new file mode 100644 index 000000000..7e098cf21 --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/ru.md @@ -0,0 +1,23 @@ +# FishAudioInstantVoiceClone + +Этот узел создает приватный клонированный голос из ваших аудиозаписей с помощью Fish Audio API. Вы предоставляете один или несколько аудиосэмплов, и узел создает индивидуальный голос, который можно сразу использовать для синтеза речи. Он принимает от 1 до 20 записей, рекомендуемая длительность каждой — от 10 до 30 секунд, общее ограничение — 270 секунд. + +## Входы + +| Параметр | Описание | Тип данных | Обязательный | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `files` | Аудиозаписи для клонирования голоса. Это расширяемый вход: подключите один или несколько аудиоэлементов (например, `audio_1`, `audio_2`, ...), чтобы предоставить образцы голоса. | AUDIO | Да | от 1 до 20 записей | +| `enhance_audio_quality` | Улучшить качество эталонного аудио перед обучением (по умолчанию: True). | BOOLEAN | Да | True
False | + +**Примечание:** Общая длительность всех эталонных аудиозаписей вместе взятых должна быть менее 270 секунд. Если суммарная длительность достигает или превышает 270 секунд, узел возвращает ошибку. + +## Выходы + +| Имя выхода | Описание | Тип данных | +|-------------|-------------|-----------| +| `voice` | Недавно созданный клонированный голос, идентифицируемый уникальным идентификатором голоса, возвращаемым Fish Audio API. Этот голос можно использовать для синтеза речи. | FISHAUDIO_VOICE | + +> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/ru.md) + +--- +**Source fingerprint (SHA-256):** `6c4f011a4611a076b2488152591efeb61c029d6dfae2b079ba74689891c84803` diff --git a/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/tr.md b/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/tr.md new file mode 100644 index 000000000..ce9ed6ee7 --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/tr.md @@ -0,0 +1,23 @@ +# FishAudioInstantVoiceClone + +Bu düğüm, Fish Audio API kullanarak ses kayıtlarınızdan özel bir klonlanmış ses oluşturur. Bir veya daha fazla ses örneği sağlarsınız; düğüm, metin-konuşma için hemen kullanılabilen özel bir ses oluşturur. 1 ila 20 kayıt kabul eder; her birinin önerilen uzunluğu 10 ila 30 saniye olup toplam limit 270 saniyedir. + +## Girdiler + +| Parametre | Açıklama | Veri Türü | Zorunlu | Aralık | +|-----------|-------------|-----------|----------|-------| +| `files` | Ses klonlama için ses kayıtları. Bu genişletilebilir bir girdidir: bir veya daha fazla ses öğesini (örneğin `audio_1`, `audio_2`, ...) ses örneklerini sağlamak için bağlayın. | AUDIO | Evet | 1 ila 20 kayıt | +| `enhance_audio_quality` | Eğitimden önce referans ses kalitesini iyileştir (varsayılan: True). | BOOLEAN | Evet | True
False | + +**Not:** Tüm referans seslerin toplam süresi 270 saniyenin altında olmalıdır. Toplam süre 270 saniyeye ulaşır veya aşarsa, düğüm bir hata döndürür. + +## Çıktılar + +| Çıktı Adı | Açıklama | Veri Türü | +|-------------|-------------|-----------| +| `voice` | Yeni oluşturulan klonlanmış ses; Fish Audio API tarafından döndürülen benzersiz bir ses kimliğiyle tanımlanır. Bu ses metin-konuşma için kullanılabilir. | FISHAUDIO_VOICE | + +> Bu belge yapay zeka tarafından oluşturulmuştur. Herhangi bir hata bulursanız veya iyileştirme önerileriniz varsa, katkıda bulunmaktan çekinmeyin! [GitHub'da Düzenle](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/tr.md) + +--- +**Source fingerprint (SHA-256):** `6c4f011a4611a076b2488152591efeb61c029d6dfae2b079ba74689891c84803` diff --git a/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/zh-TW.md b/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/zh-TW.md new file mode 100644 index 000000000..1af049cda --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/zh-TW.md @@ -0,0 +1,23 @@ +# FishAudioInstantVoiceClone + +此節點使用 Fish Audio API 從您的音訊錄音建立私人克隆語音。您提供一個或多個音訊樣本,節點會建立可立即用於文字轉語音的自訂語音。它接受 1 到 20 個錄音,每個錄音建議長度為 10 到 30 秒,總長度上限為 270 秒。 + +## 輸入 + +| 參數 | 說明 | 資料類型 | 必要 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `files` | 用於語音克隆的音訊錄音。這是一個可擴充輸入:連接一個或多個音訊項目(例如 `audio_1`、`audio_2`、...)以提供語音樣本。 | AUDIO | 是 | 1 到 20 個錄音 | +| `enhance_audio_quality` | 在訓練前增強參考音訊的品質(預設值:True)。 | BOOLEAN | 是 | True
False | + +**注意:** 所有參考音訊的合併總時長必須低於 270 秒。如果合併總時長達到或超過 270 秒,此節點將回傳錯誤。 + +## 輸出 + +| 輸出名稱 | 說明 | 資料類型 | +|-------------|-------------|-----------| +| `voice` | 新建立的克隆語音,由 Fish Audio API 回傳的唯一語音 ID 識別。此語音可用於文字轉語音。 | FISHAUDIO_VOICE | + +> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/zh-TW.md) + +--- +**Source fingerprint (SHA-256):** `6c4f011a4611a076b2488152591efeb61c029d6dfae2b079ba74689891c84803` diff --git a/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/zh.md b/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/zh.md new file mode 100644 index 000000000..c003bb145 --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/zh.md @@ -0,0 +1,23 @@ +# FishAudioInstantVoiceClone + +此节点使用 Fish Audio API 从您的录音中创建私有克隆语音。您提供一个或多个音频样本,节点会构建一个自定义语音,可立即用于文本转语音。它接受 1 到 20 个录音,每个录音建议长度为 10 到 30 秒,总时长限制为 270 秒。 + +## 输入 + +| 参数 | 描述 | 数据类型 | 必填 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `files` | 用于语音克隆的音频录音。这是一个可增长输入:连接一个或多个音频项目(例如 `audio_1`、`audio_2`……)以提供语音样本。 | AUDIO | 是 | 1 至 20 个录音 | +| `enhance_audio_quality` | 在训练前增强参考音频质量(默认值:True)。 | BOOLEAN | 是 | True
False | + +**注意:** 所有参考音频的总时长必须低于 270 秒。如果合并时长达到或超过 270 秒,节点将返回错误。 + +## 输出 + +| 输出名称 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `voice` | 新创建的克隆语音,由 Fish Audio API 返回的唯一语音 ID 标识。此语音可用于文本转语音。 | FISHAUDIO_VOICE | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioInstantVoiceClone/zh.md) + +--- +**Source fingerprint (SHA-256):** `6c4f011a4611a076b2488152591efeb61c029d6dfae2b079ba74689891c84803` diff --git a/comfyui_embedded_docs/docs/FishAudioSpeechToText/ar.md b/comfyui_embedded_docs/docs/FishAudioSpeechToText/ar.md new file mode 100644 index 000000000..db5232e2f --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioSpeechToText/ar.md @@ -0,0 +1,26 @@ +# FishAudioSpeechToText + +تقوم هذه العقدة بتحويل الصوت إلى نص باستخدام خدمة Fish Audio لتحويل الكلام إلى نص. تكتشف تلقائيًا لغة الصوت، ويمكنها اختياريًا إرجاع مقاطع ذات طوابع زمنية على مستوى الكلمات بصيغة JSON. + +## المدخلات + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|-----------|-------------|-----------|----------|-------| +| `audio` | الصوت المطلوب تحويله إلى نص. | AUDIO | نعم | — | +| `language` | تلميح لغة ISO 639-1 (مثل 'en'، 'zh'). يتم اكتشاف اللغة تلقائيًا بغض النظر عن ذلك. الافتراضي: "" (سلسلة فارغة). | STRING | لا | أي رمز لغة ISO 639-1، مثل `en`، `zh`؛ سلسلة فارغة للاكتشاف التلقائي | +| `precise_timestamps` | إرجاع مقاطع ذات طوابع زمنية على مستوى الكلمات. الافتراضي: false. | BOOLEAN | لا | true or false | + +ملاحظة: معامل `language` هو مجرد تلميح — يتم دائمًا اكتشاف اللغة تلقائيًا من الصوت. عندما تكون قيمة `precise_timestamps` هي false (الافتراضي)، لا يتم إرجاع طوابع زمنية على مستوى الكلمات؛ وعندما تكون true، تتضمن المقاطع الناتجة طوابع زمنية على مستوى الكلمات. + +## المخرجات + +| اسم المخرَج | الوصف | نوع البيانات | +|-------------|-------------|-----------| +| `text` | النص الذي تم تحويله. | STRING | +| `language_code` | رمز لغة ISO 639-1 المكتشف للصوت. | STRING | +| `segments_json` | سلسلة JSON تحتوي على مقاطع النسخ. تتضمن طوابع زمنية على مستوى الكلمات عند تفعيل `precise_timestamps`. | STRING | + +> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioSpeechToText/ar.md) + +--- +**Source fingerprint (SHA-256):** `eaf1c9a9d2b90ec962a408615cc417b552864354c3f272144b8e239b23961920` diff --git a/comfyui_embedded_docs/docs/FishAudioSpeechToText/en.md b/comfyui_embedded_docs/docs/FishAudioSpeechToText/en.md new file mode 100644 index 000000000..a0beea1db --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioSpeechToText/en.md @@ -0,0 +1,26 @@ +# FishAudioSpeechToText + +This node transcribes audio into text using the Fish Audio speech-to-text service. It automatically detects the language of the audio and can optionally return word-level timestamped segments as JSON. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `audio` | Audio to transcribe. | AUDIO | Yes | — | +| `language` | ISO 639-1 language hint (e.g. 'en', 'zh'). The language is auto-detected regardless. Default: "" (empty string). | STRING | No | Any ISO 639-1 language code, e.g. `en`, `zh`; empty string for auto-detection | +| `precise_timestamps` | Return word-level timestamped segments. Default: false. | BOOLEAN | No | true or false | + +Note: The `language` parameter is only a hint — the language is always auto-detected from the audio. When `precise_timestamps` is false (the default), word-level timestamps are not returned; when true, the output segments include word-level timestamps. + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `text` | The transcribed text. | STRING | +| `language_code` | The ISO 639-1 language code detected for the audio. | STRING | +| `segments_json` | JSON string containing the transcription segments. Includes word-level timestamps when `precise_timestamps` is enabled. | STRING | + +> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioSpeechToText/en.md) + +--- +**Source fingerprint (SHA-256):** `eaf1c9a9d2b90ec962a408615cc417b552864354c3f272144b8e239b23961920` diff --git a/comfyui_embedded_docs/docs/FishAudioSpeechToText/es.md b/comfyui_embedded_docs/docs/FishAudioSpeechToText/es.md new file mode 100644 index 000000000..50f28076c --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioSpeechToText/es.md @@ -0,0 +1,26 @@ +# FishAudioSpeechToText + +Este nodo transcribe audio a texto mediante el servicio de voz a texto de Fish Audio. Detecta automáticamente el idioma del audio y, opcionalmente, puede devolver segmentos con marcas de tiempo a nivel de palabra en formato JSON. + +## Entradas + +| Parámetro | Descripción | Tipo de dato | Requerido | Rango | +|-----------|-------------|--------------|-----------|-------| +| `audio` | Audio a transcribir. | AUDIO | Sí | — | +| `language` | Sugerencia de idioma ISO 639-1 (p. ej., `en`, `zh`). El idioma se detecta automáticamente de todos modos. Valor predeterminado: "" (cadena vacía). | STRING | No | Cualquier código de idioma ISO 639-1, p. ej., `en`, `zh`; cadena vacía para detección automática | +| `precise_timestamps` | Devuelve segmentos con marcas de tiempo a nivel de palabra. Valor predeterminado: false. | BOOLEAN | No | true o false | + +Nota: El parámetro `language` es solo una sugerencia: el idioma siempre se detecta automáticamente a partir del audio. Cuando `precise_timestamps` es false (el valor predeterminado), no se devuelven marcas de tiempo a nivel de palabra; cuando es true, los segmentos de salida incluyen marcas de tiempo a nivel de palabra. + +## Salidas + +| Nombre de salida | Descripción | Tipo de dato | +|------------------|-------------|--------------| +| `text` | El texto transcrito. | STRING | +| `language_code` | El código de idioma ISO 639-1 detectado para el audio. | STRING | +| `segments_json` | Cadena JSON que contiene los segmentos de transcripción. Incluye marcas de tiempo a nivel de palabra cuando `precise_timestamps` está habilitado. | STRING | + +> Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioSpeechToText/es.md) + +--- +**Source fingerprint (SHA-256):** `eaf1c9a9d2b90ec962a408615cc417b552864354c3f272144b8e239b23961920` diff --git a/comfyui_embedded_docs/docs/FishAudioSpeechToText/fa.md b/comfyui_embedded_docs/docs/FishAudioSpeechToText/fa.md new file mode 100644 index 000000000..41d87dc2e --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioSpeechToText/fa.md @@ -0,0 +1,24 @@ +# FishAudioSpeechToText + +## ورودی‌ها + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `audio` | صوتی که باید به متن تبدیل شود. | AUDIO | بله | — | +| `language` | راهنمای زبان بر اساس ISO 639-1 (مثلاً `en`، `zh`). زبان به هر حال به‌طور خودکار تشخیص داده می‌شود. پیش‌فرض: `""` (رشته خالی). | STRING | خیر | هر کد زبان ISO 639-1، مثلاً `en`، `zh`؛ رشته خالی برای تشخیص خودکار | +| `precise_timestamps` | بازگرداندن بخش‌های دارای برچسب زمانی در سطح کلمه. پیش‌فرض: false. | BOOLEAN | خیر | true یا false | + +توجه: پارامتر `language` فقط یک راهنما است — زبان همواره به‌طور خودکار از روی صدا تشخیص داده می‌شود. وقتی `precise_timestamps` برابر false باشد (پیش‌فرض)، برچسب‌های زمانی در سطح کلمه بازگردانده نمی‌شوند؛ وقتی true باشد، بخش‌های خروجی شامل برچسب‌های زمانی در سطح کلمه خواهند بود. + +## خروجی‌ها + +| نام خروجی | توضیحات | نوع داده | +|-------------|-------------|-----------| +| `text` | متن رونویسی‌شده. | STRING | +| `language_code` | کد زبان ISO 639-1 تشخیص‌داده‌شده برای صدا. | STRING | +| `segments_json` | رشته JSON شامل بخش‌های رونویسی. وقتی `precise_timestamps` فعال باشد، برچسب‌های زمانی در سطح کلمه را نیز شامل می‌شود. | STRING | + +> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioSpeechToText/fa.md) + +--- +**Source fingerprint (SHA-256):** `eaf1c9a9d2b90ec962a408615cc417b552864354c3f272144b8e239b23961920` diff --git a/comfyui_embedded_docs/docs/FishAudioSpeechToText/fr.md b/comfyui_embedded_docs/docs/FishAudioSpeechToText/fr.md new file mode 100644 index 000000000..220f68968 --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioSpeechToText/fr.md @@ -0,0 +1,26 @@ +# FishAudioSpeechToText + +Ce nœud transcrit l’audio en texte à l’aide du service de transcription vocale Fish Audio. Il détecte automatiquement la langue de l’audio et peut éventuellement renvoyer des segments horodatés au niveau du mot au format JSON. + +## Entrées + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `audio` | Audio à transcrire. | AUDIO | Oui | — | +| `language` | Indication de langue ISO 639-1 (p. ex. `en`, `zh`). La langue est détectée automatiquement dans tous les cas. Par défaut : "" (chaîne vide). | STRING | Non | Tout code de langue ISO 639-1, p. ex. `en`, `zh` ; chaîne vide pour la détection automatique | +| `precise_timestamps` | Renvoie des segments horodatés au niveau du mot. Par défaut : false. | BOOLEAN | Non | true ou false | + +Remarque : le paramètre `language` n’est qu’une indication — la langue est toujours détectée automatiquement à partir de l’audio. Lorsque `precise_timestamps` est false (par défaut), les horodatages au niveau du mot ne sont pas renvoyés ; lorsqu’il est true, les segments de sortie incluent les horodatages au niveau du mot. + +## Sorties + +| Nom de sortie | Description | Type de données | +|---------------|-------------|-----------------| +| `text` | Le texte transcrit. | STRING | +| `language_code` | Le code de langue ISO 639-1 détecté pour l’audio. | STRING | +| `segments_json` | Chaîne JSON contenant les segments de transcription. Inclut les horodatages au niveau du mot lorsque `precise_timestamps` est activé. | STRING | + +> Cette documentation a été générée par IA. Si vous trouvez des erreurs ou avez des suggestions d'amélioration, n'hésitez pas à contribuer ! [Modifier sur GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioSpeechToText/fr.md) + +--- +**Source fingerprint (SHA-256):** `eaf1c9a9d2b90ec962a408615cc417b552864354c3f272144b8e239b23961920` diff --git a/comfyui_embedded_docs/docs/FishAudioSpeechToText/ja.md b/comfyui_embedded_docs/docs/FishAudioSpeechToText/ja.md new file mode 100644 index 000000000..651b910eb --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioSpeechToText/ja.md @@ -0,0 +1,26 @@ +# FishAudioSpeechToText + +このノードは、Fish Audioの音声テキスト変換サービスを使用して、音声をテキストに書き起こします。音声の言語を自動検出し、オプションで単語レベルのタイムスタンプ付きセグメントをJSONとして返すこともできます。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `audio` | 書き起こす対象の音声。 | AUDIO | はい | — | +| `language` | ISO 639-1言語ヒント(例: 'en'、'zh')。この指定に関係なく、言語は自動検出されます。デフォルト: ""(空文字列)。 | STRING | いいえ | 任意のISO 639-1言語コード(例: `en`、`zh`)。自動検出の場合は空文字列 | +| `precise_timestamps` | 単語レベルのタイムスタンプ付きセグメントを返します。デフォルト: false。 | BOOLEAN | いいえ | true または false | + +注: `language` パラメータはヒントに過ぎません。言語は常に音声から自動検出されます。`precise_timestamps` が false(デフォルト)の場合、単語レベルのタイムスタンプは返されません。true の場合、出力セグメントには単語レベルのタイムスタンプが含まれます。 + +## 出力 + +| 出力名 | 説明 | データ型 | +|-------------|-------------|-----------| +| `text` | 書き起こされたテキスト。 | STRING | +| `language_code` | 音声に対して検出されたISO 639-1言語コード。 | STRING | +| `segments_json` | 書き起こしセグメントを含むJSON文字列。`precise_timestamps` が有効な場合は、単語レベルのタイムスタンプが含まれます。 | STRING | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioSpeechToText/ja.md) + +--- +**Source fingerprint (SHA-256):** `eaf1c9a9d2b90ec962a408615cc417b552864354c3f272144b8e239b23961920` diff --git a/comfyui_embedded_docs/docs/FishAudioSpeechToText/ko.md b/comfyui_embedded_docs/docs/FishAudioSpeechToText/ko.md new file mode 100644 index 000000000..32693a875 --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioSpeechToText/ko.md @@ -0,0 +1,26 @@ +# FishAudioSpeechToText + +이 노드는 Fish Audio 음성-텍스트 변환 서비스를 사용하여 오디오를 텍스트로 변환합니다. 오디오의 언어를 자동으로 감지하며, 선택적으로 단어 수준의 타임스탬프가 포함된 세그먼트를 JSON으로 반환할 수 있습니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `audio` | 변환할 오디오입니다. | AUDIO | 예 | — | +| `language` | ISO 639-1 언어 힌트(예: 'en', 'zh'). 언어는 힌트와 관계없이 자동으로 감지됩니다. 기본값: ""(빈 문자열). | STRING | 아니요 | 모든 ISO 639-1 언어 코드(예: `en`, `zh`), 자동 감지를 위한 빈 문자열 | +| `precise_timestamps` | 단어 수준의 타임스탬프가 포함된 세그먼트를 반환합니다. 기본값: false. | BOOLEAN | 아니요 | true 또는 false | + +참고: `language` 매개변수는 힌트일 뿐이며, 언어는 항상 오디오에서 자동으로 감지됩니다. `precise_timestamps`가 false(기본값)인 경우 단어 수준의 타임스탬프가 반환되지 않으며, true인 경우 출력 세그먼트에 단어 수준의 타임스탬프가 포함됩니다. + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `text` | 변환된 텍스트입니다. | STRING | +| `language_code` | 오디오에서 감지된 ISO 639-1 언어 코드입니다. | STRING | +| `segments_json` | 변환 세그먼트를 포함하는 JSON 문자열입니다. `precise_timestamps`가 활성화된 경우 단어 수준의 타임스탬프를 포함합니다. | STRING | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioSpeechToText/ko.md) + +--- +**Source fingerprint (SHA-256):** `eaf1c9a9d2b90ec962a408615cc417b552864354c3f272144b8e239b23961920` diff --git a/comfyui_embedded_docs/docs/FishAudioSpeechToText/pt-BR.md b/comfyui_embedded_docs/docs/FishAudioSpeechToText/pt-BR.md new file mode 100644 index 000000000..d22a7ec86 --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioSpeechToText/pt-BR.md @@ -0,0 +1,26 @@ +# FishAudioSpeechToText + +Este nó transcreve áudio em texto usando o serviço de transcrição de fala Fish Audio. Ele detecta automaticamente o idioma do áudio e pode, opcionalmente, retornar segmentos com marcação temporal por palavra como JSON. + +## Entradas + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | +|-----------|-------------|-----------|----------|-------| +| `audio` | Áudio a ser transcrito. | AUDIO | Sim | — | +| `language` | Dica de idioma ISO 639-1 (ex.: 'en', 'zh'). O idioma é detectado automaticamente independentemente disso. Padrão: "" (string vazia). | STRING | Não | Qualquer código de idioma ISO 639-1, ex.: `en`, `zh`; string vazia para detecção automática | +| `precise_timestamps` | Retorna segmentos com marcação temporal por palavra. Padrão: false. | BOOLEAN | Não | true ou false | + +Nota: O parâmetro `language` é apenas uma dica — o idioma é sempre detectado automaticamente a partir do áudio. Quando `precise_timestamps` é false (o padrão), marcações temporais por palavra não são retornadas; quando é true, os segmentos de saída incluem marcações temporais por palavra. + +## Saídas + +| Nome da Saída | Descrição | Tipo de Dados | +|-------------|-------------|-----------| +| `text` | O texto transcrito. | STRING | +| `language_code` | O código de idioma ISO 639-1 detectado para o áudio. | STRING | +| `segments_json` | String JSON contendo os segmentos de transcrição. Inclui marcações temporais por palavra quando `precise_timestamps` está habilitado. | STRING | + +> Esta documentação foi gerada por IA. Se você encontrar erros ou tiver sugestões de melhoria, sinta-se à vontade para contribuir! [Editar no GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioSpeechToText/pt-BR.md) + +--- +**Source fingerprint (SHA-256):** `eaf1c9a9d2b90ec962a408615cc417b552864354c3f272144b8e239b23961920` diff --git a/comfyui_embedded_docs/docs/FishAudioSpeechToText/ru.md b/comfyui_embedded_docs/docs/FishAudioSpeechToText/ru.md new file mode 100644 index 000000000..7dfbd8f7e --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioSpeechToText/ru.md @@ -0,0 +1,26 @@ +# FishAudioSpeechToText + +Этот узел преобразует аудио в текст с помощью сервиса распознавания речи Fish Audio. Он автоматически определяет язык аудио и при необходимости может возвращать сегменты с тайм-кодами на уровне слов в формате JSON. + +## Входные параметры + +| Параметр | Описание | Тип данных | Обязательный | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `audio` | Аудио для транскрибирования. | AUDIO | Да | — | +| `language` | Подсказка языка в формате ISO 639-1 (например, `'en'`, `'zh'`). Язык в любом случае определяется автоматически. По умолчанию: `""` (пустая строка). | STRING | Нет | Любой код языка ISO 639-1, например `en`, `zh`; пустая строка для автоматического определения | +| `precise_timestamps` | Возвращать сегменты с тайм-кодами на уровне слов. По умолчанию: false. | BOOLEAN | Нет | true или false | + +Примечание: параметр `language` является лишь подсказкой — язык всегда определяется автоматически из аудио. Когда `precise_timestamps` имеет значение false (по умолчанию), тайм-коды на уровне слов не возвращаются; когда true, выходные сегменты включают тайм-коды на уровне слов. + +## Выходные данные + +| Имя выхода | Описание | Тип данных | +|-------------|-------------|-----------| +| `text` | Транскрибированный текст. | STRING | +| `language_code` | Код языка ISO 639-1, определенный для аудио. | STRING | +| `segments_json` | JSON-строка, содержащая сегменты транскрипции. Включает тайм-коды на уровне слов, если включен параметр `precise_timestamps`. | STRING | + +> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioSpeechToText/ru.md) + +--- +**Source fingerprint (SHA-256):** `eaf1c9a9d2b90ec962a408615cc417b552864354c3f272144b8e239b23961920` diff --git a/comfyui_embedded_docs/docs/FishAudioSpeechToText/tr.md b/comfyui_embedded_docs/docs/FishAudioSpeechToText/tr.md new file mode 100644 index 000000000..6c9c24957 --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioSpeechToText/tr.md @@ -0,0 +1,26 @@ +# FishAudioSpeechToText + +Bu düğüm, Fish Audio konuşmadan metne (speech-to-text) hizmetini kullanarak sesi metne dönüştürür. Sesin dilini otomatik olarak algılar ve isteğe bağlı olarak kelime düzeyinde zaman damgalı bölümleri JSON olarak döndürebilir. + +## Girdiler + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +|-----------|-------------|-----------|----------|-------| +| `audio` | Transkribe edilecek ses. | AUDIO | Evet | — | +| `language` | ISO 639-1 dil ipucu (örn. 'en', 'zh'). Dil, bu ipucundan bağımsız olarak otomatik algılanır. Varsayılan: "" (boş dize). | STRING | Hayır | Herhangi bir ISO 639-1 dil kodu, örn. `en`, `zh`; otomatik algılama için boş dize | +| `precise_timestamps` | Kelime düzeyinde zaman damgalı bölümler döndürür. Varsayılan: false. | BOOLEAN | Hayır | true veya false | + +Not: `language` parametresi yalnızca bir ipucudur — dil her zaman sesten otomatik olarak algılanır. `precise_timestamps` false olduğunda (varsayılan), kelime düzeyinde zaman damgaları döndürülmez; true olduğunda, çıktı bölümleri kelime düzeyinde zaman damgalarını içerir. + +## Çıktılar + +| Çıktı Adı | Açıklama | Veri Türü | +|-------------|-------------|-----------| +| `text` | Transkribe edilen metin. | STRING | +| `language_code` | Ses için algılanan ISO 639-1 dil kodu. | STRING | +| `segments_json` | Transkripsiyon bölümlerini içeren JSON dizesi. `precise_timestamps` etkinleştirildiğinde kelime düzeyinde zaman damgalarını içerir. | STRING | + +> Bu belge yapay zeka tarafından oluşturulmuştur. Herhangi bir hata bulursanız veya iyileştirme önerileriniz varsa, katkıda bulunmaktan çekinmeyin! [GitHub'da Düzenle](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioSpeechToText/tr.md) + +--- +**Source fingerprint (SHA-256):** `eaf1c9a9d2b90ec962a408615cc417b552864354c3f272144b8e239b23961920` diff --git a/comfyui_embedded_docs/docs/FishAudioSpeechToText/zh-TW.md b/comfyui_embedded_docs/docs/FishAudioSpeechToText/zh-TW.md new file mode 100644 index 000000000..274687d4c --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioSpeechToText/zh-TW.md @@ -0,0 +1,24 @@ +# FishAudioSpeechToText + +此節點使用 Fish Audio 語音轉文字服務將音訊轉錄為文字。它會自動偵測音訊的語言,並可選擇以 JSON 形式回傳包含字詞級時間戳記的區段。 + +## 輸入 +| 參數 | 描述 | 資料類型 | 必填 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `audio` | 要轉錄的音訊。 | AUDIO | 是 | — | +| `language` | ISO 639-1 語言提示(例如 'en'、'zh')。無論如何,語言都會被自動偵測。預設值:""(空字串)。 | STRING | 否 | 任何 ISO 639-1 語言代碼,例如 `en`、`zh`;空字串表示自動偵測 | +| `precise_timestamps` | 回傳包含字詞級時間戳記的區段。預設值:false。 | BOOLEAN | 否 | true or false | + +注意:`language` 參數僅作為提示——語言一律從音訊中自動偵測。當 `precise_timestamps` 為 false(預設值)時,不會回傳字詞級時間戳記;當為 true 時,輸出區段會包含字詞級時間戳記。 + +## 輸出 +| 輸出名 | 描述 | 資料類型 | +|-------------|-------------|-----------| +| `text` | 轉錄後的文字。 | STRING | +| `language_code` | 偵測到的音訊 ISO 639-1 語言代碼。 | STRING | +| `segments_json` | 包含轉錄區段的 JSON 字串。啟用 `precise_timestamps` 時,會包含字詞級時間戳記。 | STRING | + +> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioSpeechToText/zh-TW.md) + +--- +**Source fingerprint (SHA-256):** `eaf1c9a9d2b90ec962a408615cc417b552864354c3f272144b8e239b23961920` diff --git a/comfyui_embedded_docs/docs/FishAudioSpeechToText/zh.md b/comfyui_embedded_docs/docs/FishAudioSpeechToText/zh.md new file mode 100644 index 000000000..7d0e9fdea --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioSpeechToText/zh.md @@ -0,0 +1,26 @@ +# FishAudioSpeechToText + +此节点使用 Fish Audio 语音转文字服务将音频转录为文本。它会自动检测音频的语言,并可选择返回包含单词级时间戳的片段(JSON 格式)。 + +## 输入 + +| 参数 | 描述 | 数据类型 | 必需 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `audio` | 要转录的音频。 | AUDIO | 是 | — | +| `language` | ISO 639-1 语言提示(如 'en'、'zh')。无论如何都会自动检测语言。默认:""(空字符串)。 | STRING | 否 | 任何 ISO 639-1 语言代码,如 `en`、`zh`;留空表示自动检测 | +| `precise_timestamps` | 返回包含单词级时间戳的片段。默认:false。 | BOOLEAN | 否 | true or false | + +注意:`language` 参数仅作为提示——语言始终会从音频中自动检测。当 `precise_timestamps` 为 false(默认值)时,不会返回单词级时间戳;当为 true 时,输出片段将包含单词级时间戳。 + +## 输出 + +| 输出名称 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `text` | 转录后的文本。 | STRING | +| `language_code` | 检测到的音频 ISO 639-1 语言代码。 | STRING | +| `segments_json` | 包含转录片段的 JSON 字符串。当启用 `precise_timestamps` 时,包含单词级时间戳。 | STRING | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioSpeechToText/zh.md) + +--- +**Source fingerprint (SHA-256):** `eaf1c9a9d2b90ec962a408615cc417b552864354c3f272144b8e239b23961920` diff --git a/comfyui_embedded_docs/docs/FishAudioTextToSpeech/ar.md b/comfyui_embedded_docs/docs/FishAudioTextToSpeech/ar.md new file mode 100644 index 000000000..2964cd4a8 --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioTextToSpeech/ar.md @@ -0,0 +1,52 @@ +# FishAudioTextToSpeech + +هذه العقدة تحوّل النص المكتوب إلى كلام منطوق باستخدام نماذج تحويل النص إلى كلام من Fish Audio. وهي تدعم إشارات المشاعر المضمنة في النص (‎[happy]‎ و‎[whispering]‎ على s2.1-pro؛ و‎(happy)‎ على s1) والحوار متعدد المتحدثين باستخدام وسوم @Voice1/@Voice2 عند توصيل أصوات متعددة. يتوفر نموذجان: s2.1-pro الذي يدعم حتى خمسة أصوات وحوارًا متعدد المتحدثين، وs1 الذي يستخدم صوتًا اختياريًا واحدًا. + +## المدخلات + +### المدخلات العامة + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|-----------|-------------|-----------|----------|-------| +| `text` | النص المراد تحويله إلى كلام. عند توصيل صوتين أو أكثر، حدد تغييرات المتحدث باستخدام @Voice1 و@Voice2 وما إلى ذلك. يجب ألا يكون فارغًا. (الافتراضي: فارغ) | STRING | نعم | أي نص غير فارغ | +| `model` | النموذج المستخدم لتحويل النص إلى كلام. | DYNAMIC_COMBO | نعم | "s2.1-pro"
"s1" | +| `seed` | تتحكم البذرة في ما إذا كان يجب إعادة تشغيل العقدة؛ النتائج غير حتمية بغض النظر عن البذرة. (الافتراضي: 42) | INT | نعم | من 0 إلى 2147483647 | + +### مدخلات s2.1-pro + +تظهر هذه المدخلات عند تحديد نموذج s2.1-pro. + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|-----------|-------------|-----------|----------|-------| +| `voices` | فتحة قابلة للتوسيع: قم بتوصيل من 1 إلى 5 عناصر صوتية (`voice_1`‏, `voice_2`‏, ...). الأصوات المستخدمة في التركيب. اتركها فارغة للصوت الافتراضي. عند وجود صوتين أو أكثر، حدد تغييرات المتحدث في النص باستخدام @Voice1 و@Voice2 وما إلى ذلك. | FISHAUDIO_VOICE | لا | من 0 إلى 5 أصوات | +| `temperature` | التعبيرية. القيم الأعلى تعطي تنوعًا أكبر، والقيم الأقل تعطي اتساقًا أكبر. (الافتراضي: 0.7) | FLOAT | نعم | من 0.0 إلى 1.0 | +| `top_p` | التنوع عبر أخذ العينات النووي (nucleus sampling). (الافتراضي: 0.7) | FLOAT | نعم | من 0.01 إلى 1.0 | +| `speed` | معدل الكلام. 1.0 طبيعي، <1.0 أبطأ، >1.0 أسرع. (الافتراضي: 1.0) | FLOAT | نعم | من 0.5 إلى 2.0 | +| `volume` | ضبط مستوى الصوت بالديسيبل. 0 يعني عدم التغيير. (الافتراضي: 0.0) | FLOAT | نعم | من -10.0 إلى 10.0 | +| `normalize` | تطبيع الأرقام والنصوص للغة الإنجليزية والصينية، مما يحسن استقرار الأرقام والتواريخ. (الافتراضي: true) | BOOLEAN | نعم | true / false | + +### مدخلات s1 + +تظهر هذه المدخلات عند تحديد نموذج s1. + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|-----------|-------------|-----------|----------|-------| +| `voice` | الصوت المستخدم في التركيب. اتركه غير متصل للصوت الافتراضي. | FISHAUDIO_VOICE | لا | صوت اختياري واحد | +| `temperature` | التعبيرية. القيم الأعلى تعطي تنوعًا أكبر، والقيم الأقل تعطي اتساقًا أكبر. (الافتراضي: 0.7) | FLOAT | نعم | من 0.0 إلى 1.0 | +| `top_p` | التنوع عبر أخذ العينات النووي (nucleus sampling). (الافتراضي: 0.7) | FLOAT | نعم | من 0.01 إلى 1.0 | +| `speed` | معدل الكلام. 1.0 طبيعي، <1.0 أبطأ، >1.0 أسرع. (الافتراضي: 1.0) | FLOAT | نعم | من 0.5 إلى 2.0 | +| `volume` | ضبط مستوى الصوت بالديسيبل. 0 يعني عدم التغيير. (الافتراضي: 0.0) | FLOAT | نعم | من -10.0 إلى 10.0 | +| `normalize` | تطبيع الأرقام والنصوص للغة الإنجليزية والصينية، مما يحسن استقرار الأرقام والتواريخ. (الافتراضي: true) | BOOLEAN | نعم | true / false | + +**ملاحظة:** يجب ألا يكون مدخل `text` فارغًا. وسوم المتحدث (@Voice1 و@Voice2 وما إلى ذلك) غير حساسة لحالة الأحرف ويجب أن تشير إلى صوت متصل؛ يؤدي وضع وسم على صوت غير متصل إلى ظهور خطأ. عند توصيل صوتين أو أكثر، يجب أن يشير النص إلى كل صوت متصل مرة واحدة على الأقل، وإلا ستبلغ العقدة بالوسوم المفقودة. على s2.1-pro، يؤدي توصيل 0 أصوات إلى استخدام الصوت الافتراضي، ويستخدم الصوت الواحد ذلك الصوت فقط، ويؤدي توصيل صوتين أو أكثر إلى تفعيل الحوار متعدد المتحدثين. على s1، يُستخدم صوت اختياري واحد، وتركه غير متصل يستخدم الصوت الافتراضي. يمكن وضع إشارات عاطفية في النص: ‎[happy]‎ و‎[whispering]‎ على s2.1-pro، و‎(happy)‎ على s1. + +## المخرجات + +| اسم المخرج | الوصف | نوع البيانات | +|-------------|-------------|-----------| +| `audio` | الكلام المُولَّد كملف صوتي. | AUDIO | + +> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioTextToSpeech/ar.md) + +--- +**Source fingerprint (SHA-256):** `6cc005ae76fc7b60d9399b1b0a3c5de40a6eff47cd6f0f0b73b4212c0270ae29` diff --git a/comfyui_embedded_docs/docs/FishAudioTextToSpeech/en.md b/comfyui_embedded_docs/docs/FishAudioTextToSpeech/en.md new file mode 100644 index 000000000..3d59af916 --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioTextToSpeech/en.md @@ -0,0 +1,52 @@ +# FishAudioTextToSpeech + +This node converts written text into spoken audio using Fish Audio text-to-speech models. It supports emotion cues embedded in the text ([happy], [whispering] on s2.1-pro; (happy) on s1) and multi-speaker dialogue using @Voice1/@Voice2 tags when multiple voices are connected. Two models are available: s2.1-pro, which supports up to five voices and multi-speaker dialogue, and s1, which uses a single optional voice. + +## Inputs + +### Common Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `text` | The text to convert to speech. With two or more voices connected, mark speaker changes with @Voice1, @Voice2, etc. Must not be empty. (default: empty) | STRING | Yes | Any non-empty text | +| `model` | Model to use for text-to-speech. | DYNAMIC_COMBO | Yes | "s2.1-pro"
"s1" | +| `seed` | Seed controls whether the node should re-run; results are non-deterministic regardless of seed. (default: 42) | INT | Yes | 0 to 2147483647 | + +### s2.1-pro Inputs + +These inputs appear when the s2.1-pro model is selected. + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `voices` | Growable slot: connect 1 to 5 voice items (`voice_1`, `voice_2`, ...). Voices for synthesis. Leave empty for the default voice. With two or more voices, mark speaker changes in the text with @Voice1, @Voice2, etc. | FISHAUDIO_VOICE | No | 0 to 5 voices | +| `temperature` | Expressiveness. Higher values are more varied, lower values are more consistent. (default: 0.7) | FLOAT | Yes | 0.0 to 1.0 | +| `top_p` | Diversity via nucleus sampling. (default: 0.7) | FLOAT | Yes | 0.01 to 1.0 | +| `speed` | Speaking rate. 1.0 is normal, <1.0 slower, >1.0 faster. (default: 1.0) | FLOAT | Yes | 0.5 to 2.0 | +| `volume` | Volume adjustment in decibels. 0 is no change. (default: 0.0) | FLOAT | Yes | -10.0 to 10.0 | +| `normalize` | Normalize numbers and text for English and Chinese, improving stability for numbers and dates. (default: true) | BOOLEAN | Yes | true / false | + +### s1 Inputs + +These inputs appear when the s1 model is selected. + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `voice` | Voice for synthesis. Leave unconnected for the default voice. | FISHAUDIO_VOICE | No | Optional single voice | +| `temperature` | Expressiveness. Higher values are more varied, lower values are more consistent. (default: 0.7) | FLOAT | Yes | 0.0 to 1.0 | +| `top_p` | Diversity via nucleus sampling. (default: 0.7) | FLOAT | Yes | 0.01 to 1.0 | +| `speed` | Speaking rate. 1.0 is normal, <1.0 slower, >1.0 faster. (default: 1.0) | FLOAT | Yes | 0.5 to 2.0 | +| `volume` | Volume adjustment in decibels. 0 is no change. (default: 0.0) | FLOAT | Yes | -10.0 to 10.0 | +| `normalize` | Normalize numbers and text for English and Chinese, improving stability for numbers and dates. (default: true) | BOOLEAN | Yes | true / false | + +**Note:** The `text` input must not be empty. Speaker tags (@Voice1, @Voice2, etc.) are case-insensitive and must refer to a connected voice; tagging a voice that is not connected raises an error. When two or more voices are connected, the text must reference every connected voice at least once, or the node reports the missing tags. On s2.1-pro, connecting 0 voices uses the default voice, 1 voice uses that voice alone, and 2 or more voices enable multi-speaker dialogue. On s1, a single optional voice is used and leaving it unconnected uses the default voice. Emotion cues can be placed in the text: [happy] and [whispering] on s2.1-pro, and (happy) on s1. + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `audio` | The generated speech as an audio file. | AUDIO | + +> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioTextToSpeech/en.md) + +--- +**Source fingerprint (SHA-256):** `6cc005ae76fc7b60d9399b1b0a3c5de40a6eff47cd6f0f0b73b4212c0270ae29` diff --git a/comfyui_embedded_docs/docs/FishAudioTextToSpeech/es.md b/comfyui_embedded_docs/docs/FishAudioTextToSpeech/es.md new file mode 100644 index 000000000..f175e0fa9 --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioTextToSpeech/es.md @@ -0,0 +1,52 @@ +# FishAudioTextToSpeech + +Este nodo convierte texto escrito en audio hablado utilizando modelos de conversión de texto a voz de Fish Audio. Admite indicaciones de emoción integradas en el texto ([happy], [whispering] en s2.1-pro; (happy) en s1) y diálogo multi-hablante mediante etiquetas @Voice1/@Voice2 cuando hay varias voces conectadas. Hay dos modelos disponibles: s2.1-pro, que admite hasta cinco voces y diálogo multi-hablante, y s1, que usa una única voz opcional. + +## Entradas + +### Entradas comunes + +| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango | +|-----------|-------------|---------------|-------------|-------| +| `text` | El texto a convertir en voz. Con dos o más voces conectadas, marque los cambios de hablante con @Voice1, @Voice2, etc. No debe estar vacío. (por defecto: vacío) | STRING | Sí | Cualquier texto no vacío | +| `model` | Modelo a utilizar para la conversión de texto a voz. | DYNAMIC_COMBO | Sí | "s2.1-pro"
"s1" | +| `seed` | La semilla controla si el nodo debe volver a ejecutarse; los resultados no son deterministas independientemente de la semilla. (por defecto: 42) | INT | Sí | 0 a 2147483647 | + +### Entradas de s2.1-pro + +Estas entradas aparecen cuando se selecciona el modelo s2.1-pro. + +| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango | +|-----------|-------------|---------------|-------------|-------| +| `voices` | Ranura ampliable: conecte de 1 a 5 elementos de voz (`voice_1`, `voice_2`, ...). Voces para la síntesis. No conecte ninguna para usar la voz predeterminada. Con dos o más voces, marque los cambios de hablante en el texto con @Voice1, @Voice2, etc. | FISHAUDIO_VOICE | No | 0 a 5 voces | +| `temperature` | Expresividad. Los valores más altos son más variados; los más bajos, más consistentes. (por defecto: 0.7) | FLOAT | Sí | 0.0 a 1.0 | +| `top_p` | Diversidad mediante muestreo de núcleo. (por defecto: 0.7) | FLOAT | Sí | 0.01 a 1.0 | +| `speed` | Velocidad del habla. 1.0 es normal, <1.0 más lento, >1.0 más rápido. (por defecto: 1.0) | FLOAT | Sí | 0.5 a 2.0 | +| `volume` | Ajuste de volumen en decibelios. 0 significa sin cambios. (por defecto: 0.0) | FLOAT | Sí | -10.0 a 10.0 | +| `normalize` | Normaliza números y texto en inglés y chino, mejorando la estabilidad de números y fechas. (por defecto: true) | BOOLEAN | Sí | true / false | + +### Entradas de s1 + +Estas entradas aparecen cuando se selecciona el modelo s1. + +| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango | +|-----------|-------------|---------------|-------------|-------| +| `voice` | Voz para la síntesis. Déjela sin conectar para usar la voz predeterminada. | FISHAUDIO_VOICE | No | Una sola voz opcional | +| `temperature` | Expresividad. Los valores más altos son más variados; los más bajos, más consistentes. (por defecto: 0.7) | FLOAT | Sí | 0.0 a 1.0 | +| `top_p` | Diversidad mediante muestreo de núcleo. (por defecto: 0.7) | FLOAT | Sí | 0.01 a 1.0 | +| `speed` | Velocidad del habla. 1.0 es normal, <1.0 más lento, >1.0 más rápido. (por defecto: 1.0) | FLOAT | Sí | 0.5 a 2.0 | +| `volume` | Ajuste de volumen en decibelios. 0 significa sin cambios. (por defecto: 0.0) | FLOAT | Sí | -10.0 a 10.0 | +| `normalize` | Normaliza números y texto en inglés y chino, mejorando la estabilidad de números y fechas. (por defecto: true) | BOOLEAN | Sí | true / false | + +**Nota:** La entrada `text` no debe estar vacía. Las etiquetas de hablante (@Voice1, @Voice2, etc.) no distinguen entre mayúsculas y minúsculas y deben hacer referencia a una voz conectada; etiquetar una voz que no está conectada genera un error. Cuando hay dos o más voces conectadas, el texto debe hacer referencia al menos una vez a cada voz conectada; de lo contrario, el nodo informa de las etiquetas faltantes. En s2.1-pro, conectar 0 voces usa la voz predeterminada; con 1 voz se usa solo esa voz; y con 2 o más voces se habilita el diálogo multi-hablante. En s1, se usa una única voz opcional; si se deja sin conectar, se usa la voz predeterminada. Las indicaciones de emoción pueden colocarse en el texto: [happy] y [whispering] en s2.1-pro, y (happy) en s1. + +## Salidas + +| Nombre de salida | Descripción | Tipo de datos | +|------------------|-------------|---------------| +| `audio` | El habla generada como archivo de audio. | AUDIO | + +> Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioTextToSpeech/es.md) + +--- +**Source fingerprint (SHA-256):** `6cc005ae76fc7b60d9399b1b0a3c5de40a6eff47cd6f0f0b73b4212c0270ae29` diff --git a/comfyui_embedded_docs/docs/FishAudioTextToSpeech/fa.md b/comfyui_embedded_docs/docs/FishAudioTextToSpeech/fa.md new file mode 100644 index 000000000..9c92caa15 --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioTextToSpeech/fa.md @@ -0,0 +1,52 @@ +# FishAudioTextToSpeech + +این گره متن نوشته‌شده را با استفاده از مدل‌های تبدیل متن به گفتار Fish Audio به گفتار تبدیل می‌کند. این گره از نشانه‌های هیجانی تعبیه‌شده در متن ([happy] و [whispering] در s2.1-pro؛ (happy) در s1) و گفتگوی چندگوینده با استفاده از برچسب‌های @Voice1/@Voice2 هنگامی که چند صدا متصل شده‌اند پشتیبانی می‌کند. دو مدل در دسترس است: s2.1-pro که تا پنج صدا و گفتگوی چندگوینده را پشتیبانی می‌کند، و s1 که از یک صدای اختیاری واحد استفاده می‌کند. + +## ورودی‌ها + +### ورودی‌های مشترک + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `text` | متنی که به گفتار تبدیل می‌شود. وقتی دو یا چند صدا متصل باشند، تغییر گوینده را با @Voice1، @Voice2 و غیره مشخص کنید. نباید خالی باشد. (پیش‌فرض: خالی) | STRING | بله | هر متن غیرخالی | +| `model` | مدل مورد استفاده برای تبدیل متن به گفتار. | DYNAMIC_COMBO | بله | "s2.1-pro"
"s1" | +| `seed` | مقدار seed مشخص می‌کند که آیا گره دوباره اجرا شود؛ نتایج بدون توجه به seed غیرقطعی هستند. (پیش‌فرض: 42) | INT | بله | 0 تا 2147483647 | + +### ورودی‌های s2.1-pro + +این ورودی‌ها زمانی ظاهر می‌شوند که مدل s2.1-pro انتخاب شده باشد. + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `voices` | اسلات قابل‌توسعه: 1 تا 5 آیتم صوتی را متصل کنید (`voice_1`، `voice_2`، ...). صداهای مورد استفاده برای سنتز. برای صدای پیش‌فرض خالی بگذارید. با دو یا چند صدا، تغییر گوینده را در متن با @Voice1، @Voice2 و غیره مشخص کنید. | FISHAUDIO_VOICE | خیر | 0 تا 5 صدا | +| `temperature` | بیانگری. مقادیر بالاتر متنوع‌تر و مقادیر پایین‌تر سازگارتر هستند. (پیش‌فرض: 0.7) | FLOAT | بله | 0.0 تا 1.0 | +| `top_p` | تنوع از طریق نمونه‌گیری هسته‌ای (nucleus sampling). (پیش‌فرض: 0.7) | FLOAT | بله | 0.01 تا 1.0 | +| `speed` | سرعت گفتار. 1.0 نرمال، <1.0 کندتر، >1.0 سریع‌تر است. (پیش‌فرض: 1.0) | FLOAT | بله | 0.5 تا 2.0 | +| `volume` | تنظیم بلندی صدا بر حسب دسی‌بل. 0 به معنای بدون تغییر است. (پیش‌فرض: 0.0) | FLOAT | بله | -10.0 تا 10.0 | +| `normalize` | اعداد و متن را برای انگلیسی و چینی نرمال‌سازی می‌کند و پایداری اعداد و تاریخ‌ها را بهبود می‌بخشد. (پیش‌فرض: true) | BOOLEAN | بله | true / false | + +### ورودی‌های s1 + +این ورودی‌ها زمانی ظاهر می‌شوند که مدل s1 انتخاب شده باشد. + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `voice` | صدا برای سنتز. برای استفاده از صدای پیش‌فرض، آن را متصل نکنید. | FISHAUDIO_VOICE | خیر | یک صدای اختیاری | +| `temperature` | بیانگری. مقادیر بالاتر متنوع‌تر و مقادیر پایین‌تر سازگارتر هستند. (پیش‌فرض: 0.7) | FLOAT | بله | 0.0 تا 1.0 | +| `top_p` | تنوع از طریق نمونه‌گیری هسته‌ای (nucleus sampling). (پیش‌فرض: 0.7) | FLOAT | بله | 0.01 تا 1.0 | +| `speed` | سرعت گفتار. 1.0 نرمال، <1.0 کندتر، >1.0 سریع‌تر است. (پیش‌فرض: 1.0) | FLOAT | بله | 0.5 تا 2.0 | +| `volume` | تنظیم بلندی صدا بر حسب دسی‌بل. 0 به معنای بدون تغییر است. (پیش‌فرض: 0.0) | FLOAT | بله | -10.0 تا 10.0 | +| `normalize` | اعداد و متن را برای انگلیسی و چینی نرمال‌سازی می‌کند و پایداری اعداد و تاریخ‌ها را بهبود می‌بخشد. (پیش‌فرض: true) | BOOLEAN | بله | true / false | + +**نکته:** ورودی `text` نباید خالی باشد. برچسب‌های گوینده (@Voice1، @Voice2 و غیره) به حروف بزرگ و کوچک حساس نیستند و باید به صدای متصل اشاره کنند؛ برچسب‌گذاری صدایی که متصل نیست باعث بروز خطا می‌شود. وقتی دو یا چند صدا متصل باشند، متن باید حداقل یک بار به هر صدای متصل اشاره کند؛ در غیر این صورت گره برچسب‌های جاافتاده را گزارش می‌دهد. در s2.1-pro، اتصال نداشتن صدا به معنای استفاده از صدای پیش‌فرض است، اتصال یک صدا باعث استفاده از همان صدا به تنهایی می‌شود، و اتصال دو صدا یا بیشتر گفتگوی چندگوینده را فعال می‌کند. در s1، یک صدای اختیاری استفاده می‌شود و خالی گذاشتن آن به معنای استفاده از صدای پیش‌فرض است. نشانه‌های هیجانی را می‌توان در متن قرار داد: [happy] و [whispering] در s2.1-pro و (happy) در s1. + +## خروجی‌ها + +| نام خروجی | توضیحات | نوع داده | +|-------------|-------------|-----------| +| `audio` | گفتار تولیدشده به‌صورت یک فایل صوتی. | AUDIO | + +> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioTextToSpeech/fa.md) + +--- +**Source fingerprint (SHA-256):** `6cc005ae76fc7b60d9399b1b0a3c5de40a6eff47cd6f0f0b73b4212c0270ae29` diff --git a/comfyui_embedded_docs/docs/FishAudioTextToSpeech/fr.md b/comfyui_embedded_docs/docs/FishAudioTextToSpeech/fr.md new file mode 100644 index 000000000..2949dd60b --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioTextToSpeech/fr.md @@ -0,0 +1,52 @@ +# FishAudioTextToSpeech + +Ce nœud convertit le texte écrit en audio parlé en utilisant les modèles de synthèse vocale Fish Audio. Il prend en charge les indices d'émotion intégrés dans le texte ([happy], [whispering] sur s2.1-pro ; (happy) sur s1) et le dialogue multi-locuteur à l'aide des balises @Voice1/@Voice2 lorsque plusieurs voix sont connectées. Deux modèles sont disponibles : s2.1-pro, qui prend en charge jusqu'à cinq voix et le dialogue multi-locuteur, et s1, qui utilise une seule voix facultative. + +## Entrées + +### Entrées communes + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `text` | Le texte à convertir en parole. Avec deux voix ou plus connectées, marquez les changements de locuteur avec @Voice1, @Voice2, etc. Ne doit pas être vide. (défaut : vide) | STRING | Oui | Any non-empty text | +| `model` | Modèle à utiliser pour la synthèse vocale. | DYNAMIC_COMBO | Oui | "s2.1-pro"
"s1" | +| `seed` | La graine (seed) contrôle si le nœud doit s'exécuter à nouveau ; les résultats sont non déterministes quelle que soit la graine. (défaut : 42) | INT | Oui | 0 to 2147483647 | + +### Entrées s2.1-pro + +Ces entrées apparaissent lorsque le modèle s2.1-pro est sélectionné. + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `voices` | Emplacement extensible : connectez 1 à 5 éléments de voix (`voice_1`, `voice_2`, ...). Voix pour la synthèse. Laissez vide pour la voix par défaut. Avec deux voix ou plus, marquez les changements de locuteur dans le texte avec @Voice1, @Voice2, etc. | FISHAUDIO_VOICE | Non | 0 to 5 voices | +| `temperature` | Expressivité. Des valeurs plus élevées donnent des résultats plus variés, des valeurs plus faibles sont plus cohérentes. (défaut : 0.7) | FLOAT | Oui | 0.0 to 1.0 | +| `top_p` | Diversité via l'échantillonnage par noyau (nucleus sampling). (défaut : 0.7) | FLOAT | Oui | 0.01 to 1.0 | +| `speed` | Débit de parole. 1.0 est normal, <1.0 plus lent, >1.0 plus rapide. (défaut : 1.0) | FLOAT | Oui | 0.5 to 2.0 | +| `volume` | Réglage du volume en décibels. 0 correspond à aucun changement. (défaut : 0.0) | FLOAT | Oui | -10.0 to 10.0 | +| `normalize` | Normalise les nombres et le texte pour l'anglais et le chinois, améliorant la stabilité des nombres et des dates. (défaut : true) | BOOLEAN | Oui | true / false | + +### Entrées s1 + +Ces entrées apparaissent lorsque le modèle s1 est sélectionné. + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `voice` | Voix pour la synthèse. Laissez non connecté pour la voix par défaut. | FISHAUDIO_VOICE | Non | Optional single voice | +| `temperature` | Expressivité. Des valeurs plus élevées donnent des résultats plus variés, des valeurs plus faibles sont plus cohérentes. (défaut : 0.7) | FLOAT | Oui | 0.0 to 1.0 | +| `top_p` | Diversité via l'échantillonnage par noyau (nucleus sampling). (défaut : 0.7) | FLOAT | Oui | 0.01 to 1.0 | +| `speed` | Débit de parole. 1.0 est normal, <1.0 plus lent, >1.0 plus rapide. (défaut : 1.0) | FLOAT | Oui | 0.5 to 2.0 | +| `volume` | Réglage du volume en décibels. 0 correspond à aucun changement. (défaut : 0.0) | FLOAT | Oui | -10.0 to 10.0 | +| `normalize` | Normalise les nombres et le texte pour l'anglais et le chinois, améliorant la stabilité des nombres et des dates. (défaut : true) | BOOLEAN | Oui | true / false | + +**Remarque :** L'entrée `text` ne doit pas être vide. Les balises de locuteur (@Voice1, @Voice2, etc.) sont insensibles à la casse et doivent faire référence à une voix connectée ; marquer une voix qui n'est pas connectée génère une erreur. Lorsque deux voix ou plus sont connectées, le texte doit référencer chaque voix connectée au moins une fois, sinon le nœud signale les balises manquantes. Sur s2.1-pro, connecter 0 voix utilise la voix par défaut, 1 voix utilise cette voix seule, et 2 voix ou plus activent le dialogue multi-locuteur. Sur s1, une seule voix facultative est utilisée et la laisser non connectée utilise la voix par défaut. Les indices d'émotion peuvent être placés dans le texte : [happy] et [whispering] sur s2.1-pro, et (happy) sur s1. + +## Sorties + +| Nom de sortie | Description | Type de données | +|---------------|-------------|-----------------| +| `audio` | La parole générée sous forme de fichier audio. | AUDIO | + +> Cette documentation a été générée par IA. Si vous trouvez des erreurs ou avez des suggestions d'amélioration, n'hésitez pas à contribuer ! [Modifier sur GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioTextToSpeech/fr.md) + +--- +**Source fingerprint (SHA-256):** `6cc005ae76fc7b60d9399b1b0a3c5de40a6eff47cd6f0f0b73b4212c0270ae29` diff --git a/comfyui_embedded_docs/docs/FishAudioTextToSpeech/ja.md b/comfyui_embedded_docs/docs/FishAudioTextToSpeech/ja.md new file mode 100644 index 000000000..f0f8e7354 --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioTextToSpeech/ja.md @@ -0,0 +1,50 @@ +# FishAudioTextToSpeech + +## 入力 + +### 共通入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `text` | 読み上げるテキスト。2つ以上のボイスを接続する場合は、@Voice1、@Voice2 などで話者変更を指定します。空にすることはできません。(デフォルト:空) | STRING | はい | 空でない任意のテキスト | +| `model` | テキスト読み上げに使用するモデル。 | DYNAMIC_COMBO | はい | "s2.1-pro"
"s1" | +| `seed` | シードはノードを再実行するかどうかを制御します。シードに関係なく結果は非決定的です。(デフォルト:42) | INT | はい | 0 to 2147483647 | + +### s2.1-pro 入力 + +これらの入力は、s2.1-pro モデルが選択されている場合に表示されます。 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `voices` | 拡張可能スロット:1~5個のボイスアイテム(`voice_1`、`voice_2`、...)を接続します。合成に使用するボイスです。デフォルトのボイスを使用する場合は空のままにします。2つ以上のボイスを接続する場合は、テキスト内の話者変更を @Voice1、@Voice2 などで指定します。 | FISHAUDIO_VOICE | いいえ | 0~5ボイス | +| `temperature` | 表現力。値が高いほど多様になり、低いほど一貫性が高まります。(デフォルト:0.7) | FLOAT | はい | 0.0 to 1.0 | +| `top_p` | 多様性(ニュークリアス・サンプリングによる)。(デフォルト:0.7) | FLOAT | はい | 0.01 to 1.0 | +| `speed` | 話す速度。1.0が通常で、<1.0は遅く、>1.0は速くなります。(デフォルト:1.0) | FLOAT | はい | 0.5 to 2.0 | +| `volume` | 音量調整(デシベル単位)。0は変更なしです。(デフォルト:0.0) | FLOAT | はい | -10.0 to 10.0 | +| `normalize` | 英語と中国語の数字とテキストを正規化し、数字と日付の安定性を向上させます。(デフォルト:true) | BOOLEAN | はい | true / false | + +### s1 入力 + +これらの入力は、s1 モデルが選択されている場合に表示されます。 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `voice` | 合成に使用するボイス。デフォルトのボイスを使用する場合は未接続のままにします。 | FISHAUDIO_VOICE | いいえ | オプションの単一ボイス | +| `temperature` | 表現力。値が高いほど多様になり、低いほど一貫性が高まります。(デフォルト:0.7) | FLOAT | はい | 0.0 to 1.0 | +| `top_p` | 多様性(ニュークリアス・サンプリングによる)。(デフォルト:0.7) | FLOAT | はい | 0.01 to 1.0 | +| `speed` | 話す速度。1.0が通常で、<1.0は遅く、>1.0は速くなります。(デフォルト:1.0) | FLOAT | はい | 0.5 to 2.0 | +| `volume` | 音量調整(デシベル単位)。0は変更なしです。(デフォルト:0.0) | FLOAT | はい | -10.0 to 10.0 | +| `normalize` | 英語と中国語の数字とテキストを正規化し、数字と日付の安定性を向上させます。(デフォルト:true) | BOOLEAN | はい | true / false | + +**注記:** `text` 入力は空にできません。話者タグ(@Voice1、@Voice2 など)は大文字と小文字を区別せず、接続されているボイスを参照する必要があります。接続されていないボイスをタグ指定するとエラーが発生します。2つ以上のボイスが接続されている場合、テキストは接続されているすべてのボイスを少なくとも1回は参照する必要があり、そうしないとノードは不足しているタグを報告します。s2.1-pro では、ボイスを0個接続するとデフォルトのボイスが使用され、1個の場合はそのボイスのみが使用され、2個以上で複数話者ダイアログが有効になります。s1 では、オプションの単一ボイスが使用され、未接続の場合はデフォルトのボイスが使用されます。感情表現はテキスト内に配置できます。s2.1-pro では [happy] と [whispering]、s1 では (happy) です。 + +## 出力 + +| 出力名 | 説明 | データ型 | +|-------------|-------------|-----------| +| `audio` | 生成された音声ファイルです。 | AUDIO | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioTextToSpeech/ja.md) + +--- +**Source fingerprint (SHA-256):** `6cc005ae76fc7b60d9399b1b0a3c5de40a6eff47cd6f0f0b73b4212c0270ae29` diff --git a/comfyui_embedded_docs/docs/FishAudioTextToSpeech/ko.md b/comfyui_embedded_docs/docs/FishAudioTextToSpeech/ko.md new file mode 100644 index 000000000..d490d5db0 --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioTextToSpeech/ko.md @@ -0,0 +1,52 @@ +# FishAudioTextToSpeech + +이 노드는 Fish Audio 텍스트 음성 변환 모델을 사용하여 작성된 텍스트를 음성 오디오로 변환합니다. 텍스트에 포함된 감정 큐(s2.1-pro에서는 `[happy]`, `[whispering]`, s1에서는 `(happy)`)와 여러 음성이 연결된 경우 `@Voice1`/`@Voice2` 태그를 사용한 다중 화자 대화를 지원합니다. 사용 가능한 모델은 두 가지입니다. 최대 5개 음성과 다중 화자 대화를 지원하는 s2.1-pro, 단일 선택적 음성을 사용하는 s1입니다. + +## 입력 + +### 공통 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `text` | 음성으로 변환할 텍스트입니다. 두 개 이상의 음성이 연결된 경우 `@Voice1`, `@Voice2` 등으로 화자 변경을 표시하세요. 비어 있으면 안 됩니다. (기본값: 빈 문자열) | STRING | 예 | Any non-empty text | +| `model` | 텍스트 음성 변환에 사용할 모델입니다. | DYNAMIC_COMBO | 예 | "s2.1-pro"
"s1" | +| `seed` | 시드는 노드 재실행 여부를 제어합니다. 시드와 관계없이 결과는 비결정적입니다. (기본값: 42) | INT | 예 | 0 to 2147483647 | + +### s2.1-pro 입력 + +이 입력은 s2.1-pro 모델이 선택된 경우 나타납니다. + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `voices` | 확장 가능 슬롯: 1~5개의 음성 항목(`voice_1`, `voice_2`, ...)을 연결하세요. 합성에 사용할 음성입니다. 기본 음성을 사용하려면 비워 두세요. 두 개 이상의 음성이 있으면 텍스트에서 `@Voice1`, `@Voice2` 등으로 화자 변경을 표시하세요. | FISHAUDIO_VOICE | 아니요 | 0 to 5 voices | +| `temperature` | 표현력입니다. 값이 높을수록 다양하고, 낮을수록 일관적입니다. (기본값: 0.7) | FLOAT | 예 | 0.0 to 1.0 | +| `top_p` | 핵 샘플링을 통한 다양성입니다. (기본값: 0.7) | FLOAT | 예 | 0.01 to 1.0 | +| `speed` | 말하기 속도입니다. 1.0은 보통, <1.0은 느림, >1.0은 빠름입니다. (기본값: 1.0) | FLOAT | 예 | 0.5 to 2.0 | +| `volume` | 데시벨 단위 볼륨 조정입니다. 0은 변경 없음입니다. (기본값: 0.0) | FLOAT | 예 | -10.0 to 10.0 | +| `normalize` | 영어와 중국어에 대해 숫자와 텍스트를 정규화하여 숫자와 날짜의 안정성을 향상시킵니다. (기본값: true) | BOOLEAN | 예 | true / false | + +### s1 입력 + +이 입력은 s1 모델이 선택된 경우 나타납니다. + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `voice` | 합성에 사용할 음성입니다. 기본 음성을 사용하려면 연결하지 않은 채로 두세요. | FISHAUDIO_VOICE | 아니요 | Optional single voice | +| `temperature` | 표현력입니다. 값이 높을수록 다양하고, 낮을수록 일관적입니다. (기본값: 0.7) | FLOAT | 예 | 0.0 to 1.0 | +| `top_p` | 핵 샘플링을 통한 다양성입니다. (기본값: 0.7) | FLOAT | 예 | 0.01 to 1.0 | +| `speed` | 말하기 속도입니다. 1.0은 보통, <1.0은 느림, >1.0은 빠름입니다. (기본값: 1.0) | FLOAT | 예 | 0.5 to 2.0 | +| `volume` | 데시벨 단위 볼륨 조정입니다. 0은 변경 없음입니다. (기본값: 0.0) | FLOAT | 예 | -10.0 to 10.0 | +| `normalize` | 영어와 중국어에 대해 숫자와 텍스트를 정규화하여 숫자와 날짜의 안정성을 향상시킵니다. (기본값: true) | BOOLEAN | 예 | true / false | + +**참고:** `text` 입력은 비어 있으면 안 됩니다. 화자 태그(`@Voice1`, `@Voice2` 등)는 대소문자를 구분하지 않으며 연결된 음성을 참조해야 합니다. 연결되지 않은 음성을 태그하면 오류가 발생합니다. 두 개 이상의 음성이 연결된 경우 텍스트는 연결된 모든 음성을 각각 한 번 이상 참조해야 하며, 그렇지 않으면 노드가 누락된 태그를 보고합니다. s2.1-pro에서는 음성 0개를 연결하면 기본 음성이 사용되고, 1개를 연결하면 해당 음성만 사용되며, 2개 이상을 연결하면 다중 화자 대화가 활성화됩니다. s1에서는 선택적 단일 음성이 사용되며, 연결하지 않으면 기본 음성이 사용됩니다. 감정 큐는 텍스트에 배치할 수 있습니다: s2.1-pro에서는 `[happy]` 및 `[whispering]`, s1에서는 `(happy)`입니다. + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `audio` | 생성된 음성이 포함된 오디오 파일입니다. | AUDIO | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioTextToSpeech/ko.md) + +--- +**Source fingerprint (SHA-256):** `6cc005ae76fc7b60d9399b1b0a3c5de40a6eff47cd6f0f0b73b4212c0270ae29` diff --git a/comfyui_embedded_docs/docs/FishAudioTextToSpeech/pt-BR.md b/comfyui_embedded_docs/docs/FishAudioTextToSpeech/pt-BR.md new file mode 100644 index 000000000..66f123735 --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioTextToSpeech/pt-BR.md @@ -0,0 +1,52 @@ +# FishAudioTextToSpeech + +Este nó converte texto escrito em áudio falado usando os modelos de texto para fala do Fish Audio. Ele suporta dicas de emoção incorporadas no texto ([happy], [whispering] no s2.1-pro; (happy) no s1) e diálogo com vários falantes usando tags @Voice1/@Voice2 quando várias vozes estão conectadas. Dois modelos estão disponíveis: s2.1-pro, que suporta até cinco vozes e diálogo com vários falantes, e s1, que usa uma única voz opcional. + +## Entradas + +### Entradas Comuns + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | +|-----------|-------------|-----------|----------|-------| +| `text` | O texto a ser convertido em fala. Com duas ou mais vozes conectadas, marque as mudanças de falante com @Voice1, @Voice2, etc. Não pode estar vazio. (padrão: vazio) | STRING | Sim | Qualquer texto não vazio | +| `model` | Modelo a ser usado para conversão de texto em fala. | DYNAMIC_COMBO | Sim | "s2.1-pro"
"s1" | +| `seed` | A semente controla se o nó deve ser executado novamente; os resultados não são determinísticos independentemente da semente. (padrão: 42) | INT | Sim | 0 a 2147483647 | + +### Entradas do s2.1-pro + +Estas entradas aparecem quando o modelo s2.1-pro é selecionado. + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | +|-----------|-------------|-----------|----------|-------| +| `voices` | Slot expansível: conecte de 1 a 5 itens de voz (`voice_1`, `voice_2`, ...). Vozes para síntese. Deixe vazio para usar a voz padrão. Com duas ou mais vozes, marque as mudanças de falante no texto com @Voice1, @Voice2, etc. | FISHAUDIO_VOICE | Não | 0 a 5 vozes | +| `temperature` | Expressividade. Valores mais altos são mais variados, valores mais baixos são mais consistentes. (padrão: 0.7) | FLOAT | Sim | 0.0 a 1.0 | +| `top_p` | Diversidade por amostragem de núcleo. (padrão: 0.7) | FLOAT | Sim | 0.01 a 1.0 | +| `speed` | Velocidade de fala. 1.0 é normal, <1.0 mais lento, >1.0 mais rápido. (padrão: 1.0) | FLOAT | Sim | 0.5 a 2.0 | +| `volume` | Ajuste de volume em decibéis. 0 significa nenhuma alteração. (padrão: 0.0) | FLOAT | Sim | -10.0 a 10.0 | +| `normalize` | Normaliza números e texto para inglês e chinês, melhorando a estabilidade de números e datas. (padrão: true) | BOOLEAN | Sim | true / false | + +### Entradas do s1 + +Estas entradas aparecem quando o modelo s1 é selecionado. + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | +|-----------|-------------|-----------|----------|-------| +| `voice` | Voz para síntese. Deixe desconectado para usar a voz padrão. | FISHAUDIO_VOICE | Não | Voz única opcional | +| `temperature` | Expressividade. Valores mais altos são mais variados, valores mais baixos são mais consistentes. (padrão: 0.7) | FLOAT | Sim | 0.0 a 1.0 | +| `top_p` | Diversidade por amostragem de núcleo. (padrão: 0.7) | FLOAT | Sim | 0.01 a 1.0 | +| `speed` | Velocidade de fala. 1.0 é normal, <1.0 mais lento, >1.0 mais rápido. (padrão: 1.0) | FLOAT | Sim | 0.5 a 2.0 | +| `volume` | Ajuste de volume em decibéis. 0 significa nenhuma alteração. (padrão: 0.0) | FLOAT | Sim | -10.0 a 10.0 | +| `normalize` | Normaliza números e texto para inglês e chinês, melhorando a estabilidade de números e datas. (padrão: true) | BOOLEAN | Sim | true / false | + +**Observação:** A entrada `text` não pode estar vazia. As tags de falante (@Voice1, @Voice2, etc.) não diferenciam maiúsculas de minúsculas e devem se referir a uma voz conectada; marcar uma voz que não está conectada gera um erro. Quando duas ou mais vozes estão conectadas, o texto deve referenciar cada voz conectada pelo menos uma vez, caso contrário, o nó relata as tags ausentes. No s2.1-pro, conectar 0 vozes usa a voz padrão, 1 voz usa essa voz sozinha, e 2 ou mais vozes permitem diálogo com vários falantes. No s1, uma única voz opcional é usada e deixá-la desconectada usa a voz padrão. Dicas de emoção podem ser colocadas no texto: [happy] e [whispering] no s2.1-pro, e (happy) no s1. + +## Saídas + +| Nome da Saída | Descrição | Tipo de Dados | +|-------------|-------------|-----------| +| `audio` | A fala gerada como um arquivo de áudio. | AUDIO | + +> Esta documentação foi gerada por IA. Se você encontrar erros ou tiver sugestões de melhoria, sinta-se à vontade para contribuir! [Editar no GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioTextToSpeech/pt-BR.md) + +--- +**Source fingerprint (SHA-256):** `6cc005ae76fc7b60d9399b1b0a3c5de40a6eff47cd6f0f0b73b4212c0270ae29` diff --git a/comfyui_embedded_docs/docs/FishAudioTextToSpeech/ru.md b/comfyui_embedded_docs/docs/FishAudioTextToSpeech/ru.md new file mode 100644 index 000000000..a264b8764 --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioTextToSpeech/ru.md @@ -0,0 +1,52 @@ +# FishAudioTextToSpeech + +Этот узел преобразует письменный текст в устную речь с помощью моделей text-to-speech Fish Audio. Он поддерживает эмоциональные подсказки, встроенные в текст ([happy], [whispering] на s2.1-pro; (happy) на s1), и многоголосый диалог с использованием тегов @Voice1/@Voice2 при подключении нескольких голосов. Доступны две модели: s2.1-pro, которая поддерживает до пяти голосов и многоголосый диалог, и s1, которая использует один необязательный голос. + +## Входы + +### Общие входы + +| Параметр | Описание | Тип данных | Обязательно | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `text` | Текст для преобразования в речь. При подключении двух и более голосов помечайте смену говорящего с помощью @Voice1, @Voice2 и т.д. Не должен быть пустым. (по умолчанию: пусто) | STRING | Да | Любой непустой текст | +| `model` | Модель для синтеза речи. | DYNAMIC_COMBO | Да | "s2.1-pro"
"s1" | +| `seed` | Сид управляет тем, должен ли узел выполняться заново; результаты недетерминированы независимо от сида. (по умолчанию: 42) | INT | Да | от 0 до 2147483647 | + +### Входы s2.1-pro + +Эти входы появляются при выборе модели s2.1-pro. + +| Параметр | Описание | Тип данных | Обязательно | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `voices` | Расширяемый слот: подключите от 1 до 5 голосовых элементов (`voice_1`, `voice_2`, ...). Голоса для синтеза. Оставьте пустым для использования голоса по умолчанию. При двух и более голосах помечайте смену говорящего в тексте с помощью @Voice1, @Voice2 и т.д. | FISHAUDIO_VOICE | Нет | от 0 до 5 голосов | +| `temperature` | Выразительность. Более высокие значения дают больше разнообразия, более низкие — большую стабильность. (по умолчанию: 0.7) | FLOAT | Да | от 0.0 до 1.0 | +| `top_p` | Разнообразие за счёт nucleus-сэмплинга. (по умолчанию: 0.7) | FLOAT | Да | от 0.01 до 1.0 | +| `speed` | Скорость речи. 1.0 — нормальная, <1.0 — медленнее, >1.0 — быстрее. (по умолчанию: 1.0) | FLOAT | Да | от 0.5 до 2.0 | +| `volume` | Регулировка громкости в децибелах. 0 — без изменений. (по умолчанию: 0.0) | FLOAT | Да | от -10.0 до 10.0 | +| `normalize` | Нормализует числа и текст для английского и китайского языков, повышая стабильность для чисел и дат. (по умолчанию: true) | BOOLEAN | Да | true / false | + +### Входы s1 + +Эти входы появляются при выборе модели s1. + +| Параметр | Описание | Тип данных | Обязательно | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `voice` | Голос для синтеза. Оставьте неподключённым, чтобы использовать голос по умолчанию. | FISHAUDIO_VOICE | Нет | Один необязательный голос | +| `temperature` | Выразительность. Более высокие значения дают больше разнообразия, более низкие — большую стабильность. (по умолчанию: 0.7) | FLOAT | Да | от 0.0 до 1.0 | +| `top_p` | Разнообразие за счёт nucleus-сэмплинга. (по умолчанию: 0.7) | FLOAT | Да | от 0.01 до 1.0 | +| `speed` | Скорость речи. 1.0 — нормальная, <1.0 — медленнее, >1.0 — быстрее. (по умолчанию: 1.0) | FLOAT | Да | от 0.5 до 2.0 | +| `volume` | Регулировка громкости в децибелах. 0 — без изменений. (по умолчанию: 0.0) | FLOAT | Да | от -10.0 до 10.0 | +| `normalize` | Нормализует числа и текст для английского и китайского языков, повышая стабильность для чисел и дат. (по умолчанию: true) | BOOLEAN | Да | true / false | + +**Примечание:** Вход `text` не должен быть пустым. Теги говорящих (@Voice1, @Voice2 и т.д.) нечувствительны к регистру и должны ссылаться на подключённый голос; указание тега неподключённого голоса вызывает ошибку. Если подключено два или более голосов, текст должен ссылаться на каждый подключённый голос хотя бы один раз, иначе узел сообщит об отсутствующих тегах. На s2.1-pro при подключении 0 голосов используется голос по умолчанию, 1 голос — только этот голос, а 2 и более голосов включают многоголосый диалог. На s1 используется один необязательный голос; если он не подключён, применяется голос по умолчанию. Эмоциональные подсказки можно размещать в тексте: [happy] и [whispering] на s2.1-pro, и (happy) на s1. + +## Выходы + +| Имя выхода | Описание | Тип данных | +|-------------|-------------|-----------| +| `audio` | Сгенерированная речь в виде аудиофайла. | AUDIO | + +> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioTextToSpeech/ru.md) + +--- +**Source fingerprint (SHA-256):** `6cc005ae76fc7b60d9399b1b0a3c5de40a6eff47cd6f0f0b73b4212c0270ae29` diff --git a/comfyui_embedded_docs/docs/FishAudioTextToSpeech/tr.md b/comfyui_embedded_docs/docs/FishAudioTextToSpeech/tr.md new file mode 100644 index 000000000..b07b21ee9 --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioTextToSpeech/tr.md @@ -0,0 +1,52 @@ +# FishAudioTextToSpeech + +Bu düğüm, Fish Audio metin-ses sentezi modellerini kullanarak yazılı metni sese dönüştürür. Metin içine gömülü duygu ipuçlarını ([happy], [whispering] s2.1-pro'da; (happy) s1'de) ve birden fazla ses bağlandığında @Voice1/@Voice2 etiketlerini kullanarak çok konuşmacılı diyaloğu destekler. İki model mevcuttur: en fazla beş sesi ve çok konuşmacılı diyaloğu destekleyen s2.1-pro ile tek bir isteğe bağlı ses kullanan s1. + +## Girdiler + +### Ortak Girdiler + +| Parametre | Açıklama | Veri Türü | Zorunlu | Aralık | +|-----------|-------------|-----------|----------|-------| +| `text` | Sese dönüştürülecek metin. İki veya daha fazla ses bağlıyken, konuşmacı değişikliklerini @Voice1, @Voice2 vb. ile işaretleyin. Boş olmamalıdır. (varsayılan: boş) | STRING | Evet | Boş olmayan herhangi bir metin | +| `model` | Metin-ses sentezi için kullanılacak model. | DYNAMIC_COMBO | Evet | "s2.1-pro"
"s1" | +| `seed` | Seed, düğümün yeniden çalıştırılıp çalıştırılmayacağını kontrol eder; sonuçlar seed'den bağımsız olarak deterministik değildir. (varsayılan: 42) | INT | Evet | 0 ila 2147483647 | + +### s2.1-pro Girdileri + +Bu girdiler, s2.1-pro modeli seçildiğinde görünür. + +| Parametre | Açıklama | Veri Türü | Zorunlu | Aralık | +|-----------|-------------|-----------|----------|-------| +| `voices` | Genişletilebilir yuva: 1 ila 5 ses öğesi bağlayın (`voice_1`, `voice_2`, ...). Sentez için sesler. Varsayılan ses için boş bırakın. İki veya daha fazla sesle, metindeki konuşmacı değişikliklerini @Voice1, @Voice2 vb. ile işaretleyin. | FISHAUDIO_VOICE | Hayır | 0 ila 5 ses | +| `temperature` | İfade gücü. Yüksek değerler daha çeşitli, düşük değerler daha tutarlıdır. (varsayılan: 0.7) | FLOAT | Evet | 0.0 ila 1.0 | +| `top_p` | Çekirdek örneklemesiyle çeşitlilik. (varsayılan: 0.7) | FLOAT | Evet | 0.01 ila 1.0 | +| `speed` | Konuşma hızı. 1.0 normaldir, <1.0 daha yavaş, >1.0 daha hızlıdır. (varsayılan: 1.0) | FLOAT | Evet | 0.5 ila 2.0 | +| `volume` | Desibel cinsinden ses düzeyi ayarı. 0 değişiklik yok demektir. (varsayılan: 0.0) | FLOAT | Evet | -10.0 ila 10.0 | +| `normalize` | İngilizce ve Çince için sayıları ve metni normalleştirir; sayıların ve tarihlerin kararlılığını artırır. (varsayılan: true) | BOOLEAN | Evet | true / false | + +### s1 Girdileri + +Bu girdiler, s1 modeli seçildiğinde görünür. + +| Parametre | Açıklama | Veri Türü | Zorunlu | Aralık | +|-----------|-------------|-----------|----------|-------| +| `voice` | Sentez için ses. Varsayılan ses için bağlantısız bırakın. | FISHAUDIO_VOICE | Hayır | İsteğe bağlı tek ses | +| `temperature` | İfade gücü. Yüksek değerler daha çeşitli, düşük değerler daha tutarlıdır. (varsayılan: 0.7) | FLOAT | Evet | 0.0 ila 1.0 | +| `top_p` | Çekirdek örneklemesiyle çeşitlilik. (varsayılan: 0.7) | FLOAT | Evet | 0.01 ila 1.0 | +| `speed` | Konuşma hızı. 1.0 normaldir, <1.0 daha yavaş, >1.0 daha hızlıdır. (varsayılan: 1.0) | FLOAT | Evet | 0.5 ila 2.0 | +| `volume` | Desibel cinsinden ses düzeyi ayarı. 0 değişiklik yok demektir. (varsayılan: 0.0) | FLOAT | Evet | -10.0 ila 10.0 | +| `normalize` | İngilizce ve Çince için sayıları ve metni normalleştirir; sayıların ve tarihlerin kararlılığını artırır. (varsayılan: true) | BOOLEAN | Evet | true / false | + +**Not:** `text` girdisi boş olmamalıdır. Konuşmacı etiketleri (@Voice1, @Voice2 vb.) büyük/küçük harfe duyarlı değildir ve bağlı bir sese işaret etmelidir; bağlı olmayan bir sesi etiketlemek hata verir. İki veya daha fazla ses bağlandığında, metin bağlı her sese en az bir kez atıfta bulunmalıdır; aksi halde düğüm eksik etiketleri bildirir. s2.1-pro'da 0 ses bağlamak varsayılan sesi kullanır, 1 ses yalnızca o sesi kullanır ve 2 veya daha fazla ses çok konuşmacılı diyaloğu etkinleştirir. s1'de tek bir isteğe bağlı ses kullanılır ve bağlanmadan bırakılırsa varsayılan ses kullanılır. Duygu ipuçları metne yerleştirilebilir: s2.1-pro'da [happy] ve [whispering], s1'de (happy). + +## Çıktılar + +| Çıktı Adı | Açıklama | Veri Türü | +|-------------|-------------|-----------| +| `audio` | Oluşturulan konuşmanın ses dosyası. | AUDIO | + +> Bu belge yapay zeka tarafından oluşturulmuştur. Herhangi bir hata bulursanız veya iyileştirme önerileriniz varsa, katkıda bulunmaktan çekinmeyin! [GitHub'da Düzenle](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioTextToSpeech/tr.md) + +--- +**Source fingerprint (SHA-256):** `6cc005ae76fc7b60d9399b1b0a3c5de40a6eff47cd6f0f0b73b4212c0270ae29` diff --git a/comfyui_embedded_docs/docs/FishAudioTextToSpeech/zh-TW.md b/comfyui_embedded_docs/docs/FishAudioTextToSpeech/zh-TW.md new file mode 100644 index 000000000..c30332b36 --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioTextToSpeech/zh-TW.md @@ -0,0 +1,52 @@ +# FishAudioTextToSpeech + +此節點使用 Fish Audio 文字轉語音模型,將書面文字轉換為口語音訊。它支援文字中嵌入的情緒提示(s2.1-pro 使用 [happy]、[whispering];s1 使用 (happy)),並在連接多個語音時,透過 @Voice1/@Voice2 標籤實現多人對話。提供兩個模型:s2.1-pro 最多支援五個語音及多人對話;s1 使用單一可選語音。 + +## 輸入 + +### 通用輸入 + +| 參數 | 說明 | 資料型別 | 必要 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `text` | 要轉換為語音的文字。當連接兩個或更多語音時,請使用 @Voice1、@Voice2 等標記說話者切換。不可為空。(預設:空) | STRING | 是 | 任何非空文字 | +| `model` | 用於文字轉語音的模型。 | DYNAMIC_COMBO | 是 | "s2.1-pro"
"s1" | +| `seed` | 種子控制節點是否應重新執行;無論種子為何,結果皆不具確定性。(預設:42) | INT | 是 | 0 至 2147483647 | + +### s2.1-pro 輸入 + +當選用 s2.1-pro 模型時,會顯示以下輸入。 + +| 參數 | 說明 | 資料型別 | 必要 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `voices` | 可擴充插槽:可連接 1 至 5 個語音項目(`voice_1`、`voice_2`、...)。用於合成語音。留空則使用預設語音。當連接兩個或更多語音時,請在文字中標記說話者切換,例如 @Voice1、@Voice2 等。 | FISHAUDIO_VOICE | 否 | 0 至 5 個語音 | +| `temperature` | 表現力。數值越高變化越多,數值越低越一致。(預設:0.7) | FLOAT | 是 | 0.0 至 1.0 | +| `top_p` | 透過核取樣(nucleus sampling)實現多樣性。(預設:0.7) | FLOAT | 是 | 0.01 至 1.0 | +| `speed` | 說話速度。1.0 為正常,<1.0 較慢,>1.0 較快。(預設:1.0) | FLOAT | 是 | 0.5 至 2.0 | +| `volume` | 音量調整(以分貝為單位)。0 表示不變。(預設:0.0) | FLOAT | 是 | -10.0 至 10.0 | +| `normalize` | 針對英文和中文正規化數字與文字,提升數字與日期的穩定性。(預設:true) | BOOLEAN | 是 | true / false | + +### s1 輸入 + +當選用 s1 模型時,會顯示以下輸入。 + +| 參數 | 說明 | 資料型別 | 必要 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `voice` | 用於合成語音的語音。保持未連接以使用預設語音。 | FISHAUDIO_VOICE | 否 | 可選的單一語音 | +| `temperature` | 表現力。數值越高變化越多,數值越低越一致。(預設:0.7) | FLOAT | 是 | 0.0 至 1.0 | +| `top_p` | 透過核取樣(nucleus sampling)實現多樣性。(預設:0.7) | FLOAT | 是 | 0.01 至 1.0 | +| `speed` | 說話速度。1.0 為正常,<1.0 較慢,>1.0 較快。(預設:1.0) | FLOAT | 是 | 0.5 至 2.0 | +| `volume` | 音量調整(以分貝為單位)。0 表示不變。(預設:0.0) | FLOAT | 是 | -10.0 至 10.0 | +| `normalize` | 針對英文和中文正規化數字與文字,提升數字與日期的穩定性。(預設:true) | BOOLEAN | 是 | true / false | + +**注意:** `text` 輸入不可為空。說話者標籤(@Voice1、@Voice2 等)不區分大小寫,且必須指向已連接的語音;為未連接的語音加上標籤會引發錯誤。當連接兩個或更多語音時,文字中必須至少提及每個已連接語音一次,否則節點會回報缺少標籤。在 s2.1-pro 上,連接 0 個語音會使用預設語音,連接 1 個語音會單獨使用該語音,連接 2 個或更多語音則啟用多人對話。在 s1 上,使用單一可選語音,保持未連接則使用預設語音。情緒提示可放在文字中:s2.1-pro 使用 [happy] 和 [whispering],s1 使用 (happy)。 + +## 輸出 + +| 輸出名稱 | 說明 | 資料型別 | +|-------------|-------------|-----------| +| `audio` | 生成的語音音訊檔案。 | AUDIO | + +> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioTextToSpeech/zh-TW.md) + +--- +**Source fingerprint (SHA-256):** `6cc005ae76fc7b60d9399b1b0a3c5de40a6eff47cd6f0f0b73b4212c0270ae29` diff --git a/comfyui_embedded_docs/docs/FishAudioTextToSpeech/zh.md b/comfyui_embedded_docs/docs/FishAudioTextToSpeech/zh.md new file mode 100644 index 000000000..0a42b4f6e --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioTextToSpeech/zh.md @@ -0,0 +1,52 @@ +# FishAudioTextToSpeech + +此节点使用 Fish Audio 文本转语音模型将书面文本转换为语音音频。它支持文本中嵌入的情感提示(s2.1-pro 上使用 `[happy]`、`[whispering]`;s1 上使用 `(happy)`),并在连接多个语音时通过 @Voice1/@Voice2 标签实现多说话人对话。提供两种模型:s2.1-pro 支持最多五个语音和多说话人对话;s1 使用单个可选语音。 + +## 输入 + +### 通用输入 + +| 参数 | 描述 | 数据类型 | 必需 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `text` | 要转换为语音的文本。当连接两个或更多语音时,使用 @Voice1、@Voice2 等标记说话人切换。不能为空。(默认:空) | STRING | 是 | 任意非空文本 | +| `model` | 用于文本转语音的模型。 | DYNAMIC_COMBO | 是 | "s2.1-pro"
"s1" | +| `seed` | 种子控制节点是否应重新运行;无论种子如何,结果都是非确定性的。(默认:42) | INT | 是 | 0 到 2147483647 | + +### s2.1-pro 输入 + +当选择 s2.1-pro 模型时,会显示以下输入。 + +| 参数 | 描述 | 数据类型 | 必需 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `voices` | 可扩展槽位:连接 1 到 5 个语音项(`voice_1`、`voice_2`、...)。用于合成的语音。留空则使用默认语音。当连接两个或更多语音时,在文本中使用 @Voice1、@Voice2 等标记说话人切换。 | FISHAUDIO_VOICE | 否 | 0 到 5 个语音 | +| `temperature` | 表现力。数值越高变化越多,数值越低一致性越强。(默认:0.7) | FLOAT | 是 | 0.0 到 1.0 | +| `top_p` | 通过核采样(nucleus sampling)实现多样性。(默认:0.7) | FLOAT | 是 | 0.01 到 1.0 | +| `speed` | 语速。1.0 为正常,<1.0 较慢,>1.0 较快。(默认:1.0) | FLOAT | 是 | 0.5 到 2.0 | +| `volume` | 音量调节(分贝)。0 表示不变。(默认:0.0) | FLOAT | 是 | -10.0 到 10.0 | +| `normalize` | 对英文和中文的数字及文本进行规范化,提高数字和日期的稳定性。(默认:true) | BOOLEAN | 是 | true / false | + +### s1 输入 + +当选择 s1 模型时,会显示以下输入。 + +| 参数 | 描述 | 数据类型 | 必需 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `voice` | 用于合成的语音。不连接则使用默认语音。 | FISHAUDIO_VOICE | 否 | 可选单个语音 | +| `temperature` | 表现力。数值越高变化越多,数值越低一致性越强。(默认:0.7) | FLOAT | 是 | 0.0 到 1.0 | +| `top_p` | 通过核采样(nucleus sampling)实现多样性。(默认:0.7) | FLOAT | 是 | 0.01 到 1.0 | +| `speed` | 语速。1.0 为正常,<1.0 较慢,>1.0 较快。(默认:1.0) | FLOAT | 是 | 0.5 到 2.0 | +| `volume` | 音量调节(分贝)。0 表示不变。(默认:0.0) | FLOAT | 是 | -10.0 到 10.0 | +| `normalize` | 对英文和中文的数字及文本进行规范化,提高数字和日期的稳定性。(默认:true) | BOOLEAN | 是 | true / false | + +**注意:** `text` 输入不能为空。说话人标签(@Voice1、@Voice2 等)不区分大小写,且必须指向已连接的语音;标记未连接的语音会引发错误。当连接两个或更多语音时,文本必须至少引用每个已连接语音一次,否则节点会报告缺失的标签。在 s2.1-pro 上,连接 0 个语音时使用默认语音,连接 1 个语音时仅使用该语音,连接 2 个或更多语音时启用多说话人对话。在 s1 上,使用单个可选语音,不连接则使用默认语音。情感提示可以放在文本中:s2.1-pro 使用 [happy] 和 [whispering],s1 使用 (happy)。 + +## 输出 + +| 输出名称 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `audio` | 生成的语音音频文件。 | AUDIO | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioTextToSpeech/zh.md) + +--- +**Source fingerprint (SHA-256):** `6cc005ae76fc7b60d9399b1b0a3c5de40a6eff47cd6f0f0b73b4212c0270ae29` diff --git a/comfyui_embedded_docs/docs/FishAudioVoiceSelector/ar.md b/comfyui_embedded_docs/docs/FishAudioVoiceSelector/ar.md new file mode 100644 index 000000000..cd16e2641 --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioVoiceSelector/ar.md @@ -0,0 +1,34 @@ +# FishAudioVoiceSelector + +عقدة "Fish Audio Voice Selector" (محدد صوت Fish Audio) تختار صوتًا من مكتبة Fish Audio لتوليد الكلام من النص. يمكنك اختيار أحد الأصوات الجاهزة المدمجة، أو اختيار "custom" لإدخال أي معرّف نموذج صوتي من fish.audio. + +## المدخلات + +### المدخلات العامة + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|-----------|-------------|-----------|----------|-------| +| `voice` | اختر صوتًا، أو "custom" لإدخال أي معرّف نموذج صوتي من fish.audio. | DYNAMIC_COMBO | نعم | "Energetic Male (en)"
"Friendly Women (en)"
"Sarah (en)"
"Verity (en)"
"Polo (en)"
"Adrian (en)"
"E-girl (en)"
"Narrator (en)"
"Warm Conversational Voice (en)"
"Warm Storyteller (en)"
"Dramatic Character Male (en)"
"News Narrator (zh)"
"Lively Female (zh)"
"Gentle Female (zh)"
"Energetic Female (ja)"
"Calm Female (ja)"
"Calm Male (ja)"
"custom" | + +خيارات الأصوات الجاهزة تغطي أصوات اللغة الإنجليزية (en) والصينية (zh) واليابانية (ja) ولا تتطلب أي مدخلات إضافية. + +### المدخلات المخصصة + +تظهر هذه المدخلات عندما يتم تعيين `voice` على "custom". + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|-----------|-------------|-----------|----------|-------| +| `voice_id` | معرّف نموذج الصوت من fish.audio، مثل المعرّف في https://fish.audio/m// الافتراضي: سلسلة فارغة. | STRING | نعم | أي معرّف نموذج صوتي صالح من Fish Audio | + +ملاحظة: عندما يتم تعيين `voice` على "custom"، يجب ألا يكون `voice_id` فارغًا بعد إزالة المسافات البيضاء؛ وإلا ستقوم العقدة برفع خطأ "Custom voice ID is empty." إذا تم تمرير خيار صوت غير معروف، ستقوم العقدة برفع خطأ "Unknown voice". + +## المخرجات + +| اسم المخرج | الوصف | نوع البيانات | +|-------------|-------------|-----------| +| `voice` | معرّف نموذج صوت Fish Audio المحدد. بالنسبة للصوت الجاهز، يتم إرجاع معرّف الصوت المقابل من مكتبة Fish Audio؛ بالنسبة لـ "custom"، يتم إرجاع قيمة `voice_id` المُدخلة. | FISHAUDIO_VOICE | + +> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioVoiceSelector/ar.md) + +--- +**Source fingerprint (SHA-256):** `4f99a58aa7e6054f58fe84e61e4e1008b17828bd97d71ef0a4009c4de4052bbd` diff --git a/comfyui_embedded_docs/docs/FishAudioVoiceSelector/en.md b/comfyui_embedded_docs/docs/FishAudioVoiceSelector/en.md new file mode 100644 index 000000000..d9886e90d --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioVoiceSelector/en.md @@ -0,0 +1,34 @@ +# FishAudioVoiceSelector + +The Fish Audio Voice Selector node selects a voice from the Fish Audio library for text-to-speech generation. You can pick one of the built-in preset voices, or choose "custom" to enter any voice model ID from fish.audio. + +## Inputs + +### Common Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `voice` | Choose a voice, or 'custom' to enter any fish.audio voice model ID. | DYNAMIC_COMBO | Yes | "Energetic Male (en)"
"Friendly Women (en)"
"Sarah (en)"
"Verity (en)"
"Polo (en)"
"Adrian (en)"
"E-girl (en)"
"Narrator (en)"
"Warm Conversational Voice (en)"
"Warm Storyteller (en)"
"Dramatic Character Male (en)"
"News Narrator (zh)"
"Lively Female (zh)"
"Gentle Female (zh)"
"Energetic Female (ja)"
"Calm Female (ja)"
"Calm Male (ja)"
"custom" | + +The preset voice options cover English (en), Chinese (zh), and Japanese (ja) voices and do not require any additional inputs. + +### Custom Inputs + +These inputs appear when `voice` is set to "custom". + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `voice_id` | Voice model ID from fish.audio, e.g. the ID in https://fish.audio/m//. Default: empty string. | STRING | Yes | Any valid Fish Audio voice model ID | + +Note: When `voice` is set to "custom", `voice_id` must not be empty after whitespace is trimmed; otherwise the node raises a "Custom voice ID is empty." error. If an unrecognized voice option is passed, the node raises an "Unknown voice" error. + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `voice` | The selected Fish Audio voice model ID. For a preset voice, the corresponding voice ID from the Fish Audio library is returned; for "custom", the entered `voice_id` value is returned. | FISHAUDIO_VOICE | + +> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioVoiceSelector/en.md) + +--- +**Source fingerprint (SHA-256):** `4f99a58aa7e6054f58fe84e61e4e1008b17828bd97d71ef0a4009c4de4052bbd` diff --git a/comfyui_embedded_docs/docs/FishAudioVoiceSelector/es.md b/comfyui_embedded_docs/docs/FishAudioVoiceSelector/es.md new file mode 100644 index 000000000..f68f4dd7b --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioVoiceSelector/es.md @@ -0,0 +1,34 @@ +# FishAudioVoiceSelector + +El nodo Selector de Voz de Fish Audio selecciona una voz de la biblioteca de Fish Audio para la generación de texto a voz. Puede elegir una de las voces preestablecidas integradas o seleccionar "custom" para ingresar cualquier ID de modelo de voz de fish.audio. + +## Entradas + +### Entradas comunes + +| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango | +|-----------|-------------|---------------|-------------|-------| +| `voice` | Elija una voz, o 'custom' para ingresar cualquier ID de modelo de voz de fish.audio. | DYNAMIC_COMBO | Sí | "Energetic Male (en)"
"Friendly Women (en)"
"Sarah (en)"
"Verity (en)"
"Polo (en)"
"Adrian (en)"
"E-girl (en)"
"Narrator (en)"
"Warm Conversational Voice (en)"
"Warm Storyteller (en)"
"Dramatic Character Male (en)"
"News Narrator (zh)"
"Lively Female (zh)"
"Gentle Female (zh)"
"Energetic Female (ja)"
"Calm Female (ja)"
"Calm Male (ja)"
"custom" | + +Las opciones de voz preestablecidas incluyen voces en inglés (en), chino (zh) y japonés (ja) y no requieren entradas adicionales. + +### Entradas personalizadas + +Estas entradas aparecen cuando `voice` se establece en "custom". + +| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango | +|-----------|-------------|---------------|-------------|-------| +| `voice_id` | ID de modelo de voz de fish.audio, p. ej., el ID en https://fish.audio/m//. Por defecto: cadena vacía. | STRING | Sí | Cualquier ID de modelo de voz válido de Fish Audio | + +Nota: cuando `voice` se establece en "custom", `voice_id` no debe estar vacío después de recortar los espacios en blanco; de lo contrario, el nodo lanza un error "Custom voice ID is empty.". Si se pasa una opción de voz no reconocida, el nodo lanza un error "Unknown voice". + +## Salidas + +| Nombre de salida | Descripción | Tipo de datos | +|------------------|-------------|---------------| +| `voice` | El ID del modelo de voz de Fish Audio seleccionado. Para una voz preestablecida, se devuelve el ID de voz correspondiente de la biblioteca de Fish Audio; para "custom", se devuelve el valor de `voice_id` ingresado. | FISHAUDIO_VOICE | + +> Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioVoiceSelector/es.md) + +--- +**Source fingerprint (SHA-256):** `4f99a58aa7e6054f58fe84e61e4e1008b17828bd97d71ef0a4009c4de4052bbd` diff --git a/comfyui_embedded_docs/docs/FishAudioVoiceSelector/fa.md b/comfyui_embedded_docs/docs/FishAudioVoiceSelector/fa.md new file mode 100644 index 000000000..4c3503beb --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioVoiceSelector/fa.md @@ -0,0 +1,32 @@ +# FishAudioVoiceSelector + +## ورودی‌ها + +### ورودی‌های عمومی + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `voice` | یک صدا انتخاب کنید، یا «custom» را برای وارد کردن هر شناسه مدل صوتی fish.audio انتخاب کنید. | DYNAMIC_COMBO | بله | "Energetic Male (en)"
"Friendly Women (en)"
"Sarah (en)"
"Verity (en)"
"Polo (en)"
"Adrian (en)"
"E-girl (en)"
"Narrator (en)"
"Warm Conversational Voice (en)"
"Warm Storyteller (en)"
"Dramatic Character Male (en)"
"News Narrator (zh)"
"Lively Female (zh)"
"Gentle Female (zh)"
"Energetic Female (ja)"
"Calm Female (ja)"
"Calm Male (ja)"
"custom" | + +گزینه‌های صوتی پیش‌تنظیم شامل صداهای انگلیسی (en)، چینی (zh) و ژاپنی (ja) هستند و به هیچ ورودی اضافی نیاز ندارند. + +### ورودی‌های سفارشی + +این ورودی‌ها زمانی ظاهر می‌شوند که `voice` روی «custom» تنظیم شده باشد. + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `voice_id` | شناسه مدل صوتی از fish.audio، مثلاً شناسه در https://fish.audio/m//. پیش‌فرض: رشته خالی. | STRING | بله | هر شناسه مدل صوتی معتبر Fish Audio | + +توجه: وقتی `voice` روی «custom» تنظیم می‌شود، `voice_id` نباید پس از حذف فاصله‌های خالی خالی باشد؛ در غیر این صورت گره خطای «Custom voice ID is empty.» را صادر می‌کند. اگر یک گزینه صوتی ناشناخته ارسال شود، گره خطای «Unknown voice» را صادر می‌کند. + +## خروجی‌ها + +| نام خروجی | توضیحات | نوع داده | +|-------------|-------------|-----------| +| `voice` | شناسه مدل صوتی انتخاب‌شده Fish Audio. برای صدای پیش‌تنظیم، شناسه صوتی متناظر از کتابخانه Fish Audio برگردانده می‌شود؛ برای «custom»، مقدار `voice_id` واردشده برگردانده می‌شود. | FISHAUDIO_VOICE | + +> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioVoiceSelector/fa.md) + +--- +**Source fingerprint (SHA-256):** `4f99a58aa7e6054f58fe84e61e4e1008b17828bd97d71ef0a4009c4de4052bbd` diff --git a/comfyui_embedded_docs/docs/FishAudioVoiceSelector/fr.md b/comfyui_embedded_docs/docs/FishAudioVoiceSelector/fr.md new file mode 100644 index 000000000..a744e7d76 --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioVoiceSelector/fr.md @@ -0,0 +1,34 @@ +# FishAudioVoiceSelector + +Le nœud Fish Audio Voice Selector sélectionne une voix de la bibliothèque Fish Audio pour la génération de synthèse vocale. Vous pouvez choisir l’une des voix prédéfinies intégrées, ou opter pour « custom » afin de saisir n’importe quel identifiant de modèle vocal de fish.audio. + +## Entrées + +### Entrées communes + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `voice` | Choisissez une voix, ou « custom » pour saisir n’importe quel identifiant de modèle vocal fish.audio. | DYNAMIC_COMBO | Oui | "Energetic Male (en)"
"Friendly Women (en)"
"Sarah (en)"
"Verity (en)"
"Polo (en)"
"Adrian (en)"
"E-girl (en)"
"Narrator (en)"
"Warm Conversational Voice (en)"
"Warm Storyteller (en)"
"Dramatic Character Male (en)"
"News Narrator (zh)"
"Lively Female (zh)"
"Gentle Female (zh)"
"Energetic Female (ja)"
"Calm Female (ja)"
"Calm Male (ja)"
"custom" | + +Les options de voix prédéfinies couvrent des voix en anglais (en), en chinois (zh) et en japonais (ja) et ne nécessitent aucune entrée supplémentaire. + +### Entrées personnalisées + +Ces entrées apparaissent lorsque `voice` est défini sur « custom ». + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `voice_id` | Identifiant du modèle vocal issu de fish.audio, par ex. l’identifiant dans https://fish.audio/m//. Par défaut : chaîne vide. | STRING | Oui | Toute identification valide de modèle vocal Fish Audio | + +Remarque : lorsque `voice` est défini sur « custom », `voice_id` ne doit pas être vide une fois les espaces supprimés ; sinon, le nœud lève une erreur « Custom voice ID is empty. ». Si une option de voix non reconnue est transmise, le nœud lève une erreur « Unknown voice ». + +## Sorties + +| Nom de sortie | Description | Type de données | +|---------------|-------------|-----------------| +| `voice` | L’identifiant du modèle vocal Fish Audio sélectionné. Pour une voix prédéfinie, l’identifiant vocal correspondant de la bibliothèque Fish Audio est renvoyé ; pour « custom », la valeur de `voice_id` saisie est renvoyée. | FISHAUDIO_VOICE | + +> Cette documentation a été générée par IA. Si vous trouvez des erreurs ou avez des suggestions d'amélioration, n'hésitez pas à contribuer ! [Modifier sur GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioVoiceSelector/fr.md) + +--- +**Source fingerprint (SHA-256):** `4f99a58aa7e6054f58fe84e61e4e1008b17828bd97d71ef0a4009c4de4052bbd` diff --git a/comfyui_embedded_docs/docs/FishAudioVoiceSelector/ja.md b/comfyui_embedded_docs/docs/FishAudioVoiceSelector/ja.md new file mode 100644 index 000000000..64afc89c2 --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioVoiceSelector/ja.md @@ -0,0 +1,34 @@ +# FishAudioVoiceSelector + +Fish Audio Voice Selector ノードは、テキスト読み上げ生成のために Fish Audio ライブラリから音声を選択します。内蔵のプリセット音声から1つを選ぶか、「custom」を選択して fish.audio の任意の音声モデルIDを入力できます。 + +## 入力 + +### 共通入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `voice` | 音声を選択するか、「custom」を選択すると fish.audio の音声モデルIDを入力できます。 | DYNAMIC_COMBO | はい | "Energetic Male (en)"
"Friendly Women (en)"
"Sarah (en)"
"Verity (en)"
"Polo (en)"
"Adrian (en)"
"E-girl (en)"
"Narrator (en)"
"Warm Conversational Voice (en)"
"Warm Storyteller (en)"
"Dramatic Character Male (en)"
"News Narrator (zh)"
"Lively Female (zh)"
"Gentle Female (zh)"
"Energetic Female (ja)"
"Calm Female (ja)"
"Calm Male (ja)"
"custom" | + +プリセット音声オプションは、英語(en)、中国語(zh)、日本語(ja)の音声をカバーしており、追加の入力は必要ありません。 + +### カスタム入力 + +これらの入力は、`voice` が「custom」に設定されている場合に表示されます。 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `voice_id` | fish.audio の音声モデルID。例: https://fish.audio/m// 内のID。デフォルト: 空文字列。 | STRING | はい | 有効な Fish Audio 音声モデルID | + +注:`voice` が「custom」に設定されている場合、`voice_id` は空白をトリムした後に空であってはなりません。空の場合は、ノードは「Custom voice ID is empty.」エラーを発生させます。認識できない音声オプションが渡された場合、ノードは「Unknown voice」エラーを発生させます。 + +## 出力 + +| 出力名 | 説明 | データ型 | +|-------------|-------------|-----------| +| `voice` | 選択された Fish Audio 音声モデルID。プリセット音声の場合、Fish Audio ライブラリ内の対応する音声IDが返されます。「custom」の場合は、入力された `voice_id` の値が返されます。 | FISHAUDIO_VOICE | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioVoiceSelector/ja.md) + +--- +**Source fingerprint (SHA-256):** `4f99a58aa7e6054f58fe84e61e4e1008b17828bd97d71ef0a4009c4de4052bbd` diff --git a/comfyui_embedded_docs/docs/FishAudioVoiceSelector/ko.md b/comfyui_embedded_docs/docs/FishAudioVoiceSelector/ko.md new file mode 100644 index 000000000..d324f69ea --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioVoiceSelector/ko.md @@ -0,0 +1,34 @@ +# FishAudioVoiceSelector + +Fish Audio Voice Selector 노드는 텍스트 음성 변환 생성을 위해 Fish Audio 라이브러리에서 음성을 선택합니다. 내장된 사전 설정 음성 중 하나를 선택하거나 "custom"을 선택하여 fish.audio의 음성 모델 ID를 입력할 수 있습니다. + +## 입력 + +### 공통 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `voice` | 음성을 선택하거나 'custom'을 선택하여 fish.audio 음성 모델 ID를 입력합니다. | DYNAMIC_COMBO | 예 | "Energetic Male (en)"
"Friendly Women (en)"
"Sarah (en)"
"Verity (en)"
"Polo (en)"
"Adrian (en)"
"E-girl (en)"
"Narrator (en)"
"Warm Conversational Voice (en)"
"Warm Storyteller (en)"
"Dramatic Character Male (en)"
"News Narrator (zh)"
"Lively Female (zh)"
"Gentle Female (zh)"
"Energetic Female (ja)"
"Calm Female (ja)"
"Calm Male (ja)"
"custom" | + +사전 설정 음성 옵션은 영어(en), 중국어(zh), 일본어(ja) 음성을 포함하며 추가 입력이 필요하지 않습니다. + +### 사용자 지정 입력 + +이 입력은 `voice`가 "custom"으로 설정된 경우 표시됩니다. + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `voice_id` | fish.audio의 음성 모델 ID입니다. 예: https://fish.audio/m//의 ID. 기본값: 빈 문자열. | STRING | 예 | 유효한 Fish Audio 음성 모델 ID | + +참고: `voice`가 "custom"으로 설정된 경우, 공백을 제거한 후 `voice_id`가 비어 있으면 안 됩니다. 그렇지 않으면 노드에서 "Custom voice ID is empty." 오류가 발생합니다. 인식할 수 없는 음성 옵션이 전달되면 노드에서 "Unknown voice" 오류가 발생합니다. + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `voice` | 선택된 Fish Audio 음성 모델 ID입니다. 사전 설정 음성의 경우 Fish Audio 라이브러리의 해당 음성 ID가 반환되고, "custom"의 경우 입력한 `voice_id` 값이 반환됩니다. | FISHAUDIO_VOICE | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioVoiceSelector/ko.md) + +--- +**Source fingerprint (SHA-256):** `4f99a58aa7e6054f58fe84e61e4e1008b17828bd97d71ef0a4009c4de4052bbd` diff --git a/comfyui_embedded_docs/docs/FishAudioVoiceSelector/pt-BR.md b/comfyui_embedded_docs/docs/FishAudioVoiceSelector/pt-BR.md new file mode 100644 index 000000000..93514f1f4 --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioVoiceSelector/pt-BR.md @@ -0,0 +1,34 @@ +# FishAudioVoiceSelector + +O nó Seletor de Voz do Fish Audio seleciona uma voz da biblioteca Fish Audio para geração de texto para fala. Você pode escolher uma das vozes predefinidas integradas ou selecionar `custom` para inserir qualquer ID de modelo de voz do fish.audio. + +## Entradas + +### Entradas comuns + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | +|-----------|-------------|-----------|----------|-------| +| `voice` | Escolha uma voz, ou `custom` para inserir qualquer ID de modelo de voz do fish.audio. | DYNAMIC_COMBO | Sim | "Energetic Male (en)"
"Friendly Women (en)"
"Sarah (en)"
"Verity (en)"
"Polo (en)"
"Adrian (en)"
"E-girl (en)"
"Narrator (en)"
"Warm Conversational Voice (en)"
"Warm Storyteller (en)"
"Dramatic Character Male (en)"
"News Narrator (zh)"
"Lively Female (zh)"
"Gentle Female (zh)"
"Energetic Female (ja)"
"Calm Female (ja)"
"Calm Male (ja)"
"custom" | + +As opções de voz predefinidas abrangem vozes em inglês (en), chinês (zh) e japonês (ja) e não exigem nenhuma entrada adicional. + +### Entradas personalizadas + +Estas entradas aparecem quando `voice` está definido como "custom". + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | +|-----------|-------------|-----------|----------|-------| +| `voice_id` | ID do modelo de voz do fish.audio, por exemplo, o ID em https://fish.audio/m//. Padrão: string vazia. | STRING | Sim | Qualquer ID válido de modelo de voz do Fish Audio | + +Nota: Quando `voice` está definido como "custom", `voice_id` não pode ficar vazio após a remoção de espaços em branco; caso contrário, o nó gera um erro "Custom voice ID is empty.". Se uma opção de voz não reconhecida for passada, o nó gera um erro "Unknown voice". + +## Saídas + +| Nome da Saída | Descrição | Tipo de Dados | +|-------------|-------------|-----------| +| `voice` | O ID do modelo de voz do Fish Audio selecionado. Para uma voz predefinida, o ID de voz correspondente da biblioteca Fish Audio é retornado; para "custom", o valor de `voice_id` inserido é retornado. | FISHAUDIO_VOICE | + +> Esta documentação foi gerada por IA. Se você encontrar erros ou tiver sugestões de melhoria, sinta-se à vontade para contribuir! [Editar no GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioVoiceSelector/pt-BR.md) + +--- +**Source fingerprint (SHA-256):** `4f99a58aa7e6054f58fe84e61e4e1008b17828bd97d71ef0a4009c4de4052bbd` diff --git a/comfyui_embedded_docs/docs/FishAudioVoiceSelector/ru.md b/comfyui_embedded_docs/docs/FishAudioVoiceSelector/ru.md new file mode 100644 index 000000000..702a99b0e --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioVoiceSelector/ru.md @@ -0,0 +1,34 @@ +# FishAudioVoiceSelector + +Узел Fish Audio Voice Selector выбирает голос из библиотеки Fish Audio для генерации речи (text-to-speech). Вы можете выбрать один из встроенных предустановленных голосов или выбрать «custom», чтобы ввести любой ID модели голоса с fish.audio. + +## Входы + +### Общие входы + +| Параметр | Описание | Тип данных | Обязательный | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `voice` | Выберите голос или «custom», чтобы ввести любой ID модели голоса fish.audio. | DYNAMIC_COMBO | Да | "Energetic Male (en)"
"Friendly Women (en)"
"Sarah (en)"
"Verity (en)"
"Polo (en)"
"Adrian (en)"
"E-girl (en)"
"Narrator (en)"
"Warm Conversational Voice (en)"
"Warm Storyteller (en)"
"Dramatic Character Male (en)"
"News Narrator (zh)"
"Lively Female (zh)"
"Gentle Female (zh)"
"Energetic Female (ja)"
"Calm Female (ja)"
"Calm Male (ja)"
"custom" | + +Предустановленные голоса охватывают английский (en), китайский (zh) и японский (ja) и не требуют дополнительных входных данных. + +### Пользовательские входы + +Эти входы появляются, когда параметр `voice` установлен в «custom». + +| Параметр | Описание | Тип данных | Обязательный | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `voice_id` | ID модели голоса с fish.audio, например ID из https://fish.audio/m//. По умолчанию: пустая строка. | STRING | Да | Любой допустимый ID модели голоса Fish Audio | + +Примечание: когда параметр `voice` установлен в «custom», `voice_id` не должна быть пустой после удаления пробельных символов; в противном случае узел вызывает ошибку «Custom voice ID is empty.». Если передана нераспознанная опция голоса, узел вызывает ошибку «Unknown voice». + +## Выходы + +| Имя выхода | Описание | Тип данных | +|-------------|-------------|-----------| +| `voice` | Выбранный ID модели голоса Fish Audio. Для предустановленного голоса возвращается соответствующий ID голоса из библиотеки Fish Audio; для «custom» возвращается введённое значение `voice_id`. | FISHAUDIO_VOICE | + +> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioVoiceSelector/ru.md) + +--- +**Source fingerprint (SHA-256):** `4f99a58aa7e6054f58fe84e61e4e1008b17828bd97d71ef0a4009c4de4052bbd` diff --git a/comfyui_embedded_docs/docs/FishAudioVoiceSelector/tr.md b/comfyui_embedded_docs/docs/FishAudioVoiceSelector/tr.md new file mode 100644 index 000000000..fc40ec4e7 --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioVoiceSelector/tr.md @@ -0,0 +1,34 @@ +# FishAudioVoiceSelector + +Fish Audio Voice Selector düğümü, metinden konuşmaya (text-to-speech) üretimi için Fish Audio kitaplığından bir ses seçer. Yerleşik hazır seslerden birini seçebilir veya fish.audio üzerinden herhangi bir ses modeli kimliği girmek için "custom" seçeneğini belirleyebilirsiniz. + +## Girdiler + +### Ortak Girdiler + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +|-----------|-------------|-----------|----------|-------| +| `voice` | Bir ses seçin veya herhangi bir fish.audio ses modeli kimliği girmek için 'custom' seçeneğini belirleyin. | DYNAMIC_COMBO | Evet | "Energetic Male (en)"
"Friendly Women (en)"
"Sarah (en)"
"Verity (en)"
"Polo (en)"
"Adrian (en)"
"E-girl (en)"
"Narrator (en)"
"Warm Conversational Voice (en)"
"Warm Storyteller (en)"
"Dramatic Character Male (en)"
"News Narrator (zh)"
"Lively Female (zh)"
"Gentle Female (zh)"
"Energetic Female (ja)"
"Calm Female (ja)"
"Calm Male (ja)"
"custom" | + +Hazır ses seçenekleri İngilizce (en), Çince (zh) ve Japonca (ja) seslerini kapsar ve ek girdi gerektirmez. + +### Özel Girdiler + +Bu girdiler, `voice` "custom" olarak ayarlandığında görünür. + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +|-----------|-------------|-----------|----------|-------| +| `voice_id` | fish.audio'dan ses modeli kimliği; örn. https://fish.audio/m// adresindeki kimlik. Varsayılan: boş dize. | STRING | Evet | Herhangi bir geçerli Fish Audio ses modeli kimliği | + +Not: `voice` "custom" olarak ayarlandığında, `voice_id` boşluklar temizlendikten sonra boş olmamalıdır; aksi takdirde düğüm "Custom voice ID is empty." hatası verir. Tanınmayan bir ses seçeneği iletilirse düğüm "Unknown voice" hatası verir. + +## Çıktılar + +| Çıktı Adı | Açıklama | Veri Türü | +|-------------|-------------|-----------| +| `voice` | Seçilen Fish Audio ses modeli kimliği. Hazır bir ses için Fish Audio kitaplığından ilgili ses kimliği döndürülür; "custom" için girilen `voice_id` değeri döndürülür. | FISHAUDIO_VOICE | + +> Bu belge yapay zeka tarafından oluşturulmuştur. Herhangi bir hata bulursanız veya iyileştirme önerileriniz varsa, katkıda bulunmaktan çekinmeyin! [GitHub'da Düzenle](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioVoiceSelector/tr.md) + +--- +**Source fingerprint (SHA-256):** `4f99a58aa7e6054f58fe84e61e4e1008b17828bd97d71ef0a4009c4de4052bbd` diff --git a/comfyui_embedded_docs/docs/FishAudioVoiceSelector/zh-TW.md b/comfyui_embedded_docs/docs/FishAudioVoiceSelector/zh-TW.md new file mode 100644 index 000000000..fd0b5148a --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioVoiceSelector/zh-TW.md @@ -0,0 +1,34 @@ +# FishAudioVoiceSelector + +Fish Audio 語音選擇器節點可從 Fish Audio 函式庫中選擇語音,用於文字轉語音生成。您可以選擇其中一個內建預設語音,或選擇「custom」以輸入 fish.audio 上的任何語音模型 ID。 + +## 輸入 + +### 通用輸入 + +| 參數 | 描述 | 資料類型 | 必填 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `voice` | 選擇一個語音,或選擇「custom」以輸入任何 fish.audio 語音模型 ID。 | DYNAMIC_COMBO | 是 | "Energetic Male (en)"
"Friendly Women (en)"
"Sarah (en)"
"Verity (en)"
"Polo (en)"
"Adrian (en)"
"E-girl (en)"
"Narrator (en)"
"Warm Conversational Voice (en)"
"Warm Storyteller (en)"
"Dramatic Character Male (en)"
"News Narrator (zh)"
"Lively Female (zh)"
"Gentle Female (zh)"
"Energetic Female (ja)"
"Calm Female (ja)"
"Calm Male (ja)"
"custom" | + +預設語音選項涵蓋英文(en)、中文(zh)和日文(ja)語音,且不需要任何額外輸入。 + +### 自訂輸入 + +當 `voice` 設定為「custom」時,會顯示這些輸入。 + +| 參數 | 描述 | 資料類型 | 必填 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `voice_id` | 來自 fish.audio 的語音模型 ID,例如 https://fish.audio/m// 中的 ID。預設值:空字串。 | STRING | 是 | 任何有效的 Fish Audio 語音模型 ID | + +注意:當 `voice` 設定為「custom」時,`voice_id` 在去除空白後不得為空;否則節點會拋出「"Custom voice ID is empty."」錯誤。如果傳入無法辨識的語音選項,節點會拋出「"Unknown voice"」錯誤。 + +## 輸出 + +| 輸出名稱 | 描述 | 資料類型 | +|-------------|-------------|-----------| +| `voice` | 所選的 Fish Audio 語音模型 ID。對於預設語音,會傳回 Fish Audio 函式庫中對應的語音 ID;對於「custom」,則會傳回所輸入的 `voice_id` 值。 | FISHAUDIO_VOICE | + +> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioVoiceSelector/zh-TW.md) + +--- +**Source fingerprint (SHA-256):** `4f99a58aa7e6054f58fe84e61e4e1008b17828bd97d71ef0a4009c4de4052bbd` diff --git a/comfyui_embedded_docs/docs/FishAudioVoiceSelector/zh.md b/comfyui_embedded_docs/docs/FishAudioVoiceSelector/zh.md new file mode 100644 index 000000000..91c5bf3d8 --- /dev/null +++ b/comfyui_embedded_docs/docs/FishAudioVoiceSelector/zh.md @@ -0,0 +1,34 @@ +# FishAudioVoiceSelector + +Fish Audio 语音选择节点用于从 Fish Audio 库中选择用于文本转语音生成的语音。您可以选择一个内置预设语音,或选择“custom”以输入 fish.audio 中的任意语音模型 ID。 + +## 输入 + +### 通用输入 + +| 参数 | 描述 | 数据类型 | 是否必需 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `voice` | 选择一种语音,或选择“custom”以输入任意 fish.audio 语音模型 ID。 | DYNAMIC_COMBO | 是 | “Energetic Male (en)”
“Friendly Women (en)”
“Sarah (en)”
“Verity (en)”
“Polo (en)”
“Adrian (en)”
“E-girl (en)”
“Narrator (en)”
“Warm Conversational Voice (en)”
“Warm Storyteller (en)”
“Dramatic Character Male (en)”
“News Narrator (zh)”
“Lively Female (zh)”
“Gentle Female (zh)”
“Energetic Female (ja)”
“Calm Female (ja)”
“Calm Male (ja)”
“custom” | + +预设语音选项涵盖英语(en)、中文(zh)和日语(ja)语音,且无需任何额外输入。 + +### 自定义输入 + +当 `voice` 设置为“custom”时,会出现以下输入。 + +| 参数 | 描述 | 数据类型 | 是否必需 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `voice_id` | 来自 fish.audio 的语音模型 ID,例如 https://fish.audio/m// 中的 ID。默认值:空字符串。 | STRING | 是 | 任意有效的 Fish Audio 语音模型 ID | + +注意:当 `voice` 设置为“custom”时,`voice_id` 在去除首尾空格后不能为空;否则节点会抛出“Custom voice ID is empty.”错误。如果传入了无法识别的语音选项,节点会抛出“Unknown voice”错误。 + +## 输出 + +| 输出名称 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `voice` | 所选的 Fish Audio 语音模型 ID。对于预设语音,返回 Fish Audio 库中对应的语音 ID;对于“custom”,返回输入的 `voice_id` 值。 | FISHAUDIO_VOICE | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FishAudioVoiceSelector/zh.md) + +--- +**Source fingerprint (SHA-256):** `4f99a58aa7e6054f58fe84e61e4e1008b17828bd97d71ef0a4009c4de4052bbd` diff --git a/comfyui_embedded_docs/docs/Flux2ImageNode/en.md b/comfyui_embedded_docs/docs/Flux2ImageNode/en.md index 70d5f7d26..d53af2e35 100644 --- a/comfyui_embedded_docs/docs/Flux2ImageNode/en.md +++ b/comfyui_embedded_docs/docs/Flux2ImageNode/en.md @@ -1,28 +1,37 @@ -# Flux.2 Image Node +# Flux.2 Image + +Flux.2 Image Generate images using the Flux.2 [pro] or Flux.2 [max] model from a text prompt and optional reference images. This node sends your request to the BFL API, polls for the result, and returns the generated image as a tensor. ## Inputs +### Common Inputs + | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| +| `model` | The Flux.2 model version to use. Selecting a model unlocks additional parameters for width, height, and optional reference images. | DYNAMIC_COMBO | Yes | "Flux.2 [pro]"
"Flux.2 [max]" | | `prompt` | Prompt for the image generation or edit (default: empty string). | STRING | Yes | N/A | -| `model` | The Flux.2 model version to use. Selecting a model unlocks additional parameters for width, height, and optional reference images. | COMBO | Yes | `"Flux.2 [pro]"`
`"Flux.2 [max]"` | | `seed` | The random seed used for creating the noise. Can be set to randomize after each generation (default: 0). | INT | Yes | 0 to 18446744073709551615 | -**Additional Parameters (unlocked by `model` selection):** +### Flux.2 [pro] and Flux.2 [max] Inputs + +Shared by both models — the parameter sets are identical. + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `model.width` | The width of the generated image in pixels (default: 1024). | INT | Yes | 256 to 2048 (step 32) | +| `model.height` | The height of the generated image in pixels (default: 768). | INT | Yes | 256 to 2048 (step 32) | -When you select a model, the following parameters become available: +### Reference Inputs | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `model.width` | The width of the generated image in pixels. | INT | Yes | 256 to 1440 | -| `model.height` | The height of the generated image in pixels. | INT | Yes | 256 to 1440 | -| `model.images` | Optional reference images to guide the generation. A maximum of 8 images is supported. | IMAGE | No | 0 to 8 images | +| `model.images` | Optional reference image(s) for image-to-image generation. Up to 8 images. Growable slot: connect 1..8 items (`image_1`...`image_8`). | IMAGE | No | 0 to 8 images | -**Constraints:** -- The maximum number of reference images is 8. If more than 8 images are provided, an error will be raised. -- The `model.width` and `model.height` values affect the cost of the generation. +**Note:** +- The maximum number of reference images is 8. If more than 8 images are provided, an error is raised. +- The `model.width` and `model.height` values affect the generation cost. The cost also depends on the selected model and on whether reference images are provided. ## Outputs @@ -33,4 +42,4 @@ When you select a model, the following parameters become available: > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Flux2ImageNode/en.md) --- -**Source fingerprint (SHA-256):** `9627f120df5aedfef1203db2baf39926e1d6891ef30e56b4eac4c2baf5e032e8` +**Source fingerprint (SHA-256):** `2994564757e1c66ac6da7b45d227b27ceb0020ac6fc9e8cbe2b53fe9f70bc195` diff --git a/comfyui_embedded_docs/docs/Flux2ImageNode/es.md b/comfyui_embedded_docs/docs/Flux2ImageNode/es.md index 3a28a627e..d8b650f74 100644 --- a/comfyui_embedded_docs/docs/Flux2ImageNode/es.md +++ b/comfyui_embedded_docs/docs/Flux2ImageNode/es.md @@ -46,8 +46,8 @@ Cuando seleccionas un modelo, los siguientes parámetros estarán disponibles: | Parámetro | Descripción | Tipo de Dato | Obligatorio | Rango | | --- | --- | --- | --- | --- | -| `model.width` | El ancho de la imagen generada en píxeles. | INT | Sí | 256 a 1440 | -| `model.height` | La altura de la imagen generada en píxeles. | INT | Sí | 256 a 1440 | +| `ancho` | El ancho de la imagen generada en píxeles. | INT | Sí | 256 a 1440 | +| `altura` | La altura de la imagen generada en píxeles. | INT | Sí | 256 a 1440 | | `model.images` | Imágenes de referencia opcionales para guiar la generación. Se admite un máximo de 8 imágenes. | IMAGE | No | 0 a 8 imágenes | **Restricciones:** diff --git a/comfyui_embedded_docs/docs/Flux2ImageNode/fr.md b/comfyui_embedded_docs/docs/Flux2ImageNode/fr.md index 162577b67..92d83a11f 100644 --- a/comfyui_embedded_docs/docs/Flux2ImageNode/fr.md +++ b/comfyui_embedded_docs/docs/Flux2ImageNode/fr.md @@ -20,8 +20,8 @@ Lorsque vous sélectionnez un modèle, les paramètres suivants deviennent dispo | Paramètre | Description | Type de données | Requis | Plage | | --- | --- | --- | --- | --- | -| `model.width` | La largeur de l'image générée en pixels. | INT | Oui | 256 à 1440 | -| `model.height` | La hauteur de l'image générée en pixels. | INT | Oui | 256 à 1440 | +| `largeur` | La largeur de l'image générée en pixels. | INT | Oui | 256 à 1440 | +| `hauteur` | La hauteur de l'image générée en pixels. | INT | Oui | 256 à 1440 | | `model.images` | Images de référence optionnelles pour guider la génération. Un maximum de 8 images est pris en charge. | IMAGE | Non | 0 à 8 images | **Contraintes :** diff --git a/comfyui_embedded_docs/docs/Flux2ImageNode/ja.md b/comfyui_embedded_docs/docs/Flux2ImageNode/ja.md index 48f320494..2c66d3fcf 100644 --- a/comfyui_embedded_docs/docs/Flux2ImageNode/ja.md +++ b/comfyui_embedded_docs/docs/Flux2ImageNode/ja.md @@ -20,8 +20,8 @@ | パラメータ | 説明 | データ型 | 必須 | 範囲 | | --- | --- | --- | --- | --- | -| `model.width` | 生成画像の幅(ピクセル単位)。 | INT | はい | 256 ~ 1440 | -| `model.height` | 生成画像の高さ(ピクセル単位)。 | INT | はい | 256 ~ 1440 | +| `幅` | 生成画像の幅(ピクセル単位)。 | INT | はい | 256 ~ 1440 | +| `高さ` | 生成画像の高さ(ピクセル単位)。 | INT | はい | 256 ~ 1440 | | `model.images` | 生成をガイドするためのオプションの参照画像。最大 8 枚までサポートされます。 | IMAGE | いいえ | 0 ~ 8 枚の画像 | **制約事項:** diff --git a/comfyui_embedded_docs/docs/Flux2ImageNode/zh-TW.md b/comfyui_embedded_docs/docs/Flux2ImageNode/zh-TW.md index 2a9d5bd21..b543a4223 100644 --- a/comfyui_embedded_docs/docs/Flux2ImageNode/zh-TW.md +++ b/comfyui_embedded_docs/docs/Flux2ImageNode/zh-TW.md @@ -18,8 +18,8 @@ | 參數 | 說明 | 資料類型 | 必要 | 範圍 | | --- | --- | --- | --- | --- | -| `model.width` | 生成圖像的寬度(像素)。 | INT | 是 | 256 到 1440 | -| `model.height` | 生成圖像的高度(像素)。 | INT | 是 | 256 到 1440 | +| `寬度` | 生成圖像的寬度(像素)。 | INT | 是 | 256 到 1440 | +| `高度` | 生成圖像的高度(像素)。 | INT | 是 | 256 到 1440 | | `model.images` | 可選的參考圖像,用於引導生成。最多支援 8 張圖像。 | IMAGE | 否 | 0 到 8 張圖像 | **限制條件:** diff --git a/comfyui_embedded_docs/docs/Flux2ImageNode/zh.md b/comfyui_embedded_docs/docs/Flux2ImageNode/zh.md index c0d005fce..405815a62 100644 --- a/comfyui_embedded_docs/docs/Flux2ImageNode/zh.md +++ b/comfyui_embedded_docs/docs/Flux2ImageNode/zh.md @@ -18,8 +18,8 @@ | 参数 | 描述 | 数据类型 | 是否必需 | 取值范围 | | --- | --- | --- | --- | --- | -| `model.width` | 生成图像的宽度(像素)。 | INT | 是 | 256 至 1440 | -| `model.height` | 生成图像的高度(像素)。 | INT | 是 | 256 至 1440 | +| `宽度` | 生成图像的宽度(像素)。 | INT | 是 | 256 至 1440 | +| `高度` | 生成图像的高度(像素)。 | INT | 是 | 256 至 1440 | | `model.images` | 用于引导生成的可选参考图像。最多支持 8 张图像。 | IMAGE | 否 | 0 至 8 张图像 | **约束条件:** diff --git a/comfyui_embedded_docs/docs/Flux2Scheduler/en.md b/comfyui_embedded_docs/docs/Flux2Scheduler/en.md index b9af8aac5..769862b14 100644 --- a/comfyui_embedded_docs/docs/Flux2Scheduler/en.md +++ b/comfyui_embedded_docs/docs/Flux2Scheduler/en.md @@ -1,6 +1,6 @@ # Flux2Scheduler -The Flux2Scheduler node generates a sequence of noise levels (sigmas) for the denoising process, specifically tailored for the Flux model. It calculates a schedule based on the number of denoising steps and the dimensions of the target image, which influences the progression of noise removal during image generation. +Flux2Scheduler generates a sequence of noise levels (sigmas) for the denoising process, specifically tailored for the Flux model. It calculates a schedule based on the number of denoising steps and the dimensions of the target image, which influences the progression of noise removal during image generation. ## Inputs @@ -10,6 +10,8 @@ The Flux2Scheduler node generates a sequence of noise levels (sigmas) for the de | `width` | The width of the image to be generated, in pixels. This value influences the noise schedule calculation (default: 1024). | INT | Yes | 16 to 16384 | | `height` | The height of the image to be generated, in pixels. This value influences the noise schedule calculation (default: 1024). | INT | Yes | 16 to 16384 | +Note: The schedule is computed from the image sequence length, which is derived from `width` and `height` as `(width * height) / 256`, reflecting the model's 16x latent downsampling. Larger images produce longer sequences, which shifts the noise schedule accordingly. + ## Outputs | Output Name | Description | Data Type | @@ -19,4 +21,4 @@ The Flux2Scheduler node generates a sequence of noise levels (sigmas) for the de > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Flux2Scheduler/en.md) --- -**Source fingerprint (SHA-256):** `8276ee111ffc2146f9aff5852e2abf469137aecbf7ed098c521045d206cdc104` +**Source fingerprint (SHA-256):** `9606177f37f7bc03aef524623f03b7f24bcdc3d9327dcdf74863fe2befeb2b65` diff --git a/comfyui_embedded_docs/docs/Flux3ImageToVideoNode/en.md b/comfyui_embedded_docs/docs/Flux3ImageToVideoNode/en.md index 93a7e5e0e..0193049a3 100644 --- a/comfyui_embedded_docs/docs/Flux3ImageToVideoNode/en.md +++ b/comfyui_embedded_docs/docs/Flux3ImageToVideoNode/en.md @@ -1,4 +1,4 @@ -# Flux3ImageToVideoNode +# Flux 3 Image to Video Flux 3 Image to Video animates 1 to 10 images with FLUX 3. Each image becomes a frame of the clip: one image opens it, two morph from the first to the second, and more are spread across it or pinned to times you choose. @@ -7,17 +7,23 @@ Flux 3 Image to Video animates 1 to 10 images with FLUX 3. Each image becomes a | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| | `prompt` | How the scene should move and sound; the prompt is interpreted and expanded before generation. Must contain at least one character. | STRING | Yes | Multiline text (default: empty) | -| `keyframes` | 1 to 10 images, in playback order. Minimum 256x256 pixels each. Each keyframe becomes a point in the clip. | IMAGE | Yes | 1 to 10 images | -| `placement` | 'spread across the clip' lets FLUX 3 place the images (one opens the clip, two become its start and end); 'at times' pins every image to a second you choose. | STRING | Yes | `"spread across the clip"` (default)
`"at times"` | -| `times` | One time in seconds per image, comma-separated and increasing, e.g. '0, 2.5, 5'. Required when `placement` is `"at times"`. | STRING | No | Comma-separated seconds (default: "0") | -| `aspect_ratio` | Output aspect ratio. 'auto' picks one from the prompt and inputs. | STRING | Yes | `"auto"` (default)
plus other available options | -| `duration` | Clip length in seconds. 'auto' fits the length to the content. | STRING | Yes | `"auto"` (default)
plus other available options | -| `resolution` | Output resolution. | STRING | Yes | `"720p"` (default)
`"1080p"` | +| `keyframes` | 1 to 10 images, in playback order. Minimum 256x256 pixels each. Growable input: connect images as `image_1`, `image_2`, and so on. | IMAGE | Yes | 1 to 10 images | +| `placement` | "spread across the clip" lets FLUX 3 place the images (one opens the clip, two become its start and end); "at times" pins every image to a second you choose. | DYNAMIC_COMBO | Yes | `"spread across the clip"` (default)
`"at times"` | +| `times` | One time in seconds per image, comma-separated and increasing, e.g. "0, 2.5, 5". Only appears when `placement` is "at times"; one time is required for each keyframe image. | STRING | No | Comma-separated seconds (default: "0") | +| `aspect_ratio` | Output aspect ratio. "auto" picks one from the prompt and inputs. | COMBO | Yes | `"auto"` (default)
other available aspect ratios | +| `duration` | Clip length in seconds. "auto" fits the length to the content. | COMBO | Yes | `"auto"` (default)
other available durations | +| `resolution` | Output resolution. | COMBO | Yes | `"720p"` (default)
`"1080p"` | | `generate_audio` | Generate synchronized audio (ambient, speech, effects). Off produces a video with no audio track. | BOOLEAN | Yes | true / false (default: true) | | `safety_tolerance` | Moderation tolerance, 0 is the strictest. Requests that send images or video are capped at 2 whatever you set here. | INT | Yes | 0 to 4 (default: 2, advanced setting) | -| `seed` | Seed to determine if node should re-run; FLUX 3 picks its own seed, so actual results are nondeterministic regardless of this value. | INT | Yes | 0 to 4294967295 (default: 42, with control-after-generate) | +| `seed` | Seed to determine if node should re-run; FLUX 3 picks its own seed, so actual results are nondeterministic regardless of this value. | INT | Yes | 0 to 4294967295 (default: 42, control-after-generate) | -Note: `keyframes` is required — the node raises an error if no keyframe image is connected. When `placement` is `"spread across the clip"` and 3 or more images are provided, `duration` must be set to an explicit value (not `"auto"`); otherwise the node raises an error. When `placement` is `"at times"`, `times` must provide one time in seconds per image, in increasing order. Requests that send images are capped at a safety tolerance of 2 regardless of the value set. +Note: `keyframes` must contain at least one image; the node raises an error if none are connected. Each keyframe image must be at least 256x256 pixels and its aspect ratio cannot be more extreme than 64:1. + +When `placement` is "spread across the clip" and 3 or more keyframes are connected, `duration` must be set to an explicit value, not "auto"; otherwise the node raises an error. + +When `placement` is "at times", `times` must provide one time in seconds per image. The times must increase, cannot be negative, and the last time cannot be past the end of the clip (up to 20 seconds when `duration` is "auto"). + +Because this node sends images, `safety_tolerance` is capped at 2 regardless of the value you set. ## Outputs @@ -28,4 +34,4 @@ Note: `keyframes` is required — the node raises an error if no keyframe image > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Flux3ImageToVideoNode/en.md) --- -**Source fingerprint (SHA-256):** `3b9472194020ec98cd4e8c60463cdd0e9dc074ec6cbc1fc03d313894fa570ba8` +**Source fingerprint (SHA-256):** `1c49838dfa13adc2ed70a51094f0dd860df7207970b8dceab6bb273653d7161c` diff --git a/comfyui_embedded_docs/docs/Flux3ImageToVideoNode/fa.md b/comfyui_embedded_docs/docs/Flux3ImageToVideoNode/fa.md index fb60e14a1..a18f28036 100644 --- a/comfyui_embedded_docs/docs/Flux3ImageToVideoNode/fa.md +++ b/comfyui_embedded_docs/docs/Flux3ImageToVideoNode/fa.md @@ -6,16 +6,16 @@ Flux 3 Image to Video با استفاده از FLUX 3 بین ۱ تا ۱۰ تصو | پارامتر | توضیحات | نوع داده | الزامی | محدوده | |---------|---------|----------|--------|--------| -| `prompt` | چگونگی حرکت و صدای صحنه؛ این prompt پیش از تولید تفسیر و گسترش داده می‌شود. باید حداقل یک نویسه داشته باشد. | STRING | بله | Multiline text (default: empty) | -| `keyframes` | ۱ تا ۱۰ تصویر، به ترتیب پخش. هر کدام حداقل ۲۵۶×۲۵۶ پیکسل. هر کلیدفریم به یک نقطه در کلیپ تبدیل می‌شود. | IMAGE | بله | 1 تا 10 images | -| `placement` | «spread across the clip» به FLUX 3 اجازه می‌دهد تصاویر را جای‌گذاری کند (یک تصویر کلیپ را آغاز می‌کند، دو تصویر شروع و پایان آن می‌شوند)؛ «at times» هر تصویر را به ثانیه‌ای که شما انتخاب می‌کنید می‌چسباند. | STRING | بله | `"spread across the clip"` (پیش‌فرض)
`"at times"` | +| `پرامپت` | چگونگی حرکت و صدای صحنه؛ این prompt پیش از تولید تفسیر و گسترش داده می‌شود. باید حداقل یک نویسه داشته باشد. | STRING | بله | Multiline text (default: empty) | +| `کی‌فریم‌ها` | ۱ تا ۱۰ تصویر، به ترتیب پخش. هر کدام حداقل ۲۵۶×۲۵۶ پیکسل. هر کلیدفریم به یک نقطه در کلیپ تبدیل می‌شود. | IMAGE | بله | 1 تا 10 images | +| `جای‌گذاری` | «spread across the clip» به FLUX 3 اجازه می‌دهد تصاویر را جای‌گذاری کند (یک تصویر کلیپ را آغاز می‌کند، دو تصویر شروع و پایان آن می‌شوند)؛ «at times» هر تصویر را به ثانیه‌ای که شما انتخاب می‌کنید می‌چسباند. | STRING | بله | `"spread across the clip"` (پیش‌فرض)
`"at times"` | | `times` | برای هر تصویر یک زمان بر حسب ثانیه، با کاما جدا شده و افزایشی، مثلاً '0, 2.5, 5'. وقتی `placement` برابر «at times» است الزامی است. | STRING | خیر | Comma-separated seconds (default: "0") | -| `aspect_ratio` | نسبت تصویر خروجی. «auto» یکی را از روی prompt و ورودی‌ها انتخاب می‌کند. | STRING | بله | `"auto"` (پیش‌فرض)
به‌علاوه سایر گزینه‌های موجود | -| `duration` | مدت زمان کلیپ بر حسب ثانیه. «auto» طول را با محتوا هماهنگ می‌کند. | STRING | بله | `"auto"` (پیش‌فرض)
به‌علاوه سایر گزینه‌های موجود | -| `resolution` | وضوح خروجی. | STRING | بله | `"720p"` (پیش‌فرض)
`"1080p"` | -| `generate_audio` | تولید صدای همگام‌شده (محیطی، گفتار، افکت‌ها). حالت خاموش، ویدیویی بدون تراک صوتی تولید می‌کند. | BOOLEAN | بله | true / false (default: true) | -| `safety_tolerance` | تلورانس نظارت، ۰ سخت‌گیرانه‌ترین است. درخواست‌هایی که تصویر یا ویدیو ارسال می‌کنند، صرف‌نظر از مقداری که اینجا تنظیم کنید، در ۲ محدود می‌شوند. | INT | بله | 0 تا 4 (default: 2, advanced setting) | -| `seed` | مقدار seed برای تعیین اینکه آیا گره باید دوباره اجرا شود؛ FLUX 3 seed خودش را انتخاب می‌کند، بنابراین نتایج واقعی بدون توجه به این مقدار غیرقطعی هستند. | INT | بله | 0 تا 4294967295 (default: 42, with control-after-generate) | +| `نسبت تصویر` | نسبت تصویر خروجی. «auto» یکی را از روی prompt و ورودی‌ها انتخاب می‌کند. | STRING | بله | `"auto"` (پیش‌فرض)
به‌علاوه سایر گزینه‌های موجود | +| `مدت زمان` | مدت زمان کلیپ بر حسب ثانیه. «auto» طول را با محتوا هماهنگ می‌کند. | STRING | بله | `"auto"` (پیش‌فرض)
به‌علاوه سایر گزینه‌های موجود | +| `رزولوشن` | وضوح خروجی. | STRING | بله | `"720p"` (پیش‌فرض)
`"1080p"` | +| `تولید صدا` | تولید صدای همگام‌شده (محیطی، گفتار، افکت‌ها). حالت خاموش، ویدیویی بدون تراک صوتی تولید می‌کند. | BOOLEAN | بله | true / false (default: true) | +| `درجه تحمل ایمنی` | تلورانس نظارت، ۰ سخت‌گیرانه‌ترین است. درخواست‌هایی که تصویر یا ویدیو ارسال می‌کنند، صرف‌نظر از مقداری که اینجا تنظیم کنید، در ۲ محدود می‌شوند. | INT | بله | 0 تا 4 (default: 2, advanced setting) | +| `بذر (Seed)` | مقدار seed برای تعیین اینکه آیا گره باید دوباره اجرا شود؛ FLUX 3 seed خودش را انتخاب می‌کند، بنابراین نتایج واقعی بدون توجه به این مقدار غیرقطعی هستند. | INT | بله | 0 تا 4294967295 (default: 42, with control-after-generate) | نکته: `keyframes` الزامی است — اگر هیچ تصویر کلیدفریمی متصل نباشد، گره خطا می‌دهد. وقتی `placement` برابر «spread across the clip» است و ۳ یا بیشتر تصویر ارائه شده باشد، `duration` باید به یک مقدار صریح (نه «auto») تنظیم شود؛ در غیر این صورت گره خطا می‌دهد. وقتی `placement` برابر «at times» است، `times` باید برای هر تصویر یک زمان بر حسب ثانیه به ترتیب افزایشی ارائه دهد. درخواست‌هایی که تصویر ارسال می‌کنند صرف‌نظر از مقدار تنظیم‌شده، در تلورانس ایمنی ۲ محدود می‌شوند. diff --git a/comfyui_embedded_docs/docs/Flux3ImageToVideoNode/ja.md b/comfyui_embedded_docs/docs/Flux3ImageToVideoNode/ja.md index afb55c87e..cb5410747 100644 --- a/comfyui_embedded_docs/docs/Flux3ImageToVideoNode/ja.md +++ b/comfyui_embedded_docs/docs/Flux3ImageToVideoNode/ja.md @@ -6,16 +6,16 @@ Flux 3 Image to Video は、FLUX 3 を使用して 1 ~ 10 枚の画像をア | パラメータ | 説明 | データ型 | 必須 | 範囲 | |-----------|-------------|-----------|----------|-------| -| `prompt` | シーンの動きとサウンドを指定します。プロンプトは生成前に解釈・拡張されます。少なくとも 1 文字以上必要です。 | STRING | はい | 複数行テキスト(デフォルト: 空) | -| `keyframes` | 1 ~ 10 枚の画像を再生順に指定します。各画像は最小 256x256 ピクセルです。各キーフレームはクリップ内のポイントになります。 | IMAGE | はい | 1 ~ 10 枚の画像 | -| `placement` | `"spread across the clip"` は、FLUX 3 が画像を配置します(1 枚の画像でクリップが始まり、2 枚の画像でクリップの開始と終了になります)。`"at times"` は、各画像を選択した秒に固定します。 | STRING | はい | `"spread across the clip"`(デフォルト)
`"at times"` | +| `プロンプト` | シーンの動きとサウンドを指定します。プロンプトは生成前に解釈・拡張されます。少なくとも 1 文字以上必要です。 | STRING | はい | 複数行テキスト(デフォルト: 空) | +| `キーフレーム` | 1 ~ 10 枚の画像を再生順に指定します。各画像は最小 256x256 ピクセルです。各キーフレームはクリップ内のポイントになります。 | IMAGE | はい | 1 ~ 10 枚の画像 | +| `配置` | `"spread across the clip"` は、FLUX 3 が画像を配置します(1 枚の画像でクリップが始まり、2 枚の画像でクリップの開始と終了になります)。`"at times"` は、各画像を選択した秒に固定します。 | STRING | はい | `"spread across the clip"`(デフォルト)
`"at times"` | | `times` | 画像ごとに 1 つの時間(秒)をカンマ区切りで増加順に指定します(例: `'0, 2.5, 5'`)。`placement` が `"at times"` の場合に必須です。 | STRING | いいえ | カンマ区切りの秒数(デフォルト: `"0"`) | -| `aspect_ratio` | 出力のアスペクト比です。`"auto"` はプロンプトと入力から自動的に選択します。 | STRING | はい | `"auto"`(デフォルト)
その他の利用可能なオプション | -| `duration` | クリップの長さ(秒)です。`"auto"` はコンテンツに合わせて長さを調整します。 | STRING | はい | `"auto"`(デフォルト)
その他の利用可能なオプション | -| `resolution` | 出力解像度です。 | STRING | はい | `"720p"`(デフォルト)
`"1080p"` | -| `generate_audio` | 同期オーディオ(環境音、音声、効果音)を生成します。オフにすると、オーディオトラックのないビデオが生成されます。 | BOOLEAN | はい | true / false(デフォルト: true) | -| `safety_tolerance` | モデレーションの許容度です。0 が最も厳格です。画像またはビデオを送信するリクエストは、ここで設定した値に関係なく 2 に制限されます。 | INT | はい | 0 ~ 4(デフォルト: 2、詳細設定) | -| `seed` | ノードを再実行するかどうかを決定するシードです。FLUX 3 は独自のシードを選択するため、実際の結果はこの値に関係なく非決定的になります。 | INT | はい | 0 ~ 4294967295(デフォルト: 42、生成後コントロール付き) | +| `アスペクト比` | 出力のアスペクト比です。`"auto"` はプロンプトと入力から自動的に選択します。 | STRING | はい | `"auto"`(デフォルト)
その他の利用可能なオプション | +| `長さ` | クリップの長さ(秒)です。`"auto"` はコンテンツに合わせて長さを調整します。 | STRING | はい | `"auto"`(デフォルト)
その他の利用可能なオプション | +| `解像度` | 出力解像度です。 | STRING | はい | `"720p"`(デフォルト)
`"1080p"` | +| `音声生成` | 同期オーディオ(環境音、音声、効果音)を生成します。オフにすると、オーディオトラックのないビデオが生成されます。 | BOOLEAN | はい | true / false(デフォルト: true) | +| `安全許容度` | モデレーションの許容度です。0 が最も厳格です。画像またはビデオを送信するリクエストは、ここで設定した値に関係なく 2 に制限されます。 | INT | はい | 0 ~ 4(デフォルト: 2、詳細設定) | +| `シード` | ノードを再実行するかどうかを決定するシードです。FLUX 3 は独自のシードを選択するため、実際の結果はこの値に関係なく非決定的になります。 | INT | はい | 0 ~ 4294967295(デフォルト: 42、生成後コントロール付き) | 注: `keyframes` は必須です。キーフレーム画像が接続されていない場合、ノードはエラーを発生させます。`placement` が `"spread across the clip"` で 3 枚以上の画像が指定された場合、`duration` は明示的な値(`"auto"` 以外)に設定する必要があります。設定しない場合、ノードはエラーを発生させます。`placement` が `"at times"` の場合、`times` には画像ごとに 1 つの時間(秒)を増加順で指定する必要があります。画像を送信するリクエストは、設定された値に関係なく、モデレーション許容度 2 に制限されます。 diff --git a/comfyui_embedded_docs/docs/Flux3ImageToVideoNode/zh-TW.md b/comfyui_embedded_docs/docs/Flux3ImageToVideoNode/zh-TW.md index d804ad0c2..2cb0ab311 100644 --- a/comfyui_embedded_docs/docs/Flux3ImageToVideoNode/zh-TW.md +++ b/comfyui_embedded_docs/docs/Flux3ImageToVideoNode/zh-TW.md @@ -6,16 +6,16 @@ Flux 3 Image to Video 使用 FLUX 3 將 1 到 10 張圖片動畫化。每張圖 | 參數 | 描述 | 資料型別 | 必填 | 範圍 | |-----------|-------------|-----------|----------|-------| -| `prompt` | 場景應如何移動和發聲;提示詞在生成前會被解讀並擴展。必須至少包含一個字元。 | STRING | 是 | 多行文字(預設:空) | -| `keyframes` | 1 到 10 張圖片,按播放順序排列。每張至少 256x256 像素。每個關鍵影格成為影片片段中的一個點。 | IMAGE | 是 | 1 到 10 張圖片 | -| `placement` | 'spread across the clip' 讓 FLUX 3 放置圖片(一張開啟片段,兩張成為片段的開頭和結尾);'at times' 將每張圖片固定在你選擇的秒數。 | STRING | 是 | `"spread across the clip"`(預設)
`"at times"` | +| `提示詞` | 場景應如何移動和發聲;提示詞在生成前會被解讀並擴展。必須至少包含一個字元。 | STRING | 是 | 多行文字(預設:空) | +| `關鍵畫格` | 1 到 10 張圖片,按播放順序排列。每張至少 256x256 像素。每個關鍵影格成為影片片段中的一個點。 | IMAGE | 是 | 1 到 10 張圖片 | +| `放置方式` | 'spread across the clip' 讓 FLUX 3 放置圖片(一張開啟片段,兩張成為片段的開頭和結尾);'at times' 將每張圖片固定在你選擇的秒數。 | STRING | 是 | `"spread across the clip"`(預設)
`"at times"` | | `times` | 每張圖片對應一個以秒為單位的時間,以逗號分隔且遞增,例如 '0, 2.5, 5'。當 `placement` 為 `"at times"` 時必填。 | STRING | 否 | 逗號分隔的秒數(預設:"0") | -| `aspect_ratio` | 輸出的長寬比。'auto' 會根據提示詞和輸入自動選擇。 | STRING | 是 | `"auto"`(預設)
以及其他可用選項 | -| `duration` | 影片片段的長度(秒)。'auto' 會根據內容調整長度。 | STRING | 是 | `"auto"`(預設)
以及其他可用選項 | -| `resolution` | 輸出解析度。 | STRING | 是 | `"720p"`(預設)
`"1080p"` | -| `generate_audio` | 生成同步音訊(環境音、語音、特效)。關閉(Off)將產生沒有音軌的影片。 | BOOLEAN | 是 | true / false(預設:true) | -| `safety_tolerance` | 審核容忍度,0 為最嚴格。無論你在此設定什麼值,發送圖片或影片的請求都會被限制為 2。 | INT | 是 | 0 到 4(預設:2,進階設定) | -| `seed` | 決定節點是否應重新執行的種子值;FLUX 3 會自行選擇種子,因此無論此值為何,實際結果都是不確定的。 | INT | 是 | 0 到 4294967295(預設:42,具有生成後控制) | +| `長寬比` | 輸出的長寬比。'auto' 會根據提示詞和輸入自動選擇。 | STRING | 是 | `"auto"`(預設)
以及其他可用選項 | +| `時長` | 影片片段的長度(秒)。'auto' 會根據內容調整長度。 | STRING | 是 | `"auto"`(預設)
以及其他可用選項 | +| `解析度` | 輸出解析度。 | STRING | 是 | `"720p"`(預設)
`"1080p"` | +| `產生音訊` | 生成同步音訊(環境音、語音、特效)。關閉(Off)將產生沒有音軌的影片。 | BOOLEAN | 是 | true / false(預設:true) | +| `安全容忍度` | 審核容忍度,0 為最嚴格。無論你在此設定什麼值,發送圖片或影片的請求都會被限制為 2。 | INT | 是 | 0 到 4(預設:2,進階設定) | +| `種子` | 決定節點是否應重新執行的種子值;FLUX 3 會自行選擇種子,因此無論此值為何,實際結果都是不確定的。 | INT | 是 | 0 到 4294967295(預設:42,具有生成後控制) | 注意:`keyframes` 為必填項 — 如果未連接任何關鍵影格圖片,節點將產生錯誤。當 `placement` 為 `"spread across the clip"` 且提供了 3 張或更多圖片時,`duration` 必須設定為明確的值(不能是 `"auto"`);否則節點將產生錯誤。當 `placement` 為 `"at times"` 時,`times` 必須為每張圖片提供一個以秒為單位的遞增時間。發送圖片的請求無論設定為何值,其安全容忍度上限皆為 2。 diff --git a/comfyui_embedded_docs/docs/Flux3TextToVideoNode/en.md b/comfyui_embedded_docs/docs/Flux3TextToVideoNode/en.md index 1207566f5..8e247da9a 100644 --- a/comfyui_embedded_docs/docs/Flux3TextToVideoNode/en.md +++ b/comfyui_embedded_docs/docs/Flux3TextToVideoNode/en.md @@ -1,4 +1,4 @@ -# Flux3TextToVideoNode +# Flux 3 Text to Video Generates a video with synchronized audio from a text prompt using FLUX 3. The node sends your prompt to the FLUX 3 service, waits for the generation to finish, and returns the completed video clip. @@ -7,9 +7,9 @@ Generates a video with synchronized audio from a text prompt using FLUX 3. The n | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| | `prompt` | What you want, in plain language; the prompt is interpreted and expanded before generation. Describe ambient sound, music and speech separately for layered audio. (default: "") | STRING | Yes | Multiline text | -| `aspect_ratio` | Output aspect ratio. 'auto' picks one from the prompt and inputs. (default: "auto") | STRING | Yes | Multiple options available, including `"auto"` | -| `duration` | Clip length in seconds. 'auto' fits the length to the content. (default: "auto") | STRING | Yes | Multiple options available, including `"auto"` | -| `resolution` | Output resolution. (default: "720p") | STRING | Yes | `"720p"`
`"1080p"` | +| `aspect_ratio` | Output aspect ratio. 'auto' picks one from the prompt and inputs. (default: "auto") | COMBO | Yes | Multiple options available, including `"auto"` | +| `duration` | Clip length in seconds. 'auto' fits the length to the content. (default: "auto") | COMBO | Yes | Multiple options available, including `"auto"` | +| `resolution` | Output resolution. (default: "720p") | COMBO | Yes | `"720p"`
`"1080p"` | | `generate_audio` | Generate synchronized audio (ambient, speech, effects). Off produces a video with no audio track. (default: True) | BOOLEAN | Yes | True
False | | `safety_tolerance` | Moderation tolerance, 0 is the strictest. Requests that send images or video are capped at 2 whatever you set here. (default: 2) | INT | Yes | 0 to 4 | | `seed` | Seed to determine if node should re-run; FLUX 3 picks its own seed, so actual results are nondeterministic regardless of this value. (default: 42) | INT | Yes | 0 to 4294967295 | @@ -25,4 +25,4 @@ Note: The `seed` input includes Control After Generate controls in the UI. The d > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Flux3TextToVideoNode/en.md) --- -**Source fingerprint (SHA-256):** `35f5e5b1c6dd737afab78f53700997a458781d38149cb64fc60d86a86858b2e6` +**Source fingerprint (SHA-256):** `9957c78291c320b1a8a6a9c0edeefae5f1ccc21a6b58f0b39069c2df8decd100` diff --git a/comfyui_embedded_docs/docs/Flux3TextToVideoNode/fa.md b/comfyui_embedded_docs/docs/Flux3TextToVideoNode/fa.md index 35ec93827..8483be02f 100644 --- a/comfyui_embedded_docs/docs/Flux3TextToVideoNode/fa.md +++ b/comfyui_embedded_docs/docs/Flux3TextToVideoNode/fa.md @@ -6,13 +6,13 @@ | پارامتر | توضیحات | نوع داده | الزامی | محدوده | |-----------|-------------|-----------|----------|---------| -| `prompt` | آنچه می‌خواهید، به زبان ساده؛ prompt قبل از تولید تفسیر و گسترش داده می‌شود. برای صدای لایه‌ای، صدای محیط، موسیقی و گفتار را جداگانه توصیف کنید. (پیش‌فرض: "") | STRING | بله | متن چندخطی | -| `aspect_ratio` | نسبت تصویر خروجی. 'auto' یکی را از روی prompt و ورودی‌ها انتخاب می‌کند. (پیش‌فرض: "auto") | STRING | بله | چند گزینه موجود است، از جمله `"auto"` | -| `duration` | طول ویدیو به ثانیه. 'auto' طول را با محتوا هماهنگ می‌کند. (پیش‌فرض: "auto") | STRING | بله | چند گزینه موجود است، از جمله `"auto"` | -| `resolution` | رزولوشن خروجی. (پیش‌فرض: "720p") | STRING | بله | `"720p"`
`"1080p"` | -| `generate_audio` | تولید صدای هماهنگ‌شده (محیط، گفتار، افکت‌ها). حالت خاموش، ویدیویی بدون تراک صوتی تولید می‌کند. (پیش‌فرض: True) | BOOLEAN | بله | True
False | -| `safety_tolerance` | تلورانس پالایش محتوا، 0 سخت‌گیرانه‌ترین است. درخواست‌هایی که تصویر یا ویدیو ارسال می‌کنند، صرف‌نظر از مقداری که اینجا تعیین می‌کنید، سقف 2 دارند. (پیش‌فرض: 2) | INT | بله | 0 تا 4 | -| `seed` | Seed برای تعیین اینکه آیا گره باید دوباره اجرا شود؛ FLUX 3 seed خودش را انتخاب می‌کند، بنابراین نتایج واقعی بدون توجه به این مقدار غیرقطعی هستند. (پیش‌فرض: 42) | INT | بله | 0 تا 4294967295 | +| `پرامپت` | آنچه می‌خواهید، به زبان ساده؛ prompt قبل از تولید تفسیر و گسترش داده می‌شود. برای صدای لایه‌ای، صدای محیط، موسیقی و گفتار را جداگانه توصیف کنید. (پیش‌فرض: "") | STRING | بله | متن چندخطی | +| `نسبت تصویر` | نسبت تصویر خروجی. 'auto' یکی را از روی prompt و ورودی‌ها انتخاب می‌کند. (پیش‌فرض: "auto") | STRING | بله | چند گزینه موجود است، از جمله `"auto"` | +| `مدت زمان` | طول ویدیو به ثانیه. 'auto' طول را با محتوا هماهنگ می‌کند. (پیش‌فرض: "auto") | STRING | بله | چند گزینه موجود است، از جمله `"auto"` | +| `رزولوشن` | رزولوشن خروجی. (پیش‌فرض: "720p") | STRING | بله | `"720p"`
`"1080p"` | +| `تولید صدا` | تولید صدای هماهنگ‌شده (محیط، گفتار، افکت‌ها). حالت خاموش، ویدیویی بدون تراک صوتی تولید می‌کند. (پیش‌فرض: True) | BOOLEAN | بله | True
False | +| `درجه تحمل ایمنی` | تلورانس پالایش محتوا، 0 سخت‌گیرانه‌ترین است. درخواست‌هایی که تصویر یا ویدیو ارسال می‌کنند، صرف‌نظر از مقداری که اینجا تعیین می‌کنید، سقف 2 دارند. (پیش‌فرض: 2) | INT | بله | 0 تا 4 | +| `بذر (Seed)` | Seed برای تعیین اینکه آیا گره باید دوباره اجرا شود؛ FLUX 3 seed خودش را انتخاب می‌کند، بنابراین نتایج واقعی بدون توجه به این مقدار غیرقطعی هستند. (پیش‌فرض: 42) | INT | بله | 0 تا 4294967295 | توجه: ورودی `seed` شامل کنترل‌های Control After Generate در رابط کاربری است. قیمت نمایش‌داده‌شده بر اساس `resolution` و `duration` است: HD (720p) به‌ازای هر ثانیه ۰.۲۴۳۱ دلار و FHD (1080p) به‌ازای هر ثانیه ۰.۴۱۴۷ دلار محاسبه می‌شود. وقتی مدت‌زمان ثابت انتخاب شود، هزینه تخمینی کل ویدیو نشان داده می‌شود؛ وقتی `duration` برابر "auto" باشد، نرخ هر ثانیه نمایش داده می‌شود. diff --git a/comfyui_embedded_docs/docs/Flux3TextToVideoNode/ja.md b/comfyui_embedded_docs/docs/Flux3TextToVideoNode/ja.md index efa77d7f1..670e5a6b9 100644 --- a/comfyui_embedded_docs/docs/Flux3TextToVideoNode/ja.md +++ b/comfyui_embedded_docs/docs/Flux3TextToVideoNode/ja.md @@ -6,13 +6,13 @@ FLUX 3 を使用して、テキストプロンプトから同期オーディオ | パラメータ | 説明 | データ型 | 必須 | 範囲 | |-----------|-------------|-----------|----------|-------| -| `prompt` | 平易な言葉で希望する内容を記述します。プロンプトは生成前に解釈・拡張されます。レイヤードオーディオ用に、環境音、音楽、音声をそれぞれ分けて記述してください。(既定値: "") | STRING | はい | 複数行テキスト | -| `aspect_ratio` | 出力のアスペクト比。'auto' はプロンプトと入力から自動的に選択します。(既定値: "auto") | STRING | はい | 複数のオプションから選択可能(`"auto"`を含む) | -| `duration` | クリップの長さ(秒)。'auto' はコンテンツに合わせて長さを調整します。(既定値: "auto") | STRING | はい | 複数のオプションから選択可能(`"auto"`を含む) | -| `resolution` | 出力解像度。(既定値: "720p") | STRING | はい | `"720p"`
`"1080p"` | -| `generate_audio` | 同期オーディオ(環境音、音声、効果音)を生成します。オフにするとオーディオトラックなしのビデオが生成されます。(既定値: True) | BOOLEAN | はい | True
False | -| `safety_tolerance` | モデレーションの許容度。0 が最も厳格です。画像またはビデオを送信するリクエストは、ここでの設定値にかかわらず上限は 2 です。(既定値: 2) | INT | はい | 0~4 | -| `seed` | ノードを再実行するかどうかを決定するシード。FLUX 3 は独自のシードを選択するため、この値に関係なく実際の結果は非決定的です。(既定値: 42) | INT | はい | 0~4294967295 | +| `プロンプト` | 平易な言葉で希望する内容を記述します。プロンプトは生成前に解釈・拡張されます。レイヤードオーディオ用に、環境音、音楽、音声をそれぞれ分けて記述してください。(既定値: "") | STRING | はい | 複数行テキスト | +| `アスペクト比` | 出力のアスペクト比。'auto' はプロンプトと入力から自動的に選択します。(既定値: "auto") | STRING | はい | 複数のオプションから選択可能(`"auto"`を含む) | +| `長さ` | クリップの長さ(秒)。'auto' はコンテンツに合わせて長さを調整します。(既定値: "auto") | STRING | はい | 複数のオプションから選択可能(`"auto"`を含む) | +| `解像度` | 出力解像度。(既定値: "720p") | STRING | はい | `"720p"`
`"1080p"` | +| `音声生成` | 同期オーディオ(環境音、音声、効果音)を生成します。オフにするとオーディオトラックなしのビデオが生成されます。(既定値: True) | BOOLEAN | はい | True
False | +| `安全許容度` | モデレーションの許容度。0 が最も厳格です。画像またはビデオを送信するリクエストは、ここでの設定値にかかわらず上限は 2 です。(既定値: 2) | INT | はい | 0~4 | +| `シード` | ノードを再実行するかどうかを決定するシード。FLUX 3 は独自のシードを選択するため、この値に関係なく実際の結果は非決定的です。(既定値: 42) | INT | はい | 0~4294967295 | 注: `seed` 入力には、UI に Control After Generate コントロールが含まれます。表示される価格は `resolution` と `duration` に基づきます。HD(720p)は 1 秒あたり $0.2431、FHD(1080p)は 1 秒あたり $0.4147 で課金されます。固定の duration が選択されている場合は、クリップの推定合計費用が表示されます。`duration` が "auto" の場合は、1 秒あたりの料金が表示されます。 diff --git a/comfyui_embedded_docs/docs/Flux3TextToVideoNode/zh-TW.md b/comfyui_embedded_docs/docs/Flux3TextToVideoNode/zh-TW.md index c43fa033e..af5eb3662 100644 --- a/comfyui_embedded_docs/docs/Flux3TextToVideoNode/zh-TW.md +++ b/comfyui_embedded_docs/docs/Flux3TextToVideoNode/zh-TW.md @@ -6,13 +6,13 @@ | 參數 | 描述 | 資料類型 | 必填 | 範圍 | |-----------|-------------|-----------|----------|-------| -| `prompt` | 您想要的內容,以通俗語言表達;提示在生成前會被解讀和擴充。請分別描述環境音、音樂和語音,以實現分層音訊。(預設值:"") | STRING | 是 | 多行文字 | -| `aspect_ratio` | 輸出寬高比。`auto` 會從提示和輸入中選擇一個。(預設值:"auto") | STRING | 是 | 多個可用選項,包括 `"auto"` | -| `duration` | 影片長度(秒)。`auto` 會讓長度配合內容。(預設值:"auto") | STRING | 是 | 多個可用選項,包括 `"auto"` | -| `resolution` | 輸出解析度。(預設值:"720p") | STRING | 是 | `"720p"`
`"1080p"` | -| `generate_audio` | 生成同步音訊(環境音、語音、效果)。關閉會產生沒有音軌的影片。(預設值:True) | BOOLEAN | 是 | True
False | -| `safety_tolerance` | 審核容忍度,0 最嚴格。傳送圖片或影片的請求上限為 2,無論您在此設定什麼。(預設值:2) | INT | 是 | 0 到 4 | -| `seed` | 決定節點是否重新執行的種子;FLUX 3 自己選擇種子,因此無論此值為何,實際結果都是非確定性的。(預設值:42) | INT | 是 | 0 到 4294967295 | +| `提示詞` | 您想要的內容,以通俗語言表達;提示在生成前會被解讀和擴充。請分別描述環境音、音樂和語音,以實現分層音訊。(預設值:"") | STRING | 是 | 多行文字 | +| `長寬比` | 輸出寬高比。`auto` 會從提示和輸入中選擇一個。(預設值:"auto") | STRING | 是 | 多個可用選項,包括 `"auto"` | +| `時長` | 影片長度(秒)。`auto` 會讓長度配合內容。(預設值:"auto") | STRING | 是 | 多個可用選項,包括 `"auto"` | +| `解析度` | 輸出解析度。(預設值:"720p") | STRING | 是 | `"720p"`
`"1080p"` | +| `產生音訊` | 生成同步音訊(環境音、語音、效果)。關閉會產生沒有音軌的影片。(預設值:True) | BOOLEAN | 是 | True
False | +| `安全容忍度` | 審核容忍度,0 最嚴格。傳送圖片或影片的請求上限為 2,無論您在此設定什麼。(預設值:2) | INT | 是 | 0 到 4 | +| `種子` | 決定節點是否重新執行的種子;FLUX 3 自己選擇種子,因此無論此值為何,實際結果都是非確定性的。(預設值:42) | INT | 是 | 0 到 4294967295 | 注意:`seed` 輸入在 UI 中包含「生成後控制」(Control After Generate)控件。顯示的價格基於 `resolution` 和 `duration`:HD (720p) 每秒收費 $0.2431,FHD (1080p) 每秒收費 $0.4147。選擇固定長度時,會顯示影片剪輯的估計總成本;當 `duration` 為 "auto" 時,會顯示每秒費率。 diff --git a/comfyui_embedded_docs/docs/Flux3VideoContinuationNode/ar.md b/comfyui_embedded_docs/docs/Flux3VideoContinuationNode/ar.md index e8819a025..b97145bf8 100644 --- a/comfyui_embedded_docs/docs/Flux3VideoContinuationNode/ar.md +++ b/comfyui_embedded_docs/docs/Flux3VideoContinuationNode/ar.md @@ -6,14 +6,14 @@ | المعامل | الوصف | نوع البيانات | مطلوب | النطاق | |-----------|-------------|-----------|----------|-------| -| `video` | المقطع المطلوب مواصلته. | VIDEO | نعم | مقطع فيديو واحد | -| `prompt` | ما الذي يجب أن يعرضه الاستمرار؛ يتم تفسير الموجه وتوسيعه قبل التوليد. (الافتراضي: "") | STRING | نعم | نص غير فارغ (حرف واحد على الأقل) | -| `aspect_ratio` | نسبة العرض إلى الارتفاع للمخرجات. يختار 'auto' واحدة من الموجه والمدخلات. (الافتراضي: "auto") | STRING | نعم | خيارات محددة مسبقًا متعددة (الافتراضي: "auto") | -| `duration` | طول المقطع بالثواني. يعمل 'auto' على ملاءمة الطول مع المحتوى. (الافتراضي: "auto") | STRING | نعم | "auto" (الافتراضي)
قيم رقمية بالثواني | -| `resolution` | دقة المخرجات. (الافتراضي: "720p") | STRING | نعم | خيارات محددة مسبقًا متعددة (الافتراضي: "720p") | -| `generate_audio` | توليد صوت متزامن (محيط، كلام، مؤثرات). يؤدي إيقاف التشغيل إلى إنتاج فيديو بدون مسار صوتي. (الافتراضي: true) | BOOLEAN | نعم | true
false | -| `safety_tolerance` | درجة تحمل الاعتدال، 0 هي الأكثر صرامة. الطلبات التي ترسل صورًا أو فيديو يتم تحديد حد أقصى لها عند 2 مهما كانت القيمة المحددة هنا. (معامل متقدم، الافتراضي: 2) | INT | نعم | 0 - 4 (الحد الأقصى الفعلي: 2 لطلبات الفيديو) | -| `seed` | البذرة لتحديد ما إذا كانت العقدة ستعمل مرة أخرى؛ يختار FLUX 3 بذرته الخاصة، لذا تكون النتائج الفعلية غير حتمية بغض النظر عن هذه القيمة. (معامل متقدم، الافتراضي: 42) | INT | نعم | 0 - 4294967295 (0xFFFFFFFF) | +| `الفيديو` | المقطع المطلوب مواصلته. | VIDEO | نعم | مقطع فيديو واحد | +| `الموجه` | ما الذي يجب أن يعرضه الاستمرار؛ يتم تفسير الموجه وتوسيعه قبل التوليد. (الافتراضي: "") | STRING | نعم | نص غير فارغ (حرف واحد على الأقل) | +| `نسبة العرض إلى الارتفاع` | نسبة العرض إلى الارتفاع للمخرجات. يختار 'auto' واحدة من الموجه والمدخلات. (الافتراضي: "auto") | STRING | نعم | خيارات محددة مسبقًا متعددة (الافتراضي: "auto") | +| `المدة` | طول المقطع بالثواني. يعمل 'auto' على ملاءمة الطول مع المحتوى. (الافتراضي: "auto") | STRING | نعم | "auto" (الافتراضي)
قيم رقمية بالثواني | +| `الدقة` | دقة المخرجات. (الافتراضي: "720p") | STRING | نعم | خيارات محددة مسبقًا متعددة (الافتراضي: "720p") | +| `توليد الصوت` | توليد صوت متزامن (محيط، كلام، مؤثرات). يؤدي إيقاف التشغيل إلى إنتاج فيديو بدون مسار صوتي. (الافتراضي: true) | BOOLEAN | نعم | true
false | +| `تحمل الأمان` | درجة تحمل الاعتدال، 0 هي الأكثر صرامة. الطلبات التي ترسل صورًا أو فيديو يتم تحديد حد أقصى لها عند 2 مهما كانت القيمة المحددة هنا. (معامل متقدم، الافتراضي: 2) | INT | نعم | 0 - 4 (الحد الأقصى الفعلي: 2 لطلبات الفيديو) | +| `البذرة` | البذرة لتحديد ما إذا كانت العقدة ستعمل مرة أخرى؛ يختار FLUX 3 بذرته الخاصة، لذا تكون النتائج الفعلية غير حتمية بغض النظر عن هذه القيمة. (معامل متقدم، الافتراضي: 42) | INT | نعم | 0 - 4294967295 (0xFFFFFFFF) | ### ملاحظات diff --git a/comfyui_embedded_docs/docs/Flux3VideoContinuationNode/en.md b/comfyui_embedded_docs/docs/Flux3VideoContinuationNode/en.md index e6c2bc612..c051792d3 100644 --- a/comfyui_embedded_docs/docs/Flux3VideoContinuationNode/en.md +++ b/comfyui_embedded_docs/docs/Flux3VideoContinuationNode/en.md @@ -1,6 +1,6 @@ -# Flux3VideoContinuationNode +# Flux 3 Video Continuation -This node continues an existing video clip with FLUX 3, so the new clip carries on from the final frames of the video you provide. It uploads your source clip, sends the prompt and settings to the generation service, and returns the resulting continuation video once it is ready. +This node continues an existing video clip with FLUX 3: the new clip carries on from the final frames of the video you provide. It uploads your source clip, sends the prompt and settings to the generation service, and returns the resulting continuation video once it is ready. ## Inputs @@ -8,9 +8,9 @@ This node continues an existing video clip with FLUX 3, so the new clip carries |-----------|-------------|-----------|----------|-------| | `video` | The clip to continue. | VIDEO | Yes | Single video clip | | `prompt` | What the continuation should show; the prompt is interpreted and expanded before generation. (default: "") | STRING | Yes | Non-empty text (minimum 1 character) | -| `aspect_ratio` | Output aspect ratio. 'auto' picks one from the prompt and inputs. (default: "auto") | STRING | Yes | Multiple predefined options (default: "auto") | -| `duration` | Clip length in seconds. 'auto' fits the length to the content. (default: "auto") | STRING | Yes | "auto" (default)
Numeric values in seconds | -| `resolution` | Output resolution. (default: "720p") | STRING | Yes | Multiple predefined options (default: "720p") | +| `aspect_ratio` | Output aspect ratio. 'auto' picks one from the prompt and inputs. (default: "auto") | COMBO | Yes | "auto" (default)
Multiple predefined options | +| `duration` | Clip length in seconds. 'auto' fits the length to the content. (default: "auto") | COMBO | Yes | "auto" (default)
Numeric values in seconds | +| `resolution` | Output resolution. (default: "720p") | COMBO | Yes | "720p" (default)
"1080p"
Other predefined options | | `generate_audio` | Generate synchronized audio (ambient, speech, effects). Off produces a video with no audio track. (default: true) | BOOLEAN | Yes | true
false | | `safety_tolerance` | Moderation tolerance, 0 is the strictest. Requests that send images or video are capped at 2 whatever you set here. (advanced parameter, default: 2) | INT | Yes | 0 - 4 (effective maximum: 2 for video requests) | | `seed` | Seed to determine if node should re-run; FLUX 3 picks its own seed, so actual results are nondeterministic regardless of this value. (advanced parameter, default: 42) | INT | Yes | 0 - 4294967295 (0xFFFFFFFF) | @@ -20,7 +20,7 @@ This node continues an existing video clip with FLUX 3, so the new clip carries - `prompt` must contain at least one character, otherwise generation fails. Although the field defaults to an empty string, a non-empty prompt is required to run the node. - `safety_tolerance` accepts any value from 0 to 4, but since this node sends a video to the API, the effective tolerance is capped at 2 regardless of the selected value. - When `duration` is set to a number, it is converted to an integer number of seconds. The special value "auto" lets the service fit the length to the content. -- The exact option lists for `aspect_ratio`, `duration`, and `resolution` are defined internally by the node. Resolution options include at least "720p" (the default) and "1080p", which uses a different pricing rate. +- The exact option lists for `aspect_ratio`, `duration`, and `resolution` are defined internally by the node. Resolution options include at least "720p" (the default) and "1080p". Pricing is calculated from the selected `resolution` and `duration`; "1080p" is billed at $0.7579 per second, while other resolutions are billed at $0.5863 per second. - Authentication and node identification fields (`auth_token_comfy_org`, `api_key_comfy_org`, `unique_id`) are hidden and handled automatically by the platform. ## Outputs @@ -32,4 +32,4 @@ This node continues an existing video clip with FLUX 3, so the new clip carries > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Flux3VideoContinuationNode/en.md) --- -**Source fingerprint (SHA-256):** `4b3a3df86b870edd696d10d352c7123b9c6c60ce0b57910529fca60615efa9f9` +**Source fingerprint (SHA-256):** `129ad0eb62c368854cebb010cc886aecac4caab00f9111143b883d028d7c30d9` diff --git a/comfyui_embedded_docs/docs/Flux3VideoContinuationNode/fa.md b/comfyui_embedded_docs/docs/Flux3VideoContinuationNode/fa.md index 3282b326e..2fbd59ee8 100644 --- a/comfyui_embedded_docs/docs/Flux3VideoContinuationNode/fa.md +++ b/comfyui_embedded_docs/docs/Flux3VideoContinuationNode/fa.md @@ -6,14 +6,14 @@ | پارامتر | توضیحات | نوع داده | الزامی | محدوده | |---------|----------|----------|--------|--------| -| `video` | کلیپی که باید ادامه داده شود. | VIDEO | بله | یک کلیپ ویدیویی | -| `prompt` | محتوایی که ادامه باید نشان دهد؛ این prompt قبل از تولید تفسیر و بسط داده می‌شود. (پیش‌فرض: "") | STRING | بله | متن غیرخالی (حداقل ۱ کاراکتر) | -| `aspect_ratio` | نسبت ابعاد خروجی. 'auto' یکی را از روی prompt و ورودی‌ها انتخاب می‌کند. (پیش‌فرض: "auto") | STRING | بله | چند گزینه از پیش تعریف‌شده (پیش‌فرض: "auto") | -| `duration` | طول کلیپ به ثانیه. 'auto' طول را با محتوا هماهنگ می‌کند. (پیش‌فرض: "auto") | STRING | بله | "auto" (پیش‌فرض)
مقادیر عددی به ثانیه | -| `resolution` | رزلوشن خروجی. (پیش‌فرض: "720p") | STRING | بله | چند گزینه از پیش تعریف‌شده (پیش‌فرض: "720p") | -| `generate_audio` | تولید صدای هماهنگ (محیطی، گفتار، افکت‌ها). غیرفعال بودن، ویدیویی بدون track صوتی تولید می‌کند. (پیش‌فرض: true) | BOOLEAN | بله | true
false | -| `safety_tolerance` | میزان تحمل نظارت (moderation)، 0 سخت‌گیرانه‌ترین حالت است. درخواست‌هایی که تصویر یا ویدیو ارسال می‌کنند، صرف‌نظر از مقداری که اینجا تنظیم کنید، در 2 محدود می‌شوند. (پارامتر پیشرفته، پیش‌فرض: 2) | INT | بله | 0 - 4 (حداکثر مؤثر: 2 برای درخواست‌های ویدیویی) | -| `seed` | دانه (seed) برای تعیین اینکه آیا گره دوباره اجرا شود؛ FLUX 3 دانه خودش را انتخاب می‌کند، بنابراین نتایج واقعی بدون توجه به این مقدار قطعی نیستند. (پارامتر پیشرفته، پیش‌فرض: 42) | INT | بله | 0 - 4294967295 (0xFFFFFFFF) | +| `ویدیو` | کلیپی که باید ادامه داده شود. | VIDEO | بله | یک کلیپ ویدیویی | +| `پرامپت` | محتوایی که ادامه باید نشان دهد؛ این prompt قبل از تولید تفسیر و بسط داده می‌شود. (پیش‌فرض: "") | STRING | بله | متن غیرخالی (حداقل ۱ کاراکتر) | +| `نسبت تصویر` | نسبت ابعاد خروجی. 'auto' یکی را از روی prompt و ورودی‌ها انتخاب می‌کند. (پیش‌فرض: "auto") | STRING | بله | چند گزینه از پیش تعریف‌شده (پیش‌فرض: "auto") | +| `مدت زمان` | طول کلیپ به ثانیه. 'auto' طول را با محتوا هماهنگ می‌کند. (پیش‌فرض: "auto") | STRING | بله | "auto" (پیش‌فرض)
مقادیر عددی به ثانیه | +| `رزولوشن` | رزلوشن خروجی. (پیش‌فرض: "720p") | STRING | بله | چند گزینه از پیش تعریف‌شده (پیش‌فرض: "720p") | +| `تولید صدا` | تولید صدای هماهنگ (محیطی، گفتار، افکت‌ها). غیرفعال بودن، ویدیویی بدون track صوتی تولید می‌کند. (پیش‌فرض: true) | BOOLEAN | بله | true
false | +| `تحمل ایمنی` | میزان تحمل نظارت (moderation)، 0 سخت‌گیرانه‌ترین حالت است. درخواست‌هایی که تصویر یا ویدیو ارسال می‌کنند، صرف‌نظر از مقداری که اینجا تنظیم کنید، در 2 محدود می‌شوند. (پارامتر پیشرفته، پیش‌فرض: 2) | INT | بله | 0 - 4 (حداکثر مؤثر: 2 برای درخواست‌های ویدیویی) | +| `بذر` | دانه (seed) برای تعیین اینکه آیا گره دوباره اجرا شود؛ FLUX 3 دانه خودش را انتخاب می‌کند، بنابراین نتایج واقعی بدون توجه به این مقدار قطعی نیستند. (پارامتر پیشرفته، پیش‌فرض: 42) | INT | بله | 0 - 4294967295 (0xFFFFFFFF) | ### نکات diff --git a/comfyui_embedded_docs/docs/Flux3VideoContinuationNode/fr.md b/comfyui_embedded_docs/docs/Flux3VideoContinuationNode/fr.md index 48e74b2f2..622a26eb2 100644 --- a/comfyui_embedded_docs/docs/Flux3VideoContinuationNode/fr.md +++ b/comfyui_embedded_docs/docs/Flux3VideoContinuationNode/fr.md @@ -6,13 +6,13 @@ Ce nœud prolonge un clip vidéo existant avec FLUX 3, de sorte que le nouveau c | Paramètre | Description | Type de données | Requis | Plage | |-----------|-------------|-----------|----------|-------| -| `video` | Le clip à prolonger. | VIDEO | Oui | Clip vidéo unique | +| `vidéo` | Le clip à prolonger. | VIDEO | Oui | Clip vidéo unique | | `prompt` | Ce que la continuation doit montrer ; le prompt est interprété et développé avant la génération. (défaut : "") | STRING | Oui | Texte non vide (minimum 1 caractère) | -| `aspect_ratio` | Rapport d’aspect de sortie. 'auto' en choisit un à partir du prompt et des entrées. (défaut : "auto") | STRING | Oui | Plusieurs options prédéfinies (défaut : "auto") | -| `duration` | Durée du clip en secondes. 'auto' adapte la durée au contenu. (défaut : "auto") | STRING | Oui | "auto" (défaut)
Valeurs numériques en secondes | -| `resolution` | Résolution de sortie. (défaut : "720p") | STRING | Oui | Plusieurs options prédéfinies (défaut : "720p") | -| `generate_audio` | Générer un son synchronisé (ambiance, parole, effets). La valeur Off produit une vidéo sans piste audio. (défaut : true) | BOOLEAN | Oui | true
false | -| `safety_tolerance` | Tolérance de modération, 0 étant le plus strict. Les requêtes qui envoient des images ou des vidéos sont plafonnées à 2, quelle que soit la valeur définie ici. (paramètre avancé, défaut : 2) | INT | Oui | 0 - 4 (maximum effectif : 2 pour les requêtes vidéo) | +| `rapport d'aspect` | Rapport d’aspect de sortie. 'auto' en choisit un à partir du prompt et des entrées. (défaut : "auto") | STRING | Oui | Plusieurs options prédéfinies (défaut : "auto") | +| `durée` | Durée du clip en secondes. 'auto' adapte la durée au contenu. (défaut : "auto") | STRING | Oui | "auto" (défaut)
Valeurs numériques en secondes | +| `résolution` | Résolution de sortie. (défaut : "720p") | STRING | Oui | Plusieurs options prédéfinies (défaut : "720p") | +| `générer l'audio` | Générer un son synchronisé (ambiance, parole, effets). La valeur Off produit une vidéo sans piste audio. (défaut : true) | BOOLEAN | Oui | true
false | +| `tolérance de sécurité` | Tolérance de modération, 0 étant le plus strict. Les requêtes qui envoient des images ou des vidéos sont plafonnées à 2, quelle que soit la valeur définie ici. (paramètre avancé, défaut : 2) | INT | Oui | 0 - 4 (maximum effectif : 2 pour les requêtes vidéo) | | `seed` | Seed permettant de déterminer si le nœud doit s’exécuter à nouveau ; FLUX 3 choisit lui-même la seed, donc les résultats réels sont non déterministes quelle que soit cette valeur. (paramètre avancé, défaut : 42) | INT | Oui | 0 - 4294967295 (0xFFFFFFFF) | ### Remarques diff --git a/comfyui_embedded_docs/docs/Flux3VideoContinuationNode/ja.md b/comfyui_embedded_docs/docs/Flux3VideoContinuationNode/ja.md index efa4bb3b1..c5806ed8e 100644 --- a/comfyui_embedded_docs/docs/Flux3VideoContinuationNode/ja.md +++ b/comfyui_embedded_docs/docs/Flux3VideoContinuationNode/ja.md @@ -7,13 +7,13 @@ | パラメータ | 説明 | データ型 | 必須 | 範囲 | |-----------|-------------|-----------|----------|-------| | `video` | 継続するクリップ。 | VIDEO | はい | 単一のビデオクリップ | -| `prompt` | 継続部分に表示する内容。プロンプトは生成前に解釈・拡張されます。(デフォルト: "") | STRING | はい | 空でないテキスト(最小1文字) | -| `aspect_ratio` | 出力のアスペクト比。"auto" はプロンプトと入力から自動で選びます。(デフォルト: "auto") | STRING | はい | 複数の定義済みオプション(デフォルト: "auto") | -| `duration` | クリップの長さ(秒)。"auto" はコンテンツに合わせて長さを調整します。(デフォルト: "auto") | STRING | はい | "auto"(デフォルト)
秒単位の数値 | -| `resolution` | 出力解像度。(デフォルト: "720p") | STRING | はい | 複数の定義済みオプション(デフォルト: "720p") | -| `generate_audio` | 同期されたオーディオ(環境音、音声、効果音)を生成します。オフにすると音声トラックのないビデオが生成されます。(デフォルト: true) | BOOLEAN | はい | true
false | -| `safety_tolerance` | モデレーションの許容度。0 が最も厳格です。画像やビデオを送信するリクエストは、ここでどの値を設定しても実質上限は 2 になります。(詳細パラメータ、デフォルト: 2) | INT | はい | 0 - 4(ビデオリクエストの実質上限: 2) | -| `seed` | ノードを再実行するかどうかを決定するシード。FLUX 3 は独自のシードを選択するため、この値に関係なく実際の結果は非決定的です。(詳細パラメータ、デフォルト: 42) | INT | はい | 0 - 4294967295 (0xFFFFFFFF) | +| `プロンプト` | 継続部分に表示する内容。プロンプトは生成前に解釈・拡張されます。(デフォルト: "") | STRING | はい | 空でないテキスト(最小1文字) | +| `アスペクト比` | 出力のアスペクト比。"auto" はプロンプトと入力から自動で選びます。(デフォルト: "auto") | STRING | はい | 複数の定義済みオプション(デフォルト: "auto") | +| `長さ` | クリップの長さ(秒)。"auto" はコンテンツに合わせて長さを調整します。(デフォルト: "auto") | STRING | はい | "auto"(デフォルト)
秒単位の数値 | +| `解像度` | 出力解像度。(デフォルト: "720p") | STRING | はい | 複数の定義済みオプション(デフォルト: "720p") | +| `音声生成` | 同期されたオーディオ(環境音、音声、効果音)を生成します。オフにすると音声トラックのないビデオが生成されます。(デフォルト: true) | BOOLEAN | はい | true
false | +| `安全許容度` | モデレーションの許容度。0 が最も厳格です。画像やビデオを送信するリクエストは、ここでどの値を設定しても実質上限は 2 になります。(詳細パラメータ、デフォルト: 2) | INT | はい | 0 - 4(ビデオリクエストの実質上限: 2) | +| `シード` | ノードを再実行するかどうかを決定するシード。FLUX 3 は独自のシードを選択するため、この値に関係なく実際の結果は非決定的です。(詳細パラメータ、デフォルト: 42) | INT | はい | 0 - 4294967295 (0xFFFFFFFF) | ### 注記 diff --git a/comfyui_embedded_docs/docs/Flux3VideoContinuationNode/pt-BR.md b/comfyui_embedded_docs/docs/Flux3VideoContinuationNode/pt-BR.md index e5d61eb1a..450244498 100644 --- a/comfyui_embedded_docs/docs/Flux3VideoContinuationNode/pt-BR.md +++ b/comfyui_embedded_docs/docs/Flux3VideoContinuationNode/pt-BR.md @@ -6,14 +6,14 @@ Este nó dá continuidade a um videoclipe existente com o FLUX 3, fazendo com qu | Parâmetro | Descrição | Tipo de Dados | Obrigatório | Faixa | |-----------|-------------|-----------|----------|-------| -| `video` | O clipe a ser continuado. | VIDEO | Sim | Videoclipe único | +| `vídeo` | O clipe a ser continuado. | VIDEO | Sim | Videoclipe único | | `prompt` | O que a continuação deve mostrar; o prompt é interpretado e expandido antes da geração. (padrão: "") | STRING | Sim | Texto não vazio (mínimo de 1 caractere) | -| `aspect_ratio` | Proporção de aspecto da saída. 'auto' escolhe uma a partir do prompt e das entradas. (padrão: "auto") | STRING | Sim | Múltiplas opções predefinidas (padrão: "auto") | -| `duration` | Duração do clipe em segundos. 'auto' ajusta a duração ao conteúdo. (padrão: "auto") | STRING | Sim | "auto" (padrão)
Valores numéricos em segundos | -| `resolution` | Resolução da saída. (padrão: "720p") | STRING | Sim | Múltiplas opções predefinidas (padrão: "720p") | -| `generate_audio` | Gera áudio sincronizado (ambiente, fala, efeitos). Desativado produz um vídeo sem trilha de áudio. (padrão: true) | BOOLEAN | Sim | true
false | -| `safety_tolerance` | Tolerância de moderação; 0 é o mais estrito. Solicitações que enviam imagens ou vídeo são limitadas a 2, independentemente do valor definido aqui. (parâmetro avançado, padrão: 2) | INT | Sim | 0 - 4 (máximo efetivo: 2 para solicitações de vídeo) | -| `seed` | Semente para determinar se o nó deve ser executado novamente; o FLUX 3 escolhe sua própria semente, portanto os resultados reais são não determinísticos independentemente desse valor. (parâmetro avançado, padrão: 42) | INT | Sim | 0 - 4294967295 (0xFFFFFFFF) | +| `proporção` | Proporção de aspecto da saída. 'auto' escolhe uma a partir do prompt e das entradas. (padrão: "auto") | STRING | Sim | Múltiplas opções predefinidas (padrão: "auto") | +| `duração` | Duração do clipe em segundos. 'auto' ajusta a duração ao conteúdo. (padrão: "auto") | STRING | Sim | "auto" (padrão)
Valores numéricos em segundos | +| `resolução` | Resolução da saída. (padrão: "720p") | STRING | Sim | Múltiplas opções predefinidas (padrão: "720p") | +| `gerar áudio` | Gera áudio sincronizado (ambiente, fala, efeitos). Desativado produz um vídeo sem trilha de áudio. (padrão: true) | BOOLEAN | Sim | true
false | +| `tolerância de segurança` | Tolerância de moderação; 0 é o mais estrito. Solicitações que enviam imagens ou vídeo são limitadas a 2, independentemente do valor definido aqui. (parâmetro avançado, padrão: 2) | INT | Sim | 0 - 4 (máximo efetivo: 2 para solicitações de vídeo) | +| `semente` | Semente para determinar se o nó deve ser executado novamente; o FLUX 3 escolhe sua própria semente, portanto os resultados reais são não determinísticos independentemente desse valor. (parâmetro avançado, padrão: 42) | INT | Sim | 0 - 4294967295 (0xFFFFFFFF) | ### Notas diff --git a/comfyui_embedded_docs/docs/FluxDisableGuidance/en.md b/comfyui_embedded_docs/docs/FluxDisableGuidance/en.md index 037c1bb8e..7a35015b0 100644 --- a/comfyui_embedded_docs/docs/FluxDisableGuidance/en.md +++ b/comfyui_embedded_docs/docs/FluxDisableGuidance/en.md @@ -1,6 +1,6 @@ # FluxDisableGuidance -This node completely disables the guidance embed functionality for Flux and similar models. It takes conditioning data as input and removes the guidance component by setting it to None, effectively turning off guidance-based conditioning for the generation process. +This node completely disables the guidance embed on Flux and Flux-like models. It takes conditioning data as input and removes the guidance component by setting it to None, effectively turning off guidance-based conditioning for the generation process. ## Inputs @@ -17,4 +17,4 @@ This node completely disables the guidance embed functionality for Flux and simi > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FluxDisableGuidance/en.md) --- -**Source fingerprint (SHA-256):** `32d8dd4ac57f273a7064355ef819e720302bdc819b1ebfc93e42257a73e6c632` +**Source fingerprint (SHA-256):** `da3286194f9f5e7e49dd7047d6b0a0c97bb2570eaa9281abbd3992a743302fbf` diff --git a/comfyui_embedded_docs/docs/FluxEraseNode/en.md b/comfyui_embedded_docs/docs/FluxEraseNode/en.md index 44e6b0608..99ff9e059 100644 --- a/comfyui_embedded_docs/docs/FluxEraseNode/en.md +++ b/comfyui_embedded_docs/docs/FluxEraseNode/en.md @@ -11,15 +11,15 @@ Removes the masked object from an image and reconstructs the background. Paint t | `dilate_pixels` | Expands the mask boundaries to ensure clean coverage of the object's edges (default: 10) | INT | Yes | 0 to 25 | | `seed` | The random seed used for creating the noise (default: 0) | INT | No | 0 to 2147483647 | -**Note:** The input image must be at least 256x256 pixels in both dimensions. The mask is automatically resized to match the image dimensions. +**Note:** The input image must be at least 256x256 pixels in both dimensions. The mask is automatically resized to match the image dimensions, and the image's alpha channel is removed before processing. ## Outputs | Output Name | Description | Data Type | |-------------|-------------|-----------| -| `IMAGE` | The resulting image with the masked object removed and background reconstructed | IMAGE | +| `IMAGE` | The resulting image with the masked object removed and the background reconstructed | IMAGE | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FluxEraseNode/en.md) --- -**Source fingerprint (SHA-256):** `70cf3223bc1ba0528cf99e84f073bd7a1bbcc26164cef99f4deb1645038fbf11` +**Source fingerprint (SHA-256):** `124be59b9829aa9f865d7ec76cd68f7978e2010cd3a84f25742a1c17f2d70b76` diff --git a/comfyui_embedded_docs/docs/FluxKontextMultiReferenceLatentMethod/en.md b/comfyui_embedded_docs/docs/FluxKontextMultiReferenceLatentMethod/en.md index f8556a181..0475d66ef 100644 --- a/comfyui_embedded_docs/docs/FluxKontextMultiReferenceLatentMethod/en.md +++ b/comfyui_embedded_docs/docs/FluxKontextMultiReferenceLatentMethod/en.md @@ -7,7 +7,7 @@ The FluxKontextMultiReferenceLatentMethod node modifies conditioning data by set | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | | `conditioning` | The conditioning data to be modified with the reference latents method | CONDITIONING | Yes | - | -| `reference_latents_method` | The method to use for reference latents processing. If "uxo" or "uso" is selected, it will be converted to "uxo". This parameter is marked as advanced. | STRING | Yes | `"offset"`
`"index"`
`"uxo/uno"`
`"index_timestep_zero"` | +| `reference_latents_method` | The method to use for reference latents processing. If "uxo" or "uso" is selected, it will be converted to "uxo". This parameter is marked as advanced. | COMBO | Yes | `"offset"`
`"index"`
`"uxo/uno"`
`"index_timestep_zero"` | ## Outputs @@ -18,4 +18,4 @@ The FluxKontextMultiReferenceLatentMethod node modifies conditioning data by set > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FluxKontextMultiReferenceLatentMethod/en.md) --- -**Source fingerprint (SHA-256):** `822d08ad50f167257f32d74af27a6a7444a61a554108a27e78fea5f40aba4177` +**Source fingerprint (SHA-256):** `cbe069d0c9f8adbf7f8c909b1cd644d9cd3730e934f0e5856213ff06fa8ecc56` diff --git a/comfyui_embedded_docs/docs/FluxVTONode/en.md b/comfyui_embedded_docs/docs/FluxVTONode/en.md index 5fc65fcbe..4e0aa5a39 100644 --- a/comfyui_embedded_docs/docs/FluxVTONode/en.md +++ b/comfyui_embedded_docs/docs/FluxVTONode/en.md @@ -8,8 +8,8 @@ This node performs virtual try-on by dressing a person in a provided garment ima |-----------|-------------|-----------|----------|-------| | `person` | Image of the person to dress. | IMAGE | Yes | - | | `garment` | Image of the garment to apply. | IMAGE | Yes | - | -| `prompt` | Optional natural-language styling instruction (e.g. how the garment should fit). | STRING | No | - | -| `seed` | The random seed used for creating the noise. | INT | No | 0 to 18446744073709551615 | +| `prompt` | Optional natural-language styling instruction (e.g. how the garment should fit). (default: empty) | STRING | No | - | +| `seed` | The random seed used for creating the noise. (default: 0) | INT | No | 0 to 18446744073709551615 | ## Outputs @@ -20,4 +20,4 @@ This node performs virtual try-on by dressing a person in a provided garment ima > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FluxVTONode/en.md) --- -**Source fingerprint (SHA-256):** `137c4cf91a539605ade93a428567619fea9e6a71459dd92354878fa2f2ea4afa` +**Source fingerprint (SHA-256):** `5e0777dedcbd6275e31a16f6f5d78f4166147266c0c88531c5843a027702e594` diff --git a/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/ar.md b/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/ar.md new file mode 100644 index 000000000..cc1ba48d5 --- /dev/null +++ b/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/ar.md @@ -0,0 +1,28 @@ +# FluxVideoUpscaleNode + +فلوكس فيديو أبسكيل (Flux Video Upscale) يرفع دقة مقطع فيديو بمقدار 1.5 إلى 3 مرات باستخدام تقنية الاستبانة الفائقة من FLUX. في الوضع الإبداعي، يستعيد التفاصيل الدقيقة ويبتكرها؛ بينما في الوضع الدقيق، يعمل على توضيح المصدر دون تغييره. + +## المدخلات + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|-----------|-------------|-----------|----------|-------| +| `video` | مقطع مصدري مدته من 1 إلى 20 ثانية بنسبة أبعاد بين 1:4 و4:1. يُعرض الإخراج بمعدل 24 إطارًا في الثانية وبحد أقصى يبلغ حوالي 14.4 ميجابكسل لكل إطار. | VIDEO | نعم | مدة من 1 إلى 20 ثانية؛ نسبة أبعاد بين 1:4 و4:1؛ حد أدنى 64×64 بكسل | +| `upscale_factor` | حجم الإخراج نسبةً إلى المصدر. يتم تكبير المصادر الكبيرة جدًا بعامل أقل من المطلوب بسبب الحد الأقصى لكل إطار. (الافتراضي: 2.0) | FLOAT | نعم | 1.5 إلى 3.0 (الخطوة 0.1) | +| `mode` | يعمل الوضع 'creative' على استعادة التفاصيل الدقيقة وابتكارها، وهو الأفضل للمقاطع المُولّدة والأنسجة والمشاهد الطبيعية. أما الوضع 'precise' فيوضّح المصدر دون تغييره، وهو مناسب للوجوه والمنتجات ولقطات الفيديو الحقيقية. (الافتراضي: "creative") | COMBO | نعم | "creative"
"precise" | +| `prompt` | وصف اختياري للمقطع يوجّه التفاصيل المحسّنة. اتركه فارغًا للحصول على تكبير محايد. (الافتراضي: فارغ) | STRING | نعم | نص متعدد الأسطر | +| `auto_downscale` | يقلّل تلقائيًا حجم المصادر التي تزيد مساحتها عن 3840×2160 بكسل لتناسب حد الإدخال. يتم الحفاظ على نسبة الأبعاد؛ أما مقاطع الفيديو الأصغر فتبقى دون تغيير. (الافتراضي: true) | BOOLEAN | نعم | true
false | +| `safety_tolerance` | تسامح الاعتدال، حيث القيمة 0 هي الأكثر صرامة. (الافتراضي: 2، معلمة متقدمة) | INT | نعم | 0 إلى 4 | +| `seed` | تُستخدم قيمة البذرة لتحديد ما إذا كان يجب إعادة تشغيل العقدة؛ تختار FLUX البذور الخاصة بها، لذلك تكون النتائج الفعلية غير حتمية بغض النظر عن هذه القيمة. (الافتراضي: 42) | INT | نعم | 0 إلى 4294967295 | + +ملاحظة: يجب أن تتراوح مدة الفيديو المصدر بين 1 و20 ثانية وأن يكون حجمه 64×64 بكسل على الأقل. إذا تم تعطيل `auto_downscale` وتجاوزت مساحة الفيديو 3840×2160 بكسل، تُظهر العقدة خطأً. يُعرض فيديو الإخراج بمعدل 24 إطارًا في الثانية وبحد أقصى يبلغ حوالي 14.4 ميجابكسل لكل إطار، لذا قد يتم تكبير المصادر الكبيرة جدًا بعامل أقل من المطلوب. + +## المخرجات + +| اسم المخرج | الوصف | نوع البيانات | +|-------------|-------------|-----------| +| `video` | مقطع الفيديو المكبّر. | VIDEO | + +> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/ar.md) + +--- +**Source fingerprint (SHA-256):** `22dcf7c176705ce21a9032b1c9f4fe82ee6aa153f5057b90dac653b37281a677` diff --git a/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/en.md b/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/en.md new file mode 100644 index 000000000..f2fbacd77 --- /dev/null +++ b/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/en.md @@ -0,0 +1,28 @@ +# FluxVideoUpscaleNode + +Flux Video Upscale upscales a video clip by 1.5 to 3 times using FLUX super-resolution. In creative mode it restores and invents fine detail; in precise mode it sharpens the source without changing it. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `video` | Source clip of 1 to 20 seconds with an aspect ratio between 1:4 and 4:1. The output is rendered at 24 fps and capped at about 14.4 megapixels per frame. | VIDEO | Yes | 1 to 20 seconds duration; aspect ratio between 1:4 and 4:1; minimum 64x64 pixels | +| `upscale_factor` | Output size relative to the source. Very large sources are upscaled by less than the requested factor because of the per-frame cap. (default: 2.0) | FLOAT | Yes | 1.5 to 3.0 (step 0.1) | +| `mode` | 'creative' restores and invents fine detail, best for generated footage, textures and scenery. 'precise' sharpens the source without changing it, for faces, products and real footage. (default: "creative") | COMBO | Yes | "creative"
"precise" | +| `prompt` | Optional description of the clip that steers the enhanced detail. Leave empty for a neutral upscale. (default: empty) | STRING | Yes | Multiline text | +| `auto_downscale` | Automatically downscale sources larger than 3840x2160 pixels in area to fit the input limit. Aspect ratio is preserved; smaller videos are untouched. (default: true) | BOOLEAN | Yes | true
false | +| `safety_tolerance` | Moderation tolerance, 0 is the strictest. (default: 2, advanced parameter) | INT | Yes | 0 to 4 | +| `seed` | Seed to determine if node should re-run; FLUX picks its own seed, so actual results are nondeterministic regardless of this value. (default: 42) | INT | Yes | 0 to 4294967295 | + +Note: The source video must be between 1 and 20 seconds long and at least 64x64 pixels in size. If `auto_downscale` is disabled and the video area exceeds 3840x2160 pixels, the node raises an error. The output video is rendered at 24 fps and capped at about 14.4 megapixels per frame, so very large sources may be upscaled by less than the requested factor. + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `video` | The upscaled video clip. | VIDEO | + +> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/en.md) + +--- +**Source fingerprint (SHA-256):** `22dcf7c176705ce21a9032b1c9f4fe82ee6aa153f5057b90dac653b37281a677` diff --git a/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/es.md b/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/es.md new file mode 100644 index 000000000..9475ba260 --- /dev/null +++ b/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/es.md @@ -0,0 +1,28 @@ +# FluxVideoUpscaleNode + +Flux Video Upscale amplía un clip de video de 1.5 a 3 veces mediante la superresolución de FLUX. En el modo creativo restaura e inventa detalles finos; en el modo preciso nitifica el origen sin modificarlo. + +## Entradas + +| Parámetro | Descripción | Tipo de datos | Requerido | Rango | +|-----------|-------------|---------------|-----------|-------| +| `video` | Clip de origen de 1 a 20 segundos con una relación de aspecto entre 1:4 y 4:1. La salida se renderiza a 24 fps y tiene un límite de aproximadamente 14.4 megapíxeles por fotograma. | VIDEO | Sí | Duración de 1 a 20 segundos; relación de aspecto entre 1:4 y 4:1; mínimo de 64x64 píxeles | +| `upscale_factor` | Tamaño de salida en relación con el origen. Los orígenes muy grandes se amplían a una escala menor que el factor solicitado debido al límite por fotograma. (predeterminado: 2.0) | FLOAT | Sí | 1.5 a 3.0 (paso 0.1) | +| `mode` | El modo 'creative' restaura e inventa detalles finos, ideal para material generado, texturas y paisajes. El modo 'precise' nitifica el origen sin modificarlo, para rostros, productos y metraje real. (predeterminado: "creative") | COMBO | Sí | "creative"
"precise" | +| `prompt` | Descripción opcional del clip que orienta el detalle mejorado. Déjela vacía para una ampliación neutra. (predeterminado: vacío) | STRING | Sí | Texto multilínea | +| `auto_downscale` | Reduce automáticamente la escala de los orígenes cuya área supere los 3840x2160 píxeles para ajustarse al límite de entrada. Se conserva la relación de aspecto; los videos más pequeños no se modifican. (predeterminado: true) | BOOLEAN | Sí | true
false | +| `safety_tolerance` | Tolerancia de moderación; 0 es la más estricta. (predeterminado: 2, parámetro avanzado) | INT | Sí | 0 a 4 | +| `seed` | Semilla para determinar si el nodo debe volver a ejecutarse; FLUX elige su propia semilla, por lo que los resultados reales son no deterministas independientemente de este valor. (predeterminado: 42) | INT | Sí | 0 a 4294967295 | + +Nota: El video de origen debe durar entre 1 y 20 segundos y tener un tamaño mínimo de 64x64 píxeles. Si `auto_downscale` está deshabilitado y el área del video supera los 3840x2160 píxeles, el nodo genera un error. El video de salida se renderiza a 24 fps y tiene un límite de aproximadamente 14.4 megapíxeles por fotograma, por lo que los orígenes muy grandes pueden ampliarse a una escala menor que el factor solicitado. + +## Salidas + +| Nombre de salida | Descripción | Tipo de datos | +|------------------|-------------|---------------| +| `video` | El clip de video ampliado. | VIDEO | + +> Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/es.md) + +--- +**Source fingerprint (SHA-256):** `22dcf7c176705ce21a9032b1c9f4fe82ee6aa153f5057b90dac653b37281a677` diff --git a/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/fa.md b/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/fa.md new file mode 100644 index 000000000..faf8dac95 --- /dev/null +++ b/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/fa.md @@ -0,0 +1,26 @@ +# FluxVideoUpscaleNode + +## ورودی‌ها + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `video` | ویدیوی منبع با طول ۱ تا ۲۰ ثانیه و نسبت تصویر بین ۱:۴ و ۴:۱. خروجی با نرخ ۲۴ فریم بر ثانیه رندر شده و به حدود ۱۴٫۴ مگاپیکسل در هر فریم محدود می‌شود. | VIDEO | بله | مدت ۱ تا ۲۰ ثانیه؛ نسبت تصویر بین ۱:۴ و ۴:۱؛ حداقل ۶۴×۶۴ پیکسل | +| `upscale_factor` | اندازه خروجی نسبت به منبع. منابع بسیار بزرگ به دلیل سقف هر فریم، کمتر از ضریب درخواستی بزرگ‌نمایی می‌شوند. (پیش‌فرض: 2.0) | FLOAT | بله | 1.5 تا 3.0 (گام 0.1) | +| `mode` | حالت «creative» جزئیات دقیق را بازسازی و بازآفرینی می‌کند؛ بهترین گزینه برای تصاویر تولیدشده، بافت‌ها و مناظر. حالت «precise» منبع را بدون تغییر واضح‌سازی می‌کند؛ مناسب برای چهره‌ها، محصولات و تصاویر واقعی. (پیش‌فرض: "creative") | COMBO | بله | "creative"
"precise" | +| `prompt` | توضیح اختیاری از ویدیو که جزئیات بهبودیافته را هدایت می‌کند. برای بزرگ‌نمایی خنثی، آن را خالی بگذارید. (پیش‌فرض: خالی) | STRING | بله | متن چندخطی | +| `auto_downscale` | به‌طور خودکار منابعی که مساحت آن‌ها بزرگ‌تر از ۳۸۴۰×۲۱۶۰ پیکسل است را برای تطبیق با محدودیت ورودی، کوچک‌نمایی می‌کند. نسبت تصویر حفظ می‌شود؛ ویدیوهای کوچک‌تر دست‌نخورده می‌مانند. (پیش‌فرض: true) | BOOLEAN | بله | true
false | +| `safety_tolerance` | تلورانس پایش محتوا؛ ۰ سخت‌گیرانه‌ترین حالت است. (پیش‌فرض: 2، پارامتر پیشرفته) | INT | بله | 0 تا 4 | +| `seed` | دانه (Seed) برای تعیین اینکه گره دوباره اجرا شود یا نه؛ FLUX دانه‌ی خود را انتخاب می‌کند، بنابراین نتایج واقعی بدون توجه به این مقدار قطعی نیستند. (پیش‌فرض: 42) | INT | بله | 0 تا 4294967295 | + +توجه: ویدیوی منبع باید بین ۱ تا ۲۰ ثانیه طول و حداقل ۶۴×۶۴ پیکسل اندازه داشته باشد. اگر `auto_downscale` غیرفعال باشد و مساحت ویدیو از ۳۸۴۰×۲۱۶۰ پیکسل بیشتر شود، گره خطا صادر می‌کند. ویدیوی خروجی با نرخ ۲۴ فریم بر ثانیه رندر شده و به حدود ۱۴٫۴ مگاپیکسل در هر فریم محدود می‌شود؛ بنابراین منابع بسیار بزرگ ممکن است کمتر از ضریب درخواستی بزرگ‌نمایی شوند. + +## خروجی‌ها + +| نام خروجی | توضیحات | نوع داده | +|-------------|-------------|-----------| +| `video` | ویدیوی بزرگ‌نمایی‌شده. | VIDEO | + +> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/fa.md) + +--- +**Source fingerprint (SHA-256):** `22dcf7c176705ce21a9032b1c9f4fe82ee6aa153f5057b90dac653b37281a677` diff --git a/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/fr.md b/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/fr.md new file mode 100644 index 000000000..a81cbe272 --- /dev/null +++ b/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/fr.md @@ -0,0 +1,28 @@ +# FluxVideoUpscaleNode + +Flux Video Upscale agrandit un clip vidéo de 1,5 à 3 fois grâce à la super-résolution FLUX. En mode créatif, il restaure et invente des détails fins ; en mode précis, il accentue la netteté de la source sans la modifier. + +## Entrées + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `video` | Clip source d'une durée de 1 à 20 secondes avec un rapport hauteur/largeur compris entre 1:4 et 4:1. La sortie est rendue à 24 fps et plafonnée à environ 14,4 mégapixels par image. | VIDEO | Oui | Durée de 1 à 20 secondes ; rapport hauteur/largeur entre 1:4 et 4:1 ; minimum 64x64 pixels | +| `upscale_factor` | Taille de sortie par rapport à la source. Les sources très grandes sont agrandies d'un facteur inférieur à celui demandé en raison du plafond par image. (par défaut : 2.0) | FLOAT | Oui | 1.5 à 3.0 (pas 0.1) | +| `mode` | Le mode 'creative' restaure et invente des détails fins, idéal pour les séquences générées, les textures et les paysages. Le mode 'precise' accentue la netteté de la source sans la modifier, pour les visages, les produits et les séquences réelles. (par défaut : "creative") | COMBO | Oui | "creative"
"precise" | +| `prompt` | Description facultative du clip qui oriente les détails améliorés. Laissez vide pour un agrandissement neutre. (par défaut : vide) | STRING | Oui | Texte multiligne | +| `auto_downscale` | Réduit automatiquement les sources dont la surface dépasse 3840x2160 pixels pour respecter la limite d'entrée. Le rapport hauteur/largeur est préservé ; les vidéos plus petites ne sont pas modifiées. (par défaut : true) | BOOLEAN | Oui | true
false | +| `safety_tolerance` | Tolérance de modération, 0 est le plus strict. (par défaut : 2, paramètre avancé) | INT | Oui | 0 à 4 | +| `seed` | Seed pour déterminer si le nœud doit se réexécuter ; FLUX choisit sa propre seed, donc les résultats réels sont non déterministes quelle que soit cette valeur. (par défaut : 42) | INT | Oui | 0 à 4294967295 | + +Remarque : La vidéo source doit avoir une durée comprise entre 1 et 20 secondes et une taille d'au moins 64x64 pixels. Si `auto_downscale` est désactivé et que la zone vidéo dépasse 3840x2160 pixels, le nœud lève une erreur. La vidéo de sortie est rendue à 24 fps et plafonnée à environ 14,4 mégapixels par image, donc les sources très grandes peuvent être agrandies d'un facteur inférieur à celui demandé. + +## Sorties + +| Nom de sortie | Description | Type de données | +|---------------|-------------|-----------------| +| `video` | Le clip vidéo agrandi. | VIDEO | + +> Cette documentation a été générée par IA. Si vous trouvez des erreurs ou avez des suggestions d'amélioration, n'hésitez pas à contribuer ! [Modifier sur GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/fr.md) + +--- +**Source fingerprint (SHA-256):** `22dcf7c176705ce21a9032b1c9f4fe82ee6aa153f5057b90dac653b37281a677` diff --git a/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/ja.md b/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/ja.md new file mode 100644 index 000000000..20b4ba460 --- /dev/null +++ b/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/ja.md @@ -0,0 +1,28 @@ +# FluxVideoUpscaleNode + +Flux Video Upscaleは、FLUX超解像を使用してビデオクリップを1.5倍から3倍に拡大します。クリエイティブモードでは微細なディテールを復元・生成し、プレサイスモードではソースを変更せずにシャープにします。 + +## 入力 + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `video` | 1秒から20秒のソースクリップで、アスペクト比が1:4から4:1の間である必要があります。出力は24 fpsでレンダリングされ、1フレームあたり約14.4メガピクセルに制限されます。 | VIDEO | Yes | 1 to 20 seconds duration; aspect ratio between 1:4 and 4:1; minimum 64x64 pixels | +| `upscale_factor` | ソースに対する出力サイズ。フレームごとの上限があるため、非常に大きなソースは要求された倍率よりも小さい倍率で拡大されます。(デフォルト: 2.0) | FLOAT | Yes | 1.5 to 3.0 (step 0.1) | +| `mode` | 'creative' は微細なディテールを復元・生成し、生成映像、テクスチャ、風景に最適です。'precise' はソースを変更せずにシャープにし、顔、製品、実写映像に適しています。(デフォルト: "creative") | COMBO | Yes | "creative"
"precise" | +| `prompt` | 拡大されるディテールを方向付ける、クリップの任意の説明文。ニュートラルな拡大を行うには空のままにします。(デフォルト: 空) | STRING | Yes | Multiline text | +| `auto_downscale` | 入力制限に収まるように、面積が3840x2160ピクセルより大きいソースを自動的にダウンスケールします。アスペクト比は保持され、小さいビデオは変更されません。(デフォルト: true) | BOOLEAN | Yes | true
false | +| `safety_tolerance` | モデレーションの許容度で、0が最も厳格です。(デフォルト: 2、上級者向けパラメータ) | INT | Yes | 0 to 4 | +| `seed` | ノードを再実行するかどうかを決定するシード。FLUXが独自のシードを選択するため、この値に関係なく実際の結果は非決定的です。(デフォルト: 42) | INT | Yes | 0 to 4294967295 | + +注:ソースビデオは1秒以上20秒以下で、サイズが少なくとも64x64ピクセルである必要があります。`auto_downscale` が無効で、ビデオの面積が3840x2160ピクセルを超える場合、ノードはエラーを発生させます。出力ビデオは24 fpsでレンダリングされ、1フレームあたり約14.4メガピクセルに制限されるため、非常に大きなソースは要求された倍率よりも小さい倍率で拡大される場合があります。 + +## 出力 + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `video` | 拡大されたビデオクリップ。 | VIDEO | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/ja.md) + +--- +**Source fingerprint (SHA-256):** `22dcf7c176705ce21a9032b1c9f4fe82ee6aa153f5057b90dac653b37281a677` diff --git a/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/ko.md b/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/ko.md new file mode 100644 index 000000000..70ff4db27 --- /dev/null +++ b/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/ko.md @@ -0,0 +1,28 @@ +# FluxVideoUpscaleNode + +Flux Video Upscale은 FLUX 초해상도를 사용하여 비디오 클립을 1.5배에서 3배까지 확대합니다. 크리에이티브 모드에서는 미세한 디테일을 복원하고 창조하며, 정밀 모드에서는 소스를 변경하지 않고 선명하게 합니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `video` | 1~20초 길이의 소스 클립이며 종횡비는 1:4에서 4:1 사이입니다. 출력은 24fps로 렌더링되며 프레임당 약 14.4메가픽셀로 제한됩니다. | VIDEO | 예 | 1~20초 길이; 종횡비 1:4~4:1; 최소 64x64픽셀 | +| `upscale_factor` | 소스 대비 출력 크기입니다. 소스가 매우 큰 경우 프레임당 제한 때문에 요청한 배율보다 덜 확대됩니다. (기본값: 2.0) | FLOAT | 예 | 1.5~3.0 (0.1 단계) | +| `mode` | 'creative'는 미세한 디테일을 복원하고 창조하며, 생성된 푸티지, 텍스처, 풍경에 가장 적합합니다. 'precise'는 소스를 변경하지 않고 선명하게 하여 얼굴, 제품, 실사 푸티지에 적합합니다. (기본값: "creative") | COMBO | 예 | "creative"
"precise" | +| `prompt` | 향상된 디테일을 안내하는 클립의 선택적 설명입니다. 중립적인 확대를 위해 비워 두십시오. (기본값: 비어 있음) | STRING | 예 | 여러 줄 텍스트 | +| `auto_downscale` | 면적이 3840x2160픽셀보다 큰 소스를 입력 제한에 맞게 자동으로 축소합니다. 종횡비는 유지되며, 더 작은 비디오는 변경되지 않습니다. (기본값: true) | BOOLEAN | 예 | true
false | +| `safety_tolerance` | 검열 허용 오차로, 0이 가장 엄격합니다. (기본값: 2, 고급 매개변수) | INT | 예 | 0 ~ 4 | +| `seed` | 노드를 다시 실행할지 결정하는 시드입니다. FLUX는 자체 시드를 선택하므로 이 값과 관계없이 실제 결과는 비결정적입니다. (기본값: 42) | INT | 예 | 0 ~ 4294967295 | + +참고: 소스 비디오는 길이가 1~20초이고 크기가 최소 64x64픽셀이어야 합니다. `auto_downscale`이 비활성화된 상태에서 비디오 면적이 3840x2160픽셀을 초과하면 노드에서 오류가 발생합니다. 출력 비디오는 24fps로 렌더링되며 프레임당 약 14.4메가픽셀로 제한되므로 매우 큰 소스는 요청한 배율보다 덜 확대될 수 있습니다. + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `video` | 확대된 비디오 클립입니다. | VIDEO | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/ko.md) + +--- +**Source fingerprint (SHA-256):** `22dcf7c176705ce21a9032b1c9f4fe82ee6aa153f5057b90dac653b37281a677` diff --git a/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/pt-BR.md b/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/pt-BR.md new file mode 100644 index 000000000..dbbf8a0ee --- /dev/null +++ b/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/pt-BR.md @@ -0,0 +1,28 @@ +# FluxVideoUpscaleNode + +Flux Video Upscale amplia um clipe de vídeo em 1,5 a 3 vezes usando super-resolução FLUX. No modo criativo, ele restaura e inventa detalhes finos; no modo preciso, ele nitidiza a origem sem alterá-la. + +## Entradas + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | +|-----------|-------------|-----------|----------|-------| +| `video` | Clipe de origem de 1 a 20 segundos com proporção de aspecto entre 1:4 e 4:1. A saída é renderizada a 24 fps e limitada a cerca de 14,4 megapixels por quadro. | VIDEO | Sim | duração de 1 a 20 segundos; proporção de aspecto entre 1:4 e 4:1; mínimo de 64x64 pixels | +| `upscale_factor` | Tamanho da saída em relação à origem. Origens muito grandes são ampliadas por um fator menor que o solicitado devido ao limite por quadro. (padrão: 2,0) | FLOAT | Sim | 1,5 a 3,0 (passo 0,1) | +| `mode` | 'creative' restaura e inventa detalhes finos, ideal para gravações geradas, texturas e paisagens. 'precise' nitidiza a origem sem alterá-la, para rostos, produtos e gravações reais. (padrão: "creative") | COMBO | Sim | "creative"
"precise" | +| `prompt` | Descrição opcional do clipe que orienta o detalhe aprimorado. Deixe vazio para uma ampliação neutra. (padrão: vazio) | STRING | Sim | Texto multilinha | +| `auto_downscale` | Redimensiona automaticamente origens maiores que 3840x2160 pixels em área para caber no limite de entrada. A proporção de aspecto é preservada; vídeos menores não são alterados. (padrão: true) | BOOLEAN | Sim | true
false | +| `safety_tolerance` | Tolerância de moderação, 0 é o mais estrito. (padrão: 2, parâmetro avançado) | INT | Sim | 0 a 4 | +| `seed` | Semente para determinar se o nó deve ser executado novamente; o FLUX escolhe sua própria semente, portanto os resultados reais são não determinísticos independentemente desse valor. (padrão: 42) | INT | Sim | 0 a 4294967295 | + +Nota: O vídeo de origem deve ter entre 1 e 20 segundos de duração e pelo menos 64x64 pixels de tamanho. Se `auto_downscale` estiver desativado e a área do vídeo exceder 3840x2160 pixels, o nó gerará um erro. O vídeo de saída é renderizado a 24 fps e limitado a cerca de 14,4 megapixels por quadro, portanto origens muito grandes podem ser ampliadas por um fator menor que o solicitado. + +## Saídas + +| Nome da Saída | Descrição | Tipo de Dados | +|-------------|-------------|-----------| +| `video` | O clipe de vídeo ampliado. | VIDEO | + +> Esta documentação foi gerada por IA. Se você encontrar erros ou tiver sugestões de melhoria, sinta-se à vontade para contribuir! [Editar no GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/pt-BR.md) + +--- +**Source fingerprint (SHA-256):** `22dcf7c176705ce21a9032b1c9f4fe82ee6aa153f5057b90dac653b37281a677` diff --git a/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/ru.md b/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/ru.md new file mode 100644 index 000000000..f1e6817ed --- /dev/null +++ b/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/ru.md @@ -0,0 +1,28 @@ +# FluxVideoUpscaleNode + +Flux Video Upscale увеличивает видеоклип в 1,5–3 раза с помощью суперразрешения FLUX. В творческом режиме он восстанавливает и создаёт мелкие детали; в точном режиме — повышает резкость исходника без его изменения. + +## Входы + +| Параметр | Описание | Тип данных | Обязательность | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `video` | Исходный клип длительностью от 1 до 20 секунд с соотношением сторон от 1:4 до 4:1. Выходное видео рендерится при 24 кадрах в секунду и ограничено примерно 14,4 мегапикселя на кадр. | VIDEO | Да | от 1 до 20 секунд; соотношение сторон от 1:4 до 4:1; минимум 64x64 пикселя | +| `upscale_factor` | Размер выходного видео относительно исходного. Очень большие источники увеличиваются меньше запрошенного коэффициента из-за ограничения на кадр. (по умолчанию: 2.0) | FLOAT | Да | 1.5 to 3.0 (step 0.1) | +| `mode` | 'creative' восстанавливает и создаёт мелкие детали, лучше всего подходит для сгенерированных видео, текстур и пейзажей. 'precise' повышает резкость исходника без его изменения, для лиц, товаров и реальных видео. (по умолчанию: "creative") | COMBO | Да | "creative"
"precise" | +| `prompt` | Необязательное описание клипа, которое направляет улучшение деталей. Оставьте пустым для нейтрального увеличения. (по умолчанию: пусто) | STRING | Да | Многострочный текст | +| `auto_downscale` | Автоматически уменьшать источники с площадью больше 3840x2160 пикселей для соответствия ограничению входа. Соотношение сторон сохраняется; видео меньшего размера не изменяются. (по умолчанию: true) | BOOLEAN | Да | true
false | +| `safety_tolerance` | Допуск модерации, 0 — самый строгий. (по умолчанию: 2, расширенный параметр) | INT | Да | 0 to 4 | +| `seed` | Сид для определения необходимости повторного запуска узла; FLUX выбирает свой собственный сид, поэтому фактические результаты недетерминированы независимо от этого значения. (по умолчанию: 42) | INT | Да | 0 to 4294967295 | + +Примечание: исходное видео должно быть длительностью от 1 до 20 секунд и размером не менее 64x64 пикселей. Если `auto_downscale` отключен и площадь видео превышает 3840x2160 пикселей, узел выдаст ошибку. Выходное видео рендерится при 24 кадрах в секунду и ограничено примерно 14,4 мегапикселя на кадр, поэтому очень большие источники могут быть увеличены меньше запрошенного коэффициента. + +## Выходы + +| Имя выхода | Описание | Тип данных | +|-------------|-------------|-----------| +| `video` | Увеличенный видеоклип. | VIDEO | + +> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/ru.md) + +--- +**Source fingerprint (SHA-256):** `22dcf7c176705ce21a9032b1c9f4fe82ee6aa153f5057b90dac653b37281a677` diff --git a/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/tr.md b/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/tr.md new file mode 100644 index 000000000..1d46a4cc4 --- /dev/null +++ b/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/tr.md @@ -0,0 +1,28 @@ +# FluxVideoUpscaleNode + +Flux Video Upscale, FLUX süper çözünürlüğünü kullanarak bir video klibini 1,5 ila 3 kat büyütür. Creative modunda ince ayrıntıları geri kazandırır ve üretir; precise modunda ise kaynağı değiştirmeden keskinleştirir. + +## Girdiler + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +|-----------|-------------|-----------|----------|-------| +| `video` | 1 ila 20 saniyelik, en boy oranı 1:4 ile 4:1 arasında olan kaynak klip. Çıktı 24 fps'de işlenir ve kare başına yaklaşık 14.4 megapiksel ile sınırlandırılır. | VIDEO | Evet | 1 ila 20 saniye süre; en boy oranı 1:4 ile 4:1 arasında; minimum 64x64 piksel | +| `upscale_factor` | Kaynağa göre çıktı boyutu. Çok büyük kaynaklar, kare başına sınır nedeniyle istenen faktörden daha az büyütülür. (varsayılan: 2.0) | FLOAT | Evet | 1.5 ila 3.0 (adım 0.1) | +| `mode` | 'creative' ince ayrıntıları geri kazandırır ve üretir; üretilmiş çekimler, dokular ve manzaralar için en iyisidir. 'precise' kaynağı değiştirmeden keskinleştirir; yüzler, ürünler ve gerçek çekimler için idealdir. (varsayılan: "creative") | COMBO | Evet | "creative"
"precise" | +| `prompt` | Geliştirilmiş ayrıntıyı yönlendiren klibe ait isteğe bağlı açıklama. Nötr bir büyütme için boş bırakın. (varsayılan: boş) | STRING | Evet | Çok satırlı metin | +| `auto_downscale` | 3840x2160 piksel alanından daha büyük kaynakları, giriş sınırına uyacak şekilde otomatik olarak küçültür. En boy oranı korunur; daha küçük videolara dokunulmaz. (varsayılan: true) | BOOLEAN | Evet | true
false | +| `safety_tolerance` | Moderasyon toleransı, 0 en katıdır. (varsayılan: 2, gelişmiş parametre) | INT | Evet | 0 ila 4 | +| `seed` | Düğümün yeniden çalışıp çalışmayacağını belirleyen tohum değeri; FLUX kendi tohumunu seçtiğinden, gerçek sonuçlar bu değerden bağımsız olarak deterministik değildir. (varsayılan: 42) | INT | Evet | 0 ila 4294967295 | + +Not: Kaynak video 1 ila 20 saniye uzunluğunda ve en az 64x64 piksel boyutunda olmalıdır. `auto_downscale` devre dışı bırakılırsa ve video alanı 3840x2160 pikseli aşarsa, düğüm bir hata verir. Çıktı videosu 24 fps'de işlenir ve kare başına yaklaşık 14.4 megapiksel ile sınırlandırılır; bu nedenle çok büyük kaynaklar istenen faktörden daha az büyütülebilir. + +## Çıktılar + +| Çıktı Adı | Açıklama | Veri Türü | +|-------------|-------------|-----------| +| `video` | Büyütülmüş video klibi. | VIDEO | + +> Bu belge yapay zeka tarafından oluşturulmuştur. Herhangi bir hata bulursanız veya iyileştirme önerileriniz varsa, katkıda bulunmaktan çekinmeyin! [GitHub'da Düzenle](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/tr.md) + +--- +**Source fingerprint (SHA-256):** `22dcf7c176705ce21a9032b1c9f4fe82ee6aa153f5057b90dac653b37281a677` diff --git a/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/zh-TW.md b/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/zh-TW.md new file mode 100644 index 000000000..388d47687 --- /dev/null +++ b/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/zh-TW.md @@ -0,0 +1,28 @@ +# FluxVideoUpscaleNode + +Flux Video Upscale 使用 FLUX 超解析度技術,將影片片段放大 1.5 至 3 倍。在創意模式下,它會還原並創造精細細節;在精確模式下,它會在不改變原始畫面的情況下銳化影像。 + +## 輸入 + +| 參數 | 描述 | 資料類型 | 必要 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `video` | 來源片段,長度 1 至 20 秒,長寬比介於 1:4 與 4:1 之間。輸出以 24 fps 渲染,每幀上限約 1440 萬像素。 | VIDEO | 是 | 1 至 20 秒的持續時間;長寬比介於 1:4 與 4:1 之間;最小 64x64 像素 | +| `upscale_factor` | 相對於來源的輸出大小。非常大的來源會因每幀上限而無法達到請求的放大倍率。(預設值:2.0) | FLOAT | 是 | 1.5 至 3.0(步進 0.1) | +| `mode` | 'creative' 會還原並創造精細細節,最適合生成影像、紋理與風景。'precise' 會在不改變原始畫面的情況下銳化影像,適用於臉部、產品與真實影片片段。(預設值:"creative") | COMBO | 是 | "creative"
"precise" | +| `prompt` | 可選的片段描述,用於引導增強細節。留空則進行中性放大。(預設值:空) | STRING | 是 | 多行文字 | +| `auto_downscale` | 自動將面積大於 3840x2160 像素的來源縮小,以符合輸入限制。長寬比保持不變;較小的影片不受影響。(預設值:true) | BOOLEAN | 是 | true
false | +| `safety_tolerance` | 審核寬容度,0 為最嚴格。(預設值:2,進階參數) | INT | 是 | 0 至 4 | +| `seed` | 用於決定節點是否應重新執行的種子;FLUX 會自行選擇種子,因此無論此值為何,實際結果都是不確定的。(預設值:42) | INT | 是 | 0 至 4294967295 | + +注意:來源影片的長度必須介於 1 至 20 秒之間,且至少為 64x64 像素。如果停用 `auto_downscale`,且影片面積超過 3840x2160 像素,節點會發生錯誤。輸出影片以 24 fps 渲染,每幀上限約 1440 萬像素,因此非常大的來源可能無法按請求的倍率放大。 + +## 輸出 + +| 輸出名 | 描述 | 資料類型 | +|-------------|-------------|-----------| +| `video` | 放大後的影片片段。 | VIDEO | + +> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/zh-TW.md) + +--- +**Source fingerprint (SHA-256):** `22dcf7c176705ce21a9032b1c9f4fe82ee6aa153f5057b90dac653b37281a677` diff --git a/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/zh.md b/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/zh.md new file mode 100644 index 000000000..0cb8a86b7 --- /dev/null +++ b/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/zh.md @@ -0,0 +1,28 @@ +# FluxVideoUpscaleNode + +Flux Video Upscale 使用 FLUX 超分辨率将视频片段放大 1.5 到 3 倍。在创意模式下,它会恢复并生成精细细节;在精确模式下,它会在不改变源视频的情况下进行锐化。 + +## 输入 + +| 参数 | 描述 | 数据类型 | 必填 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `video` | 源视频片段,时长为 1 到 20 秒,宽高比在 1:4 到 4:1 之间。输出以 24 fps 渲染,每帧上限约为 1440 万像素。 | VIDEO | 是 | 时长 1 到 20 秒;宽高比在 1:4 到 4:1 之间;最小 64x64 像素 | +| `upscale_factor` | 相对于源视频的输出尺寸。非常大的源视频因每帧上限而无法达到请求的放大倍数。(默认值:2.0) | FLOAT | 是 | 1.5 到 3.0(步长 0.1) | +| `mode` | “creative”会恢复并生成精细细节,最适合生成素材、纹理和风景。“precise”会在不改变源视频的情况下进行锐化,适用于人脸、产品和真实素材。(默认值:"creative") | COMBO | 是 | "creative"
"precise" | +| `prompt` | 可选的视频描述,用于引导增强细节。留空可进行中性放大。(默认值:空) | STRING | 是 | 多行文本 | +| `auto_downscale` | 自动将面积大于 3840x2160 像素的源视频缩小以符合输入限制。保持宽高比;较小的视频不受影响。(默认值:true) | BOOLEAN | 是 | true
false | +| `safety_tolerance` | 审核容差,0 为最严格。(默认值:2,高级参数) | INT | 是 | 0 到 4 | +| `seed` | 用于确定节点是否应重新运行的种子;FLUX 会自行选择种子,因此实际结果不由此值决定。(默认值:42) | INT | 是 | 0 到 4294967295 | + +注意:源视频时长必须在 1 到 20 秒之间,且尺寸至少为 64x64 像素。如果禁用 `auto_downscale` 且视频面积超过 3840x2160 像素,节点将报错。输出视频以 24 fps 渲染,每帧上限约为 1440 万像素,因此非常大的源视频可能无法达到请求的放大倍数。 + +## 输出 + +| 输出名称 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `video` | 放大后的视频片段。 | VIDEO | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FluxVideoUpscaleNode/zh.md) + +--- +**Source fingerprint (SHA-256):** `22dcf7c176705ce21a9032b1c9f4fe82ee6aa153f5057b90dac653b37281a677` diff --git a/comfyui_embedded_docs/docs/FrameInterpolate/en.md b/comfyui_embedded_docs/docs/FrameInterpolate/en.md index 3d5c6fdad..660fa6986 100644 --- a/comfyui_embedded_docs/docs/FrameInterpolate/en.md +++ b/comfyui_embedded_docs/docs/FrameInterpolate/en.md @@ -1,6 +1,4 @@ -# Frame Interpolate - -## Overview +# Run Frame Interpolation Model The Frame Interpolate node creates new frames between existing ones in a sequence of images, effectively increasing the frame rate. It uses an AI model to predict what the intermediate frames should look like, which can be used to create smooth slow-motion effects or to increase the smoothness of a video. @@ -8,8 +6,8 @@ The Frame Interpolate node creates new frames between existing ones in a sequenc | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `interp_model` | The frame interpolation model to use for generating intermediate frames | MODEL | Yes | - | -| `images` | A batch of consecutive images (frames) to interpolate between. Requires at least 2 images. | IMAGE | Yes | - | +| `interp_model` | The frame interpolation model to use for generating intermediate frames | INTERP_MODEL | Yes | - | +| `images` | A batch of consecutive images (frames) to interpolate between. Requires at least 2 images. If fewer than 2 frames are provided, the node returns the input images unchanged. | IMAGE | Yes | - | | `multiplier` | The number of times to multiply the frame count. For example, a multiplier of 2 doubles the number of frames. (default: 2) | INT | Yes | 2 to 16 | ## Outputs @@ -21,4 +19,4 @@ The Frame Interpolate node creates new frames between existing ones in a sequenc > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FrameInterpolate/en.md) --- -**Source fingerprint (SHA-256):** `54e1956bf249004315587328e8671d43739659cc00ad26f870214b704566a68b` +**Source fingerprint (SHA-256):** `e0b9dd6ec3b09e665bcc0f95d2b7a0209d9045ba9b96828e46f126e6914f049c` diff --git a/comfyui_embedded_docs/docs/FrameInterpolationModelLoader/en.md b/comfyui_embedded_docs/docs/FrameInterpolationModelLoader/en.md index 45f2c5088..dd1b89427 100644 --- a/comfyui_embedded_docs/docs/FrameInterpolationModelLoader/en.md +++ b/comfyui_embedded_docs/docs/FrameInterpolationModelLoader/en.md @@ -2,21 +2,23 @@ ## Overview -This node loads a frame interpolation model from a file and prepares it for use in the workflow. It automatically detects the model type (FILM or RIFE) and configures the model for optimal performance on your hardware. +This node loads a frame interpolation model from a file and prepares it for use in the workflow. It automatically detects whether the file is a FILM or RIFE model and configures the model for optimal performance on your hardware. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `model_name` | Select a frame interpolation model to load. Models must be placed in the 'frame_interpolation' folder. | STRING | Yes | List of model files in the `frame_interpolation` folder | +| `model_name` | Select a frame interpolation model to load. Models must be placed in the 'frame_interpolation' folder. | COMBO | Yes | List of model files in the `frame_interpolation` folder | + +Note: The node supports FILM and RIFE model formats. If the selected file is not a recognized format, an error is raised. ## Outputs | Output Name | Description | Data Type | | --- | --- | --- | -| `FRAME_INTERPOLATION_MODEL` | The loaded and configured frame interpolation model, ready for use in other nodes. | MODEL | +| `FRAME_INTERPOLATION_MODEL` | The loaded and configured frame interpolation model, ready for use in other nodes. | INTERP_MODEL | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FrameInterpolationModelLoader/en.md) --- -**Source fingerprint (SHA-256):** `b39f0aee6e02fb4c7e7268289634cf4d061038512e87ca6bd00aede5660d8196` +**Source fingerprint (SHA-256):** `21f470ee2852dbd1b332ac4a506eaa20dc8578c04b63c4fe1a072878b57beaba` diff --git a/comfyui_embedded_docs/docs/FreeU/en.md b/comfyui_embedded_docs/docs/FreeU/en.md index 6013c4f56..1f88ba51e 100644 --- a/comfyui_embedded_docs/docs/FreeU/en.md +++ b/comfyui_embedded_docs/docs/FreeU/en.md @@ -12,6 +12,8 @@ The FreeU node applies frequency-domain modifications to a model's output blocks | `s1` | Skip connection scaling factor for model_channels × 4 features (default: 0.9) | FLOAT | Yes | 0.0 - 10.0 | | `s2` | Skip connection scaling factor for model_channels × 2 features (default: 0.2) | FLOAT | Yes | 0.0 - 10.0 | +Note: FreeU adjustments are applied only to feature maps whose channel count equals model_channels × 4 (using `b1` and `s1`) or model_channels × 2 (using `b2` and `s2`). The Fourier filter scales only the central low-frequency region of the skip connection feature maps; all other frequency components remain unchanged. + ## Outputs | Output Name | Description | Data Type | @@ -21,4 +23,4 @@ The FreeU node applies frequency-domain modifications to a model's output blocks > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FreeU/en.md) --- -**Source fingerprint (SHA-256):** `a0f0b165638aa9e88ea415fc966bdac9bfbc13e9a5dcebc9780b31b63ce91f5c` +**Source fingerprint (SHA-256):** `7f7bd34964218ed16c9e58caa446d0c1e69f116607334df4a114cdc4adaf047f` diff --git a/comfyui_embedded_docs/docs/FreeU_V2/en.md b/comfyui_embedded_docs/docs/FreeU_V2/en.md index c76e5bfeb..f7f8c2f94 100644 --- a/comfyui_embedded_docs/docs/FreeU_V2/en.md +++ b/comfyui_embedded_docs/docs/FreeU_V2/en.md @@ -1,6 +1,6 @@ # FreeU_V2 -The FreeU_V2 node enhances image generation quality by applying frequency-based modifications to a diffusion model's U-Net architecture. It uses configurable scaling factors to adjust feature channels in different blocks, improving output without requiring additional training. +FreeU_V2 enhances image generation quality by applying frequency-based modifications to a diffusion model's U-Net architecture. It uses configurable scaling factors to adjust feature channels in different blocks, improving output without requiring additional training. ## Inputs @@ -12,6 +12,8 @@ The FreeU_V2 node enhances image generation quality by applying frequency-based | `s1` | Skip feature scaling factor for the first block (default: 0.9) | FLOAT | Yes | 0.0 - 10.0 | | `s2` | Skip feature scaling factor for the second block (default: 0.2) | FLOAT | Yes | 0.0 - 10.0 | +Note: `b1`, `b2`, `s1`, and `s2` are advanced parameters hidden by default in the node's UI. They can be set in steps of 0.01 within the 0.0 - 10.0 range. `b1` and `s1` control the U-Net block with the most channels, while `b2` and `s2` control the block with half as many channels. + ## Outputs | Output Name | Description | Data Type | @@ -21,4 +23,4 @@ The FreeU_V2 node enhances image generation quality by applying frequency-based > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FreeU_V2/en.md) --- -**Source fingerprint (SHA-256):** `adbbf0934f4c17fa736035b1396d26d6a5c847fd19a981ddd42d9624bd90e619` +**Source fingerprint (SHA-256):** `4cef2af9b04164a8ead25bea9c9bb3311be9224f2539a5cc6edbe97ad8465d65` diff --git a/comfyui_embedded_docs/docs/GITSScheduler/en.md b/comfyui_embedded_docs/docs/GITSScheduler/en.md index 06c4312d8..836bf7459 100644 --- a/comfyui_embedded_docs/docs/GITSScheduler/en.md +++ b/comfyui_embedded_docs/docs/GITSScheduler/en.md @@ -5,20 +5,20 @@ The GITSScheduler node generates noise schedule sigmas for the GITS (Generative ## Inputs | Parameter | Description | Data Type | Required | Range | -| --- | --- | --- | --- | --- | -| `coeff` | The coefficient value that controls the noise schedule curve (default: 1.20) | FLOAT | Yes | 0.80 - 1.50 | +|-----------|-------------|-----------|----------|-------| +| `coeff` | The coefficient value that controls the noise schedule curve (default: 1.20). The value is rounded to two decimals and selects which pre-defined noise level table is used. | FLOAT | Yes | 0.80 - 1.50 (step 0.05) | | `steps` | The total number of sampling steps to generate sigmas for (default: 10) | INT | Yes | 2 - 1000 | | `denoise` | Denoising factor that reduces the number of steps used (default: 1.0) | FLOAT | Yes | 0.0 - 1.0 | -**Note:** When `denoise` is set to 0.0, the node returns an empty tensor. When `denoise` is less than 1.0, the actual number of steps used is calculated as `round(steps * denoise)`. For steps greater than 20, the node uses log-linear interpolation to extend the pre-defined noise levels to the desired number of steps. +**Note:** When `denoise` is 0.0 or less, the node returns an empty tensor. When `denoise` is less than 1.0, the actual number of steps used is calculated as `round(steps * denoise)`, and only the last corresponding part of the schedule is kept. For steps between 2 and 20, the node selects a matching pre-defined noise schedule. For steps greater than 20, the node uses log-linear interpolation to extend the pre-defined noise levels to the desired number of steps. ## Outputs | Output Name | Description | Data Type | -| --- | --- | --- | -| `sigmas` | The generated sigma values for the noise schedule | SIGMAS | +|-------------|-------------|-----------| +| `sigmas` | The generated sigma values for the noise schedule. For N steps, N+1 sigma values are returned, and the last sigma is set to 0. | SIGMAS | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GITSScheduler/en.md) --- -**Source fingerprint (SHA-256):** `e58c8c1c0e7cbf79554040a6684f12c1a2c59c69bb50770f9577a13d76ac8eb3` +**Source fingerprint (SHA-256):** `f46681970fece985f6a4b62d0817d1ea306f1ca9a20189f937512dd5717f458b` diff --git a/comfyui_embedded_docs/docs/GeminiImage2Node/en.md b/comfyui_embedded_docs/docs/GeminiImage2Node/en.md index 490ed724d..cfd8e8393 100644 --- a/comfyui_embedded_docs/docs/GeminiImage2Node/en.md +++ b/comfyui_embedded_docs/docs/GeminiImage2Node/en.md @@ -1,25 +1,27 @@ # Nano Banana Pro (Google Gemini Image) -The GeminiImage2Node generates or edits images using Google's Vertex AI Gemini model. It sends a text prompt and optional reference images or files to the API and returns the generated image and/or a text description. +The GeminiImage2Node generates or edits images using the Google Vertex AI Gemini model. You provide a text prompt and optionally reference images or files; the node sends them to the API and returns the generated image, plus a text response when requested. ## Inputs | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `prompt` | Text prompt describing the image to generate or the edits to apply. Include any constraints, styles, or details the model should follow. | STRING | Yes | N/A | -| `model` | The specific Gemini model to use for generation. The "Nano Banana 2" option maps to the `gemini-3.1-flash-image-preview` model internally. | COMBO | Yes | `"gemini-3-pro-image-preview"`
`"Nano Banana 2 (Gemini 3.1 Flash Image)"` | -| `seed` | When fixed to a specific value, the model makes a best effort to provide the same response for repeated requests. Deterministic output isn't guaranteed. Changing the model or other settings can cause variations even with the same seed. Default: 42. | INT | Yes | 0 to 18446744073709551615 | -| `aspect_ratio` | The desired aspect ratio for the output image. If set to 'auto', it matches your input image's aspect ratio; if no image is provided, a 16:9 square is usually generated. Default: "auto". | COMBO | Yes | `"auto"`
`"1:1"`
`"2:3"`
`"3:2"`
`"3:4"`
`"4:3"`
`"4:5"`
`"5:4"`
`"9:16"`
`"16:9"`
`"21:9"` | +| `prompt` | Text prompt describing the image to generate or the edits to apply. Include any constraints, styles, or details the model should follow. The prompt must contain at least one character after removing whitespace. | STRING | Yes | N/A | +| `model` | The specific Gemini model to use for generation. The "Nano Banana 2 (Gemini 3.1 Flash Image)" option maps to the `gemini-3.1-flash-image` model internally, and "gemini-3-pro-image-preview" maps to `gemini-3-pro-image`. | COMBO | Yes | `"gemini-3-pro-image-preview"`
`"Nano Banana 2 (Gemini 3.1 Flash Image)"` | +| `seed` | When the seed is fixed to a specific value, the model makes a best effort to provide the same response for repeated requests. Deterministic output isn't guaranteed. Also, changing the model or parameter settings, such as the temperature, can cause variations in the response even when you use the same seed value. By default, a random seed value is used. Default: 42. | INT | Yes | 0 to 18446744073709551615 | +| `aspect_ratio` | If set to 'auto', matches your input image's aspect ratio; if no image is provided, a 16:9 square is usually generated. Default: "auto". | COMBO | Yes | `"auto"`
`"1:1"`
`"2:3"`
`"3:2"`
`"3:4"`
`"4:3"`
`"4:5"`
`"5:4"`
`"9:16"`
`"16:9"`
`"21:9"` | | `resolution` | Target output resolution. For 2K/4K the native Gemini upscaler is used. | COMBO | Yes | `"1K"`
`"2K"`
`"4K"` | | `response_modalities` | Choose 'IMAGE' for image-only output, or 'IMAGE+TEXT' to return both the generated image and a text response. | COMBO | Yes | `"IMAGE+TEXT"`
`"IMAGE"` | | `images` | Optional reference image(s). To include multiple images, use the Batch Images node (up to 14). | IMAGE | No | N/A | -| `files` | Optional file(s) to use as context for the model. Accepts inputs from the Gemini Generate Content Input Files node. | CUSTOM | No | N/A | +| `files` | Optional file(s) to use as context for the model. Accepts inputs from the Gemini Generate Content Input Files node. | GEMINI_INPUT_FILES | No | N/A | | `system_prompt` | Foundational instructions that dictate an AI's behavior. Default: A pre-defined system prompt for image generation. | STRING | No | N/A | **Constraints:** -* The `images` input supports a maximum of 14 images. If more are provided, an error will be raised. +* The `images` input supports a maximum of 14 images. If more are provided, an error is raised. +* When more than 10 images are provided, the first 10 are uploaded as URL references and the remaining images are sent inline in the request. * The `files` input must be connected to a node that outputs the `GEMINI_INPUT_FILES` data type. +* When `response_modalities` is set to "IMAGE", only the image is returned and the text output is empty. ## Outputs @@ -31,4 +33,4 @@ The GeminiImage2Node generates or edits images using Google's Vertex AI Gemini m > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GeminiImage2Node/en.md) --- -**Source fingerprint (SHA-256):** `3483c2b157c7359a571e2478d8709019b42b895195bc5fa14c44d6ba2950234d` +**Source fingerprint (SHA-256):** `02293dad786d4b441da3174fa76f6c5847f122d294bd7e1f765ffd72420034a4` diff --git a/comfyui_embedded_docs/docs/GeminiNanoBanana2/en.md b/comfyui_embedded_docs/docs/GeminiNanoBanana2/en.md index 1c94b933b..28c5aa115 100644 --- a/comfyui_embedded_docs/docs/GeminiNanoBanana2/en.md +++ b/comfyui_embedded_docs/docs/GeminiNanoBanana2/en.md @@ -1,23 +1,23 @@ -# GeminiNanoBanana2 +# Nano Banana 2 -The GeminiNanoBanana2 node generates or edits images using Google's Vertex AI Gemini model. It works by sending a text prompt, along with optional reference images or files, to the API and returns the generated image and any accompanying text. +The GeminiNanoBanana2 node generates or edits images using Google's Vertex AI Gemini model. It sends a text prompt, along with optional reference images or files, to the API and returns the generated image and any accompanying text. This node is marked as deprecated. ## Inputs | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `prompt` | Text prompt describing the image to generate or the edits to apply. Include any constraints, styles, or details the model should follow. | STRING | Yes | N/A | -| `model` | The specific Gemini model to use for image generation. | COMBO | Yes | `"Nano Banana 2 (Gemini 3.1 Flash Image)"` | +| `prompt` | Text prompt describing the image to generate or the edits to apply. Include any constraints, styles, or details the model should follow. Cannot be empty. (default: empty) | STRING | Yes | N/A | +| `model` | The specific Gemini model to use for image generation. | COMBO | Yes | "Nano Banana 2 (Gemini 3.1 Flash Image)" | | `seed` | When the seed is fixed to a specific value, the model makes a best effort to provide the same response for repeated requests. Deterministic output isn't guaranteed. Also, changing the model or parameter settings, such as the temperature, can cause variations in the response even when you use the same seed value. By default, a random seed value is used. (default: 42) | INT | Yes | 0 to 18446744073709551615 | -| `aspect_ratio` | If set to 'auto', matches your input image's aspect ratio; if no image is provided, a 16:9 square is usually generated. (default: "auto") | COMBO | Yes | `"auto"`
`"1:1"`
`"2:3"`
`"3:2"`
`"3:4"`
`"4:3"`
`"4:5"`
`"5:4"`
`"9:16"`
`"16:9"`
`"21:9"` | -| `resolution` | Target output resolution. For 2K/4K the native Gemini upscaler is used. | COMBO | Yes | `"1K"`
`"2K"`
`"4K"` | -| `response_modalities` | Determines the type of content the model will return. (advanced) | COMBO | Yes | `"IMAGE"`
`"IMAGE+TEXT"` | -| `thinking_level` | Controls the depth of the model's reasoning process. | COMBO | Yes | `"MINIMAL"`
`"HIGH"` | -| `images` | Optional reference image(s). To include multiple images, use the Batch Images node (up to 14). | IMAGE | No | N/A | +| `aspect_ratio` | If set to 'auto', matches your input image's aspect ratio; if no image is provided, a 16:9 square is usually generated. (default: "auto") | COMBO | Yes | "auto"
"1:1"
"2:3"
"3:2"
"3:4"
"4:3"
"4:5"
"5:4"
"9:16"
"16:9"
"21:9" | +| `resolution` | Target output resolution. For 2K/4K the native Gemini upscaler is used. | COMBO | Yes | "1K"
"2K"
"4K" | +| `response_modalities` | Determines the type of content the model returns: "IMAGE" returns only an image, "IMAGE+TEXT" also returns text. (advanced) | COMBO | Yes | "IMAGE"
"IMAGE+TEXT" | +| `thinking_level` | Controls the depth of the model's reasoning process. | COMBO | Yes | "MINIMAL"
"HIGH" | +| `images` | Optional reference image(s). To include multiple images, use the Batch Images node (up to 14). | IMAGE | No | 1 to 14 images | | `files` | Optional file(s) to use as context for the model. Accepts inputs from the Gemini Generate Content Input Files node. | CUSTOM | No | N/A | -| `system_prompt` | Foundational instructions that dictate an AI's behavior. (advanced) | STRING | No | N/A | +| `system_prompt` | Foundational instructions that dictate an AI's behavior. (default: a preset prompt that instructs the model to always produce an image) (advanced) | STRING | No | N/A | -**Note:** The `images` input supports a maximum of 14 images. If more are provided, the node will raise an error. +**Note:** The `images` input supports a maximum of 14 images. If more are provided, the node will raise an error. The `prompt` input must not be empty or whitespace-only. ## Outputs @@ -30,4 +30,4 @@ The GeminiNanoBanana2 node generates or edits images using Google's Vertex AI Ge > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GeminiNanoBanana2/en.md) --- -**Source fingerprint (SHA-256):** `3564bef74329f7019a2c9a67047d45e7342ee2e532126d597d0d21c995e1a5be` +**Source fingerprint (SHA-256):** `d781c92f04d420985f8a5a593eb5f28f1f7b2af13abd11f2a7f6f285edcd9900` diff --git a/comfyui_embedded_docs/docs/GeminiNanoBanana2V2/en.md b/comfyui_embedded_docs/docs/GeminiNanoBanana2V2/en.md index 75b2d32f2..c6bfeb35c 100644 --- a/comfyui_embedded_docs/docs/GeminiNanoBanana2V2/en.md +++ b/comfyui_embedded_docs/docs/GeminiNanoBanana2V2/en.md @@ -12,7 +12,7 @@ This node generates or edits images by sending a text prompt to Google's Vertex | `prompt` | Text prompt describing the image to generate or the edits to apply. Include any constraints, styles, or details the model should follow. Must not be empty. (default: empty) | STRING | Yes | N/A | | `seed` | When the seed is fixed to a specific value, the model makes a best effort to provide the same response for repeated requests. Deterministic output isn't guaranteed. Also, changing the model or parameter settings, such as the temperature, can cause variations in the response even when you use the same seed value. By default, a random seed value is used. (default: 42) | INT | Yes | 0 to 18446744073709551615 | | `response_modalities` | Determines the response format. IMAGE returns only an image; IMAGE+TEXT returns an image and a text response. (default: IMAGE) Advanced parameter. | COMBO | Yes | `"IMAGE"`
`"IMAGE+TEXT"` | -| `system_prompt` | Foundational instructions that dictate an AI's behavior. If left empty, a built-in prompt instructing the model to always produce an image is used. Advanced parameter. | STRING | No | N/A | +| `system_prompt` | Foundational instructions that dictate an AI's behavior. Defaults to a built-in prompt that instructs the model to always produce an image. Advanced parameter. | STRING | No | N/A | | `temperature` | Controls randomness in generation. Lower is more focused/deterministic. (default: 1.0) Advanced parameter. | FLOAT | No | 0.0 to 2.0 (step 0.01) | | `top_p` | Nucleus sampling threshold. Lower is more focused, higher more diverse. (default: 0.95) Advanced parameter. | FLOAT | No | 0.0 to 1.0 (step 0.01) | @@ -39,7 +39,7 @@ This node generates or edits images by sending a text prompt to Google's Vertex | `images` | Optional reference image(s). Up to 14 images total. Growable slot: connect `image_1` through `image_14`. | IMAGE | No | 0 to 14 images | | `files` | Optional file(s) to use as context for the model. Accepts inputs from the Gemini Generate Content Input Files node. | GEMINI_INPUT_FILES | No | N/A | -**Note:** A maximum of 14 reference images can be connected to the `images` input. +**Note:** A maximum of 14 reference images can be connected to the `images` input; exceeding this limit raises an error. ## Outputs @@ -49,7 +49,7 @@ This node generates or edits images by sending a text prompt to Google's Vertex | `STRING` | A text description or caption generated by the model. Empty when no text is returned, such as when `response_modalities` is set to `IMAGE`. | STRING | | `thought_image` | First image from the model's thinking process. Only available with `thinking_level` HIGH and IMAGE+TEXT modality. | IMAGE | -**Note:** The `STRING` output is empty when `response_modalities` is set to `IMAGE`. +**Note:** The `STRING` output is empty when `response_modalities` is set to `IMAGE`. If the model does not generate an image in this mode, the node raises an error suggesting switching to IMAGE+TEXT to view the model's reasoning. > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GeminiNanoBanana2V2/en.md) diff --git a/comfyui_embedded_docs/docs/GeminiNanoBanana2V2/fr.md b/comfyui_embedded_docs/docs/GeminiNanoBanana2V2/fr.md index 8f6c7ae5a..248b3d5d0 100644 --- a/comfyui_embedded_docs/docs/GeminiNanoBanana2V2/fr.md +++ b/comfyui_embedded_docs/docs/GeminiNanoBanana2V2/fr.md @@ -8,12 +8,12 @@ Ce nœud génère ou modifie des images en envoyant une invite textuelle à l'AP | Paramètre | Description | Type de données | Requis | Plage | |-----------|-------------|-----------------|--------|-------| -| `model` | Sélectionne le modèle d'images Gemini à utiliser. Le modèle choisi détermine les options de résolution disponibles et les entrées spécifiques au modèle. | DYNAMIC_COMBO | Oui | `"Nano Banana 2 (Gemini 3.1 Flash Image)"`
`"Nano Banana 2 Lite"` | +| `modèle` | Sélectionne le modèle d'images Gemini à utiliser. Le modèle choisi détermine les options de résolution disponibles et les entrées spécifiques au modèle. | DYNAMIC_COMBO | Oui | `"Nano Banana 2 (Gemini 3.1 Flash Image)"`
`"Nano Banana 2 Lite"` | | `prompt` | Invite textuelle décrivant l'image à générer ou les modifications à appliquer. Incluez toutes les contraintes, styles ou détails que le modèle doit suivre. Ne doit pas être vide. (défaut : vide) | STRING | Oui | N/A | -| `seed` | Lorsque la valeur de `seed` est fixée à une valeur spécifique, le modèle fait de son mieux pour fournir la même réponse pour des requêtes répétées. La sortie déterministe n'est pas garantie. De plus, modifier le modèle ou les paramètres, tels que la température, peut entraîner des variations dans la réponse même si vous utilisez la même valeur de `seed`. Par défaut, une valeur de `seed` aléatoire est utilisée. (défaut : 42) | INT | Oui | 0 à 18446744073709551615 | -| `response_modalities` | Détermine le format de la réponse. IMAGE renvoie uniquement une image ; IMAGE+TEXT renvoie une image et une réponse textuelle. (défaut : IMAGE) Paramètre avancé. | COMBO | Oui | `"IMAGE"`
`"IMAGE+TEXT"` | -| `system_prompt` | Instructions fondamentales qui régissent le comportement d'une IA. Si laissé vide, une invite intégrée demandant au modèle de toujours produire une image est utilisée. Paramètre avancé. | STRING | Non | N/A | -| `temperature` | Contrôle le caractère aléatoire de la génération. Une valeur plus basse est plus ciblée/déterministe. (défaut : 1.0) Paramètre avancé. | FLOAT | Non | 0.0 à 2.0 (pas de 0.01) | +| `graine` | Lorsque la valeur de `seed` est fixée à une valeur spécifique, le modèle fait de son mieux pour fournir la même réponse pour des requêtes répétées. La sortie déterministe n'est pas garantie. De plus, modifier le modèle ou les paramètres, tels que la température, peut entraîner des variations dans la réponse même si vous utilisez la même valeur de `seed`. Par défaut, une valeur de `seed` aléatoire est utilisée. (défaut : 42) | INT | Oui | 0 à 18446744073709551615 | +| `modalités de réponse` | Détermine le format de la réponse. IMAGE renvoie uniquement une image ; IMAGE+TEXT renvoie une image et une réponse textuelle. (défaut : IMAGE) Paramètre avancé. | COMBO | Oui | `"IMAGE"`
`"IMAGE+TEXT"` | +| `invite système` | Instructions fondamentales qui régissent le comportement d'une IA. Si laissé vide, une invite intégrée demandant au modèle de toujours produire une image est utilisée. Paramètre avancé. | STRING | Non | N/A | +| `température` | Contrôle le caractère aléatoire de la génération. Une valeur plus basse est plus ciblée/déterministe. (défaut : 1.0) Paramètre avancé. | FLOAT | Non | 0.0 à 2.0 (pas de 0.01) | | `top_p` | Seuil d'échantillonnage nucleus (noyau). Une valeur plus basse est plus ciblée, une valeur plus haute est plus diversifiée. (défaut : 0.95) Paramètre avancé. | FLOAT | Non | 0.0 à 1.0 (pas de 0.01) | ### Entrées de Nano Banana 2 (Gemini 3.1 Flash Image) @@ -47,7 +47,7 @@ Ce nœud génère ou modifie des images en envoyant une invite textuelle à l'AP |---------------|-------------|-----------------| | `IMAGE` | L'image générée ou modifiée. | IMAGE | | `STRING` | Une description textuelle ou une légende générée par le modèle. Vide lorsqu'aucun texte n'est renvoyé, par exemple lorsque `response_modalities` est défini sur `IMAGE`. | STRING | -| `thought_image` | Première image du processus de réflexion du modèle. Disponible uniquement avec `thinking_level` HIGH et la modalité IMAGE+TEXT. | IMAGE | +| `image de réflexion` | Première image du processus de réflexion du modèle. Disponible uniquement avec `thinking_level` HIGH et la modalité IMAGE+TEXT. | IMAGE | **Remarque :** La sortie `STRING` est vide lorsque `response_modalities` est défini sur `IMAGE`. diff --git a/comfyui_embedded_docs/docs/GeminiNanoBanana2V2/ja.md b/comfyui_embedded_docs/docs/GeminiNanoBanana2V2/ja.md index ecff06ae8..5604b66a0 100644 --- a/comfyui_embedded_docs/docs/GeminiNanoBanana2V2/ja.md +++ b/comfyui_embedded_docs/docs/GeminiNanoBanana2V2/ja.md @@ -8,11 +8,11 @@ | パラメータ | 説明 | データ型 | 必須 | 範囲 | |-----------|-------------|-----------|----------|-------| -| `model` | 使用する Gemini 画像モデルを選択します。選択したモデルによって、利用可能な解像度オプションとモデル固有の入力が決まります。 | DYNAMIC_COMBO | 必須 | `"Nano Banana 2 (Gemini 3.1 Flash Image)"`
`"Nano Banana 2 Lite"` | -| `prompt` | 生成する画像または適用する編集内容を説明するテキストプロンプトです。モデルが従うべき制約、スタイル、詳細を含めてください。空にすることはできません。(デフォルト: 空) | STRING | 必須 | N/A | -| `seed` | シードを特定の値に固定すると、モデルは繰り返しのリクエストに対して同じ応答を提供するよう最善を尽くします。ただし、決定的な出力は保証されません。また、モデルや temperature などのパラメーター設定を変更すると、同じシード値を使用しても応答にばらつきが生じることがあります。デフォルトでは、ランダムなシード値が使用されます。(デフォルト: 42) | INT | 必須 | 0 〜 18446744073709551615 | -| `response_modalities` | 応答形式を指定します。IMAGE は画像のみを返し、IMAGE+TEXT は画像とテキスト応答を返します。(デフォルト: IMAGE) 高度なパラメーターです。 | COMBO | 必須 | `"IMAGE"`
`"IMAGE+TEXT"` | -| `system_prompt` | AI の動作を決定づける基本的な指示です。空のままにすると、モデルに常に画像を生成するよう指示する組み込みプロンプトが使用されます。高度なパラメーターです。 | STRING | 任意 | N/A | +| `モデル` | 使用する Gemini 画像モデルを選択します。選択したモデルによって、利用可能な解像度オプションとモデル固有の入力が決まります。 | DYNAMIC_COMBO | 必須 | `"Nano Banana 2 (Gemini 3.1 Flash Image)"`
`"Nano Banana 2 Lite"` | +| `プロンプト` | 生成する画像または適用する編集内容を説明するテキストプロンプトです。モデルが従うべき制約、スタイル、詳細を含めてください。空にすることはできません。(デフォルト: 空) | STRING | 必須 | N/A | +| `シード` | シードを特定の値に固定すると、モデルは繰り返しのリクエストに対して同じ応答を提供するよう最善を尽くします。ただし、決定的な出力は保証されません。また、モデルや temperature などのパラメーター設定を変更すると、同じシード値を使用しても応答にばらつきが生じることがあります。デフォルトでは、ランダムなシード値が使用されます。(デフォルト: 42) | INT | 必須 | 0 〜 18446744073709551615 | +| `応答モダリティ` | 応答形式を指定します。IMAGE は画像のみを返し、IMAGE+TEXT は画像とテキスト応答を返します。(デフォルト: IMAGE) 高度なパラメーターです。 | COMBO | 必須 | `"IMAGE"`
`"IMAGE+TEXT"` | +| `システムプロンプト` | AI の動作を決定づける基本的な指示です。空のままにすると、モデルに常に画像を生成するよう指示する組み込みプロンプトが使用されます。高度なパラメーターです。 | STRING | 任意 | N/A | | `temperature` | 生成におけるランダム性を制御します。低い値ほど集中度が高く、決定的になります。(デフォルト: 1.0) 高度なパラメーターです。 | FLOAT | 任意 | 0.0 〜 2.0 (step 0.01) | | `top_p` | Nucleus sampling(核サンプリング)の閾値です。低い値ほど集中度が高く、高い値ほど多様性が高くなります。(デフォルト: 0.95) 高度なパラメーターです。 | FLOAT | 任意 | 0.0 〜 1.0 (step 0.01) | @@ -47,7 +47,7 @@ |-------------|-------------|-----------| | `IMAGE` | 生成または編集された画像です。 | IMAGE | | `STRING` | モデルによって生成されたテキストの説明またはキャプションです。`response_modalities` が `IMAGE` に設定されている場合など、テキストが返されないときは空になります。 | STRING | -| `thought_image` | モデルの思考プロセスから得られる最初の画像です。`thinking_level` が HIGH で、かつ IMAGE+TEXT モダリティの場合にのみ利用できます。 | IMAGE | +| `思考画像` | モデルの思考プロセスから得られる最初の画像です。`thinking_level` が HIGH で、かつ IMAGE+TEXT モダリティの場合にのみ利用できます。 | IMAGE | **注:** `response_modalities` が `IMAGE` に設定されている場合、`STRING` 出力は空になります。 diff --git a/comfyui_embedded_docs/docs/GeminiNanoBanana2V2/ko.md b/comfyui_embedded_docs/docs/GeminiNanoBanana2V2/ko.md index 13c53dcff..83bd9ac71 100644 --- a/comfyui_embedded_docs/docs/GeminiNanoBanana2V2/ko.md +++ b/comfyui_embedded_docs/docs/GeminiNanoBanana2V2/ko.md @@ -8,11 +8,11 @@ | 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | |-----------|-------------|-----------|----------|-------| -| `model` | 사용할 Gemini 이미지 모델을 선택합니다. 선택한 모델에 따라 사용 가능한 해상도 옵션과 모델별 입력이 결정됩니다. | DYNAMIC_COMBO | 예 | `"Nano Banana 2 (Gemini 3.1 Flash Image)"`
`"Nano Banana 2 Lite"` | -| `prompt` | 생성할 이미지 또는 적용할 편집 내용을 설명하는 텍스트 프롬프트입니다. 모델이 따라야 할 제약 조건, 스타일, 세부 정보를 포함하세요. 비어 있을 수 없습니다. (기본값: 비어 있음) | STRING | 예 | 해당 없음 | -| `seed` | 시드가 특정 값으로 고정되면 모델은 반복 요청에 대해 동일한 응답을 제공하기 위해 최선을 다합니다. 결정적 출력은 보장되지 않습니다. 또한 모델이나 temperature와 같은 매개변수 설정을 변경하면 동일한 시드 값을 사용하더라도 응답에 변동이 생길 수 있습니다. 기본적으로 무작위 시드 값이 사용됩니다. (기본값: 42) | INT | 예 | 0 ~ 18446744073709551615 | -| `response_modalities` | 응답 형식을 결정합니다. IMAGE는 이미지만 반환하고, IMAGE+TEXT는 이미지와 텍스트 응답을 반환합니다. (기본값: IMAGE) 고급 매개변수입니다. | COMBO | 예 | `"IMAGE"`
`"IMAGE+TEXT"` | -| `system_prompt` | AI의 동작을 지시하는 기본 지침입니다. 비워 두면 모델이 항상 이미지를 생성하도록 지시하는 기본 프롬프트가 사용됩니다. 고급 매개변수입니다. | STRING | 아니요 | 해당 없음 | +| `모델` | 사용할 Gemini 이미지 모델을 선택합니다. 선택한 모델에 따라 사용 가능한 해상도 옵션과 모델별 입력이 결정됩니다. | DYNAMIC_COMBO | 예 | `"Nano Banana 2 (Gemini 3.1 Flash Image)"`
`"Nano Banana 2 Lite"` | +| `프롬프트` | 생성할 이미지 또는 적용할 편집 내용을 설명하는 텍스트 프롬프트입니다. 모델이 따라야 할 제약 조건, 스타일, 세부 정보를 포함하세요. 비어 있을 수 없습니다. (기본값: 비어 있음) | STRING | 예 | 해당 없음 | +| `시드` | 시드가 특정 값으로 고정되면 모델은 반복 요청에 대해 동일한 응답을 제공하기 위해 최선을 다합니다. 결정적 출력은 보장되지 않습니다. 또한 모델이나 temperature와 같은 매개변수 설정을 변경하면 동일한 시드 값을 사용하더라도 응답에 변동이 생길 수 있습니다. 기본적으로 무작위 시드 값이 사용됩니다. (기본값: 42) | INT | 예 | 0 ~ 18446744073709551615 | +| `응답 모달리티` | 응답 형식을 결정합니다. IMAGE는 이미지만 반환하고, IMAGE+TEXT는 이미지와 텍스트 응답을 반환합니다. (기본값: IMAGE) 고급 매개변수입니다. | COMBO | 예 | `"IMAGE"`
`"IMAGE+TEXT"` | +| `시스템 프롬프트` | AI의 동작을 지시하는 기본 지침입니다. 비워 두면 모델이 항상 이미지를 생성하도록 지시하는 기본 프롬프트가 사용됩니다. 고급 매개변수입니다. | STRING | 아니요 | 해당 없음 | | `temperature` | 생성 시 무작위성을 제어합니다. 값이 낮을수록 더 집중적이고 결정론적입니다. (기본값: 1.0) 고급 매개변수입니다. | FLOAT | 아니요 | 0.0 ~ 2.0 (단계 0.01) | | `top_p` | 핵심 샘플링 임계값입니다. 값이 낮을수록 더 집중적이고, 높을수록 더 다양해집니다. (기본값: 0.95) 고급 매개변수입니다. | FLOAT | 아니요 | 0.0 ~ 1.0 (단계 0.01) | @@ -47,7 +47,7 @@ |-------------|-------------|-----------| | `IMAGE` | 생성되거나 편집된 이미지입니다. | IMAGE | | `STRING` | 모델이 생성한 텍스트 설명 또는 캡션입니다. 텍스트가 반환되지 않으면 비어 있습니다(예: `response_modalities`가 `IMAGE`로 설정된 경우). | STRING | -| `thought_image` | 모델의 사고 과정에서 나온 첫 번째 이미지입니다. `thinking_level`이 HIGH이고 IMAGE+TEXT 모드일 때만 사용할 수 있습니다. | IMAGE | +| `사고 이미지` | 모델의 사고 과정에서 나온 첫 번째 이미지입니다. `thinking_level`이 HIGH이고 IMAGE+TEXT 모드일 때만 사용할 수 있습니다. | IMAGE | **참고:** `response_modalities`가 `IMAGE`로 설정된 경우 `STRING` 출력은 비어 있습니다. diff --git a/comfyui_embedded_docs/docs/GeminiNanoBanana2V2/zh-TW.md b/comfyui_embedded_docs/docs/GeminiNanoBanana2V2/zh-TW.md index f0d393bc6..cd775ab8b 100644 --- a/comfyui_embedded_docs/docs/GeminiNanoBanana2V2/zh-TW.md +++ b/comfyui_embedded_docs/docs/GeminiNanoBanana2V2/zh-TW.md @@ -8,11 +8,11 @@ | 參數 | 描述 | 資料類型 | 必要 | 範圍 | |-----------|-------------|-----------|----------|-------| -| `model` | 選取要使用的 Gemini 影像模型。所選模型會決定可用的解析度選項與模型專屬輸入。 | DYNAMIC_COMBO | 是 | `"Nano Banana 2 (Gemini 3.1 Flash Image)"`
`"Nano Banana 2 Lite"` | -| `prompt` | 描述要產生的影像或要套用編輯的文字提示。請包含模型應遵循的任何限制、樣式或細節。不得為空。(預設:空) | STRING | 是 | N/A | -| `seed` | 當種子值固定為特定數值時,模型會盡力在重複請求時提供相同的回應,但不保證輸出具有確定性。此外,即使使用相同的種子值,變更模型或參數設定(例如 temperature)也可能導致回應產生變化。依預設,會使用隨機種子值。(預設:42) | INT | 是 | 0 至 18446744073709551615 | -| `response_modalities` | 決定回應格式。IMAGE 僅回傳影像;IMAGE+TEXT 回傳影像與文字回應。(預設:IMAGE)進階參數。 | COMBO | 是 | `"IMAGE"`
`"IMAGE+TEXT"` | -| `system_prompt` | 規範 AI 行為的基礎指示。若留空,將使用內建提示,指示模型一律產生影像。進階參數。 | STRING | 否 | N/A | +| `模型` | 選取要使用的 Gemini 影像模型。所選模型會決定可用的解析度選項與模型專屬輸入。 | DYNAMIC_COMBO | 是 | `"Nano Banana 2 (Gemini 3.1 Flash Image)"`
`"Nano Banana 2 Lite"` | +| `提示詞` | 描述要產生的影像或要套用編輯的文字提示。請包含模型應遵循的任何限制、樣式或細節。不得為空。(預設:空) | STRING | 是 | N/A | +| `種子` | 當種子值固定為特定數值時,模型會盡力在重複請求時提供相同的回應,但不保證輸出具有確定性。此外,即使使用相同的種子值,變更模型或參數設定(例如 temperature)也可能導致回應產生變化。依預設,會使用隨機種子值。(預設:42) | INT | 是 | 0 至 18446744073709551615 | +| `回應型態` | 決定回應格式。IMAGE 僅回傳影像;IMAGE+TEXT 回傳影像與文字回應。(預設:IMAGE)進階參數。 | COMBO | 是 | `"IMAGE"`
`"IMAGE+TEXT"` | +| `系統提示` | 規範 AI 行為的基礎指示。若留空,將使用內建提示,指示模型一律產生影像。進階參數。 | STRING | 否 | N/A | | `temperature` | 控制生成過程的隨機性。數值越低越專注/確定。(預設:1.0)進階參數。 | FLOAT | 否 | 0.0 至 2.0(步長 0.01) | | `top_p` | 核心取樣(Nucleus sampling)的閾值。數值越低越專注,越高越多樣化。(預設:0.95)進階參數。 | FLOAT | 否 | 0.0 至 1.0(步長 0.01) | @@ -47,7 +47,7 @@ |-------------|-------------|-----------| | `IMAGE` | 產生或編輯後的影像。 | IMAGE | | `STRING` | 模型產生的文字描述或標題。當未回傳文字時為空,例如當 `response_modalities` 設為 `IMAGE` 時。 | STRING | -| `thought_image` | 模型思考過程中的第一張影像。僅在 `thinking_level` 設為 HIGH 且使用 IMAGE+TEXT 模式時可用。 | IMAGE | +| `思考影像` | 模型思考過程中的第一張影像。僅在 `thinking_level` 設為 HIGH 且使用 IMAGE+TEXT 模式時可用。 | IMAGE | **注意:** 當 `response_modalities` 設為 `IMAGE` 時,`STRING` 輸出為空。 diff --git a/comfyui_embedded_docs/docs/GeminiNode/en.md b/comfyui_embedded_docs/docs/GeminiNode/en.md index 816d2a512..3c77bb35f 100644 --- a/comfyui_embedded_docs/docs/GeminiNode/en.md +++ b/comfyui_embedded_docs/docs/GeminiNode/en.md @@ -1,13 +1,15 @@ -# ComfyUI Node Documentation: GeminiNode +# Google Gemini This node allows users to interact with Google's Gemini AI models to generate text responses. You can provide multiple types of inputs including text, images, audio, video, and files as context for the model to generate more relevant and meaningful responses. The node handles all API communication and response parsing automatically. +**Note:** This node is marked as deprecated in the source code. + ## Inputs | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| | `prompt` | Text inputs to the model, used to generate a response. You can include detailed instructions, questions, or context for the model. Default: empty string. | STRING | Yes | - | -| `model` | The Gemini model to use for generating responses. Default: gemini-3-1-pro. | COMBO | Yes | `gemini-2.5-pro-preview-05-06`
`gemini-2.5-flash-preview-04-17`
`gemini-2.5-pro`
`gemini-2.5-flash`
`gemini-3-pro-preview`
`gemini-3-1-pro`
`gemini-3-1-flash-lite` | +| `model` | The Gemini model to use for generating responses. Default: gemini-3-1-pro. | COMBO | Yes | "gemini-2.5-pro"
"gemini-2.5-flash"
"gemini-3-pro-preview"
"gemini-3-1-pro"
"gemini-3-1-flash-lite" | | `seed` | When seed is fixed to a specific value, the model makes a best effort to provide the same response for repeated requests. Deterministic output isn't guaranteed. Also, changing the model or parameter settings, such as the temperature, can cause variations in the response even when you use the same seed value. By default, a random seed value is used. Default: 42. | INT | Yes | 0 to 18446744073709551615 | | `images` | Optional image(s) to use as context for the model. To include multiple images, you can use the Batch Images node. Default: None. | IMAGE | No | - | | `audio` | Optional audio to use as context for the model. Default: None. | AUDIO | No | - | @@ -15,13 +17,15 @@ This node allows users to interact with Google's Gemini AI models to generate te | `files` | Optional file(s) to use as context for the model. Accepts inputs from the Gemini Generate Content Input Files node. Default: None. | GEMINI_INPUT_FILES | No | - | | `system_prompt` | Foundational instructions that dictate an AI's behavior. Default: empty string. This is an advanced parameter. | STRING | No | - | +All connected images are used as context. When more than 10 images are provided, the first 10 are uploaded as file references and the remaining images are sent inline to the API. + ## Outputs | Output Name | Description | Data Type | |-------------|-------------|-----------| -| `STRING` | The text response generated by the Gemini model. | STRING | +| `STRING` | The text response generated by the Gemini model. If the model produces no text, the node returns "Empty response from Gemini model...". | STRING | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GeminiNode/en.md) --- -**Source fingerprint (SHA-256):** `06d3894292600e7106b38b476443ceac21480878fa2933eb18eee7a0b9ca3c6a` +**Source fingerprint (SHA-256):** `d1c53a5d80182085a36302867c8875df696adec6aaea9a9519a21bd6b9543d8f` diff --git a/comfyui_embedded_docs/docs/GeminiNodeV2/en.md b/comfyui_embedded_docs/docs/GeminiNodeV2/en.md index 3394304b1..ae3aeb28e 100644 --- a/comfyui_embedded_docs/docs/GeminiNodeV2/en.md +++ b/comfyui_embedded_docs/docs/GeminiNodeV2/en.md @@ -8,11 +8,22 @@ Generate text responses with Google's Gemini models. Provide a text prompt and, | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `model` | The Gemini model used to generate the response. | DYNAMIC_COMBO | Yes | `"Gemini 3.5 Flash"`
`"Gemini 3.1 Pro"`
`"Gemini 3.1 Flash-Lite"` | +| `model` | The Gemini model used to generate the response. | DYNAMIC_COMBO | Yes | `"Gemini 3.7 Flash"`
`"Gemini 3.5 Flash"`
`"Gemini 3.1 Pro"`
`"Gemini 3.1 Flash-Lite"` | | `prompt` | Text input to the model. Include detailed instructions, questions, or context. Must contain at least one non-whitespace character. (default: "") | STRING | Yes | | | `seed` | Seed for sampling. Set to 0 for a random seed. Deterministic output isn't guaranteed. (default: 42) | INT | Yes | 0 to 2147483647 | | `system_prompt` | Foundational instructions that dictate the model's behavior. (default: "") | STRING | No | | +### Gemini 3.7 Flash Inputs + +These inputs appear when `model` is set to `"Gemini 3.7 Flash"`. + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `thinking_level` | How hard the model reasons internally before answering. HIGH improves quality on difficult tasks but costs more (thinking) tokens and is slower. (default: "MEDIUM") | COMBO | Yes | `"LOW"`
`"MEDIUM"`
`"HIGH"` | +| `temperature` | Controls randomness. Lower is more focused/deterministic, higher is more creative. (default: 1.0) | FLOAT | Yes | 0.0 to 2.0 | +| `top_p` | Nucleus sampling: sample from the smallest token set whose cumulative probability reaches top_p. (default: 0.95) | FLOAT | Yes | 0.0 to 1.0 | +| `max_output_tokens` | Maximum tokens to generate, including the model's internal thinking. With thinking_level HIGH, a low value can leave no room for the answer; raise this if responses come back empty or truncated. The model stops early when finished, so a higher cap costs nothing extra for short replies. (default: 32768) | INT | Yes | 16 to 65536 | + ### Gemini 3.5 Flash Inputs These inputs appear when `model` is set to `"Gemini 3.5 Flash"`. @@ -48,11 +59,11 @@ These inputs appear when `model` is set to `"Gemini 3.1 Flash-Lite"`. ### Media and File Inputs -The following inputs are shared by all three models and appear alongside the model-specific inputs. +The following inputs are shared by all four models and appear alongside the model-specific inputs. | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `images` | Growable slot: connect 1 to 16 images (`image_1` ... `image_16`). Optional image(s) to use as context for the model. | IMAGE | No | 0 to 16 images | +| `images` | Growable slot: connect 1 to 16 images (`image_1` ... `image_16`). Optional image(s) to use as context for the model. Up to 16 images. | IMAGE | No | 0 to 16 images | | `audio` | Growable slot: connect one audio clip (`audio_1`). Optional audio clip to use as context for the model. | AUDIO | No | 0 to 1 clip | | `video` | Growable slot: connect one video clip (`video_1`). Optional video clip to use as context for the model. | VIDEO | No | 0 to 1 clip | | `files` | Optional file(s) to use as context for the model. Accepts inputs from the Gemini Input Files node. | GEMINI_INPUT_FILES | No | | @@ -68,4 +79,4 @@ The following inputs are shared by all three models and appear alongside the mod > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GeminiNodeV2/en.md) --- -**Source fingerprint (SHA-256):** `e88c253d9ae987ab91b0fb6b0b55cfd9cd3671438770afcedd844f236b30dc36` +**Source fingerprint (SHA-256):** `00e0f614303fa723eb787ad763e0b0c6322f89abf43d93b697357527b2fae49c` diff --git a/comfyui_embedded_docs/docs/GeminiNodeV2/fr.md b/comfyui_embedded_docs/docs/GeminiNodeV2/fr.md index d63aee34c..e0e8ef69c 100644 --- a/comfyui_embedded_docs/docs/GeminiNodeV2/fr.md +++ b/comfyui_embedded_docs/docs/GeminiNodeV2/fr.md @@ -8,10 +8,10 @@ Générez des réponses textuelles avec les modèles Gemini de Google. Fournisse | Paramètre | Description | Type de données | Requis | Plage | |-----------|-------------|-----------------|--------|-------| -| `model` | Le modèle Gemini utilisé pour générer la réponse. | DYNAMIC_COMBO | Oui | `"Gemini 3.5 Flash"`
`"Gemini 3.1 Pro"`
`"Gemini 3.1 Flash-Lite"` | -| `prompt` | Entrée textuelle fournie au modèle. Incluez des instructions détaillées, des questions ou du contexte. Doit contenir au moins un caractère non blanc. (par défaut : "") | STRING | Oui | | -| `seed` | Graine pour l'échantillonnage. Mettez à 0 pour obtenir une graine aléatoire. La sortie déterministe n'est pas garantie. (par défaut : 42) | INT | Oui | 0 à 2147483647 | -| `system_prompt` | Instructions fondamentales qui dictent le comportement du modèle. (par défaut : "") | STRING | Non | | +| `modèle` | Le modèle Gemini utilisé pour générer la réponse. | DYNAMIC_COMBO | Oui | `"Gemini 3.5 Flash"`
`"Gemini 3.1 Pro"`
`"Gemini 3.1 Flash-Lite"` | +| `invite` | Entrée textuelle fournie au modèle. Incluez des instructions détaillées, des questions ou du contexte. Doit contenir au moins un caractère non blanc. (par défaut : "") | STRING | Oui | | +| `graine` | Graine pour l'échantillonnage. Mettez à 0 pour obtenir une graine aléatoire. La sortie déterministe n'est pas garantie. (par défaut : 42) | INT | Oui | 0 à 2147483647 | +| `invite système` | Instructions fondamentales qui dictent le comportement du modèle. (par défaut : "") | STRING | Non | | ### Entrées Gemini 3.5 Flash diff --git a/comfyui_embedded_docs/docs/GenerateTracks/en.md b/comfyui_embedded_docs/docs/GenerateTracks/en.md index 36b7352f1..e040b0c50 100644 --- a/comfyui_embedded_docs/docs/GenerateTracks/en.md +++ b/comfyui_embedded_docs/docs/GenerateTracks/en.md @@ -1,6 +1,6 @@ # Generate Video Tracks -The `GenerateTracks` node creates multiple parallel motion paths for video generation. It defines a primary path from a start point to an end point, then generates a set of tracks that run parallel to this path, spaced evenly apart. You can control the shape of the path (straight line or Bezier curve), the speed of movement along it, and which frames the tracks are visible in. +The `GenerateTracks` node creates multiple parallel motion paths (tracks) for video generation. It defines a main path from a start position to an end position, then generates a set of tracks that run parallel to this path, spaced evenly apart. You can control the shape of the path (straight line or Bezier curve), the speed of movement along it, and which frames the tracks are visible in. ## Inputs @@ -18,8 +18,8 @@ The `GenerateTracks` node creates multiple parallel motion paths for video gener | `bezier` | Enable Bezier curve path using the mid point as control point. The default value is False. | BOOLEAN | Yes | True / False | | `mid_x` | Normalized X control point for Bezier curve. Only used when 'bezier' is enabled. The default value is 0.5. | FLOAT | Yes | 0.0 - 1.0 | | `mid_y` | Normalized Y control point for Bezier curve. Only used when 'bezier' is enabled. The default value is 0.5. | FLOAT | Yes | 0.0 - 1.0 | -| `interpolation` | Controls the timing/speed of movement along the path. The default value is "linear". | COMBO | Yes | `"linear"`
`"ease_in"`
`"ease_out"`
`"ease_in_out"`
`"constant"` | -| `track_mask` | Optional mask to indicate visible frames. | MASK | No | - | +| `interpolation` | Controls the timing/speed of movement along the path (default: "linear"):
"linear" - constant speed
"ease_in" - starts slow and speeds up
"ease_out" - starts fast and slows down
"ease_in_out" - smooth acceleration and deceleration
"constant" - keeps all positions at the start point | COMBO | Yes | `"linear"`
`"ease_in"`
`"ease_out"`
`"ease_in_out"`
`"constant"` | +| `track_mask` | Optional mask to indicate visible frames. If provided, frames where the mask has any nonzero pixel are marked as visible for all tracks. | MASK | No | - | **Note:** The `mid_x` and `mid_y` parameters are only used when the `bezier` parameter is set to `True`. When `bezier` is `False`, the path is a straight line from the start to the end point. @@ -33,4 +33,4 @@ The `GenerateTracks` node creates multiple parallel motion paths for video gener > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GenerateTracks/en.md) --- -**Source fingerprint (SHA-256):** `e4070f3f092bccaf8410800e36b97f5dc56584847221cfeca469b2bb4ca44355` +**Source fingerprint (SHA-256):** `4bd4d03a84f4b7ea260555b43f217af0b90dd4ca5196aca94e8f3886875ab912` diff --git a/comfyui_embedded_docs/docs/GetICLoRAParameters/en.md b/comfyui_embedded_docs/docs/GetICLoRAParameters/en.md index 4c1c2db93..0890e9b38 100644 --- a/comfyui_embedded_docs/docs/GetICLoRAParameters/en.md +++ b/comfyui_embedded_docs/docs/GetICLoRAParameters/en.md @@ -1,8 +1,6 @@ # Get IC-LoRA Parameters -## Overview - -This node extracts IC-LoRA parameters from the metadata of a LoRA-loaded model. It reads the safetensors metadata to find values like the reference downscale factor and outputs them as a structured parameter object, which can be connected to the LTXVAddGuide node for special guide handling. +This node reads the metadata from a LoRA-loaded model to extract IC-LoRA parameters, such as the reference downscale factor. It outputs these parameters as a structured object that can be connected to the LTXVAddGuide node when a LoRA requires special handling of the guides. ## Inputs @@ -10,6 +8,8 @@ This node extracts IC-LoRA parameters from the metadata of a LoRA-loaded model. | --- | --- | --- | --- | --- | | `iclora_model` | Direct output from a LoRA Loader for the specific IC-LoRA from which to extract the metadata. | MODEL | Yes | N/A | +Note: If the LoRA metadata is missing or does not contain a `reference_downscale_factor` entry, the node outputs a default value of 1. When present, the factor is rounded and set to a minimum of 1. + ## Outputs | Output Name | Description | Data Type | @@ -19,4 +19,4 @@ This node extracts IC-LoRA parameters from the metadata of a LoRA-loaded model. > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GetICLoRAParameters/en.md) --- -**Source fingerprint (SHA-256):** `44673f0b06cb258014efd77f734c076865d59338ddf825598d85592f000aca50` +**Source fingerprint (SHA-256):** `5f6becad0c7673b8cde1e099bd7ba5be7106da958b8967f8e693ba2a704baaef` diff --git a/comfyui_embedded_docs/docs/GetMeshInfo/ar.md b/comfyui_embedded_docs/docs/GetMeshInfo/ar.md new file mode 100644 index 000000000..1c01d51ed --- /dev/null +++ b/comfyui_embedded_docs/docs/GetMeshInfo/ar.md @@ -0,0 +1,23 @@ +# GetMeshInfo + +يعرض Get Mesh Info عدد الرؤوس والأوجه في الشبكة، بالإضافة إلى السمات التي تحتويها (مثل إحداثيات النسيج UVs، وألوان الرؤوس، والمتجهات العمودية، والقوام). يتم عرض التقرير على العقدة وإرجاعه كمخرج نصي، بينما تمر الشبكة نفسها دون تغيير. + +## المدخلات + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|-----------|-------------|-----------|----------|-------| +| `mesh` | الشبكة المراد فحصها. تقوم العقدة بعدّ رؤوسها وأوجهها، وتكتشف السمات الموجودة، وتمرر الشبكة دون تغيير. | MESH | نعم | — | + +ملاحظة: عندما يحتوي الإدخال على عدة شبكات (دفعة)، يعرض التقرير إجمالي عدد الرؤوس والأوجه للدفعة بأكملها بالإضافة إلى تفصيل لكل شبكة. بالنسبة للدفعات المبطّنة بالأصفار، يتم استخدام أعداد العناصر الفردية المخزنة في بيانات الشبكة. + +## المخرجات + +| اسم المخرج | الوصف | نوع البيانات | +|-------------|-------------|-----------| +| `mesh` | الشبكة الأصلية، تمر دون أي تعديل. | MESH | +| `info` | تقرير نصي متعدد الأسطر يحتوي على عدد الرؤوس والأوجه والسمات المكتشفة (uvs, vertex_colors, normals, tangents, texture, metallic_roughness, normal_map). يتم تنسيق الأعداد الكبيرة بفواصل، على سبيل المثال "1,234,567 (1.23M)". ويتم عرض النص نفسه على العقدة. | STRING | + +> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GetMeshInfo/ar.md) + +--- +**Source fingerprint (SHA-256):** `cd168a5e69131a4a37f1f47014af2bc2ac2c8aa69e146cf33c2072480b35ebb2` diff --git a/comfyui_embedded_docs/docs/GetMeshInfo/en.md b/comfyui_embedded_docs/docs/GetMeshInfo/en.md new file mode 100644 index 000000000..7095080bf --- /dev/null +++ b/comfyui_embedded_docs/docs/GetMeshInfo/en.md @@ -0,0 +1,23 @@ +# GetMeshInfo + +Get Mesh Info reports the number of vertices and faces in a mesh, along with the attributes it contains (such as UVs, vertex colors, normals, and textures). The report is displayed on the node and returned as a text output, while the mesh itself passes through unchanged. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `mesh` | The mesh to inspect. The node counts its vertices and faces, detects which attributes are present, and passes the mesh through unchanged. | MESH | Yes | — | + +Note: When the input contains several meshes (a batch), the report shows total vertex and face counts for the whole batch plus a breakdown per mesh. For zero-padded batches, the per-item counts stored in the mesh data are used. + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `mesh` | The original mesh, passed through without any modification. | MESH | +| `info` | A multiline text report with vertex count, face count, and detected attributes (uvs, vertex_colors, normals, tangents, texture, metallic_roughness, normal_map). Large counts are comma-formatted, for example "1,234,567 (1.23M)". The same text is displayed on the node. | STRING | + +> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GetMeshInfo/en.md) + +--- +**Source fingerprint (SHA-256):** `cd168a5e69131a4a37f1f47014af2bc2ac2c8aa69e146cf33c2072480b35ebb2` diff --git a/comfyui_embedded_docs/docs/GetMeshInfo/es.md b/comfyui_embedded_docs/docs/GetMeshInfo/es.md new file mode 100644 index 000000000..bf49a3364 --- /dev/null +++ b/comfyui_embedded_docs/docs/GetMeshInfo/es.md @@ -0,0 +1,23 @@ +# GetMeshInfo + +**Get Mesh Info** informa el número de vértices y caras de una malla, junto con los atributos que contiene (como UVs, colores de vértice, normales y texturas). El informe se muestra en el nodo y se devuelve como salida de texto, mientras que la malla en sí misma pasa sin cambios. + +## Entradas + +| Parámetro | Descripción | Tipo de datos | Requerido | Rango | +|-----------|-------------|---------------|-----------|-------| +| `mesh` | La malla a inspeccionar. El nodo cuenta sus vértices y caras, detecta qué atributos están presentes y pasa la malla sin cambios. | MESH | Sí | — | + +Nota: Cuando la entrada contiene varias mallas (un lote), el informe muestra los recuentos totales de vértices y caras para todo el lote, además de un desglose por malla. Para lotes con relleno de ceros, se utilizan los recuentos por elemento almacenados en los datos de la malla. + +## Salidas + +| Nombre de salida | Descripción | Tipo de datos | +|------------------|-------------|---------------| +| `mesh` | La malla original, pasada sin ninguna modificación. | MESH | +| `info` | Un informe de texto multilínea con el recuento de vértices, el recuento de caras y los atributos detectados (uvs, vertex_colors, normals, tangents, texture, metallic_roughness, normal_map). Los recuentos grandes se formatean con comas, por ejemplo "1,234,567 (1.23M)". El mismo texto se muestra en el nodo. | STRING | + +> Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GetMeshInfo/es.md) + +--- +**Source fingerprint (SHA-256):** `cd168a5e69131a4a37f1f47014af2bc2ac2c8aa69e146cf33c2072480b35ebb2` diff --git a/comfyui_embedded_docs/docs/GetMeshInfo/fa.md b/comfyui_embedded_docs/docs/GetMeshInfo/fa.md new file mode 100644 index 000000000..0159609a8 --- /dev/null +++ b/comfyui_embedded_docs/docs/GetMeshInfo/fa.md @@ -0,0 +1,21 @@ +# GetMeshInfo + +## ورودی‌ها + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `mesh` | مشی که قرار است بررسی شود. گره تعداد رئوس و وجوه آن را می‌شمارد، ویژگی‌های موجود را شناسایی می‌کند و مش را بدون تغییر عبور می‌دهد. | MESH | بله | — | + +توجه: وقتی ورودی شامل چند مش (یک دسته) باشد، گزارش تعداد کل رئوس و وجوه کل دسته را به همراه تفکیک هر مش نشان می‌دهد. برای دسته‌های صفرگذاری‌شده، تعداد هر آیتم که در داده مش ذخیره شده استفاده می‌شود. + +## خروجی‌ها + +| نام خروجی | توضیحات | نوع داده | +|-------------|-------------|-----------| +| `mesh` | مش اصلی، بدون هیچ تغییری عبور داده می‌شود. | MESH | +| `info` | یک گزارش متنی چندخطی شامل تعداد رئوس، تعداد وجوه و ویژگی‌های شناسایی‌شده (uvs، vertex_colors، normals، tangents، texture، metallic_roughness، normal_map). شمارش‌های بزرگ با کاما قالب‌بندی می‌شوند، برای مثال «1,234,567 (1.23M)». همین متن روی گره نمایش داده می‌شود. | STRING | + +> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GetMeshInfo/fa.md) + +--- +**Source fingerprint (SHA-256):** `cd168a5e69131a4a37f1f47014af2bc2ac2c8aa69e146cf33c2072480b35ebb2` diff --git a/comfyui_embedded_docs/docs/GetMeshInfo/fr.md b/comfyui_embedded_docs/docs/GetMeshInfo/fr.md new file mode 100644 index 000000000..a84d1fb1b --- /dev/null +++ b/comfyui_embedded_docs/docs/GetMeshInfo/fr.md @@ -0,0 +1,23 @@ +# GetMeshInfo + +Get Mesh Info indique le nombre de sommets et de faces d’un maillage, ainsi que les attributs qu’il contient (tels que les UV, les couleurs de sommets, les normales et les textures). Le rapport est affiché sur le nœud et renvoyé sous forme de sortie texte, tandis que le maillage lui-même est transmis tel quel. + +## Entrées + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `mesh` | Le maillage à inspecter. Le nœud compte ses sommets et ses faces, détecte les attributs présents et transmet le maillage sans modification. | MESH | Oui | — | + +Remarque : lorsque l’entrée contient plusieurs maillages (un lot), le rapport indique les totaux de sommets et de faces pour l’ensemble du lot, ainsi qu’une ventilation par maillage. Pour les lots avec remplissage de zéros, les comptes par élément stockés dans les données du maillage sont utilisés. + +## Sorties + +| Nom de sortie | Description | Type de données | +|---------------|-------------|-----------------| +| `mesh` | Le maillage d’origine, transmis sans aucune modification. | MESH | +| `info` | Un rapport textuel sur plusieurs lignes indiquant le nombre de sommets, le nombre de faces et les attributs détectés (uvs, vertex_colors, normals, tangents, texture, metallic_roughness, normal_map). Les grands nombres sont formatés avec des virgules, par exemple « 1,234,567 (1.23M) ». Le même texte est affiché sur le nœud. | STRING | + +> Cette documentation a été générée par IA. Si vous trouvez des erreurs ou avez des suggestions d'amélioration, n'hésitez pas à contribuer ! [Modifier sur GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GetMeshInfo/fr.md) + +--- +**Source fingerprint (SHA-256):** `cd168a5e69131a4a37f1f47014af2bc2ac2c8aa69e146cf33c2072480b35ebb2` diff --git a/comfyui_embedded_docs/docs/GetMeshInfo/ja.md b/comfyui_embedded_docs/docs/GetMeshInfo/ja.md new file mode 100644 index 000000000..404fdb99b --- /dev/null +++ b/comfyui_embedded_docs/docs/GetMeshInfo/ja.md @@ -0,0 +1,23 @@ +# GetMeshInfo + +Get Mesh Info は、メッシュ内の頂点数と面数を、メッシュが含む属性(UV、頂点カラー、法線、テクスチャなど)とともに報告します。レポートはノード上に表示され、テキスト出力として返されます。メッシュ自体は変更されずにそのまま渡されます。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|------|----------|------|------| +| `mesh` | 検査対象のメッシュ。ノードは頂点数と面数を数え、どの属性が存在するかを検出し、メッシュを変更せずにそのまま渡します。 | MESH | はい | — | + +注:入力に複数のメッシュ(バッチ)が含まれる場合、レポートにはバッチ全体の頂点数と面数の合計に加え、メッシュごとの内訳が表示されます。ゼロパディングされたバッチの場合、メッシュデータに格納されているアイテムごとのカウントが使用されます。 + +## 出力 + +| 出力名 | 説明 | データ型 | +|--------|------|----------| +| `mesh` | 元のメッシュ。変更されることなくそのまま渡されます。 | MESH | +| `info` | 頂点数、面数、検出された属性(uvs、vertex_colors、normals、tangents、texture、metallic_roughness、normal_map)を含む複数行のテキストレポート。大きな数値はカンマ区切りでフォーマットされます(例:"1,234,567 (1.23M)")。同じテキストがノード上に表示されます。 | STRING | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GetMeshInfo/ja.md) + +--- +**Source fingerprint (SHA-256):** `cd168a5e69131a4a37f1f47014af2bc2ac2c8aa69e146cf33c2072480b35ebb2` diff --git a/comfyui_embedded_docs/docs/GetMeshInfo/ko.md b/comfyui_embedded_docs/docs/GetMeshInfo/ko.md new file mode 100644 index 000000000..87c7cf928 --- /dev/null +++ b/comfyui_embedded_docs/docs/GetMeshInfo/ko.md @@ -0,0 +1,23 @@ +# GetMeshInfo + +Get Mesh Info는 메시의 정점(버텍스) 수와 면(폴리곤) 수, 그리고 메시가 포함하는 속성(예: UV, 버텍스 컬러, 노멀, 텍스처)을 보고합니다. 보고서는 노드에 표시되고 텍스트 출력으로 반환되며, 메시 자체는 변경 없이 그대로 통과합니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `mesh` | 검사할 메시입니다. 노드는 메시의 정점과 면 수를 계산하고, 포함된 속성을 감지한 후, 메시를 변경 없이 그대로 통과시킵니다. | MESH | 예 | — | + +참고: 입력에 여러 메시(배치)가 포함된 경우, 보고서에는 전체 배치에 대한 총 정점/면 수와 각 메시별 세부 수치가 표시됩니다. 제로 패딩된 배치의 경우 메시 데이터에 저장된 항목별 수치가 사용됩니다. + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `mesh` | 원본 메시로, 어떠한 수정도 없이 그대로 통과합니다. | MESH | +| `info` | 정점 수, 면 수, 감지된 속성(uvs, vertex_colors, normals, tangents, texture, metallic_roughness, normal_map)을 포함한 여러 줄의 텍스트 보고서입니다. 큰 수는 쉼표로 서식이 지정됩니다(예: "1,234,567 (1.23M)"). 동일한 텍스트가 노드에 표시됩니다. | STRING | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GetMeshInfo/ko.md) + +--- +**Source fingerprint (SHA-256):** `cd168a5e69131a4a37f1f47014af2bc2ac2c8aa69e146cf33c2072480b35ebb2` diff --git a/comfyui_embedded_docs/docs/GetMeshInfo/pt-BR.md b/comfyui_embedded_docs/docs/GetMeshInfo/pt-BR.md new file mode 100644 index 000000000..02bcc80be --- /dev/null +++ b/comfyui_embedded_docs/docs/GetMeshInfo/pt-BR.md @@ -0,0 +1,23 @@ +# GetMeshInfo + +Get Mesh Info informa o número de vértices e faces em uma malha, juntamente com os atributos que ela contém (como UVs, cores de vértice, normais e texturas). O relatório é exibido no nó e retornado como uma saída de texto, enquanto a malha em si passa inalterada. + +## Entradas + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | +|-----------|-------------|-----------|----------|-------| +| `mesh` | A malha a ser inspecionada. O nó conta seus vértices e faces, detecta quais atributos estão presentes e passa a malha adiante inalterada. | MESH | Sim | — | + +Nota: Quando a entrada contém várias malhas (um lote), o relatório mostra contagens totais de vértices e faces para o lote inteiro, além de um detalhamento por malha. Para lotes com preenchimento zero, as contagens por item armazenadas nos dados da malha são usadas. + +## Saídas + +| Nome da Saída | Descrição | Tipo de Dados | +|-------------|-------------|-----------| +| `mesh` | A malha original, passada adiante sem qualquer modificação. | MESH | +| `info` | Um relatório de texto multilinha com contagem de vértices, contagem de faces e atributos detectados (uvs, vertex_colors, normals, tangents, texture, metallic_roughness, normal_map). Contagens grandes são formatadas com vírgula, por exemplo "1,234,567 (1.23M)". O mesmo texto é exibido no nó. | STRING | + +> Esta documentação foi gerada por IA. Se você encontrar erros ou tiver sugestões de melhoria, sinta-se à vontade para contribuir! [Editar no GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GetMeshInfo/pt-BR.md) + +--- +**Source fingerprint (SHA-256):** `cd168a5e69131a4a37f1f47014af2bc2ac2c8aa69e146cf33c2072480b35ebb2` diff --git a/comfyui_embedded_docs/docs/GetMeshInfo/ru.md b/comfyui_embedded_docs/docs/GetMeshInfo/ru.md new file mode 100644 index 000000000..a94bc9ad5 --- /dev/null +++ b/comfyui_embedded_docs/docs/GetMeshInfo/ru.md @@ -0,0 +1,23 @@ +# GetMeshInfo + +Get Mesh Info сообщает количество вершин и граней в сетке, а также атрибуты, которые она содержит (например, UV, цвета вершин, нормали и текстуры). Отчёт отображается на узле и возвращается в виде текстового вывода, при этом сама сетка передаётся без изменений. + +## Входы + +| Параметр | Описание | Тип данных | Обязательность | Диапазон | +|-----------|-------------|-----------|----------------|----------| +| `mesh` | Сетка для анализа. Узел подсчитывает её вершины и грани, определяет наличие атрибутов и передаёт сетку дальше без изменений. | MESH | Да | — | + +Примечание: когда на вход подаётся несколько сеток (пакет), в отчёте показываются общее количество вершин и граней для всего пакета, а также разбивка по каждой сетке. Для пакетов с нулевым дополнением используются счётчики для каждого элемента, хранящиеся в данных сетки. + +## Выходы + +| Имя вывода | Описание | Тип данных | +|-------------|-------------|-------------| +| `mesh` | Исходная сетка, передаваемая без каких-либо изменений. | MESH | +| `info` | Многострочный текстовый отчёт с количеством вершин, граней и обнаруженными атрибутами (uvs, vertex_colors, normals, tangents, texture, metallic_roughness, normal_map). Большие числа форматируются с разделителями разрядов, например "1,234,567 (1.23M)". Тот же текст отображается на узле. | STRING | + +> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GetMeshInfo/ru.md) + +--- +**Source fingerprint (SHA-256):** `cd168a5e69131a4a37f1f47014af2bc2ac2c8aa69e146cf33c2072480b35ebb2` diff --git a/comfyui_embedded_docs/docs/GetMeshInfo/tr.md b/comfyui_embedded_docs/docs/GetMeshInfo/tr.md new file mode 100644 index 000000000..a00754a48 --- /dev/null +++ b/comfyui_embedded_docs/docs/GetMeshInfo/tr.md @@ -0,0 +1,23 @@ +# GetMeshInfo + +Get Mesh Info, bir ağdaki (mesh) köşe ve yüzey sayısını, ayrıca içerdiği nitelikleri (UV'ler, köşe renkleri, normaller ve dokular gibi) raporlar. Rapor düğüm üzerinde görüntülenir ve metin çıktısı olarak döndürülür; ağın kendisi değişmeden geçer. + +## Girdiler + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +|-----------|-------------|-----------|----------|-------| +| `mesh` | Denetlenecek ağ. Düğüm, köşeleri ve yüzeyleri sayar, hangi niteliklerin mevcut olduğunu tespit eder ve ağı değiştirmeden geçirir. | MESH | Evet | — | + +Not: Girdi birden fazla ağ içerdiğinde (bir grup), rapor tüm grup için toplam köşe ve yüzey sayılarını ve ayrıca ağ başına dökümü gösterir. Sıfır dolgulu gruplarda, ağ verilerinde saklanan öğe başına sayılar kullanılır. + +## Çıktılar + +| Çıktı Adı | Açıklama | Veri Türü | +|-------------|-------------|-----------| +| `mesh` | Orijinal ağ, hiçbir değişiklik yapılmadan geçirilir. | MESH | +| `info` | Çok satırlı bir metin raporu: köşe sayısı, yüzey sayısı ve tespit edilen nitelikler (uvs, vertex_colors, normals, tangents, texture, metallic_roughness, normal_map). Büyük sayılar virgülle biçimlendirilir, örneğin "1,234,567 (1.23M)". Aynı metin düğüm üzerinde görüntülenir. | STRING | + +> Bu belge yapay zeka tarafından oluşturulmuştur. Herhangi bir hata bulursanız veya iyileştirme önerileriniz varsa, katkıda bulunmaktan çekinmeyin! [GitHub'da Düzenle](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GetMeshInfo/tr.md) + +--- +**Source fingerprint (SHA-256):** `cd168a5e69131a4a37f1f47014af2bc2ac2c8aa69e146cf33c2072480b35ebb2` diff --git a/comfyui_embedded_docs/docs/GetMeshInfo/zh-TW.md b/comfyui_embedded_docs/docs/GetMeshInfo/zh-TW.md new file mode 100644 index 000000000..ebf2b81cc --- /dev/null +++ b/comfyui_embedded_docs/docs/GetMeshInfo/zh-TW.md @@ -0,0 +1,23 @@ +# GetMeshInfo + +取得網格資訊會回報網格中的頂點數與面數,以及其所包含的屬性(如 UV、頂點顏色、法線與紋理)。這份報告會顯示在節點上,並以文字輸出回傳,同時網格本身會原封不動地通過。 + +## 輸入 + +| 參數 | 說明 | 資料型別 | 必填 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `mesh` | 要檢查的網格。此節點會計算其頂點與面數,偵測包含哪些屬性,並將網格原封不動地傳遞出去。 | MESH | 是 | — | + +注意:當輸入包含多個網格(批次)時,報告會顯示整個批次的頂點與面總數,並附上每個網格的明細。對於零填充的批次,會使用儲存在網格資料中的每項計數。 + +## 輸出 + +| 輸出名稱 | 說明 | 資料型別 | +|-------------|-------------|-----------| +| `mesh` | 原始網格,未經任何修改直接傳遞。 | MESH | +| `info` | 多行文字報告,包含頂點數、面數與偵測到的屬性(uvs、vertex_colors、normals、tangents、texture、metallic_roughness、normal_map)。大數字會以逗號格式化,例如「1,234,567 (1.23M)」。相同文字也會顯示在節點上。 | STRING | + +> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GetMeshInfo/zh-TW.md) + +--- +**Source fingerprint (SHA-256):** `cd168a5e69131a4a37f1f47014af2bc2ac2c8aa69e146cf33c2072480b35ebb2` diff --git a/comfyui_embedded_docs/docs/GetMeshInfo/zh.md b/comfyui_embedded_docs/docs/GetMeshInfo/zh.md new file mode 100644 index 000000000..8bbb817c3 --- /dev/null +++ b/comfyui_embedded_docs/docs/GetMeshInfo/zh.md @@ -0,0 +1,23 @@ +# GetMeshInfo + +Get Mesh Info 节点会报告网格中的顶点数和面数,以及其包含的属性(如 UV、顶点颜色、法线和纹理)。报告显示在节点上,并作为文本输出返回,而网格本身保持不变。 + +## 输入 + +| 参数 | 描述 | 数据类型 | 是否必填 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `mesh` | 要检查的网格。该节点对其顶点和面进行计数,检测存在哪些属性,并原样传递该网格。 | MESH | 是 | — | + +注意:当输入包含多个网格(一个批次)时,报告会显示整个批次的总顶点数和总面数,以及按网格细分的明细。对于零填充批次,则使用存储在网格数据中的每项计数。 + +## 输出 + +| 输出名称 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `mesh` | 原始网格,未做任何修改地传递。 | MESH | +| `info` | 包含顶点数、面数和检测到的属性(uvs、vertex_colors、normals、tangents、texture、metallic_roughness、normal_map)的多行文本报告。大数值使用逗号格式化,例如 "1,234,567 (1.23M)"。相同文本也会显示在节点上。 | STRING | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GetMeshInfo/zh.md) + +--- +**Source fingerprint (SHA-256):** `cd168a5e69131a4a37f1f47014af2bc2ac2c8aa69e146cf33c2072480b35ebb2` diff --git a/comfyui_embedded_docs/docs/GetVideoComponents/en.md b/comfyui_embedded_docs/docs/GetVideoComponents/en.md index 62775060f..02aeaa4d0 100644 --- a/comfyui_embedded_docs/docs/GetVideoComponents/en.md +++ b/comfyui_embedded_docs/docs/GetVideoComponents/en.md @@ -1,6 +1,6 @@ # Get Video Components -The Get Video Components node extracts all the main elements from a video file. It separates the video into individual frames, extracts the audio track, and provides the video's framerate and bit depth information. This allows you to work with each component independently for further processing or analysis. +The Get Video Components node extracts all the main elements from a video file. It separates the video into individual frames, extracts the audio track, and provides the video's framerate, bit depth, and color space information. This allows you to work with each component independently for further processing or analysis. ## Inputs @@ -16,8 +16,9 @@ The Get Video Components node extracts all the main elements from a video file. | `audio` | The audio track extracted from the video. | AUDIO | | `fps` | The framerate of the video in frames per second. | FLOAT | | `bit_depth` | The bit depth of the video. | INT | +| `color_space` | The color space of the video. | COMBO | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GetVideoComponents/en.md) --- -**Source fingerprint (SHA-256):** `b2232b2c558b472226418d56910b9b763d8398612b31c4019d4881d0c4717b8d` +**Source fingerprint (SHA-256):** `ffe8b6c698cb9a855b8796768f068d403448cf56188ce4c5ead21bff30baff6e` diff --git a/comfyui_embedded_docs/docs/GrokImageEditNode/en.md b/comfyui_embedded_docs/docs/GrokImageEditNode/en.md index c04126b7d..f89ff8897 100644 --- a/comfyui_embedded_docs/docs/GrokImageEditNode/en.md +++ b/comfyui_embedded_docs/docs/GrokImageEditNode/en.md @@ -1,30 +1,31 @@ -# Grok Image Edit Node +# Grok Image Edit -The Grok Image Edit node modifies an existing image based on a text prompt. It uses the Grok API to generate one or more new images that are variations of the input, guided by your description. +The Grok Image Edit node modifies an existing image based on a text prompt. It uses the Grok API to generate one or more new images that are variations of the input, guided by your description. This node is marked as deprecated. ## Inputs | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| | `model` | The specific AI model to use for image editing. | COMBO | Yes | `"grok-imagine-image-quality"`
`"grok-imagine-image-pro"`
`"grok-imagine-image"` | -| `image` | The input image(s) to be edited. Supports up to 3 input images, except for the "pro" model which supports only 1. | IMAGE | Yes | | -| `prompt` | The text prompt used to generate the edited image. Must be at least 1 character after stripping whitespace. | STRING | Yes | | +| `image` | The input image(s) to be edited. | IMAGE | Yes | | +| `prompt` | The text prompt used to generate the image. Multiline text; must contain at least one non-whitespace character. | STRING | Yes | | | `resolution` | The resolution for the output image. | COMBO | Yes | `"1K"`
`"2K"` | -| `number_of_images` | Number of edited images to generate (default: 1). | INT | No | 1 to 10 | -| `seed` | Seed to determine if node should re-run; actual results are nondeterministic regardless of seed (default: 0). | INT | No | 0 to 2147483647 | -| `aspect_ratio` | The aspect ratio for the output image. Only allowed when multiple images are connected to the image input. If set to "auto", the aspect ratio is determined automatically (default: "auto"). | COMBO | No | `"auto"`
`"1:1"`
`"2:3"`
`"3:2"`
`"3:4"`
`"4:3"`
`"9:16"`
`"16:9"`
`"9:19.5"`
`"19.5:9"`
`"9:20"`
`"20:9"`
`"1:2"`
`"2:1"` | +| `number_of_images` | Number of edited images to generate (default: 1). | INT | Yes | 1 to 10 | +| `seed` | Seed to determine if node should re-run; actual results are nondeterministic regardless of seed (default: 0). | INT | Yes | 0 to 2147483647 | +| `aspect_ratio` | The aspect ratio for the output image. Only allowed when multiple images are connected to the image input (default: "auto"). | COMBO | No | `"auto"`
`"1:1"`
`"2:3"`
`"3:2"`
`"3:4"`
`"4:3"`
`"9:16"`
`"16:9"`
`"9:19.5"`
`"19.5:9"`
`"9:20"`
`"20:9"`
`"1:2"`
`"2:1"` | **Important constraints:** - The `image` input supports up to 3 images, except when using the `grok-imagine-image-pro` model, which supports only 1 input image. - The `aspect_ratio` parameter can only be set to a custom value (not "auto") when multiple images are connected to the `image` input. Setting a custom aspect ratio with a single input image will cause an error. +- The `prompt` must contain at least one non-whitespace character. ## Outputs | Output Name | Description | Data Type | |-------------|-------------|-----------| -| `output` | The edited image(s) generated by the node. If `number_of_images` is greater than 1, the outputs are concatenated into a batch. | IMAGE | +| `output` | The edited image(s) generated by the node. If more than one image is generated, the images are concatenated into a single batch. | IMAGE | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GrokImageEditNode/en.md) --- -**Source fingerprint (SHA-256):** `5b2eb9418302bba0e18f43edeab7dc73c9b14ebc78b1ce6cc8a3e5bb411f0351` +**Source fingerprint (SHA-256):** `e2ace07d10901c4e57086da8e3294a5d04e379103e9740131f5355cd4b07625d` diff --git a/comfyui_embedded_docs/docs/GrokImageEditNodeV2/ar.md b/comfyui_embedded_docs/docs/GrokImageEditNodeV2/ar.md index 7b3439dda..3f93295bc 100644 --- a/comfyui_embedded_docs/docs/GrokImageEditNodeV2/ar.md +++ b/comfyui_embedded_docs/docs/GrokImageEditNodeV2/ar.md @@ -7,9 +7,9 @@ | المعامل | الوصف | نوع البيانات | إلزامي | النطاق | |---|---|---|---|---| -| `model` | نموذج Grok للصور الذي سيتم استخدامه. تتغير المعاملات الفرعية الموضحة أدناه اعتمادًا على النموذج المحدد. | DYNAMIC_COMBO | نعم | "grok-imagine-image-2.0"
"grok-imagine-image-quality"
"grok-imagine-image-pro"
"grok-imagine-image" | -| `prompt` | الموجّه النصي المستخدم لإنشاء الصورة. (الافتراضي: "") | STRING | نعم | N/A | -| `seed` | البذرة لتحديد ما إذا كان ينبغي إعادة تشغيل العقدة؛ النتائج الفعلية غير حتمية بغض النظر عن البذرة. (الافتراضي: 0) | INT | نعم | 0 to 2147483647 | +| `النموذج` | نموذج Grok للصور الذي سيتم استخدامه. تتغير المعاملات الفرعية الموضحة أدناه اعتمادًا على النموذج المحدد. | DYNAMIC_COMBO | نعم | "grok-imagine-image-2.0"
"grok-imagine-image-quality"
"grok-imagine-image-pro"
"grok-imagine-image" | +| `الموجه` | الموجّه النصي المستخدم لإنشاء الصورة. (الافتراضي: "") | STRING | نعم | N/A | +| `البذرة` | البذرة لتحديد ما إذا كان ينبغي إعادة تشغيل العقدة؛ النتائج الفعلية غير حتمية بغض النظر عن البذرة. (الافتراضي: 0) | INT | نعم | 0 to 2147483647 | ### مدخلات grok-imagine-image-2.0 diff --git a/comfyui_embedded_docs/docs/GrokImageEditNodeV2/es.md b/comfyui_embedded_docs/docs/GrokImageEditNodeV2/es.md index 24cdc35c5..0489abf57 100644 --- a/comfyui_embedded_docs/docs/GrokImageEditNodeV2/es.md +++ b/comfyui_embedded_docs/docs/GrokImageEditNodeV2/es.md @@ -8,9 +8,9 @@ Este nodo edita una o más imágenes existentes a partir de un prompt de texto. | Parámetro | Descripción | Tipo de dato | Obligatorio | Rango | |-----------|-------------|-----------|----------|-------| -| `model` | El modelo de imagen de Grok a utilizar. Los subparámetros que se muestran a continuación cambian según el modelo seleccionado. | DYNAMIC_COMBO | Sí | "grok-imagine-image-2.0"
"grok-imagine-image-quality"
"grok-imagine-image-pro"
"grok-imagine-image" | +| `modelo` | El modelo de imagen de Grok a utilizar. Los subparámetros que se muestran a continuación cambian según el modelo seleccionado. | DYNAMIC_COMBO | Sí | "grok-imagine-image-2.0"
"grok-imagine-image-quality"
"grok-imagine-image-pro"
"grok-imagine-image" | | `prompt` | El prompt de texto utilizado para generar la imagen. (por defecto: "") | STRING | Sí | N/A | -| `seed` | Semilla para determinar si el nodo debe volver a ejecutarse; los resultados reales son no deterministas independientemente de la semilla. (por defecto: 0) | INT | Sí | 0 a 2147483647 | +| `semilla` | Semilla para determinar si el nodo debe volver a ejecutarse; los resultados reales son no deterministas independientemente de la semilla. (por defecto: 0) | INT | Sí | 0 a 2147483647 | ### Entradas de grok-imagine-image-2.0 diff --git a/comfyui_embedded_docs/docs/GrokImageEditNodeV2/fr.md b/comfyui_embedded_docs/docs/GrokImageEditNodeV2/fr.md index 6aef32fcc..7807a58a8 100644 --- a/comfyui_embedded_docs/docs/GrokImageEditNodeV2/fr.md +++ b/comfyui_embedded_docs/docs/GrokImageEditNodeV2/fr.md @@ -8,9 +8,9 @@ Modifie une ou plusieurs images existantes en fonction d'un prompt texte. Le nœ | Paramètre | Description | Type de données | Requis | Plage | |-----------|-------------|-----------|----------|-------| -| `model` | Le modèle d'image Grok à utiliser. Les sous-paramètres affichés ci-dessous changent en fonction du modèle sélectionné. | DYNAMIC_COMBO | Oui | "grok-imagine-image-2.0"
"grok-imagine-image-quality"
"grok-imagine-image-pro"
"grok-imagine-image" | +| `modèle` | Le modèle d'image Grok à utiliser. Les sous-paramètres affichés ci-dessous changent en fonction du modèle sélectionné. | DYNAMIC_COMBO | Oui | "grok-imagine-image-2.0"
"grok-imagine-image-quality"
"grok-imagine-image-pro"
"grok-imagine-image" | | `prompt` | Le prompt texte utilisé pour générer l'image. (défaut : "") | STRING | Oui | N/A | -| `seed` | Graine permettant de déterminer si le nœud doit être relancé ; les résultats réels sont non déterministes quelle que soit la graine. (défaut : 0) | INT | Oui | 0 à 2147483647 | +| `graine` | Graine permettant de déterminer si le nœud doit être relancé ; les résultats réels sont non déterministes quelle que soit la graine. (défaut : 0) | INT | Oui | 0 à 2147483647 | ### grok-imagine-image-2.0 Entrées diff --git a/comfyui_embedded_docs/docs/GrokImageEditNodeV2/ja.md b/comfyui_embedded_docs/docs/GrokImageEditNodeV2/ja.md index 5e94ee02f..47b7879d2 100644 --- a/comfyui_embedded_docs/docs/GrokImageEditNodeV2/ja.md +++ b/comfyui_embedded_docs/docs/GrokImageEditNodeV2/ja.md @@ -8,9 +8,9 @@ | パラメータ | 説明 | データ型 | 必須 | 範囲 | |-----------|-------------|-----------|----------|-------| -| `model` | 使用するGrok画像モデル。以下に表示されるサブパラメータは、選択したモデルによって異なります。 | DYNAMIC_COMBO | 必須 | "grok-imagine-image-2.0"
"grok-imagine-image-quality"
"grok-imagine-image-pro"
"grok-imagine-image" | -| `prompt` | 画像の生成に使用するテキストプロンプト。(デフォルト:"") | STRING | 必須 | N/A | -| `seed` | ノードを再実行すべきかどうかを決定するためのシード。実際の結果はシードに関係なく非決定的です。(デフォルト:0) | INT | 必須 | 0 〜 2147483647 | +| `モデル` | 使用するGrok画像モデル。以下に表示されるサブパラメータは、選択したモデルによって異なります。 | DYNAMIC_COMBO | 必須 | "grok-imagine-image-2.0"
"grok-imagine-image-quality"
"grok-imagine-image-pro"
"grok-imagine-image" | +| `プロンプト` | 画像の生成に使用するテキストプロンプト。(デフォルト:"") | STRING | 必須 | N/A | +| `シード` | ノードを再実行すべきかどうかを決定するためのシード。実際の結果はシードに関係なく非決定的です。(デフォルト:0) | INT | 必須 | 0 〜 2147483647 | ### grok-imagine-image-2.0 入力 diff --git a/comfyui_embedded_docs/docs/GrokImageEditNodeV2/ko.md b/comfyui_embedded_docs/docs/GrokImageEditNodeV2/ko.md index bb24e1ab7..6aaab6155 100644 --- a/comfyui_embedded_docs/docs/GrokImageEditNodeV2/ko.md +++ b/comfyui_embedded_docs/docs/GrokImageEditNodeV2/ko.md @@ -8,9 +8,9 @@ | 매개변수 | 설명 | 데이터 유형 | 필수 | 범위 | |-----------|-------------|-----------|----------|-------| -| `model` | 사용할 Grok 이미지 모델입니다. 아래 표시되는 하위 매개변수는 선택한 모델에 따라 변경됩니다. | DYNAMIC_COMBO | 예 | "grok-imagine-image-2.0"
"grok-imagine-image-quality"
"grok-imagine-image-pro"
"grok-imagine-image" | -| `prompt` | 이미지를 생성하는 데 사용되는 텍스트 프롬프트입니다. (기본값: "") | STRING | 예 | N/A | -| `seed` | 노드 재실행 여부를 결정하는 시드입니다. 실제 결과는 시드와 관계없이 비결정적입니다. (기본값: 0) | INT | 예 | 0 ~ 2147483647 | +| `모델` | 사용할 Grok 이미지 모델입니다. 아래 표시되는 하위 매개변수는 선택한 모델에 따라 변경됩니다. | DYNAMIC_COMBO | 예 | "grok-imagine-image-2.0"
"grok-imagine-image-quality"
"grok-imagine-image-pro"
"grok-imagine-image" | +| `프롬프트` | 이미지를 생성하는 데 사용되는 텍스트 프롬프트입니다. (기본값: "") | STRING | 예 | N/A | +| `시드` | 노드 재실행 여부를 결정하는 시드입니다. 실제 결과는 시드와 관계없이 비결정적입니다. (기본값: 0) | INT | 예 | 0 ~ 2147483647 | ### grok-imagine-image-2.0 입력 diff --git a/comfyui_embedded_docs/docs/GrokImageEditNodeV2/pt-BR.md b/comfyui_embedded_docs/docs/GrokImageEditNodeV2/pt-BR.md index 70687d3da..b4ba9f603 100644 --- a/comfyui_embedded_docs/docs/GrokImageEditNodeV2/pt-BR.md +++ b/comfyui_embedded_docs/docs/GrokImageEditNodeV2/pt-BR.md @@ -7,9 +7,9 @@ Modifique uma imagem existente com base em um prompt de texto. Este nó envia su | Parâmetro | Descrição | Tipo de dados | Obrigatório | Intervalo | |---|---|---|---|---| -| `model` | O modelo de imagem Grok a ser usado. Os subparâmetros exibidos abaixo mudam dependendo do modelo selecionado. | DYNAMIC_COMBO | Sim | "grok-imagine-image-2.0"
"grok-imagine-image-quality"
"grok-imagine-image-pro"
"grok-imagine-image" | +| `modelo` | O modelo de imagem Grok a ser usado. Os subparâmetros exibidos abaixo mudam dependendo do modelo selecionado. | DYNAMIC_COMBO | Sim | "grok-imagine-image-2.0"
"grok-imagine-image-quality"
"grok-imagine-image-pro"
"grok-imagine-image" | | `prompt` | O prompt de texto usado para gerar a imagem. (padrão: "") | STRING | Sim | N/A | -| `seed` | Semente para determinar se o nó deve ser executado novamente; os resultados reais são não determinísticos, independentemente da semente. (padrão: 0) | INT | Sim | 0 to 2147483647 | +| `semente` | Semente para determinar se o nó deve ser executado novamente; os resultados reais são não determinísticos, independentemente da semente. (padrão: 0) | INT | Sim | 0 to 2147483647 | ### Entradas do grok-imagine-image-2.0 diff --git a/comfyui_embedded_docs/docs/GrokImageEditNodeV2/zh-TW.md b/comfyui_embedded_docs/docs/GrokImageEditNodeV2/zh-TW.md index 4be402ed3..052789813 100644 --- a/comfyui_embedded_docs/docs/GrokImageEditNodeV2/zh-TW.md +++ b/comfyui_embedded_docs/docs/GrokImageEditNodeV2/zh-TW.md @@ -8,9 +8,9 @@ | 參數 | 說明 | 資料型別 | 必要 | 範圍 | |-----------|-------------|-----------|----------|-------| -| `model` | 要使用的 Grok 影像模型。下方顯示的子參數會依所選模型而變。 | DYNAMIC_COMBO | 是 | "grok-imagine-image-2.0"
"grok-imagine-image-quality"
"grok-imagine-image-pro"
"grok-imagine-image" | -| `prompt` | 用於產生影像的文字提示。(預設值:"") | STRING | 是 | N/A | -| `seed` | 用於決定節點是否應重新執行的種子;無論種子數值為何,實際結果皆為非確定性。(預設值:0) | INT | 是 | 0 至 2147483647 | +| `模型` | 要使用的 Grok 影像模型。下方顯示的子參數會依所選模型而變。 | DYNAMIC_COMBO | 是 | "grok-imagine-image-2.0"
"grok-imagine-image-quality"
"grok-imagine-image-pro"
"grok-imagine-image" | +| `提示詞` | 用於產生影像的文字提示。(預設值:"") | STRING | 是 | N/A | +| `種子` | 用於決定節點是否應重新執行的種子;無論種子數值為何,實際結果皆為非確定性。(預設值:0) | INT | 是 | 0 至 2147483647 | ### grok-imagine-image-2.0 輸入 diff --git a/comfyui_embedded_docs/docs/GrokImageEditNodeV2/zh.md b/comfyui_embedded_docs/docs/GrokImageEditNodeV2/zh.md index c714da97b..54ae46800 100644 --- a/comfyui_embedded_docs/docs/GrokImageEditNodeV2/zh.md +++ b/comfyui_embedded_docs/docs/GrokImageEditNodeV2/zh.md @@ -8,9 +8,9 @@ | 参数 | 描述 | 数据类型 | 必填 | 范围 | |-----------|-------------|-----------|----------|-------| -| `model` | 要使用的 Grok 图像模型。下方显示的子参数会随所选模型而变化。 | DYNAMIC_COMBO | 是 | "grok-imagine-image-2.0"
"grok-imagine-image-quality"
"grok-imagine-image-pro"
"grok-imagine-image" | -| `prompt` | 用于生成图像的文字提示。(默认值:"") | STRING | 是 | 不适用 | -| `seed` | 用于决定节点是否应重新运行的种子;实际结果与种子无关,具有不确定性。(默认值:0) | INT | 是 | 0 到 2147483647 | +| `模型` | 要使用的 Grok 图像模型。下方显示的子参数会随所选模型而变化。 | DYNAMIC_COMBO | 是 | "grok-imagine-image-2.0"
"grok-imagine-image-quality"
"grok-imagine-image-pro"
"grok-imagine-image" | +| `提示词` | 用于生成图像的文字提示。(默认值:"") | STRING | 是 | 不适用 | +| `种子` | 用于决定节点是否应重新运行的种子;实际结果与种子无关,具有不确定性。(默认值:0) | INT | 是 | 0 到 2147483647 | ### grok-imagine-image-2.0 输入 diff --git a/comfyui_embedded_docs/docs/GrokImageNode/en.md b/comfyui_embedded_docs/docs/GrokImageNode/en.md index 40354dcad..1e9ff21b8 100644 --- a/comfyui_embedded_docs/docs/GrokImageNode/en.md +++ b/comfyui_embedded_docs/docs/GrokImageNode/en.md @@ -1,4 +1,4 @@ -# Grok Image Node +# Grok Image The Grok Image node generates one or more images based on a text description using the Grok AI model. It sends your prompt to an external service and returns the generated images as tensors that can be used in your workflow. @@ -6,16 +6,17 @@ The Grok Image node generates one or more images based on a text description usi | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `model` | The specific Grok model to use for image generation. Different models may offer varying quality, speed, or features. | COMBO | Yes | `"grok-imagine-image-quality"`
`"grok-imagine-image-pro"`
`"grok-imagine-image"` | +| `model` | The specific Grok model to use for image generation. Different models may offer varying quality, speed, or features. | COMBO | Yes | `"grok-imagine-image-2.0"`
`"grok-imagine-image-quality"`
`"grok-imagine-image-pro"`
`"grok-imagine-image"` | | `prompt` | The text prompt used to generate the image. This description guides the AI on what to create. Must be at least 1 character long. | STRING | Yes | N/A | | `aspect_ratio` | The desired width-to-height ratio for the generated image. | COMBO | Yes | `"1:1"`
`"2:3"`
`"3:2"`
`"3:4"`
`"4:3"`
`"9:16"`
`"16:9"`
`"9:19.5"`
`"19.5:9"`
`"9:20"`
`"20:9"`
`"1:2"`
`"2:1"` | -| `number_of_images` | Number of images to generate (default: 1). | INT | No | 1 to 10 | -| `seed` | Seed to determine if node should re-run; actual results are nondeterministic regardless of seed (default: 0). | INT | No | 0 to 2147483647 | +| `number_of_images` | Number of images to generate (default: 1). | INT | Yes | 1 to 10 | +| `seed` | Seed to determine if node should re-run; actual results are nondeterministic regardless of seed (default: 0). | INT | Yes | 0 to 2147483647 | | `resolution` | The desired output resolution for the generated images (default: "1K"). | COMBO | No | `"1K"`
`"2K"` | +| `quality` | Quality level, supported only by the `grok-imagine-image-2.0` model (default: "medium"; "low" is one of the available options). For all other models, this setting is ignored. | COMBO | No | Multiple options available | **Note:** The `seed` parameter is primarily used to control when the node re-executes within a workflow. Due to the nature of the external AI service, the generated images will not be reproducible or identical across runs, even with an identical seed. -**Note on pricing:** The cost of generating images depends on the selected `model`, `resolution`, and `number_of_images`. For example, the "grok-imagine-image-quality" model with "1K" resolution costs $0.05 per image, while "2K" resolution costs $0.07 per image. The "grok-imagine-image-pro" model costs $0.07 per image, and other models cost $0.02 per image. +**Note on pricing:** The cost of generating images depends on the selected `model`, `resolution`, `quality`, and `number_of_images`. For the `grok-imagine-image-2.0` model, "low" quality costs $0.04 per image at 1K resolution and $0.06 per image at 2K resolution; other quality levels cost $0.06 per image at 1K and $0.08 per image at 2K. The `grok-imagine-image-quality` model costs $0.05 per image at 1K resolution and $0.07 per image at 2K resolution. The `grok-imagine-image-pro` model costs $0.07 per image. The `grok-imagine-image` model costs $0.02 per image. ## Outputs @@ -26,4 +27,4 @@ The Grok Image node generates one or more images based on a text description usi > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GrokImageNode/en.md) --- -**Source fingerprint (SHA-256):** `e7f3e249c56ee0f9f4e703d6c478cc0f160f95ee605acd5176f4f62212b8b3cf` +**Source fingerprint (SHA-256):** `a89f5df0d4827f45013f1af92541d36b5b8c8edc8626e07af4fe2d85ee5486e7` diff --git a/comfyui_embedded_docs/docs/GrokVideoEditNode/en.md b/comfyui_embedded_docs/docs/GrokVideoEditNode/en.md index 671d0b70c..8d121bac9 100644 --- a/comfyui_embedded_docs/docs/GrokVideoEditNode/en.md +++ b/comfyui_embedded_docs/docs/GrokVideoEditNode/en.md @@ -1,4 +1,4 @@ -# Grok Video Edit Node +# Grok Video Edit This node uses the Grok API to edit an existing video based on a text prompt. It uploads your video, sends a request to the AI model to modify it according to your description, and returns the newly generated video. @@ -6,16 +6,16 @@ This node uses the Grok API to edit an existing video based on a text prompt. It | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `model` | The AI model to use for video editing (default: `"grok-imagine-video"`). | STRING | Yes | `"grok-imagine-video"` | +| `model` | The AI model to use for video editing (default: "grok-imagine-video"). | COMBO | Yes | "grok-imagine-video" | | `prompt` | Text description of the desired video. | STRING | Yes | N/A | | `video` | The input video to be edited. Maximum supported duration is 8.7 seconds and 50MB file size. | VIDEO | Yes | N/A | | `seed` | Seed to determine if node should re-run; actual results are nondeterministic regardless of seed (default: 0). | INT | No | 0 to 2147483647 | **Constraints:** +* The `prompt` must not be empty. * The input `video` must be between 1 and 8.7 seconds in duration. * The input `video` file size must not exceed 50MB. -* The `prompt` must not be empty. ## Outputs @@ -26,4 +26,4 @@ This node uses the Grok API to edit an existing video based on a text prompt. It > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GrokVideoEditNode/en.md) --- -**Source fingerprint (SHA-256):** `488aa152744e5a17a9fbc55f8cbc3e863e1212f58544e47aa377276e8990834c` +**Source fingerprint (SHA-256):** `7ceedff2f858bc0849b5e0d92d10ed51e7fdccd1391c6a6966561cb05999b4b1` diff --git a/comfyui_embedded_docs/docs/GrokVideoExtendNode/en.md b/comfyui_embedded_docs/docs/GrokVideoExtendNode/en.md index 10c1fb2a8..3cc7573e7 100644 --- a/comfyui_embedded_docs/docs/GrokVideoExtendNode/en.md +++ b/comfyui_embedded_docs/docs/GrokVideoExtendNode/en.md @@ -21,7 +21,7 @@ The Grok Video Extend node uses an AI model to create a seamless continuation of **Parameter Constraints:** * The `video` input must be an MP4 file between 2 and 15 seconds in length and cannot exceed 50MB in file size. -* The `prompt` must contain at least one character (whitespace is trimmed). +* The `prompt` must contain at least one character after whitespace is trimmed. * The `model` parameter is a dynamic combo. Selecting the "grok-imagine-video" option reveals the nested `duration` parameter. ## Outputs @@ -33,4 +33,4 @@ The Grok Video Extend node uses an AI model to create a seamless continuation of > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GrokVideoExtendNode/en.md) --- -**Source fingerprint (SHA-256):** `bfaf56dd12afab13c820345587db9ee871db87d60b8dc003f00f035513dbdf61` +**Source fingerprint (SHA-256):** `5009c007b6f93cd44f2742b024b65f1ac92ab9bca3b85a55554b1d99649e323b` diff --git a/comfyui_embedded_docs/docs/GrokVideoExtendNode/es.md b/comfyui_embedded_docs/docs/GrokVideoExtendNode/es.md index 68786bbe6..f71144ba3 100644 --- a/comfyui_embedded_docs/docs/GrokVideoExtendNode/es.md +++ b/comfyui_embedded_docs/docs/GrokVideoExtendNode/es.md @@ -8,10 +8,10 @@ El nodo Grok Video Extend utiliza un modelo de IA para crear una continuación s | Parámetro | Descripción | Tipo de datos | Requerido | Rango | |-----------|-------------|-----------|----------|-------| -| `model` | El modelo que se utilizará para la extensión de video. | DYNAMIC_COMBO | Sí | `"grok-imagine-video"` | +| `modelo` | El modelo que se utilizará para la extensión de video. | DYNAMIC_COMBO | Sí | `"grok-imagine-video"` | | `prompt` | Descripción textual de lo que debería suceder a continuación en el video. | STRING | Sí | N/A | | `video` | Video de origen para extender. Formato MP4, de 2 a 15 segundos. | VIDEO | Sí | N/A | -| `seed` | Semilla para determinar si el nodo debe volver a ejecutarse; los resultados reales son no deterministas independientemente de la semilla (por defecto: 0). | INT | Sí | 0 a 2147483647 | +| `semilla` | Semilla para determinar si el nodo debe volver a ejecutarse; los resultados reales son no deterministas independientemente de la semilla (por defecto: 0). | INT | Sí | 0 a 2147483647 | ### Entradas de grok-imagine-video diff --git a/comfyui_embedded_docs/docs/GrokVideoExtendNode/fr.md b/comfyui_embedded_docs/docs/GrokVideoExtendNode/fr.md index a08506d76..fc4d648fa 100644 --- a/comfyui_embedded_docs/docs/GrokVideoExtendNode/fr.md +++ b/comfyui_embedded_docs/docs/GrokVideoExtendNode/fr.md @@ -8,10 +8,10 @@ Le nœud Grok Video Extend utilise un modèle d'IA pour créer une continuation | Paramètre | Description | Type de données | Requis | Plage | |-----------|-------------|-----------------|--------|-------| -| `model` | Le modèle à utiliser pour l'extension vidéo. | DYNAMIC_COMBO | Oui | `"grok-imagine-video"` | -| `prompt` | Description textuelle de ce qui doit se passer ensuite dans la vidéo. | STRING | Oui | N/A | -| `video` | Vidéo source à étendre. Format MP4, 2 à 15 secondes. | VIDEO | Oui | N/A | -| `seed` | Graine déterminant si le nœud doit être relancé ; les résultats réels sont non déterministes quelle que soit la graine (par défaut : 0). | INT | Oui | 0 à 2147483647 | +| `modèle` | Le modèle à utiliser pour l'extension vidéo. | DYNAMIC_COMBO | Oui | `"grok-imagine-video"` | +| `invite` | Description textuelle de ce qui doit se passer ensuite dans la vidéo. | STRING | Oui | N/A | +| `vidéo` | Vidéo source à étendre. Format MP4, 2 à 15 secondes. | VIDEO | Oui | N/A | +| `graine` | Graine déterminant si le nœud doit être relancé ; les résultats réels sont non déterministes quelle que soit la graine (par défaut : 0). | INT | Oui | 0 à 2147483647 | ### Entrées grok-imagine-video diff --git a/comfyui_embedded_docs/docs/GrokVideoExtendNode/ja.md b/comfyui_embedded_docs/docs/GrokVideoExtendNode/ja.md index 6d0a9f9eb..f8c784689 100644 --- a/comfyui_embedded_docs/docs/GrokVideoExtendNode/ja.md +++ b/comfyui_embedded_docs/docs/GrokVideoExtendNode/ja.md @@ -8,10 +8,10 @@ Grok Video Extend ノードは、AIモデルを使用して、既存のビデオ | パラメータ | 説明 | データ型 | 必須 | 範囲 | |-----------|-------------|-----------|----------|-------| -| `model` | ビデオ拡張に使用するモデル。 | DYNAMIC_COMBO | 必須 | `"grok-imagine-video"` | -| `prompt` | ビデオで次に起こるべきことを説明するテキスト。 | STRING | 必須 | N/A | -| `video` | 拡張するソースビデオ。MP4形式、2〜15秒。 | VIDEO | 必須 | N/A | -| `seed` | ノードを再実行するかどうかを決定するシード。実際の結果はシードに関係なく非決定的です(デフォルト: 0)。 | INT | 必須 | 0 〜 2147483647 | +| `モデル` | ビデオ拡張に使用するモデル。 | DYNAMIC_COMBO | 必須 | `"grok-imagine-video"` | +| `プロンプト` | ビデオで次に起こるべきことを説明するテキスト。 | STRING | 必須 | N/A | +| `ビデオ` | 拡張するソースビデオ。MP4形式、2〜15秒。 | VIDEO | 必須 | N/A | +| `シード` | ノードを再実行するかどうかを決定するシード。実際の結果はシードに関係なく非決定的です(デフォルト: 0)。 | INT | 必須 | 0 〜 2147483647 | ### grok-imagine-video 入力 diff --git a/comfyui_embedded_docs/docs/GrokVideoExtendNode/ko.md b/comfyui_embedded_docs/docs/GrokVideoExtendNode/ko.md index f8b660d4c..4f04a4cec 100644 --- a/comfyui_embedded_docs/docs/GrokVideoExtendNode/ko.md +++ b/comfyui_embedded_docs/docs/GrokVideoExtendNode/ko.md @@ -8,10 +8,10 @@ The Grok Video Extend 노드는 AI 모델을 사용하여 기존 비디오의 | 매개변수 | 설명 | 데이터 타입 | 필수 여부 | 범위 | |-----------|-------------|-----------|----------|-------| -| `model` | 비디오 확장에 사용할 모델입니다. | DYNAMIC_COMBO | 예 | `"grok-imagine-video"` | -| `prompt` | 비디오에서 다음에 어떤 일이 일어나야 하는지에 대한 텍스트 설명입니다. | STRING | 예 | 해당 없음 | -| `video` | 확장할 원본 비디오입니다. MP4 형식, 2~15초 길이. | VIDEO | 예 | 해당 없음 | -| `seed` | 노드가 다시 실행되어야 하는지 결정하는 시드입니다. 실제 결과는 시드와 관계없이 비결정적입니다(기본값: 0). | INT | 예 | 0 ~ 2147483647 | +| `모델` | 비디오 확장에 사용할 모델입니다. | DYNAMIC_COMBO | 예 | `"grok-imagine-video"` | +| `프롬프트` | 비디오에서 다음에 어떤 일이 일어나야 하는지에 대한 텍스트 설명입니다. | STRING | 예 | 해당 없음 | +| `비디오` | 확장할 원본 비디오입니다. MP4 형식, 2~15초 길이. | VIDEO | 예 | 해당 없음 | +| `시드` | 노드가 다시 실행되어야 하는지 결정하는 시드입니다. 실제 결과는 시드와 관계없이 비결정적입니다(기본값: 0). | INT | 예 | 0 ~ 2147483647 | ### grok-imagine-video 입력 diff --git a/comfyui_embedded_docs/docs/GrokVideoExtendNode/zh-TW.md b/comfyui_embedded_docs/docs/GrokVideoExtendNode/zh-TW.md index e3dbaeeec..f7611b7e1 100644 --- a/comfyui_embedded_docs/docs/GrokVideoExtendNode/zh-TW.md +++ b/comfyui_embedded_docs/docs/GrokVideoExtendNode/zh-TW.md @@ -8,10 +8,10 @@ Grok Video Extend 節點使用 AI 模型來建立現有影片的無縫延續。 | 參數 | 說明 | 資料類型 | 必填 | 範圍 | |-----------|-------------|-----------|----------|-------| -| `model` | 用於影片延續的模型。 | DYNAMIC_COMBO | 是 | `"grok-imagine-video"` | -| `prompt` | 描述影片接下來應發生內容的文字。 | STRING | 是 | N/A | -| `video` | 要延伸的來源影片。MP4 格式,長度 2 至 15 秒。 | VIDEO | 是 | N/A | -| `seed` | 用於決定節點是否應重新執行的種子;無論種子為何,實際結果都是非確定性的(預設值:0)。 | INT | 是 | 0 至 2147483647 | +| `模型` | 用於影片延續的模型。 | DYNAMIC_COMBO | 是 | `"grok-imagine-video"` | +| `提示詞` | 描述影片接下來應發生內容的文字。 | STRING | 是 | N/A | +| `影片` | 要延伸的來源影片。MP4 格式,長度 2 至 15 秒。 | VIDEO | 是 | N/A | +| `種子` | 用於決定節點是否應重新執行的種子;無論種子為何,實際結果都是非確定性的(預設值:0)。 | INT | 是 | 0 至 2147483647 | ### grok-imagine-video 輸入 diff --git a/comfyui_embedded_docs/docs/GrokVideoExtendNode/zh.md b/comfyui_embedded_docs/docs/GrokVideoExtendNode/zh.md index 14c5f4465..e4d95db35 100644 --- a/comfyui_embedded_docs/docs/GrokVideoExtendNode/zh.md +++ b/comfyui_embedded_docs/docs/GrokVideoExtendNode/zh.md @@ -8,10 +8,10 @@ Grok Video Extend 节点使用 AI 模型为现有视频创建无缝续接。您 | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `model` | 用于视频扩展的模型。 | DYNAMIC_COMBO | 是 | `"grok-imagine-video"` | -| `prompt` | 描述视频接下来应发生内容的文本。 | STRING | 是 | N/A | -| `video` | 要扩展的源视频。MP4 格式,时长 2-15 秒。 | VIDEO | 是 | N/A | -| `seed` | 用于决定节点是否应重新运行的种子;无论种子为何,实际结果都是不确定的(默认值:0)。 | INT | 是 | 0 至 2147483647 | +| `模型` | 用于视频扩展的模型。 | DYNAMIC_COMBO | 是 | `"grok-imagine-video"` | +| `提示词` | 描述视频接下来应发生内容的文本。 | STRING | 是 | N/A | +| `视频` | 要扩展的源视频。MP4 格式,时长 2-15 秒。 | VIDEO | 是 | N/A | +| `种子` | 用于决定节点是否应重新运行的种子;无论种子为何,实际结果都是不确定的(默认值:0)。 | INT | 是 | 0 至 2147483647 | ### grok-imagine-video 输入 diff --git a/comfyui_embedded_docs/docs/GrokVideoNode/en.md b/comfyui_embedded_docs/docs/GrokVideoNode/en.md index ab63707c7..33886e333 100644 --- a/comfyui_embedded_docs/docs/GrokVideoNode/en.md +++ b/comfyui_embedded_docs/docs/GrokVideoNode/en.md @@ -1,20 +1,20 @@ -# Grok Video Node +# Grok Video -The Grok Video node generates a short video from a text description. It can create a video from scratch using a prompt or animate a single input image based on a prompt. The node sends a request to an external API and returns the generated video. +The Grok Video node generates a short video from a text description. It can create a video from scratch using a prompt, or generate a video from a single input image. The node sends the request to an external API and returns the generated video. ## Inputs | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| | `model` | The model to use for video generation. | COMBO | Yes | `"grok-imagine-video"`
`"grok-imagine-video-1.5"` | -| `prompt` | Text description of the desired video. | STRING | Yes | - | -| `resolution` | The resolution of the output video. | COMBO | Yes | `"480p"`
`"720p"` | -| `aspect_ratio` | The aspect ratio of the output video (default: "auto"). | COMBO | Yes | `"auto"`
`"16:9"`
`"4:3"`
`"3:2"`
`"1:1"`
`"2:3"`
`"3:4"`
`"9:16"` | +| `prompt` | Text description of the desired video. Optional for grok-imagine-video-1.5 when an input image is provided. | STRING | Yes | - | +| `resolution` | The resolution of the output video. 1080p is only available for grok-imagine-video-1.5. | COMBO | Yes | `"480p"`
`"720p"`
`"1080p"` | +| `aspect_ratio` | The aspect ratio of the output video. | COMBO | Yes | `"auto"`
`"16:9"`
`"4:3"`
`"3:2"`
`"1:1"`
`"2:3"`
`"3:4"`
`"9:16"` | | `duration` | The duration of the output video in seconds (default: 6). | INT | Yes | 1 to 15 | | `seed` | Seed to determine if node should re-run; actual results are nondeterministic regardless of seed (default: 0). | INT | Yes | 0 to 2147483647 | -| `image` | Optional starting image for grok-imagine-video. Required for grok-imagine-video-1.5. | IMAGE | No | - | +| `image` | Optional starting image. If omitted, the video is generated from the text prompt alone. | IMAGE | No | - | -**Note:** The `grok-imagine-video-1.5` model always requires an input image. If an `image` is provided, only one image is supported. Providing multiple images will cause an error. The `prompt` must be at least 1 character long after stripping whitespace. +**Note:** When an `image` is provided, only one input image is supported; providing multiple images will cause an error. The `prompt` must be non-empty after stripping whitespace when no image is provided, or when using `grok-imagine-video` even with an image. For `grok-imagine-video-1.5`, the `prompt` is optional only when an input image is provided. The `1080p` resolution is available only for `grok-imagine-video-1.5`. When `aspect_ratio` is set to `"auto"`, the aspect ratio is chosen automatically by the service. ## Outputs @@ -25,4 +25,4 @@ The Grok Video node generates a short video from a text description. It can crea > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GrokVideoNode/en.md) --- -**Source fingerprint (SHA-256):** `1f9bdd4698f01a36b0bd9a696a7acb04330073794c11ede229949999ffce5be4` +**Source fingerprint (SHA-256):** `c7d07b7bf9a776892873698abb97c7d936c7770aab397d031a287b7ecfad0b71` diff --git a/comfyui_embedded_docs/docs/GrokVideoReferenceNode/en.md b/comfyui_embedded_docs/docs/GrokVideoReferenceNode/en.md index 36e88adba..424b656af 100644 --- a/comfyui_embedded_docs/docs/GrokVideoReferenceNode/en.md +++ b/comfyui_embedded_docs/docs/GrokVideoReferenceNode/en.md @@ -52,4 +52,4 @@ Available when `model` is set to `grok-imagine-video`. > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GrokVideoReferenceNode/en.md) --- -**Source fingerprint (SHA-256):** `ac068b34ad7efe786d29f51052a623eaf324041a99b124f6b5f81fadea661a83` +**Source fingerprint (SHA-256):** `e584c450563eaa7fcb7751d2325f9ef847fa34a4342df01f2bd9ce2e4ff8f2c3` diff --git a/comfyui_embedded_docs/docs/GrokVideoReferenceNode/es.md b/comfyui_embedded_docs/docs/GrokVideoReferenceNode/es.md index 67a67b0da..c7e8b13c7 100644 --- a/comfyui_embedded_docs/docs/GrokVideoReferenceNode/es.md +++ b/comfyui_embedded_docs/docs/GrokVideoReferenceNode/es.md @@ -8,9 +8,9 @@ El nodo Grok Reference-to-Video genera un video a partir de un prompt de texto, | Parámetro | Descripción | Tipo de datos | Requerido | Rango | |-----------|-------------|-----------|----------|-------| -| `model` | El modelo a utilizar para la generación de video. | DYNAMIC_COMBO | Sí | `"grok-imagine-video-1.5"`
`"grok-imagine-video"` | +| `modelo` | El modelo a utilizar para la generación de video. | DYNAMIC_COMBO | Sí | `"grok-imagine-video-1.5"`
`"grok-imagine-video"` | | `prompt` | Descripción de texto del video deseado. Debe ser una cadena no vacía. | STRING | Sí | N/A | -| `seed` | Semilla para determinar si el nodo debe volver a ejecutarse; los resultados reales son no deterministas independientemente de la semilla (por defecto: 0). | INT | Sí | 0 a 2147483647 | +| `semilla` | Semilla para determinar si el nodo debe volver a ejecutarse; los resultados reales son no deterministas independientemente de la semilla (por defecto: 0). | INT | Sí | 0 a 2147483647 | ### Entradas de Grok Imagine Video 1.5 diff --git a/comfyui_embedded_docs/docs/GrokVideoReferenceNode/fr.md b/comfyui_embedded_docs/docs/GrokVideoReferenceNode/fr.md index 624f7432c..cd70bc5ae 100644 --- a/comfyui_embedded_docs/docs/GrokVideoReferenceNode/fr.md +++ b/comfyui_embedded_docs/docs/GrokVideoReferenceNode/fr.md @@ -8,9 +8,9 @@ Le nœud Grok Reference-to-Video génère une vidéo à partir d’un prompt tex | Paramètre | Description | Type de données | Requis | Plage | |-----------|-------------|-----------------|--------|-------| -| `model` | Le modèle à utiliser pour la génération vidéo. | DYNAMIC_COMBO | Oui | `"grok-imagine-video-1.5"`
`"grok-imagine-video"` | -| `prompt` | Description textuelle de la vidéo souhaitée. Doit être une chaîne non vide. | STRING | Oui | N/A | -| `seed` | Seed pour déterminer si le nœud doit se relancer ; les résultats réels sont non déterministes, quelle que soit la seed (défaut : 0). | INT | Oui | 0 à 2147483647 | +| `modèle` | Le modèle à utiliser pour la génération vidéo. | DYNAMIC_COMBO | Oui | `"grok-imagine-video-1.5"`
`"grok-imagine-video"` | +| `invite` | Description textuelle de la vidéo souhaitée. Doit être une chaîne non vide. | STRING | Oui | N/A | +| `graine` | Seed pour déterminer si le nœud doit se relancer ; les résultats réels sont non déterministes, quelle que soit la seed (défaut : 0). | INT | Oui | 0 à 2147483647 | ### Grok Imagine Video 1.5 Entrées diff --git a/comfyui_embedded_docs/docs/GrokVideoReferenceNode/ja.md b/comfyui_embedded_docs/docs/GrokVideoReferenceNode/ja.md index 10f49eebe..de1e17253 100644 --- a/comfyui_embedded_docs/docs/GrokVideoReferenceNode/ja.md +++ b/comfyui_embedded_docs/docs/GrokVideoReferenceNode/ja.md @@ -12,9 +12,9 @@ Grok Reference-to-Video ノードは、テキストプロンプトから動画 | パラメータ | 説明 | データ型 | 必須 | 範囲 | |-----------|-------------|-----------|----------|-------| -| `model` | 動画生成に使用するモデル。 | DYNAMIC_COMBO | 必須 | `"grok-imagine-video-1.5"`
`"grok-imagine-video"` | -| `prompt` | 生成したい動画のテキストによる説明。空でない文字列である必要があります。 | STRING | 必須 | N/A | -| `seed` | ノードを再実行する必要があるかどうかを判断するためのシード。実際の結果はシードに関係なく非決定的です(デフォルト: 0)。 | INT | 必須 | 0 〜 2147483647 | +| `モデル` | 動画生成に使用するモデル。 | DYNAMIC_COMBO | 必須 | `"grok-imagine-video-1.5"`
`"grok-imagine-video"` | +| `プロンプト` | 生成したい動画のテキストによる説明。空でない文字列である必要があります。 | STRING | 必須 | N/A | +| `シード` | ノードを再実行する必要があるかどうかを判断するためのシード。実際の結果はシードに関係なく非決定的です(デフォルト: 0)。 | INT | 必須 | 0 〜 2147483647 | ### Grok Imagine Video 1.5 入力 diff --git a/comfyui_embedded_docs/docs/GrokVideoReferenceNode/ko.md b/comfyui_embedded_docs/docs/GrokVideoReferenceNode/ko.md index 9cb3f0f5c..a7a400ad4 100644 --- a/comfyui_embedded_docs/docs/GrokVideoReferenceNode/ko.md +++ b/comfyui_embedded_docs/docs/GrokVideoReferenceNode/ko.md @@ -8,9 +8,9 @@ Grok Reference-to-Video 노드는 텍스트 프롬프트에서 비디오를 생 | 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | |-----------|-------------|-----------|----------|-------| -| `model` | 비디오 생성에 사용할 모델입니다. | DYNAMIC_COMBO | 예 | `"grok-imagine-video-1.5"`
`"grok-imagine-video"` | -| `prompt` | 원하는 비디오에 대한 텍스트 설명입니다. 비어 있지 않은 문자열이어야 합니다. | STRING | 예 | N/A | -| `seed` | 노드가 다시 실행되어야 하는지 결정하는 시드입니다. 시드와 관계없이 실제 결과는 비결정적입니다 (기본값: 0). | INT | 예 | 0 ~ 2147483647 | +| `모델` | 비디오 생성에 사용할 모델입니다. | DYNAMIC_COMBO | 예 | `"grok-imagine-video-1.5"`
`"grok-imagine-video"` | +| `프롬프트` | 원하는 비디오에 대한 텍스트 설명입니다. 비어 있지 않은 문자열이어야 합니다. | STRING | 예 | N/A | +| `시드` | 노드가 다시 실행되어야 하는지 결정하는 시드입니다. 시드와 관계없이 실제 결과는 비결정적입니다 (기본값: 0). | INT | 예 | 0 ~ 2147483647 | ### Grok Imagine Video 1.5 입력 diff --git a/comfyui_embedded_docs/docs/GrokVideoReferenceNode/zh-TW.md b/comfyui_embedded_docs/docs/GrokVideoReferenceNode/zh-TW.md index 0fb2552df..dfb78b497 100644 --- a/comfyui_embedded_docs/docs/GrokVideoReferenceNode/zh-TW.md +++ b/comfyui_embedded_docs/docs/GrokVideoReferenceNode/zh-TW.md @@ -8,9 +8,9 @@ Grok Reference-to-Video 節點會根據文字提示生成影片,並使用最 | 參數 | 說明 | 資料型別 | 必要 | 範圍 | |-----------|-------------|-----------|----------|-------| -| `model` | 用於影片生成的模型。 | DYNAMIC_COMBO | 是 | `"grok-imagine-video-1.5"`
`"grok-imagine-video"` | -| `prompt` | 期望影片的文字描述。必須是非空字串。 | STRING | 是 | N/A | -| `seed` | 用於決定節點是否應重新執行的種子;無論種子為何,實際結果皆為非確定性(預設值:0)。 | INT | 是 | 0 至 2147483647 | +| `模型` | 用於影片生成的模型。 | DYNAMIC_COMBO | 是 | `"grok-imagine-video-1.5"`
`"grok-imagine-video"` | +| `提示詞` | 期望影片的文字描述。必須是非空字串。 | STRING | 是 | N/A | +| `種子` | 用於決定節點是否應重新執行的種子;無論種子為何,實際結果皆為非確定性(預設值:0)。 | INT | 是 | 0 至 2147483647 | ### Grok Imagine Video 1.5 輸入 diff --git a/comfyui_embedded_docs/docs/GrokVideoReferenceNode/zh.md b/comfyui_embedded_docs/docs/GrokVideoReferenceNode/zh.md index 67a5815e0..3a62c8b53 100644 --- a/comfyui_embedded_docs/docs/GrokVideoReferenceNode/zh.md +++ b/comfyui_embedded_docs/docs/GrokVideoReferenceNode/zh.md @@ -8,9 +8,9 @@ Grok Reference-to-Video 节点根据文本提示生成视频,使用最多七 | 参数 | 描述 | 数据类型 | 是否必填 | 范围 | |-----------|-------------|-----------|----------|-------| -| `model` | 用于视频生成的模型。 | DYNAMIC_COMBO | 是 | `"grok-imagine-video-1.5"`
`"grok-imagine-video"` | -| `prompt` | 所需视频的文本描述。必须是非空字符串。 | STRING | 是 | N/A | -| `seed` | 用于确定节点是否应重新运行的种子;无论种子如何,实际结果都是不确定的(默认值:0)。 | INT | 是 | 0 到 2147483647 | +| `模型` | 用于视频生成的模型。 | DYNAMIC_COMBO | 是 | `"grok-imagine-video-1.5"`
`"grok-imagine-video"` | +| `提示词` | 所需视频的文本描述。必须是非空字符串。 | STRING | 是 | N/A | +| `种子` | 用于确定节点是否应重新运行的种子;无论种子如何,实际结果都是不确定的(默认值:0)。 | INT | 是 | 0 到 2147483647 | ### Grok Imagine Video 1.5 输入 diff --git a/comfyui_embedded_docs/docs/HappyHorseImageToVideoApi/es.md b/comfyui_embedded_docs/docs/HappyHorseImageToVideoApi/es.md index b52ccb98e..2058b4235 100644 --- a/comfyui_embedded_docs/docs/HappyHorseImageToVideoApi/es.md +++ b/comfyui_embedded_docs/docs/HappyHorseImageToVideoApi/es.md @@ -8,10 +8,10 @@ Este nodo genera un video corto a partir de una única imagen inicial utilizando | Parámetro | Descripción | Tipo de datos | Requerido | Rango | |-----------|-------------|---------------|-----------|-------| -| `model` | El modelo HappyHorse que se utilizará para la generación de video. | DYNAMIC_COMBO | Sí | `"happyhorse-1.1-i2v"`
`"happyhorse-1.0-i2v"` | -| `first_frame` | Imagen del primer fotograma. La relación de aspecto de la salida se deriva de esta imagen. | IMAGE | Sí | 300×300 px mín.; 1:2.5 a 2.5:1 | -| `seed` | Semilla para usar en la generación. (por defecto: 0) | INT | Sí | 0 a 2147483647 | -| `watermark` | Si se debe agregar una marca de agua generada por IA al resultado. (opción avanzada; por defecto: False) | BOOLEAN | Sí | True / False | +| `modelo` | El modelo HappyHorse que se utilizará para la generación de video. | DYNAMIC_COMBO | Sí | `"happyhorse-1.1-i2v"`
`"happyhorse-1.0-i2v"` | +| `primer fotograma` | Imagen del primer fotograma. La relación de aspecto de la salida se deriva de esta imagen. | IMAGE | Sí | 300×300 px mín.; 1:2.5 a 2.5:1 | +| `semilla` | Semilla para usar en la generación. (por defecto: 0) | INT | Sí | 0 a 2147483647 | +| `marca de agua` | Si se debe agregar una marca de agua generada por IA al resultado. (opción avanzada; por defecto: False) | BOOLEAN | Sí | True / False | ### Entradas de happyhorse-1.1-i2v y happyhorse-1.0-i2v diff --git a/comfyui_embedded_docs/docs/HappyHorseImageToVideoApi/fr.md b/comfyui_embedded_docs/docs/HappyHorseImageToVideoApi/fr.md index c021f72e6..8fb004463 100644 --- a/comfyui_embedded_docs/docs/HappyHorseImageToVideoApi/fr.md +++ b/comfyui_embedded_docs/docs/HappyHorseImageToVideoApi/fr.md @@ -8,10 +8,10 @@ Ce nœud génère une courte vidéo à partir d’une image de départ unique en | Paramètre | Description | Type de données | Requis | Plage | |-----------|-------------|-----------|----------|-------| -| `model` | Le modèle HappyHorse à utiliser pour la génération vidéo. | DYNAMIC_COMBO | Oui | `"happyhorse-1.1-i2v"`
`"happyhorse-1.0-i2v"` | -| `first_frame` | Image du premier frame. Le rapport hauteur/largeur de la sortie est dérivé de cette image. | IMAGE | Oui | 300×300 px min ; 1:2.5 à 2.5:1 | -| `seed` | Graine à utiliser pour la génération. (défaut : 0) | INT | Oui | 0 à 2147483647 | -| `watermark` | Indique s’il faut ajouter un filigrane généré par IA au résultat. (option avancée ; défaut : False) | BOOLEAN | Oui | True / False | +| `modèle` | Le modèle HappyHorse à utiliser pour la génération vidéo. | DYNAMIC_COMBO | Oui | `"happyhorse-1.1-i2v"`
`"happyhorse-1.0-i2v"` | +| `première image` | Image du premier frame. Le rapport hauteur/largeur de la sortie est dérivé de cette image. | IMAGE | Oui | 300×300 px min ; 1:2.5 à 2.5:1 | +| `graine` | Graine à utiliser pour la génération. (défaut : 0) | INT | Oui | 0 à 2147483647 | +| `filigrane` | Indique s’il faut ajouter un filigrane généré par IA au résultat. (option avancée ; défaut : False) | BOOLEAN | Oui | True / False | ### happyhorse-1.1-i2v and happyhorse-1.0-i2v Entrées diff --git a/comfyui_embedded_docs/docs/HappyHorseImageToVideoApi/ja.md b/comfyui_embedded_docs/docs/HappyHorseImageToVideoApi/ja.md index 975510586..e4f809aee 100644 --- a/comfyui_embedded_docs/docs/HappyHorseImageToVideoApi/ja.md +++ b/comfyui_embedded_docs/docs/HappyHorseImageToVideoApi/ja.md @@ -8,10 +8,10 @@ | パラメータ | 説明 | データ型 | 必須 | 範囲 | |-----------|-------------|-----------|----------|-------| -| `model` | 動画生成に使用するHappyHorseモデル。 | DYNAMIC_COMBO | 必須 | `"happyhorse-1.1-i2v"`
`"happyhorse-1.0-i2v"` | -| `first_frame` | 最初のフレーム画像。出力のアスペクト比はこの画像から導出されます。 | IMAGE | 必須 | 300×300 px 最小; 1:2.5 から 2.5:1 | -| `seed` | 生成に使用するシード。(デフォルト: 0) | INT | 必須 | 0 から 2147483647 | -| `watermark` | 結果にAI生成の透かしを追加するかどうか。(詳細オプション、デフォルト: False) | BOOLEAN | 必須 | True / False | +| `モデル` | 動画生成に使用するHappyHorseモデル。 | DYNAMIC_COMBO | 必須 | `"happyhorse-1.1-i2v"`
`"happyhorse-1.0-i2v"` | +| `最初のフレーム` | 最初のフレーム画像。出力のアスペクト比はこの画像から導出されます。 | IMAGE | 必須 | 300×300 px 最小; 1:2.5 から 2.5:1 | +| `シード` | 生成に使用するシード。(デフォルト: 0) | INT | 必須 | 0 から 2147483647 | +| `ウォーターマーク` | 結果にAI生成の透かしを追加するかどうか。(詳細オプション、デフォルト: False) | BOOLEAN | 必須 | True / False | ### happyhorse-1.1-i2v および happyhorse-1.0-i2v 入力 diff --git a/comfyui_embedded_docs/docs/HappyHorseReferenceVideoApi/es.md b/comfyui_embedded_docs/docs/HappyHorseReferenceVideoApi/es.md index 72c0115e8..245bd4f1d 100644 --- a/comfyui_embedded_docs/docs/HappyHorseReferenceVideoApi/es.md +++ b/comfyui_embedded_docs/docs/HappyHorseReferenceVideoApi/es.md @@ -8,9 +8,9 @@ Este nodo genera un video que muestra a una persona u objeto a partir de imágen | Parámetro | Descripción | Tipo de datos | Requerido | Rango | |-----------|-------------|-----------|----------|-------| -| `model` | El modelo HappyHorse de referencia a video que se utilizará para la generación. | DYNAMIC_COMBO | Sí | `"happyhorse-1.1-r2v"`
`"happyhorse-1.0-r2v"` | -| `seed` | Semilla a utilizar para la generación (por defecto: 0). Puede configurarse para que cambie automáticamente después de cada generación. | INT | Sí | 0 a 2147483647 | -| `watermark` | Si se debe añadir una marca de agua generada por IA al resultado (por defecto: False). | BOOLEAN | Sí | True or False | +| `modelo` | El modelo HappyHorse de referencia a video que se utilizará para la generación. | DYNAMIC_COMBO | Sí | `"happyhorse-1.1-r2v"`
`"happyhorse-1.0-r2v"` | +| `semilla` | Semilla a utilizar para la generación (por defecto: 0). Puede configurarse para que cambie automáticamente después de cada generación. | INT | Sí | 0 a 2147483647 | +| `marca de agua` | Si se debe añadir una marca de agua generada por IA al resultado (por defecto: False). | BOOLEAN | Sí | True or False | ### Entradas de HappyHorse 1.1 (happyhorse-1.1-r2v) diff --git a/comfyui_embedded_docs/docs/HappyHorseReferenceVideoApi/fr.md b/comfyui_embedded_docs/docs/HappyHorseReferenceVideoApi/fr.md index 6c6b29e94..f4e5fc7e9 100644 --- a/comfyui_embedded_docs/docs/HappyHorseReferenceVideoApi/fr.md +++ b/comfyui_embedded_docs/docs/HappyHorseReferenceVideoApi/fr.md @@ -10,9 +10,9 @@ Ce nœud génère une vidéo mettant en scène une personne ou un objet à parti | Paramètre | Description | Type de données | Requis | Plage | |-----------|-------------|-----------------|--------|-------| -| `model` | Le modèle HappyHorse de référence-vers-vidéo à utiliser pour la génération. | DYNAMIC_COMBO | Oui | `"happyhorse-1.1-r2v"`
`"happyhorse-1.0-r2v"` | -| `seed` | Graine à utiliser pour la génération (par défaut : 0). Peut être définie pour changer automatiquement après chaque génération. | INT | Oui | 0 à 2147483647 | -| `watermark` | Indique s'il faut ajouter un filigrane généré par IA au résultat (par défaut : False). | BOOLEAN | Oui | True ou False | +| `modèle` | Le modèle HappyHorse de référence-vers-vidéo à utiliser pour la génération. | DYNAMIC_COMBO | Oui | `"happyhorse-1.1-r2v"`
`"happyhorse-1.0-r2v"` | +| `graine` | Graine à utiliser pour la génération (par défaut : 0). Peut être définie pour changer automatiquement après chaque génération. | INT | Oui | 0 à 2147483647 | +| `filigrane` | Indique s'il faut ajouter un filigrane généré par IA au résultat (par défaut : False). | BOOLEAN | Oui | True ou False | ### HappyHorse 1.1 Entrées (happyhorse-1.1-r2v) diff --git a/comfyui_embedded_docs/docs/HappyHorseReferenceVideoApi/ja.md b/comfyui_embedded_docs/docs/HappyHorseReferenceVideoApi/ja.md index f949ed559..249dd64ba 100644 --- a/comfyui_embedded_docs/docs/HappyHorseReferenceVideoApi/ja.md +++ b/comfyui_embedded_docs/docs/HappyHorseReferenceVideoApi/ja.md @@ -8,9 +8,9 @@ | パラメータ | 説明 | データ型 | 必須 | 範囲 | |-----------|-------------|-----------|----------|-------| -| `model` | 生成に使用する HappyHorse 参照動画モデル。 | DYNAMIC_COMBO | 必須 | `"happyhorse-1.1-r2v"`
`"happyhorse-1.0-r2v"` | -| `seed` | 生成に使用するシード値(デフォルト: 0)。生成のたびに自動的に変更するよう設定できます。 | INT | 必須 | 0 〜 2147483647 | -| `watermark` | 結果にAI生成の透かしを追加するかどうか(デフォルト: False)。 | BOOLEAN | 必須 | True or False | +| `モデル` | 生成に使用する HappyHorse 参照動画モデル。 | DYNAMIC_COMBO | 必須 | `"happyhorse-1.1-r2v"`
`"happyhorse-1.0-r2v"` | +| `シード` | 生成に使用するシード値(デフォルト: 0)。生成のたびに自動的に変更するよう設定できます。 | INT | 必須 | 0 〜 2147483647 | +| `ウォーターマーク` | 結果にAI生成の透かしを追加するかどうか(デフォルト: False)。 | BOOLEAN | 必須 | True or False | ### HappyHorse 1.1 入力 diff --git a/comfyui_embedded_docs/docs/HappyHorseTextToVideoApi/ar.md b/comfyui_embedded_docs/docs/HappyHorseTextToVideoApi/ar.md index b537cc3f0..f8f7ab25f 100644 --- a/comfyui_embedded_docs/docs/HappyHorseTextToVideoApi/ar.md +++ b/comfyui_embedded_docs/docs/HappyHorseTextToVideoApi/ar.md @@ -7,9 +7,9 @@ | المعامل | الوصف | نوع البيانات | إلزامي | النطاق | |---|---|---|---|---| -| `model` | نموذج HappyHorse المستخدم في التوليد، مع معامِلاته الفرعية. يحدد اختيار النموذج المعامِلات الفرعية المتاحة (انظر أقسام النماذج أدناه). | DYNAMIC_COMBO | نعم | "happyhorse-1.1-t2v"
"happyhorse-1.0-t2v" | -| `seed` | البذرة المستخدمة في التوليد. استخدام نفس البذرة مع نفس المدخلات ينتج نفس النتيجة. (الافتراضي: 0). | INT | نعم | 0 to 2147483647 | -| `watermark` | ما إذا كان سيتم إضافة علامة مائية مولّدة بالذكاء الاصطناعي إلى النتيجة. (الافتراضي: False). | BOOLEAN | نعم | True / False | +| `النموذج` | نموذج HappyHorse المستخدم في التوليد، مع معامِلاته الفرعية. يحدد اختيار النموذج المعامِلات الفرعية المتاحة (انظر أقسام النماذج أدناه). | DYNAMIC_COMBO | نعم | "happyhorse-1.1-t2v"
"happyhorse-1.0-t2v" | +| `البذرة` | البذرة المستخدمة في التوليد. استخدام نفس البذرة مع نفس المدخلات ينتج نفس النتيجة. (الافتراضي: 0). | INT | نعم | 0 to 2147483647 | +| `علامة مائية` | ما إذا كان سيتم إضافة علامة مائية مولّدة بالذكاء الاصطناعي إلى النتيجة. (الافتراضي: False). | BOOLEAN | نعم | True / False | ### مدخلات happyhorse-1.1-t2v diff --git a/comfyui_embedded_docs/docs/HappyHorseTextToVideoApi/es.md b/comfyui_embedded_docs/docs/HappyHorseTextToVideoApi/es.md index 33d5bc7e7..6a0139094 100644 --- a/comfyui_embedded_docs/docs/HappyHorseTextToVideoApi/es.md +++ b/comfyui_embedded_docs/docs/HappyHorseTextToVideoApi/es.md @@ -8,9 +8,9 @@ Genera un video basado en un prompt de texto utilizando el modelo HappyHorse. Es | Parámetro | Descripción | Tipo de datos | Obligatorio | Rango | |-----------|-------------|---------------|--------------|-------| -| `model` | El modelo HappyHorse utilizado para la generación, junto con sus subparámetros. Seleccionar un modelo determina qué subparámetros están disponibles (consulta las secciones de modelos a continuación). | DYNAMIC_COMBO | Sí | "happyhorse-1.1-t2v"
"happyhorse-1.0-t2v" | -| `seed` | Semilla utilizada para la generación. Usar la misma semilla con las mismas entradas producirá el mismo resultado. (predeterminado: 0). | INT | Sí | 0 a 2147483647 | -| `watermark` | Si se añade una marca de agua generada por IA al resultado. (predeterminado: False). | BOOLEAN | Sí | True / False | +| `modelo` | El modelo HappyHorse utilizado para la generación, junto con sus subparámetros. Seleccionar un modelo determina qué subparámetros están disponibles (consulta las secciones de modelos a continuación). | DYNAMIC_COMBO | Sí | "happyhorse-1.1-t2v"
"happyhorse-1.0-t2v" | +| `semilla` | Semilla utilizada para la generación. Usar la misma semilla con las mismas entradas producirá el mismo resultado. (predeterminado: 0). | INT | Sí | 0 a 2147483647 | +| `marca de agua` | Si se añade una marca de agua generada por IA al resultado. (predeterminado: False). | BOOLEAN | Sí | True / False | ### Entradas de happyhorse-1.1-t2v diff --git a/comfyui_embedded_docs/docs/HappyHorseTextToVideoApi/fr.md b/comfyui_embedded_docs/docs/HappyHorseTextToVideoApi/fr.md index 8624b39da..e8fa4711f 100644 --- a/comfyui_embedded_docs/docs/HappyHorseTextToVideoApi/fr.md +++ b/comfyui_embedded_docs/docs/HappyHorseTextToVideoApi/fr.md @@ -8,9 +8,9 @@ Génère une vidéo à partir d'une invite texte en utilisant le modèle HappyHo | Paramètre | Description | Type de données | Requis | Plage | |-----------|-------------|-----------------|--------|-------| -| `model` | Le modèle HappyHorse utilisé pour la génération, ainsi que ses sous-paramètres. La sélection d'un modèle détermine les sous-paramètres disponibles (voir les sections de modèle ci-dessous). | DYNAMIC_COMBO | Oui | "happyhorse-1.1-t2v"
"happyhorse-1.0-t2v" | -| `seed` | Graine à utiliser pour la génération. Utiliser la même graine avec les mêmes entrées produira le même résultat. (défaut : 0). | INT | Oui | 0 à 2147483647 | -| `watermark` | Indique s'il faut ajouter un filigrane généré par IA au résultat. (défaut : False). | BOOLEAN | Oui | True / False | +| `modèle` | Le modèle HappyHorse utilisé pour la génération, ainsi que ses sous-paramètres. La sélection d'un modèle détermine les sous-paramètres disponibles (voir les sections de modèle ci-dessous). | DYNAMIC_COMBO | Oui | "happyhorse-1.1-t2v"
"happyhorse-1.0-t2v" | +| `graine` | Graine à utiliser pour la génération. Utiliser la même graine avec les mêmes entrées produira le même résultat. (défaut : 0). | INT | Oui | 0 à 2147483647 | +| `filigrane` | Indique s'il faut ajouter un filigrane généré par IA au résultat. (défaut : False). | BOOLEAN | Oui | True / False | ### happyhorse-1.1-t2v Entrées diff --git a/comfyui_embedded_docs/docs/HappyHorseTextToVideoApi/ja.md b/comfyui_embedded_docs/docs/HappyHorseTextToVideoApi/ja.md index 0cb2b167c..a8b3ed9a9 100644 --- a/comfyui_embedded_docs/docs/HappyHorseTextToVideoApi/ja.md +++ b/comfyui_embedded_docs/docs/HappyHorseTextToVideoApi/ja.md @@ -8,9 +8,9 @@ HappyHorseモデルを使用して、テキストプロンプトに基づいて | パラメータ | 説明 | データ型 | 必須 | 範囲 | |-----------|-------------|-----------|----------|-------| -| `model` | 生成に使用するHappyHorseモデルと、そのサブパラメータ。モデルを選択すると、利用可能なサブパラメータが決まります(以下のモデルセクションを参照)。 | DYNAMIC_COMBO | 必須 | "happyhorse-1.1-t2v"
"happyhorse-1.0-t2v" | -| `seed` | 生成に使用するシード。同じシードと同一の入力を使うと、同じ結果が生成されます。(デフォルト: 0) | INT | 必須 | 0 〜 2147483647 | -| `watermark` | 結果にAI生成の透かしを追加するかどうか。(デフォルト: False) | BOOLEAN | 必須 | True / False | +| `モデル` | 生成に使用するHappyHorseモデルと、そのサブパラメータ。モデルを選択すると、利用可能なサブパラメータが決まります(以下のモデルセクションを参照)。 | DYNAMIC_COMBO | 必須 | "happyhorse-1.1-t2v"
"happyhorse-1.0-t2v" | +| `シード` | 生成に使用するシード。同じシードと同一の入力を使うと、同じ結果が生成されます。(デフォルト: 0) | INT | 必須 | 0 〜 2147483647 | +| `ウォーターマーク` | 結果にAI生成の透かしを追加するかどうか。(デフォルト: False) | BOOLEAN | 必須 | True / False | ### happyhorse-1.1-t2v 入力 diff --git a/comfyui_embedded_docs/docs/HappyHorseVideoEditApi/ar.md b/comfyui_embedded_docs/docs/HappyHorseVideoEditApi/ar.md index ad9a82627..76f19e57c 100644 --- a/comfyui_embedded_docs/docs/HappyHorseVideoEditApi/ar.md +++ b/comfyui_embedded_docs/docs/HappyHorseVideoEditApi/ar.md @@ -7,10 +7,10 @@ | المعامل | الوصف | نوع البيانات | إلزامي | النطاق | |---|---|---|---|---| -| `model` | نموذج تحرير الفيديو HappyHorse الذي سيتم استخدامه. يحدد هذا الاختيار خيارات التعليمات والدقة ونسبة الأبعاد والصور المرجعية المتاحة. | DYNAMIC_COMBO | نعم | "happyhorse-1.0-video-edit" | -| `video` | الفيديو المراد تحريره. | VIDEO | نعم | 3 to 60 seconds | -| `seed` | البذرة (Seed) المستخدمة للتوليد (الافتراضي: 0). | INT | نعم | 0 to 2147483647 | -| `watermark` | ما إذا كان سيتم إضافة علامة مائية مولّدة بالذكاء الاصطناعي إلى النتيجة (الافتراضي: False). | BOOLEAN | نعم | True
False | +| `النموذج` | نموذج تحرير الفيديو HappyHorse الذي سيتم استخدامه. يحدد هذا الاختيار خيارات التعليمات والدقة ونسبة الأبعاد والصور المرجعية المتاحة. | DYNAMIC_COMBO | نعم | "happyhorse-1.0-video-edit" | +| `الفيديو` | الفيديو المراد تحريره. | VIDEO | نعم | 3 to 60 seconds | +| `البذرة` | البذرة (Seed) المستخدمة للتوليد (الافتراضي: 0). | INT | نعم | 0 to 2147483647 | +| `علامة مائية` | ما إذا كان سيتم إضافة علامة مائية مولّدة بالذكاء الاصطناعي إلى النتيجة (الافتراضي: False). | BOOLEAN | نعم | True
False | ### مدخلات happyhorse-1.0-video-edit diff --git a/comfyui_embedded_docs/docs/HappyHorseVideoEditApi/en.md b/comfyui_embedded_docs/docs/HappyHorseVideoEditApi/en.md index a1abf7ced..a77b72846 100644 --- a/comfyui_embedded_docs/docs/HappyHorseVideoEditApi/en.md +++ b/comfyui_embedded_docs/docs/HappyHorseVideoEditApi/en.md @@ -11,7 +11,7 @@ Edit a video using text instructions or reference images with the HappyHorse mod | `model` | The HappyHorse video editing model to use. This selection determines which prompt, resolution, ratio, and reference image options are available. | DYNAMIC_COMBO | Yes | "happyhorse-1.0-video-edit" | | `video` | The video to edit. | VIDEO | Yes | 3 to 60 seconds | | `seed` | Seed to use for generation (default: 0). | INT | Yes | 0 to 2147483647 | -| `watermark` | Whether to add an AI-generated watermark to the result (default: False). | BOOLEAN | Yes | True
False | +| `watermark` | Whether to add an AI-generated watermark to the result (default: False). Advanced parameter. | BOOLEAN | Yes | True
False | ### happyhorse-1.0-video-edit Inputs diff --git a/comfyui_embedded_docs/docs/HappyHorseVideoEditApi/es.md b/comfyui_embedded_docs/docs/HappyHorseVideoEditApi/es.md index ded57b523..b03377c62 100644 --- a/comfyui_embedded_docs/docs/HappyHorseVideoEditApi/es.md +++ b/comfyui_embedded_docs/docs/HappyHorseVideoEditApi/es.md @@ -8,10 +8,10 @@ Edita un video usando instrucciones de texto o imágenes de referencia con el mo | Parámetro | Descripción | Tipo de datos | Requerido | Rango | |-----------|-------------|---------------|-----------|-------| -| `model` | El modelo de edición de video HappyHorse a utilizar. Esta selección determina qué opciones de prompt, resolución, proporción e imágenes de referencia están disponibles. | DYNAMIC_COMBO | Sí | "happyhorse-1.0-video-edit" | +| `modelo` | El modelo de edición de video HappyHorse a utilizar. Esta selección determina qué opciones de prompt, resolución, proporción e imágenes de referencia están disponibles. | DYNAMIC_COMBO | Sí | "happyhorse-1.0-video-edit" | | `video` | El video a editar. | VIDEO | Sí | 3 a 60 segundos | -| `seed` | Semilla a usar para la generación (predeterminado: 0). | INT | Sí | 0 a 2147483647 | -| `watermark` | Si se debe añadir una marca de agua generada por IA al resultado (predeterminado: False). | BOOLEAN | Sí | True
False | +| `semilla` | Semilla a usar para la generación (predeterminado: 0). | INT | Sí | 0 a 2147483647 | +| `marca de agua` | Si se debe añadir una marca de agua generada por IA al resultado (predeterminado: False). | BOOLEAN | Sí | True
False | ### Entradas de happyhorse-1.0-video-edit diff --git a/comfyui_embedded_docs/docs/HappyHorseVideoEditApi/fr.md b/comfyui_embedded_docs/docs/HappyHorseVideoEditApi/fr.md index c5af804c1..6756aa47c 100644 --- a/comfyui_embedded_docs/docs/HappyHorseVideoEditApi/fr.md +++ b/comfyui_embedded_docs/docs/HappyHorseVideoEditApi/fr.md @@ -6,10 +6,10 @@ | Paramètre | Description | Type de données | Requis | Plage | |-----------|-------------|-----------------|--------|-------| -| `model` | Le modèle d'édition vidéo HappyHorse à utiliser. Cette sélection détermine quelles options de prompt, résolution, format d'image et images de référence sont disponibles. | DYNAMIC_COMBO | Oui | "happyhorse-1.0-video-edit" | -| `video` | La vidéo à éditer. | VIDEO | Oui | 3 à 60 secondes | -| `seed` | Graine à utiliser pour la génération (par défaut : 0). | INT | Oui | 0 à 2147483647 | -| `watermark` | Indique s'il faut ajouter un filigrane généré par IA au résultat (par défaut : False). | BOOLEAN | Oui | True
False | +| `modèle` | Le modèle d'édition vidéo HappyHorse à utiliser. Cette sélection détermine quelles options de prompt, résolution, format d'image et images de référence sont disponibles. | DYNAMIC_COMBO | Oui | "happyhorse-1.0-video-edit" | +| `vidéo` | La vidéo à éditer. | VIDEO | Oui | 3 à 60 secondes | +| `graine` | Graine à utiliser pour la génération (par défaut : 0). | INT | Oui | 0 à 2147483647 | +| `filigrane` | Indique s'il faut ajouter un filigrane généré par IA au résultat (par défaut : False). | BOOLEAN | Oui | True
False | ### happyhorse-1.0-video-edit Entrées diff --git a/comfyui_embedded_docs/docs/HappyHorseVideoEditApi/ja.md b/comfyui_embedded_docs/docs/HappyHorseVideoEditApi/ja.md index 9e185a86c..f6a745d54 100644 --- a/comfyui_embedded_docs/docs/HappyHorseVideoEditApi/ja.md +++ b/comfyui_embedded_docs/docs/HappyHorseVideoEditApi/ja.md @@ -12,10 +12,10 @@ HappyHorse モデルを使用して、テキスト指示または参照画像に | パラメータ | 説明 | データ型 | 必須 | 範囲 | |-----------|-------------|-----------|----------|-------| -| `model` | 使用する HappyHorse 動画編集モデルです。この選択により、利用可能なプロンプト、解像度、アスペクト比、参照画像オプションが決まります。 | DYNAMIC_COMBO | 必須 | "happyhorse-1.0-video-edit" | -| `video` | 編集する動画です。 | VIDEO | 必須 | 3 〜 60 seconds | -| `seed` | 生成に使用するシードです(デフォルト: 0)。 | INT | 必須 | 0 〜 2147483647 | -| `watermark` | 結果に AI 生成の透かしを追加するかどうかを指定します(デフォルト: False)。 | BOOLEAN | 必須 | True
False | +| `モデル` | 使用する HappyHorse 動画編集モデルです。この選択により、利用可能なプロンプト、解像度、アスペクト比、参照画像オプションが決まります。 | DYNAMIC_COMBO | 必須 | "happyhorse-1.0-video-edit" | +| `動画` | 編集する動画です。 | VIDEO | 必須 | 3 〜 60 seconds | +| `シード` | 生成に使用するシードです(デフォルト: 0)。 | INT | 必須 | 0 〜 2147483647 | +| `ウォーターマーク` | 結果に AI 生成の透かしを追加するかどうかを指定します(デフォルト: False)。 | BOOLEAN | 必須 | True
False | ### happyhorse-1.0-video-edit 入力 diff --git a/comfyui_embedded_docs/docs/HeyGenAvatarVideoNode/en.md b/comfyui_embedded_docs/docs/HeyGenAvatarVideoNode/en.md index 8facbb19b..cd050aaac 100644 --- a/comfyui_embedded_docs/docs/HeyGenAvatarVideoNode/en.md +++ b/comfyui_embedded_docs/docs/HeyGenAvatarVideoNode/en.md @@ -4,32 +4,71 @@ Generate a talking-presenter video from a HeyGen avatar. This node creates a vid ## Inputs +### Common Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `engine` | Rendering engine; each choice lists only the avatars that support it. "auto" offers every avatar and picks its best engine (Avatar IV preferred). Avatar V is highest fidelity, Avatar III is the most affordable. | DYNAMIC_COMBO | Yes | `"auto"`
`"avatar_iv"`
`"avatar_iii"`
`"avatar_v"` | +| `custom_avatar_id` | Optional HeyGen avatar look ID. When set, overrides the avatar selected above. Any of HeyGen's 3000+ public looks (or your private avatars) can be used. Default: empty string. | STRING | No | | +| `speech` | Drive the avatar with a text script (HeyGen text-to-speech) or your own audio. | DYNAMIC_COMBO | Yes | `"script"`
`"audio"` | +| `resolution` | Output video resolution. Default: `"1080p"`. | COMBO | No | `"720p"`
`"1080p"` | +| `aspect_ratio` | Output aspect ratio. "auto" follows the avatar's source footage. Default: `"auto"`. | COMBO | No | `"auto"`
`"16:9"`
`"9:16"`
`"1:1"`
`"4:5"`
`"5:4"` | +| `background_color` | Optional solid background color as a hex code (e.g. `"#00ff00"`). Leave empty for the avatar's own background. If provided, the value must start with `#`. Default: empty string. | STRING | No | | +| `seed` | Not sent to HeyGen; change it to force a re-run. Default: `42`. | INT | No | Min: 0
Max: 2147483647 | + +### `auto` Inputs + +When `engine` is `"auto"`, the following sub-parameter is available: + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `avatar` | Avatar look to present the video (curated from HeyGen's public library). The best engine the look supports is chosen automatically. | COMBO | Yes | Multiple options available | + +### `avatar_iv` Inputs + +When `engine` is `"avatar_iv"`, the following sub-parameter is available: + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `avatar` | Avatar looks that support the Avatar IV engine. | COMBO | Yes | Multiple options available | + +### `avatar_iii` Inputs + +When `engine` is `"avatar_iii"`, the following sub-parameter is available: + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `avatar` | Avatar looks that support the Avatar III engine. | COMBO | Yes | Multiple options available | + +### `avatar_v` Inputs + +When `engine` is `"avatar_v"`, the following sub-parameter is available: + | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `engine` | Rendering engine; each choice lists only the avatars that support it. 'auto' offers every avatar and picks its best engine (Avatar IV preferred). Avatar V is highest fidelity, Avatar III is the most affordable. | COMBO | Yes | `"auto"`
`"avatar_iv"`
`"avatar_iii"`
`"avatar_v"` | -| `avatar` | Avatar look to present the video. With engine `"auto"`, it is curated from HeyGen's public library and the best engine the look supports is chosen automatically. With engine `"avatar_iv"`, `"avatar_iii"`, or `"avatar_v"`, only avatar looks that support that engine are listed. | COMBO | Yes | Varies based on the `engine` selection | -| `custom_avatar_id` | Optional HeyGen avatar look ID. When set, overrides the avatar selected above. Any of HeyGen's 3000+ public looks (or your private avatars) can be used. | STRING | No | | -| `speech` | Drive the avatar with a text script (HeyGen text-to-speech) or your own audio. When `"script"` is chosen, see the sub-parameters below; when `"audio"` is chosen, provide an audio file for lip-sync. | COMBO | Yes | `"script"`
`"audio"` | -| `resolution` | Output video resolution (default: `"1080p"`). | COMBO | No | `"720p"`
`"1080p"` | -| `aspect_ratio` | Output aspect ratio. `"auto"` follows the avatar's source footage (default: `"auto"`). | COMBO | No | `"auto"`
`"16:9"`
`"9:16"`
`"1:1"`
`"4:5"`
`"5:4"` | -| `background_color` | Optional solid background color as a hex code (e.g. `'#00ff00'`). Leave empty for the avatar's own background. If provided, the value must start with `#`. | STRING | No | | -| `seed` | Not sent to HeyGen; change it to force a re-run (default: `42`). | INT | No | Min: 0
Max: 2147483647 | +| `avatar` | Avatar looks that support the Avatar V engine. | COMBO | Yes | Multiple options available | -### Sub-parameters when `speech` is `"script"` +### `script` Inputs + +When `speech` is `"script"`, the following sub-parameters are available: | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `text` | Text for the avatar to speak (up to 5000 characters). The generated speech must be at least 1 second long. | STRING | Yes | | -| `voice` | Voice for the script. The default option uses the voice HeyGen assigned to the avatar. | COMBO | Yes | Multiple options available (default voice plus HeyGen's general voice library) | -| `custom_voice_id` | Optional HeyGen voice ID. When set, overrides the voice selected above. Any voice from HeyGen's library (2000+) can be used. | STRING | No | | -| `voice_speed` | Speech speed multiplier (default: `1.0`). | FLOAT | No | Min: 0.5
Max: 1.5
Step: 0.05 | +| `text` | Text for the avatar to speak (up to 5000 characters). The generated speech must be at least 1 second long. Default: empty string. | STRING | Yes | Min: 1 character
Max: 5000 characters | +| `voice` | Voice for the script. The default option uses the voice HeyGen assigned to the avatar. | COMBO | Yes | `"(avatar's default voice)"`
Multiple general voice options available | +| `custom_voice_id` | Optional HeyGen voice ID. When set, overrides the voice selected above. Any voice from HeyGen's library (2000+) can be used. Default: empty string. | STRING | No | | +| `voice_speed` | Speech speed multiplier. Default: `1.0`. | FLOAT | No | Min: 0.5
Max: 1.5
Step: 0.05 | + +### `audio` Inputs -### Sub-parameters when `speech` is `"audio"` +When `speech` is `"audio"`, the following sub-parameter is available: | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| | `audio` | Audio for the avatar to lip-sync, up to 10 minutes. | AUDIO | Yes | | +Note: `speech` is a source selector with two mutually exclusive modes. In `"script"` mode, `text` is required (1 to 5000 characters); if `custom_voice_id` is provided, it overrides `voice`. In `"audio"` mode, the avatar lip-syncs to the provided audio clip. `background_color` must be a hex color code starting with `#` when provided. When `custom_avatar_id` is set, it overrides the `avatar` selection, and the selected `engine` must be supported by that avatar look; otherwise an error is raised (unless `engine` is `"auto"`). + ## Outputs | Output Name | Description | Data Type | diff --git a/comfyui_embedded_docs/docs/HeyGenCreateAvatarNode/en.md b/comfyui_embedded_docs/docs/HeyGenCreateAvatarNode/en.md index 6a2c1eeb2..b42ff2569 100644 --- a/comfyui_embedded_docs/docs/HeyGenCreateAvatarNode/en.md +++ b/comfyui_embedded_docs/docs/HeyGenCreateAvatarNode/en.md @@ -1,27 +1,40 @@ # HeyGen Create Avatar -Create a reusable HeyGen avatar from a photo of a person or from a text prompt that describes a character to generate. The resulting avatar ID can be used with the HeyGen Avatar Video node to create videos featuring this avatar. Save the ID to reuse the avatar in future workflows. +Create a reusable HeyGen avatar from a photo of a person or from a text prompt describing a character to generate. The resulting `avatar_id` can be used with the HeyGen Avatar Video node, and should be saved to reuse the avatar in future workflows. ## Inputs +### Common Inputs + | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `source` | Generate a new character from a text prompt, or create the avatar from a connected photo of a person. | COMBO | Yes | `"prompt"`
`"photo"` | +| `source` | Generate a new character from a text prompt, or create the avatar from a connected photo of a person. | DYNAMIC_COMBO | Yes | `"prompt"`
`"photo"` | + +### Prompt Inputs -When `source` is set to `"prompt"`, the following additional parameters become available: +Available when `source` is set to `"prompt"`. | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| | `prompt` | Description of the avatar to generate (up to 1000 characters). Must contain at least 1 non-whitespace character. Default: empty string. | STRING | Yes | 1 to 1000 characters | -| `reference_images` | Up to 3 reference images guiding the generated look. Downscaled automatically if larger than 2K. | IMAGE | No | 0 to 3 images | -When `source` is set to `"photo"`, the following additional parameter becomes available: +### Photo Inputs + +Available when `source` is set to `"photo"`. | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| | `identity_photo` | Photo of the person to turn into an avatar. Downscaled automatically if larger than 2K. | IMAGE | Yes | Single image | -**Note:** The `source` parameter switches between two modes. In `"prompt"` mode, you provide a text description and optionally up to 3 reference images. In `"photo"` mode, you provide a single photo of a person. These modes are mutually exclusive. +### Reference Inputs + +Available when `source` is set to `"prompt"`. + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `reference_images` | Growable slot: connect up to 3 images (`ref_image_1`...`ref_image_3`) guiding the generated look. Images are downscaled automatically if larger than 2K. | IMAGE | No | 0 to 3 images | + +**Note:** The `source` parameter switches between two mutually exclusive modes. In `"prompt"` mode, `prompt` is required and up to 3 reference images can optionally be connected. In `"photo"` mode, `identity_photo` is required. Photos and reference images are downscaled automatically when larger than 2K; more than 3 reference images are not accepted. ## Outputs diff --git a/comfyui_embedded_docs/docs/HeyGenTalkingPhotoNode/en.md b/comfyui_embedded_docs/docs/HeyGenTalkingPhotoNode/en.md index 239f95ad3..256dc7ae3 100644 --- a/comfyui_embedded_docs/docs/HeyGenTalkingPhotoNode/en.md +++ b/comfyui_embedded_docs/docs/HeyGenTalkingPhotoNode/en.md @@ -4,21 +4,37 @@ Animate a still image of a person into a lip-synced talking video using HeyGen's ## Inputs +### Common Inputs + | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| | `image` | Image of a person to animate. Downscaled automatically if larger than 2K. | IMAGE | Yes | - | -| `speech` | Drive the avatar with a text script (HeyGen text-to-speech) or your own audio. | COMBO | Yes | `"script"`
`"audio"` | -| `text` | Text for the avatar to speak (up to 5000 characters). The generated speech must be at least 1 second long. (default: empty) | STRING | Yes (when speech is `"script"`) | - | -| `voice` | Voice for the script (HeyGen's most popular voices). | COMBO | Yes (when speech is `"script"`) | Multiple options available | -| `custom_voice_id` | Optional HeyGen voice ID. When set, overrides the voice selected above. Any voice from HeyGen's library (2000+) can be used. (default: empty) | STRING | No | - | -| `voice_speed` | Speech speed multiplier (default: 1.0). | FLOAT | No | 0.5 to 1.5 | -| `audio` | Audio for the avatar to lip-sync, up to 10 minutes. | AUDIO | Yes (when speech is `"audio"`) | - | +| `speech` | Drive the avatar with a text script (HeyGen text-to-speech) or your own audio. | DYNAMIC_COMBO | Yes | `"script"`
`"audio"` | | `resolution` | Output video resolution (default: `"1080p"`). | COMBO | No | `"720p"`
`"1080p"` | | `aspect_ratio` | Output aspect ratio. `"auto"` follows the input image (default: `"auto"`). | COMBO | No | `"auto"`
`"16:9"`
`"9:16"`
`"1:1"`
`"4:5"`
`"5:4"` | | `expressiveness` | How expressive the animated face and gestures are (default: `"low"`). | COMBO | No | `"low"`
`"medium"`
`"high"` | | `seed` | Not sent to HeyGen; change it to force a re-run (default: 42). | INT | No | 0 to 2147483647 | -Note: `speech` is a dynamic input that selects the speech source. When set to `"script"`, `text` and `voice` are required, and `custom_voice_id` and `voice_speed` are optional. When set to `"audio"`, `audio` is required instead. +### Script Inputs + +Shown when `speech` is `"script"`. + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `text` | Text for the avatar to speak (up to 5000 characters). The generated speech must be at least 1 second long. (default: empty) | STRING | Yes | 1 to 5000 characters | +| `voice` | Voice for the script (HeyGen's most popular voices). | COMBO | Yes | Multiple options available | +| `custom_voice_id` | Optional HeyGen voice ID. When set, overrides the voice selected above. Any voice from HeyGen's library (2000+) can be used. (default: empty) | STRING | No | - | +| `voice_speed` | Speech speed multiplier (default: 1.0). | FLOAT | No | 0.5 to 1.5 (step 0.05) | + +### Audio Inputs + +Shown when `speech` is `"audio"`. + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `audio` | Audio for the avatar to lip-sync, up to 10 minutes. | AUDIO | Yes | Up to 10 minutes | + +Note: When `speech` is `"script"`, `text` must be specified, and a voice is required via the `voice` selector (choosing anything other than the avatar's default voice) or a `custom_voice_id`. When `speech` is `"audio"`, `audio` is required instead. ## Outputs diff --git a/comfyui_embedded_docs/docs/HiDreamO1PatchSeamSmoothing/en.md b/comfyui_embedded_docs/docs/HiDreamO1PatchSeamSmoothing/en.md index 929cead7e..5a2669899 100644 --- a/comfyui_embedded_docs/docs/HiDreamO1PatchSeamSmoothing/en.md +++ b/comfyui_embedded_docs/docs/HiDreamO1PatchSeamSmoothing/en.md @@ -1,7 +1,5 @@ # HiDream-O1 Patch Seam Smoothing -## Overview - This node reduces visible seams in images generated by the HiDream-O1 model by averaging the model's output across multiple shifted patch-grid positions during the later part of the sampling process. It works by running the model several times with slightly different image alignments and blending the results together, which helps cancel out the grid-like artifacts that can appear at patch boundaries. ## Inputs @@ -17,7 +15,7 @@ This node reduces visible seams in images generated by the HiDream-O1 model by a | `strength` | Controls the interpolation between the original model output (0.0) and the fully smoothed result (1.0) (default: 1.0). | FLOAT | Yes | 0.0 to 1.0 (step: 0.01) | **Note on Parameter Constraints:** -- The smoothing effect will not be applied if `strength` is 0.0 or less, or if `end_percent` is less than or equal to `start_percent`. +- The smoothing effect will not be applied if `strength` is 0.0 or less, or if `end_percent` is less than or equal to `start_percent`. In those cases the node returns the model unchanged. - The `passes` parameter's ramp options (`ramp_2_4`, `ramp_2_4_8`) are only meaningful when `start_percent` and `end_percent` define a range, as the number of passes increases as sampling progresses through that range. ## Outputs @@ -29,4 +27,4 @@ This node reduces visible seams in images generated by the HiDream-O1 model by a > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HiDreamO1PatchSeamSmoothing/en.md) --- -**Source fingerprint (SHA-256):** `f4d1a617d88f880dcae3afda25699333df023d7b4ec13a22a73512713d6ef18c` +**Source fingerprint (SHA-256):** `02a2256fbf1868cc033a00f15066e9a896a7685ecdca0564ceec5b5b618b6a3c` diff --git a/comfyui_embedded_docs/docs/HiDreamO1ReferenceImages/en.md b/comfyui_embedded_docs/docs/HiDreamO1ReferenceImages/en.md index 168476be7..1991232c0 100644 --- a/comfyui_embedded_docs/docs/HiDreamO1ReferenceImages/en.md +++ b/comfyui_embedded_docs/docs/HiDreamO1ReferenceImages/en.md @@ -2,7 +2,7 @@ ## Overview -Attach reference images to both positive and negative conditioning. This node allows you to provide one or more reference images that will be used to guide the image generation process, either for editing based on an instruction or for subject-driven personalization. +Attach reference images to both positive and negative conditioning. This node lets you provide 1 to 10 reference images; a single image is used for instruction-based editing, while multiple images (2-10) enable subject-driven personalization. ## Inputs @@ -10,7 +10,7 @@ Attach reference images to both positive and negative conditioning. This node al | --- | --- | --- | --- | --- | | `positive` | The positive conditioning to attach reference images to. | CONDITIONING | Yes | - | | `negative` | The negative conditioning to attach reference images to. | CONDITIONING | Yes | - | -| `images` | Reference images. 1 image enables instruction-based editing; 2-10 images enable multi-reference subject-driven personalization. | IMAGE | Yes | 1 to 10 images | +| `images` | Reference images. 1 image = instruction edit; 2-10 images = multi reference. | IMAGE | Yes | 1 to 10 images | **Note on `images` parameter:** This is an autogrow input that accepts between 1 and 10 images. The images are labeled `image_1` through `image_10`. You must provide at least 1 image. The number of images determines the mode of operation: a single image is used for edit instructions, while multiple images (2-10) are used for subject-driven personalization. @@ -24,4 +24,4 @@ Attach reference images to both positive and negative conditioning. This node al > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HiDreamO1ReferenceImages/en.md) --- -**Source fingerprint (SHA-256):** `b14a8fc2acd44618370bd7e94758d469ff37530f2e19498a6c72ee3748559303` +**Source fingerprint (SHA-256):** `f05f6be19df8b8697a98507163e8f60fd0cf2048c81f92597d2ae0a3395b8c6d` diff --git a/comfyui_embedded_docs/docs/HitPawGeneralImageEnhance/en.md b/comfyui_embedded_docs/docs/HitPawGeneralImageEnhance/en.md index c457508ff..5e4aaefea 100644 --- a/comfyui_embedded_docs/docs/HitPawGeneralImageEnhance/en.md +++ b/comfyui_embedded_docs/docs/HitPawGeneralImageEnhance/en.md @@ -6,12 +6,12 @@ This node enhances low-resolution images by upscaling them to super-resolution, | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `model` | The enhancement model to use. The `generative_portrait` model is optimized for portraits, while `generative` is a general-purpose model. | STRING | Yes | `"generative_portrait"`
`"generative"` | +| `model` | The enhancement model to use. The `generative_portrait` model is optimized for portraits, while `generative` is a general-purpose model. | COMBO | Yes | `"generative_portrait"`
`"generative"` | | `image` | The input image to be enhanced. | IMAGE | Yes | - | -| `upscale_factor` | The factor by which to upscale the image's dimensions. A factor of 1 means no upscaling, 2 doubles the dimensions, and 4 quadruples them. | INT | Yes | `1`
`2`
`4` | -| `auto_downscale` | Automatically downscale input image if output would exceed the limit. When enabled, the node will attempt to reduce the input image size or reduce the upscale factor to fit within the 32 megapixel output limit. (default: `False`) | BOOLEAN | No | - | +| `upscale_factor` | The factor by which to upscale the image's dimensions. A factor of 1 means no upscaling, 2 doubles the dimensions, and 4 quadruples them. | COMBO | Yes | `1`
`2`
`4` | +| `auto_downscale` | Automatically downscale input image if output would exceed the limit. (default: `False`) | BOOLEAN | No | - | -**Note:** The node will raise an error if the calculated output size (input height × upscale_factor × input width × upscale_factor) exceeds 32,000,000 pixels (32MP) and `auto_downscale` is disabled. When `auto_downscale` is enabled, the node will attempt to downscale the input image to fit within the limit before applying the requested upscale factor. If downscaling by more than 2x would be required, the node will instead reduce the upscale factor. +**Note:** The node raises an error if the calculated output size (input width × upscale_factor × input height × upscale_factor) exceeds 32,000,000 pixels (32MP) and `auto_downscale` is disabled. When `auto_downscale` is enabled, the node automatically reduces the input image size or the upscale factor (or both) so the output fits within the 32MP limit. ## Outputs @@ -22,4 +22,4 @@ This node enhances low-resolution images by upscaling them to super-resolution, > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HitPawGeneralImageEnhance/en.md) --- -**Source fingerprint (SHA-256):** `effdb98c6400d3b4e3ad238be7049187af6512efacad45996f2a49a0b18b67b3` +**Source fingerprint (SHA-256):** `eb9adc1ac94c5fb943e3dd8f6617b21c5d3203f0d9ddb93ba1c9d4b4e63bd421` diff --git a/comfyui_embedded_docs/docs/HitPawVideoEnhance/ar.md b/comfyui_embedded_docs/docs/HitPawVideoEnhance/ar.md index 37922d79e..a80ef9650 100644 --- a/comfyui_embedded_docs/docs/HitPawVideoEnhance/ar.md +++ b/comfyui_embedded_docs/docs/HitPawVideoEnhance/ar.md @@ -7,7 +7,7 @@ | المعامل | الوصف | نوع البيانات | إلزامي | النطاق | | --- | --- | --- | --- | --- | | `النموذج` | نموذج الذكاء الاصطناعي المستخدم لتحسين الفيديو. يؤدي اختيار نموذج إلى إظهار معامل `resolution` متداخل. تختلف النماذج المتاحة ودقاتها المدعومة. | قائمة ديناميكية مركبة | نعم | تتوفر خيارات متعددة | -| `model.resolution` | الدقة المستهدفة للفيديو المُحسّن. قد لا تتوفر بعض الخيارات حسب `النموذج` المحدد. | قائمة اختيارية | نعم | `"original"`
`"720p"`
`"1080p"`
`"2k/qhd"`
`"4k/uhd"`
`"8k"` | +| `الدقة` | الدقة المستهدفة للفيديو المُحسّن. قد لا تتوفر بعض الخيارات حسب `النموذج` المحدد. | قائمة اختيارية | نعم | `"original"`
`"720p"`
`"1080p"`
`"2k/qhd"`
`"4k/uhd"`
`"8k"` | | `الفيديو` | ملف الفيديو المُدخل المراد تحسينه. | فيديو | نعم | غير متاح | **القيود:** diff --git a/comfyui_embedded_docs/docs/HitPawVideoEnhance/en.md b/comfyui_embedded_docs/docs/HitPawVideoEnhance/en.md index 091ced727..33053d865 100644 --- a/comfyui_embedded_docs/docs/HitPawVideoEnhance/en.md +++ b/comfyui_embedded_docs/docs/HitPawVideoEnhance/en.md @@ -4,16 +4,32 @@ The HitPaw Video Enhance node uses an external API to improve the quality of vid ## Inputs +### Common Inputs + | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `model` | The AI model to use for video enhancement. Selecting a model reveals a nested `resolution` parameter. The available models and their supported resolutions vary. | DYNAMIC COMBO | Yes | `"Portrait Restore Model (1x)"`
`"Portrait Restore Model (2x)"`
`"General Restore Model (1x)"`
`"General Restore Model (2x)"`
`"General Restore Model (4x)"`
`"Ultra HD Model (2x)"`
`"Generative Model (1x)"` | -| `model.resolution` | The target resolution for the enhanced video. The `"8K"` option is only available for models other than `"Generative Model (1x)"`. | COMBO | Yes | For `"Generative Model (1x)"`: `"original"`
`"720p"`
`"1080p"`
`"2K/QHD"`
`"4K/UHD"`

For all other models: `"original"`
`"720p"`
`"1080p"`
`"2K/QHD"`
`"4K/UHD"`
`"8K"` | +| `model` | The AI model to use for video enhancement. Selecting a model reveals a nested `resolution` parameter. The available models and their supported resolutions vary. | DYNAMIC_COMBO | Yes | `"Portrait Restore Model (1x)"`
`"Portrait Restore Model (2x)"`
`"General Restore Model (1x)"`
`"General Restore Model (2x)"`
`"General Restore Model (4x)"`
`"Ultra HD Model (2x)"`
`"Generative Model (1x)"` | | `video` | The input video file to be enhanced. | VIDEO | Yes | N/A | -**Constraints:** +### Portrait Restore, General Restore, and Ultra HD Model Inputs + +These resolution options are shared by Portrait Restore Model (1x), Portrait Restore Model (2x), General Restore Model (1x), General Restore Model (2x), General Restore Model (4x), and Ultra HD Model (2x). + +| Parameter | Description | Data Type | Required | Range | +| --- | --- | --- | --- | --- | +| `model.resolution` | The target resolution for the enhanced video. Selecting `"original"` keeps the input video's resolution. | COMBO | Yes | `"original"`
`"720p"`
`"1080p"`
`"2K/QHD"`
`"4K/UHD"`
`"8K"` | + +### Generative Model (1x) Inputs + +| Parameter | Description | Data Type | Required | Range | +| --- | --- | --- | --- | --- | +| `model.resolution` | The target resolution for the enhanced video. Selecting `"original"` keeps the input video's resolution. The `"8K"` option is not available for this model. | COMBO | Yes | `"original"`
`"720p"`
`"1080p"`
`"2K/QHD"`
`"4K/UHD"` | + +**Notes:** * The input `video` must be between 0.5 seconds and 60 minutes (3600 seconds) in duration. -* The selected `resolution` must be larger than the input video's dimensions. If the video is square, the selected resolution must be larger than its width/height. For non-square videos, the selected resolution must be larger than the video's shorter dimension. If the target resolution is smaller, an error will be raised. Choose `"original"` to keep the input video's resolution. +* The selected `resolution` must be at least as large as the input video's dimensions. For square videos, it must be at least as large as the video's width and height. For non-square videos, it must be at least as large as the video's shorter dimension. If the target resolution is smaller, an error is raised. Selecting `"original"` keeps the input video's resolution. +* When a resolution other than `"original"` is selected, non-square videos are scaled so that their shorter dimension matches the selected resolution while preserving the aspect ratio. Square videos are scaled so that both dimensions match the square target size of the selected resolution (for example, `"4K/UHD"` produces 2048×2048). ## Outputs @@ -24,4 +40,4 @@ The HitPaw Video Enhance node uses an external API to improve the quality of vid > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HitPawVideoEnhance/en.md) --- -**Source fingerprint (SHA-256):** `3326833e8e542e0642e34a6cc444115376fd03c26e3c8f27592fe8e3a72d593b` +**Source fingerprint (SHA-256):** `42803c7137d62dbce5021cd2bd9b9fba1a89c80e7b3f237f8a0eb03858c49967` diff --git a/comfyui_embedded_docs/docs/HitPawVideoEnhance/es.md b/comfyui_embedded_docs/docs/HitPawVideoEnhance/es.md index d28f42772..498dbd0d9 100644 --- a/comfyui_embedded_docs/docs/HitPawVideoEnhance/es.md +++ b/comfyui_embedded_docs/docs/HitPawVideoEnhance/es.md @@ -7,7 +7,7 @@ El nodo HitPaw Video Enhance utiliza una API externa para mejorar la calidad de | Parámetro | Descripción | Tipo de Dato | Obligatorio | Rango | | --- | --- | --- | --- | --- | | `modelo` | El modelo de IA a utilizar para la mejora del video. Al seleccionar un modelo, se muestra un parámetro `resolution` anidado. Los modelos disponibles y sus resoluciones compatibles varían. | DYNAMIC COMBO | Sí | Múltiples opciones disponibles | -| `model.resolution` | La resolución objetivo para el video mejorado. Algunas opciones pueden no estar disponibles según el `modelo` seleccionado. | COMBO | Sí | `"original"`
`"720p"`
`"1080p"`
`"2k/qhd"`
`"4k/uhd"`
`"8k"` | +| `resolución` | La resolución objetivo para el video mejorado. Algunas opciones pueden no estar disponibles según el `modelo` seleccionado. | COMBO | Sí | `"original"`
`"720p"`
`"1080p"`
`"2k/qhd"`
`"4k/uhd"`
`"8k"` | | `video` | El archivo de video de entrada que se va a mejorar. | VIDEO | Sí | N/A | **Restricciones:** diff --git a/comfyui_embedded_docs/docs/HitPawVideoEnhance/fa.md b/comfyui_embedded_docs/docs/HitPawVideoEnhance/fa.md index b116b3071..1b0578c51 100644 --- a/comfyui_embedded_docs/docs/HitPawVideoEnhance/fa.md +++ b/comfyui_embedded_docs/docs/HitPawVideoEnhance/fa.md @@ -9,7 +9,7 @@ | پارامتر | توضیحات | نوع داده | الزامی | محدوده | | --- | --- | --- | --- | --- | | `مدل` | مدل هوش مصنوعی مورد استفاده برای بهبود ویدیو. انتخاب یک مدل، پارامتر تودرتوی `resolution` را نمایش می‌دهد. مدل‌های موجود و وضوح‌های پشتیبانی‌شده توسط آن‌ها متفاوت است. | DYNAMIC COMBO | بله | چندین گزینه موجود | -| `model.resolution` | وضوح هدف برای ویدیوی بهبودیافته. برخی گزینه‌ها بسته به `مدل` انتخاب‌شده ممکن است در دسترس نباشند. | COMBO | بله | `"original"`
`"720p"`
`"1080p"`
`"2k/qhd"`
`"4k/uhd"`
`"8k"` | +| `وضوح` | وضوح هدف برای ویدیوی بهبودیافته. برخی گزینه‌ها بسته به `مدل` انتخاب‌شده ممکن است در دسترس نباشند. | COMBO | بله | `"original"`
`"720p"`
`"1080p"`
`"2k/qhd"`
`"4k/uhd"`
`"8k"` | | `ویدیو` | فایل ویدیوی ورودی که باید بهبود یابد. | VIDEO | بله | نامعتبر | **محدودیت‌ها:** diff --git a/comfyui_embedded_docs/docs/HitPawVideoEnhance/fr.md b/comfyui_embedded_docs/docs/HitPawVideoEnhance/fr.md index fa912f7b8..c10ac1fe6 100644 --- a/comfyui_embedded_docs/docs/HitPawVideoEnhance/fr.md +++ b/comfyui_embedded_docs/docs/HitPawVideoEnhance/fr.md @@ -9,7 +9,7 @@ Le nœud HitPaw Video Enhance utilise une API externe pour améliorer la qualit | Paramètre | Description | Type de données | Requis | Plage | | --- | --- | --- | --- | --- | | `modèle` | Le modèle d'IA à utiliser pour l'amélioration vidéo. La sélection d'un modèle révèle un paramètre `resolution` imbriqué. Les modèles disponibles et leurs résolutions prises en charge varient. | DYNAMIC COMBO | Oui | Plusieurs options disponibles | -| `model.resolution` | La résolution cible pour la vidéo améliorée. Certaines options peuvent être indisponibles selon le `modèle` sélectionné. | COMBO | Oui | `"original"`
`"720p"`
`"1080p"`
`"2k/qhd"`
`"4k/uhd"`
`"8k"` | +| `résolution` | La résolution cible pour la vidéo améliorée. Certaines options peuvent être indisponibles selon le `modèle` sélectionné. | COMBO | Oui | `"original"`
`"720p"`
`"1080p"`
`"2k/qhd"`
`"4k/uhd"`
`"8k"` | | `vidéo` | Le fichier vidéo d'entrée à améliorer. | VIDEO | Oui | N/A | **Contraintes :** diff --git a/comfyui_embedded_docs/docs/HitPawVideoEnhance/ja.md b/comfyui_embedded_docs/docs/HitPawVideoEnhance/ja.md index ae34ae8db..76f40b28b 100644 --- a/comfyui_embedded_docs/docs/HitPawVideoEnhance/ja.md +++ b/comfyui_embedded_docs/docs/HitPawVideoEnhance/ja.md @@ -11,7 +11,7 @@ HitPaw Video Enhance ノードは、外部APIを使用して動画の品質を | パラメータ | 説明 | データ型 | 必須 | 範囲 | | --- | --- | --- | --- | --- | | `モデル` | 動画の画質向上に使用するAIモデルです。モデルを選択すると、ネストされた `resolution` パラメータが表示されます。利用可能なモデルとその対応解像度は異なります。 | DYNAMIC COMBO | はい | 複数のオプションから選択可能 | -| `model.resolution` | 画質向上後の動画の目標解像度です。選択した `モデル` によっては、一部のオプションが利用できない場合があります。 | COMBO | はい | `"original"`
`"720p"`
`"1080p"`
`"2k/qhd"`
`"4k/uhd"`
`"8k"` | +| `解像度` | 画質向上後の動画の目標解像度です。選択した `モデル` によっては、一部のオプションが利用できない場合があります。 | COMBO | はい | `"original"`
`"720p"`
`"1080p"`
`"2k/qhd"`
`"4k/uhd"`
`"8k"` | | `動画` | 画質を向上させる入力動画ファイルです。 | VIDEO | はい | なし | **制約事項:** diff --git a/comfyui_embedded_docs/docs/HitPawVideoEnhance/ko.md b/comfyui_embedded_docs/docs/HitPawVideoEnhance/ko.md index c44e79b8f..e06a0c8ff 100644 --- a/comfyui_embedded_docs/docs/HitPawVideoEnhance/ko.md +++ b/comfyui_embedded_docs/docs/HitPawVideoEnhance/ko.md @@ -7,7 +7,7 @@ HitPaw Video Enhance 노드는 외부 API를 사용하여 비디오 품질을 | 매개변수 | 설명 | 데이터 타입 | 필수 여부 | 범위 | | --- | --- | --- | --- | --- | | `모델` | 비디오 향상에 사용할 AI 모델입니다. 모델을 선택하면 중첩된 `resolution` 매개변수가 표시됩니다. 사용 가능한 모델과 지원되는 해상도는 다양합니다. | DYNAMIC COMBO | 예 | 여러 옵션 사용 가능 | -| `model.resolution` | 향상된 비디오의 대상 해상도입니다. 선택한 `모델`에 따라 일부 옵션을 사용하지 못할 수 있습니다. | COMBO | 예 | `"original"`
`"720p"`
`"1080p"`
`"2k/qhd"`
`"4k/uhd"`
`"8k"` | +| `해상도` | 향상된 비디오의 대상 해상도입니다. 선택한 `모델`에 따라 일부 옵션을 사용하지 못할 수 있습니다. | COMBO | 예 | `"original"`
`"720p"`
`"1080p"`
`"2k/qhd"`
`"4k/uhd"`
`"8k"` | | `비디오` | 향상시킬 입력 비디오 파일입니다. | VIDEO | 예 | 해당 없음 | **제약 사항:** diff --git a/comfyui_embedded_docs/docs/HitPawVideoEnhance/pt-BR.md b/comfyui_embedded_docs/docs/HitPawVideoEnhance/pt-BR.md index f6cd91879..0a5db1221 100644 --- a/comfyui_embedded_docs/docs/HitPawVideoEnhance/pt-BR.md +++ b/comfyui_embedded_docs/docs/HitPawVideoEnhance/pt-BR.md @@ -9,7 +9,7 @@ O nó HitPaw Video Enhance utiliza uma API externa para melhorar a qualidade de | Parâmetro | Descrição | Tipo de Dado | Obrigatório | Faixa | | --- | --- | --- | --- | --- | | `modelo` | O modelo de IA a ser usado para aprimoramento de vídeo. Selecionar um modelo revela um parâmetro `resolution` aninhado. Os modelos disponíveis e suas resoluções suportadas variam. | DYNAMIC COMBO | Sim | Múltiplas opções disponíveis | -| `model.resolution` | A resolução alvo para o vídeo aprimorado. Algumas opções podem não estar disponíveis dependendo do `modelo` selecionado. | COMBO | Sim | `"original"`
`"720p"`
`"1080p"`
`"2k/qhd"`
`"4k/uhd"`
`"8k"` | +| `resolução` | A resolução alvo para o vídeo aprimorado. Algumas opções podem não estar disponíveis dependendo do `modelo` selecionado. | COMBO | Sim | `"original"`
`"720p"`
`"1080p"`
`"2k/qhd"`
`"4k/uhd"`
`"8k"` | | `vídeo` | O arquivo de vídeo de entrada a ser aprimorado. | VIDEO | Sim | N/A | **Restrições:** diff --git a/comfyui_embedded_docs/docs/HitPawVideoEnhance/zh-TW.md b/comfyui_embedded_docs/docs/HitPawVideoEnhance/zh-TW.md index 9db97f0c4..23f686479 100644 --- a/comfyui_embedded_docs/docs/HitPawVideoEnhance/zh-TW.md +++ b/comfyui_embedded_docs/docs/HitPawVideoEnhance/zh-TW.md @@ -7,7 +7,7 @@ | 參數 | 說明 | 資料類型 | 必要 | 範圍 | | --- | --- | --- | --- | --- | | `模型` | 用於影片增強的 AI 模型。選擇模型後會顯示巢狀的 `resolution` 參數。可用的模型及其支援的解析度會有所不同。 | DYNAMIC COMBO | 是 | 提供多種選項 | -| `model.resolution` | 增強後影片的目標解析度。部分選項可能因所選的 `模型` 而無法使用。 | COMBO | 是 | `"original"`
`"720p"`
`"1080p"
`"2k/qhd"`
`"4k/uhd"`
`"8k"` | +| `解析度` | 增強後影片的目標解析度。部分選項可能因所選的 `模型` 而無法使用。 | COMBO | 是 | `"original"`
`"720p"`
`"1080p"
`"2k/qhd"`
`"4k/uhd"`
`"8k"` | | `影片` | 要增強的輸入影片檔案。 | VIDEO | 是 | 不適用 | **限制條件:** diff --git a/comfyui_embedded_docs/docs/HitPawVideoEnhance/zh.md b/comfyui_embedded_docs/docs/HitPawVideoEnhance/zh.md index ac84bf5ae..f697be805 100644 --- a/comfyui_embedded_docs/docs/HitPawVideoEnhance/zh.md +++ b/comfyui_embedded_docs/docs/HitPawVideoEnhance/zh.md @@ -7,7 +7,7 @@ HitPaw视频增强节点使用外部API来提升视频质量。它可将低分 | 参数 | 描述 | 数据类型 | 是否必填 | 取值范围 | | --- | --- | --- | --- | --- | | `模型` | 用于视频增强的AI模型。选择模型后会显示嵌套的`resolution`参数。可用模型及其支持的分辨率各不相同。 | DYNAMIC COMBO | 是 | 提供多个选项 | -| `model.resolution` | 增强视频的目标分辨率。部分选项可能因所选`模型`而不可用。 | COMBO | 是 | `"original"`
`"720p"`
`"1080p"`
`"2k/qhd"`
`"4k/uhd"`
`"8k"` | +| `分辨率` | 增强视频的目标分辨率。部分选项可能因所选`模型`而不可用。 | COMBO | 是 | `"original"`
`"720p"`
`"1080p"`
`"2k/qhd"`
`"4k/uhd"`
`"8k"` | | `视频` | 待增强的输入视频文件。 | VIDEO | 是 | 不适用 | **限制条件:** diff --git a/comfyui_embedded_docs/docs/Hunyuan3Dv2Conditioning/en.md b/comfyui_embedded_docs/docs/Hunyuan3Dv2Conditioning/en.md index 91881a364..1b63b0f22 100644 --- a/comfyui_embedded_docs/docs/Hunyuan3Dv2Conditioning/en.md +++ b/comfyui_embedded_docs/docs/Hunyuan3Dv2Conditioning/en.md @@ -5,17 +5,17 @@ The Hunyuan3Dv2Conditioning node processes CLIP vision output to generate condit ## Inputs | Parameter | Description | Data Type | Required | Range | -| --- | --- | --- | --- | --- | +|-----------|-------------|-----------|----------|-------| | `clip_vision_output` | The output from a CLIP vision model containing visual embeddings | CLIP_VISION_OUTPUT | Yes | - | ## Outputs | Output Name | Description | Data Type | -| --- | --- | --- | +|-------------|-------------|-----------| | `positive` | Positive conditioning data containing the CLIP vision embeddings | CONDITIONING | | `negative` | Negative conditioning data containing zero-valued embeddings matching the positive embeddings shape | CONDITIONING | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Hunyuan3Dv2Conditioning/en.md) --- -**Source fingerprint (SHA-256):** `93ee88ca001f59a344c7e3113da0200c75d7a566de9084103f69efe3270231e8` +**Source fingerprint (SHA-256):** `114d23574a93bd31013fc909568023c143bba2e4ea75b35a0ebb808c19e83867` diff --git a/comfyui_embedded_docs/docs/Hunyuan3Dv2ConditioningMultiView/en.md b/comfyui_embedded_docs/docs/Hunyuan3Dv2ConditioningMultiView/en.md index b8f192d29..cc0479a94 100644 --- a/comfyui_embedded_docs/docs/Hunyuan3Dv2ConditioningMultiView/en.md +++ b/comfyui_embedded_docs/docs/Hunyuan3Dv2ConditioningMultiView/en.md @@ -1,26 +1,26 @@ # Hunyuan3Dv2ConditioningMultiView -The Hunyuan3Dv2ConditioningMultiView node processes multi-view CLIP vision embeddings for 3D video generation. It takes optional front, left, back, and right view embeddings and combines them with positional encoding to create conditioning data for video models. The node outputs both positive conditioning from the combined embeddings and negative conditioning with zero values. +The Hunyuan3Dv2ConditioningMultiView node combines CLIP vision outputs from up to four views (front, left, back, and right) into a single multi-view conditioning. Each provided view has a positional encoding added to its CLIP vision embedding, and the resulting embeddings are concatenated. The node outputs a positive conditioning based on the combined embeddings and a negative conditioning filled with zeros of the same shape. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `front` | CLIP vision output for the front view | CLIP_VISION_OUTPUT | No | - | -| `left` | CLIP vision output for the left view | CLIP_VISION_OUTPUT | No | - | -| `back` | CLIP vision output for the back view | CLIP_VISION_OUTPUT | No | - | -| `right` | CLIP vision output for the right view | CLIP_VISION_OUTPUT | No | - | +| `front` | CLIP vision output for the front view. Optional view input. | CLIP_VISION_OUTPUT | No | - | +| `left` | CLIP vision output for the left view. Optional view input. | CLIP_VISION_OUTPUT | No | - | +| `back` | CLIP vision output for the back view. Optional view input. | CLIP_VISION_OUTPUT | No | - | +| `right` | CLIP vision output for the right view. Optional view input. | CLIP_VISION_OUTPUT | No | - | -**Note:** At least one view input must be provided for the node to function. The node will only process views that contain valid CLIP vision output data. +**Note:** At least one view input must be provided for the node to function. The node only processes views that contain valid CLIP vision output data and skips views that are not connected. ## Outputs | Output Name | Description | Data Type | | --- | --- | --- | -| `positive` | Positive conditioning containing the combined multi-view embeddings with positional encoding | CONDITIONING | -| `negative` | Negative conditioning with zero values for contrastive learning | CONDITIONING | +| `positive` | Positive conditioning containing the combined multi-view embeddings with positional encoding. | CONDITIONING | +| `negative` | Negative conditioning with zero values matching the positive conditioning shape. | CONDITIONING | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Hunyuan3Dv2ConditioningMultiView/en.md) --- -**Source fingerprint (SHA-256):** `b1e745e1b626508c974d3a90029f70b224bfefbe0988e98462fc9cb68d46a8f2` +**Source fingerprint (SHA-256):** `1492b51661d0bb8f2c142c1b1e8ef104beed1b9dae532a970e2928e27ad71d69` diff --git a/comfyui_embedded_docs/docs/HunyuanImageToVideo/en.md b/comfyui_embedded_docs/docs/HunyuanImageToVideo/en.md index 3acb137d1..f4ee5b7ea 100644 --- a/comfyui_embedded_docs/docs/HunyuanImageToVideo/en.md +++ b/comfyui_embedded_docs/docs/HunyuanImageToVideo/en.md @@ -12,8 +12,8 @@ The HunyuanImageToVideo node converts images into video latent representations u | `height` | Height of the output video in pixels (default: 480, step: 16) | INT | Yes | 16 to MAX_RESOLUTION | | `length` | Number of frames in the output video (default: 53, step: 4) | INT | Yes | 1 to MAX_RESOLUTION | | `batch_size` | Number of videos to generate simultaneously (default: 1) | INT | Yes | 1 to 4096 | -| `guidance_type` | Method for incorporating the starting image into video generation (default: "v1 (concat)") | COMBO | Yes | "v1 (concat)"
"v2 (replace)"
"custom" | -| `start_image` | Optional starting image to initialize the video generation | IMAGE | No | - | +| `guidance_type` | Method for incorporating the starting image into video generation (default: "v1 (concat)"). Advanced option | COMBO | Yes | "v1 (concat)"
"v2 (replace)"
"custom" | +| `start_image` | Optional starting image (or image sequence) to initialize the video generation. Only the first `length` frames and the first 3 color channels are used | IMAGE | No | - | **Note:** When `start_image` is provided, the node uses different guidance methods based on the selected `guidance_type`: @@ -31,4 +31,4 @@ The HunyuanImageToVideo node converts images into video latent representations u > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HunyuanImageToVideo/en.md) --- -**Source fingerprint (SHA-256):** `171e60e0ff5bbe2715b83693212e91dd9a3e2236e7b4437c7e33929d6143ae4f` +**Source fingerprint (SHA-256):** `0ed00d59513492f31760a18ce3b0edf10b64cad848ba52c4e47d5f61fae9accc` diff --git a/comfyui_embedded_docs/docs/HunyuanRefinerLatent/en.md b/comfyui_embedded_docs/docs/HunyuanRefinerLatent/en.md index 412c56367..1af6fdeb7 100644 --- a/comfyui_embedded_docs/docs/HunyuanRefinerLatent/en.md +++ b/comfyui_embedded_docs/docs/HunyuanRefinerLatent/en.md @@ -1,6 +1,6 @@ # Hunyuan Latent Refiner -The HunyuanRefinerLatent node processes conditioning and latent inputs for refinement operations. It applies noise augmentation to both positive and negative conditioning while incorporating latent image data, and generates a new latent output with specific dimensions for further processing. +The HunyuanRefinerLatent node prepares conditioning and latent data for the Hunyuan video refinement process. It attaches the input latent image data to both the positive and negative conditioning, applies a noise augmentation value to them, and creates a new zero-filled latent with 32 channels for further processing. ## Inputs @@ -8,18 +8,18 @@ The HunyuanRefinerLatent node processes conditioning and latent inputs for refin | --- | --- | --- | --- | --- | | `positive` | The positive conditioning input to be processed | CONDITIONING | Yes | - | | `negative` | The negative conditioning input to be processed | CONDITIONING | Yes | - | -| `latent` | The latent representation input | LATENT | Yes | - | -| `noise_augmentation` | The amount of noise augmentation to apply (default: 0.10) | FLOAT | Yes | 0.0 - 1.0 | +| `latent` | The latent representation input, used as the latent image data for the conditioning and to define the dimensions of the output latent | LATENT | Yes | - | +| `noise_augmentation` | The amount of noise augmentation to apply (default: 0.10). This parameter is shown in the advanced section of the node. | FLOAT | Yes | 0.0 - 1.0 | ## Outputs | Output Name | Description | Data Type | | --- | --- | --- | -| `positive` | The processed positive conditioning with applied noise augmentation and latent image concatenation | CONDITIONING | -| `negative` | The processed negative conditioning with applied noise augmentation and latent image concatenation | CONDITIONING | -| `latent` | A new latent output with dimensions [batch_size, 32, height, width, channels] | LATENT | +| `positive` | The processed positive conditioning with the latent image data attached and the noise augmentation applied | CONDITIONING | +| `negative` | The processed negative conditioning with the latent image data attached and the noise augmentation applied | CONDITIONING | +| `latent` | A new latent filled with zeros, with the same batch size and the same last three dimensions as the input latent, and 32 channels | LATENT | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HunyuanRefinerLatent/en.md) --- -**Source fingerprint (SHA-256):** `da9ba6729a4ff9147e3783841200ae5b6a9a20ab396e82d7ac6300faec3dc8f9` +**Source fingerprint (SHA-256):** `4c5669cf2ad5ba00e176876741b7d8d3f092cc58d2163871a10fd769ee4ff84c` diff --git a/comfyui_embedded_docs/docs/HunyuanVideo15ImageToVideo/en.md b/comfyui_embedded_docs/docs/HunyuanVideo15ImageToVideo/en.md index b44644eda..76787968f 100644 --- a/comfyui_embedded_docs/docs/HunyuanVideo15ImageToVideo/en.md +++ b/comfyui_embedded_docs/docs/HunyuanVideo15ImageToVideo/en.md @@ -9,14 +9,14 @@ The HunyuanVideo15ImageToVideo node prepares conditioning and latent space data | `positive` | The positive conditioning prompts that describe what the video should contain. | CONDITIONING | Yes | - | | `negative` | The negative conditioning prompts that describe what the video should avoid. | CONDITIONING | Yes | - | | `vae` | The VAE (Variational Autoencoder) model used to encode the starting image into the latent space. | VAE | Yes | - | -| `width` | The width of the output video frames in pixels. Must be divisible by 16. (default: 848) | INT | No | 16 to MAX_RESOLUTION, step: 16 | -| `height` | The height of the output video frames in pixels. Must be divisible by 16. (default: 480) | INT | No | 16 to MAX_RESOLUTION, step: 16 | -| `length` | The total number of frames in the video sequence. Must be a multiple of 4. (default: 33) | INT | No | 1 to MAX_RESOLUTION, step: 4 | -| `batch_size` | The number of video sequences to generate in a single batch. (default: 1) | INT | No | 1 to 4096 | +| `width` | The width of the output video frames in pixels. Must be divisible by 16. (default: 848) | INT | Yes | 16 to MAX_RESOLUTION, step: 16 | +| `height` | The height of the output video frames in pixels. Must be divisible by 16. (default: 480) | INT | Yes | 16 to MAX_RESOLUTION, step: 16 | +| `length` | The total number of frames in the video sequence. Values increase in steps of 4 starting from 1 (1, 5, 9, 13, ...). (default: 33) | INT | Yes | 1 to MAX_RESOLUTION, step: 4 | +| `batch_size` | The number of video sequences to generate in a single batch. (default: 1) | INT | Yes | 1 to 4096 | | `start_image` | An optional starting image to initialize the video generation. If provided, it is encoded and used to condition the first frames. Only the first `length` frames of the image are used. | IMAGE | No | - | | `clip_vision_output` | Optional CLIP vision embeddings to provide additional visual conditioning for the generation. | CLIP_VISION_OUTPUT | No | - | -**Note:** When a `start_image` is provided, it is automatically resized to match the specified `width` and `height` using bilinear interpolation. The first `length` frames of the image batch are used. The encoded image is then added to both the `positive` and `negative` conditioning as a `concat_latent_image` with a corresponding `concat_mask`. The mask is set to 0.0 for the frames covered by the starting image and 1.0 for the remaining frames. +**Note:** When a `start_image` is provided, it is automatically resized to match the specified `width` and `height` using bilinear interpolation. The first `length` frames of the image batch are used, and only the first 3 color channels of each frame are encoded. The encoded image is then added to both the `positive` and `negative` conditioning as a `concat_latent_image` with a corresponding `concat_mask`. The mask is set to 0.0 for the frames covered by the starting image and 1.0 for the remaining frames. When a `clip_vision_output` is provided, it is also added to both the `positive` and `negative` conditioning. ## Outputs @@ -29,4 +29,4 @@ The HunyuanVideo15ImageToVideo node prepares conditioning and latent space data > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HunyuanVideo15ImageToVideo/en.md) --- -**Source fingerprint (SHA-256):** `383b965a2e67c3643a13991ea5969c4d31ce17e48a57a400f89974f64e4b1e04` +**Source fingerprint (SHA-256):** `dbedf7f378ae9613c8f47fe9876a4576c815055b4cdb6bf687b7575fcd7ea80a` diff --git a/comfyui_embedded_docs/docs/HunyuanVideo15LatentUpscaleWithModel/en.md b/comfyui_embedded_docs/docs/HunyuanVideo15LatentUpscaleWithModel/en.md index de54a50a0..848dbf992 100644 --- a/comfyui_embedded_docs/docs/HunyuanVideo15LatentUpscaleWithModel/en.md +++ b/comfyui_embedded_docs/docs/HunyuanVideo15LatentUpscaleWithModel/en.md @@ -9,8 +9,8 @@ The Hunyuan Video 15 Latent Upscale With Model node increases the resolution of | `model` | The Hunyuan Video 1.5 latent upscale model used to refine the upscaled samples. | LATENT_UPSCALE_MODEL | Yes | N/A | | `samples` | The latent image representation to be upscaled. | LATENT | Yes | N/A | | `upscale_method` | The interpolation algorithm used for the initial upscaling step (default: `"bilinear"`). | COMBO | No | `"nearest-exact"`
`"bilinear"`
`"area"`
`"bicubic"`
`"bislerp"` | -| `width` | The target width for the upscaled latent, in pixels. A value of 0 will calculate the width automatically based on the target height and the original aspect ratio. The final output width will be a multiple of 16 (default: 1280). | INT | No | 0 to 16384 | -| `height` | The target height for the upscaled latent, in pixels. A value of 0 will calculate the height automatically based on the target width and the original aspect ratio. The final output height will be a multiple of 16 (default: 720). | INT | No | 0 to 16384 | +| `width` | The target width for the upscaled latent, in pixels. A value of 0 will calculate the width automatically based on the target height and the original aspect ratio. The final output width will be a multiple of 16 (default: 1280). | INT | No | 0 to 16384 (step: 8) | +| `height` | The target height for the upscaled latent, in pixels. A value of 0 will calculate the height automatically based on the target width and the original aspect ratio. The final output height will be a multiple of 16 (default: 720). | INT | No | 0 to 16384 (step: 8) | | `crop` | Determines how the upscaled latent is cropped to fit the target dimensions. | COMBO | No | `"disabled"`
`"center"` | **Note on Dimensions:** If both `width` and `height` are set to 0, the node returns the input `samples` unchanged. If only one dimension is set to 0, the other dimension is calculated to preserve the original aspect ratio. The final dimensions are always adjusted to be at least 64 pixels and are divisible by 16. @@ -24,4 +24,4 @@ The Hunyuan Video 15 Latent Upscale With Model node increases the resolution of > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HunyuanVideo15LatentUpscaleWithModel/en.md) --- -**Source fingerprint (SHA-256):** `2d249b1bf8eca3a27952cedfc4001b19efeeaeddb6ce461bdfc9b8bb3f2ada82` +**Source fingerprint (SHA-256):** `71af49eefb010aadd30f8699b751ad901b1ee385d6cbeedd3a83995a1a623516` diff --git a/comfyui_embedded_docs/docs/HunyuanVideo15SuperResolution/en.md b/comfyui_embedded_docs/docs/HunyuanVideo15SuperResolution/en.md index d0ccadbd0..063095346 100644 --- a/comfyui_embedded_docs/docs/HunyuanVideo15SuperResolution/en.md +++ b/comfyui_embedded_docs/docs/HunyuanVideo15SuperResolution/en.md @@ -9,12 +9,12 @@ The HunyuanVideo15SuperResolution node prepares conditioning data for a video su | `positive` | The positive conditioning input to be modified with latent and augmentation data. | CONDITIONING | Yes | N/A | | `negative` | The negative conditioning input to be modified with latent and augmentation data. | CONDITIONING | Yes | N/A | | `vae` | The VAE used to encode the optional `start_image`. Required if `start_image` is provided. | VAE | No | N/A | -| `start_image` | An optional starting image to guide the super-resolution. If provided, it will be upscaled and encoded into the conditioning latent. | IMAGE | No | N/A | +| `start_image` | An optional starting image to guide the super-resolution. If provided, it is upscaled and encoded into the conditioning latent. | IMAGE | No | N/A | | `clip_vision_output` | Optional CLIP vision embeddings to add to the conditioning. | CLIP_VISION_OUTPUT | No | N/A | -| `latent` | The input latent video representation that will be incorporated into the conditioning. | LATENT | Yes | N/A | -| `noise_augmentation` | The strength of noise augmentation to apply to the conditioning (default: 0.70). | FLOAT | No | 0.0 - 1.0 | +| `latent` | The input latent video representation that is incorporated into the conditioning. | LATENT | Yes | N/A | +| `noise_augmentation` | The strength of noise augmentation to apply to the conditioning (default: 0.70). This is an advanced parameter. | FLOAT | No | 0.0 - 1.0 (step 0.01) | -**Note:** If you provide a `start_image`, you must also connect a `vae` for it to be encoded. The `start_image` will be automatically upscaled to match the dimensions implied by the input `latent`. +**Note:** If you provide a `start_image`, you must also connect a `vae` so it can be encoded. The `start_image` is automatically upscaled to 16 times the spatial dimensions (width and height) of the input `latent`, then encoded and placed into the conditioning latent. Only the RGB channels of the `start_image` are used for encoding. ## Outputs @@ -27,4 +27,4 @@ The HunyuanVideo15SuperResolution node prepares conditioning data for a video su > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HunyuanVideo15SuperResolution/en.md) --- -**Source fingerprint (SHA-256):** `12bb48e731a265f806e5961950b3fc9c64e30148785e443a40c8d9f3ad9484e4` +**Source fingerprint (SHA-256):** `c9e64092e78423f5e0dc43446a77240e09100242c25e4fccc91491049fe76be5` diff --git a/comfyui_embedded_docs/docs/HyperTile/en.md b/comfyui_embedded_docs/docs/HyperTile/en.md index 6fb0d15ed..235bfd1e7 100644 --- a/comfyui_embedded_docs/docs/HyperTile/en.md +++ b/comfyui_embedded_docs/docs/HyperTile/en.md @@ -7,10 +7,10 @@ The HyperTile node applies a tiling technique to the attention mechanism in diff | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | | `model` | The diffusion model to apply the HyperTile optimization to | MODEL | Yes | - | -| `tile_size` | The target tile size for processing (default: 256). The effective tile size is rounded down to a multiple of 8, with a minimum of 32. | INT | No | 1 - 2048 | -| `swap_size` | Controls how the tiles are rearranged during processing to improve efficiency (default: 2) | INT | No | 1 - 128 | -| `max_depth` | The maximum depth level (resolution scale) to apply tiling. A value of 0 applies tiling only at the highest resolution (default: 0) | INT | No | 0 - 10 | -| `scale_depth` | When enabled, the tile size is scaled proportionally at deeper depth levels. This can help maintain quality at lower resolutions (default: False) | BOOLEAN | No | True / False | +| `tile_size` | The target tile size for processing (default: 256). Internally, the value is clamped to a minimum of 32 and then divided by 8 to obtain the effective tile size. | INT | Yes | 1 - 2048 | +| `swap_size` | Controls how the tiles are rearranged during processing to improve efficiency. Larger values allow more variation in tile sizes (default: 2) | INT | Yes | 1 - 128 | +| `max_depth` | The maximum depth level (resolution scale) to apply tiling. A value of 0 applies tiling only at the highest resolution (default: 0) | INT | Yes | 0 - 10 | +| `scale_depth` | When enabled, the tile size is scaled proportionally at deeper depth levels. This can help maintain quality at lower resolutions (default: False) | BOOLEAN | Yes | True / False | ## Outputs @@ -21,4 +21,4 @@ The HyperTile node applies a tiling technique to the attention mechanism in diff > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HyperTile/en.md) --- -**Source fingerprint (SHA-256):** `ea770eea3c628ffb166c2a15a6f75757cebd99c3fdd6225f041b3ef01a0e73c7` +**Source fingerprint (SHA-256):** `fb2fa29a403b6b7de7d5263240cc51a74126078457a3ff9ea63aeded45b9b74a` diff --git a/comfyui_embedded_docs/docs/Ideogram4Scheduler/en.md b/comfyui_embedded_docs/docs/Ideogram4Scheduler/en.md index 1c7e9c9a5..43c788dc0 100644 --- a/comfyui_embedded_docs/docs/Ideogram4Scheduler/en.md +++ b/comfyui_embedded_docs/docs/Ideogram4Scheduler/en.md @@ -6,11 +6,13 @@ The Ideogram 4 Scheduler node generates a sequence of sigma values (noise levels | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `steps` | The number of sampling steps to generate the schedule for (default: 20) | INT | Yes | 1 to 200 | -| `width` | The width of the image in pixels (default: 1024) | INT | Yes | 256 to 8192 (step: 16) | -| `height` | The height of the image in pixels (default: 1024) | INT | Yes | 256 to 8192 (step: 16) | -| `mu` | The mean parameter for the logit-normal distribution, controlling the central noise level (default: 0.0) | FLOAT | Yes | -10.0 to 10.0 (step: 0.05) | -| `std` | The standard deviation parameter for the logit-normal distribution, controlling the spread of noise levels (default: 1.75) | FLOAT | Yes | 0.1 to 5.0 (step: 0.05) | +| `steps` | The number of sampling steps to generate the schedule for (default: 20). The output contains `steps + 1` sigma values. | INT | Yes | 1 to 200 | +| `width` | The width of the image in pixels (default: 1024). The resolution relative to a 512×512 reference shifts the noise schedule. | INT | Yes | 256 to 8192 (step: 16) | +| `height` | The height of the image in pixels (default: 1024). The resolution relative to a 512×512 reference shifts the noise schedule. | INT | Yes | 256 to 8192 (step: 16) | +| `mu` | The mean parameter for the logit-normal distribution, controlling the central noise level. Combined with the resolution term to form the logSNR shift (default: 0.0). | FLOAT | Yes | -10.0 to 10.0 (step: 0.05) | +| `std` | The standard deviation parameter for the logit-normal distribution, controlling the spread of noise levels (default: 1.75). | FLOAT | Yes | 0.1 to 5.0 (step: 0.05) | + +Note: The schedule is derived from a logit-normal distribution over reference time. A resolution term equal to `0.5 * log((width × height) / (512 × 512))` is added to `mu`, so larger or smaller images shift the schedule relative to a 512×512 reference at the same `mu` value. ## Outputs @@ -21,4 +23,4 @@ The Ideogram 4 Scheduler node generates a sequence of sigma values (noise levels > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Ideogram4Scheduler/en.md) --- -**Source fingerprint (SHA-256):** `408ea680158500690e28e300098a5c4fd13eb1a2c96c3d95db06244151116f22` +**Source fingerprint (SHA-256):** `af0749713ce223d2246fc24b5100f18aa68d56746480990282899c223578b8f4` diff --git a/comfyui_embedded_docs/docs/IdeogramPImage/en.md b/comfyui_embedded_docs/docs/IdeogramPImage/en.md index 62db8203f..f07c6766a 100644 --- a/comfyui_embedded_docs/docs/IdeogramPImage/en.md +++ b/comfyui_embedded_docs/docs/IdeogramPImage/en.md @@ -1,16 +1,16 @@ -# IdeogramPImage +# Ideogram P-Image -Ideogram P-Image generates images from a text prompt using Ideogram's fast text-to-image model, which is known for strong typography and photorealism. It also supports Ideogram 4.0 structured JSON captions for exact control over text strings, colors, and layout. The node returns the generated image(s) along with the final prompt the image was actually generated from. +Ideogram & Pruna P-Image generates images from a text prompt using Ideogram's fast text-to-image model, which is known for strong typography and photorealism. It also supports Ideogram 4.0 structured JSON captions for exact control over text strings, colors, and layout. The node returns the generated image(s) along with the final prompt the image was actually generated from. ## Inputs | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `prompt` | Text prompt. Also accepts an Ideogram 4.0 structured JSON caption (exact colors as #RRGGBB hexes, exact text strings, bounding-box layout) — set prompt_upsampling to OFF to use it verbatim. Must not be empty. (default: "") | STRING | Yes | Any text | -| `quality` | Speed/price/quality tier. MEDIUM is the everyday default; HIGH for complex prompts, fine detail and difficult text; VERY_LOW/LOW for drafts at scale. Difficult text renders poorly below MEDIUM. (default: "MEDIUM") | STRING | Yes | "VERY_LOW"
"LOW"
"MEDIUM"
"HIGH" | -| `resolution` | Output size class (exact pixels follow the aspect ratio, e.g. 16:9 gives 1280x720 at 1K and 2560x1440 at 2K). Prefer HIGH + 2K for crisp typography. (default: "1K") | STRING | Yes | "1K"
"2K" | -| `aspect_ratio` | The aspect ratio for image generation. (default: "1:1") | STRING | Yes | "1:3"
"3:1"
"1:2"
"2:1"
"9:16"
"16:9"
"10:16"
"16:10"
"2:3"
"3:2"
"3:4"
"4:3"
"4:5"
"5:4"
"1:1" | -| `prompt_upsampling` | Expands short prompts into a detailed structured caption before generation (the rewritten prompt is returned as final_prompt). Set OFF when supplying your own JSON caption or exact wording. (default: "AUTO") | STRING | Yes | "AUTO"
"ON"
"OFF" | +| `prompt` | Text prompt. Also accepts an Ideogram 4.0 structured JSON caption (exact colors as #RRGGBB hexes, exact text strings, bounding-box layout) — set prompt_upsampling to OFF to use it verbatim. Must not be empty. (default: "") | STRING | Yes | Any non-empty text | +| `quality` | Speed/price/quality tier. MEDIUM is the everyday default; HIGH for complex prompts, fine detail and difficult text; VERY_LOW/LOW for drafts at scale. Difficult text renders poorly below MEDIUM. (default: "MEDIUM") | COMBO | Yes | "VERY_LOW"
"LOW"
"MEDIUM"
"HIGH" | +| `resolution` | Output size class (exact pixels follow the aspect ratio, e.g. 16:9 gives 1280x720 at 1K and 2560x1440 at 2K). Prefer HIGH + 2K for crisp typography. (default: "1K") | COMBO | Yes | "1K"
"2K" | +| `aspect_ratio` | The aspect ratio for image generation. (default: "1:1") | COMBO | Yes | "1:3"
"3:1"
"1:2"
"2:1"
"9:16"
"16:9"
"10:16"
"16:10"
"2:3"
"3:2"
"3:4"
"4:3"
"4:5"
"5:4"
"1:1" | +| `prompt_upsampling` | Expands short prompts into a detailed structured caption before generation (the rewritten prompt is returned as final_prompt). Set OFF when supplying your own JSON caption or exact wording. (default: "AUTO") | COMBO | Yes | "AUTO"
"ON"
"OFF" | | `seed` | Seed for reproducible generation. With prompt_upsampling OFF, the same seed and settings return the same image; with ON/AUTO the prompt rewrite varies per run — reproduce a result by reusing its final_prompt output with prompt_upsampling OFF and the same seed. (default: 42) | INT | No | 0 to 2147483647 | **Note on constraints:** The prompt must contain at least one non-whitespace character, otherwise the node fails. Set `prompt_upsampling` to OFF when supplying your own structured JSON caption or exact wording. When `prompt_upsampling` is ON or AUTO, the prompt is rewritten before generation, so the same seed may not reproduce the same image; to reproduce an image, reuse its `final_prompt` output with `prompt_upsampling` OFF and the same seed. @@ -25,4 +25,4 @@ Ideogram P-Image generates images from a text prompt using Ideogram's fast text- > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/IdeogramPImage/en.md) --- -**Source fingerprint (SHA-256):** `7bd20aae508fee111ded32e87119ed6fc01c5ad5ba7d595e24391830a0f20bb7` +**Source fingerprint (SHA-256):** `6b014c2f097c49b5930f38869a4e2da0ebb19863763ae5817d6e566a36d2b8e8` diff --git a/comfyui_embedded_docs/docs/ImageCompositor/ar.md b/comfyui_embedded_docs/docs/ImageCompositor/ar.md index 887495fc5..c9e0bcda5 100644 --- a/comfyui_embedded_docs/docs/ImageCompositor/ar.md +++ b/comfyui_embedded_docs/docs/ImageCompositor/ar.md @@ -6,8 +6,8 @@ | المعامل | الوصف | نوع البيانات | إلزامي | النطاق | |-----------|-------------|-----------|----------|-------| -| `layers` | حزمة الطبقات المراد تركيبها؛ أنشئها باستخدام Add Layer. تُرتَّب العناصر حسب z_index، وتتوسع إطارات الدُفعات داخل العنصر إلى طبقات متتالية، ويحدد موضع العنصر وشفافيته ووضع المزج التركيب المبدئي. بدون لوحة مستند صريحة، يكون الحجم هو أقصى امتداد بأفضل جهد ممكن للطبقات الموضوعة. التركيبة المحفوظة التي تطابق المدخلات الحالية لها الأولوية. | LAYERS | نعم | 50 طبقة كحد أقصى | -| `compositor` | تركيبة طبقية محفوظة بواسطة محرر التركيب. | COMPOSITOR | لا | لا يوجد | +| `الطبقات` | حزمة الطبقات المراد تركيبها؛ أنشئها باستخدام Add Layer. تُرتَّب العناصر حسب z_index، وتتوسع إطارات الدُفعات داخل العنصر إلى طبقات متتالية، ويحدد موضع العنصر وشفافيته ووضع المزج التركيب المبدئي. بدون لوحة مستند صريحة، يكون الحجم هو أقصى امتداد بأفضل جهد ممكن للطبقات الموضوعة. التركيبة المحفوظة التي تطابق المدخلات الحالية لها الأولوية. | LAYERS | نعم | 50 طبقة كحد أقصى | +| `المركب` | تركيبة طبقية محفوظة بواسطة محرر التركيب. | COMPOSITOR | لا | لا يوجد | **ملاحظات حول القيود:** diff --git a/comfyui_embedded_docs/docs/ImageCompositor/es.md b/comfyui_embedded_docs/docs/ImageCompositor/es.md index 6dbbf1a99..af22aff81 100644 --- a/comfyui_embedded_docs/docs/ImageCompositor/es.md +++ b/comfyui_embedded_docs/docs/ImageCompositor/es.md @@ -6,7 +6,7 @@ Este nodo combina múltiples capas de imagen en una única imagen compuesta. Tom | Parámetro | Descripción | Tipo de Dato | Requerido | Rango | |-----------|-------------|--------------|-----------|-------| -| `layers` | Pila de capas para componer; constrúyala con Add Layer. Los elementos se apilan por z_index, los fotogramas de lote dentro de un elemento se expanden a capas consecutivas, y la posición, opacidad y modo de mezcla del elemento definen la composición inicial. Sin un lienzo de documento explícito, el tamaño es el alcance máximo de las capas colocadas según el mejor esfuerzo. Una composición guardada que coincida con las entradas actuales tiene prioridad. | LAYERS | Sí | Máximo 50 capas | +| `capas` | Pila de capas para componer; constrúyala con Add Layer. Los elementos se apilan por z_index, los fotogramas de lote dentro de un elemento se expanden a capas consecutivas, y la posición, opacidad y modo de mezcla del elemento definen la composición inicial. Sin un lienzo de documento explícito, el tamaño es el alcance máximo de las capas colocadas según el mejor esfuerzo. Una composición guardada que coincida con las entradas actuales tiene prioridad. | LAYERS | Sí | Máximo 50 capas | | `compositor` | Composición en capas guardada por el editor de compositor. | COMPOSITOR | No | Ninguno | **Notas sobre las restricciones:** diff --git a/comfyui_embedded_docs/docs/ImageCompositor/fa.md b/comfyui_embedded_docs/docs/ImageCompositor/fa.md index beb0cf1b9..ee84fe800 100644 --- a/comfyui_embedded_docs/docs/ImageCompositor/fa.md +++ b/comfyui_embedded_docs/docs/ImageCompositor/fa.md @@ -6,8 +6,8 @@ | پارامتر | توضیحات | نوع داده | الزامی | بازه | |-----------|-------------|-----------|----------|-------| -| `layers` | پشته لایه برای ترکیب؛ آن را با Add Layer بسازید. آیتم‌ها توسط `z_index` پشته‌سازی می‌شوند، فریم‌های دسته‌ای درون یک آیتم به لایه‌های متوالی گسترش می‌یابند، و مکان آیتم، شفافیت و حالت ترکیب، ترکیب اولیه را تعریف می‌کنند. بدون بوم سند صریح، اندازه به‌صورت حداکثر وسعت ممکن لایه‌های جای‌گذاری‌شده در نظر گرفته می‌شود. یک ترکیب ذخیره‌شده که با ورودی‌های فعلی مطابقت داشته باشد، اولویت دارد. | LAYERS | بله | حداکثر ۵۰ لایه | -| `compositor` | ترکیب لایه‌ای ذخیره‌شده توسط ویرایشگر compositor. | COMPOSITOR | خیر | هیچ | +| `لایه‌ها` | پشته لایه برای ترکیب؛ آن را با Add Layer بسازید. آیتم‌ها توسط `z_index` پشته‌سازی می‌شوند، فریم‌های دسته‌ای درون یک آیتم به لایه‌های متوالی گسترش می‌یابند، و مکان آیتم، شفافیت و حالت ترکیب، ترکیب اولیه را تعریف می‌کنند. بدون بوم سند صریح، اندازه به‌صورت حداکثر وسعت ممکن لایه‌های جای‌گذاری‌شده در نظر گرفته می‌شود. یک ترکیب ذخیره‌شده که با ورودی‌های فعلی مطابقت داشته باشد، اولویت دارد. | LAYERS | بله | حداکثر ۵۰ لایه | +| `ترکیب‌کننده` | ترکیب لایه‌ای ذخیره‌شده توسط ویرایشگر compositor. | COMPOSITOR | خیر | هیچ | **یادداشت‌هایی درباره محدودیت‌ها:** diff --git a/comfyui_embedded_docs/docs/ImageCompositor/ru.md b/comfyui_embedded_docs/docs/ImageCompositor/ru.md index f5b298403..4e5426446 100644 --- a/comfyui_embedded_docs/docs/ImageCompositor/ru.md +++ b/comfyui_embedded_docs/docs/ImageCompositor/ru.md @@ -6,8 +6,8 @@ | Параметр | Описание | Тип данных | Обязательный | Диапазон | |-----------|-------------|-----------|----------|-------| -| `layers` | Стек слоев для композитинга; создается с помощью Add Layer. Элементы располагаются по z_index, кадры внутри элемента расширяются в последовательные слои, а положение элемента, непрозрачность и режим наложения определяют исходную композицию. При отсутствии явного холста документа размер вычисляется как наилучшая оценка максимальной протяженности размещенных слоев. Сохраненная композиция, соответствующая текущим входным данным, имеет приоритет. | LAYERS | Да | Maximum 50 layers | -| `compositor` | Многослойная композиция, сохраненная редактором композитора. | COMPOSITOR | Нет | None | +| `слои` | Стек слоев для композитинга; создается с помощью Add Layer. Элементы располагаются по z_index, кадры внутри элемента расширяются в последовательные слои, а положение элемента, непрозрачность и режим наложения определяют исходную композицию. При отсутствии явного холста документа размер вычисляется как наилучшая оценка максимальной протяженности размещенных слоев. Сохраненная композиция, соответствующая текущим входным данным, имеет приоритет. | LAYERS | Да | Maximum 50 layers | +| `композитор` | Многослойная композиция, сохраненная редактором композитора. | COMPOSITOR | Нет | None | **Примечания по ограничениям:** diff --git a/comfyui_embedded_docs/docs/ImageCompositor/tr.md b/comfyui_embedded_docs/docs/ImageCompositor/tr.md index c2c551815..d14971069 100644 --- a/comfyui_embedded_docs/docs/ImageCompositor/tr.md +++ b/comfyui_embedded_docs/docs/ImageCompositor/tr.md @@ -6,8 +6,8 @@ Bu düğüm, birden fazla görüntü katmanını tek bir birleşik görüntüde | Parametre | Açıklama | Veri Türü | Gerekli | Aralık | |-----------|-------------|-----------|----------|-------| -| `layers` | Birleştirilecek katman yığını; Add Layer ile oluşturun. Öğeler z_index'e göre istiflenir, bir öğe içindeki batch kareleri ardışık katmanlara genişler ve öğe yerleşimi, opaklığı ve karışım modu ilk birleşimi tanımlar. Açık bir belge tuvali olmadığında boyut, yerleştirilen katmanların maksimum kapsamına göre belirlenir. Mevcut girdilerle eşleşen kaydedilmiş bir kompozisyon önceliklidir. | LAYERS | Evet | Maksimum 50 katman | -| `compositor` | Kompozitör düzenleyici tarafından kaydedilmiş katmanlı kompozisyon. | COMPOSITOR | Hayır | Yok | +| `katmanlar` | Birleştirilecek katman yığını; Add Layer ile oluşturun. Öğeler z_index'e göre istiflenir, bir öğe içindeki batch kareleri ardışık katmanlara genişler ve öğe yerleşimi, opaklığı ve karışım modu ilk birleşimi tanımlar. Açık bir belge tuvali olmadığında boyut, yerleştirilen katmanların maksimum kapsamına göre belirlenir. Mevcut girdilerle eşleşen kaydedilmiş bir kompozisyon önceliklidir. | LAYERS | Evet | Maksimum 50 katman | +| `kompozitör` | Kompozitör düzenleyici tarafından kaydedilmiş katmanlı kompozisyon. | COMPOSITOR | Hayır | Yok | **Kısıtlamalara ilişkin notlar:** diff --git a/comfyui_embedded_docs/docs/ImageCropToMask/ar.md b/comfyui_embedded_docs/docs/ImageCropToMask/ar.md new file mode 100644 index 000000000..d3ce4776c --- /dev/null +++ b/comfyui_embedded_docs/docs/ImageCropToMask/ar.md @@ -0,0 +1,32 @@ +# ImageCropToMask + +هذه وثيقة مترجمة إلى العربية، مع الحفاظ على جميع التنسيقات وأسماء المعاملات والمخرجات الإنجليزي كما هو مطلوب. + +--- + +تقوم هذه العقدة بقصّ الصورة إلى الصندوق المحيط بالقناع الخاص بها، مما يُنتج موضوعًا متمركزًا فوق لون خلفية صلب. تقوم العقدة بتركيب الصورة المُقنَّعة فوق الخلفية المختارة وتغيير حجم النتيجة إلى أبعاد الإخراج المحددة، مما يجعلها مناسبة لخطوط أنابيب العرض ثلاثية الأبعاد التي تتوقع موضوعًا متمركزًا وخاليًا من الخلفية بدقة ثابتة. + +## المدخلات + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|-----------|-------------|-----------|----------|-------| +| `images` | صورة الإدخال أو دفعة الصور المراد قصّها. | IMAGE | نعم | — | +| `masks` | القناع أو دفعة الأقنعة التي تحدّد منطقة الموضوع. يُطبَّق قناع واحد على جميع الصور؛ وإلا يجب أن يتطابق حجم دفعة الأقنعة مع حجم دفعة الصور. إذا كانت دقة القناع مختلفة عن دقة الصورة، يتم تغيير حجم القناع تلقائيًا ليطابقها. | MASK | نعم | — | +| `width` | عرض الإخراج بالبكسل. (الافتراضي: 1024) | INT | نعم | 64 إلى 4096 (الخطوة 8) | +| `height` | ارتفاع الإخراج بالبكسل. (الافتراضي: 1024) | INT | نعم | 64 إلى 4096 (الخطوة 8) | +| `pad_factor` | هامش إضافي حول الصندوق المحيط بالقناع كمضاعِف. (الافتراضي: 1.0) | FLOAT | نعم | 1.0 إلى 2.0 (الخطوة 0.01) | +| `grow_mask` | قم بتوسيع القناع أو تقليصه بهذا العدد من البكسلات قبل القصّ. القيم الموجبة توسّع القناع، والقيم السالبة تقلّصه. (الافتراضي: 0) | INT | نعم | -32 إلى 32 (الخطوة 1) | +| `background` | لون الخلفية خلف الموضوع المُقنَّع. (الافتراضي: #000000) | COLOR | نعم | — | + +ملاحظة: تكون منطقة القصّ متمركزة حول الصندوق المحيط بالقناع، وتطابق نسبة أبعادها نسبة `width` / `height`. تكتشف العقدة تلقائيًا القناع المعكوس وتصححه (بكسلات المقدمة على طول الحواف، والخلفية في المنتصف). إذا كان القناع لا يحتوي على بكسلات مقدمة، تحاول العقدة استخدام القناع المعكوس؛ إذا كان فارغًا أيضًا، فإنها تسجّل تحذيرًا وتقصّ الصورة بأكملها. يتم رفع خطأ عندما لا يتطابق حجم دفعة الأقنعة مع حجم دفعة الصور وليس قناعًا واحدًا. + +## المخرجات + +| اسم المخرَج | الوصف | نوع البيانات | +|-------------|-------------|-----------| +| `images` | الصور المركّبة بعد القصّ (الموضوع المُقنَّع فوق لون الخلفية المختار)، مع تغيير حجمها إلى `width` × `height`. يتطابق حجم الدفعة مع دفعة صور الإدخال. | IMAGE | + +> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ImageCropToMask/ar.md) + +--- +**Source fingerprint (SHA-256):** `fcc14b5db7318699526dd544d404f78f9d1ab362b73769276f113f2b1062b214` diff --git a/comfyui_embedded_docs/docs/ImageCropToMask/en.md b/comfyui_embedded_docs/docs/ImageCropToMask/en.md new file mode 100644 index 000000000..7e15d8996 --- /dev/null +++ b/comfyui_embedded_docs/docs/ImageCropToMask/en.md @@ -0,0 +1,28 @@ +# ImageCropToMask + +Crops an image to the bounding box of its mask, producing a centered subject over a solid background color. The node composites the masked image over the chosen background and resizes the result to the specified output dimensions, making it suitable for 3D pipelines that expect a centered, background-free subject at a fixed resolution. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `images` | The input image or batch of images to crop. | IMAGE | Yes | — | +| `masks` | The mask or batch of masks that defines the subject area. A single mask is applied to all images; otherwise the mask batch size must match the image batch size. If the mask resolution differs from the image resolution, the mask is automatically resized to match. | MASK | Yes | — | +| `width` | Output width in pixels. (default: 1024) | INT | Yes | 64 to 4096 (step 8) | +| `height` | Output height in pixels. (default: 1024) | INT | Yes | 64 to 4096 (step 8) | +| `pad_factor` | Extra margin around the mask bounding box as a multiplier. (default: 1.0) | FLOAT | Yes | 1.0 to 2.0 (step 0.01) | +| `grow_mask` | Grow or shrink the mask by this many pixels before cropping. Positive values expand the mask, negative values shrink it. (default: 0) | INT | Yes | -32 to 32 (step 1) | +| `background` | Background color behind the masked subject. (default: #000000) | COLOR | Yes | — | + +Note: The crop region is centered on the mask's bounding box and its aspect ratio matches `width` / `height`. The node automatically detects and corrects an inverted mask (foreground pixels along the border, background in the center). If the mask contains no foreground pixels, the node tries the inverted mask; if that is also empty, it logs a warning and crops the entire image. An error is raised when the mask batch size does not match the image batch size and is not a single mask. + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `images` | The cropped composite images (masked subject over the chosen background color), resized to `width` x `height`. The batch size matches the input image batch. | IMAGE | + +> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ImageCropToMask/en.md) + +--- +**Source fingerprint (SHA-256):** `fcc14b5db7318699526dd544d404f78f9d1ab362b73769276f113f2b1062b214` diff --git a/comfyui_embedded_docs/docs/ImageCropToMask/es.md b/comfyui_embedded_docs/docs/ImageCropToMask/es.md new file mode 100644 index 000000000..6c4ad9a30 --- /dev/null +++ b/comfyui_embedded_docs/docs/ImageCropToMask/es.md @@ -0,0 +1,28 @@ +# ImageCropToMask + +Recorta una imagen al cuadro delimitador de su máscara, produciendo un sujeto centrado sobre un color de fondo sólido. El nodo compone la imagen enmascarada sobre el fondo elegido y redimensiona el resultado a las dimensiones de salida especificadas, lo que lo hace adecuado para pipelines 3D que esperan un sujeto centrado, sin fondo y a una resolución fija. + +## Entradas + +| Parámetro | Descripción | Tipo de datos | Requerido | Rango | +|-----------|-------------|---------------|-----------|-------| +| `images` | La imagen de entrada o lote de imágenes a recortar. | IMAGE | Sí | — | +| `masks` | La máscara o lote de máscaras que define el área del sujeto. Una máscara única se aplica a todas las imágenes; de lo contrario, el tamaño del lote de máscaras debe coincidir con el tamaño del lote de imágenes. Si la resolución de la máscara difiere de la resolución de la imagen, la máscara se redimensiona automáticamente para coincidir. | MASK | Sí | — | +| `width` | Ancho de salida en píxeles. (por defecto: 1024) | INT | Sí | 64 to 4096 (step 8) | +| `height` | Alto de salida en píxeles. (por defecto: 1024) | INT | Sí | 64 to 4096 (step 8) | +| `pad_factor` | Margen adicional alrededor del cuadro delimitador de la máscara como multiplicador. (por defecto: 1.0) | FLOAT | Sí | 1.0 to 2.0 (step 0.01) | +| `grow_mask` | Expandir o contraer la máscara en esta cantidad de píxeles antes de recortar. Los valores positivos expanden la máscara, los negativos la contraen. (por defecto: 0) | INT | Sí | -32 to 32 (step 1) | +| `background` | Color de fondo detrás del sujeto enmascarado. (por defecto: #000000) | COLOR | Sí | — | + +Nota: La región de recorte está centrada en el cuadro delimitador de la máscara y su relación de aspecto coincide con `width` / `height`. El nodo detecta y corrige automáticamente una máscara invertida (píxeles de primer plano a lo largo del borde, fondo en el centro). Si la máscara no contiene píxeles de primer plano, el nodo intenta con la máscara invertida; si esta también está vacía, registra una advertencia y recorta la imagen completa. Se produce un error cuando el tamaño del lote de máscaras no coincide con el tamaño del lote de imágenes y no es una máscara única. + +## Salidas + +| Nombre de salida | Descripción | Tipo de datos | +|------------------|-------------|---------------| +| `images` | Las imágenes compuestas recortadas (sujeto enmascarado sobre el color de fondo elegido), redimensionadas a `width` x `height`. El tamaño del lote coincide con el lote de imágenes de entrada. | IMAGE | + +> Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ImageCropToMask/es.md) + +--- +**Source fingerprint (SHA-256):** `fcc14b5db7318699526dd544d404f78f9d1ab362b73769276f113f2b1062b214` diff --git a/comfyui_embedded_docs/docs/ImageCropToMask/fa.md b/comfyui_embedded_docs/docs/ImageCropToMask/fa.md new file mode 100644 index 000000000..d8a288384 --- /dev/null +++ b/comfyui_embedded_docs/docs/ImageCropToMask/fa.md @@ -0,0 +1,30 @@ +# ImageCropToMask + +```markdown +تصویر را به جعبه‌ی محدودکننده‌ی ماسک آن برش می‌زند و سوژه‌ای مرکزچین روی یک رنگ پس‌زمینه‌ی ساده تولید می‌کند. گره، تصویر ماسک‌شده را روی پس‌زمینه‌ی انتخابی ترکیب می‌کند و نتیجه را به ابعاد خروجی مشخص‌شده تغییر اندازه می‌دهد؛ این کار آن را برای خطوط لوله‌ی سه‌بعدی که انتظار یک سوژه‌ی مرکزچین و بدون پس‌زمینه با وضوح ثابت دارند، مناسب می‌سازد. + +## ورودی‌ها + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `images` | تصویر ورودی یا دسته‌ای از تصاویر برای برش. | IMAGE | بله | — | +| `masks` | ماسک یا دسته‌ای از ماسک‌ها که ناحیه‌ی سوژه را تعریف می‌کند. یک ماسک تکی به همه‌ی تصاویر اعمال می‌شود؛ در غیر این صورت اندازه‌ی دسته‌ی ماسک باید با اندازه‌ی دسته‌ی تصویر مطابقت داشته باشد. اگر وضوح ماسک با وضوح تصویر متفاوت باشد، ماسک به‌صورت خودکار برای تطبیق تغییر اندازه داده می‌شود. | MASK | بله | — | +| `width` | عرض خروجی به پیکسل. (پیش‌فرض: 1024) | INT | بله | 64 تا 4096 (گام 8) | +| `height` | ارتفاع خروجی به پیکسل. (پیش‌فرض: 1024) | INT | بله | 64 تا 4096 (گام 8) | +| `pad_factor` | حاشیه‌ی اضافی دور جعبه‌ی محدودکننده‌ی ماسک به‌صورت ضریب. (پیش‌فرض: 1.0) | FLOAT | بله | 1.0 تا 2.0 (گام 0.01) | +| `grow_mask` | ماسک را به اندازه‌ی این تعداد پیکسل قبل از برش بزرگ یا کوچک می‌کند. مقادیر مثبت ماسک را گسترش می‌دهند، مقادیر منفی آن را کوچک می‌کنند. (پیش‌فرض: 0) | INT | بله | 32- تا 32 (گام 1) | +| `background` | رنگ پس‌زمینه‌ی پشت سوژه‌ی ماسک‌شده. (پیش‌فرض: #000000) | COLOR | بله | — | + +نکته: ناحیه‌ی برش بر روی جعبه‌ی محدودکننده‌ی ماسک متمرکز است و نسبت ابعاد آن با `width` / `height` مطابقت دارد. گره به‌صورت خودکار ماسک وارونه را تشخیص داده و اصلاح می‌کند (پیکسل‌های پیش‌زمینه در امتداد لبه، پس‌زمینه در مرکز). اگر ماسک حاوی پیکسل پیش‌زمینه نباشد، گره ماسک وارونه را امتحان می‌کند؛ اگر آن نیز خالی بود، یک هشدار ثبت می‌کند و کل تصویر را برش می‌زند. اگر اندازه‌ی دسته‌ی ماسک با اندازه‌ی دسته‌ی تصویر مطابقت نداشته باشد و ماسک تکی نباشد، خطا ایجاد می‌شود. + +## خروجی‌ها + +| نام خروجی | توضیحات | نوع داده | +|-------------|-------------|-----------| +| `images` | تصاویر کامپوزیت برش‌خورده (سوژه‌ی ماسک‌شده روی رنگ پس‌زمینه‌ی انتخابی)، تغییر اندازه‌داده‌شده به `width` در `height`. اندازه‌ی دسته با دسته‌ی تصویر ورودی مطابقت دارد. | IMAGE | +``` + +> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ImageCropToMask/fa.md) + +--- +**Source fingerprint (SHA-256):** `fcc14b5db7318699526dd544d404f78f9d1ab362b73769276f113f2b1062b214` diff --git a/comfyui_embedded_docs/docs/ImageCropToMask/fr.md b/comfyui_embedded_docs/docs/ImageCropToMask/fr.md new file mode 100644 index 000000000..642ab0bf4 --- /dev/null +++ b/comfyui_embedded_docs/docs/ImageCropToMask/fr.md @@ -0,0 +1,26 @@ +# ImageCropToMask + +## Entrées + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------|----------|-------| +| `images` | L’image ou le lot d’images à recadrer. | IMAGE | Oui | — | +| `masks` | Le masque ou le lot de masques qui définit la zone du sujet. Un masque unique est appliqué à toutes les images ; sinon, la taille du lot de masques doit correspondre à celle du lot d’images. Si la résolution du masque diffère de celle de l’image, le masque est automatiquement redimensionné pour correspondre. | MASK | Oui | — | +| `width` | Largeur de sortie en pixels. (défaut : 1024) | INT | Oui | 64 à 4096 (pas 8) | +| `height` | Hauteur de sortie en pixels. (défaut : 1024) | INT | Oui | 64 à 4096 (pas 8) | +| `pad_factor` | Marge supplémentaire autour de la boîte englobante du masque, sous forme de multiplicateur. (défaut : 1.0) | FLOAT | Oui | 1.0 à 2.0 (pas 0.01) | +| `grow_mask` | Agrandit ou réduit le masque de ce nombre de pixels avant le recadrage. Les valeurs positives agrandissent le masque, les valeurs négatives le réduisent. (défaut : 0) | INT | Oui | -32 à 32 (pas 1) | +| `background` | Couleur d’arrière-plan derrière le sujet masqué. (défaut : #000000) | COLOR | Oui | — | + +Remarque : La région de recadrage est centrée sur la boîte englobante du masque et son rapport largeur/hauteur correspond à `width` / `height`. Le nœud détecte et corrige automatiquement un masque inversé (pixels de premier plan le long du bord, arrière-plan au centre). Si le masque ne contient aucun pixel de premier plan, le nœud essaie le masque inversé ; si celui-ci est également vide, il émet un avertissement et recadre l’image entière. Une erreur est déclenchée lorsque la taille du lot de masques ne correspond pas à celle du lot d’images et qu’il ne s’agit pas d’un masque unique. + +## Sorties + +| Nom de sortie | Description | Type de données | +|-------------|-------------|-----------| +| `images` | Les images composites recadrées (sujet masqué sur la couleur d’arrière-plan choisie), redimensionnées à `width` x `height`. La taille du lot correspond au lot d’images d’entrée. | IMAGE | + +> Cette documentation a été générée par IA. Si vous trouvez des erreurs ou avez des suggestions d'amélioration, n'hésitez pas à contribuer ! [Modifier sur GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ImageCropToMask/fr.md) + +--- +**Source fingerprint (SHA-256):** `fcc14b5db7318699526dd544d404f78f9d1ab362b73769276f113f2b1062b214` diff --git a/comfyui_embedded_docs/docs/ImageCropToMask/ja.md b/comfyui_embedded_docs/docs/ImageCropToMask/ja.md new file mode 100644 index 000000000..a3219cef5 --- /dev/null +++ b/comfyui_embedded_docs/docs/ImageCropToMask/ja.md @@ -0,0 +1,28 @@ +# ImageCropToMask + +画像をマスクの境界ボックスに合わせてクロップし、被写体を単一の背景色の上に中央配置します。このノードは、マスクされた画像を選択した背景の上に合成し、指定された出力サイズにリサイズします。これにより、固定解像度で中央配置された背景なしの被写体を必要とする3Dパイプラインに適した出力が得られます。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `images` | クロップする入力画像、または画像のバッチ。 | IMAGE | はい | — | +| `masks` | 被写体領域を定義するマスク、またはマスクのバッチ。単一のマスクはすべての画像に適用されます。それ以外の場合、マスクのバッチサイズは画像のバッチサイズと一致する必要があります。マスクの解像度が画像の解像度と異なる場合は、自動的にリサイズされます。 | MASK | はい | — | +| `width` | 出力幅(ピクセル単位)。(デフォルト:1024) | INT | はい | 64 から 4096(ステップ 8) | +| `height` | 出力高さ(ピクセル単位)。(デフォルト:1024) | INT | はい | 64 から 4096(ステップ 8) | +| `pad_factor` | マスク境界ボックス周囲の余白を乗数として指定します。(デフォルト:1.0) | FLOAT | はい | 1.0 から 2.0(ステップ 0.01) | +| `grow_mask` | クロップ前にマスクをこのピクセル数だけ拡大または縮小します。正の値はマスクを拡大し、負の値は縮小します。(デフォルト:0) | INT | はい | -32 から 32(ステップ 1) | +| `background` | マスクされた被写体の背後に配置する背景色。(デフォルト:#000000) | COLOR | はい | — | + +注:クロップ領域はマスクの境界ボックスを中心とし、そのアスペクト比は `width` / `height` に一致します。ノードは反転したマスク(境界に前景ピクセル、中央に背景)を自動的に検出して補正します。マスクに前景ピクセルがない場合、ノードは反転マスクを試行します。それも空の場合は警告をログに記録し、画像全体をクロップします。マスクのバッチサイズが画像のバッチサイズと一致せず、単一マスクでもない場合はエラーが発生します。 + +## 出力 + +| 出力名 | 説明 | データ型 | +|-------------|-------------|-----------| +| `images` | クロップされた合成画像(マスクされた被写体を選択した背景色の上に配置)、`width` x `height` にリサイズされます。バッチサイズは入力画像バッチと一致します。 | IMAGE | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ImageCropToMask/ja.md) + +--- +**Source fingerprint (SHA-256):** `fcc14b5db7318699526dd544d404f78f9d1ab362b73769276f113f2b1062b214` diff --git a/comfyui_embedded_docs/docs/ImageCropToMask/ko.md b/comfyui_embedded_docs/docs/ImageCropToMask/ko.md new file mode 100644 index 000000000..c2d5192fb --- /dev/null +++ b/comfyui_embedded_docs/docs/ImageCropToMask/ko.md @@ -0,0 +1,28 @@ +# ImageCropToMask + +이미지를 마스크의 경계 상자로 크롭하여 단색 배경 위에 중앙 정렬된 피사체를 생성합니다. 이 노드는 마스킹된 이미지를 선택한 배경 위에 합성하고 결과를 지정된 출력 크기로 조정하므로, 고정 해상도에서 중앙에 위치하고 배경이 없는 피사체를 기대하는 3D 파이프라인에 적합합니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `images` | 크롭할 입력 이미지 또는 이미지 배치입니다. | IMAGE | 예 | — | +| `masks` | 피사체 영역을 정의하는 마스크 또는 마스크 배치입니다. 단일 마스크는 모든 이미지에 적용되며, 그렇지 않은 경우 마스크 배치 크기가 이미지 배치 크기와 일치해야 합니다. 마스크 해상도가 이미지 해상도와 다른 경우 마스크가 자동으로 일치하도록 크기가 조정됩니다. | MASK | 예 | — | +| `width` | 출력 너비(픽셀)입니다. (기본값: 1024) | INT | 예 | 64 ~ 4096 (단계: 8) | +| `height` | 출력 높이(픽셀)입니다. (기본값: 1024) | INT | 예 | 64 ~ 4096 (단계: 8) | +| `pad_factor` | 마스크 경계 상자 주변의 추가 여백 배율입니다. (기본값: 1.0) | FLOAT | 예 | 1.0 ~ 2.0 (단계: 0.01) | +| `grow_mask` | 크롭 전에 마스크를 이 픽셀 수만큼 확장하거나 축소합니다. 양수 값은 마스크를 확장하고 음수 값은 축소합니다. (기본값: 0) | INT | 예 | -32 ~ 32 (단계: 1) | +| `background` | 마스킹된 피사체 뒤의 배경색입니다. (기본값: #000000) | COLOR | 예 | — | + +참고: 크롭 영역은 마스크의 경계 상자를 기준으로 중앙에 위치하며, 가로 세로 비율은 `width` / `height`와 일치합니다. 노드는 반전된 마스크(테두리를 따라 전경 픽셀이 있고 중앙이 배경인 경우)를 자동으로 감지하여 수정합니다. 마스크에 전경 픽셀이 없으면 노드는 반전된 마스크를 시도하고, 그것도 비어 있으면 경고를 기록하고 전체 이미지를 크롭합니다. 마스크 배치 크기가 이미지 배치 크기와 일치하지 않고 단일 마스크도 아닌 경우 오류가 발생합니다. + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `images` | 선택한 배경색 위에 마스킹된 피사체가 있는 크롭된 합성 이미지로, `width` x `height`로 크기가 조정됩니다. 배치 크기는 입력 이미지 배치와 일치합니다. | IMAGE | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ImageCropToMask/ko.md) + +--- +**Source fingerprint (SHA-256):** `fcc14b5db7318699526dd544d404f78f9d1ab362b73769276f113f2b1062b214` diff --git a/comfyui_embedded_docs/docs/ImageCropToMask/pt-BR.md b/comfyui_embedded_docs/docs/ImageCropToMask/pt-BR.md new file mode 100644 index 000000000..8dc860712 --- /dev/null +++ b/comfyui_embedded_docs/docs/ImageCropToMask/pt-BR.md @@ -0,0 +1,26 @@ +# ImageCropToMask + +## Entradas + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Faixa | +|-----------|-------------|-----------|----------|-------| +| `images` | A imagem de entrada ou lote de imagens a serem recortadas. | IMAGE | Sim | — | +| `masks` | A máscara ou lote de máscaras que define a área do assunto. Uma única máscara é aplicada a todas as imagens; caso contrário, o tamanho do lote de máscaras deve corresponder ao tamanho do lote de imagens. Se a resolução da máscara for diferente da resolução da imagem, a máscara é redimensionada automaticamente para corresponder. | MASK | Sim | — | +| `width` | Largura da saída em pixels. (padrão: 1024) | INT | Sim | 64 to 4096 (step 8) | +| `height` | Altura da saída em pixels. (padrão: 1024) | INT | Sim | 64 to 4096 (step 8) | +| `pad_factor` | Margem extra ao redor da caixa delimitadora da máscara como um multiplicador. (padrão: 1.0) | FLOAT | Sim | 1.0 to 2.0 (step 0.01) | +| `grow_mask` | Aumenta ou diminui a máscara por este número de pixels antes do recorte. Valores positivos expandem a máscara, valores negativos a reduzem. (padrão: 0) | INT | Sim | -32 to 32 (step 1) | +| `background` | Cor de fundo atrás do assunto mascarado. (padrão: #000000) | COLOR | Sim | — | + +Nota: A região de recorte é centralizada na caixa delimitadora da máscara e sua proporção corresponde a `width` / `height`. O nó detecta e corrige automaticamente uma máscara invertida (pixels de primeiro plano nas bordas, fundo no centro). Se a máscara não contiver pixels de primeiro plano, o nó tenta a máscara invertida; se esta também estiver vazia, ele registra um aviso e recorta a imagem inteira. Um erro é gerado quando o tamanho do lote de máscaras não corresponde ao tamanho do lote de imagens e não é uma única máscara. + +## Saídas + +| Nome da Saída | Descrição | Tipo de Dados | +|-------------|-------------|-----------| +| `images` | As imagens compostas recortadas (assunto mascarado sobre a cor de fundo escolhida), redimensionadas para `width` x `height`. O tamanho do lote corresponde ao lote de imagens de entrada. | IMAGE | + +> Esta documentação foi gerada por IA. Se você encontrar erros ou tiver sugestões de melhoria, sinta-se à vontade para contribuir! [Editar no GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ImageCropToMask/pt-BR.md) + +--- +**Source fingerprint (SHA-256):** `fcc14b5db7318699526dd544d404f78f9d1ab362b73769276f113f2b1062b214` diff --git a/comfyui_embedded_docs/docs/ImageCropToMask/ru.md b/comfyui_embedded_docs/docs/ImageCropToMask/ru.md new file mode 100644 index 000000000..acab38480 --- /dev/null +++ b/comfyui_embedded_docs/docs/ImageCropToMask/ru.md @@ -0,0 +1,28 @@ +# ImageCropToMask + +Обрезает изображение по ограничивающей рамке его маски, создавая центрированный объект на сплошном фоновом цвете. Узел компонует изображение с маской поверх выбранного фона и изменяет размер результата до указанных выходных размеров, что делает его подходящим для 3D-конвейеров, ожидающих центрированный объект без фона с фиксированным разрешением. + +## Входы + +| Параметр | Описание | Тип данных | Обязательный | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `images` | Входное изображение или пакет изображений для обрезки. | IMAGE | Да | — | +| `masks` | Маска или пакет масок, определяющих область объекта. Одна маска применяется ко всем изображениям; в противном случае размер пакета масок должен соответствовать размеру пакета изображений. Если разрешение маски отличается от разрешения изображения, маска автоматически изменяется для соответствия. | MASK | Да | — | +| `width` | Выходная ширина в пикселях. (по умолчанию: 1024) | INT | Да | 64 to 4096 (step 8) | +| `height` | Выходная высота в пикселях. (по умолчанию: 1024) | INT | Да | 64 to 4096 (step 8) | +| `pad_factor` | Дополнительное поле вокруг ограничивающей рамки маски в виде множителя. (по умолчанию: 1.0) | FLOAT | Да | 1.0 to 2.0 (step 0.01) | +| `grow_mask` | Увеличить или уменьшить маску на указанное количество пикселей перед обрезкой. Положительные значения расширяют маску, отрицательные — сужают. (по умолчанию: 0) | INT | Да | -32 to 32 (step 1) | +| `background` | Цвет фона за объектом с маской. (по умолчанию: #000000) | COLOR | Да | — | + +Примечание. Область обрезки центрируется по ограничивающей рамке маски, и ее соотношение сторон соответствует `width` / `height`. Узел автоматически обнаруживает и исправляет инвертированную маску (пиксели переднего плана по краям, фон в центре). Если маска не содержит пикселей переднего плана, узел пробует инвертированную маску; если она также пуста, он выводит предупреждение и обрезает все изображение. Ошибка возникает, когда размер пакета масок не соответствует размеру пакета изображений и при этом не является одной маской. + +## Выходы + +| Имя выхода | Описание | Тип данных | +|-------------|-------------|-----------| +| `images` | Обрезанные составные изображения (объект с маской поверх выбранного фонового цвета), измененные до размера `width` x `height`. Размер пакета соответствует входному пакету изображений. | IMAGE | + +> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ImageCropToMask/ru.md) + +--- +**Source fingerprint (SHA-256):** `fcc14b5db7318699526dd544d404f78f9d1ab362b73769276f113f2b1062b214` diff --git a/comfyui_embedded_docs/docs/ImageCropToMask/tr.md b/comfyui_embedded_docs/docs/ImageCropToMask/tr.md new file mode 100644 index 000000000..3c8a116e8 --- /dev/null +++ b/comfyui_embedded_docs/docs/ImageCropToMask/tr.md @@ -0,0 +1,28 @@ +# ImageCropToMask + +Bir görüntüyü maskesinin sınırlayıcı kutusuna göre kırpar ve düz bir arka plan rengi üzerinde ortalanmış bir nesne üretir. Düğüm, maskelenmiş görüntüyü seçilen arka plan üzerine yerleştirir ve sonucu belirtilen çıktı boyutlarına yeniden boyutlandırarak sabit çözünürlükte ortalanmış, arka plandan arındırılmış bir nesne bekleyen 3B işlem hatları için uygun hale getirir. + +## Girdiler + +| Parametre | Açıklama | Veri Türü | Zorunlu | Aralık | +|-----------|-------------|-----------|----------|-------| +| `images` | Kırpılacak giriş görüntüsü veya görüntü dizisi. | IMAGE | Evet | — | +| `masks` | Nesne alanını tanımlayan maske veya maske dizisi. Tek bir maske tüm görüntülere uygulanır; aksi takdirde maske dizisi boyutu, görüntü dizisi boyutuyla eşleşmelidir. Maske çözünürlüğü görüntü çözünürlüğünden farklıysa, maske otomatik olarak eşleşecek şekilde yeniden boyutlandırılır. | MASK | Evet | — | +| `width` | Piksel cinsinden çıktı genişliği. (varsayılan: 1024) | INT | Evet | 64 to 4096 (step 8) | +| `height` | Piksel cinsinden çıktı yüksekliği. (varsayılan: 1024) | INT | Evet | 64 to 4096 (step 8) | +| `pad_factor` | Maske sınırlayıcı kutusu çevresinde çarpan olarak ek kenar boşluğu. (varsayılan: 1.0) | FLOAT | Evet | 1.0 to 2.0 (step 0.01) | +| `grow_mask` | Kırpmadan önce maskeyi bu kadar piksel büyütün veya küçültün. Pozitif değerler maskeyi genişletir, negatif değerler küçültür. (varsayılan: 0) | INT | Evet | -32 to 32 (step 1) | +| `background` | Maskelenmiş nesnenin arkasındaki arka plan rengi. (varsayılan: #000000) | COLOR | Evet | — | + +Not: Kırpma bölgesi, maskenin sınırlayıcı kutusuna ortalanır ve en-boy oranı `width` / `height` ile eşleşir. Düğüm, ters çevrilmiş bir maskeyi otomatik olarak algılar ve düzeltir (kenarlarda ön plan pikselleri, merkezde arka plan). Maske hiçbir ön plan pikseli içermiyorsa, düğüm ters çevrilmiş maskeyi dener; o da boşsa, bir uyarı günlüğe yazılır ve görüntünün tamamı kırpılır. Maske dizisi boyutu, görüntü dizisi boyutuyla eşleşmiyorsa ve tek bir maske değilse bir hata oluşturulur. + +## Çıktılar + +| Çıktı Adı | Açıklama | Veri Türü | +|-------------|-------------|-----------| +| `images` | Kırpılmış birleşik görüntüler (seçilen arka plan rengi üzerinde maskelenmiş nesne), `width` x `height` boyutuna yeniden boyutlandırılır. Dizi boyutu, giriş görüntü dizisiyle eşleşir. | IMAGE | + +> Bu belge yapay zeka tarafından oluşturulmuştur. Herhangi bir hata bulursanız veya iyileştirme önerileriniz varsa, katkıda bulunmaktan çekinmeyin! [GitHub'da Düzenle](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ImageCropToMask/tr.md) + +--- +**Source fingerprint (SHA-256):** `fcc14b5db7318699526dd544d404f78f9d1ab362b73769276f113f2b1062b214` diff --git a/comfyui_embedded_docs/docs/ImageCropToMask/zh-TW.md b/comfyui_embedded_docs/docs/ImageCropToMask/zh-TW.md new file mode 100644 index 000000000..35c076534 --- /dev/null +++ b/comfyui_embedded_docs/docs/ImageCropToMask/zh-TW.md @@ -0,0 +1,28 @@ +# ImageCropToMask + +將影像裁切至其遮罩的邊界框,產生一個位於純色背景上、置中的主體。此節點會將遮罩後的影像合成在所選背景上,並將結果調整為指定的輸出尺寸,使其適用於需要固定解析度下、置中且無背景主體的 3D 管線。 + +## 輸入 + +| 參數 | 說明 | 資料型態 | 必填 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `images` | 要裁切的輸入影像或影像批次。 | IMAGE | 是 | — | +| `masks` | 定義主體區域的遮罩或遮罩批次。單一遮罩會套用至所有影像;否則遮罩批次大小必須與影像批次大小相符。若遮罩解析度與影像解析度不同,遮罩會自動調整大小以相符。 | MASK | 是 | — | +| `width` | 輸出寬度(像素)。(預設值:1024) | INT | 是 | 64 至 4096(步長 8) | +| `height` | 輸出高度(像素)。(預設值:1024) | INT | 是 | 64 至 4096(步長 8) | +| `pad_factor` | 遮罩邊界框周圍的額外邊距(以倍數表示)。(預設值:1.0) | FLOAT | 是 | 1.0 至 2.0(步長 0.01) | +| `grow_mask` | 在裁切前將遮罩擴大或縮小此像素數。正值擴大遮罩,負值縮小遮罩。(預設值:0) | INT | 是 | -32 至 32(步長 1) | +| `background` | 遮罩主體後方的背景顏色。(預設值:#000000) | COLOR | 是 | — | + +注意:裁切區域以遮罩的邊界框為中心,其長寬比與 `width` / `height` 相符。節點會自動偵測並修正反向遮罩(前景像素位於邊緣,背景位於中央)。若遮罩不包含任何前景像素,節點會嘗試反向遮罩;若仍為空白,則會記錄警告並裁切整個影像。當遮罩批次大小與影像批次大小不符且不是單一遮罩時,會引發錯誤。 + +## 輸出 + +| 輸出名稱 | 說明 | 資料型態 | +|-------------|-------------|-----------| +| `images` | 裁切後的合成影像(遮罩主體疊加在所選背景顏色上),已調整為 `width` x `height`。批次大小與輸入影像批次相符。 | IMAGE | + +> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ImageCropToMask/zh-TW.md) + +--- +**Source fingerprint (SHA-256):** `fcc14b5db7318699526dd544d404f78f9d1ab362b73769276f113f2b1062b214` diff --git a/comfyui_embedded_docs/docs/ImageCropToMask/zh.md b/comfyui_embedded_docs/docs/ImageCropToMask/zh.md new file mode 100644 index 000000000..1beb279fe --- /dev/null +++ b/comfyui_embedded_docs/docs/ImageCropToMask/zh.md @@ -0,0 +1,28 @@ +# ImageCropToMask + +将图像裁剪到其掩码的边界框,在纯色背景上生成居中的主体。该节点将掩码图像合成到所选背景上,并将结果调整到指定的输出尺寸,使其适用于需要固定分辨率下居中、无背景主体的 3D 流程。 + +## 输入 + +| 参数 | 描述 | 数据类型 | 必填 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `images` | 要裁剪的输入图像或图像批次。 | IMAGE | 是 | — | +| `masks` | 定义主体区域的掩码或掩码批次。单个掩码将应用于所有图像;否则掩码批次大小必须与图像批次大小匹配。如果掩码分辨率与图像分辨率不同,掩码会自动调整大小以匹配。 | MASK | 是 | — | +| `width` | 输出宽度(像素)。(默认值:1024) | INT | 是 | 64 至 4096(步长 8) | +| `height` | 输出高度(像素)。(默认值:1024) | INT | 是 | 64 至 4096(步长 8) | +| `pad_factor` | 掩码边界框周围的额外边距乘数。(默认值:1.0) | FLOAT | 是 | 1.0 至 2.0(步长 0.01) | +| `grow_mask` | 在裁剪前将掩码扩展或收缩这么多像素。正值扩大掩码,负值缩小掩码。(默认值:0) | INT | 是 | -32 至 32(步长 1) | +| `background` | 掩码主体后面的背景颜色。(默认值:#000000) | COLOR | 是 | — | + +注意:裁剪区域以掩码的边界框为中心,其宽高比与 `width` / `height` 匹配。该节点会自动检测并纠正反相的掩码(前景像素位于边缘,背景位于中心)。如果掩码不包含任何前景像素,节点会尝试反相后的掩码;如果反相后仍然为空,则记录警告并裁剪整个图像。当掩码批次大小与图像批次大小不匹配且不是单个掩码时,会引发错误。 + +## 输出 + +| 输出名称 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `images` | 裁剪后的合成图像(掩码主体叠加在所选背景颜色上),并调整为 `width` x `height`。批次大小与输入图像批次一致。 | IMAGE | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ImageCropToMask/zh.md) + +--- +**Source fingerprint (SHA-256):** `fcc14b5db7318699526dd544d404f78f9d1ab362b73769276f113f2b1062b214` diff --git a/comfyui_embedded_docs/docs/ImageHistogram/en.md b/comfyui_embedded_docs/docs/ImageHistogram/en.md index fcef99027..5cf179cef 100644 --- a/comfyui_embedded_docs/docs/ImageHistogram/en.md +++ b/comfyui_embedded_docs/docs/ImageHistogram/en.md @@ -1,6 +1,6 @@ # Image Histogram -The ImageHistogram node analyzes the color distribution of an input image. It calculates and outputs several histograms, which are graphs showing how many pixels in the image have each possible intensity value. It generates separate histograms for the red, green, and blue color channels, a composite RGB histogram, and a luminance histogram based on a standard brightness formula. +The ImageHistogram node analyzes the color distribution of an input image. It calculates and outputs several histograms, which are graphs showing how many pixels in the image have each possible intensity value. It generates separate histograms for the red, green, and blue color channels, a composite RGB histogram, and a luminance histogram based on a standard brightness formula. Each histogram contains 256 bins, covering intensity levels from 0 to 255. ## Inputs @@ -21,4 +21,4 @@ The ImageHistogram node analyzes the color distribution of an input image. It ca > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ImageHistogram/en.md) --- -**Source fingerprint (SHA-256):** `026a470129a49794bc1ddcdd3ecd8e8ad95b43fc94db4387f0e2de365b305879` +**Source fingerprint (SHA-256):** `5020f5cedd325250a207a00950011f4b6dc19ddfe4d172665ffca4982731dd5e` diff --git a/comfyui_embedded_docs/docs/ImageOnlyCheckpointSave/en.md b/comfyui_embedded_docs/docs/ImageOnlyCheckpointSave/en.md index f1bc955b6..81893caab 100644 --- a/comfyui_embedded_docs/docs/ImageOnlyCheckpointSave/en.md +++ b/comfyui_embedded_docs/docs/ImageOnlyCheckpointSave/en.md @@ -11,7 +11,7 @@ The ImageOnlyCheckpointSave node saves a checkpoint file containing a model, CLI | `vae` | The VAE (Variational Autoencoder) to be saved in the checkpoint | VAE | Yes | - | | `filename_prefix` | The prefix for the output filename (default: "checkpoints/ComfyUI") | STRING | Yes | - | | `prompt` | Hidden parameter for workflow prompt data | PROMPT | No | - | -| `extra_pnginfo` | Hidden parameter for additional PNG metadata | EXTRA_PNGINFO | No | - | +| `extra_pnginfo` | Additional PNG metadata | EXTRA_PNGINFO | No | - | ## Outputs @@ -22,4 +22,4 @@ The ImageOnlyCheckpointSave node saves a checkpoint file containing a model, CLI > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ImageOnlyCheckpointSave/en.md) --- -**Source fingerprint (SHA-256):** `d2a26933f0e2fcccf3c57f50038fb40ef5b23d00ccdd2e1d215b3cb78203b9fd` +**Source fingerprint (SHA-256):** `8ff4b3a78d8da523eaa5f784f847e954ba73b4d6037e748dcce592b447fcdee9` diff --git a/comfyui_embedded_docs/docs/InstructPixToPixConditioning/en.md b/comfyui_embedded_docs/docs/InstructPixToPixConditioning/en.md index c2963feae..731a636aa 100644 --- a/comfyui_embedded_docs/docs/InstructPixToPixConditioning/en.md +++ b/comfyui_embedded_docs/docs/InstructPixToPixConditioning/en.md @@ -11,7 +11,7 @@ The InstructPixToPixConditioning node prepares conditioning data for InstructPix | `vae` | VAE model used for encoding input images into latent representations | VAE | Yes | - | | `pixels` | Input image to be processed and encoded into latent space | IMAGE | Yes | - | -**Note:** The input image dimensions are automatically adjusted by cropping to the nearest multiple of 8 pixels in both width and height to ensure compatibility with the VAE encoding process. +**Note:** The input image dimensions are automatically adjusted by center-cropping to multiples of 8 pixels in both width and height to ensure compatibility with the VAE encoding process. ## Outputs @@ -24,4 +24,4 @@ The InstructPixToPixConditioning node prepares conditioning data for InstructPix > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/InstructPixToPixConditioning/en.md) --- -**Source fingerprint (SHA-256):** `ac48cc0d3c77f1e399b615068291ae60801f36a6c4e1ae47d624fbc08e0b7264` +**Source fingerprint (SHA-256):** `e9a5a05cdeafe9337ca2033111f1ad4f7314fa33d71a4764f62919857efc79f4` diff --git a/comfyui_embedded_docs/docs/InvertBooleanNode/en.md b/comfyui_embedded_docs/docs/InvertBooleanNode/en.md index ef3c0f082..786e85e90 100644 --- a/comfyui_embedded_docs/docs/InvertBooleanNode/en.md +++ b/comfyui_embedded_docs/docs/InvertBooleanNode/en.md @@ -5,16 +5,16 @@ This node takes a single boolean (true/false) input and outputs the opposite val ## Inputs | Parameter | Description | Data Type | Required | Range | -| --- | --- | --- | --- | --- | +|-----------|-------------|-----------|----------|-------| | `boolean` | The input boolean value to be inverted. | BOOLEAN | Yes | `true`
`false` | ## Outputs | Output Name | Description | Data Type | -| --- | --- | --- | +|-------------|-------------|-----------| | `output` | The inverted boolean value. | BOOLEAN | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/InvertBooleanNode/en.md) --- -**Source fingerprint (SHA-256):** `c512b0f8847c971776c2aebe0c6053ca17a66f756b1b90c803d1a6ef9d3d0ad0` +**Source fingerprint (SHA-256):** `7e28bb375a25249bc237870bf281321375c4be7b7782b217b3e0f70afc2e0c53` diff --git a/comfyui_embedded_docs/docs/Kandinsky5ImageToVideo/en.md b/comfyui_embedded_docs/docs/Kandinsky5ImageToVideo/en.md index ac60631e1..f1a5e6478 100644 --- a/comfyui_embedded_docs/docs/Kandinsky5ImageToVideo/en.md +++ b/comfyui_embedded_docs/docs/Kandinsky5ImageToVideo/en.md @@ -9,13 +9,13 @@ The Kandinsky5ImageToVideo node prepares conditioning and latent space data for | `positive` | The positive conditioning prompts to guide the video generation. | CONDITIONING | Yes | N/A | | `negative` | The negative conditioning prompts to steer the video generation away from certain concepts. | CONDITIONING | Yes | N/A | | `vae` | The VAE model used to encode the optional starting image into the latent space. | VAE | Yes | N/A | -| `width` | The width of the output video in pixels (default: 768). | INT | No | 16 to 8192 (step 16) | -| `height` | The height of the output video in pixels (default: 512). | INT | No | 16 to 8192 (step 16) | -| `length` | The number of frames in the video (default: 121). | INT | No | 1 to 8192 (step 4) | -| `batch_size` | The number of video sequences to generate simultaneously (default: 1). | INT | No | 1 to 4096 | -| `start_image` | An optional starting image. If provided, it is encoded and used to replace the noisy start of the model's output latents. | IMAGE | No | N/A | +| `width` | The width of the output video in pixels (default: 768). | INT | Yes | 16 to 16384 (step 16) | +| `height` | The height of the output video in pixels (default: 512). | INT | Yes | 16 to 16384 (step 16) | +| `length` | The number of frames in the video (default: 121). | INT | Yes | 1 to 16384 (step 4) | +| `batch_size` | The number of video sequences to generate simultaneously (default: 1). | INT | Yes | 1 to 4096 | +| `start_image` | An optional starting image or batch of frames. If provided, it is encoded and used to replace the noisy start of the model's output latents. | IMAGE | No | N/A | -**Note:** When a `start_image` is provided, it is automatically resized to match the specified `width` and `height` using bilinear interpolation. The first `length` frames of the image batch are used for encoding. The encoded latent is then injected into both the `positive` and `negative` conditioning to guide the video's initial appearance. +**Note:** When a `start_image` is provided, it is automatically resized to match the specified `width` and `height` using bilinear interpolation. Only the first `length` frames of the image batch are used for encoding; any additional frames are ignored. If the image batch has fewer than `length` frames, only those frames are used. Only the RGB channels of the image are encoded. The encoded latent is then injected into both the `positive` and `negative` conditioning to guide the video's initial appearance, and the clean encoded frames replace the noisy start of the model's output latents. ## Outputs @@ -23,10 +23,10 @@ The Kandinsky5ImageToVideo node prepares conditioning and latent space data for | --- | --- | --- | | `positive` | The modified positive conditioning, potentially updated with encoded start image data. | CONDITIONING | | `negative` | The modified negative conditioning, potentially updated with encoded start image data. | CONDITIONING | -| `latent` | An empty video latent tensor with zeros, shaped for the specified dimensions. | LATENT | -| `cond_latent` | The clean, encoded latent representation of the provided start images. This is used internally to replace the noisy beginning of the generated video latents. | LATENT | +| `latent` | Empty video latent. A latent tensor filled with zeros, shaped for the specified dimensions. | LATENT | +| `cond_latent` | Clean encoded start images, used to replace the noisy start of the model output latents. Empty when no `start_image` is provided. | LATENT | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Kandinsky5ImageToVideo/en.md) --- -**Source fingerprint (SHA-256):** `c171187b89f102d608ddee9dc981e56674d62b02d936b3cf4dee3ce86760fd0e` +**Source fingerprint (SHA-256):** `7212f0ea912578d3b72dddf1333a20054a881e3f22c2b8abd9645fc21e75a08b` diff --git a/comfyui_embedded_docs/docs/KlingImage2VideoNode/en.md b/comfyui_embedded_docs/docs/KlingImage2VideoNode/en.md index 340610a44..05f29b1df 100644 --- a/comfyui_embedded_docs/docs/KlingImage2VideoNode/en.md +++ b/comfyui_embedded_docs/docs/KlingImage2VideoNode/en.md @@ -1,17 +1,17 @@ -# Kling Image to Video Node +# Kling Image(First Frame) to Video -The Kling Image to Video Node generates a video from a starting reference image using text prompts. It takes an image as the first frame and creates a video sequence based on positive and negative text descriptions, with configurable options for model, duration, aspect ratio, and generation mode. +The Kling Image to Video Node generates a short video using a starting image as the first frame. It combines the image with text prompts and generation settings, then returns the resulting video along with its ID and duration. ## Inputs | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| | `start_frame` | The reference image used to generate the video. The image must be at least 300x300 pixels and have an aspect ratio between 1:2.5 and 2.5:1. | IMAGE | Yes | - | -| `prompt` | Positive text prompt. Maximum 500 characters. | STRING | Yes | - | -| `negative_prompt` | Negative text prompt. Maximum 500 characters. | STRING | Yes | - | -| `model_name` | The model used for video generation (default: `"kling-v2-master"`). | COMBO | Yes | `"kling-v2-master"`
`"kling-v2-1-master"`
`"kling-v2-5-turbo"`
`"kling-v2-1"`
`"kling-v1-6"`
`"kling-v1-5"`
`"kling-v1-4"`
`"kling-v1-0"` | +| `prompt` | Positive text prompt. Must not be empty. Maximum 500 characters. | STRING | Yes | - | +| `negative_prompt` | Negative text prompt. Maximum 500 characters. Leave empty if not used. | STRING | Yes | - | +| `model_name` | The model used for video generation (default: `"kling-v2-5-turbo"`). | COMBO | Yes | `"kling-v2-5-turbo"` | | `cfg_scale` | Controls how closely the video follows the prompt. Higher values mean stronger adherence (default: 0.8). | FLOAT | Yes | 0.0 to 1.0 | -| `mode` | The generation mode. `"std"` is standard quality, `"pro"` is higher quality (default: `"std"`). Note: When using the `kling-v2-5-turbo` model, `"std"` mode is not supported and will be automatically switched to `"pro"`. | COMBO | Yes | `"std"`
`"pro"` | +| `mode` | The generation mode (default: `"pro"`). | COMBO | Yes | `"pro"` | | `aspect_ratio` | The aspect ratio of the generated video (default: `"16:9"`). | COMBO | Yes | `"16:9"`
`"9:16"`
`"1:1"` | | `duration` | The duration of the generated video in seconds (default: `"5"`). | COMBO | Yes | `"5"`
`"10"` | @@ -26,4 +26,4 @@ The Kling Image to Video Node generates a video from a starting reference image > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/KlingImage2VideoNode/en.md) --- -**Source fingerprint (SHA-256):** `e5731be52e00b6e80a6323417f927d0d6ba5e8147aa149f7ec9dd902d77bc70d` +**Source fingerprint (SHA-256):** `f4a461819bc05f92d867bddcc78a66ad7beaa10707ef8cae3e7eb9e6f72c890a` diff --git a/comfyui_embedded_docs/docs/KlingImageGenerationNode/en.md b/comfyui_embedded_docs/docs/KlingImageGenerationNode/en.md index 17a6a0fda..8801d6b93 100644 --- a/comfyui_embedded_docs/docs/KlingImageGenerationNode/en.md +++ b/comfyui_embedded_docs/docs/KlingImageGenerationNode/en.md @@ -1,4 +1,4 @@ -# Kling 3.0 Image Generation Node +# Kling 3.0 Image Kling Image Generation Node generates images from text prompts with the option to use a reference image for guidance. It creates one or more images based on your text description and reference settings, then returns the generated images as output. @@ -11,7 +11,7 @@ Kling Image Generation Node generates images from text prompts with the option t | `image_type` | Image reference type selection (advanced). Required when a reference image is provided. | COMBO | Yes | `"subject_reference"`
`"style_reference"` | | `image_fidelity` | Reference intensity for user-uploaded images (default: 0.5, advanced) | FLOAT | Yes | 0.0 - 1.0 | | `human_fidelity` | Subject reference similarity (default: 0.45, advanced) | FLOAT | Yes | 0.0 - 1.0 | -| `model_name` | Model selection for image generation (default: "kling-v3") | COMBO | Yes | `"kling-v3"`
`"kling-v2"`
`"kling-v1-5"` | +| `model_name` | Model selection for image generation (default: "kling-v3") | COMBO | Yes | `"kling-v3"` | | `aspect_ratio` | Aspect ratio for generated images (default: "16:9") | COMBO | Yes | `"16:9"`
`"9:16"`
`"1:1"`
`"4:3"`
`"3:4"`
`"21:9"`
`"9:21"` | | `n` | Number of generated images (default: 1) | INT | Yes | 1 - 9 | | `image` | Optional reference image | IMAGE | No | - | @@ -19,18 +19,18 @@ Kling Image Generation Node generates images from text prompts with the option t **Parameter Constraints:** -- The `image` parameter is optional. When a reference image is provided, the `image_type` parameter must be set to either `"subject_reference"` or `"style_reference"`. -- When no reference image is provided, the `image_type`, `image_fidelity`, and `human_fidelity` parameters are not used. -- Prompt and negative prompt have a maximum length of 500 characters. +- The `image` parameter is optional. When a reference image is provided, the `image_type` parameter determines whether the reference is used as a subject reference or a style reference. +- When no reference image is provided, the reference-related settings (`image_type`, `image_fidelity`, `human_fidelity`) have no effect on the result. +- `prompt` and `negative_prompt` have a maximum length of 500 characters. - The `seed` parameter is optional and does not guarantee deterministic results. ## Outputs | Output Name | Description | Data Type | |-------------|-------------|-----------| -| `output` | Generated image(s) based on the input parameters | IMAGE | +| `output` | Generated image(s) based on the input parameters. When `n` is greater than 1, multiple images are returned as a batch. | IMAGE | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/KlingImageGenerationNode/en.md) --- -**Source fingerprint (SHA-256):** `65bd6ea842877a9af9a7b554fe020418291d06ae6cc35e86127ab524aadd48c1` +**Source fingerprint (SHA-256):** `fd344519346f63ac03975b93f03725749ed9697245d6dfa2378884c59a5325cd` diff --git a/comfyui_embedded_docs/docs/KlingOmniProFirstLastFrameNode/en.md b/comfyui_embedded_docs/docs/KlingOmniProFirstLastFrameNode/en.md index 21b4a6f80..4c4a03938 100644 --- a/comfyui_embedded_docs/docs/KlingOmniProFirstLastFrameNode/en.md +++ b/comfyui_embedded_docs/docs/KlingOmniProFirstLastFrameNode/en.md @@ -13,7 +13,7 @@ This node uses the latest Kling AI model to generate a video from a start frame, | `end_frame` | An optional end frame for the video. This cannot be used simultaneously with `reference_images`. Does not work with storyboards. | IMAGE | No | - | | `reference_images` | Up to 6 additional reference images. | IMAGE | No | - | | `resolution` | The output resolution for the generated video (default: "1080p"). | COMBO | No | `"4k"`
`"1080p"`
`"720p"` | -| `storyboards` | Generate a series of video segments with individual prompts and durations. Only supported for `kling-v3-omni`. When enabled, each storyboard requires a prompt and duration input. | DYNAMIC_COMBO | No | `"disabled"`
`"1 storyboard"`
`"2 storyboards"`
`"3 storyboards"`
`"4 storyboards"`
`"5 storyboards"`
`"6 storyboards"` | +| `storyboards` | Generate a series of video segments with individual prompts and durations. Only supported for `kling-v3-omni`. | DYNAMIC_COMBO | No | `"disabled"`
`"1 storyboard"`
`"2 storyboards"`
`"3 storyboards"`
`"4 storyboards"`
`"5 storyboards"`
`"6 storyboards"` | | `generate_audio` | Generate audio for the video (default: False). Only supported for `kling-v3-omni`. | BOOLEAN | No | True / False | | `seed` | Seed controls whether the node should re-run; results are non-deterministic regardless of seed (default: 0). | INT | No | 0 to 2147483647 | diff --git a/comfyui_embedded_docs/docs/KlingOmniProImageToVideoNode/en.md b/comfyui_embedded_docs/docs/KlingOmniProImageToVideoNode/en.md index 31b878066..cc9bf91b1 100644 --- a/comfyui_embedded_docs/docs/KlingOmniProImageToVideoNode/en.md +++ b/comfyui_embedded_docs/docs/KlingOmniProImageToVideoNode/en.md @@ -8,13 +8,13 @@ This node uses the Kling AI model to generate a video based on a text prompt and | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `model_name` | The specific Kling model to use for video generation (default: "kling-v3-omni"). | COMBO | Yes | `"kling-v3-omni"`
`"kling-video-o1"` | -| `prompt` | A text prompt describing the video content. This can include both positive and negative descriptions. Ignored when storyboards are enabled. Placeholders such as `@image` or `@video` (optionally numbered) are automatically converted to the API-compatible format. Must be between 1 and 2500 characters (can be empty when storyboards are enabled). | STRING | Yes | - | +| `model_name` | The specific Kling model to use for video generation (default: `"kling-v3-omni"`). | COMBO | Yes | `"kling-v3-omni"`
`"kling-video-o1"` | +| `prompt` | A text prompt describing the video content. This can include both positive and negative descriptions. Ignored when storyboards are enabled. Placeholders such as `@image` or `@video` (optionally numbered) are automatically converted to the API-compatible format. Must be between 1 and 2500 characters (can be empty when storyboards are enabled). | STRING | Yes | 1 to 2500 characters | | `aspect_ratio` | The desired aspect ratio for the generated video. | COMBO | Yes | `"16:9"`
`"9:16"`
`"1:1"` | | `duration` | The length of the video in seconds, adjusted with a slider (default: 5). | INT | Yes | 3 to 15 | | `reference_images` | Up to 7 reference images. Each image must be at least 300x300 pixels and have an aspect ratio between 1:2.5 and 2.5:1. | IMAGE | Yes | 1 to 7 images | -| `resolution` | The output resolution of the video (default: "1080p"). | COMBO | No | `"4k"`
`"1080p"`
`"720p"` | -| `storyboards` | Generate a series of video segments with individual prompts and durations. Only supported for `kling-v3-omni`. When enabled, the global `prompt` is ignored, and the total duration of all storyboard segments must equal the global `duration` (default: "disabled"). | DYNAMIC_COMBO | No | `"disabled"`
`"1 storyboard"`
`"2 storyboards"`
`"3 storyboards"`
`"4 storyboards"`
`"5 storyboards"`
`"6 storyboards"` | +| `resolution` | The output resolution of the video (default: `"1080p"`). | COMBO | No | `"4k"`
`"1080p"`
`"720p"` | +| `storyboards` | Generate a series of video segments with individual prompts and durations. Only supported for `kling-v3-omni`. When enabled, the global `prompt` is ignored, and the total duration of all storyboard segments must equal the global `duration` (default: `"disabled"`). | DYNAMIC_COMBO | No | `"disabled"`
`"1 storyboard"`
`"2 storyboards"`
`"3 storyboards"`
`"4 storyboards"`
`"5 storyboards"`
`"6 storyboards"` | | `generate_audio` | Generate audio for the video. Only supported for `kling-v3-omni` (default: false). | BOOLEAN | No | `true`
`false` | | `seed` | Seed controls whether the node should re-run; results are non-deterministic regardless of seed (default: 0). | INT | No | 0 to 2147483647 | diff --git a/comfyui_embedded_docs/docs/KlingOmniProTextToVideoNode/en.md b/comfyui_embedded_docs/docs/KlingOmniProTextToVideoNode/en.md index f3e2e7f14..3930e81f8 100644 --- a/comfyui_embedded_docs/docs/KlingOmniProTextToVideoNode/en.md +++ b/comfyui_embedded_docs/docs/KlingOmniProTextToVideoNode/en.md @@ -10,7 +10,7 @@ This node uses the latest Kling AI model to generate a video from a text descrip | `prompt` | A text prompt describing the video content. This can include both positive and negative descriptions. Ignored when storyboards are enabled. | STRING | Yes | 0 to 2500 characters | | `aspect_ratio` | The shape or dimensions of the video to generate. | COMBO | Yes | `"16:9"`
`"9:16"`
`"1:1"` | | `duration` | The length of the video in seconds (default: 5). | INT | Yes | 3 to 15 seconds | -| `resolution` | The quality or pixel resolution of the video (default: `"1080p"`). | COMBO | No | `"4k"`
`"1080p"`
`"720p"` | +| `resolution` | The quality or pixel resolution of the video (default: `"1080p"`). Internally maps to standard, pro, or 4k quality. | COMBO | No | `"4k"`
`"1080p"`
`"720p"` | | `storyboards` | Generate a series of video segments with individual prompts and durations. Ignored for the o1 model. | DYNAMIC_COMBO | No | `"disabled"`
`"1 storyboard"`
`"2 storyboards"`
`"3 storyboards"`
`"4 storyboards"`
`"5 storyboards"`
`"6 storyboards"` | | `generate_audio` | Whether to generate audio for the video (default: False). | BOOLEAN | No | True / False | | `seed` | Seed controls whether the node should re-run; results are non-deterministic regardless of seed (default: 0). | INT | No | 0 to 2147483647 | diff --git a/comfyui_embedded_docs/docs/KlingStartEndFrameNode/en.md b/comfyui_embedded_docs/docs/KlingStartEndFrameNode/en.md index bf94a46c0..d07b295f5 100644 --- a/comfyui_embedded_docs/docs/KlingStartEndFrameNode/en.md +++ b/comfyui_embedded_docs/docs/KlingStartEndFrameNode/en.md @@ -8,18 +8,28 @@ This node creates a video sequence that transitions between your provided start |-----------|-------------|-----------|----------|-------| | `start_frame` | Reference Image - URL or Base64 encoded string, cannot exceed 10MB, resolution not less than 300*300px, aspect ratio between 1:2.5 ~ 2.5:1. Base64 should not include data:image prefix. | IMAGE | Yes | - | | `end_frame` | Reference Image - End frame control. URL or Base64 encoded string, cannot exceed 10MB, resolution not less than 300*300px. Base64 should not include data:image prefix. | IMAGE | Yes | - | -| `prompt` | Positive text prompt | STRING | Yes | - | -| `negative_prompt` | Negative text prompt | STRING | Yes | - | -| `cfg_scale` | Controls the strength of the prompt guidance (default: 0.5) | FLOAT | No | 0.0-1.0 | -| `aspect_ratio` | The aspect ratio for the generated video (default: "16:9") | COMBO | No | "16:9"
"9:16"
"1:1" | -| `mode` | The configuration to use for the video generation following the format: mode / duration / model_name. (default: "pro mode / 5s duration / kling-v2-5-turbo") | COMBO | No | "pro mode / 5s duration / kling-v1-5"
"pro mode / 10s duration / kling-v1-5"
"pro mode / 5s duration / kling-v1-6"
"pro mode / 10s duration / kling-v1-6"
"pro mode / 5s duration / kling-v2-1"
"pro mode / 10s duration / kling-v2-1"
"pro mode / 5s duration / kling-v2-5-turbo"
"pro mode / 10s duration / kling-v2-5-turbo" | +| `prompt` | Positive text prompt. Must not be empty and cannot exceed 500 characters. | STRING | Yes | - | +| `negative_prompt` | Negative text prompt. Cannot exceed 500 characters. If left empty, it is omitted from the request. | STRING | Yes | - | +| `cfg_scale` | Controls the strength of the prompt guidance (default: 0.5) | FLOAT | Yes | 0.0-1.0 | +| `aspect_ratio` | The aspect ratio for the generated video (default: "16:9") | COMBO | Yes | "16:9"
"9:16"
"1:1" | +| `mode` | The configuration to use for the video generation following the format: mode / duration / model_name. (default: "pro mode / 5s duration / kling-v2-5-turbo") | COMBO | Yes | "pro mode / 5s duration / kling-v2-5-turbo"
"pro mode / 10s duration / kling-v2-5-turbo" | **Image Constraints:** -- Both `start_frame` and `end_frame` must be provided and cannot exceed 10MB file size -- Minimum resolution: 300×300 pixels for both images -- `start_frame` aspect ratio must be between 1:2.5 and 2.5:1 -- Base64 encoded images should not include the "data:image" prefix +- Both `start_frame` and `end_frame` are required and cannot exceed 10MB in file size. +- Minimum resolution: 300×300 pixels for both images. +- `start_frame` aspect ratio must be between 1:2.5 and 2.5:1. +- Base64 encoded images should not include the "data:image" prefix. + +**Prompt Constraints:** + +- `prompt` must not be empty and cannot exceed 500 characters. +- `negative_prompt` cannot exceed 500 characters; when empty, it is not sent with the request. + +**Mode Notes:** + +- Both mode options use pro mode with the kling-v2-5-turbo model and differ only in duration (5 seconds or 10 seconds). +- Pricing per generation, as shown in the node's price badge: 5s mode costs $0.35 USD and 10s mode costs $0.70 USD. ## Outputs @@ -32,4 +42,4 @@ This node creates a video sequence that transitions between your provided start > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/KlingStartEndFrameNode/en.md) --- -**Source fingerprint (SHA-256):** `7e3a6a4b04b7ad01708a0664a6bed9d817103206074ef41a747ef8193a8ce348` +**Source fingerprint (SHA-256):** `a27977226360a425614255f8330ce7fd8ba94b8c3020eb8fdddc01eb74f035c1` diff --git a/comfyui_embedded_docs/docs/KlingTextToVideoNode/en.md b/comfyui_embedded_docs/docs/KlingTextToVideoNode/en.md index ac1873b3b..fdb6ee74f 100644 --- a/comfyui_embedded_docs/docs/KlingTextToVideoNode/en.md +++ b/comfyui_embedded_docs/docs/KlingTextToVideoNode/en.md @@ -1,16 +1,18 @@ -# Kling Text to Video Node +# Kling Text to Video -The Kling Text to Video Node converts text descriptions into video content. It takes text prompts and generates corresponding video sequences based on the specified configuration settings. The node supports different aspect ratios, generation modes, and model versions to produce videos of varying durations and quality. +The Kling Text to Video node generates videos from text descriptions using the Kling video generation API. It sends the prompt and settings (aspect ratio, generation mode, and CFG scale) to the API, waits for the generation task to complete, and then returns the resulting video along with its ID and duration. ## Inputs | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| | `prompt` | Positive text prompt describing the desired video content | STRING | Yes | Maximum 2500 characters | -| `negative_prompt` | Negative text prompt describing what to avoid in the video | STRING | Yes | Maximum 2500 characters | +| `negative_prompt` | Negative text prompt describing what to avoid in the video | STRING | No | Maximum 2500 characters | | `cfg_scale` | Configuration scale value that controls how closely the video follows the prompt (default: 1.0) | FLOAT | No | 0.0 to 1.0 | -| `aspect_ratio` | Video aspect ratio setting (default: "16:9") | COMBO | No | `"16:9"`
`"9:16"`
`"1:1"` | -| `mode` | The configuration to use for video generation, following the format: mode / duration / model_name (default: "pro mode / 5s duration / kling-v2-5-turbo") | COMBO | No | `"standard mode / 5s duration / kling-v1-6"`
`"standard mode / 10s duration / kling-v1-6"`
`"pro mode / 5s duration / kling-v2-master"`
`"pro mode / 10s duration / kling-v2-master"`
`"standard mode / 5s duration / kling-v2-master"`
`"standard mode / 10s duration / kling-v2-master"`
`"pro mode / 5s duration / kling-v2-1-master"`
`"pro mode / 10s duration / kling-v2-1-master"`
`"pro mode / 5s duration / kling-v2-5-turbo"`
`"pro mode / 10s duration / kling-v2-5-turbo"` | +| `aspect_ratio` | Video aspect ratio setting (default: "16:9") | COMBO | No | "16:9"
"9:16"
"1:1" | +| `mode` | The configuration to use for the video generation following the format: mode / duration / model_name (default: "pro mode / 5s duration / kling-v2-5-turbo") | COMBO | No | "pro mode / 5s duration / kling-v2-5-turbo"
"pro mode / 10s duration / kling-v2-5-turbo" | + +Note: The `prompt` parameter is required and must not be empty. Both `prompt` and `negative_prompt` are limited to a maximum of 2500 characters. ## Outputs @@ -23,4 +25,4 @@ The Kling Text to Video Node converts text descriptions into video content. It t > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/KlingTextToVideoNode/en.md) --- -**Source fingerprint (SHA-256):** `02860325301936682a8e4e49f2a3d7c18d4915edbf61f58ded513564c5e85f7a` +**Source fingerprint (SHA-256):** `6a63b0b8bc45dc5a6300cdfe7a373399eeead36de6727f7aae2c026ba0deaea8` diff --git a/comfyui_embedded_docs/docs/KlingVideoNode/en.md b/comfyui_embedded_docs/docs/KlingVideoNode/en.md index d82798e8a..d8c46737c 100644 --- a/comfyui_embedded_docs/docs/KlingVideoNode/en.md +++ b/comfyui_embedded_docs/docs/KlingVideoNode/en.md @@ -9,7 +9,7 @@ This node generates videos using the Kling V3 model. It supports text-to-video m | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| | `multi_shot` | Generate a series of video segments with individual prompts and durations. When set to a storyboard option, additional inputs for each storyboard's prompt and duration appear. | DYNAMIC_COMBO | Yes | `"disabled"`
`"1 storyboard"`
`"2 storyboards"`
`"3 storyboards"`
`"4 storyboards"`
`"5 storyboards"`
`"6 storyboards"` | -| `model` | Model and generation settings. Selecting a model reveals its `model.resolution` and `model.aspect_ratio` sub-parameters. | DYNAMIC_COMBO | Yes | `"kling-v3"`
`"kling-3.0-turbo"` | +| `model` | Model and generation settings. Selecting a model reveals its resolution and aspect ratio sub-parameters. | DYNAMIC_COMBO | Yes | `"kling-v3"`
`"kling-3.0-turbo"` | | `generate_audio` | When enabled, the node generates audio for the video. Note: `"kling-3.0-turbo"` always generates native audio, so this toggle is ignored for that model. Default is True. | BOOLEAN | Yes | True
False | | `seed` | Seed controls whether the node should re-run; results are non-deterministic regardless of seed. Default is 0. | INT | Yes | 0 to 2147483647 | | `start_frame` | Optional start frame image. When connected, switches to image-to-video mode. | IMAGE | No | - | @@ -51,6 +51,7 @@ For each storyboard segment N (from 1 up to the selected storyboard count), the - Text-to-video mode is used when `start_frame` is not connected; image-to-video mode is used when `start_frame` is connected. In image-to-video mode, `model.aspect_ratio` is ignored and the input image must be at least 300x300 pixels with an aspect ratio between 1:2.5 and 2.5:1. - In storyboard mode, the main `prompt` and `negative_prompt` are not used. The total sum of all storyboard durations must be between 3 and 15 seconds. +- `negative_prompt` is only used with `kling-v3`; it is ignored when `kling-3.0-turbo` is selected. - For `kling-v3`, each storyboard is sent to the API as a separate segment. For `kling-3.0-turbo`, the storyboard prompts and durations are combined into a single multi-shot prompt. - For `kling-3.0-turbo`, `generate_audio` is ignored because this model always generates native audio. diff --git a/comfyui_embedded_docs/docs/LTXAVTextEncoderLoader/en.md b/comfyui_embedded_docs/docs/LTXAVTextEncoderLoader/en.md index 438b23a33..a7d8c57bc 100644 --- a/comfyui_embedded_docs/docs/LTXAVTextEncoderLoader/en.md +++ b/comfyui_embedded_docs/docs/LTXAVTextEncoderLoader/en.md @@ -1,16 +1,16 @@ # Load LTXV Audio Text Encoder -This node loads a specialized text encoder for the LTXV audio model. It combines a specific text encoder file with a checkpoint file to create a CLIP model that can be used for audio-related text conditioning tasks. +This node loads a specialized text encoder for the LTXV audio model. It combines a text encoder file with a checkpoint file to create a CLIP model used for text conditioning in audio generation. Per the node's description, the text encoder should be a Gemma 3 12B or a matching Gemma 4 model. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `text_encoder` | The filename of the LTXV text encoder model to load. The available options are loaded from the `text_encoders` folder. | STRING | Yes | Multiple options available | -| `ckpt_name` | The filename of the checkpoint to load. The available options are loaded from the `checkpoints` folder. | STRING | Yes | Multiple options available | -| `device` | Specifies the device to load the model onto. Use `"cpu"` to force loading onto the CPU. The default behavior (`"default"`) uses the system's automatic device placement. | STRING | No | `"default"`
`"cpu"` | +| `text_encoder` | The filename of the LTXV text encoder model to load. The available options are loaded from the `text_encoders` folder. | COMBO | Yes | Multiple options available | +| `ckpt_name` | The filename of the checkpoint to load. The available options are loaded from the `checkpoints` folder. | COMBO | Yes | Multiple options available | +| `device` | Specifies the device to load the model onto. Use `"cpu"` to force loading onto the CPU. The default behavior (`"default"`) uses the system's automatic device placement (default: `"default"`). This is an advanced parameter. | COMBO | No | `"default"`
`"cpu"` | -**Note:** The `text_encoder` and `ckpt_name` parameters work together. The node loads both specified files to create a single, functional CLIP model. The files must be compatible with the LTXV architecture. +**Note:** The `text_encoder` and `ckpt_name` parameters work together. The node loads both specified files to create a single, functional CLIP model. The files must be compatible with the LTXV architecture, and the text encoder should be a Gemma 3 12B or matching Gemma 4 model. ## Outputs @@ -21,4 +21,4 @@ This node loads a specialized text encoder for the LTXV audio model. It combines > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXAVTextEncoderLoader/en.md) --- -**Source fingerprint (SHA-256):** `41d4c4ffef8bd1e55a44cc19e7c1c768484118458a7d4e100e5e22f5323c59dc` +**Source fingerprint (SHA-256):** `1f3df2c1791203ba849a87897de14052e0cb8370100dbca19df4cf30169a0a2a` diff --git a/comfyui_embedded_docs/docs/LTXVAddGuide/en.md b/comfyui_embedded_docs/docs/LTXVAddGuide/en.md index 0f7668ee1..5fba4457f 100644 --- a/comfyui_embedded_docs/docs/LTXVAddGuide/en.md +++ b/comfyui_embedded_docs/docs/LTXVAddGuide/en.md @@ -11,8 +11,8 @@ The LTXVAddGuide node adds video conditioning guidance to latent sequences by en | `vae` | VAE model used for encoding the input image/video frames | VAE | Yes | - | | `latent` | Input latent sequence that will receive the conditioning frames | LATENT | Yes | - | | `image` | Image or video to condition the latent video on. Must be 8*n + 1 frames. If the video is not 8*n + 1 frames, it will be cropped to the nearest 8*n + 1 frames. | IMAGE | Yes | - | -| `frame_idx` | Frame index to start the conditioning at. For single-frame images or videos with 1-8 frames, any frame_idx value is acceptable. For videos with 9+ frames, frame_idx must be divisible by 8, otherwise it will be rounded down to the nearest multiple of 8. Negative values are counted from the end of the video. (default: 0) | INT | No | -9999 to 9999 | -| `strength` | Strength of the conditioning influence, where 1.0 applies full conditioning and 0.0 applies no conditioning (default: 1.0) | FLOAT | No | 0.0 to 10.0 | +| `frame_idx` | Frame index to start the conditioning at. For single-frame images or videos with 1-8 frames, any frame_idx value is acceptable. For videos with 9+ frames, frame_idx must be divisible by 8, otherwise it will be rounded down to the nearest multiple of 8. Negative values are counted from the end of the video. (default: 0) | INT | Yes | -9999 to 9999 | +| `strength` | Strength of the conditioning influence, where 1.0 applies full conditioning and 0.0 applies no conditioning (default: 1.0) | FLOAT | Yes | 0.0 to 10.0 | | `attention_mask` | Optional pixel-space spatial mask. Controls per-region conditioning influence via self-attention, multiplied by strength. | MASK | No | - | | `iclora_parameters` | Optional IC-LoRA parameters from a Get IC-LoRA Parameters node. Used for adjusting guide processing as required by certain IC-LoRAs (e.g., those with a reference_downscale_factor > 1). When chained, each LTXVAddGuide uses only the parameters connected to it. | IC_LORA_PARAMETERS | No | - | @@ -31,4 +31,4 @@ The LTXVAddGuide node adds video conditioning guidance to latent sequences by en > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVAddGuide/en.md) --- -**Source fingerprint (SHA-256):** `889348768112c6ecc3ef2e724981d3c49d96339b156617725816cf4186a94b7a` +**Source fingerprint (SHA-256):** `3e0d1422fbd1b5b3e4c69e641af2ecdb5ae8de3f4368b336917a0dce4286771e` diff --git a/comfyui_embedded_docs/docs/LTXVAudioVAEDecode/en.md b/comfyui_embedded_docs/docs/LTXVAudioVAEDecode/en.md index cd671ae78..460d50ea7 100644 --- a/comfyui_embedded_docs/docs/LTXVAudioVAEDecode/en.md +++ b/comfyui_embedded_docs/docs/LTXVAudioVAEDecode/en.md @@ -1,6 +1,6 @@ # LTXV Audio VAE Decode -The LTXV Audio VAE Decode node converts a latent representation of audio back into an audio waveform. It uses a specialized Audio VAE model to perform this decoding process, producing an audio output with a specific sample rate. +The LTXV Audio VAE Decode node converts a latent representation of audio back into an audio waveform. It uses a specialized Audio VAE model to perform this decoding process, producing an audio output with its associated sample rate. ## Inputs @@ -9,15 +9,15 @@ The LTXV Audio VAE Decode node converts a latent representation of audio back in | `samples` | The latent to be decoded. | LATENT | Yes | N/A | | `audio_vae` | The Audio VAE model used for decoding the latent. | VAE | Yes | N/A | -**Note:** If the provided latent is nested (contains multiple latents), the node will automatically use the last latent in the sequence for decoding. +**Note:** If the provided latent is nested (contains multiple latents), the node automatically uses the last latent in the sequence for decoding. ## Outputs | Output Name | Description | Data Type | | --- | --- | --- | -| `Audio` | The decoded audio waveform and its associated sample rate. The waveform is a tensor moved to the same device as the input latent, and the sample rate is determined by the Audio VAE model. | AUDIO | +| `Audio` | The decoded audio waveform and its associated sample rate. The waveform is placed on the same device as the input latent, and the sample rate is determined by the Audio VAE model. | AUDIO | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVAudioVAEDecode/en.md) --- -**Source fingerprint (SHA-256):** `b410b535f8cfc07b2d5a7814d719970ca813172bbbb04bec22a0ce3be04dfa94` +**Source fingerprint (SHA-256):** `fc94f3cb78ede86ada374444d613411cc9bb5849e5cdb8a24074babee50719b1` diff --git a/comfyui_embedded_docs/docs/LTXVAudioVAEEncode/en.md b/comfyui_embedded_docs/docs/LTXVAudioVAEEncode/en.md index 163f44789..fa4407b53 100644 --- a/comfyui_embedded_docs/docs/LTXVAudioVAEEncode/en.md +++ b/comfyui_embedded_docs/docs/LTXVAudioVAEEncode/en.md @@ -18,4 +18,4 @@ The LTXV Audio VAE Encode node takes an audio input and compresses it into a sma > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVAudioVAEEncode/en.md) --- -**Source fingerprint (SHA-256):** `0c17491e6d2910febe7dc5c1ecf988c3f160b1a08de70f8c0c4ab52defe897cd` +**Source fingerprint (SHA-256):** `68f70e0f8048cd9ba723f52eefc93cc33564eb3e68c0cb9b677964dc99aecb97` diff --git a/comfyui_embedded_docs/docs/LTXVAudioVAELoader/en.md b/comfyui_embedded_docs/docs/LTXVAudioVAELoader/en.md index 039c84332..2350045cf 100644 --- a/comfyui_embedded_docs/docs/LTXVAudioVAELoader/en.md +++ b/comfyui_embedded_docs/docs/LTXVAudioVAELoader/en.md @@ -5,16 +5,18 @@ The LTXV Audio VAE Loader node loads a pre-trained Audio Variational Autoencoder ## Inputs | Parameter | Description | Data Type | Required | Range | -| --- | --- | --- | --- | --- | -| `ckpt_name` | Audio VAE checkpoint to load. This is a dropdown list populated with all the files found in your ComfyUI `checkpoints` directory. | STRING | Yes | All files in the `checkpoints` folder.
*Example: `"audio_vae.safetensors"`* | +|-----------|-------------|-----------|----------|-------| +| `ckpt_name` | Audio VAE checkpoint to load. This is a dropdown list populated with all the files found in your ComfyUI `checkpoints` directory. | COMBO | Yes | All files in the `checkpoints` folder. The list is generated at runtime. | + +The selected file must be a valid LTXV audio VAE checkpoint. The node keeps only the audio VAE and vocoder weights from the file and raises an error if the loaded model is not a valid VAE. ## Outputs | Output Name | Description | Data Type | -| --- | --- | --- | +|-------------|-------------|-----------| | `Audio VAE` | The loaded Audio Variational Autoencoder model, ready to be connected to other audio processing nodes. | VAE | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVAudioVAELoader/en.md) --- -**Source fingerprint (SHA-256):** `bafe0ae9a6175565e95514d8a42cd11ffc32330503d87a097bc7fd2ef113c794` +**Source fingerprint (SHA-256):** `c91956645a9de0b8f56191f6c0c6bef43f13724ba59078ec9a885168bf2650e8` diff --git a/comfyui_embedded_docs/docs/LTXVConcatAVLatent/en.md b/comfyui_embedded_docs/docs/LTXVConcatAVLatent/en.md index aaa8a6b11..0842e1fef 100644 --- a/comfyui_embedded_docs/docs/LTXVConcatAVLatent/en.md +++ b/comfyui_embedded_docs/docs/LTXVConcatAVLatent/en.md @@ -1,23 +1,23 @@ -# LTXVConcatAVLatent +# Concat AV Latent -The LTXVConcatAVLatent node combines a video latent representation and an audio latent representation into a single, concatenated latent output. It merges the `samples` tensors from both inputs and, if present, their `noise_mask` tensors as well, preparing them for further processing in a video generation pipeline. +This node merges a video latent and an audio latent into a single joint audio-video (AV) latent, ready for AV models such as LTXV or MiniMax H3. If the video input is already an AV latent, its video stream is kept and only the audio stream is replaced with the supplied audio latent. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `video_latent` | The latent representation of the video data. | LATENT | Yes | | -| `audio_latent` | The latent representation of the audio data. | LATENT | Yes | | +| `video_latent` | The latent representation of the video data. When it already contains both video and audio streams, the node keeps its video stream and swaps in the audio from `audio_latent`. | LATENT | Yes | | +| `audio_latent` | The latent representation of the audio data. Its length is adjusted to fit the video stream: longer audio is trimmed, shorter audio is zero-padded. | LATENT | Yes | | -**Note:** The `samples` tensors from the `video_latent` and `audio_latent` inputs are concatenated. If either input contains a `noise_mask`, it will be used; if one is missing, a mask of ones (same shape as the corresponding `samples`) is created for it. The resulting masks are then also concatenated. +**Note:** The samples from both inputs are combined as a pair of video and audio streams in a nested tensor. If either input contains a `noise_mask`, the output includes a combined one; a missing mask is replaced with an all-ones mask matching the shape of its samples. When shorter audio is padded, the padded region is left unmasked so the model can generate it. The node raises an error if the audio latent cannot be fitted to the video latent, for example when the two latents differ in more than one dimension or when they differ in the batch or channel dimensions. ## Outputs | Output Name | Description | Data Type | | --- | --- | --- | -| `latent` | A single latent dictionary containing the concatenated `samples` and, if applicable, the concatenated `noise_mask` from the video and audio inputs. | LATENT | +| `latent` | A latent containing the video and audio samples packed together as two streams, plus a combined `noise_mask` when at least one input provides one. | LATENT | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVConcatAVLatent/en.md) --- -**Source fingerprint (SHA-256):** `ae619048b36d205d63e6054760c443f438b77d561e05458ce2d9d3f4a2024e74` +**Source fingerprint (SHA-256):** `0231f9db2ce73132d8555fbb33f295b68aa68a0c1c54e4a0c5d2e1f67b5611cb` diff --git a/comfyui_embedded_docs/docs/LTXVConditioning/en.md b/comfyui_embedded_docs/docs/LTXVConditioning/en.md index 695c4c73a..583db18c6 100644 --- a/comfyui_embedded_docs/docs/LTXVConditioning/en.md +++ b/comfyui_embedded_docs/docs/LTXVConditioning/en.md @@ -20,4 +20,4 @@ The LTXVConditioning node adds frame rate information to both positive and negat > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVConditioning/en.md) --- -**Source fingerprint (SHA-256):** `8089df723caec60e89d309f004a8cd4bbe376e075bfa39bc881cf5a1bbe359c7` +**Source fingerprint (SHA-256):** `c8546b691329f2934995f97a6db2e1393d2928bf1a7438fd079d52f87bee1c35` diff --git a/comfyui_embedded_docs/docs/LTXVCropGuides/en.md b/comfyui_embedded_docs/docs/LTXVCropGuides/en.md index 22de955d4..f7b5830dc 100644 --- a/comfyui_embedded_docs/docs/LTXVCropGuides/en.md +++ b/comfyui_embedded_docs/docs/LTXVCropGuides/en.md @@ -1,14 +1,16 @@ # LTXVCropGuides -The LTXVCropGuides node processes conditioning and latent inputs for video generation by removing keyframe information and adjusting the latent dimensions. It crops the latent image and noise mask to exclude keyframe sections while clearing keyframe indices from both positive and negative conditioning inputs. This prepares the data for video generation workflows that don't require keyframe guidance. +The LTXVCropGuides node processes conditioning and latent inputs for video generation by removing keyframe information and adjusting the latent dimensions. It crops the latent image and noise mask to exclude keyframe sections while clearing keyframe indices and guide attention entries from both positive and negative conditioning inputs. This prepares the data for video generation workflows that don't require keyframe guidance. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `positive` | The positive conditioning input containing guidance information for generation | CONDITIONING | Yes | - | -| `negative` | The negative conditioning input containing guidance information for what to avoid in generation | CONDITIONING | Yes | - | -| `latent` | The latent representation containing image samples and noise mask data | LATENT | Yes | - | +| `positive` | The positive conditioning input containing guidance information for generation. Its keyframe indices determine how many frames are cropped from the latent. | CONDITIONING | Yes | - | +| `negative` | The negative conditioning input containing guidance information for what to avoid in generation. Its keyframe data is cleared along with the positive conditioning. | CONDITIONING | Yes | - | +| `latent` | The latent representation containing image samples and noise mask data. When keyframes are present in the positive conditioning, the last keyframe frames are removed from both the samples and the noise mask. | LATENT | Yes | - | + +Note: Cropping only occurs when the positive conditioning contains keyframe indices. If no keyframes are detected, the positive and negative conditioning pass through unchanged along with the latent. ## Outputs @@ -21,4 +23,4 @@ The LTXVCropGuides node processes conditioning and latent inputs for video gener > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVCropGuides/en.md) --- -**Source fingerprint (SHA-256):** `b5981a2e685c3590df2ced4b619d6d4596971255c8eb6081d63f917a9a938504` +**Source fingerprint (SHA-256):** `83e08bad281902e765ec18e06144b6a5fa730be2533932daa1d4076e6390b1e1` diff --git a/comfyui_embedded_docs/docs/LTXVDualCFGGuider/ar.md b/comfyui_embedded_docs/docs/LTXVDualCFGGuider/ar.md index 32afc44a1..72ee078ae 100644 --- a/comfyui_embedded_docs/docs/LTXVDualCFGGuider/ar.md +++ b/comfyui_embedded_docs/docs/LTXVDualCFGGuider/ar.md @@ -6,9 +6,9 @@ | المعامل | الوصف | نوع البيانات | مطلوب | النطاق | |-----------|-------------|-----------|----------|-------| -| `model` | النموذج المستخدم عند أخذ العينات. | MODEL | نعم | - | -| `positive` | التكييف الإيجابي لتوجيه التوليد نحوه. | CONDITIONING | نعم | - | -| `negative` | التكييف السلبي لإبعاد التوليد عنه. | CONDITIONING | نعم | - | +| `النموذج` | النموذج المستخدم عند أخذ العينات. | MODEL | نعم | - | +| `إيجابي` | التكييف الإيجابي لتوجيه التوليد نحوه. | CONDITIONING | نعم | - | +| `سلبي` | التكييف السلبي لإبعاد التوليد عنه. | CONDITIONING | نعم | - | | `video_cfg` | قوة الإرشاد المطبقة على نمط الفيديو في الكامن (الافتراضي: 3.0). | FLOAT | نعم | 0.0 إلى 100.0 | | `audio_cfg` | قوة الإرشاد المطبقة على نمط الصوت في الكامن (الافتراضي: 7.0). | FLOAT | نعم | 0.0 إلى 100.0 | diff --git a/comfyui_embedded_docs/docs/LTXVDualCFGGuider/en.md b/comfyui_embedded_docs/docs/LTXVDualCFGGuider/en.md index b748b0a6c..8ea49c851 100644 --- a/comfyui_embedded_docs/docs/LTXVDualCFGGuider/en.md +++ b/comfyui_embedded_docs/docs/LTXVDualCFGGuider/en.md @@ -1,4 +1,4 @@ -# LTXVDualCFGGuider +# LTXV Dual CFG Guider This node creates a guided sampling object (CFG guider) for LTXV-AV models. It applies a separate guidance scale to the video part and audio part of the packed latent, letting you control the influence of conditioning on each modality independently. If the two scales are equal, or if the latent does not contain separate video and audio components, a single overall scale is used. @@ -12,7 +12,7 @@ This node creates a guided sampling object (CFG guider) for LTXV-AV models. It a | `video_cfg` | Guidance strength applied to the video modality of the latent (default: 3.0). | FLOAT | Yes | 0.0 to 100.0 | | `audio_cfg` | Guidance strength applied to the audio modality of the latent (default: 7.0). | FLOAT | Yes | 0.0 to 100.0 | -Note: When `video_cfg` and `audio_cfg` have the same value, the guider uses that value as a single CFG scale for the whole latent. If the latent is not a packed LTXV-AV latent, only the `video_cfg` value is used. +Note: When `video_cfg` and `audio_cfg` are equal or very close in value, the guider uses that value as a single CFG scale for the whole latent. If the latent is not a packed LTXV-AV latent, only the `video_cfg` value is used. ## Outputs diff --git a/comfyui_embedded_docs/docs/LTXVDualCFGGuider/es.md b/comfyui_embedded_docs/docs/LTXVDualCFGGuider/es.md index c31ed177a..bdcb8eadc 100644 --- a/comfyui_embedded_docs/docs/LTXVDualCFGGuider/es.md +++ b/comfyui_embedded_docs/docs/LTXVDualCFGGuider/es.md @@ -6,9 +6,9 @@ Este nodo crea un objeto de muestreo guiado (guía CFG) para los modelos LTXV-AV | Parámetro | Descripción | Tipo de datos | ¿Requerido? | Rango | |-----------|-------------|---------------|-------------|-------| -| `model` | El modelo que se usará al muestrear. | MODEL | Sí | - | -| `positive` | Condicionamiento positivo para guiar la generación hacia lo deseado. | CONDITIONING | Sí | - | -| `negative` | Condicionamiento negativo para alejar la generación de lo no deseado. | CONDITIONING | Sí | - | +| `modelo` | El modelo que se usará al muestrear. | MODEL | Sí | - | +| `positivo` | Condicionamiento positivo para guiar la generación hacia lo deseado. | CONDITIONING | Sí | - | +| `negativo` | Condicionamiento negativo para alejar la generación de lo no deseado. | CONDITIONING | Sí | - | | `video_cfg` | Intensidad de guía aplicada a la modalidad de video del latent (predeterminado: 3.0). | FLOAT | Sí | 0.0 a 100.0 | | `audio_cfg` | Intensidad de guía aplicada a la modalidad de audio del latent (predeterminado: 7.0). | FLOAT | Sí | 0.0 a 100.0 | diff --git a/comfyui_embedded_docs/docs/LTXVDualCFGGuider/fa.md b/comfyui_embedded_docs/docs/LTXVDualCFGGuider/fa.md index d6b6bff14..c83022de4 100644 --- a/comfyui_embedded_docs/docs/LTXVDualCFGGuider/fa.md +++ b/comfyui_embedded_docs/docs/LTXVDualCFGGuider/fa.md @@ -6,11 +6,11 @@ | پارامتر | توضیحات | نوع داده | الزامی | محدوده | |---------|-----------|-----------|----------|-------| -| `model` | مدلی که هنگام نمونه‌گیری استفاده می‌شود. | MODEL | بله | - | -| `positive` | شرطی‌سازی مثبت برای هدایت تولید به سمت آن. | CONDITIONING | بله | - | -| `negative` | شرطی‌سازی منفی برای دور کردن تولید از آن. | CONDITIONING | بله | - | -| `video_cfg` | شدت راهنمایی اعمال‌شده به مدالیته ویدیویی latent (پیش‌فرض: 3.0). | FLOAT | بله | 0.0 تا 100.0 | -| `audio_cfg` | شدت راهنمایی اعمال‌شده به مدالیته صوتی latent (پیش‌فرض: 7.0). | FLOAT | بله | 0.0 تا 100.0 | +| `مدل` | مدلی که هنگام نمونه‌گیری استفاده می‌شود. | MODEL | بله | - | +| `مثبت` | شرطی‌سازی مثبت برای هدایت تولید به سمت آن. | CONDITIONING | بله | - | +| `منفی` | شرطی‌سازی منفی برای دور کردن تولید از آن. | CONDITIONING | بله | - | +| `ویدیو CFG` | شدت راهنمایی اعمال‌شده به مدالیته ویدیویی latent (پیش‌فرض: 3.0). | FLOAT | بله | 0.0 تا 100.0 | +| `صوت CFG` | شدت راهنمایی اعمال‌شده به مدالیته صوتی latent (پیش‌فرض: 7.0). | FLOAT | بله | 0.0 تا 100.0 | نکته: وقتی `video_cfg` و `audio_cfg` مقدار یکسانی داشته باشند، راهنما از آن مقدار به‌عنوان یک مقیاس CFG واحد برای کل latent استفاده می‌کند. اگر latent یک latent بسته‌بندی‌شدهٔ LTXV-AV نباشد، فقط مقدار `video_cfg` استفاده می‌شود. diff --git a/comfyui_embedded_docs/docs/LTXVDualCFGGuider/fr.md b/comfyui_embedded_docs/docs/LTXVDualCFGGuider/fr.md index a657c1582..33b95de6b 100644 --- a/comfyui_embedded_docs/docs/LTXVDualCFGGuider/fr.md +++ b/comfyui_embedded_docs/docs/LTXVDualCFGGuider/fr.md @@ -6,9 +6,9 @@ Ce nœud crée un objet d'échantillonnage guidé (guider CFG) pour les modèles | Paramètre | Description | Type de données | Requis | Plage | |-----------|-------------|-----------|----------|-------| -| `model` | Le modèle à utiliser lors de l'échantillonnage. | MODEL | Oui | - | -| `positive` | Conditionnement positif pour guider la génération vers la cible souhaitée. | CONDITIONING | Oui | - | -| `negative` | Conditionnement négatif pour éloigner la génération de la cible indésirable. | CONDITIONING | Oui | - | +| `modèle` | Le modèle à utiliser lors de l'échantillonnage. | MODEL | Oui | - | +| `positif` | Conditionnement positif pour guider la génération vers la cible souhaitée. | CONDITIONING | Oui | - | +| `négatif` | Conditionnement négatif pour éloigner la génération de la cible indésirable. | CONDITIONING | Oui | - | | `video_cfg` | Force de guidage appliquée à la modalité vidéo du latent (par défaut : 3.0). | FLOAT | Oui | 0.0 à 100.0 | | `audio_cfg` | Force de guidage appliquée à la modalité audio du latent (par défaut : 7.0). | FLOAT | Oui | 0.0 à 100.0 | diff --git a/comfyui_embedded_docs/docs/LTXVDualCFGGuider/tr.md b/comfyui_embedded_docs/docs/LTXVDualCFGGuider/tr.md index 8db5a4267..4819850d5 100644 --- a/comfyui_embedded_docs/docs/LTXVDualCFGGuider/tr.md +++ b/comfyui_embedded_docs/docs/LTXVDualCFGGuider/tr.md @@ -7,8 +7,8 @@ Bu düğüm, LTXV-AV modelleri için yönlendirilmiş bir örnekleme nesnesi (CF | Parametre | Açıklama | Veri Türü | Gerekli | Aralık | |-----------|-------------|-----------|----------|-------| | `model` | Örnekleme sırasında kullanılacak model. | MODEL | Evet | - | -| `positive` | Üretimi yönlendirmek için kullanılan pozitif koşullandırma. | CONDITIONING | Evet | - | -| `negative` | Üretimi istenmeyen yönden uzaklaştıran negatif koşullandırma. | CONDITIONING | Evet | - | +| `pozitif` | Üretimi yönlendirmek için kullanılan pozitif koşullandırma. | CONDITIONING | Evet | - | +| `negatif` | Üretimi istenmeyen yönden uzaklaştıran negatif koşullandırma. | CONDITIONING | Evet | - | | `video_cfg` | Latentin video modalitesine uygulanan yönlendirme gücü (varsayılan: 3.0). | FLOAT | Evet | 0.0 ile 100.0 arası | | `audio_cfg` | Latentin ses modalitesine uygulanan yönlendirme gücü (varsayılan: 7.0). | FLOAT | Evet | 0.0 ile 100.0 arası | diff --git a/comfyui_embedded_docs/docs/LTXVDurationPredictor/ar.md b/comfyui_embedded_docs/docs/LTXVDurationPredictor/ar.md index 4a408f0e8..9e66dc138 100644 --- a/comfyui_embedded_docs/docs/LTXVDurationPredictor/ar.md +++ b/comfyui_embedded_docs/docs/LTXVDurationPredictor/ar.md @@ -6,12 +6,12 @@ | المعامل | الوصف | نوع البيانات | إلزامي | النطاق | |---------|--------|--------------|--------|--------| -| `model` | النموذج المستخدم لمعالجة تضمينات النص مسبقًا وتشغيل رأس المدة. | MODEL | نعم | N/A | -| `positive` | التكييف الذي يوفر تضمينات النص للموجه والبيانات الوصفية للتنبؤ بالمدة. | CONDITIONING | نعم | N/A | +| `النموذج` | النموذج المستخدم لمعالجة تضمينات النص مسبقًا وتشغيل رأس المدة. | MODEL | نعم | N/A | +| `إيجابي` | التكييف الذي يوفر تضمينات النص للموجه والبيانات الوصفية للتنبؤ بالمدة. | CONDITIONING | نعم | N/A | | `duration_head` | رأس مدة LTX 2.4 الذي تم تحميله باستخدام ModelPatchLoader. يجب أن يكون رأس مدة LTX. | MODEL_PATCH | نعم | N/A | -| `frame_rate` | معدل الإطارات بالإطارات في الثانية المستخدم لتحويل الثواني إلى إطارات (الافتراضي: 24.0). | FLOAT | نعم | 1.0 إلى 120.0 | -| `min_seconds` | الحد الأدنى للمدة بالثواني المستخدم عند تحويل التنبؤ إلى عدد إطارات (الافتراضي: 1.0). | FLOAT | نعم | 0.5 إلى 120.0 | -| `max_seconds` | الحد الأقصى للمدة بالثواني المستخدم عند تحويل التنبؤ إلى عدد إطارات (الافتراضي: 20.0). | FLOAT | نعم | 0.5 إلى 120.0 | +| `معدل الإطارات` | معدل الإطارات بالإطارات في الثانية المستخدم لتحويل الثواني إلى إطارات (الافتراضي: 24.0). | FLOAT | نعم | 1.0 إلى 120.0 | +| `الحد الأدنى للثواني` | الحد الأدنى للمدة بالثواني المستخدم عند تحويل التنبؤ إلى عدد إطارات (الافتراضي: 1.0). | FLOAT | نعم | 0.5 إلى 120.0 | +| `الحد الأقصى للثواني` | الحد الأقصى للمدة بالثواني المستخدم عند تحويل التنبؤ إلى عدد إطارات (الافتراضي: 20.0). | FLOAT | نعم | 0.5 إلى 120.0 | ملاحظة: يجب أن يكون مدخل `duration_head` رأس مدة LTX 2.4 تم تحميله باستخدام ModelPatchLoader. إذا لم يكن الترقيع النموذجي المتصل رأس مدة LTX، ترفع العقدة خطأ ValueError. @@ -19,8 +19,8 @@ | اسم المخرَج | الوصف | نوع البيانات | |-------------|--------|--------------| -| `num_frames` | المدة المتوقعة محولة إلى عدد إطارات ومقربة إلى شبكة إطارات VAE ذات 8k+1. | INT | -| `seconds` | المدة المتوقعة الخام (غير المقيدة). هذه هي القيمة قبل التقريب إلى شبكة الإطارات. | FLOAT | +| `عدد الإطارات` | المدة المتوقعة محولة إلى عدد إطارات ومقربة إلى شبكة إطارات VAE ذات 8k+1. | INT | +| `الثواني` | المدة المتوقعة الخام (غير المقيدة). هذه هي القيمة قبل التقريب إلى شبكة الإطارات. | FLOAT | > تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVDurationPredictor/ar.md) diff --git a/comfyui_embedded_docs/docs/LTXVDurationPredictor/en.md b/comfyui_embedded_docs/docs/LTXVDurationPredictor/en.md index 52057d667..53fd9c8bb 100644 --- a/comfyui_embedded_docs/docs/LTXVDurationPredictor/en.md +++ b/comfyui_embedded_docs/docs/LTXVDurationPredictor/en.md @@ -1,6 +1,6 @@ -# LTXVDurationPredictor +# LTXV Duration Predictor -This node predicts the natural duration of a shot for a prompt using an LTX 2.4 duration head. It converts the predicted duration into a frame count that fits the VAE's frame grid, using the supplied frame rate and minimum/maximum duration limits. +This node predicts the natural shot duration for a prompt using an LTX 2.4 duration head. It converts the predicted duration into a frame count that fits the VAE's frame grid, using the supplied frame rate and minimum/maximum duration limits. ## Inputs diff --git a/comfyui_embedded_docs/docs/LTXVDurationPredictor/es.md b/comfyui_embedded_docs/docs/LTXVDurationPredictor/es.md index 919304efa..f5962e880 100644 --- a/comfyui_embedded_docs/docs/LTXVDurationPredictor/es.md +++ b/comfyui_embedded_docs/docs/LTXVDurationPredictor/es.md @@ -6,12 +6,12 @@ Este nodo predice la duración natural de una toma para un prompt utilizando un | Parámetro | Descripción | Tipo de datos | Requerido | Rango | |-----------|-------------|---------------|-----------|-------| -| `model` | El modelo utilizado para preprocesar los embeddings de texto y ejecutar el cabezal de duración. | MODEL | Sí | N/A | -| `positive` | El condicionamiento que proporciona los embeddings de texto del prompt y los metadatos para la predicción de duración. | CONDITIONING | Sí | N/A | +| `modelo` | El modelo utilizado para preprocesar los embeddings de texto y ejecutar el cabezal de duración. | MODEL | Sí | N/A | +| `positivo` | El condicionamiento que proporciona los embeddings de texto del prompt y los metadatos para la predicción de duración. | CONDITIONING | Sí | N/A | | `duration_head` | Cabezal de duración LTX 2.4 cargado con ModelPatchLoader. Debe ser un cabezal de duración LTX. | MODEL_PATCH | Sí | N/A | -| `frame_rate` | Velocidad de fotogramas en fotogramas por segundo utilizada para convertir segundos a fotogramas (predeterminado: 24.0). | FLOAT | Sí | 1.0 a 120.0 | -| `min_seconds` | Duración mínima en segundos utilizada al convertir la predicción a un número de fotogramas (predeterminado: 1.0). | FLOAT | Sí | 0.5 a 120.0 | -| `max_seconds` | Duración máxima en segundos utilizada al convertir la predicción a un número de fotogramas (predeterminado: 20.0). | FLOAT | Sí | 0.5 a 120.0 | +| `frecuencia_de_fotogramas` | Velocidad de fotogramas en fotogramas por segundo utilizada para convertir segundos a fotogramas (predeterminado: 24.0). | FLOAT | Sí | 1.0 a 120.0 | +| `segundos_mínimos` | Duración mínima en segundos utilizada al convertir la predicción a un número de fotogramas (predeterminado: 1.0). | FLOAT | Sí | 0.5 a 120.0 | +| `segundos_máximos` | Duración máxima en segundos utilizada al convertir la predicción a un número de fotogramas (predeterminado: 20.0). | FLOAT | Sí | 0.5 a 120.0 | Nota: La entrada `duration_head` debe ser un cabezal de duración LTX 2.4 cargado con ModelPatchLoader. Si el parche de modelo conectado no es un cabezal de duración LTX, el nodo lanza un ValueError. @@ -20,7 +20,7 @@ Nota: La entrada `duration_head` debe ser un cabezal de duración LTX 2.4 cargad | Nombre de salida | Descripción | Tipo de datos | |------------------|-------------|---------------| | `num_frames` | La duración predicha convertida a un número de fotogramas y ajustada a la cuadrícula de fotogramas 8k+1 de la VAE. | INT | -| `seconds` | Duración predicha en bruto (sin limitar). Este es el valor antes de ajustarse a la cuadrícula de fotogramas. | FLOAT | +| `segundos` | Duración predicha en bruto (sin limitar). Este es el valor antes de ajustarse a la cuadrícula de fotogramas. | FLOAT | > Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVDurationPredictor/es.md) diff --git a/comfyui_embedded_docs/docs/LTXVDurationPredictor/fa.md b/comfyui_embedded_docs/docs/LTXVDurationPredictor/fa.md index e5960b7d9..85cbc9b97 100644 --- a/comfyui_embedded_docs/docs/LTXVDurationPredictor/fa.md +++ b/comfyui_embedded_docs/docs/LTXVDurationPredictor/fa.md @@ -6,12 +6,12 @@ | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `model` | مدلی که برای پیش‌پردازش امبدینگ‌های متن و اجرای سر مدت‌زمان استفاده می‌شود. | MODEL | بله | N/A | -| `positive` | conditioning شامل امبدینگ‌های متن prompt و فراداده‌های لازم برای پیش‌بینی مدت‌زمان. | CONDITIONING | بله | N/A | -| `duration_head` | سر مدت‌زمان LTX 2.4 بارگذاری‌شده با ModelPatchLoader. باید یک سر مدت‌زمان LTX باشد. | MODEL_PATCH | بله | N/A | -| `frame_rate` | نرخ فریم بر حسب فریم بر ثانیه، برای تبدیل ثانیه به فریم استفاده می‌شود (پیش‌فرض: 24.0). | FLOAT | بله | 1.0 تا 120.0 | -| `min_seconds` | حداقل مدت‌زمان بر حسب ثانیه، هنگام تبدیل پیش‌بینی به تعداد فریم استفاده می‌شود (پیش‌فرض: 1.0). | FLOAT | بله | 0.5 تا 120.0 | -| `max_seconds` | حداکثر مدت‌زمان بر حسب ثانیه، هنگام تبدیل پیش‌بینی به تعداد فریم استفاده می‌شود (پیش‌فرض: 20.0). | FLOAT | بله | 0.5 تا 120.0 | +| `مدل` | مدلی که برای پیش‌پردازش امبدینگ‌های متن و اجرای سر مدت‌زمان استفاده می‌شود. | MODEL | بله | N/A | +| `مثبت` | conditioning شامل امبدینگ‌های متن prompt و فراداده‌های لازم برای پیش‌بینی مدت‌زمان. | CONDITIONING | بله | N/A | +| `duration head` | سر مدت‌زمان LTX 2.4 بارگذاری‌شده با ModelPatchLoader. باید یک سر مدت‌زمان LTX باشد. | MODEL_PATCH | بله | N/A | +| `نرخ فریم` | نرخ فریم بر حسب فریم بر ثانیه، برای تبدیل ثانیه به فریم استفاده می‌شود (پیش‌فرض: 24.0). | FLOAT | بله | 1.0 تا 120.0 | +| `حداقل ثانیه` | حداقل مدت‌زمان بر حسب ثانیه، هنگام تبدیل پیش‌بینی به تعداد فریم استفاده می‌شود (پیش‌فرض: 1.0). | FLOAT | بله | 0.5 تا 120.0 | +| `حداکثر ثانیه` | حداکثر مدت‌زمان بر حسب ثانیه، هنگام تبدیل پیش‌بینی به تعداد فریم استفاده می‌شود (پیش‌فرض: 20.0). | FLOAT | بله | 0.5 تا 120.0 | توجه: ورودی `duration_head` باید یک سر مدت‌زمان LTX 2.4 باشد که با ModelPatchLoader بارگذاری شده است. اگر patch مدل متصل‌شده یک سر مدت‌زمان LTX نباشد، گره خطای ValueError صادر می‌کند. diff --git a/comfyui_embedded_docs/docs/LTXVDurationPredictor/fr.md b/comfyui_embedded_docs/docs/LTXVDurationPredictor/fr.md index 861da7122..bc91b4d71 100644 --- a/comfyui_embedded_docs/docs/LTXVDurationPredictor/fr.md +++ b/comfyui_embedded_docs/docs/LTXVDurationPredictor/fr.md @@ -7,12 +7,12 @@ Ce nœud prédit la durée naturelle d'un plan pour un prompt à l'aide d'une t | Paramètre | Description | Type de données | Requis | Plage | |-----------|-------------|-----------------|--------|-------| -| `model` | Le modèle utilisé pour prétraiter les plongements de texte et exécuter la tête de durée. | MODEL | Oui | N/A | -| `positive` | Le conditionnement qui fournit les plongements de texte du prompt et les métadonnées pour la prédiction de durée. | CONDITIONING | Oui | N/A | +| `modèle` | Le modèle utilisé pour prétraiter les plongements de texte et exécuter la tête de durée. | MODEL | Oui | N/A | +| `positif` | Le conditionnement qui fournit les plongements de texte du prompt et les métadonnées pour la prédiction de durée. | CONDITIONING | Oui | N/A | | `duration_head` | Tête de durée LTX 2.4 chargée avec ModelPatchLoader. Doit être une tête de durée LTX. | MODEL_PATCH | Oui | N/A | -| `frame_rate` | Cadence en images par seconde utilisée pour convertir les secondes en images (défaut : 24.0). | FLOAT | Oui | 1.0 à 120.0 | -| `min_seconds` | Durée minimale en secondes utilisée lors de la conversion de la prédiction en nombre d'images (défaut : 1.0). | FLOAT | Oui | 0.5 à 120.0 | -| `max_seconds` | Durée maximale en secondes utilisée lors de la conversion de la prédiction en nombre d'images (défaut : 20.0). | FLOAT | Oui | 0.5 à 120.0 | +| `taux d’images` | Cadence en images par seconde utilisée pour convertir les secondes en images (défaut : 24.0). | FLOAT | Oui | 1.0 à 120.0 | +| `secondes_min` | Durée minimale en secondes utilisée lors de la conversion de la prédiction en nombre d'images (défaut : 1.0). | FLOAT | Oui | 0.5 à 120.0 | +| `secondes_max` | Durée maximale en secondes utilisée lors de la conversion de la prédiction en nombre d'images (défaut : 20.0). | FLOAT | Oui | 0.5 à 120.0 | Note : L'entrée `duration_head` doit être une tête de durée LTX 2.4 chargée avec ModelPatchLoader. Si le patch de modèle connecté n'est pas une tête de durée LTX, le nœud lève une ValueError. @@ -20,8 +20,8 @@ Note : L'entrée `duration_head` doit être une tête de durée LTX 2.4 chargée | Nom de sortie | Description | Type de données | |---------------|-------------|-----------------| -| `num_frames` | La durée prédite convertie en nombre d'images et ajustée à la grille d'images 8k+1 du VAE. | INT | -| `seconds` | Durée prédite brute (non écrêtée). Il s'agit de la valeur avant l'ajustement à la grille d'images. | FLOAT | +| `nombre_de_frames` | La durée prédite convertie en nombre d'images et ajustée à la grille d'images 8k+1 du VAE. | INT | +| `secondes` | Durée prédite brute (non écrêtée). Il s'agit de la valeur avant l'ajustement à la grille d'images. | FLOAT | ``` > Cette documentation a été générée par IA. Si vous trouvez des erreurs ou avez des suggestions d'amélioration, n'hésitez pas à contribuer ! [Modifier sur GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVDurationPredictor/fr.md) diff --git a/comfyui_embedded_docs/docs/LTXVDurationPredictor/tr.md b/comfyui_embedded_docs/docs/LTXVDurationPredictor/tr.md index 56709fb06..56a214435 100644 --- a/comfyui_embedded_docs/docs/LTXVDurationPredictor/tr.md +++ b/comfyui_embedded_docs/docs/LTXVDurationPredictor/tr.md @@ -7,11 +7,11 @@ Bu düğüm, bir prompt için LTX 2.4 süre başlığını (duration head) kulla | Parametre | Açıklama | Veri Türü | Gerekli | Aralık | |-----------|-------------|-----------|----------|-------| | `model` | Metin gömmelerini ön işlemede ve süre başlığını çalıştırmada kullanılan model. | MODEL | Evet | N/A | -| `positive` | Süre tahmini için prompt'un metin gömmelerini ve meta verilerini sağlayan koşullandırma. | CONDITIONING | Evet | N/A | +| `pozitif` | Süre tahmini için prompt'un metin gömmelerini ve meta verilerini sağlayan koşullandırma. | CONDITIONING | Evet | N/A | | `duration_head` | ModelPatchLoader ile yüklenen LTX 2.4 süre başlığı. Bir LTX süre başlığı olmalıdır. | MODEL_PATCH | Evet | N/A | -| `frame_rate` | Saniyeyi kareye dönüştürmek için kullanılan saniyedeki kare sayısı cinsinden kare hızı (varsayılan: 24.0). | FLOAT | Evet | 1.0 ila 120.0 | -| `min_seconds` | Tahmini bir kare sayısına dönüştürürken kullanılan saniye cinsinden minimum süre (varsayılan: 1.0). | FLOAT | Evet | 0.5 ila 120.0 | -| `max_seconds` | Tahmini bir kare sayısına dönüştürürken kullanılan saniye cinsinden maksimum süre (varsayılan: 20.0). | FLOAT | Evet | 0.5 ila 120.0 | +| `kare_hızı` | Saniyeyi kareye dönüştürmek için kullanılan saniyedeki kare sayısı cinsinden kare hızı (varsayılan: 24.0). | FLOAT | Evet | 1.0 ila 120.0 | +| `min_saniye` | Tahmini bir kare sayısına dönüştürürken kullanılan saniye cinsinden minimum süre (varsayılan: 1.0). | FLOAT | Evet | 0.5 ila 120.0 | +| `maks_saniye` | Tahmini bir kare sayısına dönüştürürken kullanılan saniye cinsinden maksimum süre (varsayılan: 20.0). | FLOAT | Evet | 0.5 ila 120.0 | Not: `duration_head` girdisi, ModelPatchLoader ile yüklenmiş bir LTX 2.4 süre başlığı olmalıdır. Bağlı model yaması bir LTX süre başlığı değilse, düğüm bir ValueError hatası oluşturur. @@ -19,8 +19,8 @@ Not: `duration_head` girdisi, ModelPatchLoader ile yüklenmiş bir LTX 2.4 süre | Çıktı Adı | Açıklama | Veri Türü | |-------------|-------------|-----------| -| `num_frames` | Tahmin edilen sürenin kare sayısına dönüştürülmüş ve VAE'nin 8k+1 kare ızgarasına hizalanmış hali. | INT | -| `seconds` | Ham (sınırlanmamış) tahmin edilen süre. Kare ızgarasına hizalanmadan önceki değerdir. | FLOAT | +| `kare_sayısı` | Tahmin edilen sürenin kare sayısına dönüştürülmüş ve VAE'nin 8k+1 kare ızgarasına hizalanmış hali. | INT | +| `saniye` | Ham (sınırlanmamış) tahmin edilen süre. Kare ızgarasına hizalanmadan önceki değerdir. | FLOAT | > Bu belge yapay zeka tarafından oluşturulmuştur. Herhangi bir hata bulursanız veya iyileştirme önerileriniz varsa, katkıda bulunmaktan çekinmeyin! [GitHub'da Düzenle](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVDurationPredictor/tr.md) diff --git a/comfyui_embedded_docs/docs/LTXVEmptyLatentAudio/en.md b/comfyui_embedded_docs/docs/LTXVEmptyLatentAudio/en.md index f69e077a3..c4e682d5d 100644 --- a/comfyui_embedded_docs/docs/LTXVEmptyLatentAudio/en.md +++ b/comfyui_embedded_docs/docs/LTXVEmptyLatentAudio/en.md @@ -1,13 +1,16 @@ # LTXV Empty Latent Audio -The LTXV Empty Latent Audio node creates a batch of empty (zero-filled) latent audio tensors. It uses the configuration from a provided Audio VAE model to determine the correct dimensions for the latent space, such as the number of channels and frequency bins. This empty latent serves as a starting point for audio generation or manipulation workflows within ComfyUI. +```markdown +# LTXV Empty Latent Audio + +The LTXV Empty Latent Audio node creates a batch of empty (zero-filled) latent audio tensors. It uses the configuration from a provided Audio VAE model to determine the correct dimensions for the latent space, such as the number of channels and frequency bins, and computes the number of audio latents from the frame count and frame rate. This empty latent serves as a starting point for audio generation or manipulation workflows within ComfyUI. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | | `frames_number` | Number of frames. The default value is 97. | INT | Yes | 1 to 1000 | -| `frame_rate` | Number of frames per second. The default value is 25. | INT | Yes | 1 to 1000 | +| `frame_rate` | Number of frames per second. The default value is 25.0. Accepts FLOAT or INT values. | FLOAT | Yes | 1.0 to 1000.0 | | `batch_size` | The number of latent audio samples in the batch. The default value is 1. | INT | Yes | 1 to 4096 | | `audio_vae` | The Audio VAE model to get configuration from. This parameter is required. | VAE | Yes | N/A | @@ -18,8 +21,9 @@ The LTXV Empty Latent Audio node creates a batch of empty (zero-filled) latent a | Output Name | Description | Data Type | | --- | --- | --- | | `Latent` | An empty latent audio tensor with the structure (batch_size, z_channels, num_audio_latents, audio_freq) configured to match the input Audio VAE. The output also includes a `type` field set to "audio". | LATENT | +``` > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVEmptyLatentAudio/en.md) --- -**Source fingerprint (SHA-256):** `1b0ecbeb1388d952f5c5178cdc70bb06aad1640112a0851802c387594629f4bf` +**Source fingerprint (SHA-256):** `3ac1bf17ebdba7c3a73bdd795f561b7bee31798d8a1efc11b972db1944f873a4` diff --git a/comfyui_embedded_docs/docs/LTXVImgToVideo/en.md b/comfyui_embedded_docs/docs/LTXVImgToVideo/en.md index 60025c23f..48021aced 100644 --- a/comfyui_embedded_docs/docs/LTXVImgToVideo/en.md +++ b/comfyui_embedded_docs/docs/LTXVImgToVideo/en.md @@ -1,6 +1,6 @@ # LTXVImgToVideo -The LTXVImgToVideo node converts an input image into a video latent representation for video generation models. It takes a single image and extends it into a sequence of frames using the VAE encoder, then applies conditioning with strength control to determine how much of the original image content is preserved versus modified during video generation. +LTXVImgToVideo converts an input image into a video latent representation for video generation models. It resizes the image to the requested width and height, encodes it with the VAE, and places the encoded frames at the start of a video-sized latent of zeros. The strength control determines how much of the original image content is preserved versus modified during video generation. ## Inputs @@ -14,17 +14,19 @@ The LTXVImgToVideo node converts an input image into a video latent representati | `height` | Output video height in pixels (default: 512, step: 32) | INT | No | 64 to MAX_RESOLUTION | | `length` | Number of frames in the generated video (default: 97, step: 8) | INT | No | 9 to MAX_RESOLUTION | | `batch_size` | Number of videos to generate simultaneously (default: 1) | INT | No | 1 to 4096 | -| `strength` | Control over how much of the original image content is preserved in the first frame of the generated video. A value of 1.0 preserves the original image completely, while 0.0 allows maximum modification (default: 1.0) | FLOAT | No | 0.0 to 1.0 | +| `strength` | Control over how much of the original image content is preserved in the first frames of the generated video. A value of 1.0 preserves the original image completely, while 0.0 allows maximum modification (default: 1.0) | FLOAT | No | 0.0 to 1.0 | + +Note: `width` and `height` change in steps of 32 pixels, and `length` changes in steps of 8 frames, matching the video latent compression (32x in the spatial dimensions and 8x in the temporal dimension). The video latent contains ((length - 1) // 8) + 1 frames. ## Outputs | Output Name | Description | Data Type | | --- | --- | --- | -| `positive` | Processed positive conditioning with video frame masking applied | CONDITIONING | -| `negative` | Processed negative conditioning with video frame masking applied | CONDITIONING | -| `latent` | Video latent representation containing the encoded frames and noise mask for video generation | LATENT | +| `positive` | The positive conditioning passed through unchanged for use with the generated latent | CONDITIONING | +| `negative` | The negative conditioning passed through unchanged for use with the generated latent | CONDITIONING | +| `latent` | Video latent representation containing the encoded image frames and a noise mask that controls how strongly the conditioning is applied during video generation | LATENT | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVImgToVideo/en.md) --- -**Source fingerprint (SHA-256):** `1f9d897d1f461270106bf44106acc90db422a04e6bce10ad3bca22127e96ffab` +**Source fingerprint (SHA-256):** `4ebc7f80b4d9ac3329e3349c7048885de22b827b5bdd102976687afd7e07a16b` diff --git a/comfyui_embedded_docs/docs/LTXVImgToVideoInplace/en.md b/comfyui_embedded_docs/docs/LTXVImgToVideoInplace/en.md index 66acc2f23..9a041dd7f 100644 --- a/comfyui_embedded_docs/docs/LTXVImgToVideoInplace/en.md +++ b/comfyui_embedded_docs/docs/LTXVImgToVideoInplace/en.md @@ -1,6 +1,6 @@ # LTXVImgToVideoInplace -The LTXVImgToVideoInplace node conditions a video latent representation by encoding an input image into its initial frames. It works by using a VAE to encode the image into the latent space and then blending it with the existing latent samples based on a specified strength. This allows an image to serve as a starting point or conditioning signal for video generation. +LTXVImgToVideoInplace encodes an input image into the latent space and places those encoded frames at the start of an existing latent video. The `strength` value controls how strongly the encoded image conditions those initial frames, and when `bypass` is enabled, the input latent is returned unchanged. ## Inputs @@ -9,18 +9,18 @@ The LTXVImgToVideoInplace node conditions a video latent representation by encod | `vae` | The VAE model used to encode the input image into the latent space. | VAE | Yes | - | | `image` | The input image to be encoded and used to condition the video latent. | IMAGE | Yes | - | | `latent` | The target latent video representation to be modified. | LATENT | Yes | - | -| `strength` | Controls the blending strength of the encoded image into the latent. A value of 1.0 fully replaces the initial frames, while lower values blend them. (default: 1.0) | FLOAT | No | 0.0 - 1.0 | -| `bypass` | Bypass the conditioning. When enabled, the node returns the input latent unchanged. (default: False) | BOOLEAN | No | - | +| `strength` | Controls how strongly the encoded image conditions the initial frames of the latent. A value of 1.0 fully conditions the initial frames with the encoded image, while lower values condition them less strongly. The noise mask for the initial frames is set to `1.0 - strength`. (default: 1.0) | FLOAT | No | 0.0 - 1.0 | +| `bypass` | Bypass the conditioning. When enabled, the node returns the input latent unchanged. (default: False) | BOOLEAN | No | True or False | -**Note:** The `image` will be automatically resized to match the spatial dimensions required by the `vae` for encoding, based on the `latent` input's width and height. +**Note:** The `image` will be automatically resized to match the spatial dimensions required by the `vae` for encoding, based on the `latent` input's width and height. Only the RGB channels of the `image` are used for encoding. ## Outputs | Output Name | Description | Data Type | | --- | --- | --- | -| `latent` | The modified latent video representation. It contains the updated samples and a `noise_mask` that applies the conditioning strength to the initial frames. | LATENT | +| `latent` | The resulting latent video representation. When bypass is disabled, it contains the updated `samples` and a `noise_mask` that applies the conditioning strength to the initial frames. When bypass is enabled, it is the input latent returned unchanged. | LATENT | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVImgToVideoInplace/en.md) --- -**Source fingerprint (SHA-256):** `5824199a55eb455f28399447d6834ede2cc5c33d1be09e550631bbfeef77d785` +**Source fingerprint (SHA-256):** `69faa4b2e7b0fedeee531dc5a8809e23a79c9ce03e9760afb865160594fef30d` diff --git a/comfyui_embedded_docs/docs/LTXVLatentUpsampler/en.md b/comfyui_embedded_docs/docs/LTXVLatentUpsampler/en.md index 6fced3ca0..bd6bdddfe 100644 --- a/comfyui_embedded_docs/docs/LTXVLatentUpsampler/en.md +++ b/comfyui_embedded_docs/docs/LTXVLatentUpsampler/en.md @@ -10,6 +10,8 @@ The LTXVLatentUpsampler node increases the spatial resolution of a video latent | `upscale_model` | The loaded model used to perform the 2x upscaling on the latent data. | LATENT_UPSCALE_MODEL | Yes | | | `vae` | The VAE model used to un-normalize the input latents before upscaling and to normalize the output latents afterwards. | VAE | Yes | | +Note: This node is marked as experimental in ComfyUI. + ## Outputs | Output Name | Description | Data Type | @@ -19,4 +21,4 @@ The LTXVLatentUpsampler node increases the spatial resolution of a video latent > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVLatentUpsampler/en.md) --- -**Source fingerprint (SHA-256):** `b2c726d3a3e4881eee7e1d3bae8c478adf01cd87a9652be882579f4e26c1536f` +**Source fingerprint (SHA-256):** `7d7f0b733cb3758e9ec985cac30134d719b130b5b86c35bfdd14576a5b4575db` diff --git a/comfyui_embedded_docs/docs/LTXVModalityGuidance/ar.md b/comfyui_embedded_docs/docs/LTXVModalityGuidance/ar.md index 5f4a274f6..3daa37924 100644 --- a/comfyui_embedded_docs/docs/LTXVModalityGuidance/ar.md +++ b/comfyui_embedded_docs/docs/LTXVModalityGuidance/ar.md @@ -6,10 +6,10 @@ | المعامل | الوصف | نوع البيانات | مطلوب | النطاق | |-----------|-------------|-----------|----------|-------| -| `model` | النموذج الأساسي الذي سيتم تطبيق توجيه الوسائط عليه. يتم استنساخه داخليًا، مع بقاء النموذج الأصلي دون تغيير. | MODEL | نعم | - | +| `النموذج` | النموذج الأساسي الذي سيتم تطبيق توجيه الوسائط عليه. يتم استنساخه داخليًا، مع بقاء النموذج الأصلي دون تغيير. | MODEL | نعم | - | | `modality_scale` | قوة توجيه الاقتران الصوتي البصري. القيمة الافتراضية هي 3.0. اضبطها على 1.0 لتعطيل التمرير الأمامي الإضافي. | FLOAT | نعم | 1.0 إلى 100.0 (الافتراضي: 3.0) | -| `start_percent` | النقطة في عملية أخذ العينات، كنسبة مئوية من 0.0 إلى 1.0، التي يبدأ عندها توجيه الوسائط. الافتراضي هو 0.0. | FLOAT | نعم | 0.0 إلى 1.0 (الافتراضي: 0.0) | -| `end_percent` | النقطة في عملية أخذ العينات، كنسبة مئوية من 0.0 إلى 1.0، التي ينتهي عندها توجيه الوسائط. الافتراضي هو 1.0. | FLOAT | نعم | 0.0 إلى 1.0 (الافتراضي: 1.0) | +| `نسبة البداية` | النقطة في عملية أخذ العينات، كنسبة مئوية من 0.0 إلى 1.0، التي يبدأ عندها توجيه الوسائط. الافتراضي هو 0.0. | FLOAT | نعم | 0.0 إلى 1.0 (الافتراضي: 0.0) | +| `نسبة النهاية` | النقطة في عملية أخذ العينات، كنسبة مئوية من 0.0 إلى 1.0، التي ينتهي عندها توجيه الوسائط. الافتراضي هو 1.0. | FLOAT | نعم | 0.0 إلى 1.0 (الافتراضي: 1.0) | يُطبَّق التوجيه فقط على خطوات أخذ العينات التي تقع قيم سيجما الخاصة بها ضمن النطاق المحدد بواسطة `start_percent` و`end_percent`. خارج هذا النطاق، تعيد العقدة النتيجة منزوعة الضوضاء دون تغيير. كما أن ضبط `modality_scale` على 1.0 يعطّل التمرير الأمامي الإضافي بالكامل. diff --git a/comfyui_embedded_docs/docs/LTXVModalityGuidance/en.md b/comfyui_embedded_docs/docs/LTXVModalityGuidance/en.md index ae1f297aa..8a72b6050 100644 --- a/comfyui_embedded_docs/docs/LTXVModalityGuidance/en.md +++ b/comfyui_embedded_docs/docs/LTXVModalityGuidance/en.md @@ -1,6 +1,6 @@ -# LTXVModalityGuidance +# LTXV Modality Guidance (A/V coupling) -This node applies cross-modal (audio-video) guidance to an LTXV-AV model. During sampling, it runs one extra forward pass per step with the audio-to-video and video-to-audio cross-attention connections disabled, then pushes the result toward the coupled prediction. This strengthens audio-visual synchronization, such as lip-sync. The reference default for `modality_scale` is 3.0; setting it to 1.0 disables the extra pass. +This node applies cross-modal (audio-video) guidance to an LTXV-AV model. During sampling, it runs one extra forward pass per step with the audio-to-video and video-to-audio cross-attention connections disabled, then pushes the result toward the coupled prediction to strengthen audio-visual synchronization, such as lip-sync. The reference default for `modality_scale` is 3.0; setting it to 1.0 disables the extra pass, and it stacks with the dual-CFG guider and STG. ## Inputs @@ -8,8 +8,8 @@ This node applies cross-modal (audio-video) guidance to an LTXV-AV model. During |-----------|-------------|-----------|----------|-------| | `model` | The base model to which modality guidance will be applied. It is cloned internally, leaving the original model unchanged. | MODEL | Yes | - | | `modality_scale` | Strength of the audio-video coupling guidance. Default is 3.0. Set to 1.0 to disable the extra forward pass. | FLOAT | Yes | 1.0 to 100.0 (default: 3.0) | -| `start_percent` | The point in the sampling process, as a percentage from 0.0 to 1.0, at which modality guidance begins. Default is 0.0. | FLOAT | Yes | 0.0 to 1.0 (default: 0.0) | -| `end_percent` | The point in the sampling process, as a percentage from 0.0 to 1.0, at which modality guidance ends. Default is 1.0. | FLOAT | Yes | 0.0 to 1.0 (default: 1.0) | +| `start_percent` | The point in the sampling process, as a percentage from 0.0 to 1.0, at which modality guidance begins. This is an advanced parameter. Default is 0.0. | FLOAT | Yes | 0.0 to 1.0 (default: 0.0) | +| `end_percent` | The point in the sampling process, as a percentage from 0.0 to 1.0, at which modality guidance ends. This is an advanced parameter. Default is 1.0. | FLOAT | Yes | 0.0 to 1.0 (default: 1.0) | Guidance is applied only for sampling steps whose sigma values fall within the range defined by `start_percent` and `end_percent`. Outside this range, the node returns the denoised result unchanged. A `modality_scale` of 1.0 also disables the extra forward pass entirely. diff --git a/comfyui_embedded_docs/docs/LTXVModalityGuidance/es.md b/comfyui_embedded_docs/docs/LTXVModalityGuidance/es.md index 6d57dd6c1..2dc13914c 100644 --- a/comfyui_embedded_docs/docs/LTXVModalityGuidance/es.md +++ b/comfyui_embedded_docs/docs/LTXVModalityGuidance/es.md @@ -6,10 +6,10 @@ Este nodo aplica guía multimodal (audio-video) a un modelo LTXV-AV. Durante el | Parámetro | Descripción | Tipo de dato | Requerido | Rango | |-----------|-------------|--------------|-----------|-------| -| `model` | El modelo base al que se le aplicará la guía multimodal. Se clona internamente, dejando el modelo original sin cambios. | MODEL | Sí | - | +| `modelo` | El modelo base al que se le aplicará la guía multimodal. Se clona internamente, dejando el modelo original sin cambios. | MODEL | Sí | - | | `modality_scale` | Fuerza de la guía de acoplamiento audio-video. El valor predeterminado es 3.0. Configúrelo en 1.0 para desactivar la pasada adicional hacia adelante. | FLOAT | Sí | 1.0 a 100.0 (default: 3.0) | -| `start_percent` | El punto del proceso de muestreo, como porcentaje de 0.0 a 1.0, en el que comienza la guía multimodal. El valor predeterminado es 0.0. | FLOAT | Sí | 0.0 a 1.0 (default: 0.0) | -| `end_percent` | El punto del proceso de muestreo, como porcentaje de 0.0 a 1.0, en el que termina la guía multimodal. El valor predeterminado es 1.0. | FLOAT | Sí | 0.0 a 1.0 (default: 1.0) | +| `porcentaje_inicio` | El punto del proceso de muestreo, como porcentaje de 0.0 a 1.0, en el que comienza la guía multimodal. El valor predeterminado es 0.0. | FLOAT | Sí | 0.0 a 1.0 (default: 0.0) | +| `porcentaje_fin` | El punto del proceso de muestreo, como porcentaje de 0.0 a 1.0, en el que termina la guía multimodal. El valor predeterminado es 1.0. | FLOAT | Sí | 0.0 a 1.0 (default: 1.0) | La guía se aplica solo para los pasos de muestreo cuyos valores de sigma se encuentran dentro del rango definido por `start_percent` y `end_percent`. Fuera de este rango, el nodo devuelve el resultado denoizado sin cambios. Un `modality_scale` de 1.0 también desactiva por completo la pasada adicional hacia adelante. diff --git a/comfyui_embedded_docs/docs/LTXVModalityGuidance/fa.md b/comfyui_embedded_docs/docs/LTXVModalityGuidance/fa.md index 0044ad731..f2309ba0b 100644 --- a/comfyui_embedded_docs/docs/LTXVModalityGuidance/fa.md +++ b/comfyui_embedded_docs/docs/LTXVModalityGuidance/fa.md @@ -6,10 +6,10 @@ | پارامتر | توضیحات | نوع داده | الزامی | محدوده | |---------|---------|----------|--------|--------| -| `model` | مدل پایه‌ای که راهنمایی حالتی به آن اعمال می‌شود. به‌صورت داخلی کلون می‌شود و مدل اصلی بدون تغییر باقی می‌ماند. | MODEL | بله | - | -| `modality_scale` | شدت راهنمایی جفت‌شدگی صوتی-تصویری. پیش‌فرض 3.0 است. برای غیرفعال‌سازی گذر روبه‌جلو اضافی، آن را روی 1.0 تنظیم کنید. | FLOAT | بله | 1.0 تا 100.0 (default: 3.0) | -| `start_percent` | نقطه‌ای در فرایند نمونه‌برداری، به‌صورت درصد از 0.0 تا 1.0، که در آن راهنمایی حالتی آغاز می‌شود. پیش‌فرض 0.0 است. | FLOAT | بله | 0.0 تا 1.0 (default: 0.0) | -| `end_percent` | نقطه‌ای در فرایند نمونه‌برداری، به‌صورت درصد از 0.0 تا 1.0، که در آن راهنمایی حالتی پایان می‌یابد. پیش‌فرض 1.0 است. | FLOAT | بله | 0.0 تا 1.0 (default: 1.0) | +| `مدل` | مدل پایه‌ای که راهنمایی حالتی به آن اعمال می‌شود. به‌صورت داخلی کلون می‌شود و مدل اصلی بدون تغییر باقی می‌ماند. | MODEL | بله | - | +| `مقیاس حالت` | شدت راهنمایی جفت‌شدگی صوتی-تصویری. پیش‌فرض 3.0 است. برای غیرفعال‌سازی گذر روبه‌جلو اضافی، آن را روی 1.0 تنظیم کنید. | FLOAT | بله | 1.0 تا 100.0 (default: 3.0) | +| `درصد شروع` | نقطه‌ای در فرایند نمونه‌برداری، به‌صورت درصد از 0.0 تا 1.0، که در آن راهنمایی حالتی آغاز می‌شود. پیش‌فرض 0.0 است. | FLOAT | بله | 0.0 تا 1.0 (default: 0.0) | +| `درصد پایان` | نقطه‌ای در فرایند نمونه‌برداری، به‌صورت درصد از 0.0 تا 1.0، که در آن راهنمایی حالتی پایان می‌یابد. پیش‌فرض 1.0 است. | FLOAT | بله | 0.0 تا 1.0 (default: 1.0) | راهنمایی فقط برای گام‌های نمونه‌برداری اعمال می‌شود که مقادیر سیگمای آن‌ها در بازه‌ای که توسط `start_percent` و `end_percent` تعریف شده، قرار می‌گیرند. خارج از این بازه، گره نتیجهٔ نویززدایی‌شده را بدون تغییر برمی‌گرداند. مقدار `modality_scale` برابر با 1.0 نیز گذر روبه‌جلو اضافی را کاملاً غیرفعال می‌کند. diff --git a/comfyui_embedded_docs/docs/LTXVModalityGuidance/fr.md b/comfyui_embedded_docs/docs/LTXVModalityGuidance/fr.md index 5b8dae385..bbed12e66 100644 --- a/comfyui_embedded_docs/docs/LTXVModalityGuidance/fr.md +++ b/comfyui_embedded_docs/docs/LTXVModalityGuidance/fr.md @@ -6,10 +6,10 @@ Ce nœud applique un guidage cross-modal (audio-vidéo) à un modèle LTXV-AV. P | Paramètre | Description | Type de données | Requis | Plage | |-----------|-------------|-----------------|--------|-------| -| `model` | Le modèle de base auquel le guidage de modalité sera appliqué. Il est cloné en interne, laissant le modèle original inchangé. | MODEL | Oui | - | +| `modèle` | Le modèle de base auquel le guidage de modalité sera appliqué. Il est cloné en interne, laissant le modèle original inchangé. | MODEL | Oui | - | | `modality_scale` | Force du guidage de couplage audio-vidéo. La valeur par défaut est 3.0. Réglez sur 1.0 pour désactiver la passe avant supplémentaire. | FLOAT | Oui | 1.0 à 100.0 (default: 3.0) | -| `start_percent` | Le point du processus d'échantillonnage, en pourcentage de 0.0 à 1.0, auquel le guidage de modalité commence. La valeur par défaut est 0.0. | FLOAT | Oui | 0.0 à 1.0 (default: 0.0) | -| `end_percent` | Le point du processus d'échantillonnage, en pourcentage de 0.0 à 1.0, auquel le guidage de modalité se termine. La valeur par défaut est 1.0. | FLOAT | Oui | 0.0 à 1.0 (default: 1.0) | +| `pourcentage_début` | Le point du processus d'échantillonnage, en pourcentage de 0.0 à 1.0, auquel le guidage de modalité commence. La valeur par défaut est 0.0. | FLOAT | Oui | 0.0 à 1.0 (default: 0.0) | +| `pourcentage_fin` | Le point du processus d'échantillonnage, en pourcentage de 0.0 à 1.0, auquel le guidage de modalité se termine. La valeur par défaut est 1.0. | FLOAT | Oui | 0.0 à 1.0 (default: 1.0) | Le guidage n'est appliqué que pour les étapes d'échantillonnage dont les valeurs de sigma se situent dans la plage définie par `start_percent` et `end_percent`. En dehors de cette plage, le nœud renvoie le résultat débruité inchangé. Un `modality_scale` de 1.0 désactive également entièrement la passe avant supplémentaire. diff --git a/comfyui_embedded_docs/docs/LTXVModalityGuidance/tr.md b/comfyui_embedded_docs/docs/LTXVModalityGuidance/tr.md index eb5d6db20..db2576668 100644 --- a/comfyui_embedded_docs/docs/LTXVModalityGuidance/tr.md +++ b/comfyui_embedded_docs/docs/LTXVModalityGuidance/tr.md @@ -8,8 +8,8 @@ Bu düğüm, bir LTXV-AV modeline çapraz mod (ses-video) yönlendirmesi uygular |-----------|-------------|-----------|----------|-------| | `model` | Üzerine modalite yönlendirmesi uygulanacak temel model. Dahili olarak klonlanır ve orijinal model değişmeden bırakılır. | MODEL | Evet | - | | `modality_scale` | Ses-video birleştirme yönlendirmesinin gücü. Varsayılan 3.0'dır. Ekstra ileri geçişi devre dışı bırakmak için 1.0 olarak ayarlayın. | FLOAT | Evet | 1.0 ile 100.0 arası (default: 3.0) | -| `start_percent` | Modalite yönlendirmesinin başladığı örnekleme sürecindeki nokta (0.0 ile 1.0 arasında bir yüzde). Varsayılan 0.0'dır. | FLOAT | Evet | 0.0 ile 1.0 arası (default: 0.0) | -| `end_percent` | Modalite yönlendirmesinin sona erdiği örnekleme sürecindeki nokta (0.0 ile 1.0 arasında bir yüzde). Varsayılan 1.0'dır. | FLOAT | Evet | 0.0 ile 1.0 arası (default: 1.0) | +| `başlangıç_yüzdesi` | Modalite yönlendirmesinin başladığı örnekleme sürecindeki nokta (0.0 ile 1.0 arasında bir yüzde). Varsayılan 0.0'dır. | FLOAT | Evet | 0.0 ile 1.0 arası (default: 0.0) | +| `bitiş_yüzdesi` | Modalite yönlendirmesinin sona erdiği örnekleme sürecindeki nokta (0.0 ile 1.0 arasında bir yüzde). Varsayılan 1.0'dır. | FLOAT | Evet | 0.0 ile 1.0 arası (default: 1.0) | Yönlendirme yalnızca sigma değerleri `start_percent` ve `end_percent` tarafından tanımlanan aralığa giren örnekleme adımlarına uygulanır. Bu aralığın dışında, düğüm gürültüsü giderilmiş sonucu değiştirmeden döndürür. `modality_scale` değerinin 1.0 olması ayrıca ekstra ileri geçişi tamamen devre dışı bırakır. diff --git a/comfyui_embedded_docs/docs/LTXVReferenceAudio/en.md b/comfyui_embedded_docs/docs/LTXVReferenceAudio/en.md index ff8878f0c..c4ed44774 100644 --- a/comfyui_embedded_docs/docs/LTXVReferenceAudio/en.md +++ b/comfyui_embedded_docs/docs/LTXVReferenceAudio/en.md @@ -1,6 +1,6 @@ # LTXV Reference Audio (ID-LoRA) -The LTXV Reference Audio node is used for speaker identity transfer in audio generation. It encodes a reference audio clip into the conditioning for a model, allowing the generated audio to adopt the speaker's voice characteristics. It can also apply identity guidance, which runs an extra processing step to amplify the speaker identity effect. +LTXV Reference Audio transfers the voice identity of a speaker from a reference audio clip to generated audio. It encodes the reference audio into the conditioning and optionally patches the model with identity guidance, which runs an extra forward pass without the reference each step to amplify the speaker identity effect. ## Inputs @@ -10,10 +10,12 @@ The LTXV Reference Audio node is used for speaker identity transfer in audio gen | `positive` | The positive conditioning input. | CONDITIONING | Yes | - | | `negative` | The negative conditioning input. | CONDITIONING | Yes | - | | `reference_audio` | Reference audio clip whose speaker identity to transfer. ~5 seconds recommended (training duration). Shorter or longer clips may degrade voice identity transfer. | AUDIO | Yes | - | -| `audio_vae` | LTXV Audio VAE for encoding the reference audio. | VAE | Yes | - | -| `identity_guidance_scale` | Strength of identity guidance. Runs an extra forward pass without reference each step to amplify speaker identity. Set to 0 to disable (no extra pass). (default: 3.0) | FLOAT | No | 0.0 - 100.0 | -| `start_percent` | Start of the sigma range where identity guidance is active. (default: 0.0) | FLOAT | No | 0.0 - 1.0 | -| `end_percent` | End of the sigma range where identity guidance is active. (default: 1.0) | FLOAT | No | 0.0 - 1.0 | +| `audio_vae` | LTXV Audio VAE for encoding. | VAE | Yes | - | +| `identity_guidance_scale` | Strength of identity guidance. Runs an extra forward pass without reference each step to amplify speaker identity. Set to 0 to disable (no extra pass). (default: 3.0) | FLOAT | Yes | 0.0 - 100.0 | +| `start_percent` | Start of the sigma range where identity guidance is active. (default: 0.0) | FLOAT | Yes | 0.0 - 1.0 | +| `end_percent` | End of the sigma range where identity guidance is active. (default: 1.0) | FLOAT | Yes | 0.0 - 1.0 | + +Note: Identity guidance is only applied when `identity_guidance_scale` is greater than 0 and the current sampling step is within the range defined by `start_percent` and `end_percent`. The reference audio is resampled to the audio VAE's sample rate if the two differ. ## Outputs @@ -26,4 +28,4 @@ The LTXV Reference Audio node is used for speaker identity transfer in audio gen > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVReferenceAudio/en.md) --- -**Source fingerprint (SHA-256):** `a25e24a08df73b8a34fd476544634e396a0eec5b6dc630e911c371f1b16931b8` +**Source fingerprint (SHA-256):** `ae15c5838656324667d099614b325b863341f05afda43054658999574522dd49` diff --git a/comfyui_embedded_docs/docs/LTXVScheduler/en.md b/comfyui_embedded_docs/docs/LTXVScheduler/en.md index 01875e353..35914ea34 100644 --- a/comfyui_embedded_docs/docs/LTXVScheduler/en.md +++ b/comfyui_embedded_docs/docs/LTXVScheduler/en.md @@ -24,4 +24,4 @@ The LTXVScheduler node generates sigma values for custom sampling processes. It > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVScheduler/en.md) --- -**Source fingerprint (SHA-256):** `63a827c5a5e54370eab4cd259c00ccc3d2bada6e61988011cbd1e779233604bb` +**Source fingerprint (SHA-256):** `5b4907e905e27a951c332c400e24023ef089df7a5f4a17b1fc8ba42a41302399` diff --git a/comfyui_embedded_docs/docs/LTXVSeparateAVLatent/en.md b/comfyui_embedded_docs/docs/LTXVSeparateAVLatent/en.md index 68ac44313..be2383a22 100644 --- a/comfyui_embedded_docs/docs/LTXVSeparateAVLatent/en.md +++ b/comfyui_embedded_docs/docs/LTXVSeparateAVLatent/en.md @@ -1,12 +1,12 @@ -# LTXVSeparateAVLatent +# Separate AV Latent -The LTXVSeparateAVLatent node takes a combined audio-visual latent representation and splits it into two distinct parts: one for video and one for audio. It separates the samples and, if present, the noise masks from the input latent, creating two new latent objects. +The LTXVSeparateAVLatent node splits a combined audio-visual latent into two separate latents: one containing the video data and one containing the audio data. This works with any audio-visual model, such as LTXV or MiniMax H3. The samples tensor is split along its first dimension, with the first element becoming the video latent and the second element becoming the audio latent; if a noise mask is present, it is split in the same way. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `av_latent` | The combined audio-visual latent representation to be separated. | LATENT | Yes | N/A | +| `av_latent` | The combined audio-visual latent representation to be split into video and audio latents. | LATENT | Yes | N/A | **Note:** The input latent's `samples` tensor is expected to have at least two elements along the first dimension (batch dimension). The first element is used for the video latent, and the second element is used for the audio latent. If a `noise_mask` is present, it is split in the same way. @@ -20,4 +20,4 @@ The LTXVSeparateAVLatent node takes a combined audio-visual latent representatio > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVSeparateAVLatent/en.md) --- -**Source fingerprint (SHA-256):** `8e871b6163af27826c197c678214bac7a02c2a5b24279385ba34632c7116356c` +**Source fingerprint (SHA-256):** `22ed38bbc1b5716cee380c35c50455810f79c273f51bbe6a535c9ae33192afe6` diff --git a/comfyui_embedded_docs/docs/LTXVSpatioTemporalGuidance/ar.md b/comfyui_embedded_docs/docs/LTXVSpatioTemporalGuidance/ar.md index b78c58702..916593d8f 100644 --- a/comfyui_embedded_docs/docs/LTXVSpatioTemporalGuidance/ar.md +++ b/comfyui_embedded_docs/docs/LTXVSpatioTemporalGuidance/ar.md @@ -6,11 +6,11 @@ | المعامل | الوصف | نوع البيانات | إلزامي | النطاق | |-----------|-------------|-----------|----------|-------| -| `model` | النموذج الأساسي الذي سيتم تطبيق التوجيه المكاني الزمني عليه. يتم استنساخ النموذج وتعديله باستخدام دالة توجيه ما بعد CFG. | MODEL | نعم | — | -| `scale` | قوة التوجيه المطبقة على النتيجة المنقّاة من التشويش. عند الضبط على 0، لا يكون للتوجيه أي تأثير. (الافتراضي: 1.0) | FLOAT | نعم | 0.0 إلى 100.0 (الخطوة 0.01) | -| `blocks` | فهارس كتل المحول المراد التعديل عليها، مفصولة بفواصل. يتم استخدام القيم الرقمية فقط؛ يتم تجاهل أي أحرف أخرى. (الافتراضي: "29") | STRING | نعم | — | -| `start_percent` | جزء عملية أخذ العينات الذي يبدأ عنده التوجيه. (الافتراضي: 0.0) | FLOAT | نعم | 0.0 إلى 1.0 (الخطوة 0.001) | -| `end_percent` | جزء عملية أخذ العينات الذي ينتهي عنده التوجيه. (الافتراضي: 1.0) | FLOAT | نعم | 0.0 إلى 1.0 (الخطوة 0.001) | +| `النموذج` | النموذج الأساسي الذي سيتم تطبيق التوجيه المكاني الزمني عليه. يتم استنساخ النموذج وتعديله باستخدام دالة توجيه ما بعد CFG. | MODEL | نعم | — | +| `المقياس` | قوة التوجيه المطبقة على النتيجة المنقّاة من التشويش. عند الضبط على 0، لا يكون للتوجيه أي تأثير. (الافتراضي: 1.0) | FLOAT | نعم | 0.0 إلى 100.0 (الخطوة 0.01) | +| `الكتل` | فهارس كتل المحول المراد التعديل عليها، مفصولة بفواصل. يتم استخدام القيم الرقمية فقط؛ يتم تجاهل أي أحرف أخرى. (الافتراضي: "29") | STRING | نعم | — | +| `نسبة البداية` | جزء عملية أخذ العينات الذي يبدأ عنده التوجيه. (الافتراضي: 0.0) | FLOAT | نعم | 0.0 إلى 1.0 (الخطوة 0.001) | +| `نسبة النهاية` | جزء عملية أخذ العينات الذي ينتهي عنده التوجيه. (الافتراضي: 1.0) | FLOAT | نعم | 0.0 إلى 1.0 (الخطوة 0.001) | ملاحظة: يتم تطبيق التوجيه فقط خلال الفاصل الزمني لأخذ العينات بين `start_percent` و`end_percent`. إذا كانت قيمة `scale` تساوي 0 أو إذا كانت `blocks` لا تحتوي على قيم رقمية، فلن يكون للتمريرة الموجّهة أي تأثير على عملية أخذ العينات. diff --git a/comfyui_embedded_docs/docs/LTXVSpatioTemporalGuidance/en.md b/comfyui_embedded_docs/docs/LTXVSpatioTemporalGuidance/en.md index d6c622486..378559ac0 100644 --- a/comfyui_embedded_docs/docs/LTXVSpatioTemporalGuidance/en.md +++ b/comfyui_embedded_docs/docs/LTXVSpatioTemporalGuidance/en.md @@ -1,4 +1,4 @@ -# LTXVSpatioTemporalGuidance +# LTXV Spatio-Temporal Guidance (STG) This node improves the spatial detail and motion coherence of LTXV video generation by running an extra pass at each sampling step. During this pass, the self-attention of the selected transformer blocks is degraded to a value-passthrough, and the generation is guided away from the degraded result. @@ -9,8 +9,8 @@ This node improves the spatial detail and motion coherence of LTXV video generat | `model` | The base model to apply spatio-temporal guidance to. The model is cloned and modified with a post-CFG guidance function. | MODEL | Yes | — | | `scale` | The strength of the guidance applied to the denoised result. When set to 0, guidance has no effect. (default: 1.0) | FLOAT | Yes | 0.0 to 100.0 (step 0.01) | | `blocks` | Comma-separated transformer block indices to perturb. Only numeric values are used; any other characters are ignored. (default: "29") | STRING | Yes | — | -| `start_percent` | The fraction of the sampling process at which guidance begins. (default: 0.0) | FLOAT | Yes | 0.0 to 1.0 (step 0.001) | -| `end_percent` | The fraction of the sampling process at which guidance ends. (default: 1.0) | FLOAT | Yes | 0.0 to 1.0 (step 0.001) | +| `start_percent` | The fraction of the sampling process at which guidance begins. This is an advanced parameter. (default: 0.0) | FLOAT | Yes | 0.0 to 1.0 (step 0.001) | +| `end_percent` | The fraction of the sampling process at which guidance ends. This is an advanced parameter. (default: 1.0) | FLOAT | Yes | 0.0 to 1.0 (step 0.001) | Note: Guidance is only applied during the sampling interval between `start_percent` and `end_percent`. If `scale` is 0 or `blocks` contains no numeric values, the guided pass has no effect on the sampling process. diff --git a/comfyui_embedded_docs/docs/LTXVSpatioTemporalGuidance/es.md b/comfyui_embedded_docs/docs/LTXVSpatioTemporalGuidance/es.md index e5e5a0254..3bad524f8 100644 --- a/comfyui_embedded_docs/docs/LTXVSpatioTemporalGuidance/es.md +++ b/comfyui_embedded_docs/docs/LTXVSpatioTemporalGuidance/es.md @@ -6,11 +6,11 @@ Este nodo mejora el detalle espacial y la coherencia del movimiento en la genera | Parámetro | Descripción | Tipo de datos | Requerido | Rango | |-----------|-------------|---------------|-----------|-------| -| `model` | El modelo base al que se le aplica la guía espacio-temporal. El modelo se clona y se modifica con una función de guía posterior a CFG. | MODEL | Sí | — | -| `scale` | La fuerza de la guía aplicada al resultado sin ruido. Cuando se establece en 0, la guía no tiene efecto. (por defecto: 1.0) | FLOAT | Sí | 0.0 a 100.0 (paso 0.01) | -| `blocks` | Índices de bloques del transformador separados por comas para perturbar. Solo se utilizan valores numéricos; cualquier otro carácter se ignora. (por defecto: "29") | STRING | Sí | — | -| `start_percent` | La fracción del proceso de muestreo en la que comienza la guía. (por defecto: 0.0) | FLOAT | Sí | 0.0 a 1.0 (paso 0.001) | -| `end_percent` | La fracción del proceso de muestreo en la que finaliza la guía. (por defecto: 1.0) | FLOAT | Sí | 0.0 a 1.0 (paso 0.001) | +| `modelo` | El modelo base al que se le aplica la guía espacio-temporal. El modelo se clona y se modifica con una función de guía posterior a CFG. | MODEL | Sí | — | +| `escala` | La fuerza de la guía aplicada al resultado sin ruido. Cuando se establece en 0, la guía no tiene efecto. (por defecto: 1.0) | FLOAT | Sí | 0.0 a 100.0 (paso 0.01) | +| `bloques` | Índices de bloques del transformador separados por comas para perturbar. Solo se utilizan valores numéricos; cualquier otro carácter se ignora. (por defecto: "29") | STRING | Sí | — | +| `porcentaje_inicio` | La fracción del proceso de muestreo en la que comienza la guía. (por defecto: 0.0) | FLOAT | Sí | 0.0 a 1.0 (paso 0.001) | +| `porcentaje_fin` | La fracción del proceso de muestreo en la que finaliza la guía. (por defecto: 1.0) | FLOAT | Sí | 0.0 a 1.0 (paso 0.001) | Nota: La guía solo se aplica durante el intervalo de muestreo entre `start_percent` y `end_percent`. Si `scale` es 0 o `blocks` no contiene valores numéricos, la pasada guiada no tiene efecto en el proceso de muestreo. diff --git a/comfyui_embedded_docs/docs/LTXVSpatioTemporalGuidance/fa.md b/comfyui_embedded_docs/docs/LTXVSpatioTemporalGuidance/fa.md index 8b366994e..292819a00 100644 --- a/comfyui_embedded_docs/docs/LTXVSpatioTemporalGuidance/fa.md +++ b/comfyui_embedded_docs/docs/LTXVSpatioTemporalGuidance/fa.md @@ -4,11 +4,11 @@ | پارامتر | توضیحات | نوع داده | الزامی | محدوده | |---------|---------|----------|--------|--------| -| `model` | مدل پایه که راهنمای فضایی-زمانی روی آن اعمال می‌شود. مدل کلون‌سازی شده و با یک تابع راهنمای پس از CFG اصلاح می‌شود. | MODEL | بله | — | -| `scale` | قدرت راهنمای اعمال‌شده بر نتیجهٔ نویززدایی‌شده. هنگامی که روی 0 تنظیم شود، راهنما هیچ اثری ندارد. (پیش‌فرض: 1.0) | FLOAT | بله | 0.0 تا 100.0 (گام 0.01) | -| `blocks` | شاخص‌های بلوک ترنسفورمر برای اختلال، با کاما جدا شده‌اند. فقط مقادیر عددی استفاده می‌شوند؛ هر کاراکتر دیگری نادیده گرفته می‌شود. (پیش‌فرض: "29") | STRING | بله | — | -| `start_percent` | کسری از فرایند نمونه‌برداری که راهنما در آن آغاز می‌شود. (پیش‌فرض: 0.0) | FLOAT | بله | 0.0 تا 1.0 (گام 0.001) | -| `end_percent` | کسری از فرایند نمونه‌برداری که راهنما در آن پایان می‌یابد. (پیش‌فرض: 1.0) | FLOAT | بله | 0.0 تا 1.0 (گام 0.001) | +| `مدل` | مدل پایه که راهنمای فضایی-زمانی روی آن اعمال می‌شود. مدل کلون‌سازی شده و با یک تابع راهنمای پس از CFG اصلاح می‌شود. | MODEL | بله | — | +| `مقیاس` | قدرت راهنمای اعمال‌شده بر نتیجهٔ نویززدایی‌شده. هنگامی که روی 0 تنظیم شود، راهنما هیچ اثری ندارد. (پیش‌فرض: 1.0) | FLOAT | بله | 0.0 تا 100.0 (گام 0.01) | +| `بلوک‌ها` | شاخص‌های بلوک ترنسفورمر برای اختلال، با کاما جدا شده‌اند. فقط مقادیر عددی استفاده می‌شوند؛ هر کاراکتر دیگری نادیده گرفته می‌شود. (پیش‌فرض: "29") | STRING | بله | — | +| `درصد شروع` | کسری از فرایند نمونه‌برداری که راهنما در آن آغاز می‌شود. (پیش‌فرض: 0.0) | FLOAT | بله | 0.0 تا 1.0 (گام 0.001) | +| `درصد پایان` | کسری از فرایند نمونه‌برداری که راهنما در آن پایان می‌یابد. (پیش‌فرض: 1.0) | FLOAT | بله | 0.0 تا 1.0 (گام 0.001) | نکته: راهنما فقط در بازهٔ نمونه‌برداری بین `start_percent` و `end_percent` اعمال می‌شود. اگر `scale` برابر 0 باشد یا `blocks` حاوی مقادیر عددی نباشد، گذر راهنماشده بر فرایند نمونه‌برداری اثری ندارد. diff --git a/comfyui_embedded_docs/docs/LTXVSpatioTemporalGuidance/fr.md b/comfyui_embedded_docs/docs/LTXVSpatioTemporalGuidance/fr.md index 19a3493f9..b0bd73cb4 100644 --- a/comfyui_embedded_docs/docs/LTXVSpatioTemporalGuidance/fr.md +++ b/comfyui_embedded_docs/docs/LTXVSpatioTemporalGuidance/fr.md @@ -6,11 +6,11 @@ Ce nœud améliore le détail spatial et la cohérence du mouvement de la géné | Paramètre | Description | Type de données | Requis | Plage | |-----------|-------------|-----------------|--------|-------| -| `model` | Le modèle de base auquel appliquer le guidage spatio-temporel. Le modèle est cloné et modifié avec une fonction de guidage post-CFG. | MODEL | Oui | — | -| `scale` | La force du guidage appliqué au résultat débruité. Lorsqu'elle est définie à 0, le guidage n'a aucun effet. (défaut : 1.0) | FLOAT | Oui | 0.0 à 100.0 (pas 0.01) | -| `blocks` | Indices de blocs de transformateur séparés par des virgules à perturber. Seules les valeurs numériques sont utilisées ; tous les autres caractères sont ignorés. (défaut : "29") | STRING | Oui | — | -| `start_percent` | La fraction du processus d'échantillonnage à laquelle le guidage commence. (défaut : 0.0) | FLOAT | Oui | 0.0 à 1.0 (pas 0.001) | -| `end_percent` | La fraction du processus d'échantillonnage à laquelle le guidage se termine. (défaut : 1.0) | FLOAT | Oui | 0.0 à 1.0 (pas 0.001) | +| `modèle` | Le modèle de base auquel appliquer le guidage spatio-temporel. Le modèle est cloné et modifié avec une fonction de guidage post-CFG. | MODEL | Oui | — | +| `échelle` | La force du guidage appliqué au résultat débruité. Lorsqu'elle est définie à 0, le guidage n'a aucun effet. (défaut : 1.0) | FLOAT | Oui | 0.0 à 100.0 (pas 0.01) | +| `blocs` | Indices de blocs de transformateur séparés par des virgules à perturber. Seules les valeurs numériques sont utilisées ; tous les autres caractères sont ignorés. (défaut : "29") | STRING | Oui | — | +| `pourcentage_début` | La fraction du processus d'échantillonnage à laquelle le guidage commence. (défaut : 0.0) | FLOAT | Oui | 0.0 à 1.0 (pas 0.001) | +| `pourcentage_fin` | La fraction du processus d'échantillonnage à laquelle le guidage se termine. (défaut : 1.0) | FLOAT | Oui | 0.0 à 1.0 (pas 0.001) | Remarque : Le guidage n'est appliqué que pendant l'intervalle d'échantillonnage entre `start_percent` et `end_percent`. Si `scale` est 0 ou si `blocks` ne contient aucune valeur numérique, la passe guidée n'a aucun effet sur le processus d'échantillonnage. diff --git a/comfyui_embedded_docs/docs/LTXVSpatioTemporalGuidance/tr.md b/comfyui_embedded_docs/docs/LTXVSpatioTemporalGuidance/tr.md index 1c5c6d028..aad527fc4 100644 --- a/comfyui_embedded_docs/docs/LTXVSpatioTemporalGuidance/tr.md +++ b/comfyui_embedded_docs/docs/LTXVSpatioTemporalGuidance/tr.md @@ -7,10 +7,10 @@ Bu düğüm, her örnekleme adımında ekstra bir geçiş çalıştırarak LTXV | Parametre | Açıklama | Veri Türü | Gerekli | Aralık | |-----------|-------------|-----------|----------|-------| | `model` | Uzamsal-zamansal rehberliğin uygulanacağı temel model. Model kopyalanır ve CFG sonrası rehberlik işleviyle değiştirilir. | MODEL | Evet | — | -| `scale` | Gürültü giderme sonucuna uygulanan rehberliğin gücü. 0 olarak ayarlandığında rehberliğin etkisi olmaz. (varsayılan: 1.0) | FLOAT | Evet | 0.0 ila 100.0 (adım 0.01) | -| `blocks` | Bozulacak virgülle ayrılmış transformatör blok dizinleri. Yalnızca sayısal değerler kullanılır; diğer tüm karakterler yok sayılır. (varsayılan: "29") | STRING | Evet | — | -| `start_percent` | Rehberliğin başladığı örnekleme sürecinin kesri. (varsayılan: 0.0) | FLOAT | Evet | 0.0 ila 1.0 (adım 0.001) | -| `end_percent` | Rehberliğin bittiği örnekleme sürecinin kesri. (varsayılan: 1.0) | FLOAT | Evet | 0.0 ila 1.0 (adım 0.001) | +| `ölçek` | Gürültü giderme sonucuna uygulanan rehberliğin gücü. 0 olarak ayarlandığında rehberliğin etkisi olmaz. (varsayılan: 1.0) | FLOAT | Evet | 0.0 ila 100.0 (adım 0.01) | +| `bloklar` | Bozulacak virgülle ayrılmış transformatör blok dizinleri. Yalnızca sayısal değerler kullanılır; diğer tüm karakterler yok sayılır. (varsayılan: "29") | STRING | Evet | — | +| `başlangıç_yüzdesi` | Rehberliğin başladığı örnekleme sürecinin kesri. (varsayılan: 0.0) | FLOAT | Evet | 0.0 ila 1.0 (adım 0.001) | +| `bitiş_yüzdesi` | Rehberliğin bittiği örnekleme sürecinin kesri. (varsayılan: 1.0) | FLOAT | Evet | 0.0 ila 1.0 (adım 0.001) | Not: Rehberlik yalnızca `start_percent` ile `end_percent` arasındaki örnekleme aralığında uygulanır. `scale` 0 ise veya `blocks` sayısal değer içermiyorsa, rehberli geçişin örnekleme sürecine etkisi olmaz. diff --git a/comfyui_embedded_docs/docs/LaplaceScheduler/en.md b/comfyui_embedded_docs/docs/LaplaceScheduler/en.md index 5aa5b8278..8686c6959 100644 --- a/comfyui_embedded_docs/docs/LaplaceScheduler/en.md +++ b/comfyui_embedded_docs/docs/LaplaceScheduler/en.md @@ -12,6 +12,8 @@ The LaplaceScheduler node generates a sequence of sigma values following a Lapla | `mu` | Mean parameter for the Laplace distribution (default: 0.0) | FLOAT | Yes | -10.0 to 10.0 | | `beta` | Scale parameter for the Laplace distribution (default: 0.5) | FLOAT | Yes | 0.0 to 10.0 | +Note: `sigma_max`, `sigma_min`, `mu`, and `beta` are advanced parameters. + ## Outputs | Output Name | Description | Data Type | @@ -21,4 +23,4 @@ The LaplaceScheduler node generates a sequence of sigma values following a Lapla > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LaplaceScheduler/en.md) --- -**Source fingerprint (SHA-256):** `fe8a405937a4b59ab988031b8509a9f030a57d8d1a17bb0812dc51eb5ad83717` +**Source fingerprint (SHA-256):** `8e5ca00f4797f863a2cf8b9b115ec27beb7f65981cbb04eb036150402fc19389` diff --git a/comfyui_embedded_docs/docs/LatentApplyOperation/en.md b/comfyui_embedded_docs/docs/LatentApplyOperation/en.md index 915a70452..0afdeea90 100644 --- a/comfyui_embedded_docs/docs/LatentApplyOperation/en.md +++ b/comfyui_embedded_docs/docs/LatentApplyOperation/en.md @@ -1,6 +1,6 @@ # LatentApplyOperation -The LatentApplyOperation node applies a specified operation to latent samples. It takes latent data and an operation as inputs, processes the latent samples using the provided operation, and returns the modified latent data. This node allows you to transform or manipulate latent representations in your workflow. +The LatentApplyOperation node applies a specified latent operation to latent samples. It takes latent data and an operation as inputs, processes the latent samples using the provided operation, and returns the modified latent data. This node allows you to transform or manipulate latent representations in your workflow. This node is currently marked as experimental. ## Inputs @@ -18,4 +18,4 @@ The LatentApplyOperation node applies a specified operation to latent samples. I > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LatentApplyOperation/en.md) --- -**Source fingerprint (SHA-256):** `e91307b6426c5220b4eab574d1efd0dd5ff26886b3baf8de9f7b6d9a123920e4` +**Source fingerprint (SHA-256):** `cba55d019793fde8dcc0d4aeb4eb6020b6149f523c6bffc65d73c533aa2e2c6c` diff --git a/comfyui_embedded_docs/docs/LatentApplyOperationCFG/en.md b/comfyui_embedded_docs/docs/LatentApplyOperationCFG/en.md index 59cca86e2..26b81de2a 100644 --- a/comfyui_embedded_docs/docs/LatentApplyOperationCFG/en.md +++ b/comfyui_embedded_docs/docs/LatentApplyOperationCFG/en.md @@ -1,6 +1,6 @@ # LatentApplyOperationCFG -The LatentApplyOperationCFG node applies a latent operation to modify the conditioning guidance process in a model. It works by intercepting the conditioning outputs during the classifier-free guidance (CFG) sampling process and applying the specified operation to the latent representations before they are used for generation. +The LatentApplyOperationCFG node applies a latent operation to modify the conditioning guidance process in a model. It works by intercepting the conditioning outputs during the classifier-free guidance (CFG) sampling process and applying the specified operation to the latent representations before they are used for generation. When the sampler produces two conditioning outputs, the operation is applied to the difference between them, and the second output is then added back to the result. ## Inputs @@ -9,6 +9,8 @@ The LatentApplyOperationCFG node applies a latent operation to modify the condit | `model` | The model to which the CFG operation will be applied | MODEL | Yes | - | | `operation` | The latent operation to apply during the CFG sampling process | LATENT_OPERATION | Yes | - | +Note: This node is marked as experimental. The operation is applied to the model's conditioning outputs during the CFG sampling process. When two conditioning outputs are present, the operation is applied to the difference between the first and second output, and the second output is added back. When only one conditioning output is present, the operation is applied directly to it. + ## Outputs | Output Name | Description | Data Type | @@ -18,4 +20,4 @@ The LatentApplyOperationCFG node applies a latent operation to modify the condit > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LatentApplyOperationCFG/en.md) --- -**Source fingerprint (SHA-256):** `0dd2cdc0561938866f12e11ae44d41fc34d16453ab49e686ba751118d2233c54` +**Source fingerprint (SHA-256):** `e383684a785878bfa4004c2fac78ae562d8e035fdfe081f8e4ebbb2c50161987` diff --git a/comfyui_embedded_docs/docs/LatentConcat/en.md b/comfyui_embedded_docs/docs/LatentConcat/en.md index cf53ead53..fb2aaafc5 100644 --- a/comfyui_embedded_docs/docs/LatentConcat/en.md +++ b/comfyui_embedded_docs/docs/LatentConcat/en.md @@ -10,7 +10,7 @@ The LatentConcat node combines two latent samples by joining them together along | `samples2` | The second latent sample to concatenate | LATENT | Yes | - | | `dim` | The dimension along which to concatenate the latent samples. Positive values (x, y, t) place samples1 before samples2 in the result. Negative values (-x, -y, -t) place samples2 before samples1. The dimension mapping is: x = width, y = height, t = time/frames | COMBO | Yes | `"x"`
`"-x"`
`"y"`
`"-y"`
`"t"`
`"-t"` | -**Note:** The second latent sample (`samples2`) is automatically adjusted to match the batch size of the first latent sample (`samples1`) before concatenation. +**Note:** The second latent sample (`samples2`) is automatically repeated as needed to match the batch size of the first latent sample (`samples1`) before concatenation. ## Outputs @@ -21,4 +21,4 @@ The LatentConcat node combines two latent samples by joining them together along > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LatentConcat/en.md) --- -**Source fingerprint (SHA-256):** `82cc2d659cd7c3d35ad20eee6fc63a7574e7367397618c0bdf3e82924372dff7` +**Source fingerprint (SHA-256):** `dfe27f76ad12e16623d62c9e7f0b2772df6ecadb543a4eee430bc38ab04a12f2` diff --git a/comfyui_embedded_docs/docs/LatentCut/en.md b/comfyui_embedded_docs/docs/LatentCut/en.md index f8be88176..71c8127e4 100644 --- a/comfyui_embedded_docs/docs/LatentCut/en.md +++ b/comfyui_embedded_docs/docs/LatentCut/en.md @@ -7,7 +7,7 @@ The LatentCut node extracts a specific section from latent samples along a chose | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | | `samples` | The input latent samples to extract from | LATENT | Yes | - | -| `dim` | The dimension along which to cut the latent samples | COMBO | Yes | "x"
"y"
"t" | +| `dim` | The dimension along which to cut the latent samples. "x" cuts along the last axis (typically width), "y" along the second-to-last axis (typically height), and "t" along the third-to-last axis (typically frames in video latents) | COMBO | Yes | "x"
"y"
"t" | | `index` | The starting position for the cut (default: 0). Positive values count from the start, negative values count from the end. The node automatically clamps the index to stay within the valid range of the latent samples | INT | Yes | -16384 to 16384 | | `amount` | The number of elements to extract along the specified dimension (default: 1). The node automatically reduces this value if it would exceed the available data beyond the starting index | INT | Yes | 1 to 16384 | @@ -20,4 +20,4 @@ The LatentCut node extracts a specific section from latent samples along a chose > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LatentCut/en.md) --- -**Source fingerprint (SHA-256):** `c05ce7a33d9416bdd8dabeed2c61fbc6102fc9e797d727aefaadb00f375287a9` +**Source fingerprint (SHA-256):** `7682de2644a4b85dba0571406f9f9802eca7caab09dc2ccf1ac91dc13b41bcdf` diff --git a/comfyui_embedded_docs/docs/LatentCutToBatch/en.md b/comfyui_embedded_docs/docs/LatentCutToBatch/en.md index 570b77225..6d7168df0 100644 --- a/comfyui_embedded_docs/docs/LatentCutToBatch/en.md +++ b/comfyui_embedded_docs/docs/LatentCutToBatch/en.md @@ -1,15 +1,17 @@ # LatentCutToBatch -The LatentCutToBatch node splits a latent representation along a chosen dimension into multiple slices and stacks them into a new batch. This allows you to process different parts of a latent sample independently. +The LatentCutToBatch node splits a latent representation along a chosen dimension (time, width, or height) into slices of a specified size and stacks them into a new batch. Each slice becomes a separate item in the batch, so different parts of a latent sample can be processed independently. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | | `samples` | The latent representation to be split and batched. | LATENT | Yes | - | -| `dim` | The dimension along which to cut the latent samples. `"t"` refers to the temporal dimension, `"x"` to the width, and `"y"` to the height. | COMBO | Yes | `"t"`
`"x"`
`"y"` | +| `dim` | The dimension along which to cut the latent samples. `"t"` refers to the temporal (frame) dimension, `"x"` to the width, and `"y"` to the height. | COMBO | Yes | `"t"`
`"x"`
`"y"` | | `slice_size` | The size of each slice to cut from the specified dimension. If the dimension's size is not perfectly divisible by this value, the remainder is discarded. (default: 1) | INT | Yes | 1 to 16384 (max resolution) | +Note: The `"t"` option only takes effect when the latent includes a temporal dimension. If the chosen dimension maps to the batch or channel position, or does not exist (for example, selecting `"t"` on a latent without frames), the node returns the input unchanged. If `slice_size` is larger than the size of the chosen dimension, the entire dimension is used as a single slice. When the dimension size is not evenly divisible by `slice_size`, the leftover portion at the end is discarded. The output batch size is the input batch size multiplied by the number of slices, and the sliced dimension itself is reduced to `slice_size`. + ## Outputs | Output Name | Description | Data Type | @@ -19,4 +21,4 @@ The LatentCutToBatch node splits a latent representation along a chosen dimensio > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LatentCutToBatch/en.md) --- -**Source fingerprint (SHA-256):** `565fd1e72a1353050cf8c32c6ab8dade475afb2e8ee13ba323d30a8467204201` +**Source fingerprint (SHA-256):** `873c9bc8391971887f1ab636c086cab86f5504a9c653bc80b54120ee53980bdf` diff --git a/comfyui_embedded_docs/docs/LatentOperationSharpen/en.md b/comfyui_embedded_docs/docs/LatentOperationSharpen/en.md index 1b21ef729..4ac5b68c0 100644 --- a/comfyui_embedded_docs/docs/LatentOperationSharpen/en.md +++ b/comfyui_embedded_docs/docs/LatentOperationSharpen/en.md @@ -1,14 +1,16 @@ # LatentOperationSharpen -The LatentOperationSharpen node applies a sharpening effect to latent representations using a Gaussian kernel. It works by normalizing the latent data, applying a convolution with a custom sharpening kernel, and then restoring the original luminance. This enhances the details and edges in the latent space representation. +The LatentOperationSharpen node creates a sharpening operation for latent representations using a Gaussian kernel. It normalizes the latent data, applies a custom sharpening kernel through convolution, and then restores the original luminance. This enhances the details and edges in the latent space representation. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `sharpen_radius` | The radius of the sharpening kernel (default: 9) | INT | No | 1-31 | -| `sigma` | The standard deviation for the Gaussian kernel (default: 1.0) | FLOAT | No | 0.1-10.0 | -| `alpha` | The sharpening intensity factor (default: 0.1) | FLOAT | No | 0.0-5.0 | +| `sharpen_radius` | The radius of the sharpening kernel, which controls the size of the area used for sharpening (default: 9) | INT | Yes | 1-31 | +| `sigma` | The standard deviation of the Gaussian kernel used to build the sharpening kernel (default: 1.0) | FLOAT | Yes | 0.1-10.0 | +| `alpha` | The sharpening intensity factor; higher values produce a stronger sharpening effect (default: 0.1) | FLOAT | Yes | 0.0-5.0 | + +All three inputs are advanced parameters and have default values, so the node can be used without changing them. This node is marked as experimental. ## Outputs @@ -19,4 +21,4 @@ The LatentOperationSharpen node applies a sharpening effect to latent representa > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LatentOperationSharpen/en.md) --- -**Source fingerprint (SHA-256):** `98d80144a7d9ae2794ef9e6803ec7e6383dfac1b42a42fec5e17e93d6a806ca5` +**Source fingerprint (SHA-256):** `8f49b7e47d35547a7169e9ec209328adbe084ee861ac26b9f26e4e644ac14d6d` diff --git a/comfyui_embedded_docs/docs/LatentOperationTonemapReinhard/en.md b/comfyui_embedded_docs/docs/LatentOperationTonemapReinhard/en.md index 095302e2f..24ee1c339 100644 --- a/comfyui_embedded_docs/docs/LatentOperationTonemapReinhard/en.md +++ b/comfyui_embedded_docs/docs/LatentOperationTonemapReinhard/en.md @@ -1,12 +1,12 @@ # LatentOperationTonemapReinhard -The LatentOperationTonemapReinhard node applies Reinhard tonemapping to latent vectors. This technique normalizes the latent vectors and adjusts their magnitude using a statistical approach based on mean and standard deviation, with the intensity controlled by a multiplier parameter. +The LatentOperationTonemapReinhard node applies Reinhard tonemapping to latent vectors. This technique normalizes the latent vectors and adjusts their magnitude using a statistical approach based on mean and standard deviation, with the intensity controlled by a multiplier parameter. This node is currently marked as experimental. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `multiplier` | Controls the intensity of the tonemapping effect (default: 1.0) | FLOAT | Yes | 0.0 to 100.0 | +| `multiplier` | Controls the intensity of the tonemapping effect (default: 1.0) | FLOAT | Yes | 0.0 to 100.0 (step 0.01) | ## Outputs @@ -17,4 +17,4 @@ The LatentOperationTonemapReinhard node applies Reinhard tonemapping to latent v > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LatentOperationTonemapReinhard/en.md) --- -**Source fingerprint (SHA-256):** `698c142dd4fa084b52c43a12062e8be063870704b0c0dd2de015f3a1142378b8` +**Source fingerprint (SHA-256):** `19d58c288967ab27eb1e84e60bc35a6d6c8b4e643168de689132396ae0ee3cbe` diff --git a/comfyui_embedded_docs/docs/LatentUpscaleModelLoader/en.md b/comfyui_embedded_docs/docs/LatentUpscaleModelLoader/en.md index d7f7000d4..55f5ab0fb 100644 --- a/comfyui_embedded_docs/docs/LatentUpscaleModelLoader/en.md +++ b/comfyui_embedded_docs/docs/LatentUpscaleModelLoader/en.md @@ -1,12 +1,12 @@ # Load Latent Upscale Model -The LatentUpscaleModelLoader node loads a specialized model designed for upscaling latent representations. It reads a model file from the system's designated folder and automatically detects its type (720p, 1080p, or other) to instantiate and configure the correct internal model architecture. The loaded model is then ready to be used by other nodes for latent space super-resolution tasks. +The LatentUpscaleModelLoader node loads a model specialized in upscaling latent representations from a file stored in ComfyUI's `latent_upscale_models` folder. It automatically detects the model type (720p, 1080p, or another latent upsampler) from the file contents and configures the matching internal architecture, making the loaded model ready for use by other nodes. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `model_name` | The name of the latent upscale model file to load. The available options are dynamically populated from the files present in your ComfyUI's `latent_upscale_models` directory. | STRING | Yes | *All files in the `latent_upscale_models` folder* | +| `model_name` | The name of the latent upscale model file to load. The available options are dynamically populated from the files present in ComfyUI's `latent_upscale_models` directory. | COMBO | Yes | All files in the `latent_upscale_models` folder | ## Outputs @@ -17,4 +17,4 @@ The LatentUpscaleModelLoader node loads a specialized model designed for upscali > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LatentUpscaleModelLoader/en.md) --- -**Source fingerprint (SHA-256):** `afd35f0d5dacb14a835c00bf34c016d270e85064eca7d7ff42880e67cc64a01f` +**Source fingerprint (SHA-256):** `7e23214b1b1fc11be84910a5a209c7990a5199120cb0e6b6c61302a442dcf153` diff --git a/comfyui_embedded_docs/docs/LayersFromBoundingBoxes/ar.md b/comfyui_embedded_docs/docs/LayersFromBoundingBoxes/ar.md index 33fc5a77b..afe44a425 100644 --- a/comfyui_embedded_docs/docs/LayersFromBoundingBoxes/ar.md +++ b/comfyui_embedded_docs/docs/LayersFromBoundingBoxes/ar.md @@ -6,13 +6,13 @@ | المعامل | الوصف | نوع البيانات | مطلوب | النطاق | |-----------|-------------|-----------|----------|-------| -| `image` | دفعة الصور؛ كل إطار يصبح طبقة واحدة. | IMAGE | نعم | — | -| `bboxes` | صناديق التموضع، متوافقة في الفهرس مع دفعة الصور. تقبل صناديق محيطة (x, y, width, height)، عناصر معايرة (تحتوي على "bbox" — هذه تحتاج إلى canvas_width/canvas_height لتحويلها إلى بكسلات)، أو سلسلة JSON لأي منهما. الإطارات التي لا تحتوي على صندوق مطابق تُوضع عند نقطة الأصل. عرض/ارتفاع الصندوق يغيّر حجم الطبقة لتناسبه. يتم استخدام metadata.name (أو desc) و metadata.z_index عند وجودهما، ويعمل metadata.content_rect (نسبي للإطار) على قص الإطار إلى محتواه الفعلي. | BOUNDING_BOX, ARRAY, أو STRING | نعم | — | -| `mask` | الشفافية لكل إطار، متوافقة في الفهرس مع دفعة الصور (1 = شفاف، اصطلاح LoadImage). | MASK | لا | — | -| `layers` | حزمة الطبقات التي ستُضاف إليها. اتركها غير موصولة لبدء حزمة جديدة. | LAYERS | لا | — | -| `crop_to_content` | قص كل إطار إلى metadata.content_rect عند وجوده ووضع المحتوى في موضع الصندوق مع إزاحة المستطيل. اتركه مفعّلاً للدفعات التي تكون إطاراتها محشوة — فهو يحتفظ فقط بالمحتوى الفعلي في موضعه الصحيح. (الافتراضي: true) | BOOLEAN | لا | true
false | -| `canvas_width` | عرض لوحة المستند. القيمة 0 تستنتجه من الطبقات الموضوعة. (الافتراضي: 0) | INT | لا | 0 إلى MAX_RESOLUTION | -| `canvas_height` | ارتفاع لوحة المستند. القيمة 0 تستنتجه من الطبقات الموضوعة. (الافتراضي: 0) | INT | لا | 0 إلى MAX_RESOLUTION | +| `الصورة` | دفعة الصور؛ كل إطار يصبح طبقة واحدة. | IMAGE | نعم | — | +| `مربعات التحديد` | صناديق التموضع، متوافقة في الفهرس مع دفعة الصور. تقبل صناديق محيطة (x, y, width, height)، عناصر معايرة (تحتوي على "bbox" — هذه تحتاج إلى canvas_width/canvas_height لتحويلها إلى بكسلات)، أو سلسلة JSON لأي منهما. الإطارات التي لا تحتوي على صندوق مطابق تُوضع عند نقطة الأصل. عرض/ارتفاع الصندوق يغيّر حجم الطبقة لتناسبه. يتم استخدام metadata.name (أو desc) و metadata.z_index عند وجودهما، ويعمل metadata.content_rect (نسبي للإطار) على قص الإطار إلى محتواه الفعلي. | BOUNDING_BOX, ARRAY, أو STRING | نعم | — | +| `القناع` | الشفافية لكل إطار، متوافقة في الفهرس مع دفعة الصور (1 = شفاف، اصطلاح LoadImage). | MASK | لا | — | +| `الطبقات` | حزمة الطبقات التي ستُضاف إليها. اتركها غير موصولة لبدء حزمة جديدة. | LAYERS | لا | — | +| `قص إلى المحتوى` | قص كل إطار إلى metadata.content_rect عند وجوده ووضع المحتوى في موضع الصندوق مع إزاحة المستطيل. اتركه مفعّلاً للدفعات التي تكون إطاراتها محشوة — فهو يحتفظ فقط بالمحتوى الفعلي في موضعه الصحيح. (الافتراضي: true) | BOOLEAN | لا | true
false | +| `عرض اللوحة` | عرض لوحة المستند. القيمة 0 تستنتجه من الطبقات الموضوعة. (الافتراضي: 0) | INT | لا | 0 إلى MAX_RESOLUTION | +| `ارتفاع اللوحة` | ارتفاع لوحة المستند. القيمة 0 تستنتجه من الطبقات الموضوعة. (الافتراضي: 0) | INT | لا | 0 إلى MAX_RESOLUTION | ملاحظات: diff --git a/comfyui_embedded_docs/docs/LayersFromBoundingBoxes/es.md b/comfyui_embedded_docs/docs/LayersFromBoundingBoxes/es.md index 3eb161744..5f2505a05 100644 --- a/comfyui_embedded_docs/docs/LayersFromBoundingBoxes/es.md +++ b/comfyui_embedded_docs/docs/LayersFromBoundingBoxes/es.md @@ -6,13 +6,13 @@ Este nodo convierte un lote de imágenes y sus cajas delimitadoras en una pila d | Parámetro | Descripción | Tipo de datos | Requerido | Rango | |-----------|-------------|---------------|-----------|-------| -| `image` | Lote de imágenes; cada fotograma se convierte en una capa. | IMAGE | Sí | — | -| `bboxes` | Cajas de colocación, alineadas por índice con el lote de imágenes. Acepta cajas delimitadoras (x, y, width, height), elementos normalizados (con un "bbox" — estos necesitan `canvas_width`/`canvas_height` para resolverse en píxeles), o una cadena JSON de cualquiera de ambos. Los fotogramas sin una caja correspondiente se colocan en el origen. El ancho/alto de una caja escala la capa para ajustarse a ella. Se usan `metadata.name` (o `desc`) y `metadata.z_index` cuando están presentes, y `metadata.content_rect` (relativo al fotograma) recorta el fotograma a su contenido real. | BOUNDING_BOX, ARRAY o STRING | Sí | — | -| `mask` | Transparencia por fotograma, alineada por índice con el lote de imágenes (1 = transparente, convención de LoadImage). | MASK | No | — | -| `layers` | Pila de capas a la que añadir. Déjala sin conectar para iniciar una nueva pila. | LAYERS | No | — | -| `crop_to_content` | Recorta cada fotograma a `metadata.content_rect` cuando esté presente y coloca el contenido en la posición de la caja más el desplazamiento del rect. Mantén esta opción activada para lotes cuyos fotogramas estén rellenos (padded): conserva solo el contenido real en su ubicación verdadera. (por defecto: true) | BOOLEAN | No | true
false | -| `canvas_width` | Ancho del lienzo del documento. 0 lo deriva de las capas colocadas. (por defecto: 0) | INT | No | 0 a MAX_RESOLUTION | -| `canvas_height` | Alto del lienzo del documento. 0 lo deriva de las capas colocadas. (por defecto: 0) | INT | No | 0 a MAX_RESOLUTION | +| `imagen` | Lote de imágenes; cada fotograma se convierte en una capa. | IMAGE | Sí | — | +| `cajas` | Cajas de colocación, alineadas por índice con el lote de imágenes. Acepta cajas delimitadoras (x, y, width, height), elementos normalizados (con un "bbox" — estos necesitan `canvas_width`/`canvas_height` para resolverse en píxeles), o una cadena JSON de cualquiera de ambos. Los fotogramas sin una caja correspondiente se colocan en el origen. El ancho/alto de una caja escala la capa para ajustarse a ella. Se usan `metadata.name` (o `desc`) y `metadata.z_index` cuando están presentes, y `metadata.content_rect` (relativo al fotograma) recorta el fotograma a su contenido real. | BOUNDING_BOX, ARRAY o STRING | Sí | — | +| `máscara` | Transparencia por fotograma, alineada por índice con el lote de imágenes (1 = transparente, convención de LoadImage). | MASK | No | — | +| `capas` | Pila de capas a la que añadir. Déjala sin conectar para iniciar una nueva pila. | LAYERS | No | — | +| `recortar_al_contenido` | Recorta cada fotograma a `metadata.content_rect` cuando esté presente y coloca el contenido en la posición de la caja más el desplazamiento del rect. Mantén esta opción activada para lotes cuyos fotogramas estén rellenos (padded): conserva solo el contenido real en su ubicación verdadera. (por defecto: true) | BOOLEAN | No | true
false | +| `ancho_lienzo` | Ancho del lienzo del documento. 0 lo deriva de las capas colocadas. (por defecto: 0) | INT | No | 0 a MAX_RESOLUTION | +| `alto_lienzo` | Alto del lienzo del documento. 0 lo deriva de las capas colocadas. (por defecto: 0) | INT | No | 0 a MAX_RESOLUTION | Notas: diff --git a/comfyui_embedded_docs/docs/LayersFromBoundingBoxes/fa.md b/comfyui_embedded_docs/docs/LayersFromBoundingBoxes/fa.md index 53ac6d78b..0657580fc 100644 --- a/comfyui_embedded_docs/docs/LayersFromBoundingBoxes/fa.md +++ b/comfyui_embedded_docs/docs/LayersFromBoundingBoxes/fa.md @@ -6,13 +6,13 @@ | پارامتر | توضیحات | نوع داده | الزامی | محدوده | |-----------|-------------|-----------|----------|-------| -| `image` | دسته تصویر؛ هر فریم به یک لایه تبدیل می‌شود. | IMAGE | بله | — | -| `bboxes` | جعبه‌های مکان‌دهی، هم‌اندیس با دسته تصویر. جعبه‌های محدودکننده (x, y, width, height)، عناصر نرمال‌شده (دارای «bbox» — این‌ها برای تبدیل شدن به پیکسل به canvas_width/canvas_height نیاز دارند)، یا یک رشته JSON از هر کدام را می‌پذیرد. فریم‌هایی که جعبه‌ی متناظر ندارند در مبدأ قرار می‌گیرند. عرض/ارتفاع یک جعبه، لایه را برای تناسب با آن مقیاس‌بندی می‌کند. در صورت وجود، metadata.name (یا desc) و metadata.z_index استفاده می‌شوند و metadata.content_rect (نسبت به فریم) فریم را تا محتوای واقعی آن برش می‌دهد. | BOUNDING_BOX, ARRAY, یا STRING | بله | — | -| `mask` | شفافیت به‌ازای هر فریم، هم‌اندیس با دسته تصویر (1 = شفاف، مطابق قرارداد LoadImage). | MASK | خیر | — | -| `layers` | پشته لایه‌ای که لایه‌ها به آن اضافه می‌شوند. برای شروع یک پشته جدید، آن را متصل نکنید. | LAYERS | خیر | — | -| `crop_to_content` | هر فریم را در صورت وجود به metadata.content_rect برش می‌دهد و محتوا را در موقعیت جعبه به‌علاوه‌ی آفست مستطیل قرار می‌دهد. برای دسته‌هایی که فریم‌هایشان padding دارند، آن را روشن بگذارید — این کار فقط محتوای واقعی را در مکان درست نگه می‌دارد. (پیش‌فرض: true) | BOOLEAN | خیر | true
false | -| `canvas_width` | عرض بوم سند. 0 آن را از لایه‌های قرارگرفته استخراج می‌کند. (پیش‌فرض: 0) | INT | خیر | 0 تا MAX_RESOLUTION | -| `canvas_height` | ارتفاع بوم سند. 0 آن را از لایه‌های قرارگرفته استخراج می‌کند. (پیش‌فرض: 0) | INT | خیر | 0 تا MAX_RESOLUTION | +| `تصویر` | دسته تصویر؛ هر فریم به یک لایه تبدیل می‌شود. | IMAGE | بله | — | +| `جعبه‌های مرزی` | جعبه‌های مکان‌دهی، هم‌اندیس با دسته تصویر. جعبه‌های محدودکننده (x, y, width, height)، عناصر نرمال‌شده (دارای «bbox» — این‌ها برای تبدیل شدن به پیکسل به canvas_width/canvas_height نیاز دارند)، یا یک رشته JSON از هر کدام را می‌پذیرد. فریم‌هایی که جعبه‌ی متناظر ندارند در مبدأ قرار می‌گیرند. عرض/ارتفاع یک جعبه، لایه را برای تناسب با آن مقیاس‌بندی می‌کند. در صورت وجود، metadata.name (یا desc) و metadata.z_index استفاده می‌شوند و metadata.content_rect (نسبت به فریم) فریم را تا محتوای واقعی آن برش می‌دهد. | BOUNDING_BOX, ARRAY, یا STRING | بله | — | +| `ماسک` | شفافیت به‌ازای هر فریم، هم‌اندیس با دسته تصویر (1 = شفاف، مطابق قرارداد LoadImage). | MASK | خیر | — | +| `لایه‌ها` | پشته لایه‌ای که لایه‌ها به آن اضافه می‌شوند. برای شروع یک پشته جدید، آن را متصل نکنید. | LAYERS | خیر | — | +| `برش به محتوا` | هر فریم را در صورت وجود به metadata.content_rect برش می‌دهد و محتوا را در موقعیت جعبه به‌علاوه‌ی آفست مستطیل قرار می‌دهد. برای دسته‌هایی که فریم‌هایشان padding دارند، آن را روشن بگذارید — این کار فقط محتوای واقعی را در مکان درست نگه می‌دارد. (پیش‌فرض: true) | BOOLEAN | خیر | true
false | +| `عرض بوم` | عرض بوم سند. 0 آن را از لایه‌های قرارگرفته استخراج می‌کند. (پیش‌فرض: 0) | INT | خیر | 0 تا MAX_RESOLUTION | +| `ارتفاع بوم` | ارتفاع بوم سند. 0 آن را از لایه‌های قرارگرفته استخراج می‌کند. (پیش‌فرض: 0) | INT | خیر | 0 تا MAX_RESOLUTION | نکات: diff --git a/comfyui_embedded_docs/docs/LayersFromBoundingBoxes/ru.md b/comfyui_embedded_docs/docs/LayersFromBoundingBoxes/ru.md index fed25d97f..0517e584f 100644 --- a/comfyui_embedded_docs/docs/LayersFromBoundingBoxes/ru.md +++ b/comfyui_embedded_docs/docs/LayersFromBoundingBoxes/ru.md @@ -6,13 +6,13 @@ | Параметр | Описание | Тип данных | Обязательный | Диапазон | |-----------|-------------|-----------|----------|-------| -| `image` | Пакет изображений; каждый кадр становится одним слоем. | IMAGE | Да | — | -| `bboxes` | Рамки размещения, выровненные по индексу с пакетом изображений. Принимает ограничивающие рамки (x, y, width, height), нормализованные элементы (с "bbox" — для них требуются canvas_width/canvas_height для преобразования в пиксели) или JSON-строку любого из этих вариантов. Кадры без соответствующей рамки размещаются в начале координат. Ширина/высота рамки масштабирует слой, чтобы он соответствовал ей. metadata.name (или desc) и metadata.z_index используются при их наличии, а metadata.content_rect (относительно кадра) обрезает кадр до его реального содержимого. | BOUNDING_BOX, ARRAY или STRING | Да | — | -| `mask` | Прозрачность для каждого кадра, выровненная по индексу с пакетом изображений (1 = прозрачный, согласно соглашению LoadImage). | MASK | Нет | — | -| `layers` | Стек слоев, к которому нужно добавить. Оставьте неподключенным, чтобы начать новый стек. | LAYERS | Нет | — | -| `crop_to_content` | Обрезать каждый кадр до metadata.content_rect, если он присутствует, и размещать содержимое в позиции рамки плюс смещение прямоугольника. Оставьте включенным для пакетов, кадры которых имеют поля — это сохраняет только реальное содержимое в его истинном месте. (по умолчанию: true) | BOOLEAN | Нет | true
false | -| `canvas_width` | Ширина документа. 0 означает автоматическое определение по размещенным слоям. (по умолчанию: 0) | INT | Нет | 0 до MAX_RESOLUTION | -| `canvas_height` | Высота документа. 0 означает автоматическое определение по размещенным слоям. (по умолчанию: 0) | INT | Нет | 0 до MAX_RESOLUTION | +| `изображение` | Пакет изображений; каждый кадр становится одним слоем. | IMAGE | Да | — | +| `ограничивающие_рамки` | Рамки размещения, выровненные по индексу с пакетом изображений. Принимает ограничивающие рамки (x, y, width, height), нормализованные элементы (с "bbox" — для них требуются canvas_width/canvas_height для преобразования в пиксели) или JSON-строку любого из этих вариантов. Кадры без соответствующей рамки размещаются в начале координат. Ширина/высота рамки масштабирует слой, чтобы он соответствовал ей. metadata.name (или desc) и metadata.z_index используются при их наличии, а metadata.content_rect (относительно кадра) обрезает кадр до его реального содержимого. | BOUNDING_BOX, ARRAY или STRING | Да | — | +| `маска` | Прозрачность для каждого кадра, выровненная по индексу с пакетом изображений (1 = прозрачный, согласно соглашению LoadImage). | MASK | Нет | — | +| `слои` | Стек слоев, к которому нужно добавить. Оставьте неподключенным, чтобы начать новый стек. | LAYERS | Нет | — | +| `обрезать_по_контенту` | Обрезать каждый кадр до metadata.content_rect, если он присутствует, и размещать содержимое в позиции рамки плюс смещение прямоугольника. Оставьте включенным для пакетов, кадры которых имеют поля — это сохраняет только реальное содержимое в его истинном месте. (по умолчанию: true) | BOOLEAN | Нет | true
false | +| `ширина_холста` | Ширина документа. 0 означает автоматическое определение по размещенным слоям. (по умолчанию: 0) | INT | Нет | 0 до MAX_RESOLUTION | +| `высота_холста` | Высота документа. 0 означает автоматическое определение по размещенным слоям. (по умолчанию: 0) | INT | Нет | 0 до MAX_RESOLUTION | Примечания: diff --git a/comfyui_embedded_docs/docs/LayersFromBoundingBoxes/tr.md b/comfyui_embedded_docs/docs/LayersFromBoundingBoxes/tr.md index fd4d850b5..4b7ed7a06 100644 --- a/comfyui_embedded_docs/docs/LayersFromBoundingBoxes/tr.md +++ b/comfyui_embedded_docs/docs/LayersFromBoundingBoxes/tr.md @@ -6,13 +6,13 @@ Bu düğüm, bir görüntü kümesini ve sınırlayıcı kutularını bir katman | Parametre | Açıklama | Veri Türü | Zorunlu | Aralık | |-----------|-------------|-----------|----------|-------| -| `image` | Görüntü kümesi; her kare bir katman olur. | IMAGE | Evet | — | -| `bboxes` | Yerleştirme kutuları, görüntü kümesiyle dizin hizalıdır. Sınırlayıcı kutuları (x, y, genişlik, yükseklik), normalleştirilmiş öğeleri ("bbox" içeren — bunlar piksele dönüştürülmek için canvas_width/canvas_height gerektirir) veya bunlardan birinin JSON dizgesini kabul eder. Eşleşen kutusu olmayan kareler orijine yerleştirilir. Bir kutunun genişliği/yüksekliği, katmanı ona sığacak şekilde ölçekler. metadata.name (veya desc) ve metadata.z_index varsa kullanılır; metadata.content_rect (kareye göreli) kareyi gerçek içeriğine göre kırpar. | BOUNDING_BOX, ARRAY veya STRING | Evet | — | -| `mask` | Kare başına saydamlık, görüntü kümesiyle dizin hizalıdır (1 = saydam, LoadImage kuralı). | MASK | Hayır | — | -| `layers` | Eklenecek katman yığını. Yeni bir yığın başlatmak için bağlantısız bırakın. | LAYERS | Hayır | — | -| `crop_to_content` | Her kareyi, varsa metadata.content_rect'e göre kırpın ve içeriği kutu konumu artı dikdörtgen ofsetiyle yerleştirin. Kareleri dolgulu olan kümeler için açık bırakın — yalnızca gerçek içeriği gerçek konumunda tutar. (varsayılan: true) | BOOLEAN | Hayır | true
false | -| `canvas_width` | Belge tuvali genişliği. 0, yerleştirilen katmanlardan türetir. (varsayılan: 0) | INT | Hayır | 0 ile MAX_RESOLUTION | -| `canvas_height` | Belge tuvali yüksekliği. 0, yerleştirilen katmanlardan türetir. (varsayılan: 0) | INT | Hayır | 0 ile MAX_RESOLUTION | +| `görsel` | Görüntü kümesi; her kare bir katman olur. | IMAGE | Evet | — | +| `sınırlayıcı_kutular` | Yerleştirme kutuları, görüntü kümesiyle dizin hizalıdır. Sınırlayıcı kutuları (x, y, genişlik, yükseklik), normalleştirilmiş öğeleri ("bbox" içeren — bunlar piksele dönüştürülmek için canvas_width/canvas_height gerektirir) veya bunlardan birinin JSON dizgesini kabul eder. Eşleşen kutusu olmayan kareler orijine yerleştirilir. Bir kutunun genişliği/yüksekliği, katmanı ona sığacak şekilde ölçekler. metadata.name (veya desc) ve metadata.z_index varsa kullanılır; metadata.content_rect (kareye göreli) kareyi gerçek içeriğine göre kırpar. | BOUNDING_BOX, ARRAY veya STRING | Evet | — | +| `maske` | Kare başına saydamlık, görüntü kümesiyle dizin hizalıdır (1 = saydam, LoadImage kuralı). | MASK | Hayır | — | +| `katmanlar` | Eklenecek katman yığını. Yeni bir yığın başlatmak için bağlantısız bırakın. | LAYERS | Hayır | — | +| `içeriğe_kırp` | Her kareyi, varsa metadata.content_rect'e göre kırpın ve içeriği kutu konumu artı dikdörtgen ofsetiyle yerleştirin. Kareleri dolgulu olan kümeler için açık bırakın — yalnızca gerçek içeriği gerçek konumunda tutar. (varsayılan: true) | BOOLEAN | Hayır | true
false | +| `tuval_genişliği` | Belge tuvali genişliği. 0, yerleştirilen katmanlardan türetir. (varsayılan: 0) | INT | Hayır | 0 ile MAX_RESOLUTION | +| `tuval_yüksekliği` | Belge tuvali yüksekliği. 0, yerleştirilen katmanlardan türetir. (varsayılan: 0) | INT | Hayır | 0 ile MAX_RESOLUTION | Notlar: diff --git a/comfyui_embedded_docs/docs/LazyCache/en.md b/comfyui_embedded_docs/docs/LazyCache/en.md index 8fa78c1bf..b45d1bf38 100644 --- a/comfyui_embedded_docs/docs/LazyCache/en.md +++ b/comfyui_embedded_docs/docs/LazyCache/en.md @@ -12,6 +12,8 @@ LazyCache is a homebrew version of EasyCache that provides an even easier implem | `end_percent` | The relative sampling step to end use of LazyCache (default: 0.95). | FLOAT | No | 0.0 - 1.0 | | `verbose` | Whether to log verbose information (default: False). | BOOLEAN | No | - | +Note: `reuse_threshold`, `start_percent`, `end_percent`, and `verbose` are optional advanced options. + ## Outputs | Output Name | Description | Data Type | @@ -21,4 +23,4 @@ LazyCache is a homebrew version of EasyCache that provides an even easier implem > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LazyCache/en.md) --- -**Source fingerprint (SHA-256):** `72ca1bbaf795e17951d1f7f9f37350dc3f1511351cc59a5043b40e069fd31340` +**Source fingerprint (SHA-256):** `78f9c13473567e068fc2be35b2f8f5aa459d43d3f13300a6ea858af98d3e2a44` diff --git a/comfyui_embedded_docs/docs/LoadBackgroundRemovalModel/en.md b/comfyui_embedded_docs/docs/LoadBackgroundRemovalModel/en.md index 140c2898f..5614e7f81 100644 --- a/comfyui_embedded_docs/docs/LoadBackgroundRemovalModel/en.md +++ b/comfyui_embedded_docs/docs/LoadBackgroundRemovalModel/en.md @@ -1,14 +1,14 @@ # Load Background Removal Model -## Overview - Loads a background removal model from a file. This node prepares the model for use in removing backgrounds from images. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `bg_removal_name` | The model used to remove backgrounds from images. Select from the list of available background removal model files. | STRING | Yes | List of available model files | +| `bg_removal_name` | The model used to remove backgrounds from images. Select from the list of available background removal model files. | COMBO | Yes | List of available model files (sorted alphabetically) | + +Note: If the selected file does not contain a valid background removal model, the node raises a RuntimeError. ## Outputs @@ -19,4 +19,4 @@ Loads a background removal model from a file. This node prepares the model for u > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LoadBackgroundRemovalModel/en.md) --- -**Source fingerprint (SHA-256):** `3f2da4d2fcafb7d65f4e5099102011c3be9500f3eec6c59c6897aa9640ae8f04` +**Source fingerprint (SHA-256):** `76f6536eae849a8b63f46f11c6afcf8c89774e4e89a5976e051253acc6108bcc` diff --git a/comfyui_embedded_docs/docs/LoadImageDataSetFromFolder/en.md b/comfyui_embedded_docs/docs/LoadImageDataSetFromFolder/en.md index 1c37e4caa..46d0afea1 100644 --- a/comfyui_embedded_docs/docs/LoadImageDataSetFromFolder/en.md +++ b/comfyui_embedded_docs/docs/LoadImageDataSetFromFolder/en.md @@ -1,12 +1,14 @@ # Load Image (from Folder) -This node loads multiple images from a specified subfolder within ComfyUI's input directory. It scans the chosen folder for common image file types and returns them as a list, making it useful for batch processing or dataset preparation. +This node loads multiple images from a selected subfolder within ComfyUI's main input directory and returns them as a list. It scans the chosen folder for image files in PNG, JPG, JPEG, or WEBP format, which makes it useful for batch processing or preparing image datasets. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `folder` | The folder to load images from. The options are the subfolders present in ComfyUI's main input directory. | STRING | Yes | *Multiple options available* | +| `folder` | The folder to load images from. The options are the subfolders present in ComfyUI's main input directory. | COMBO | Yes | Multiple options available | + +Note: The selected folder must be a subfolder of ComfyUI's main input directory; any value that resolves outside of it is rejected. Only files with the extensions .png, .jpg, .jpeg, or .webp are loaded, and the extension check is case-insensitive. If the selected folder contains no valid image files, the node raises an error. This node is marked as experimental. ## Outputs @@ -17,4 +19,4 @@ This node loads multiple images from a specified subfolder within ComfyUI's inpu > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LoadImageDataSetFromFolder/en.md) --- -**Source fingerprint (SHA-256):** `62db052cfda66658172a881214d2a30dcfe626bec3ae619d1d32c75e327339c4` +**Source fingerprint (SHA-256):** `cdee4e372890c126dd5f09654a7dd4103bba97a7901b6f5df8e02f29c4064ed2` diff --git a/comfyui_embedded_docs/docs/LoadImageTextDataSetFromFolder/en.md b/comfyui_embedded_docs/docs/LoadImageTextDataSetFromFolder/en.md index b321fd05e..708b5461e 100644 --- a/comfyui_embedded_docs/docs/LoadImageTextDataSetFromFolder/en.md +++ b/comfyui_embedded_docs/docs/LoadImageTextDataSetFromFolder/en.md @@ -1,23 +1,23 @@ # Load Image-Text (from Folder) -This node loads a dataset of images and their corresponding text captions from a specified folder. It searches for image files and automatically looks for matching `.txt` files with the same base name to use as captions. The node also supports a specific folder structure where subfolders can be named with a number prefix (like `10_folder_name`) to indicate that the images inside should be repeated multiple times in the output. +This node loads a dataset of image-text caption pairs from a selected folder and returns them as a list. It supports PNG, JPG, JPEG, and WEBP images, and for each image it looks for a caption in a `.txt` file with the same base name. The node also supports the kohya-ss/sd-scripts folder structure, where a subfolder name that starts with a number (such as `10_cats`) repeats the images inside that subfolder that many times in the output. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `folder` | The folder to load images and text captions from. The available options are the subdirectories within ComfyUI's input directory. | COMBO | Yes | *Dynamically loaded from `folder_paths.get_input_subfolders()`* | +| `folder` | The folder to load images and text captions from. | COMBO | Yes | Subfolders inside ComfyUI's input directory (dynamically loaded) | -**Note:** The node expects a specific file structure. For each image file (`.png`, `.jpg`, `.jpeg`, `.webp`), it will look for a `.txt` file with the same name to use as a caption. If a caption file is not found, an empty string is used. The node also supports a special structure where a subfolder's name begins with a number and an underscore (e.g., `5_cats`), which will cause all images inside that subfolder to be repeated that number of times in the final output list. +**Note:** The selected folder must be a subfolder of ComfyUI's input directory. The node expects one `.txt` caption file per image: for each image file (`.png`, `.jpg`, `.jpeg`, `.webp`) it looks for a `.txt` file with the same base name in the same location and uses its trimmed contents as the caption. If no caption file is found, an empty string is used. The node also supports the kohya-ss/sd-scripts folder structure: subfolders whose name starts with a number and an underscore (for example `5_cats`) repeat the images inside them that number of times in the final output list. If the selected folder contains no valid images, the node raises an error. ## Outputs | Output Name | Description | Data Type | | --- | --- | --- | -| `images` | A list of loaded image tensors. | IMAGE | -| `texts` | A list of text captions corresponding to each loaded image. | STRING | +| `images` | List of loaded images. Images are converted to RGB and normalized to the 0–1 float range. | IMAGE | +| `texts` | List of text captions, one for each loaded image. Captions are the trimmed contents of the matching `.txt` file, or an empty string when no caption file exists. | STRING | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LoadImageTextDataSetFromFolder/en.md) --- -**Source fingerprint (SHA-256):** `c505d580b7bfb84ee71aca8fa98c847eeba531da9e578ddfe17818a2fd2ae5e8` +**Source fingerprint (SHA-256):** `d34494d59a65edb38d7e6a5f12c241fb0093371db0b0bf1e52789e84209ad3f5` diff --git a/comfyui_embedded_docs/docs/LoadLatent/en.md b/comfyui_embedded_docs/docs/LoadLatent/en.md index 68488ade7..d167591cd 100644 --- a/comfyui_embedded_docs/docs/LoadLatent/en.md +++ b/comfyui_embedded_docs/docs/LoadLatent/en.md @@ -1,20 +1,22 @@ -# LoadLatent +# Load Latent -The LoadLatent node loads previously saved latent representations from .latent files in the input directory. It reads the latent tensor data from the file and applies any necessary scaling adjustments before returning the latent data for use in other nodes. +The LoadLatent node loads previously saved latent representations from .latent files in the input directory. It reads the latent tensor data from the selected file and applies any necessary scaling adjustments before returning the latent data for use in other nodes. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `latent` | Selects which .latent file to load from the available files in the input directory | STRING | Yes | All .latent files in input directory | +| `latent` | Selects which .latent file to load from the available files in the input directory | COMBO | Yes | All .latent files in the input directory (dynamic list, sorted alphabetically) | + +Note: The list of available files is generated dynamically and only includes files ending in .latent that are present in the input directory. If the selected file no longer exists, the node reports it as an invalid latent file. ## Outputs | Output Name | Description | Data Type | | --- | --- | --- | -| `LATENT` | Returns the loaded latent representation data from the selected file | LATENT | +| `LATENT` | Returns the loaded latent representation data from the selected file as a float tensor. If the file does not contain the `latent_format_version_0` marker, the tensor is scaled by 1/0.18215 before being returned; files that contain the marker are returned at their stored scale. | LATENT | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LoadLatent/en.md) --- -**Source fingerprint (SHA-256):** `020185a6066263b75b2417411f07af54d31a2a3a056d650eacfff188dc2cb87e` +**Source fingerprint (SHA-256):** `0938214361687a3a98e03878b8cbc0240100cbeacc0b157c4a299e59e7728a13` diff --git a/comfyui_embedded_docs/docs/LoadMediaPipeFaceLandmarker/en.md b/comfyui_embedded_docs/docs/LoadMediaPipeFaceLandmarker/en.md index 2db64afce..c3f019f36 100644 --- a/comfyui_embedded_docs/docs/LoadMediaPipeFaceLandmarker/en.md +++ b/comfyui_embedded_docs/docs/LoadMediaPipeFaceLandmarker/en.md @@ -1,5 +1,7 @@ # Load Face Detection Model (MediaPipe) +Load Face Detection Model (MediaPipe) + ## Overview This node loads a MediaPipe Face Landmarker v2 model, which can detect faces and facial landmarks (like eyes, nose, and mouth) in images. It contains two detection variants (short-range and full-range) along with shared mesh data, blendshapes, and canonical geometry for facial analysis. @@ -7,13 +9,13 @@ This node loads a MediaPipe Face Landmarker v2 model, which can detect faces and ## Inputs | Parameter | Description | Data Type | Required | Range | -| --- | --- | --- | --- | --- | -| `model_name` | Face detection model from models/detection/. | STRING | Yes | List of available models in the `models/detection/` directory | +|-----------|-------------|-----------|----------|-------| +| `model_name` | Face detection model from models/detection/. | COMBO | Yes | List of available models in the `models/detection/` directory | ## Outputs | Output Name | Description | Data Type | -| --- | --- | --- | +|-------------|-------------|-----------| | `FACE_DETECTION_MODEL` | A loaded FaceLandmarker model object containing both detection variants (short/full), connection sets for facial topology, canonical data, and model patchers for GPU management. | FACE_DETECTION_MODEL | **Note:** The output is a complex object that can be used by other nodes for face detection and landmark extraction tasks. It contains two detection variants: "short" for close-range detection and "full" for full-range detection. @@ -21,4 +23,4 @@ This node loads a MediaPipe Face Landmarker v2 model, which can detect faces and > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LoadMediaPipeFaceLandmarker/en.md) --- -**Source fingerprint (SHA-256):** `b30bf4d04aa06a227f3661c0e1346d3dab3ea1e25d6627fce5b6480198203c26` +**Source fingerprint (SHA-256):** `33dda845b572ccffc1bd4b64fb9c338ce4313783b092fe311d89741a211f18c9` diff --git a/comfyui_embedded_docs/docs/LoadMoGeModel/en.md b/comfyui_embedded_docs/docs/LoadMoGeModel/en.md index 34728be38..2610363c0 100644 --- a/comfyui_embedded_docs/docs/LoadMoGeModel/en.md +++ b/comfyui_embedded_docs/docs/LoadMoGeModel/en.md @@ -1,14 +1,12 @@ # Load MoGe Model -## Overview - Loads a MoGe (Monocular Geometry) model from a file and prepares it for use in geometry estimation tasks. This node reads a model file from the `geometry_estimation` folder and initializes the MoGe model with its trained weights. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `model_name` | The name of the MoGe model file to load. Select from the available model files in your ComfyUI installation. | STRING | Yes | List of available model files in the `geometry_estimation` folder | +| `model_name` | The name of the MoGe model file to load. Select from the available model files in your ComfyUI installation. | COMBO | Yes | List of available model files in the `geometry_estimation` folder | ## Outputs @@ -19,4 +17,4 @@ Loads a MoGe (Monocular Geometry) model from a file and prepares it for use in g > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LoadMoGeModel/en.md) --- -**Source fingerprint (SHA-256):** `4707002565181ca17936ecf87ea8059630c97c44c17facfecd04053d9581b7d1` +**Source fingerprint (SHA-256):** `b5b55f94d3762852d5a1480c0b00d15da4e534adbeb544bf7c47da012e5a6353` diff --git a/comfyui_embedded_docs/docs/LoadTrainingDataset/en.md b/comfyui_embedded_docs/docs/LoadTrainingDataset/en.md index 87b805236..befb6c084 100644 --- a/comfyui_embedded_docs/docs/LoadTrainingDataset/en.md +++ b/comfyui_embedded_docs/docs/LoadTrainingDataset/en.md @@ -1,21 +1,23 @@ # Load Training Dataset -This node loads an encoded training dataset that has been previously saved to disk. It searches for and reads all data shard files from a specified folder within the ComfyUI output directory, then returns the combined latent vectors and conditioning data for use in training workflows. +This node loads an encoded training dataset (latents and conditioning) that was previously saved to disk. It reads all data shard files from a selected dataset folder in the datasets directory and returns the combined latent vectors and conditioning data for use in training workflows. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `folder_name` | Name of the folder containing the saved dataset, located inside the ComfyUI output directory (default: "training_dataset"). | STRING | Yes | N/A | +| `folder_name` | Saved dataset to load, from the datasets directory. | COMBO | Yes | One option per dataset folder found in the datasets directory | + +Note: The `folder_name` options are built automatically by scanning the datasets directory. A subfolder is listed as a dataset when it contains a `metadata.json` file or at least one `.safetensors` file. The selected dataset folder is searched across all configured dataset root directories. The node reads all files named `shard_*.pkl` in the selected folder and raises an error if no shard files are found. ## Outputs | Output Name | Description | Data Type | | --- | --- | --- | -| `latents` | A list of latent dictionaries, where each dictionary contains a `"samples"` key with a tensor. | LATENT | -| `conditioning` | A list of conditioning lists, where each inner list contains conditioning data for a corresponding sample. | CONDITIONING | +| `latents` | List of latent dicts, where each dict contains a `"samples"` key with a tensor. | LATENT | +| `conditioning` | List of conditioning lists, where each inner list contains conditioning data for the corresponding sample. | CONDITIONING | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LoadTrainingDataset/en.md) --- -**Source fingerprint (SHA-256):** `1d074685317b5bd53d9fb7596126b0f579de6c67b5615717b1a16ba01fc01efd` +**Source fingerprint (SHA-256):** `9f914b27f067460f6f3b54f3f2a7bb793c65b99c85e8aa14ab64894be26bd816` diff --git a/comfyui_embedded_docs/docs/LoadVideoDataSetFromFolder/en.md b/comfyui_embedded_docs/docs/LoadVideoDataSetFromFolder/en.md index f44a2fb1e..934d71b1b 100644 --- a/comfyui_embedded_docs/docs/LoadVideoDataSetFromFolder/en.md +++ b/comfyui_embedded_docs/docs/LoadVideoDataSetFromFolder/en.md @@ -1,22 +1,22 @@ # Load Video (from Folder) -Loads all supported video files from a selected folder inside the ComfyUI input directory and returns them as a list of video references. This node returns lazy video references, so frames are decoded only when another node actually needs them. +Loads a dataset of videos from a selected folder inside the ComfyUI input directory and returns them as a list of lazy video references. This node loads a dataset of videos: frames are decoded only when another node actually needs them. Supported formats are MP4, AVI, MOV, WEBM, MKV, and FLV. ## Inputs | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `folder` | The folder containing video files. Select from available subfolders inside the ComfyUI input directory. | STRING | Yes | All subfolders available in the ComfyUI input directory | +| `folder` | The folder containing video files. | COMBO | Yes | All subfolders available in the ComfyUI input directory (populated dynamically) | -**Note:** The selected folder must contain at least one supported video file. Supported extensions are MP4, AVI, MOV, WEBM, MKV, and FLV. If no supported video files are found, the node raises an error. +**Note:** The selected folder must be a subfolder of the ComfyUI input directory and must contain at least one supported video file. Supported extensions are MP4, AVI, MOV, WEBM, MKV, and FLV. If no supported video files are found, or if the folder path resolves outside the input directory, the node raises an error. ## Outputs | Output Name | Description | Data Type | |-------------|-------------|-----------| -| `videos` | A list of lazy video references, one for each video file in the selected folder. Video frames are decoded only when the output is consumed by another node. | VIDEO (list) | +| `videos` | A list of lazy video references, one for each supported video file in the selected folder, sorted alphabetically by file name. Video frames are decoded only when the output is consumed by another node. | VIDEO (list) | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LoadVideoDataSetFromFolder/en.md) --- -**Source fingerprint (SHA-256):** `74017c46993c38a72e529cef59ea1282f7b88b6a33b9028cf200cb3eb37de395` +**Source fingerprint (SHA-256):** `6a7e6115872bb994fa554bb9de84bcd419106485403a3d2db654cbdd6c72bbe5` diff --git a/comfyui_embedded_docs/docs/LoadVideoTextDataSetFromFolder/en.md b/comfyui_embedded_docs/docs/LoadVideoTextDataSetFromFolder/en.md index 4938cdb11..a5b6ff1ad 100644 --- a/comfyui_embedded_docs/docs/LoadVideoTextDataSetFromFolder/en.md +++ b/comfyui_embedded_docs/docs/LoadVideoTextDataSetFromFolder/en.md @@ -6,9 +6,9 @@ This node loads video files and their associated text captions from a selected s | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `folder` | The folder containing video files and .txt captions. | STRING | Yes | Combo: dynamic list of all subfolders inside the ComfyUI input directory | +| `folder` | The folder containing video files and .txt captions. | COMBO | Yes | Multiple options available: dynamically lists all subfolders inside the ComfyUI input directory | -If the selected folder contains no files with a supported video extension, the node raises an error. For nested folders whose name starts with a number followed by an underscore (for example `5_classname`), each video inside that folder is included in the dataset the number of times given by that prefix. +The selected folder must be a subfolder of the ComfyUI input directory; a folder name that resolves outside of that directory raises an error. If the selected folder contains no files with a supported video extension (MP4, AVI, MOV, WEBM, MKV, FLV), the node raises an error. For nested folders whose name starts with a number followed by an underscore (for example `5_classname`), each video inside that folder is included in the dataset the number of times given by that prefix. Each video's caption is read from a `.txt` file with the same base name; if no matching `.txt` file exists, the caption is an empty string. ## Outputs @@ -20,4 +20,4 @@ If the selected folder contains no files with a supported video extension, the n > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LoadVideoTextDataSetFromFolder/en.md) --- -**Source fingerprint (SHA-256):** `91236fcb1e42b8de1a1100b0aecaad49bd49c159d7d8f502032cd7f5b2b54845` +**Source fingerprint (SHA-256):** `21ed21bc3189e96be5c7f0415c65e8749d6591cf19bddf4350a3b0af48b92841` diff --git a/comfyui_embedded_docs/docs/LoraLoaderBypass/en.md b/comfyui_embedded_docs/docs/LoraLoaderBypass/en.md index 02408e41c..4f109c9a2 100644 --- a/comfyui_embedded_docs/docs/LoraLoaderBypass/en.md +++ b/comfyui_embedded_docs/docs/LoraLoaderBypass/en.md @@ -8,20 +8,22 @@ The LoraLoaderBypass node applies a LoRA (Low-Rank Adaptation) to a diffusion mo | --- | --- | --- | --- | --- | | `model` | The diffusion model the LoRA will be applied to. | MODEL | Yes | - | | `clip` | The CLIP model the LoRA will be applied to. | CLIP | Yes | - | -| `lora_name` | The name of the LoRA file to apply. The options are loaded from the `loras` folder. | COMBO | Yes | *List of available LoRA files* | -| `strength_model` | How strongly to modify the diffusion model. This value can be negative (default: 1.0). | FLOAT | Yes | -100.0 to 100.0 | -| `strength_clip` | How strongly to modify the CLIP model. This value can be negative (default: 1.0). | FLOAT | Yes | -100.0 to 100.0 | +| `lora_name` | The name of the LoRA. Available LoRA files are loaded from the `loras` folder. | COMBO | Yes | List of available LoRA files | +| `strength_model` | How strongly to modify the diffusion model. This value can be negative (default: 1.0). | FLOAT | Yes | -100.0 to 100.0 (step: 0.01) | +| `strength_clip` | How strongly to modify the CLIP model. This value can be negative (default: 1.0). | FLOAT | Yes | -100.0 to 100.0 (step: 0.01) | -**Note:** If both `strength_model` and `strength_clip` are set to 0, the node will return the original, unmodified `model` and `clip` inputs without processing. +**Note:** If both `strength_model` and `strength_clip` are set to 0, the node returns the original, unmodified `model` and `clip` inputs without processing. ## Outputs | Output Name | Description | Data Type | | --- | --- | --- | -| `MODEL` | The diffusion model with the LoRA applied in bypass mode. | MODEL | -| `CLIP` | The CLIP model with the LoRA applied in bypass mode. | CLIP | +| `MODEL` | The modified diffusion model. | MODEL | +| `CLIP` | The modified CLIP model. | CLIP | + +**Note:** This node is marked as experimental. > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LoraLoaderBypass/en.md) --- -**Source fingerprint (SHA-256):** `2642f4ed98457e5fd08e2103ffb9f2c02f11326590aadf0636fb7db51f484815` +**Source fingerprint (SHA-256):** `025f0638a6690a53b1a6c4548dac24fb7e7f26e04ff4b1c88d29b061430037a8` diff --git a/comfyui_embedded_docs/docs/LoraModelLoader/en.md b/comfyui_embedded_docs/docs/LoraModelLoader/en.md index 9e6cc8d51..51e49e11e 100644 --- a/comfyui_embedded_docs/docs/LoraModelLoader/en.md +++ b/comfyui_embedded_docs/docs/LoraModelLoader/en.md @@ -1,6 +1,6 @@ # Load LoRA Model -The LoraModelLoader node applies trained LoRA (Low-Rank Adaptation) weights to a diffusion model. It modifies the base model by loading LoRA weights from a trained LoRA model and adjusting their influence strength. This allows you to customize the behavior of diffusion models without retraining them from scratch. +The LoraModelLoader node applies trained LoRA (Low-Rank Adaptation) weights to a diffusion model. It modifies the base model by loading LoRA weights from a trained LoRA model and adjusting their influence strength. This allows you to customize the behavior of diffusion models without retraining them from scratch, including a bypass mode that leaves the base model weights unchanged. ## Inputs @@ -22,4 +22,4 @@ The LoraModelLoader node applies trained LoRA (Low-Rank Adaptation) weights to a > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LoraModelLoader/en.md) --- -**Source fingerprint (SHA-256):** `dbb0852d4f40ded8a4490244634e13eeb367e5573b664a0f7e37213364793413` +**Source fingerprint (SHA-256):** `81eb2a9b0376fe7453f6e7e422414472e80a3d1b92bb6874b91df6de8aed0d9a` diff --git a/comfyui_embedded_docs/docs/LossGraphNode/en.md b/comfyui_embedded_docs/docs/LossGraphNode/en.md index 734c13912..056a987bb 100644 --- a/comfyui_embedded_docs/docs/LossGraphNode/en.md +++ b/comfyui_embedded_docs/docs/LossGraphNode/en.md @@ -1,12 +1,12 @@ # Plot Loss Graph -The LossGraphNode creates a visual graph of training loss values over time and displays it as a preview image. It takes loss data from training processes and generates a line chart showing how the loss changes across training steps. The resulting graph includes axis labels and min/max loss values. +The LossGraphNode creates a line chart of training loss values over training steps and shows it as a preview image. It reads loss values from a training node, plots them on a graph with labeled axes and min/max loss values, and returns the graph as an image preview in the UI. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `loss` | Loss map from training node. | LOSS_MAP | Yes | - | +| `loss` | Loss map from training node. It must contain a `loss` key with a list of numeric loss values. | LOSS_MAP | Yes | - | | `filename_prefix` | Prefix for the saved loss graph image. (default: "loss_graph") | STRING | Yes | - | ## Outputs @@ -18,4 +18,4 @@ The LossGraphNode creates a visual graph of training loss values over time and d > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LossGraphNode/en.md) --- -**Source fingerprint (SHA-256):** `88164045339e4181cefc6ed3a2d3c35921b9cadc2977eb7406fad7e9b353f818` +**Source fingerprint (SHA-256):** `b1f0b72a03d4ce2d9461fc6e312bd1e847455f7dd5227667876a945494ea8cdb` diff --git a/comfyui_embedded_docs/docs/LotusConditioning/en.md b/comfyui_embedded_docs/docs/LotusConditioning/en.md index 317d4e21b..53aeacfc2 100644 --- a/comfyui_embedded_docs/docs/LotusConditioning/en.md +++ b/comfyui_embedded_docs/docs/LotusConditioning/en.md @@ -17,4 +17,4 @@ The LotusConditioning node provides pre-computed conditioning embeddings for the > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LotusConditioning/en.md) --- -**Source fingerprint (SHA-256):** `950e09b7fda911c7596445cf1a90ec10f451b396534f149b74e86b2da7deacc0` +**Source fingerprint (SHA-256):** `1fcb6530850341253c8acb47b2f26ee79d93f51eca84bef03a1fa5de33d6bc8d` diff --git a/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/ar.md b/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/ar.md index 47441235d..04af13db9 100644 --- a/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/ar.md +++ b/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/ar.md @@ -6,11 +6,11 @@ | المعامل | الوصف | نوع البيانات | مطلوب | النطاق | |-----------|-------------|-----------|----------|-------| -| `audio` | المسار الصوتي الذي يحرك الفيديو. يحدد طوله (2-20 ثانية) مدة الفيديو. | AUDIO | نعم | 2-20 ثانية | -| `model` | إصدار نموذج LTX 2.5 المطلوب استخدامه. تُختار الدقة مع النموذج؛ يوفر كلا النموذجين نفس خيارات الدقة (1920x1080 أو 1080x1920). | COMBO | نعم | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | -| `prompt` | وصف نصي يوجه محتوى الفيديو المُنشأ (الافتراضي: ""). يجب أن يحتوي على حرف واحد على الأقل وبحد أقصى 10000 حرف. | STRING | نعم | 1-10000 حرف | -| `seed` | رقم يتحكم في عشوائية التوليد. نفس الرقم ينتج نفس النتيجة (الافتراضي: 42). | INT | نعم | أي عدد صحيح | -| `image` | إطار أول اختياري يُستخدم للفيديو. يتم دعم صورة واحدة فقط. | IMAGE | لا | صورة واحدة | +| `الصوت` | المسار الصوتي الذي يحرك الفيديو. يحدد طوله (2-20 ثانية) مدة الفيديو. | AUDIO | نعم | 2-20 ثانية | +| `النموذج` | إصدار نموذج LTX 2.5 المطلوب استخدامه. تُختار الدقة مع النموذج؛ يوفر كلا النموذجين نفس خيارات الدقة (1920x1080 أو 1080x1920). | COMBO | نعم | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | +| `المطالبة` | وصف نصي يوجه محتوى الفيديو المُنشأ (الافتراضي: ""). يجب أن يحتوي على حرف واحد على الأقل وبحد أقصى 10000 حرف. | STRING | نعم | 1-10000 حرف | +| `البذرة` | رقم يتحكم في عشوائية التوليد. نفس الرقم ينتج نفس النتيجة (الافتراضي: 42). | INT | نعم | أي عدد صحيح | +| `الصورة` | إطار أول اختياري يُستخدم للفيديو. يتم دعم صورة واحدة فقط. | IMAGE | لا | صورة واحدة | ملاحظات حول القيود: - يجب أن تكون مدة الصوت بين 2 و20 ثانية؛ تُظهر العقدة خطأً إذا كانت خارج هذا النطاق. diff --git a/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/en.md b/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/en.md index bb60e3dd4..26807a583 100644 --- a/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/en.md +++ b/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/en.md @@ -1,4 +1,4 @@ -# LtxApi25AudioToVideo +# LTX 2.5 Audio To Video This node generates a video that follows an audio track using the LTX 2.5 model. The audio determines the video duration (between 2 and 20 seconds), and you can optionally provide an image to use as the first frame. The video is generated through the LTX 2.5 API service. @@ -7,14 +7,14 @@ This node generates a video that follows an audio track using the LTX 2.5 model. | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| | `audio` | Audio track driving the video. Its length (2-20 seconds) sets the video duration. | AUDIO | Yes | 2-20 seconds | -| `model` | The LTX 2.5 model version to use. The resolution is chosen along with the model; both models offer the same resolution options (1920x1080 or 1080x1920). | COMBO | Yes | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | +| `model` | The LTX 2.5 model version to use. The video resolution (1920x1080 or 1080x1920) is selected together with the model; both models offer the same resolution options. | COMBO | Yes | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | | `prompt` | A text description that guides the content of the generated video (default: ""). Must contain at least 1 character and at most 10000 characters. | STRING | Yes | 1-10000 characters | | `seed` | A number that controls the randomness of the generation. The same seed produces the same result (default: 42). | INT | Yes | Any integer | | `image` | Optional first frame to be used for the video. Only one image is supported. | IMAGE | No | Single image | Notes on constraints: - The audio duration must be between 2 and 20 seconds; the node raises an error if it is outside this range. -- The prompt is required and cannot be empty. +- The prompt is required and cannot be empty; it must be between 1 and 10000 characters. - Only a single input image is accepted when `image` is provided. ## Outputs diff --git a/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/es.md b/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/es.md index c8f5808d1..ff33bd950 100644 --- a/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/es.md +++ b/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/es.md @@ -7,10 +7,10 @@ Este nodo genera un video que sigue una pista de audio utilizando el modelo LTX | Parámetro | Descripción | Tipo de dato | Obligatorio | Rango | |-----------|-------------|--------------|-------------|-------| | `audio` | Pista de audio que impulsa el video. Su duración (2-20 segundos) establece la duración del video. | AUDIO | Sí | 2-20 segundos | -| `model` | La versión del modelo LTX 2.5 a utilizar. La resolución se elige junto con el modelo; ambos modelos ofrecen las mismas opciones de resolución (1920x1080 o 1080x1920). | COMBO | Sí | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | +| `modelo` | La versión del modelo LTX 2.5 a utilizar. La resolución se elige junto con el modelo; ambos modelos ofrecen las mismas opciones de resolución (1920x1080 o 1080x1920). | COMBO | Sí | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | | `prompt` | Una descripción de texto que guía el contenido del video generado (por defecto: ""). Debe contener al menos 1 carácter y como máximo 10000 caracteres. | STRING | Sí | 1-10000 caracteres | -| `seed` | Un número que controla la aleatoriedad de la generación. La misma semilla produce el mismo resultado (por defecto: 42). | INT | Sí | Cualquier entero | -| `image` | Primer fotograma opcional para usar en el video. Solo se admite una imagen. | IMAGE | No | Una sola imagen | +| `semilla` | Un número que controla la aleatoriedad de la generación. La misma semilla produce el mismo resultado (por defecto: 42). | INT | Sí | Cualquier entero | +| `imagen` | Primer fotograma opcional para usar en el video. Solo se admite una imagen. | IMAGE | No | Una sola imagen | Notas sobre las restricciones: - La duración del audio debe estar entre 2 y 20 segundos; el nodo genera un error si está fuera de este rango. diff --git a/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/fa.md b/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/fa.md index 59a704aba..0c904b1c7 100644 --- a/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/fa.md +++ b/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/fa.md @@ -6,11 +6,11 @@ | پارامتر | توضیحات | نوع داده | الزامی | محدوده | |---------|----------|----------|--------|--------| -| `audio` | مسیر صوتی که ویدیو را هدایت می‌کند. طول آن (2 تا 20 ثانیه) مدت‌زمان ویدیو را تعیین می‌کند. | AUDIO | بله | 2-20 ثانیه | -| `model` | نسخه مدل LTX 2.5 که باید استفاده شود. رزولوشن همراه با مدل انتخاب می‌شود؛ هر دو مدل گزینه‌های رزولوشن یکسانی ارائه می‌دهند (1920x1080 یا 1080x1920). | COMBO | بله | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | -| `prompt` | توضیح متنی که محتوای ویدیوی تولیدشده را هدایت می‌کند (پیش‌فرض: ""). باید حداقل 1 کاراکتر و حداکثر 10000 کاراکتر داشته باشد. | STRING | بله | 1-10000 کاراکتر | -| `seed` | عددی که تصادفی‌بودن تولید را کنترل می‌کند. همان seed نتیجه یکسانی تولید می‌کند (پیش‌فرض: 42). | INT | بله | هر عدد صحیح | -| `image` | فریم اول اختیاری که برای ویدیو استفاده می‌شود. تنها یک تصویر پشتیبانی می‌شود. | IMAGE | خیر | یک تصویر | +| `صوت` | مسیر صوتی که ویدیو را هدایت می‌کند. طول آن (2 تا 20 ثانیه) مدت‌زمان ویدیو را تعیین می‌کند. | AUDIO | بله | 2-20 ثانیه | +| `مدل` | نسخه مدل LTX 2.5 که باید استفاده شود. رزولوشن همراه با مدل انتخاب می‌شود؛ هر دو مدل گزینه‌های رزولوشن یکسانی ارائه می‌دهند (1920x1080 یا 1080x1920). | COMBO | بله | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | +| `پرامپت` | توضیح متنی که محتوای ویدیوی تولیدشده را هدایت می‌کند (پیش‌فرض: ""). باید حداقل 1 کاراکتر و حداکثر 10000 کاراکتر داشته باشد. | STRING | بله | 1-10000 کاراکتر | +| `بذر` | عددی که تصادفی‌بودن تولید را کنترل می‌کند. همان seed نتیجه یکسانی تولید می‌کند (پیش‌فرض: 42). | INT | بله | هر عدد صحیح | +| `تصویر` | فریم اول اختیاری که برای ویدیو استفاده می‌شود. تنها یک تصویر پشتیبانی می‌شود. | IMAGE | خیر | یک تصویر | نکات مربوط به محدودیت‌ها: - مدت‌زمان صدا باید بین 2 تا 20 ثانیه باشد؛ اگر خارج از این محدوده باشد، گره خطا ایجاد می‌کند. diff --git a/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/fr.md b/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/fr.md index 075e1dfb8..da6c7a8bf 100644 --- a/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/fr.md +++ b/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/fr.md @@ -7,7 +7,7 @@ Ce nœud génère une vidéo qui suit une piste audio à l'aide du modèle LTX 2 | Paramètre | Description | Type de données | Requis | Plage | |-----------|-------------|-----------------|--------|-------| | `audio` | Piste audio pilotant la vidéo. Sa durée (2-20 secondes) définit la durée de la vidéo. | AUDIO | Oui | 2-20 secondes | -| `model` | La version du modèle LTX 2.5 à utiliser. La résolution est choisie avec le modèle ; les deux modèles offrent les mêmes options de résolution (1920x1080 ou 1080x1920). | COMBO | Oui | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | +| `modèle` | La version du modèle LTX 2.5 à utiliser. La résolution est choisie avec le modèle ; les deux modèles offrent les mêmes options de résolution (1920x1080 ou 1080x1920). | COMBO | Oui | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | | `prompt` | Description textuelle qui guide le contenu de la vidéo générée (par défaut : ""). Doit contenir au moins 1 caractère et au plus 10000 caractères. | STRING | Oui | 1-10000 caractères | | `seed` | Nombre qui contrôle le caractère aléatoire de la génération. La même graine (seed) produit le même résultat (par défaut : 42). | INT | Oui | Tout entier | | `image` | Première image facultative à utiliser pour la vidéo. Une seule image est prise en charge. | IMAGE | Non | Une seule image | diff --git a/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/ja.md b/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/ja.md index 6bac4168f..828c72a8d 100644 --- a/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/ja.md +++ b/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/ja.md @@ -6,11 +6,11 @@ | パラメータ | 説明 | データ型 | 必須 | 範囲 | |-----------|-------------|-----------|----------|-------| -| `audio` | ビデオを駆動するオーディオトラック。その長さ(2〜20秒)がビデオの長さを決定します。 | AUDIO | はい | 2〜20秒 | -| `model` | 使用するLTX 2.5モデルバージョン。解像度はモデルとともに選択されます。両方のモデルで同じ解像度オプション(1920x1080または1080x1920)が利用可能です。 | COMBO | はい | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | -| `prompt` | 生成されるビデオの内容を導くテキストによる説明(デフォルト: "")。1文字以上10000文字以下でなければなりません。 | STRING | はい | 1〜10000文字 | -| `seed` | 生成のランダム性を制御する数値。同じシードを使用すると同じ結果が生成されます(デフォルト: 42)。 | INT | はい | 任意の整数 | -| `image` | ビデオに使用するオプションの先頭フレーム。サポートされる画像は1枚のみです。 | IMAGE | いいえ | 単一画像 | +| `オーディオ` | ビデオを駆動するオーディオトラック。その長さ(2〜20秒)がビデオの長さを決定します。 | AUDIO | はい | 2〜20秒 | +| `モデル` | 使用するLTX 2.5モデルバージョン。解像度はモデルとともに選択されます。両方のモデルで同じ解像度オプション(1920x1080または1080x1920)が利用可能です。 | COMBO | はい | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | +| `プロンプト` | 生成されるビデオの内容を導くテキストによる説明(デフォルト: "")。1文字以上10000文字以下でなければなりません。 | STRING | はい | 1〜10000文字 | +| `シード` | 生成のランダム性を制御する数値。同じシードを使用すると同じ結果が生成されます(デフォルト: 42)。 | INT | はい | 任意の整数 | +| `画像` | ビデオに使用するオプションの先頭フレーム。サポートされる画像は1枚のみです。 | IMAGE | いいえ | 単一画像 | 制約に関する注意事項: - オーディオの長さは2〜20秒の範囲内でなければなりません。この範囲外の場合はノードがエラーを発生させます。 diff --git a/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/ko.md b/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/ko.md index 7b90581fb..3826a67a5 100644 --- a/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/ko.md +++ b/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/ko.md @@ -6,11 +6,11 @@ | 매개변수 | 설명 | 데이터 유형 | 필수 | 범위 | |-----------|-------------|-----------|----------|-------| -| `audio` | 비디오를 구동하는 오디오 트랙입니다. 오디오 길이(2~20초)가 비디오 길이를 결정합니다. | AUDIO | 예 | 2-20초 | -| `model` | 사용할 LTX 2.5 모델 버전입니다. 해상도는 모델과 함께 선택되며, 두 모델 모두 동일한 해상도 옵션(1920x1080 또는 1080x1920)을 제공합니다. | COMBO | 예 | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | -| `prompt` | 생성할 비디오의 내용을 안내하는 텍스트 설명입니다(기본값: ""). 최소 1자 이상, 최대 10000자 이하여야 합니다. | STRING | 예 | 1-10000자 | -| `seed` | 생성의 무작위성을 제어하는 숫자입니다. 동일한 시드 값은 동일한 결과를 생성합니다(기본값: 42). | INT | 예 | 모든 정수 | -| `image` | 비디오에 사용할 선택적 첫 번째 프레임입니다. 하나의 이미지만 지원됩니다. | IMAGE | 아니요 | 단일 이미지 | +| `오디오` | 비디오를 구동하는 오디오 트랙입니다. 오디오 길이(2~20초)가 비디오 길이를 결정합니다. | AUDIO | 예 | 2-20초 | +| `모델` | 사용할 LTX 2.5 모델 버전입니다. 해상도는 모델과 함께 선택되며, 두 모델 모두 동일한 해상도 옵션(1920x1080 또는 1080x1920)을 제공합니다. | COMBO | 예 | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | +| `프롬프트` | 생성할 비디오의 내용을 안내하는 텍스트 설명입니다(기본값: ""). 최소 1자 이상, 최대 10000자 이하여야 합니다. | STRING | 예 | 1-10000자 | +| `시드` | 생성의 무작위성을 제어하는 숫자입니다. 동일한 시드 값은 동일한 결과를 생성합니다(기본값: 42). | INT | 예 | 모든 정수 | +| `이미지` | 비디오에 사용할 선택적 첫 번째 프레임입니다. 하나의 이미지만 지원됩니다. | IMAGE | 아니요 | 단일 이미지 | 제약 조건 참고 사항: - 오디오 길이는 2초에서 20초 사이여야 하며, 이 범위를 벗어나면 노드에서 오류가 발생합니다. diff --git a/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/pt-BR.md b/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/pt-BR.md index 067f6e0f7..696c4df98 100644 --- a/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/pt-BR.md +++ b/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/pt-BR.md @@ -6,11 +6,11 @@ Este nó gera um vídeo que segue uma trilha de áudio usando o modelo LTX 2.5. | Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | |-----------|-------------|-----------|----------|-------| -| `audio` | Trilha de áudio que orienta o vídeo. A duração do áudio (2 a 20 segundos) define a duração do vídeo. | AUDIO | Sim | 2 a 20 segundos | -| `model` | A versão do modelo LTX 2.5 a ser usada. A resolução é escolhida junto com o modelo; ambos os modelos oferecem as mesmas opções de resolução (1920x1080 ou 1080x1920). | COMBO | Sim | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | +| `áudio` | Trilha de áudio que orienta o vídeo. A duração do áudio (2 a 20 segundos) define a duração do vídeo. | AUDIO | Sim | 2 a 20 segundos | +| `modelo` | A versão do modelo LTX 2.5 a ser usada. A resolução é escolhida junto com o modelo; ambos os modelos oferecem as mesmas opções de resolução (1920x1080 ou 1080x1920). | COMBO | Sim | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | | `prompt` | Uma descrição em texto que orienta o conteúdo do vídeo gerado (padrão: ""). Deve conter pelo menos 1 caractere e no máximo 10000 caracteres. | STRING | Sim | 1 a 10000 caracteres | -| `seed` | Um número que controla a aleatoriedade da geração. A mesma `seed` produz o mesmo resultado (padrão: 42). | INT | Sim | Qualquer número inteiro | -| `image` | Primeiro quadro opcional a ser usado no vídeo. Apenas uma imagem é suportada. | IMAGE | Não | Uma única imagem | +| `semente` | Um número que controla a aleatoriedade da geração. A mesma `seed` produz o mesmo resultado (padrão: 42). | INT | Sim | Qualquer número inteiro | +| `imagem` | Primeiro quadro opcional a ser usado no vídeo. Apenas uma imagem é suportada. | IMAGE | Não | Uma única imagem | ## Notas sobre restrições diff --git a/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/ru.md b/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/ru.md index b9477de36..0d3dac815 100644 --- a/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/ru.md +++ b/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/ru.md @@ -6,11 +6,11 @@ | Параметр | Описание | Тип данных | Обязательный | Диапазон | |-----------|-------------|-----------|----------|-------| -| `audio` | Аудиодорожка, управляющая видео. Её длина (2-20 секунд) определяет продолжительность видео. | AUDIO | Да | 2-20 seconds | -| `model` | Версия модели LTX 2.5 для использования. Разрешение выбирается вместе с моделью; обе модели предлагают одинаковые варианты разрешения (1920x1080 или 1080x1920). | COMBO | Да | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | -| `prompt` | Текстовое описание, которое задаёт содержимое генерируемого видео (по умолчанию: ""). Должно содержать не менее 1 и не более 10000 символов. | STRING | Да | 1-10000 characters | +| `аудио` | Аудиодорожка, управляющая видео. Её длина (2-20 секунд) определяет продолжительность видео. | AUDIO | Да | 2-20 seconds | +| `модель` | Версия модели LTX 2.5 для использования. Разрешение выбирается вместе с моделью; обе модели предлагают одинаковые варианты разрешения (1920x1080 или 1080x1920). | COMBO | Да | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | +| `промпт` | Текстовое описание, которое задаёт содержимое генерируемого видео (по умолчанию: ""). Должно содержать не менее 1 и не более 10000 символов. | STRING | Да | 1-10000 characters | | `seed` | Число, управляющее случайностью генерации. Одинаковое значение seed даёт одинаковый результат (по умолчанию: 42). | INT | Да | Any integer | -| `image` | Необязательный первый кадр для использования в видео. Поддерживается только одно изображение. | IMAGE | Нет | Single image | +| `изображение` | Необязательный первый кадр для использования в видео. Поддерживается только одно изображение. | IMAGE | Нет | Single image | Примечания об ограничениях: - Длительность аудио должна быть от 2 до 20 секунд; узел выдаёт ошибку, если она выходит за этот диапазон. diff --git a/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/tr.md b/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/tr.md index 5cb3e4c54..c9ffb9f59 100644 --- a/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/tr.md +++ b/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/tr.md @@ -6,11 +6,11 @@ Bu düğüm, LTX 2.5 modelini kullanarak bir ses parçasına uygun video oluştu | Parametre | Açıklama | Veri Türü | Gerekli | Aralık | |-----------|-------------|-----------|----------|-------| -| `audio` | Videoyu yönlendiren ses parçası. Uzunluğu (2-20 saniye) video süresini belirler. | AUDIO | Evet | 2-20 seconds | +| `ses` | Videoyu yönlendiren ses parçası. Uzunluğu (2-20 saniye) video süresini belirler. | AUDIO | Evet | 2-20 seconds | | `model` | Kullanılacak LTX 2.5 model sürümü. Çözünürlük modelle birlikte seçilir; her iki model de aynı çözünürlük seçeneklerini sunar (1920x1080 veya 1080x1920). | COMBO | Evet | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | | `prompt` | Oluşturulan videonun içeriğini yönlendiren metin açıklaması (varsayılan: ""). En az 1 karakter ve en fazla 10000 karakter içermelidir. | STRING | Evet | 1-10000 characters | -| `seed` | Üretimin rastgeleliğini kontrol eden bir sayı. Aynı seed aynı sonucu üretir (varsayılan: 42). | INT | Evet | Any integer | -| `image` | Video için kullanılacak isteğe bağlı ilk kare. Yalnızca bir görüntü desteklenir. | IMAGE | Hayır | Single image | +| `tohum` | Üretimin rastgeleliğini kontrol eden bir sayı. Aynı seed aynı sonucu üretir (varsayılan: 42). | INT | Evet | Any integer | +| `görsel` | Video için kullanılacak isteğe bağlı ilk kare. Yalnızca bir görüntü desteklenir. | IMAGE | Hayır | Single image | Kısıtlamalara ilişkin notlar: - Ses süresi 2 ila 20 saniye arasında olmalıdır; düğüm bu aralığın dışında bir değerde hata verir. diff --git a/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/zh-TW.md b/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/zh-TW.md index d13cd7bb6..b84fb87d7 100644 --- a/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/zh-TW.md +++ b/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/zh-TW.md @@ -6,11 +6,11 @@ | 參數 | 描述 | 資料類型 | 必填 | 範圍 | |-----------|-------------|-----------|----------|-------| -| `audio` | 驅動影片的音訊軌跡。其長度(2-20 秒)設定影片的持續時間。 | AUDIO | 是 | 2-20 seconds | -| `model` | 要使用的 LTX 2.5 模型版本。解析度與模型一起選擇;兩種型號提供相同的解析度選項(1920x1080 或 1080x1920)。 | COMBO | 是 | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | -| `prompt` | 引導生成影片內容的文字描述(預設:"")。必須至少包含 1 個字元,最多 10000 個字元。 | STRING | 是 | 1-10000 characters | -| `seed` | 控制生成隨機性的數字。相同的種子會產生相同的結果(預設:42)。 | INT | 是 | Any integer | -| `image` | 可選的影片第一個畫面。僅支援一張圖片。 | IMAGE | 否 | Single image | +| `音訊` | 驅動影片的音訊軌跡。其長度(2-20 秒)設定影片的持續時間。 | AUDIO | 是 | 2-20 seconds | +| `模型` | 要使用的 LTX 2.5 模型版本。解析度與模型一起選擇;兩種型號提供相同的解析度選項(1920x1080 或 1080x1920)。 | COMBO | 是 | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | +| `提示詞` | 引導生成影片內容的文字描述(預設:"")。必須至少包含 1 個字元,最多 10000 個字元。 | STRING | 是 | 1-10000 characters | +| `種子` | 控制生成隨機性的數字。相同的種子會產生相同的結果(預設:42)。 | INT | 是 | Any integer | +| `影像` | 可選的影片第一個畫面。僅支援一張圖片。 | IMAGE | 否 | Single image | 約束說明: - 音訊持續時間必須在 2 到 20 秒之間;如果超出此範圍,節點會引發錯誤。 diff --git a/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/zh.md b/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/zh.md index 590ad5ad4..c6c633a4f 100644 --- a/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/zh.md +++ b/comfyui_embedded_docs/docs/LtxApi25AudioToVideo/zh.md @@ -6,11 +6,11 @@ | 参数 | 描述 | 数据类型 | 必填 | 范围 | |-----------|-------------|-----------|----------|-------| -| `audio` | 驱动视频的音频轨道。其长度(2-20 秒)决定视频时长。 | AUDIO | 是 | 2-20 秒 | -| `model` | 要使用的 LTX 2.5 模型版本。分辨率与模型一起选择;两个模型提供相同的分辨率选项(1920x1080 或 1080x1920)。 | COMBO | 是 | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | -| `prompt` | 引导生成视频内容的文本描述(默认:"")。必须包含至少 1 个字符,最多 10000 个字符。 | STRING | 是 | 1-10000 个字符 | -| `seed` | 控制生成随机性的数字。相同的种子会产生相同的结果(默认:42)。 | INT | 是 | 任何整数 | -| `image` | 可选的视频首帧图片。仅支持单张图片。 | IMAGE | 否 | 单张图片 | +| `音频` | 驱动视频的音频轨道。其长度(2-20 秒)决定视频时长。 | AUDIO | 是 | 2-20 秒 | +| `模型` | 要使用的 LTX 2.5 模型版本。分辨率与模型一起选择;两个模型提供相同的分辨率选项(1920x1080 或 1080x1920)。 | COMBO | 是 | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | +| `提示词` | 引导生成视频内容的文本描述(默认:"")。必须包含至少 1 个字符,最多 10000 个字符。 | STRING | 是 | 1-10000 个字符 | +| `种子` | 控制生成随机性的数字。相同的种子会产生相同的结果(默认:42)。 | INT | 是 | 任何整数 | +| `图像` | 可选的视频首帧图片。仅支持单张图片。 | IMAGE | 否 | 单张图片 | 约束说明: - 音频时长必须在 2 到 20 秒之间;如果超出此范围,节点将报错。 diff --git a/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/ar.md b/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/ar.md index 1406faf58..ff260451d 100644 --- a/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/ar.md +++ b/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/ar.md @@ -6,15 +6,15 @@ | المعامل | الوصف | نوع البيانات | إلزامي | النطاق | |-----------|-------------|-----------|----------|-------| -| `image` | الإطار الأول المستخدم في الفيديو. | IMAGE | نعم | صورة واحدة بالضبط | -| `model` | مجموعة إعدادات النموذج. يحدد نسخة نموذج LTX 2.5 المستخدمة. | COMBO | نعم | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | -| `model.duration` | طول الفيديو المُولَّد بالثواني. | INT | نعم | Integer | -| `model.resolution` | دقة الفيديو المُولَّد. قد تعتمد الخيارات المتاحة على النموذج المحدد. | COMBO | نعم | "1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840" | -| `model.fps` | معدل إطارات الفيديو المُولَّد. | INT | نعم | Integer (الافتراضي: 25) | -| `model.generate_audio` | ما إذا كان سيتم توليد صوت للفيديو. | BOOLEAN | نعم | True
False | -| `prompt` | وصف نصي لمحتوى الفيديو المراد توليده. يجب أن يتراوح بين 1 و10000 حرف. | STRING | نعم | من 1 إلى 10000 حرف | -| `seed` | قيمة البذرة لتوليد قابل لإعادة الإنتاج. استخدام نفس البذرة مع نفس الإعدادات ينتج نفس النتيجة. | INT | نعم | Integer (الافتراضي: 42) | -| `last_frame` | الإطار الأخير المستخدم في الفيديو. | IMAGE | لا | صورة واحدة بالضبط | +| `الصورة` | الإطار الأول المستخدم في الفيديو. | IMAGE | نعم | صورة واحدة بالضبط | +| `النموذج` | مجموعة إعدادات النموذج. يحدد نسخة نموذج LTX 2.5 المستخدمة. | COMBO | نعم | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | +| `المدة` | طول الفيديو المُولَّد بالثواني. | INT | نعم | Integer | +| `الدقة` | دقة الفيديو المُولَّد. قد تعتمد الخيارات المتاحة على النموذج المحدد. | COMBO | نعم | "1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840" | +| `معدل الإطارات` | معدل إطارات الفيديو المُولَّد. | INT | نعم | Integer (الافتراضي: 25) | +| `توليد الصوت` | ما إذا كان سيتم توليد صوت للفيديو. | BOOLEAN | نعم | True
False | +| `المطالبة` | وصف نصي لمحتوى الفيديو المراد توليده. يجب أن يتراوح بين 1 و10000 حرف. | STRING | نعم | من 1 إلى 10000 حرف | +| `البذرة` | قيمة البذرة لتوليد قابل لإعادة الإنتاج. استخدام نفس البذرة مع نفس الإعدادات ينتج نفس النتيجة. | INT | نعم | Integer (الافتراضي: 42) | +| `الإطار الأخير` | الإطار الأخير المستخدم في الفيديو. | IMAGE | لا | صورة واحدة بالضبط | ## المخرجات diff --git a/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/en.md b/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/en.md index e56ac2b4c..37a11e2c2 100644 --- a/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/en.md +++ b/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/en.md @@ -1,6 +1,6 @@ -# LtxApi25ImageToVideo +# LTX 2.5 Image To Video -This node generates a professional-quality video based on a starting image. You can choose the LTX 2.5 model variant, describe the video with a text prompt, adjust duration, resolution, frame rate, and audio generation, and optionally provide a final frame. The output is a video that starts from the provided image. +This node generates a professional-quality video from a starting image using an LTX 2.5 model. You describe the video content with a text prompt, select a model variant, and adjust duration, resolution, frame rate, and audio generation. An optional final frame can be supplied to define the end of the video. ## Inputs @@ -11,11 +11,13 @@ This node generates a professional-quality video based on a starting image. You | `model.duration` | Length of the generated video in seconds. | INT | Yes | Integer | | `model.resolution` | Resolution of the generated video. Available options may depend on the selected model. | COMBO | Yes | "1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840" | | `model.fps` | Frame rate of the generated video. | INT | Yes | Integer (default: 25) | -| `model.generate_audio` | Whether to generate audio for the video. | BOOLEAN | Yes | True
False | +| `model.generate_audio` | Whether to generate audio for the video. | BOOLEAN | Yes | True
False (default: True) | | `prompt` | Text description of the video content to generate. Must be between 1 and 10000 characters. | STRING | Yes | 1 to 10000 characters | | `seed` | Seed value for reproducible generation. Using the same seed with the same settings produces the same result. | INT | Yes | Integer (default: 42) | | `last_frame` | Last frame to be used for the video. | IMAGE | No | Exactly one image | +**Note:** Only one image is supported for `image`. If `last_frame` is provided, it must also contain exactly one image. The available `model.resolution` options may vary depending on the selected `model` variant. + ## Outputs | Output Name | Description | Data Type | diff --git a/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/es.md b/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/es.md index ac39f518c..981677dac 100644 --- a/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/es.md +++ b/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/es.md @@ -6,15 +6,15 @@ Este nodo genera un video de calidad profesional basado en una imagen inicial. P | Parámetro | Descripción | Tipo de datos | Requerido | Rango | |-----------|-------------|-----------|----------|-------| -| `image` | Primera imagen (fotograma) que se utilizará para el video. | IMAGE | Sí | Exactamente una imagen | -| `model` | Grupo de configuración del modelo. Selecciona la variante del modelo LTX 2.5 a utilizar. | COMBO | Sí | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | -| `model.duration` | Duración del video generado en segundos. | INT | Sí | Entero | -| `model.resolution` | Resolución del video generado. Las opciones disponibles pueden depender del modelo seleccionado. | COMBO | Sí | "1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840" | -| `model.fps` | Velocidad de fotogramas del video generado. | INT | Sí | Entero (predeterminado: 25) | -| `model.generate_audio` | Si se debe generar audio para el video. | BOOLEAN | Sí | True
False | +| `imagen` | Primera imagen (fotograma) que se utilizará para el video. | IMAGE | Sí | Exactamente una imagen | +| `modelo` | Grupo de configuración del modelo. Selecciona la variante del modelo LTX 2.5 a utilizar. | COMBO | Sí | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | +| `duración` | Duración del video generado en segundos. | INT | Sí | Entero | +| `resolución` | Resolución del video generado. Las opciones disponibles pueden depender del modelo seleccionado. | COMBO | Sí | "1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840" | +| `fps` | Velocidad de fotogramas del video generado. | INT | Sí | Entero (predeterminado: 25) | +| `generar_audio` | Si se debe generar audio para el video. | BOOLEAN | Sí | True
False | | `prompt` | Descripción de texto del contenido del video a generar. Debe tener entre 1 y 10000 caracteres. | STRING | Sí | 1 a 10000 caracteres | -| `seed` | Valor de semilla para generación reproducible. Usar la misma semilla con la misma configuración produce el mismo resultado. | INT | Sí | Entero (predeterminado: 42) | -| `last_frame` | Último fotograma que se utilizará para el video. | IMAGE | No | Exactamente una imagen | +| `semilla` | Valor de semilla para generación reproducible. Usar la misma semilla con la misma configuración produce el mismo resultado. | INT | Sí | Entero (predeterminado: 42) | +| `último_fotograma` | Último fotograma que se utilizará para el video. | IMAGE | No | Exactamente una imagen | ## Salidas diff --git a/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/fa.md b/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/fa.md index d55fcd481..830724f3d 100644 --- a/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/fa.md +++ b/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/fa.md @@ -6,15 +6,15 @@ | پارامتر | توضیحات | نوع داده | الزامی | محدوده | |-----------|-------------|-----------|----------|-------| -| `image` | فریم اول برای استفاده در ویدئو. | IMAGE | بله | دقیقاً یک تصویر | -| `model` | گروه تنظیمات مدل. نوع مدل LTX 2.5 را انتخاب می‌کند. | COMBO | بله | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | -| `model.duration` | طول ویدئوی تولیدشده بر حسب ثانیه. | INT | بله | عدد صحیح | -| `model.resolution` | وضوح ویدئوی تولیدشده. گزینه‌های موجود ممکن است به مدل انتخابی بستگی داشته باشند. | COMBO | بله | "1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840" | -| `model.fps` | نرخ فریم ویدئوی تولیدشده. | INT | بله | عدد صحیح (پیش‌فرض: 25) | -| `model.generate_audio` | آیا برای ویدئو صدا تولید شود؟ | BOOLEAN | بله | True
False | -| `prompt` | توصیف متنی محتوای ویدئو برای تولید. باید بین ۱ تا ۱۰۰۰۰ کاراکتر باشد. | STRING | بله | ۱ تا ۱۰۰۰۰ کاراکتر | -| `seed` | مقدار seed برای تولید قابل تکرار. استفاده از seed یکسان با تنظیمات یکسان، نتیجه یکسان تولید می‌کند. | INT | بله | عدد صحیح (پیش‌فرض: 42) | -| `last_frame` | آخرین فریم برای استفاده در ویدئو. | IMAGE | خیر | دقیقاً یک تصویر | +| `تصویر` | فریم اول برای استفاده در ویدئو. | IMAGE | بله | دقیقاً یک تصویر | +| `مدل` | گروه تنظیمات مدل. نوع مدل LTX 2.5 را انتخاب می‌کند. | COMBO | بله | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | +| `مدت زمان` | طول ویدئوی تولیدشده بر حسب ثانیه. | INT | بله | عدد صحیح | +| `رزولوشن` | وضوح ویدئوی تولیدشده. گزینه‌های موجود ممکن است به مدل انتخابی بستگی داشته باشند. | COMBO | بله | "1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840" | +| `فریم بر ثانیه` | نرخ فریم ویدئوی تولیدشده. | INT | بله | عدد صحیح (پیش‌فرض: 25) | +| `تولید صوت` | آیا برای ویدئو صدا تولید شود؟ | BOOLEAN | بله | True
False | +| `پرامپت` | توصیف متنی محتوای ویدئو برای تولید. باید بین ۱ تا ۱۰۰۰۰ کاراکتر باشد. | STRING | بله | ۱ تا ۱۰۰۰۰ کاراکتر | +| `بذر` | مقدار seed برای تولید قابل تکرار. استفاده از seed یکسان با تنظیمات یکسان، نتیجه یکسان تولید می‌کند. | INT | بله | عدد صحیح (پیش‌فرض: 42) | +| `فریم آخر` | آخرین فریم برای استفاده در ویدئو. | IMAGE | خیر | دقیقاً یک تصویر | ## خروجی‌ها diff --git a/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/fr.md b/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/fr.md index aa29dbf40..eeab421da 100644 --- a/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/fr.md +++ b/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/fr.md @@ -7,11 +7,11 @@ Ce nœud génère une vidéo de qualité professionnelle à partir d'une image d | Paramètre | Description | Type de données | Requis | Plage | |-----------|-------------|-----------------|--------|-------| | `image` | Première image à utiliser pour la vidéo. | IMAGE | Oui | Exactement une image | -| `model` | Groupe de réglages du modèle. Sélectionne la variante du modèle LTX 2.5 à utiliser. | COMBO | Oui | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | -| `model.duration` | Durée de la vidéo générée en secondes. | INT | Oui | Entier | -| `model.resolution` | Résolution de la vidéo générée. Les options disponibles peuvent dépendre du modèle sélectionné. | COMBO | Oui | "1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840" | -| `model.fps` | Fréquence d'images de la vidéo générée. | INT | Oui | Entier (défaut : 25) | -| `model.generate_audio` | Indique si l'audio doit être généré pour la vidéo. | BOOLEAN | Oui | True
False | +| `modèle` | Groupe de réglages du modèle. Sélectionne la variante du modèle LTX 2.5 à utiliser. | COMBO | Oui | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | +| `durée` | Durée de la vidéo générée en secondes. | INT | Oui | Entier | +| `résolution` | Résolution de la vidéo générée. Les options disponibles peuvent dépendre du modèle sélectionné. | COMBO | Oui | "1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840" | +| `fps` | Fréquence d'images de la vidéo générée. | INT | Oui | Entier (défaut : 25) | +| `générer_audio` | Indique si l'audio doit être généré pour la vidéo. | BOOLEAN | Oui | True
False | | `prompt` | Description textuelle du contenu de la vidéo à générer. Doit contenir entre 1 et 10 000 caractères. | STRING | Oui | 1 à 10 000 caractères | | `seed` | Valeur de graine pour une génération reproductible. L'utilisation de la même graine avec les mêmes réglages produit le même résultat. | INT | Oui | Entier (défaut : 42) | | `last_frame` | Dernière image à utiliser pour la vidéo. | IMAGE | Non | Exactement une image | diff --git a/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/ja.md b/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/ja.md index e7579e3d9..22a1b69a5 100644 --- a/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/ja.md +++ b/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/ja.md @@ -6,15 +6,15 @@ | パラメータ | 説明 | データ型 | 必須 | 範囲 | |-----------|-------------|-----------|----------|-------| -| `image` | ビデオに使用される最初のフレームです。 | IMAGE | はい | 画像1枚のみ | -| `model` | モデル設定グループ。使用する LTX 2.5 モデルのバリアントを選択します。 | COMBO | はい | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | -| `model.duration` | 生成されるビデオの長さ(秒単位)。 | INT | はい | 整数 | -| `model.resolution` | 生成されるビデオの解像度。利用可能なオプションは選択したモデルによって異なる場合があります。 | COMBO | はい | "1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840" | -| `model.fps` | 生成されるビデオのフレームレート。 | INT | はい | 整数(デフォルト: 25) | -| `model.generate_audio` | ビデオのオーディオを生成するかどうか。 | BOOLEAN | はい | True
False | -| `prompt` | 生成するビデオ内容のテキスト記述。1文字以上10000文字以下である必要があります。 | STRING | はい | 1~10000文字 | -| `seed` | 再現性のためのシード値。同じ設定で同じシードを使用すると、同じ結果が生成されます。 | INT | はい | 整数(デフォルト: 42) | -| `last_frame` | ビデオに使用される最終フレームです。 | IMAGE | いいえ | 画像1枚のみ | +| `画像` | ビデオに使用される最初のフレームです。 | IMAGE | はい | 画像1枚のみ | +| `モデル` | モデル設定グループ。使用する LTX 2.5 モデルのバリアントを選択します。 | COMBO | はい | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | +| `長さ` | 生成されるビデオの長さ(秒単位)。 | INT | はい | 整数 | +| `解像度` | 生成されるビデオの解像度。利用可能なオプションは選択したモデルによって異なる場合があります。 | COMBO | はい | "1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840" | +| `fps` | 生成されるビデオのフレームレート。 | INT | はい | 整数(デフォルト: 25) | +| `オーディオ生成` | ビデオのオーディオを生成するかどうか。 | BOOLEAN | はい | True
False | +| `プロンプト` | 生成するビデオ内容のテキスト記述。1文字以上10000文字以下である必要があります。 | STRING | はい | 1~10000文字 | +| `シード` | 再現性のためのシード値。同じ設定で同じシードを使用すると、同じ結果が生成されます。 | INT | はい | 整数(デフォルト: 42) | +| `ラストフレーム` | ビデオに使用される最終フレームです。 | IMAGE | いいえ | 画像1枚のみ | ## 出力 diff --git a/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/ko.md b/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/ko.md index 7b6ce4e5b..91c0a6901 100644 --- a/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/ko.md +++ b/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/ko.md @@ -6,15 +6,15 @@ | 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | |-----------|-------------|-----------|----------|-------| -| `image` | 비디오에 사용할 첫 번째 프레임입니다. | IMAGE | 예 | 정확히 하나의 이미지 | -| `model` | 모델 설정 그룹입니다. 사용할 LTX 2.5 모델 변형을 선택합니다. | COMBO | 예 | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | -| `model.duration` | 생성된 비디오의 길이(초)입니다. | INT | 예 | 정수 | -| `model.resolution` | 생성된 비디오의 해상도입니다. 사용 가능한 옵션은 선택한 모델에 따라 다를 수 있습니다. | COMBO | 예 | "1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840" | -| `model.fps` | 생성된 비디오의 프레임 속도입니다. | INT | 예 | 정수 (기본값: 25) | -| `model.generate_audio` | 비디오에 오디오를 생성할지 여부입니다. | BOOLEAN | 예 | True
False | -| `prompt` | 생성할 비디오 내용에 대한 텍스트 설명입니다. 1자에서 10000자 사이여야 합니다. | STRING | 예 | 1자에서 10000자 사이 | -| `seed` | 재현 가능한 생성을 위한 시드 값입니다. 동일한 시드와 동일한 설정을 사용하면 동일한 결과가 생성됩니다. | INT | 예 | 정수 (기본값: 42) | -| `last_frame` | 비디오에 사용할 마지막 프레임입니다. | IMAGE | 아니오 | 정확히 하나의 이미지 | +| `이미지` | 비디오에 사용할 첫 번째 프레임입니다. | IMAGE | 예 | 정확히 하나의 이미지 | +| `모델` | 모델 설정 그룹입니다. 사용할 LTX 2.5 모델 변형을 선택합니다. | COMBO | 예 | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | +| `지속 시간` | 생성된 비디오의 길이(초)입니다. | INT | 예 | 정수 | +| `해상도` | 생성된 비디오의 해상도입니다. 사용 가능한 옵션은 선택한 모델에 따라 다를 수 있습니다. | COMBO | 예 | "1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840" | +| `FPS` | 생성된 비디오의 프레임 속도입니다. | INT | 예 | 정수 (기본값: 25) | +| `오디오 생성` | 비디오에 오디오를 생성할지 여부입니다. | BOOLEAN | 예 | True
False | +| `프롬프트` | 생성할 비디오 내용에 대한 텍스트 설명입니다. 1자에서 10000자 사이여야 합니다. | STRING | 예 | 1자에서 10000자 사이 | +| `시드` | 재현 가능한 생성을 위한 시드 값입니다. 동일한 시드와 동일한 설정을 사용하면 동일한 결과가 생성됩니다. | INT | 예 | 정수 (기본값: 42) | +| `마지막 프레임` | 비디오에 사용할 마지막 프레임입니다. | IMAGE | 아니오 | 정확히 하나의 이미지 | ## 출력 diff --git a/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/pt-BR.md b/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/pt-BR.md index ea4585929..890eb0082 100644 --- a/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/pt-BR.md +++ b/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/pt-BR.md @@ -6,15 +6,15 @@ Este nó gera um vídeo de qualidade profissional com base em uma imagem inicial | Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | |-----------|-------------|-----------|----------|-------| -| `image` | Primeiro quadro a ser usado para o vídeo. | IMAGE | Sim | Exatamente uma imagem | -| `model` | Grupo de configurações do modelo. Seleciona a variante do modelo LTX 2.5 a ser usada. | COMBO | Sim | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | -| `model.duration` | Duração do vídeo gerado em segundos. | INT | Sim | Inteiro | -| `model.resolution` | Resolução do vídeo gerado. As opções disponíveis podem depender do modelo selecionado. | COMBO | Sim | "1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840" | -| `model.fps` | Taxa de quadros do vídeo gerado. | INT | Sim | Inteiro (padrão: 25) | -| `model.generate_audio` | Se deve gerar áudio para o vídeo. | BOOLEAN | Sim | True
False | +| `imagem` | Primeiro quadro a ser usado para o vídeo. | IMAGE | Sim | Exatamente uma imagem | +| `modelo` | Grupo de configurações do modelo. Seleciona a variante do modelo LTX 2.5 a ser usada. | COMBO | Sim | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | +| `duração` | Duração do vídeo gerado em segundos. | INT | Sim | Inteiro | +| `resolução` | Resolução do vídeo gerado. As opções disponíveis podem depender do modelo selecionado. | COMBO | Sim | "1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840" | +| `fps` | Taxa de quadros do vídeo gerado. | INT | Sim | Inteiro (padrão: 25) | +| `gerar_áudio` | Se deve gerar áudio para o vídeo. | BOOLEAN | Sim | True
False | | `prompt` | Descrição textual do conteúdo do vídeo a ser gerado. Deve ter entre 1 e 10000 caracteres. | STRING | Sim | 1 a 10000 caracteres | -| `seed` | Valor da semente para geração reproduzível. Usar a mesma semente com as mesmas configurações produz o mesmo resultado. | INT | Sim | Inteiro (padrão: 42) | -| `last_frame` | Último quadro a ser usado para o vídeo. | IMAGE | Não | Exatamente uma imagem | +| `semente` | Valor da semente para geração reproduzível. Usar a mesma semente com as mesmas configurações produz o mesmo resultado. | INT | Sim | Inteiro (padrão: 42) | +| `último_quadro` | Último quadro a ser usado para o vídeo. | IMAGE | Não | Exatamente uma imagem | ## Saídas diff --git a/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/ru.md b/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/ru.md index 502b0a19e..0e9d30908 100644 --- a/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/ru.md +++ b/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/ru.md @@ -6,15 +6,15 @@ | Параметр | Описание | Тип данных | Обязательный | Диапазон | |-----------|-------------|-----------|----------|-------| -| `image` | Первый кадр для видео. | IMAGE | Да | Ровно одно изображение | -| `model` | Группа настроек модели. Выбирает вариант модели LTX 2.5 для использования. | COMBO | Да | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | -| `model.duration` | Длительность сгенерированного видео в секундах. | INT | Да | Целое число | -| `model.resolution` | Разрешение сгенерированного видео. Доступные варианты могут зависеть от выбранной модели. | COMBO | Да | "1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840" | -| `model.fps` | Частота кадров сгенерированного видео. | INT | Да | Целое число (по умолчанию: 25) | -| `model.generate_audio` | Нужно ли генерировать аудио для видео. | BOOLEAN | Да | True
False | -| `prompt` | Текстовое описание содержимого видео для генерации. Должно содержать от 1 до 10000 символов. | STRING | Да | от 1 до 10000 символов | +| `изображение` | Первый кадр для видео. | IMAGE | Да | Ровно одно изображение | +| `модель` | Группа настроек модели. Выбирает вариант модели LTX 2.5 для использования. | COMBO | Да | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | +| `длительность` | Длительность сгенерированного видео в секундах. | INT | Да | Целое число | +| `разрешение` | Разрешение сгенерированного видео. Доступные варианты могут зависеть от выбранной модели. | COMBO | Да | "1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840" | +| `fps` | Частота кадров сгенерированного видео. | INT | Да | Целое число (по умолчанию: 25) | +| `генерировать аудио` | Нужно ли генерировать аудио для видео. | BOOLEAN | Да | True
False | +| `промпт` | Текстовое описание содержимого видео для генерации. Должно содержать от 1 до 10000 символов. | STRING | Да | от 1 до 10000 символов | | `seed` | Значение сида для воспроизводимой генерации. Использование одного и того же сида с одинаковыми настройками даёт один и тот же результат. | INT | Да | Целое число (по умолчанию: 42) | -| `last_frame` | Последний кадр для видео. | IMAGE | Нет | Ровно одно изображение | +| `последний кадр` | Последний кадр для видео. | IMAGE | Нет | Ровно одно изображение | ## Выходы diff --git a/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/tr.md b/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/tr.md index bc916525a..511b22bb6 100644 --- a/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/tr.md +++ b/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/tr.md @@ -6,15 +6,15 @@ Bu düğüm, bir başlangıç görüntüsüne dayalı olarak profesyonel kalited | Parametre | Açıklama | Veri Türü | Gerekli | Aralık | |-----------|-------------|-----------|----------|-------| -| `image` | Video için kullanılacak ilk kare. | IMAGE | Evet | Tam olarak bir görüntü | +| `görsel` | Video için kullanılacak ilk kare. | IMAGE | Evet | Tam olarak bir görüntü | | `model` | Model ayarları grubu. Kullanılacak LTX 2.5 model çeşidini seçer. | COMBO | Evet | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | -| `model.duration` | Üretilen videonun saniye cinsinden süresi. | INT | Evet | Tam sayı | -| `model.resolution` | Üretilen videonun çözünürlüğü. Kullanılabilir seçenekler seçilen modele bağlı olabilir. | COMBO | Evet | "1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840" | -| `model.fps` | Üretilen videonun kare hızı. | INT | Evet | Tam sayı (varsayılan: 25) | -| `model.generate_audio` | Video için ses üretilip üretilmeyeceği. | BOOLEAN | Evet | True
False | +| `süre` | Üretilen videonun saniye cinsinden süresi. | INT | Evet | Tam sayı | +| `çözünürlük` | Üretilen videonun çözünürlüğü. Kullanılabilir seçenekler seçilen modele bağlı olabilir. | COMBO | Evet | "1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840" | +| `fps` | Üretilen videonun kare hızı. | INT | Evet | Tam sayı (varsayılan: 25) | +| `ses_oluştur` | Video için ses üretilip üretilmeyeceği. | BOOLEAN | Evet | True
False | | `prompt` | Üretilecek video içeriğinin metin açıklaması. 1 ile 10000 karakter arasında olmalıdır. | STRING | Evet | 1 ila 10000 karakter | -| `seed` | Tekrarlanabilir üretim için tohum değeri. Aynı tohumu aynı ayarlarla kullanmak aynı sonucu üretir. | INT | Evet | Tam sayı (varsayılan: 42) | -| `last_frame` | Video için kullanılacak son kare. | IMAGE | Hayır | Tam olarak bir görüntü | +| `tohum` | Tekrarlanabilir üretim için tohum değeri. Aynı tohumu aynı ayarlarla kullanmak aynı sonucu üretir. | INT | Evet | Tam sayı (varsayılan: 42) | +| `son_kare` | Video için kullanılacak son kare. | IMAGE | Hayır | Tam olarak bir görüntü | ## Çıktılar diff --git a/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/zh-TW.md b/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/zh-TW.md index 48381c20b..a78fb3ff6 100644 --- a/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/zh-TW.md +++ b/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/zh-TW.md @@ -6,15 +6,15 @@ | 參數 | 描述 | 資料類型 | 必填 | 範圍 | |-----------|-------------|-----------|----------|-------| -| `image` | 用於影片的第一幀。 | IMAGE | 是 | Exactly one image | -| `model` | 模型設定群組。選擇要使用的 LTX 2.5 模型變體。 | COMBO | 是 | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | -| `model.duration` | 生成影片的長度(以秒為單位)。 | INT | 是 | Integer | -| `model.resolution` | 生成影片的解析度。可用選項可能取決於所選模型。 | COMBO | 是 | "1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840" | -| `model.fps` | 生成影片的幀率。 | INT | 是 | Integer (default: 25) | -| `model.generate_audio` | 是否為影片生成音訊。 | BOOLEAN | 是 | True
False | -| `prompt` | 要生成的影片內容的文字描述。必須介於 1 到 10000 個字元之間。 | STRING | 是 | 1 至 10000 characters | -| `seed` | 用於可重現生成的種子值。使用相同的種子和設定會產生相同的結果。 | INT | 是 | Integer (default: 42) | -| `last_frame` | 用於影片的最終幀。 | IMAGE | 否 | Exactly one image | +| `影像` | 用於影片的第一幀。 | IMAGE | 是 | Exactly one image | +| `模型` | 模型設定群組。選擇要使用的 LTX 2.5 模型變體。 | COMBO | 是 | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | +| `時長` | 生成影片的長度(以秒為單位)。 | INT | 是 | Integer | +| `解析度` | 生成影片的解析度。可用選項可能取決於所選模型。 | COMBO | 是 | "1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840" | +| `幀率` | 生成影片的幀率。 | INT | 是 | Integer (default: 25) | +| `生成音訊` | 是否為影片生成音訊。 | BOOLEAN | 是 | True
False | +| `提示詞` | 要生成的影片內容的文字描述。必須介於 1 到 10000 個字元之間。 | STRING | 是 | 1 至 10000 characters | +| `種子` | 用於可重現生成的種子值。使用相同的種子和設定會產生相同的結果。 | INT | 是 | Integer (default: 42) | +| `最後幀` | 用於影片的最終幀。 | IMAGE | 否 | Exactly one image | ## 輸出 diff --git a/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/zh.md b/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/zh.md index ddb98739c..40f829be3 100644 --- a/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/zh.md +++ b/comfyui_embedded_docs/docs/LtxApi25ImageToVideo/zh.md @@ -5,15 +5,15 @@ ## 输入 | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `image` | 用于视频的第一帧。 | IMAGE | 是 | Exactly one image | -| `model` | 模型设置组。选择要使用的 LTX 2.5 模型变体。 | COMBO | 是 | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | -| `model.duration` | 生成视频的时长(以秒为单位)。 | INT | 是 | Integer | -| `model.resolution` | 生成视频的分辨率。可用选项可能取决于所选的模型。 | COMBO | 是 | "1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840" | -| `model.fps` | 生成视频的帧率。 | INT | 是 | Integer (default: 25) | -| `model.generate_audio` | 是否为视频生成音频。 | BOOLEAN | 是 | True
False | -| `prompt` | 要生成的视频内容的文本描述。长度必须在 1 到 10000 个字符之间。 | STRING | 是 | 1 到 10000 characters | -| `seed` | 用于可重现生成的种子值。使用相同种子和相同设置将产生相同结果。 | INT | 是 | Integer (default: 42) | -| `last_frame` | 用于视频的最后一帧。 | IMAGE | 否 | Exactly one image | +| `图像` | 用于视频的第一帧。 | IMAGE | 是 | Exactly one image | +| `模型` | 模型设置组。选择要使用的 LTX 2.5 模型变体。 | COMBO | 是 | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | +| `时长` | 生成视频的时长(以秒为单位)。 | INT | 是 | Integer | +| `分辨率` | 生成视频的分辨率。可用选项可能取决于所选的模型。 | COMBO | 是 | "1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840" | +| `帧率` | 生成视频的帧率。 | INT | 是 | Integer (default: 25) | +| `生成音频` | 是否为视频生成音频。 | BOOLEAN | 是 | True
False | +| `提示词` | 要生成的视频内容的文本描述。长度必须在 1 到 10000 个字符之间。 | STRING | 是 | 1 到 10000 characters | +| `种子` | 用于可重现生成的种子值。使用相同种子和相同设置将产生相同结果。 | INT | 是 | Integer (default: 42) | +| `末帧` | 用于视频的最后一帧。 | IMAGE | 否 | Exactly one image | ## 输出 | Output Name | Description | Data Type | diff --git a/comfyui_embedded_docs/docs/LtxApi25TextToVideo/ar.md b/comfyui_embedded_docs/docs/LtxApi25TextToVideo/ar.md index b1829c502..fb378ec94 100644 --- a/comfyui_embedded_docs/docs/LtxApi25TextToVideo/ar.md +++ b/comfyui_embedded_docs/docs/LtxApi25TextToVideo/ar.md @@ -6,13 +6,13 @@ LTX 2.5 Text To Video هي وحدة API تولّد فيديوهات بجودة | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `model` | مستوى نموذج LTX 2.5 المستخدم لتوليد الفيديو. | STRING | نعم | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | -| `model.duration` | طول الفيديو المُولَّد. | INT | نعم | عدد صحيح | -| `model.resolution` | دقة إخراج الفيديو. تتوفر الخيارات حسب `model` المحدد. | STRING | نعم | مع "LTX-2.5 (Fast)":
"1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840"
مع "LTX-2.5 (Pro)":
"1280x720"
"720x1280"
"1920x1080"
"1080x1920" | -| `model.fps` | معدل إطارات الفيديو المُولَّد (الافتراضي: 25). | INT | لا | عدد صحيح | -| `model.generate_audio` | ما إذا كان سيتم توليد الصوت مع الفيديو (الافتراضي: True). | BOOLEAN | لا | True
False | -| `prompt` | الوصف النصي للفيديو المراد توليده. يلزم تقديم مطالبة غير فارغة يصل طولها إلى 10,000 حرف (الافتراضي: ""). | STRING | نعم | من 1 إلى 10000 حرف | -| `seed` | قيمة البذرة المستخدمة للتوليد القابل لإعادة الإنتاج (الافتراضي: 42). | INT | لا | عدد صحيح | +| `النموذج` | مستوى نموذج LTX 2.5 المستخدم لتوليد الفيديو. | STRING | نعم | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | +| `المدة` | طول الفيديو المُولَّد. | INT | نعم | عدد صحيح | +| `الدقة` | دقة إخراج الفيديو. تتوفر الخيارات حسب `model` المحدد. | STRING | نعم | مع "LTX-2.5 (Fast)":
"1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840"
مع "LTX-2.5 (Pro)":
"1280x720"
"720x1280"
"1920x1080"
"1080x1920" | +| `معدل الإطارات` | معدل إطارات الفيديو المُولَّد (الافتراضي: 25). | INT | لا | عدد صحيح | +| `توليد الصوت` | ما إذا كان سيتم توليد الصوت مع الفيديو (الافتراضي: True). | BOOLEAN | لا | True
False | +| `المطالبة` | الوصف النصي للفيديو المراد توليده. يلزم تقديم مطالبة غير فارغة يصل طولها إلى 10,000 حرف (الافتراضي: ""). | STRING | نعم | من 1 إلى 10000 حرف | +| `البذرة` | قيمة البذرة المستخدمة للتوليد القابل لإعادة الإنتاج (الافتراضي: 42). | INT | لا | عدد صحيح | ملاحظة: تعتمد خيارات `model.resolution` المتاحة على `model` المحدد. يدعم "LTX-2.5 (Fast)" دقة تصل إلى 2160x3840، بينما يدعم "LTX-2.5 (Pro)" دقة تصل إلى 1920x1080. diff --git a/comfyui_embedded_docs/docs/LtxApi25TextToVideo/en.md b/comfyui_embedded_docs/docs/LtxApi25TextToVideo/en.md index 7ca47c6c9..216df47c7 100644 --- a/comfyui_embedded_docs/docs/LtxApi25TextToVideo/en.md +++ b/comfyui_embedded_docs/docs/LtxApi25TextToVideo/en.md @@ -1,4 +1,4 @@ -# LtxApi25TextToVideo +# LTX 2.5 Text To Video LTX 2.5 Text To Video is an API node that generates professional-quality videos from a text description using the LTX 2.5 model. You provide a prompt and choose generation settings such as the model tier, duration, resolution, frame rate, and whether to include audio; the node submits the task to the LTX API and returns the resulting video. diff --git a/comfyui_embedded_docs/docs/LtxApi25TextToVideo/es.md b/comfyui_embedded_docs/docs/LtxApi25TextToVideo/es.md index 5b921872a..c4370bab5 100644 --- a/comfyui_embedded_docs/docs/LtxApi25TextToVideo/es.md +++ b/comfyui_embedded_docs/docs/LtxApi25TextToVideo/es.md @@ -6,13 +6,13 @@ LTX 2.5 Text To Video es un nodo de API que genera videos de calidad profesional | Parámetro | Descripción | Tipo de datos | Requerido | Rango | |-----------|-------------|---------------|-----------|-------| -| `model` | El nivel del modelo LTX 2.5 que se usará para la generación de video. | STRING | Sí | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | -| `model.duration` | La duración del video generado. | INT | Sí | Entero | -| `model.resolution` | La resolución de salida del video. Las opciones disponibles dependen del `model` seleccionado. | STRING | Sí | Con "LTX-2.5 (Fast)":
"1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840"
Con "LTX-2.5 (Pro)":
"1280x720"
"720x1280"
"1920x1080"
"1080x1920" | -| `model.fps` | Velocidad de fotogramas del video generado (predeterminado: 25). | INT | No | Entero | -| `model.generate_audio` | Indica si se debe generar audio junto con el video (predeterminado: True). | BOOLEAN | No | True
False | +| `modelo` | El nivel del modelo LTX 2.5 que se usará para la generación de video. | STRING | Sí | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | +| `duración` | La duración del video generado. | INT | Sí | Entero | +| `resolución` | La resolución de salida del video. Las opciones disponibles dependen del `model` seleccionado. | STRING | Sí | Con "LTX-2.5 (Fast)":
"1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840"
Con "LTX-2.5 (Pro)":
"1280x720"
"720x1280"
"1920x1080"
"1080x1920" | +| `fps` | Velocidad de fotogramas del video generado (predeterminado: 25). | INT | No | Entero | +| `generar_audio` | Indica si se debe generar audio junto con el video (predeterminado: True). | BOOLEAN | No | True
False | | `prompt` | La descripción textual del video a generar. Se requiere un prompt no vacío de hasta 10,000 caracteres (predeterminado: ""). | STRING | Sí | De 1 a 10000 caracteres | -| `seed` | Valor de semilla utilizado para la generación reproducible (predeterminado: 42). | INT | No | Entero | +| `semilla` | Valor de semilla utilizado para la generación reproducible (predeterminado: 42). | INT | No | Entero | Nota: Las opciones disponibles de `model.resolution` dependen del `model` seleccionado. "LTX-2.5 (Fast)" admite resoluciones de hasta 2160x3840, mientras que "LTX-2.5 (Pro)" admite resoluciones de hasta 1920x1080. diff --git a/comfyui_embedded_docs/docs/LtxApi25TextToVideo/fa.md b/comfyui_embedded_docs/docs/LtxApi25TextToVideo/fa.md index 3988ef097..f665f8d84 100644 --- a/comfyui_embedded_docs/docs/LtxApi25TextToVideo/fa.md +++ b/comfyui_embedded_docs/docs/LtxApi25TextToVideo/fa.md @@ -4,13 +4,13 @@ | پارامتر | توضیحات | نوع داده | الزامی | محدوده | |-----------|-------------|-----------|----------|-------| -| `model` | سطح مدل LTX 2.5 که برای تولید ویدیو استفاده می‌شود. | STRING | بله | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | -| `model.duration` | مدت‌زمان ویدیوی تولیدشده. | INT | بله | Integer | -| `model.resolution` | وضوح خروجی ویدیو. گزینه‌های موجود به `model` انتخاب‌شده بستگی دارند. | STRING | بله | در حالت "LTX-2.5 (Fast)":
"1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840"
در حالت "LTX-2.5 (Pro)":
"1280x720"
"720x1280"
"1920x1080"
"1080x1920" | -| `model.fps` | نرخ فریم ویدیوی تولیدشده (پیش‌فرض: 25). | INT | خیر | Integer | -| `model.generate_audio` | مشخص می‌کند که صدا همراه با ویدیو تولید شود یا نه (پیش‌فرض: True). | BOOLEAN | خیر | True
False | -| `prompt` | توصیف متنی ویدیویی که باید تولید شود. یک prompt غیرخالی با حداکثر ۱۰,۰۰۰ کاراکتر الزامی است (پیش‌فرض: ""). | STRING | بله | از 1 تا 10000 کاراکتر | -| `seed` | مقدار seed که برای تولید قابل تکرار استفاده می‌شود (پیش‌فرض: 42). | INT | خیر | Integer | +| `مدل` | سطح مدل LTX 2.5 که برای تولید ویدیو استفاده می‌شود. | STRING | بله | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | +| `مدت زمان` | مدت‌زمان ویدیوی تولیدشده. | INT | بله | Integer | +| `رزولوشن` | وضوح خروجی ویدیو. گزینه‌های موجود به `model` انتخاب‌شده بستگی دارند. | STRING | بله | در حالت "LTX-2.5 (Fast)":
"1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840"
در حالت "LTX-2.5 (Pro)":
"1280x720"
"720x1280"
"1920x1080"
"1080x1920" | +| `فریم بر ثانیه` | نرخ فریم ویدیوی تولیدشده (پیش‌فرض: 25). | INT | خیر | Integer | +| `تولید صوت` | مشخص می‌کند که صدا همراه با ویدیو تولید شود یا نه (پیش‌فرض: True). | BOOLEAN | خیر | True
False | +| `پرامپت` | توصیف متنی ویدیویی که باید تولید شود. یک prompt غیرخالی با حداکثر ۱۰,۰۰۰ کاراکتر الزامی است (پیش‌فرض: ""). | STRING | بله | از 1 تا 10000 کاراکتر | +| `بذر` | مقدار seed که برای تولید قابل تکرار استفاده می‌شود (پیش‌فرض: 42). | INT | خیر | Integer | توجه: گزینه‌های موجود برای `model.resolution` به `model` انتخاب‌شده بستگی دارند. «LTX-2.5 (Fast)» از وضوح‌های تا 2160x3840 پشتیبانی می‌کند، در حالی که «LTX-2.5 (Pro)» از وضوح‌های تا 1920x1080 پشتیبانی می‌کند. diff --git a/comfyui_embedded_docs/docs/LtxApi25TextToVideo/fr.md b/comfyui_embedded_docs/docs/LtxApi25TextToVideo/fr.md index d8cd4ea8f..e4fe9b074 100644 --- a/comfyui_embedded_docs/docs/LtxApi25TextToVideo/fr.md +++ b/comfyui_embedded_docs/docs/LtxApi25TextToVideo/fr.md @@ -6,11 +6,11 @@ LTX 2.5 Text To Video est un nœud API qui génère des vidéos de qualité prof | Paramètre | Description | Type de données | Requis | Plage | |-----------|-------------|-----------------|--------|-------| -| `model` | Le niveau du modèle LTX 2.5 à utiliser pour la génération de vidéos. | STRING | Oui | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | -| `model.duration` | La durée de la vidéo générée. | INT | Oui | Entier | -| `model.resolution` | La résolution de sortie de la vidéo. Les options disponibles dépendent du `model` sélectionné. | STRING | Oui | Avec "LTX-2.5 (Fast)" :
"1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840"
Avec "LTX-2.5 (Pro)" :
"1280x720"
"720x1280"
"1920x1080"
"1080x1920" | -| `model.fps` | Nombre d'images par seconde (FPS) de la vidéo générée (par défaut : 25). | INT | Non | Entier | -| `model.generate_audio` | Indique si l'audio doit être généré avec la vidéo (par défaut : True). | BOOLEAN | Non | True
False | +| `modèle` | Le niveau du modèle LTX 2.5 à utiliser pour la génération de vidéos. | STRING | Oui | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | +| `durée` | La durée de la vidéo générée. | INT | Oui | Entier | +| `résolution` | La résolution de sortie de la vidéo. Les options disponibles dépendent du `model` sélectionné. | STRING | Oui | Avec "LTX-2.5 (Fast)" :
"1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840"
Avec "LTX-2.5 (Pro)" :
"1280x720"
"720x1280"
"1920x1080"
"1080x1920" | +| `fps` | Nombre d'images par seconde (FPS) de la vidéo générée (par défaut : 25). | INT | Non | Entier | +| `générer_audio` | Indique si l'audio doit être généré avec la vidéo (par défaut : True). | BOOLEAN | Non | True
False | | `prompt` | La description textuelle de la vidéo à générer. Une invite non vide de 10 000 caractères maximum est requise (par défaut : ""). | STRING | Oui | 1 à 10000 caractères | | `seed` | Valeur de graine utilisée pour une génération reproductible (par défaut : 42). | INT | Non | Entier | diff --git a/comfyui_embedded_docs/docs/LtxApi25TextToVideo/ja.md b/comfyui_embedded_docs/docs/LtxApi25TextToVideo/ja.md index e008ce21f..4957b77e3 100644 --- a/comfyui_embedded_docs/docs/LtxApi25TextToVideo/ja.md +++ b/comfyui_embedded_docs/docs/LtxApi25TextToVideo/ja.md @@ -6,13 +6,13 @@ LTX 2.5 Text To Video は、LTX 2.5 モデルを使用してテキスト記述 | パラメータ | 説明 | データ型 | 必須 | 範囲 | |-----------|-------------|-----------|----------|-------| -| `model` | ビデオ生成に使用する LTX 2.5 モデルのティアです。 | STRING | はい | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | -| `model.duration` | 生成されるビデオの長さです。 | INT | はい | 整数 | -| `model.resolution` | ビデオの出力解像度です。利用可能なオプションは選択した `model` によって異なります。 | STRING | はい | "LTX-2.5 (Fast)" の場合:
"1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840"
"LTX-2.5 (Pro)" の場合:
"1280x720"
"720x1280"
"1920x1080"
"1080x1920" | -| `model.fps` | 生成されるビデオのフレームレートです(デフォルト:25)。 | INT | いいえ | 整数 | -| `model.generate_audio` | ビデオと一緒にオーディオを生成するかどうかです(デフォルト:True)。 | BOOLEAN | いいえ | True
False | -| `prompt` | 生成するビデオのテキストによる説明です。10,000文字以内の空でないプロンプトが必要です(デフォルト:"")。 | STRING | はい | 1〜10000文字 | -| `seed` | 再現性のある生成に使用されるシード値です(デフォルト:42)。 | INT | いいえ | 整数 | +| `モデル` | ビデオ生成に使用する LTX 2.5 モデルのティアです。 | STRING | はい | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | +| `長さ` | 生成されるビデオの長さです。 | INT | はい | 整数 | +| `解像度` | ビデオの出力解像度です。利用可能なオプションは選択した `model` によって異なります。 | STRING | はい | "LTX-2.5 (Fast)" の場合:
"1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840"
"LTX-2.5 (Pro)" の場合:
"1280x720"
"720x1280"
"1920x1080"
"1080x1920" | +| `fps` | 生成されるビデオのフレームレートです(デフォルト:25)。 | INT | いいえ | 整数 | +| `オーディオ生成` | ビデオと一緒にオーディオを生成するかどうかです(デフォルト:True)。 | BOOLEAN | いいえ | True
False | +| `プロンプト` | 生成するビデオのテキストによる説明です。10,000文字以内の空でないプロンプトが必要です(デフォルト:"")。 | STRING | はい | 1〜10000文字 | +| `シード` | 再現性のある生成に使用されるシード値です(デフォルト:42)。 | INT | いいえ | 整数 | 注:利用可能な `model.resolution` オプションは選択した `model` によって異なります。"LTX-2.5 (Fast)" は 2160x3840 までの解像度をサポートし、"LTX-2.5 (Pro)" は 1920x1080 までの解像度をサポートしています。 diff --git a/comfyui_embedded_docs/docs/LtxApi25TextToVideo/ko.md b/comfyui_embedded_docs/docs/LtxApi25TextToVideo/ko.md index 11f4e64e6..7a0f27091 100644 --- a/comfyui_embedded_docs/docs/LtxApi25TextToVideo/ko.md +++ b/comfyui_embedded_docs/docs/LtxApi25TextToVideo/ko.md @@ -6,13 +6,13 @@ LTX 2.5 Text To Video는 LTX 2.5 모델을 사용하여 텍스트 설명에서 | 매개변수 | 설명 | 데이터 유형 | 필수 | 범위 | |-----------|-------------|-----------|----------|-------| -| `model` | 비디오 생성에 사용할 LTX 2.5 모델 등급입니다. | STRING | 예 | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | -| `model.duration` | 생성된 비디오의 길이입니다. | INT | 예 | 정수 | -| `model.resolution` | 비디오의 출력 해상도입니다. 사용 가능한 옵션은 선택한 `model`에 따라 달라집니다. | STRING | 예 | "LTX-2.5 (Fast)" 선택 시:
"1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840"
"LTX-2.5 (Pro)" 선택 시:
"1280x720"
"720x1280"
"1920x1080"
"1080x1920" | -| `model.fps` | 생성된 비디오의 프레임 속도입니다 (기본값: 25). | INT | 아니요 | 정수 | -| `model.generate_audio` | 비디오와 함께 오디오를 생성할지 여부입니다 (기본값: True). | BOOLEAN | 아니요 | True
False | -| `prompt` | 생성할 비디오에 대한 텍스트 설명입니다. 최대 10,000자의 비어 있지 않은 프롬프트가 필요합니다 (기본값: ""). | STRING | 예 | 1~10000자 | -| `seed` | 재현 가능한 생성을 위해 사용되는 시드 값입니다 (기본값: 42). | INT | 아니요 | 정수 | +| `모델` | 비디오 생성에 사용할 LTX 2.5 모델 등급입니다. | STRING | 예 | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | +| `지속 시간` | 생성된 비디오의 길이입니다. | INT | 예 | 정수 | +| `해상도` | 비디오의 출력 해상도입니다. 사용 가능한 옵션은 선택한 `model`에 따라 달라집니다. | STRING | 예 | "LTX-2.5 (Fast)" 선택 시:
"1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840"
"LTX-2.5 (Pro)" 선택 시:
"1280x720"
"720x1280"
"1920x1080"
"1080x1920" | +| `FPS` | 생성된 비디오의 프레임 속도입니다 (기본값: 25). | INT | 아니요 | 정수 | +| `오디오 생성` | 비디오와 함께 오디오를 생성할지 여부입니다 (기본값: True). | BOOLEAN | 아니요 | True
False | +| `프롬프트` | 생성할 비디오에 대한 텍스트 설명입니다. 최대 10,000자의 비어 있지 않은 프롬프트가 필요합니다 (기본값: ""). | STRING | 예 | 1~10000자 | +| `시드` | 재현 가능한 생성을 위해 사용되는 시드 값입니다 (기본값: 42). | INT | 아니요 | 정수 | 참고: 사용 가능한 `model.resolution` 옵션은 선택한 `model`에 따라 달라집니다. "LTX-2.5 (Fast)"는 최대 2160x3840 해상도를 지원하며, "LTX-2.5 (Pro)"는 최대 1920x1080 해상도를 지원합니다. diff --git a/comfyui_embedded_docs/docs/LtxApi25TextToVideo/pt-BR.md b/comfyui_embedded_docs/docs/LtxApi25TextToVideo/pt-BR.md index da1694190..92454ce9d 100644 --- a/comfyui_embedded_docs/docs/LtxApi25TextToVideo/pt-BR.md +++ b/comfyui_embedded_docs/docs/LtxApi25TextToVideo/pt-BR.md @@ -6,13 +6,13 @@ LTX 2.5 Text To Video é um nó de API que gera vídeos de qualidade profissiona | Parâmetro | Descrição | Tipo de Dado | Obrigatório | Intervalo | |-----------|-------------|--------------|-------------|-----------| -| `model` | O nível do modelo LTX 2.5 a ser usado para a geração de vídeo. | STRING | Sim | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | -| `model.duration` | A duração do vídeo gerado. | INT | Sim | Inteiro | -| `model.resolution` | A resolução de saída do vídeo. As opções disponíveis dependem do `model` selecionado. | STRING | Sim | Com "LTX-2.5 (Fast)":
"1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840"
Com "LTX-2.5 (Pro)":
"1280x720"
"720x1280"
"1920x1080"
"1080x1920" | -| `model.fps` | Taxa de quadros do vídeo gerado (padrão: 25). | INT | Não | Inteiro | -| `model.generate_audio` | Se deve gerar áudio junto com o vídeo (padrão: True). | BOOLEAN | Não | True
False | +| `modelo` | O nível do modelo LTX 2.5 a ser usado para a geração de vídeo. | STRING | Sim | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | +| `duração` | A duração do vídeo gerado. | INT | Sim | Inteiro | +| `resolução` | A resolução de saída do vídeo. As opções disponíveis dependem do `model` selecionado. | STRING | Sim | Com "LTX-2.5 (Fast)":
"1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840"
Com "LTX-2.5 (Pro)":
"1280x720"
"720x1280"
"1920x1080"
"1080x1920" | +| `fps` | Taxa de quadros do vídeo gerado (padrão: 25). | INT | Não | Inteiro | +| `gerar_áudio` | Se deve gerar áudio junto com o vídeo (padrão: True). | BOOLEAN | Não | True
False | | `prompt` | A descrição textual do vídeo a ser gerado. É necessário um prompt não vazio de até 10.000 caracteres (padrão: ""). | STRING | Sim | 1 a 10.000 caracteres | -| `seed` | Valor da semente usado para geração reproduzível (padrão: 42). | INT | Não | Inteiro | +| `semente` | Valor da semente usado para geração reproduzível (padrão: 42). | INT | Não | Inteiro | Nota: As opções disponíveis de `model.resolution` dependem do `model` selecionado. "LTX-2.5 (Fast)" suporta resoluções de até 2160x3840, enquanto "LTX-2.5 (Pro)" suporta resoluções de até 1920x1080. diff --git a/comfyui_embedded_docs/docs/LtxApi25TextToVideo/tr.md b/comfyui_embedded_docs/docs/LtxApi25TextToVideo/tr.md index 70e123a93..ed3216b5b 100644 --- a/comfyui_embedded_docs/docs/LtxApi25TextToVideo/tr.md +++ b/comfyui_embedded_docs/docs/LtxApi25TextToVideo/tr.md @@ -7,12 +7,12 @@ LTX 2.5 Text To Video, LTX 2.5 modelini kullanarak metin açıklamasından profe | Parametre | Açıklama | Veri Türü | Zorunlu | Aralık | |-----------|-------------|-----------|----------|-------| | `model` | Video üretimi için kullanılacak LTX 2.5 model kademesi. | STRING | Evet | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | -| `model.duration` | Oluşturulan videonun uzunluğu. | INT | Evet | Integer | -| `model.resolution` | Videonun çıktı çözünürlüğü. Kullanılabilir seçenekler seçilen `model`e bağlıdır. | STRING | Evet | With "LTX-2.5 (Fast)":
"1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840"
With "LTX-2.5 (Pro)":
"1280x720"
"720x1280"
"1920x1080"
"1080x1920" | -| `model.fps` | Oluşturulan videonun kare hızı (varsayılan: 25). | INT | Hayır | Integer | -| `model.generate_audio` | Video ile birlikte ses üretilip üretilmeyeceği (varsayılan: True). | BOOLEAN | Hayır | True
False | +| `süre` | Oluşturulan videonun uzunluğu. | INT | Evet | Integer | +| `çözünürlük` | Videonun çıktı çözünürlüğü. Kullanılabilir seçenekler seçilen `model`e bağlıdır. | STRING | Evet | With "LTX-2.5 (Fast)":
"1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840"
With "LTX-2.5 (Pro)":
"1280x720"
"720x1280"
"1920x1080"
"1080x1920" | +| `fps` | Oluşturulan videonun kare hızı (varsayılan: 25). | INT | Hayır | Integer | +| `ses_oluştur` | Video ile birlikte ses üretilip üretilmeyeceği (varsayılan: True). | BOOLEAN | Hayır | True
False | | `prompt` | Oluşturulacak videonun metin açıklaması. En fazla 10.000 karakterden oluşan boş olmayan bir istem gereklidir (varsayılan: ""). | STRING | Evet | 1 ile 10000 arası characters | -| `seed` | Tekrarlanabilir üretim için kullanılan tohum değeri (varsayılan: 42). | INT | Hayır | Integer | +| `tohum` | Tekrarlanabilir üretim için kullanılan tohum değeri (varsayılan: 42). | INT | Hayır | Integer | Not: Kullanılabilir `model.resolution` seçenekleri seçilen `model`e bağlıdır. "LTX-2.5 (Fast)" 2160x3840'a kadar çözünürlükleri desteklerken, "LTX-2.5 (Pro)" 1920x1080'e kadar çözünürlükleri destekler. diff --git a/comfyui_embedded_docs/docs/LtxApi25TextToVideo/zh-TW.md b/comfyui_embedded_docs/docs/LtxApi25TextToVideo/zh-TW.md index 7df98582b..1dffb9747 100644 --- a/comfyui_embedded_docs/docs/LtxApi25TextToVideo/zh-TW.md +++ b/comfyui_embedded_docs/docs/LtxApi25TextToVideo/zh-TW.md @@ -5,13 +5,13 @@ LTX 2.5 Text To Video 是一個 API 節點,使用 LTX 2.5 模型從文字描 ## 輸入 | 參數 | 描述 | 資料類型 | 必要 | 範圍 | |-----------|-------------|-----------|----------|-------| -| `model` | 用於影片產生的 LTX 2.5 模型等級。 | STRING | 是 | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | -| `model.duration` | 產生的影片長度。 | INT | 是 | Integer | -| `model.resolution` | 影片的輸出解析度。可用的選項取決於所選的 `model`。 | STRING | 是 | With "LTX-2.5 (Fast)":
"1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840"
With "LTX-2.5 (Pro)":
"1280x720"
"720x1280"
"1920x1080"
"1080x1920" | -| `model.fps` | 產生的影片的幀率(預設:25)。 | INT | 否 | Integer | -| `model.generate_audio` | 是否在產生影片時同時產生音訊(預設:True)。 | BOOLEAN | 否 | True
False | -| `prompt` | 要產生的影片的文字描述。需要非空白的提示詞,最多 10,000 個字元(預設:"")。 | STRING | 是 | 1 至 10000 characters | -| `seed` | 用於可重現生成的種子值(預設:42)。 | INT | 否 | Integer | +| `模型` | 用於影片產生的 LTX 2.5 模型等級。 | STRING | 是 | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | +| `時長` | 產生的影片長度。 | INT | 是 | Integer | +| `解析度` | 影片的輸出解析度。可用的選項取決於所選的 `model`。 | STRING | 是 | With "LTX-2.5 (Fast)":
"1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840"
With "LTX-2.5 (Pro)":
"1280x720"
"720x1280"
"1920x1080"
"1080x1920" | +| `幀率` | 產生的影片的幀率(預設:25)。 | INT | 否 | Integer | +| `生成音訊` | 是否在產生影片時同時產生音訊(預設:True)。 | BOOLEAN | 否 | True
False | +| `提示詞` | 要產生的影片的文字描述。需要非空白的提示詞,最多 10,000 個字元(預設:"")。 | STRING | 是 | 1 至 10000 characters | +| `種子` | 用於可重現生成的種子值(預設:42)。 | INT | 否 | Integer | 注意:可用的 `model.resolution` 選項取決於所選的 `model`。"LTX-2.5 (Fast)" 支援最高 2160x3840 的解析度,而 "LTX-2.5 (Pro)" 支援最高 1920x1080 的解析度。 diff --git a/comfyui_embedded_docs/docs/LtxApi25TextToVideo/zh.md b/comfyui_embedded_docs/docs/LtxApi25TextToVideo/zh.md index 4776d4a5b..9066da6ca 100644 --- a/comfyui_embedded_docs/docs/LtxApi25TextToVideo/zh.md +++ b/comfyui_embedded_docs/docs/LtxApi25TextToVideo/zh.md @@ -6,13 +6,13 @@ LTX 2.5 Text To Video 是一个 API 节点,使用 LTX 2.5 模型根据文本 | 参数 | 描述 | 数据类型 | 必填 | 范围 | |-----------|-------------|-----------|----------|-------| -| `model` | 用于视频生成的 LTX 2.5 模型级别。 | STRING | 是 | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | -| `model.duration` | 生成的视频时长。 | INT | 是 | Integer | -| `model.resolution` | 视频的输出分辨率。可用选项取决于所选的 `model`。 | STRING | 是 | 当选择 "LTX-2.5 (Fast)" 时:
"1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840"
当选择 "LTX-2.5 (Pro)" 时:
"1280x720"
"720x1280"
"1920x1080"
"1080x1920" | -| `model.fps` | 生成视频的帧率(默认值:25)。 | INT | 否 | Integer | -| `model.generate_audio` | 是否随视频一起生成音频(默认值:True)。 | BOOLEAN | 否 | True
False | -| `prompt` | 要生成的视频的文本描述。需要非空提示词,最多 10,000 个字符(默认值:"")。 | STRING | 是 | 1 到 10000 characters | -| `seed` | 用于可复现生成的种子值(默认值:42)。 | INT | 否 | Integer | +| `模型` | 用于视频生成的 LTX 2.5 模型级别。 | STRING | 是 | "LTX-2.5 (Fast)"
"LTX-2.5 (Pro)" | +| `时长` | 生成的视频时长。 | INT | 是 | Integer | +| `分辨率` | 视频的输出分辨率。可用选项取决于所选的 `model`。 | STRING | 是 | 当选择 "LTX-2.5 (Fast)" 时:
"1280x720"
"720x1280"
"1920x1080"
"1080x1920"
"2560x1440"
"1440x2560"
"3840x2160"
"2160x3840"
当选择 "LTX-2.5 (Pro)" 时:
"1280x720"
"720x1280"
"1920x1080"
"1080x1920" | +| `帧率` | 生成视频的帧率(默认值:25)。 | INT | 否 | Integer | +| `生成音频` | 是否随视频一起生成音频(默认值:True)。 | BOOLEAN | 否 | True
False | +| `提示词` | 要生成的视频的文本描述。需要非空提示词,最多 10,000 个字符(默认值:"")。 | STRING | 是 | 1 到 10000 characters | +| `种子` | 用于可复现生成的种子值(默认值:42)。 | INT | 否 | Integer | 注意:可用的 `model.resolution` 选项取决于所选的 `model`。"LTX-2.5 (Fast)" 支持最高 2160x3840 的分辨率,而 "LTX-2.5 (Pro)" 支持最高 1920x1080 的分辨率。 diff --git a/comfyui_embedded_docs/docs/LtxvApiImageToVideo/en.md b/comfyui_embedded_docs/docs/LtxvApiImageToVideo/en.md index 0447b0e0a..c79fae747 100644 --- a/comfyui_embedded_docs/docs/LtxvApiImageToVideo/en.md +++ b/comfyui_embedded_docs/docs/LtxvApiImageToVideo/en.md @@ -8,7 +8,7 @@ The LTXV Image To Video node generates a professional-quality video from a singl | --- | --- | --- | --- | --- | | `image` | First frame to be used for the video. | IMAGE | Yes | - | | `model` | The AI model to use for video generation. The "Pro" model is optimized for quality, while the "Fast" model is optimized for speed. | COMBO | Yes | `"LTX-2 (Pro)"`
`"LTX-2 (Fast)"` | -| `prompt` | A text description that guides the content and motion of the generated video. | STRING | Yes | - | +| `prompt` | A text description that guides the content and motion of the generated video (default: empty). | STRING | Yes | - | | `duration` | The length of the video in seconds (default: 8). | COMBO | Yes | `6`
`8`
`10`
`12`
`14`
`16`
`18`
`20` | | `resolution` | The output resolution of the generated video. | COMBO | Yes | `"1920x1080"`
`"2560x1440"`
`"3840x2160"` | | `fps` | The frames per second for the video (default: 25). | COMBO | Yes | `25`
`50` | @@ -20,6 +20,8 @@ The LTXV Image To Video node generates a professional-quality video from a singl * The `prompt` must be between 1 and 10,000 characters long. * If you select a `duration` longer than 10 seconds, you must use the **"LTX-2 (Fast)"** model, a **"1920x1080"** resolution, and **25** FPS. This combination is required for longer videos. +**Note:** This node is marked as deprecated. + ## Outputs | Output Name | Description | Data Type | @@ -29,4 +31,4 @@ The LTXV Image To Video node generates a professional-quality video from a singl > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LtxvApiImageToVideo/en.md) --- -**Source fingerprint (SHA-256):** `5c62025059cc0c583de3e0ae8721b8f8adb6929bb03cbcec5875bbc1fdaf20c3` +**Source fingerprint (SHA-256):** `fa3928262e59105718b6ed97ddc8d2801e540b6b0c142541d92525dd75540cc7` diff --git a/comfyui_embedded_docs/docs/LtxvApiTextToVideo/en.md b/comfyui_embedded_docs/docs/LtxvApiTextToVideo/en.md index 9f6224367..66a13b11f 100644 --- a/comfyui_embedded_docs/docs/LtxvApiTextToVideo/en.md +++ b/comfyui_embedded_docs/docs/LtxvApiTextToVideo/en.md @@ -7,17 +7,19 @@ The LTXV Text To Video node generates professional-quality videos from a text de | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | | `model` | The AI model to use for video generation. "LTX-2 (Pro)" offers higher quality, while "LTX-2 (Fast)" is optimized for speed. | COMBO | Yes | `"LTX-2 (Pro)"`
`"LTX-2 (Fast)"` | -| `prompt` | The text description that the AI will use to generate the video. This field supports multiple lines of text. | STRING | Yes | - | +| `prompt` | The text description that the AI will use to generate the video. This field supports multiple lines of text and must contain 1 to 10,000 characters. | STRING | Yes | - | | `duration` | The length of the generated video in seconds (default: 8). | COMBO | Yes | `6`
`8`
`10`
`12`
`14`
`16`
`18`
`20` | | `resolution` | The pixel dimensions (width x height) of the output video. | COMBO | Yes | `"1920x1080"`
`"2560x1440"`
`"3840x2160"` | | `fps` | The frames per second for the video (default: 25). | COMBO | Yes | `25`
`50` | -| `generate_audio` | When enabled, the generated video will include AI-generated audio matching the scene (default: False). | BOOLEAN | No | - | +| `generate_audio` | When true, the generated video will include AI-generated audio matching the scene (default: False). This is an advanced optional setting. | BOOLEAN | No | - | **Important Constraints:** * The `prompt` must be between 1 and 10,000 characters long. * If you select a `duration` greater than 10 seconds, you must also use the `"LTX-2 (Fast)"` model, a resolution of `"1920x1080"`, and an `fps` of `25`. This combination is required for longer videos. +**Note:** This node is deprecated. + ## Outputs | Output Name | Description | Data Type | @@ -27,4 +29,4 @@ The LTXV Text To Video node generates professional-quality videos from a text de > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LtxvApiTextToVideo/en.md) --- -**Source fingerprint (SHA-256):** `11e358bdf9ff9b799b428768c10504f450d81d12f81b2ec0749f9d2d88e82f91` +**Source fingerprint (SHA-256):** `8cf7409e46bb92abdff8a12e0d4ab49d67bb70e66c0c9074c9af99d1cf250df8` diff --git a/comfyui_embedded_docs/docs/LumaImageEditNode2/ar.md b/comfyui_embedded_docs/docs/LumaImageEditNode2/ar.md index d9de7e3ca..a737e64d7 100644 --- a/comfyui_embedded_docs/docs/LumaImageEditNode2/ar.md +++ b/comfyui_embedded_docs/docs/LumaImageEditNode2/ar.md @@ -7,10 +7,10 @@ | المعامل | الوصف | نوع البيانات | إلزامي | النطاق | |---|---|---|---|---| -| `model` | النموذج المستخدم للتعديل. يؤدي تحديد نموذج إلى إظهار الخيارات الخاصة به أدناه. | DYNAMIC_COMBO | نعم | `"uni-1"`
`"uni-1-max"` | -| `source` | الصورة المصدر المراد تعديلها. | IMAGE | نعم | - | -| `prompt` | وصف التعديل المطلوب. من 1 إلى 6000 حرف. الافتراضي: "" (سلسلة فارغة؛ يظل الطلب غير صالح حتى يتم إدخال حرف واحد على الأقل). | STRING | نعم | 1 to 6000 characters | -| `seed` | تتحكم seed في ما إذا كان ينبغي إعادة تشغيل العقدة؛ النتائج غير حتمية بغض النظر عن قيمة seed. الافتراضي: 0. | INT | نعم | 0 to 2147483647 | +| `النموذج` | النموذج المستخدم للتعديل. يؤدي تحديد نموذج إلى إظهار الخيارات الخاصة به أدناه. | DYNAMIC_COMBO | نعم | `"uni-1"`
`"uni-1-max"` | +| `المصدر` | الصورة المصدر المراد تعديلها. | IMAGE | نعم | - | +| `المطالبة` | وصف التعديل المطلوب. من 1 إلى 6000 حرف. الافتراضي: "" (سلسلة فارغة؛ يظل الطلب غير صالح حتى يتم إدخال حرف واحد على الأقل). | STRING | نعم | 1 to 6000 characters | +| `البذرة` | تتحكم seed في ما إذا كان ينبغي إعادة تشغيل العقدة؛ النتائج غير حتمية بغض النظر عن قيمة seed. الافتراضي: 0. | INT | نعم | 0 to 2147483647 | ### مدخلات uni-1 وuni-1-max diff --git a/comfyui_embedded_docs/docs/LumaImageEditNode2/fr.md b/comfyui_embedded_docs/docs/LumaImageEditNode2/fr.md index d13d5b640..63fc18e81 100644 --- a/comfyui_embedded_docs/docs/LumaImageEditNode2/fr.md +++ b/comfyui_embedded_docs/docs/LumaImageEditNode2/fr.md @@ -8,10 +8,10 @@ Ce nœud modifie une image existante à l'aide d'une invite texte, propulsé par | Paramètre | Description | Type de données | Requis | Plage | |-----------|-------------|-----------------|--------|-------| -| `model` | Modèle à utiliser pour l'édition. La sélection d'un modèle révèle les options spécifiques au modèle ci-dessous. | DYNAMIC_COMBO | Oui | `"uni-1"`
`"uni-1-max"` | +| `modèle` | Modèle à utiliser pour l'édition. La sélection d'un modèle révèle les options spécifiques au modèle ci-dessous. | DYNAMIC_COMBO | Oui | `"uni-1"`
`"uni-1-max"` | | `source` | Image source à modifier. | IMAGE | Oui | - | -| `prompt` | Description de la modification souhaitée. 1 à 6000 caractères. Par défaut : "" (chaîne vide ; la requête est invalide tant qu'au moins un caractère n'est pas saisi). | STRING | Oui | 1 à 6000 caractères | -| `seed` | Le seed contrôle si le nœud doit être réexécuté ; les résultats sont non déterministes quel que soit le seed. Par défaut : 0. | INT | Oui | 0 à 2147483647 | +| `invite` | Description de la modification souhaitée. 1 à 6000 caractères. Par défaut : "" (chaîne vide ; la requête est invalide tant qu'au moins un caractère n'est pas saisi). | STRING | Oui | 1 à 6000 caractères | +| `graine` | Le seed contrôle si le nœud doit être réexécuté ; les résultats sont non déterministes quel que soit le seed. Par défaut : 0. | INT | Oui | 0 à 2147483647 | ### Entrées uni-1 et uni-1-max diff --git a/comfyui_embedded_docs/docs/LumaImageEditNode2/zh-TW.md b/comfyui_embedded_docs/docs/LumaImageEditNode2/zh-TW.md index 94b3b473b..b9d419bb0 100644 --- a/comfyui_embedded_docs/docs/LumaImageEditNode2/zh-TW.md +++ b/comfyui_embedded_docs/docs/LumaImageEditNode2/zh-TW.md @@ -8,10 +8,10 @@ | 參數 | 說明 | 資料類型 | 必填 | 範圍 | |-----------|-------------|-----------|----------|-------| -| `model` | 要用於編輯的模型。選取模型後,下方會顯示模型專屬選項。 | DYNAMIC_COMBO | 是 | `"uni-1"`
`"uni-1-max"` | -| `source` | 要編輯的來源影像。 | IMAGE | 是 | - | -| `prompt` | 描述所需的編輯內容。1–6000 字元。預設值:""(空字串;在輸入至少一個字元前,請求無效)。 | STRING | 是 | 1 至 6000 字元 | -| `seed` | 種子控制節點是否應重新執行;無論種子為何,結果皆非確定性。預設值:0。 | INT | 是 | 0 至 2147483647 | +| `模型` | 要用於編輯的模型。選取模型後,下方會顯示模型專屬選項。 | DYNAMIC_COMBO | 是 | `"uni-1"`
`"uni-1-max"` | +| `來源` | 要編輯的來源影像。 | IMAGE | 是 | - | +| `提示` | 描述所需的編輯內容。1–6000 字元。預設值:""(空字串;在輸入至少一個字元前,請求無效)。 | STRING | 是 | 1 至 6000 字元 | +| `種子` | 種子控制節點是否應重新執行;無論種子為何,結果皆非確定性。預設值:0。 | INT | 是 | 0 至 2147483647 | ### uni-1 與 uni-1-max 輸入 diff --git a/comfyui_embedded_docs/docs/LumaImageNode2/en.md b/comfyui_embedded_docs/docs/LumaImageNode2/en.md index bb33e3121..9dfb0cc49 100644 --- a/comfyui_embedded_docs/docs/LumaImageNode2/en.md +++ b/comfyui_embedded_docs/docs/LumaImageNode2/en.md @@ -1,7 +1,5 @@ # Luma UNI-1 Image -## Overview - This node generates images from text descriptions using the Luma UNI-1 model. It takes a text prompt and optional settings like aspect ratio and style, then sends the request to the Luma API to create an image. Two model variants are available: `uni-1` and `uni-1-max`. ## Inputs @@ -11,7 +9,7 @@ This node generates images from text descriptions using the Luma UNI-1 model. It | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | | `model` | Model to use for generation. Selecting a model reveals additional settings for that model. | DYNAMIC_COMBO | Yes | `"uni-1"`
`"uni-1-max"` | -| `prompt` | Text description of the desired image. 1–6000 characters. | STRING | Yes | 1 to 6000 characters | +| `prompt` | Text description of the desired image. 1–6000 characters. (default: "") | STRING | Yes | 1 to 6000 characters | | `seed` | Seed controls whether the node should re-run; results are non-deterministic regardless of seed. (default: 0) | INT | Yes | 0 to 2147483647 | ### uni-1 and uni-1-max Inputs diff --git a/comfyui_embedded_docs/docs/LumaImageNode2/fr.md b/comfyui_embedded_docs/docs/LumaImageNode2/fr.md index 627240701..44b3fdb63 100644 --- a/comfyui_embedded_docs/docs/LumaImageNode2/fr.md +++ b/comfyui_embedded_docs/docs/LumaImageNode2/fr.md @@ -10,9 +10,9 @@ Ce nœud génère des images à partir de descriptions textuelles à l'aide du m | Paramètre | Description | Type de données | Requis | Plage | | --- | --- | --- | --- | --- | -| `model` | Modèle à utiliser pour la génération. La sélection d'un modèle révèle des paramètres supplémentaires pour ce modèle. | DYNAMIC_COMBO | Oui | `"uni-1"`
`"uni-1-max"` | -| `prompt` | Description textuelle de l'image souhaitée. De 1 à 6000 caractères. | STRING | Oui | 1 à 6000 caractères | -| `seed` | La graine (seed) contrôle si le nœud doit s'exécuter de nouveau ; les résultats ne sont pas déterministes quelle que soit la graine. (par défaut : 0) | INT | Oui | 0 à 2147483647 | +| `modèle` | Modèle à utiliser pour la génération. La sélection d'un modèle révèle des paramètres supplémentaires pour ce modèle. | DYNAMIC_COMBO | Oui | `"uni-1"`
`"uni-1-max"` | +| `invite` | Description textuelle de l'image souhaitée. De 1 à 6000 caractères. | STRING | Oui | 1 à 6000 caractères | +| `graine` | La graine (seed) contrôle si le nœud doit s'exécuter de nouveau ; les résultats ne sont pas déterministes quelle que soit la graine. (par défaut : 0) | INT | Oui | 0 à 2147483647 | ### Entrées uni-1 et uni-1-max diff --git a/comfyui_embedded_docs/docs/LumaRay32ExtendVideoNode/en.md b/comfyui_embedded_docs/docs/LumaRay32ExtendVideoNode/en.md index e88d37fd3..ce6089ce7 100644 --- a/comfyui_embedded_docs/docs/LumaRay32ExtendVideoNode/en.md +++ b/comfyui_embedded_docs/docs/LumaRay32ExtendVideoNode/en.md @@ -4,16 +4,27 @@ Luma Ray 3.2 Extend Video continues a previous Luma Ray 3.2 video generation by ## Inputs +### Common Inputs + | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| +| `direction` | Forward continues after the prior clip; backward is prepended before it. Forward uses the source clip as the starting frame; backward uses it as the ending frame. Selecting "Forward (continue after)" adds the `loop` option. | DYNAMIC_COMBO | Yes | "Forward (continue after)"
"Backward (lead-in before)" | | `source_generation_id` | Generation ID of the prior Ray 3.2 video to extend. Connect the `generation_id` output of another Luma Ray 3.2 node. This value is required and must not be empty. | STRING | Yes | – | -| `direction` | Forward continues after the prior clip; backward is prepended before it. Selecting "Forward (continue after)" also adds the `loop` option. | COMBO | Yes | "Forward (continue after)"
"Backward (lead-in before)" | -| `loop` | Loop the extended video seamlessly (forward extend only). Only available when `direction` is "Forward (continue after)". Default: False. | BOOLEAN | No | True
False | -| `prompt` | Text prompt for the new content. Must be between 1 and 6000 characters. | STRING | Yes | – | +| `prompt` | Text prompt for the new content. Must be between 1 and 6000 characters. | STRING | Yes | 1 to 6000 characters | | `resolution` | Output resolution for the extended video segment. Default: "720p". | COMBO | Yes | "540p"
"720p"
"1080p" | -| `seed` | Random seed for reproducible generation results. | INT | Yes | – | +| `seed` | Seed to determine if node should re-run; results are nondeterministic regardless of seed. Default: 0. | INT | Yes | 0 to 0xFFFFFFFFFFFFFFFF | + +### Forward (continue after) Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `loop` | Loop the extended video seamlessly (forward extend only). Default: False. | BOOLEAN | No | True
False | + +### Backward (lead-in before) Inputs + +This direction adds no additional parameters. -**Note:** The `loop` parameter is only available when `direction` is set to "Forward (continue after)". When using "Backward (lead-in before)", the `loop` option is not available. The `prompt` must be between 1 and 6000 characters. The `source_generation_id` is required and must be connected from a prior Luma Ray 3.2 node's `generation_id` output. +**Note:** Extensions are always 5 seconds. The `loop` parameter is only available when `direction` is "Forward (continue after)"; when using "Backward (lead-in before)", the `loop` option is not available. The `prompt` must be between 1 and 6000 characters. The `source_generation_id` is required and must be connected from a prior Luma Ray 3.2 node's `generation_id` output. ## Outputs diff --git a/comfyui_embedded_docs/docs/MagnificImageUpscalerCreativeNode/en.md b/comfyui_embedded_docs/docs/MagnificImageUpscalerCreativeNode/en.md index 7d09f2003..df46e5cee 100644 --- a/comfyui_embedded_docs/docs/MagnificImageUpscalerCreativeNode/en.md +++ b/comfyui_embedded_docs/docs/MagnificImageUpscalerCreativeNode/en.md @@ -15,14 +15,16 @@ This node uses the Magnific AI service to upscale and creatively enhance an imag | `resemblance` | The level of resemblance to the original image (default: 0). | INT | No | -10 to 10 | | `fractality` | The strength of the prompt and intricacy per square pixel (default: 0). | INT | No | -10 to 10 | | `engine` | The specific AI engine to use for processing. This is an advanced parameter. | COMBO | Yes | `"automatic"`
`"magnific_illusio"`
`"magnific_sharpy"`
`"magnific_sparkle"` | -| `auto_downscale` | When enabled, the node will automatically downscale the input image if the requested upscale would exceed the maximum allowed output size of 25.3 megapixels. This is an advanced parameter (default: False). | BOOLEAN | No | - | +| `auto_downscale` | Automatically downscale input image if output would exceed maximum pixel limit (default: False). This is an advanced parameter. | BOOLEAN | No | - | **Constraints:** * The input `image` must be exactly one image. * The input image must have a minimum height and width of 160 pixels. * The input image's aspect ratio must be between 1:3 and 3:1. -* The final output size (input dimensions multiplied by the `scale_factor`) cannot exceed 25,300,000 pixels. If `auto_downscale` is disabled and this limit would be exceeded, the node will raise an error. +* The final output size (input dimensions multiplied by the `scale_factor`) cannot exceed 25,300,000 pixels. If this limit would be exceeded: + - When `auto_downscale` is enabled, the node automatically reduces the input image size (by no more than 2x) or uses a lower `scale_factor` so the output stays within the limit. + - When `auto_downscale` is disabled, the node raises an error. ## Outputs @@ -33,4 +35,4 @@ This node uses the Magnific AI service to upscale and creatively enhance an imag > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MagnificImageUpscalerCreativeNode/en.md) --- -**Source fingerprint (SHA-256):** `88362dd9630f0f9420bd7caf3f82ace73d5d2b979bd71939298b84ceff288dc8` +**Source fingerprint (SHA-256):** `36c38e87f9f1e568c78cf794aeb0a268c6d25d639006eb2cf18ee040d3071ad4` diff --git a/comfyui_embedded_docs/docs/MagnificImageUpscalerPreciseV2Node/en.md b/comfyui_embedded_docs/docs/MagnificImageUpscalerPreciseV2Node/en.md index 009431126..2043ca965 100644 --- a/comfyui_embedded_docs/docs/MagnificImageUpscalerPreciseV2Node/en.md +++ b/comfyui_embedded_docs/docs/MagnificImageUpscalerPreciseV2Node/en.md @@ -1,14 +1,14 @@ # Magnific Image Upscale (Precise V2) -The Magnific Image Upscale (Precise V2) node performs high-fidelity image upscaling with precise control over sharpness, grain, and detail enhancement. It processes images through an external API, supporting up to a maximum output resolution of 10060×10060 pixels. The node offers different processing styles and can automatically downscale the input if the requested output would exceed the maximum allowed size. +The Magnific Image Upscale (Precise V2) node performs high-fidelity image upscaling with fine control over sharpness, grain, and detail enhancement. It processes images through an external API, supporting up to a maximum output resolution of 10060×10060 pixels. The node offers different processing styles and can automatically downscale the input if the requested output would exceed the maximum allowed size. ## Inputs | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| | `image` | The input image to be upscaled. Exactly one image is required. Minimum dimensions are 160x160 pixels. The aspect ratio must be between 1:3 and 3:1. | IMAGE | Yes | - | -| `scale_factor` | The desired upscaling multiplier. | STRING | Yes | `"2x"`
`"4x"`
`"8x"`
`"16x"` | -| `flavor` | Processing style: sublime for general use, photo for photographs, photo_denoiser for noisy photos. | STRING | Yes | `"sublime"`
`"photo"`
`"photo_denoiser"` | +| `scale_factor` | The desired upscaling multiplier. | COMBO | Yes | `"2x"`
`"4x"`
`"8x"`
`"16x"` | +| `flavor` | Processing style: sublime for general use, photo for photographs, photo_denoiser for noisy photos. | COMBO | Yes | `"sublime"`
`"photo"`
`"photo_denoiser"` | | `sharpen` | Image sharpness intensity. Higher values increase edge definition and clarity. Default: 7. | INT | No | 0 to 100 | | `smart_grain` | Intelligent grain/texture enhancement to prevent the image from looking too smooth or artificial. Default: 7. | INT | No | 0 to 100 | | `ultra_detail` | Controls fine detail, textures, and micro-details added during upscaling. Default: 30. | INT | No | 0 to 100 | @@ -25,4 +25,4 @@ The Magnific Image Upscale (Precise V2) node performs high-fidelity image upscal > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MagnificImageUpscalerPreciseV2Node/en.md) --- -**Source fingerprint (SHA-256):** `b4de8780c46d113fd043930daa6d4b91df3dca493afef486a0ecf2ee9e0ae708` +**Source fingerprint (SHA-256):** `aeb2b3569fd7b1d2417890586b8ac84ff921c4405f63f190188af93044ccfd28` diff --git a/comfyui_embedded_docs/docs/MakeTrainingDataset/en.md b/comfyui_embedded_docs/docs/MakeTrainingDataset/en.md index af562276e..2329c88d1 100644 --- a/comfyui_embedded_docs/docs/MakeTrainingDataset/en.md +++ b/comfyui_embedded_docs/docs/MakeTrainingDataset/en.md @@ -9,11 +9,12 @@ This node prepares data for training by encoding images and text. It takes a lis | `images` | List of images to encode. | IMAGE | Yes | N/A | | `vae` | VAE model for encoding images to latents. | VAE | Yes | N/A | | `clip` | CLIP model for encoding text to conditioning. | CLIP | Yes | N/A | -| `texts` | List of text captions. Can be length n (matching images), 1 (repeated for all), or omitted (uses empty string). | STRING | No | N/A | +| `texts` | List of text captions. Can be length n (matching images), 1 (repeated for all), or omitted (uses empty string). | STRING | No | 0, 1, or n items (n = number of images) | **Parameter Constraints:** -* The number of items in the `texts` list must be 0, 1, or exactly match the number of items in the `images` list. If it is 0, an empty string is used for all images. If it is 1, that single text is repeated for all images. +* The number of items in the `texts` list must be 0, 1, or exactly match the number of items in the `images` list. If it is 0, an empty string is used for all images. If it is 1, that single text is repeated for all images. Any other length raises an error. +* The output `latents` and `conditioning` lists always contain the same number of items as the `images` list, so each latent is paired with the conditioning for its corresponding caption. ## Outputs @@ -25,4 +26,4 @@ This node prepares data for training by encoding images and text. It takes a lis > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MakeTrainingDataset/en.md) --- -**Source fingerprint (SHA-256):** `72f1686aa9da9d50b1948040c323c7e944d4a5c1f4cd2ec5e0987d998c20ea43` +**Source fingerprint (SHA-256):** `244adc98810a874cfe42f834e89f96da300d883faeb5791dff19607c13d0c0db` diff --git a/comfyui_embedded_docs/docs/ManualSigmas/en.md b/comfyui_embedded_docs/docs/ManualSigmas/en.md index 9784b9a8c..419f122ca 100644 --- a/comfyui_embedded_docs/docs/ManualSigmas/en.md +++ b/comfyui_embedded_docs/docs/ManualSigmas/en.md @@ -6,15 +6,17 @@ The ManualSigmas node allows you to manually define a custom sequence of noise l | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `sigmas` | A string containing the sigma values. The node will extract all numbers from this string. For example, "1, 0.5, 0.1" or "1 0.5 0.1". The default value is "1, 0.5". | STRING | Yes | Any comma or space-separated numbers | +| `sigmas` | A string containing the sigma values. The node extracts all numbers from this string, including decimals and negative values. For example, "1, 0.5, 0.1" or "1 0.5 0.1". Default: "1, 0.5". | STRING | Yes | Any comma- or space-separated numeric values | + +Note: This node is marked as experimental. ## Outputs | Output Name | Description | Data Type | | --- | --- | --- | -| `sigmas` | The tensor containing the sequence of sigma values extracted from the input string. | SIGMAS | +| `sigmas` | A tensor containing the sequence of sigma values extracted from the input string. | SIGMAS | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ManualSigmas/en.md) --- -**Source fingerprint (SHA-256):** `38fef43da8aa27a9b79584213c3b6cdd003bc47bcaddcf29d549b0b91880ae8d` +**Source fingerprint (SHA-256):** `19d938ef0eac7343a3138393a039f63632b0763e3884636653c06b91b6f44ed6` diff --git a/comfyui_embedded_docs/docs/MaskPreview/en.md b/comfyui_embedded_docs/docs/MaskPreview/en.md index c60798543..660116f08 100644 --- a/comfyui_embedded_docs/docs/MaskPreview/en.md +++ b/comfyui_embedded_docs/docs/MaskPreview/en.md @@ -1,23 +1,25 @@ # Preview Mask -The MaskPreview node saves mask data as a preview image to your ComfyUI output directory, allowing you to visually inspect mask data during workflow execution. It converts the input mask into a format suitable for image display and saves it with a configurable filename prefix. +The MaskPreview node displays a visual preview of the mask data directly in the ComfyUI interface, without saving it to the output directory. This lets you inspect the exact mask values at any point in your workflow. ## Inputs | Parameter | Description | Data Type | Required | Range | -| --- | --- | --- | --- | --- | -| `mask` | The mask data to be previewed and saved as an image | MASK | Yes | - | -| `filename_prefix` | Prefix for the output filename (default: "ComfyUI") | STRING | No | - | +|-----------|-------------|-----------|----------|-------| +| `mask` | The mask data to preview | MASK | Yes | - | +| `filename_prefix` | Prefix for the preview filename (default: "ComfyUI") | STRING | No | - | | `prompt` | Prompt information for metadata (automatically provided) | PROMPT | No | - | | `extra_pnginfo` | Additional PNG information for metadata (automatically provided) | EXTRA_PNGINFO | No | - | +The `prompt` and `extra_pnginfo` inputs are hidden and are supplied automatically by the ComfyUI system; you do not need to connect them manually. + ## Outputs | Output Name | Description | Data Type | -| --- | --- | --- | -| `ui` | Contains the preview image information and metadata for display in the UI | DICT | +|-------------|-------------|-----------| +| `mask` | The mask data that was previewed, returned unchanged for further use in the workflow | MASK | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MaskPreview/en.md) --- -**Source fingerprint (SHA-256):** `c9d9dbc5720ac4c75518c758f2ec3e789b0d3c45431590fb0008573bb9159427` +**Source fingerprint (SHA-256):** `3d4ecb8cd90c3ecbe9d3cff8f782062c582c7190d9f0e0ed069cba114d4beac5` diff --git a/comfyui_embedded_docs/docs/MergeMeshes/ar.md b/comfyui_embedded_docs/docs/MergeMeshes/ar.md new file mode 100644 index 000000000..924e10153 --- /dev/null +++ b/comfyui_embedded_docs/docs/MergeMeshes/ar.md @@ -0,0 +1,24 @@ +# MergeMeshes + +```markdown +MergeMeshes تدمج مدخلات شبكات متعددة في شبكة واحدة عن طريق تكديس رؤوسها وأوجهها وإحداثيات UV وألوان الرؤوس، مع ضبط فهارس الأوجه بحيث تكون النتيجة شبكة واحدة متصلة. + +## المدخلات + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|-----------|-------------|-----------|----------|-------| +| `meshes` | فتحة قابلة للتوسيع: اربط من 2 إلى 50 كائن شبكة (تُسمى `mesh_1`, `mesh_2`, ..., `mesh_50`). يتم دمج جميع الشبكات المتصلة في شبكة إخراج واحدة. | MESH | نعم | 2 to 50 meshes | + +**ملاحظة:** يتم استخدام أول عنصر شبكة فقط من دفعة كل شبكة إدخال. إذا كانت أي شبكة إدخال تحتوي على بيانات UV، فسيشمل الإخراج قيم UV وستحصل الشبكات التي لا تحتوي على UV على قيم UV معبأة بالأصفار. إذا كانت أي شبكة إدخال تحتوي على ألوان رؤوس، فسيشمل الإخراج ألوان الرؤوس؛ أما الشبكات التي لا تحتوي على ألوان فستحصل على اللون الأبيض (القيمة 1)، ويتم توسيع قنوات الألوان إلى أكبر عدد قنوات موجود بين المدخلات. يتم الاحتفاظ فقط بالنسيج من أول مدخل يوفره؛ ويتم تجاهل أي أنسجة إضافية. + +## المخرجات + +| اسم المخرج | الوصف | نوع البيانات | +|-------------|-------------|-----------| +| `mesh` | الشبكة المدمجة التي تحتوي على جميع رؤوس المدخلات وأوجهها وقيم UV وألوانها مجتمعة في شبكة واحدة. | MESH | +``` + +> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MergeMeshes/ar.md) + +--- +**Source fingerprint (SHA-256):** `0ce49b522f6348d524df20d6c27eb8bd9575c4a781790f6f8e3ac4f3ee255d38` diff --git a/comfyui_embedded_docs/docs/MergeMeshes/en.md b/comfyui_embedded_docs/docs/MergeMeshes/en.md new file mode 100644 index 000000000..634a07ff6 --- /dev/null +++ b/comfyui_embedded_docs/docs/MergeMeshes/en.md @@ -0,0 +1,22 @@ +# MergeMeshes + +MergeMeshes combines multiple mesh inputs into one mesh by stacking their vertices, faces, UV coordinates, and vertex colors, and adjusting face indices so the result is a single continuous mesh. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `meshes` | Growable slot: connect 2 to 50 mesh objects (named `mesh_1`, `mesh_2`, ..., `mesh_50`). All connected meshes are merged into one output mesh. | MESH | Yes | 2 to 50 meshes | + +**Note:** Only the first mesh item from each input mesh's batch is used. If any input mesh has UV data, the output includes UVs and meshes without UVs receive zero-filled UV values. If any input mesh has vertex colors, the output includes vertex colors; meshes without colors receive white (value 1) colors, and color channels are padded to the largest channel count found among inputs. Only the texture from the first input that provides one is kept; additional textures are dropped. + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `mesh` | The merged mesh containing all input vertices, faces, UVs, and colors combined into one mesh. | MESH | + +> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MergeMeshes/en.md) + +--- +**Source fingerprint (SHA-256):** `0ce49b522f6348d524df20d6c27eb8bd9575c4a781790f6f8e3ac4f3ee255d38` diff --git a/comfyui_embedded_docs/docs/MergeMeshes/es.md b/comfyui_embedded_docs/docs/MergeMeshes/es.md new file mode 100644 index 000000000..6b1ecfead --- /dev/null +++ b/comfyui_embedded_docs/docs/MergeMeshes/es.md @@ -0,0 +1,22 @@ +# MergeMeshes + +MergeMeshes combina múltiples entradas de malla en una sola malla apilando sus vértices, caras, coordenadas UV y colores de vértice, y ajustando los índices de las caras para que el resultado sea una única malla continua. + +## Entradas + +| Parámetro | Descripción | Tipo de datos | Requerido | Rango | +|-----------|-------------|---------------|-----------|-------| +| `meshes` | Ranura ampliable: conecta de 2 a 50 objetos de malla (denominados `mesh_1`, `mesh_2`, ..., `mesh_50`). Todas las mallas conectadas se fusionan en una única malla de salida. | MESH | Sí | 2 a 50 mallas | + +**Nota:** Solo se utiliza el primer elemento de malla de cada lote de mallas de entrada. Si alguna malla de entrada tiene datos UV, la salida incluye UV y las mallas sin UV reciben valores UV rellenos con ceros. Si alguna malla de entrada tiene colores de vértice, la salida incluye colores de vértice; las mallas sin colores reciben colores blancos (valor 1), y los canales de color se rellenan hasta el mayor número de canales encontrado entre las entradas. Solo se conserva la textura de la primera entrada que la proporcione; las texturas adicionales se descartan. + +## Salidas + +| Nombre de salida | Descripción | Tipo de datos | +|------------------|-------------|---------------| +| `mesh` | La malla fusionada que contiene todos los vértices, caras, UV y colores de entrada combinados en una sola malla. | MESH | + +> Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MergeMeshes/es.md) + +--- +**Source fingerprint (SHA-256):** `0ce49b522f6348d524df20d6c27eb8bd9575c4a781790f6f8e3ac4f3ee255d38` diff --git a/comfyui_embedded_docs/docs/MergeMeshes/fa.md b/comfyui_embedded_docs/docs/MergeMeshes/fa.md new file mode 100644 index 000000000..047b69185 --- /dev/null +++ b/comfyui_embedded_docs/docs/MergeMeshes/fa.md @@ -0,0 +1,22 @@ +# MergeMeshes + +MergeMeshes چند ورودی مش را با انباشتن رئوس، وجه‌ها، مختصات UV و رنگ‌های رأس آن‌ها در یک مش ترکیب می‌کند و ایندکس‌های وجه را طوری تنظیم می‌کند که نتیجه یک مش پیوسته واحد باشد. + +## ورودی‌ها + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `meshes` | اسلات قابل توسعه: ۲ تا ۵۰ شیء مش را متصل کنید (با نام‌های `mesh_1`, `mesh_2`, ..., `mesh_50`). همه مش‌های متصل‌شده در یک مش خروجی ادغام می‌شوند. | MESH | بله | 2 to 50 meshes | + +**نکته:** تنها اولین آیتم مش از دسته (batch) هر مش ورودی استفاده می‌شود. اگر هر مش ورودی دارای داده UV باشد، خروجی شامل UVها خواهد بود و مش‌های بدون UV مقادیر UV صفر دریافت می‌کنند. اگر هر مش ورودی دارای رنگ رأس باشد، خروجی شامل رنگ‌های رأس خواهد بود؛ مش‌های بدون رنگ، رنگ سفید (مقدار 1) دریافت می‌کنند و کانال‌های رنگ به بزرگ‌ترین تعداد کانال موجود در میان ورودی‌ها تکمیل می‌شوند. تنها بافت (texture) از اولین ورودی که بافتی ارائه دهد نگهداری می‌شود؛ بافت‌های اضافی حذف می‌شوند. + +## خروجی‌ها + +| نام خروجی | توضیحات | نوع داده | +|-------------|-------------|-----------| +| `mesh` | مش ادغام‌شده شامل تمام رئوس، وجه‌ها، UVها و رنگ‌های ورودی که در یک مش ترکیب شده‌اند. | MESH | + +> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MergeMeshes/fa.md) + +--- +**Source fingerprint (SHA-256):** `0ce49b522f6348d524df20d6c27eb8bd9575c4a781790f6f8e3ac4f3ee255d38` diff --git a/comfyui_embedded_docs/docs/MergeMeshes/fr.md b/comfyui_embedded_docs/docs/MergeMeshes/fr.md new file mode 100644 index 000000000..124520118 --- /dev/null +++ b/comfyui_embedded_docs/docs/MergeMeshes/fr.md @@ -0,0 +1,22 @@ +# MergeMeshes + +MergeMeshes combine plusieurs maillages en un seul en empilant leurs sommets, faces, coordonnées UV et couleurs de sommets, et en ajustant les indices de faces afin que le résultat soit un maillage continu unique. + +## Entrées + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `meshes` | Emplacement extensible : connectez 2 à 50 objets maillage (nommés `mesh_1`, `mesh_2`, ..., `mesh_50`). Tous les maillages connectés sont fusionnés en un seul maillage de sortie. | MESH | Oui | 2 à 50 maillages | + +**Remarque :** Seul le premier élément de maillage de chaque lot (batch) d’entrée est utilisé. Si un maillage d’entrée possède des données UV, la sortie inclut les UV et les maillages sans UV reçoivent des valeurs UV remplies de zéros. Si un maillage d’entrée possède des couleurs de sommets, la sortie inclut les couleurs de sommets ; les maillages sans couleurs reçoivent des couleurs blanches (valeur 1), et les canaux de couleur sont remplis de zéros jusqu’au nombre de canaux le plus élevé trouvé parmi les entrées. Seule la texture provenant du premier maillage qui en fournit une est conservée ; les textures supplémentaires sont supprimées. + +## Sorties + +| Nom de sortie | Description | Type de données | +|---------------|-------------|-----------------| +| `mesh` | Le maillage fusionné contenant tous les sommets, faces, UV et couleurs des entrées, combinés en un seul maillage. | MESH | + +> Cette documentation a été générée par IA. Si vous trouvez des erreurs ou avez des suggestions d'amélioration, n'hésitez pas à contribuer ! [Modifier sur GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MergeMeshes/fr.md) + +--- +**Source fingerprint (SHA-256):** `0ce49b522f6348d524df20d6c27eb8bd9575c4a781790f6f8e3ac4f3ee255d38` diff --git a/comfyui_embedded_docs/docs/MergeMeshes/ja.md b/comfyui_embedded_docs/docs/MergeMeshes/ja.md new file mode 100644 index 000000000..56aa93639 --- /dev/null +++ b/comfyui_embedded_docs/docs/MergeMeshes/ja.md @@ -0,0 +1,22 @@ +# MergeMeshes + +MergeMeshes は、複数のメッシュ入力の頂点、面、UV 座標、頂点カラーをスタックし、面インデックスを調整することで、単一の連続したメッシュに結合します。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `meshes` | 拡張可能スロット: 2~50個のメッシュオブジェクト(`mesh_1`、`mesh_2`、...、`mesh_50` という名前)を接続できます。接続されたすべてのメッシュは、1つの出力メッシュに結合されます。 | MESH | はい | 2~50メッシュ | + +**注:** 各入力メッシュのバッチからは、最初のメッシュアイテムのみが使用されます。いずれかの入力メッシュに UV データがある場合、出力には UV が含まれ、UV を持たないメッシュにはゼロで埋められた UV 値が割り当てられます。いずれかの入力メッシュに頂点カラーがある場合、出力には頂点カラーが含まれます。カラーを持たないメッシュには白(値 1)のカラーが割り当てられ、カラーチャンネルは入力内で見つかった最大チャンネル数に合わせてパディングされます。テクスチャを提供する最初の入力からのテクスチャのみが保持され、追加のテクスチャは破棄されます。 + +## 出力 + +| 出力名 | 説明 | データ型 | +|-------------|-------------|-----------| +| `mesh` | 入力されたすべての頂点、面、UV、カラーを1つのメッシュに結合した統合メッシュです。 | MESH | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MergeMeshes/ja.md) + +--- +**Source fingerprint (SHA-256):** `0ce49b522f6348d524df20d6c27eb8bd9575c4a781790f6f8e3ac4f3ee255d38` diff --git a/comfyui_embedded_docs/docs/MergeMeshes/ko.md b/comfyui_embedded_docs/docs/MergeMeshes/ko.md new file mode 100644 index 000000000..11580c164 --- /dev/null +++ b/comfyui_embedded_docs/docs/MergeMeshes/ko.md @@ -0,0 +1,22 @@ +# MergeMeshes + +MergeMeshes는 여러 메시 입력을 하나의 메시로 결합합니다. 정점, 면, UV 좌표 및 정점 색상을 적층하고 면 인덱스를 조정하여 결과가 단일 연속 메시가 되도록 합니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 유형 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `meshes` | 확장 가능한 슬롯: 2~50개의 메시 객체를 연결합니다(`mesh_1`, `mesh_2`, ..., `mesh_50` 이름 사용). 연결된 모든 메시는 하나의 출력 메시로 병합됩니다. | MESH | 예 | 2~50개 메시 | + +**참고:** 각 입력 메시의 배치에서 첫 번째 메시 항목만 사용됩니다. 입력 메시에 UV 데이터가 있으면 출력에 UV가 포함되며, UV가 없는 메시에는 0으로 채워진 UV 값이 할당됩니다. 입력 메시에 정점 색상이 있으면 출력에 정점 색상이 포함되고, 색상이 없는 메시에는 흰색(값 1)이 할당되며, 색상 채널은 입력 중 가장 큰 채널 수에 맞춰 패딩됩니다. 텍스처는 텍스처를 제공한 첫 번째 입력의 텍스처만 유지되며, 추가 텍스처는 삭제됩니다. + +## 출력 + +| 출력 이름 | 설명 | 데이터 유형 | +|-------------|-------------|-----------| +| `mesh` | 모든 입력 정점, 면, UV 및 색상을 하나의 메시로 결합한 병합된 메시입니다. | MESH | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MergeMeshes/ko.md) + +--- +**Source fingerprint (SHA-256):** `0ce49b522f6348d524df20d6c27eb8bd9575c4a781790f6f8e3ac4f3ee255d38` diff --git a/comfyui_embedded_docs/docs/MergeMeshes/pt-BR.md b/comfyui_embedded_docs/docs/MergeMeshes/pt-BR.md new file mode 100644 index 000000000..89b1d1830 --- /dev/null +++ b/comfyui_embedded_docs/docs/MergeMeshes/pt-BR.md @@ -0,0 +1,22 @@ +# MergeMeshes + +MergeMeshes combina várias entradas de mesh em um único mesh, empilhando seus vértices, faces, coordenadas UV e cores de vértice, e ajustando os índices das faces para que o resultado seja um único mesh contínuo. + +## Entradas + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Faixa | +|-----------|-------------|-----------|----------|-------| +| `meshes` | Slot expansível: conecte de 2 a 50 objetos de mesh (nomeados `mesh_1`, `mesh_2`, ..., `mesh_50`). Todos os meshes conectados são mesclados em um único mesh de saída. | MESH | Sim | 2 a 50 meshes | + +**Nota:** Apenas o primeiro item de mesh do lote de cada mesh de entrada é usado. Se algum mesh de entrada tiver dados de UV, a saída incluirá UVs e os meshes sem UVs receberão valores de UV preenchidos com zero. Se algum mesh de entrada tiver cores de vértice, a saída incluirá cores de vértice; meshes sem cores recebem cor branca (valor 1), e os canais de cor são preenchidos até a maior contagem de canais encontrada entre as entradas. Apenas a textura da primeira entrada que fornecer uma é mantida; texturas adicionais são descartadas. + +## Saídas + +| Nome da Saída | Descrição | Tipo de Dados | +|-------------|-------------|-----------| +| `mesh` | O mesh mesclado contendo todos os vértices, faces, UVs e cores das entradas combinados em um único mesh. | MESH | + +> Esta documentação foi gerada por IA. Se você encontrar erros ou tiver sugestões de melhoria, sinta-se à vontade para contribuir! [Editar no GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MergeMeshes/pt-BR.md) + +--- +**Source fingerprint (SHA-256):** `0ce49b522f6348d524df20d6c27eb8bd9575c4a781790f6f8e3ac4f3ee255d38` diff --git a/comfyui_embedded_docs/docs/MergeMeshes/ru.md b/comfyui_embedded_docs/docs/MergeMeshes/ru.md new file mode 100644 index 000000000..41527d60a --- /dev/null +++ b/comfyui_embedded_docs/docs/MergeMeshes/ru.md @@ -0,0 +1,22 @@ +# MergeMeshes + +MergeMeshes объединяет несколько входных mesh-объектов в один mesh, накладывая их вершины, грани, UV-координаты и цвета вершин, а также корректируя индексы граней, чтобы в результате получился единый непрерывный mesh. + +## Входы + +| Параметр | Описание | Тип данных | Обязательный | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `meshes` | Расширяемый слот: подключите от 2 до 50 mesh-объектов (с именами `mesh_1`, `mesh_2`, ..., `mesh_50`). Все подключенные mesh-объекты объединяются в один выходной mesh. | MESH | Да | от 2 до 50 мешей | + +**Примечание:** Из пакета (batch) каждого входного mesh-объекта используется только первый элемент. Если хотя бы один входной mesh содержит UV-данные, выходной mesh включает UV-координаты, а mesh-объекты без UV получают нулевые значения UV. Если хотя бы один входной mesh содержит цвета вершин, выходной mesh включает цвета вершин; mesh-объекты без цветов получают белые (значение 1) цвета, а цветовые каналы дополняются до наибольшего количества каналов среди всех входных данных. Сохраняется только текстура из первого входного mesh-объекта, который её предоставляет; дополнительные текстуры отбрасываются. + +## Выходы + +| Имя выхода | Описание | Тип данных | +|-------------|-------------|-----------| +| `mesh` | Объединенный mesh, содержащий все входные вершины, грани, UV-координаты и цвета, объединенные в один mesh. | MESH | + +> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MergeMeshes/ru.md) + +--- +**Source fingerprint (SHA-256):** `0ce49b522f6348d524df20d6c27eb8bd9575c4a781790f6f8e3ac4f3ee255d38` diff --git a/comfyui_embedded_docs/docs/MergeMeshes/tr.md b/comfyui_embedded_docs/docs/MergeMeshes/tr.md new file mode 100644 index 000000000..275674835 --- /dev/null +++ b/comfyui_embedded_docs/docs/MergeMeshes/tr.md @@ -0,0 +1,22 @@ +# MergeMeshes + +MergeMeshes, birden fazla mesh girdisini; köşe noktalarını, yüzeyleri, UV koordinatlarını ve köşe renklerini üst üste ekleyerek ve yüzey indekslerini ayarlayarak tek bir mesh halinde birleştirir. Böylece sonuç, tek bir sürekli mesh olur. + +## Girdiler + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +|-----------|----------|-----------|---------|--------| +| `meshes` | Genişletilebilir yuva: 2 ila 50 mesh nesnesi bağlayın (`mesh_1`, `mesh_2`, ..., `mesh_50` olarak adlandırılır). Bağlanan tüm meshler tek bir çıktı meshinde birleştirilir. | MESH | Evet | 2 ila 50 mesh | + +**Not:** Her girdi mesh'inin grubundan yalnızca ilk mesh öğesi kullanılır. Herhangi bir girdi mesh'inde UV verisi varsa, çıktı UV'leri içerir ve UV'si olmayan meshler sıfır değerli UV değerleri alır. Herhangi bir girdi mesh'inde köşe rengi varsa, çıktı köşe renklerini içerir; rengi olmayan meshler beyaz (değer 1) renk alır ve renk kanalları, girdiler arasında bulunan en büyük kanal sayısına göre doldurulur. Yalnızca doku sağlayan ilk girdiden gelen doku korunur; ek dokular atılır. + +## Çıktılar + +| Çıktı Adı | Açıklama | Veri Türü | +|-------------|-------------|-----------| +| `mesh` | Tüm girdi köşe noktalarını, yüzeyleri, UV'leri ve renkleri tek bir mesh içinde birleştiren birleştirilmiş mesh. | MESH | + +> Bu belge yapay zeka tarafından oluşturulmuştur. Herhangi bir hata bulursanız veya iyileştirme önerileriniz varsa, katkıda bulunmaktan çekinmeyin! [GitHub'da Düzenle](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MergeMeshes/tr.md) + +--- +**Source fingerprint (SHA-256):** `0ce49b522f6348d524df20d6c27eb8bd9575c4a781790f6f8e3ac4f3ee255d38` diff --git a/comfyui_embedded_docs/docs/MergeMeshes/zh-TW.md b/comfyui_embedded_docs/docs/MergeMeshes/zh-TW.md new file mode 100644 index 000000000..39edeb3a2 --- /dev/null +++ b/comfyui_embedded_docs/docs/MergeMeshes/zh-TW.md @@ -0,0 +1,22 @@ +# MergeMeshes + +MergeMeshes 通過堆疊多個網格輸入的頂點、面、UV 座標和頂點顏色,並調整面索引,將多個網格輸入合併為一個網格,使結果成為單一的連續網格。 + +## 輸入 + +| 參數 | 描述 | 資料類型 | 必要 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `meshes` | 可增長插槽:連接 2 到 50 個網格物件(命名為 `mesh_1`、`mesh_2`、...、`mesh_50`)。所有連接的網格都會合併為一個輸出網格。 | MESH | 是 | 2 to 50 meshes | + +**注意:** 僅使用每個輸入網格批次中的第一個網格項目。如果任何輸入網格具有 UV 資料,則輸出將包含 UV,而沒有 UV 的網格將接收零填充的 UV 值。如果任何輸入網格具有頂點顏色,則輸出將包含頂點顏色;沒有顏色的網格將接收白色(值 1)顏色,並且顏色通道會填充到輸入中最大的通道數。僅保留第一個提供紋理的輸入的紋理,其餘紋理將被丟棄。 + +## 輸出 + +| 輸出名 | 描述 | 資料類型 | +|-------------|-------------|-----------| +| `mesh` | 合併後的網格,包含所有輸入的頂點、面、UV 和顏色,並組合成一個網格。 | MESH | + +> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MergeMeshes/zh-TW.md) + +--- +**Source fingerprint (SHA-256):** `0ce49b522f6348d524df20d6c27eb8bd9575c4a781790f6f8e3ac4f3ee255d38` diff --git a/comfyui_embedded_docs/docs/MergeMeshes/zh.md b/comfyui_embedded_docs/docs/MergeMeshes/zh.md new file mode 100644 index 000000000..2892c35bc --- /dev/null +++ b/comfyui_embedded_docs/docs/MergeMeshes/zh.md @@ -0,0 +1,22 @@ +# MergeMeshes + +MergeMeshes 通过堆叠多个网格输入的顶点、面、UV 坐标和顶点颜色,并调整面索引,将多个网格输入合并为一个网格,从而生成单个连续的网格。 + +## 输入 + +| 参数 | 描述 | 数据类型 | 是否必填 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `meshes` | 可增长插槽:连接 2 到 50 个网格对象(命名为 `mesh_1`、`mesh_2`、...、`mesh_50`)。所有连接的网格都将合并为一个输出网格。 | MESH | 是 | 2 to 50 meshes | + +**注意:** 仅使用每个输入网格批次中的第一个网格项。如果任一输入网格具有 UV 数据,则输出将包含 UV,而没有 UV 的网格将接收零填充的 UV 值。如果任一输入网格具有顶点颜色,则输出将包含顶点颜色;没有颜色的网格将接收白色(值 1)颜色,并且颜色通道将填充到输入中最大的通道数。仅保留第一个提供纹理的输入的纹理;其他纹理将被丢弃。 + +## 输出 + +| 输出名称 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `mesh` | 合并后的网格,包含所有输入的顶点、面、UV 和颜色,组合成一个网格。 | MESH | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MergeMeshes/zh.md) + +--- +**Source fingerprint (SHA-256):** `0ce49b522f6348d524df20d6c27eb8bd9575c4a781790f6f8e3ac4f3ee255d38` diff --git a/comfyui_embedded_docs/docs/MeshSmoothNormals/ar.md b/comfyui_embedded_docs/docs/MeshSmoothNormals/ar.md new file mode 100644 index 000000000..13830c5fa --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshSmoothNormals/ar.md @@ -0,0 +1,23 @@ +# MeshSmoothNormals + +حساب العموديات السلسة لكل رأس في الشبكة وإرفاقها. الشبكات الخالية من العموديات تُظلَّل بشكل مسطح (لكل وجه) بواسطة عارضات glTF؛ هذه العقدة تجعل تظليلها سلسًا. مع زاوية انثناء أقل من 180، تبقى الحواف الأكثر حدةً من العتبة صلبةً عبر تقسيم الرؤوس على طولها. + +## المدخلات + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|-----------|-------------|-----------|----------|-------| +| `mesh` | الشبكة المدخلة للمعالجة. | MESH | نعم | - | +| `crease_angle` | الحواف التي تتجاوز زاويتها الثنائية هذه القيمة (بالدرجات) تبقى صلبة (يتم تقسيم الرؤوس). 180 = سلس كليًا؛ القيم الأقل تحافظ على الحواف الحادة (مثل 30-60 للأسطح الصلبة). الافتراضي: 180.0. | FLOAT | نعم | 0.0 إلى 180.0 (الخطوة 1.0) | + +عندما تكون `crease_angle` بقيمة 180 أو أكثر، لا يتغير هيكل الشبكة. وعند ضبطها أقل من 180، يتم تقسيم الرؤوس على طول الحواف الحادة، مما قد يزيد عدد الرؤوس. + +## المخرجات + +| اسم المخرج | الوصف | نوع البيانات | +|-------------|-------------|-----------| +| `mesh` | الشبكة المدخلة مع بيانات العموديات السلسة المرفقة، أو مع رؤوس مقسمة وعموديات عند ضبط زاوية الانثناء. | MESH | + +> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshSmoothNormals/ar.md) + +--- +**Source fingerprint (SHA-256):** `bbe9c0fba68369d8e9d3fb68e635869233804f3aac458e7c217d94977e77b9be` diff --git a/comfyui_embedded_docs/docs/MeshSmoothNormals/en.md b/comfyui_embedded_docs/docs/MeshSmoothNormals/en.md new file mode 100644 index 000000000..3dbf2f617 --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshSmoothNormals/en.md @@ -0,0 +1,23 @@ +# MeshSmoothNormals + +Compute smooth per-vertex normals for a mesh and attach them. Meshes without normals are shaded flat (per-face) by glTF viewers; this node makes them shade smoothly. With a crease angle below 180, edges sharper than the threshold are kept hard by splitting vertices along them. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `mesh` | The input mesh to process. | MESH | Yes | - | +| `crease_angle` | Edges whose dihedral angle exceeds this value (degrees) stay hard (vertices are split). 180 = fully smooth; lower preserves sharp edges (e.g. ~30-60 for hard-surface). Default: 180.0. | FLOAT | Yes | 0.0 to 180.0 (step 1.0) | + +When `crease_angle` is 180 or higher, the mesh topology is unchanged. When set below 180, vertices are split along hard edges, which may increase the vertex count. + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `mesh` | The input mesh with smooth normal data attached, or with split vertices and normals when a crease angle is set. | MESH | + +> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshSmoothNormals/en.md) + +--- +**Source fingerprint (SHA-256):** `bbe9c0fba68369d8e9d3fb68e635869233804f3aac458e7c217d94977e77b9be` diff --git a/comfyui_embedded_docs/docs/MeshSmoothNormals/es.md b/comfyui_embedded_docs/docs/MeshSmoothNormals/es.md new file mode 100644 index 000000000..11c59b4f2 --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshSmoothNormals/es.md @@ -0,0 +1,21 @@ +# MeshSmoothNormals + +## Entradas + +| Parámetro | Descripción | Tipo de dato | Obligatorio | Rango | +|-----------|-------------|--------------|--------------|-------| +| `mesh` | La malla de entrada a procesar. | MESH | Sí | - | +| `crease_angle` | Las aristas cuyo ángulo diedro supera este valor (en grados) permanecen duras (los vértices se dividen). 180 = completamente suave; valores más bajos conservan aristas afiladas (p. ej., ~30-60 para superficies duras). Predeterminado: 180.0. | FLOAT | Sí | 0.0 to 180.0 (step 1.0) | + +Cuando `crease_angle` es 180 o más, la topología de la malla no cambia. Cuando se establece por debajo de 180, los vértices se dividen a lo largo de las aristas duras, lo que puede aumentar el número de vértices. + +## Salidas + +| Nombre de salida | Descripción | Tipo de dato | +|-----------------|-------------|--------------| +| `mesh` | La malla de entrada con datos normales suaves adjuntos, o con vértices y normales divididos cuando se establece un ángulo de pliegue. | MESH | + +> Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshSmoothNormals/es.md) + +--- +**Source fingerprint (SHA-256):** `bbe9c0fba68369d8e9d3fb68e635869233804f3aac458e7c217d94977e77b9be` diff --git a/comfyui_embedded_docs/docs/MeshSmoothNormals/fa.md b/comfyui_embedded_docs/docs/MeshSmoothNormals/fa.md new file mode 100644 index 000000000..dde819b22 --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshSmoothNormals/fa.md @@ -0,0 +1,23 @@ +# MeshSmoothNormals + +نرمال‌های هموار per-vertex را برای یک مش محاسبه کرده و به آن متصل می‌کند. مش‌های بدون نرمال توسط بینندگان glTF به‌صورت تخت (per-face) سایه‌دهی می‌شوند؛ این گره باعث می‌شود آن‌ها به‌صورت هموار سایه بخورند. با زاویه چین (crease angle) کمتر از ۱۸۰، یال‌هایی که تیزتر از آستانه هستند با جدا کردن رأس‌ها در امتداد آن‌ها سخت باقی می‌مانند. + +## ورودی‌ها + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `mesh` | مش ورودی برای پردازش. | MESH | بله | - | +| `crease_angle` | یال‌هایی که زاویه دوسطحی آن‌ها از این مقدار (بر حسب درجه) بیشتر باشد، سخت می‌مانند (رأس‌ها جدا می‌شوند). 180 = کاملاً هموار؛ مقادیر پایین‌تر لبه‌های تیز را حفظ می‌کنند (مثلاً حدود 30-60 برای سطوح سخت). پیش‌فرض: 180.0. | FLOAT | بله | 0.0 تا 180.0 (گام 1.0) | + +وقتی `crease_angle` برابر یا بیشتر از 180 باشد، توپولوژی مش بدون تغییر می‌ماند. وقتی زیر 180 تنظیم شود، رأس‌ها در امتداد یال‌های سخت جدا می‌شوند که ممکن است تعداد رأس‌ها را افزایش دهد. + +## خروجی‌ها + +| نام خروجی | توضیحات | نوع داده | +|-------------|-------------|-----------| +| `mesh` | مش ورودی با داده‌های نرمال هموار متصل‌شده، یا با رأس‌های جدا و نرمال‌ها هنگام تنظیم زاویه چین. | MESH | + +> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshSmoothNormals/fa.md) + +--- +**Source fingerprint (SHA-256):** `bbe9c0fba68369d8e9d3fb68e635869233804f3aac458e7c217d94977e77b9be` diff --git a/comfyui_embedded_docs/docs/MeshSmoothNormals/fr.md b/comfyui_embedded_docs/docs/MeshSmoothNormals/fr.md new file mode 100644 index 000000000..80c8182e6 --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshSmoothNormals/fr.md @@ -0,0 +1,23 @@ +# MeshSmoothNormals + +Calcule des normales lisses par sommet pour un maillage et les attache. Les maillages sans normales sont ombrés de façon plate (par face) par les visionneuses glTF ; ce nœud permet un ombrage lisse. Avec un angle de pli inférieur à 180, les arêtes plus vives que le seuil restent nettes en divisant les sommets le long de celles-ci. + +## Entrées + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `mesh` | Le maillage d'entrée à traiter. | MESH | Oui | - | +| `crease_angle` | Les arêtes dont l'angle dièdre dépasse cette valeur (en degrés) restent vives (les sommets sont divisés). 180 = entièrement lisse ; une valeur inférieure préserve les arêtes vives (par ex. ~30-60 pour les surfaces dures). Défaut : 180.0. | FLOAT | Oui | 0.0 à 180.0 (pas de 1.0) | + +Quand `crease_angle` est égal à 180 ou plus, la topologie du maillage est inchangée. Quand elle est inférieure à 180, les sommets sont divisés le long des arêtes vives, ce qui peut augmenter le nombre de sommets. + +## Sorties + +| Nom de sortie | Description | Type de données | +|---------------|-------------|-----------------| +| `mesh` | Le maillage d'entrée avec les données de normales lisses attachées, ou avec des sommets divisés et des normales lorsqu'un angle de pli est défini. | MESH | + +> Cette documentation a été générée par IA. Si vous trouvez des erreurs ou avez des suggestions d'amélioration, n'hésitez pas à contribuer ! [Modifier sur GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshSmoothNormals/fr.md) + +--- +**Source fingerprint (SHA-256):** `bbe9c0fba68369d8e9d3fb68e635869233804f3aac458e7c217d94977e77b9be` diff --git a/comfyui_embedded_docs/docs/MeshSmoothNormals/ja.md b/comfyui_embedded_docs/docs/MeshSmoothNormals/ja.md new file mode 100644 index 000000000..576be9809 --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshSmoothNormals/ja.md @@ -0,0 +1,25 @@ +# MeshSmoothNormals + +```markdown +メッシュの頂点ごとの滑らかな法線を計算し、それをメッシュに付与します。法線がないメッシュは、glTF ビューアではフラット(面ごと)にシェーディングされますが、このノードを使用すると滑らかにシェーディングされます。`crease_angle` が180未満の場合、しきい値よりも鋭いエッジは、頂点を分割することでハードエッジとして保持されます。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `mesh` | 処理対象の入力メッシュです。 | MESH | はい | - | +| `crease_angle` | この値(度)を超える二面角を持つエッジは、ハードエッジとして保持されます(頂点が分割されます)。180 = 完全に滑らか。それより低い値は鋭いエッジを保持します(例: ハードサーフェスでは約30〜60)。デフォルト: 180.0。 | FLOAT | はい | 0.0 to 180.0 (step 1.0) | + +`crease_angle` が180以上の場合、メッシュのトポロジーは変更されません。180未満に設定すると、ハードエッジに沿って頂点が分割され、頂点数が増える場合があります。 + +## 出力 + +| 出力名 | 説明 | データ型 | +|-------------|-------------|-----------| +| `mesh` | 滑らかな法線データが付加された入力メッシュ、またはクリース角が設定された場合は分割された頂点と法線を持つ入力メッシュです。 | MESH | +``` + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshSmoothNormals/ja.md) + +--- +**Source fingerprint (SHA-256):** `bbe9c0fba68369d8e9d3fb68e635869233804f3aac458e7c217d94977e77b9be` diff --git a/comfyui_embedded_docs/docs/MeshSmoothNormals/ko.md b/comfyui_embedded_docs/docs/MeshSmoothNormals/ko.md new file mode 100644 index 000000000..17e318c0b --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshSmoothNormals/ko.md @@ -0,0 +1,23 @@ +# MeshSmoothNormals + +메시의 부드러운 정점별 법선을 계산하고 이를 첨부합니다. 법선이 없는 메시는 glTF 뷰어에서 평면(면별)으로 음영 처리됩니다. 이 노드는 메시가 부드럽게 음영 처리되도록 합니다. `crease_angle`이 180보다 작으면 임계값보다 날카로운 모서리는 정점을 분할하여 하드 엣지로 유지됩니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `mesh` | 처리할 입력 메시입니다. | MESH | 예 | - | +| `crease_angle` | 이 값(도)을 초과하는 이면각을 가진 모서리는 하드하게 유지됩니다(정점이 분할됨). 180 = 완전히 부드럽게; 낮을수록 날카로운 모서리를 보존합니다(예: 하드 서피스의 경우 약 30-60). 기본값: 180.0. | FLOAT | 예 | 0.0 ~ 180.0 (1.0 단위) | + +`crease_angle`이 180 이상이면 메시 토폴로지는 변경되지 않습니다. 180 미만으로 설정하면 하드 엣지를 따라 정점이 분할되어 정점 수가 늘어날 수 있습니다. + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `mesh` | 입력 메시에 부드러운 법선 데이터가 첨부되거나, `crease_angle`이 설정된 경우 분할된 정점과 법선이 포함된 메시입니다. | MESH | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshSmoothNormals/ko.md) + +--- +**Source fingerprint (SHA-256):** `bbe9c0fba68369d8e9d3fb68e635869233804f3aac458e7c217d94977e77b9be` diff --git a/comfyui_embedded_docs/docs/MeshSmoothNormals/pt-BR.md b/comfyui_embedded_docs/docs/MeshSmoothNormals/pt-BR.md new file mode 100644 index 000000000..8a4f60fb5 --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshSmoothNormals/pt-BR.md @@ -0,0 +1,23 @@ +# MeshSmoothNormals + +Calcula normais suaves por vértice para uma malha e as anexa. Malhas sem normais são sombreadas de forma plana (por face) pelos visualizadores glTF; este nó faz com que sejam sombreadas suavemente. Com um ângulo de vinco abaixo de 180, arestas mais nítidas que o limite são mantidas rígidas, dividindo os vértices ao longo delas. + +## Entradas + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Faixa | +|-----------|-------------|-----------|----------|-------| +| `mesh` | A malha de entrada a ser processada. | MESH | Sim | - | +| `crease_angle` | Arestas cujo ângulo diedro excede este valor (em graus) permanecem rígidas (os vértices são divididos). 180 = totalmente suave; valores menores preservam arestas afiadas (por exemplo, ~30-60 para superfícies duras). Padrão: 180.0. | FLOAT | Sim | 0.0 a 180.0 (passo 1.0) | + +Quando `crease_angle` é 180 ou maior, a topologia da malha permanece inalterada. Quando definido abaixo de 180, os vértices são divididos ao longo das arestas rígidas, o que pode aumentar a contagem de vértices. + +## Saídas + +| Nome da Saída | Descrição | Tipo de Dados | +|-------------|-------------|-----------| +| `mesh` | A malha de entrada com dados de normais suaves anexados, ou com vértices e normais divididos quando um ângulo de vinco é definido. | MESH | + +> Esta documentação foi gerada por IA. Se você encontrar erros ou tiver sugestões de melhoria, sinta-se à vontade para contribuir! [Editar no GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshSmoothNormals/pt-BR.md) + +--- +**Source fingerprint (SHA-256):** `bbe9c0fba68369d8e9d3fb68e635869233804f3aac458e7c217d94977e77b9be` diff --git a/comfyui_embedded_docs/docs/MeshSmoothNormals/ru.md b/comfyui_embedded_docs/docs/MeshSmoothNormals/ru.md new file mode 100644 index 000000000..95b0364df --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshSmoothNormals/ru.md @@ -0,0 +1,23 @@ +# MeshSmoothNormals + +Вычислите сглаженные нормали для каждой вершины сетки и присоедините их. Сетки без нормалей затеняются плоско (по граням) в glTF-просмотрщиках; этот узел делает их затенение плавным. При угле складки ниже 180 рёбра, более острые, чем порог, остаются жёсткими за счёт разделения вершин вдоль них. + +## Входы + +| Параметр | Описание | Тип данных | Обязательный | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `mesh` | Входная сетка для обработки. | MESH | Да | - | +| `crease_angle` | Рёбра, двугранный угол которых превышает это значение (в градусах), остаются жёсткими (вершины разделяются). 180 = полностью гладко; меньшее значение сохраняет острые рёбра (например, ~30–60 для жёстких поверхностей). По умолчанию: 180.0. | FLOAT | Да | 0.0 to 180.0 (step 1.0) | + +Когда `crease_angle` равен 180 или больше, топология сетки не изменяется. При значении ниже 180 вершины разделяются вдоль жёстких рёбер, что может увеличить количество вершин. + +## Выходы + +| Имя выхода | Описание | Тип данных | +|-------------|-------------|-----------| +| `mesh` | Входная сетка с присоединёнными данными сглаженных нормалей, либо с разделёнными вершинами и нормалями, если задан угол складки. | MESH | + +> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshSmoothNormals/ru.md) + +--- +**Source fingerprint (SHA-256):** `bbe9c0fba68369d8e9d3fb68e635869233804f3aac458e7c217d94977e77b9be` diff --git a/comfyui_embedded_docs/docs/MeshSmoothNormals/tr.md b/comfyui_embedded_docs/docs/MeshSmoothNormals/tr.md new file mode 100644 index 000000000..a22f27c00 --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshSmoothNormals/tr.md @@ -0,0 +1,23 @@ +# MeshSmoothNormals + +Compute smooth per-vertex normals for a mesh and attach them. Meshes without normals are shaded flat (per-face) by glTF viewers; this node makes them shade smoothly. With a crease angle below 180, edges sharper than the threshold are kept hard by splitting vertices along them. + +## Girdiler + +| Parametre | Açıklama | Veri Tipi | Gerekli | Aralık | +|-----------|-------------|-----------|----------|-------| +| `mesh` | İşlenecek girdi ağı. | MESH | Evet | - | +| `crease_angle` | Dihedral açısı bu değeri (derece) aşan kenarlar sert kalır (köşeler bölünür). 180 = tamamen yumuşak; düşük değerler keskin kenarları korur (örn. sert yüzeyler için ~30-60). Varsayılan: 180.0. | FLOAT | Evet | 0.0 ila 180.0 (adım 1.0) | + +`crease_angle` 180 veya daha yüksek olduğunda ağ topolojisi değişmez. 180'in altına ayarlandığında, köşeler sert kenarlar boyunca bölünür ve bu da köşe sayısını artırabilir. + +## Çıktılar + +| Çıktı Adı | Açıklama | Veri Tipi | +|-------------|-------------|-----------| +| `mesh` | Yumuşak normal verisi eklenmiş girdi ağı veya bir katlama açısı ayarlandığında bölünmüş köşeler ve normaller içeren ağ. | MESH | + +> Bu belge yapay zeka tarafından oluşturulmuştur. Herhangi bir hata bulursanız veya iyileştirme önerileriniz varsa, katkıda bulunmaktan çekinmeyin! [GitHub'da Düzenle](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshSmoothNormals/tr.md) + +--- +**Source fingerprint (SHA-256):** `bbe9c0fba68369d8e9d3fb68e635869233804f3aac458e7c217d94977e77b9be` diff --git a/comfyui_embedded_docs/docs/MeshSmoothNormals/zh-TW.md b/comfyui_embedded_docs/docs/MeshSmoothNormals/zh-TW.md new file mode 100644 index 000000000..03f9b0315 --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshSmoothNormals/zh-TW.md @@ -0,0 +1,23 @@ +# MeshSmoothNormals + +計算網格的平滑逐頂點法線並將其附加至網格。沒有法線的網格在 glTF 檢視器中會以平面(逐面)方式著色;此節點可讓它們平滑著色。當摺痕角度低於 180 度時,比閾值更銳利的邊緣會透過沿邊緣分割頂點來保持硬邊。 + +## 輸入 + +| 參數 | 描述 | 資料型別 | 必填 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `mesh` | 要處理的輸入網格。 | MESH | 是 | - | +| `crease_angle` | 二面角超過此值(度)的邊緣保持硬邊(頂點會被分割)。180 = 完全平滑;較低的值會保留銳利邊緣(例如硬表面約 30-60)。預設值:180.0。 | FLOAT | 是 | 0.0 to 180.0 (step 1.0) | + +當 `crease_angle` 為 180 或更高時,網格拓撲保持不變。當設定低於 180 時,頂點會沿硬邊分割,這可能會增加頂點數量。 + +## 輸出 + +| 輸出名稱 | 描述 | 資料型別 | +|-------------|-------------|-----------| +| `mesh` | 已附加平滑法線資料的輸入網格,或設定了摺痕角度時具有分割頂點與法線的輸入網格。 | MESH | + +> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshSmoothNormals/zh-TW.md) + +--- +**Source fingerprint (SHA-256):** `bbe9c0fba68369d8e9d3fb68e635869233804f3aac458e7c217d94977e77b9be` diff --git a/comfyui_embedded_docs/docs/MeshSmoothNormals/zh.md b/comfyui_embedded_docs/docs/MeshSmoothNormals/zh.md new file mode 100644 index 000000000..d8c217900 --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshSmoothNormals/zh.md @@ -0,0 +1,23 @@ +# MeshSmoothNormals + +计算网格的平滑逐顶点法线并附加到网格上。没有法线的网格会被 glTF 查看器以平面着色(逐面)方式显示;此节点可使它们平滑着色。当折痕角低于 180 时,比阈值更尖锐的边会通过沿边分割顶点来保持硬边。 + +## 输入 + +| 参数 | 说明 | 数据类型 | 必填 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `mesh` | 要处理的输入网格。 | MESH | 是 | - | +| `crease_angle` | 二面角超过此值(度)的边保持硬边(顶点会被分割)。180 = 完全平滑;较低的值会保留尖锐边缘(例如硬表面模型约 30-60)。默认值:180.0。 | FLOAT | 是 | 0.0 to 180.0 (step 1.0) | + +当 `crease_angle` 为 180 或更高时,网格拓扑不变。当设置为低于 180 时,顶点会沿硬边分割,这可能会增加顶点数量。 + +## 输出 + +| 输出名称 | 说明 | 数据类型 | +|-------------|-------------|-----------| +| `mesh` | 已附加平滑法线数据的输入网格;若设置了折痕角,则为带有分割顶点和法线的输入网格。 | MESH | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshSmoothNormals/zh.md) + +--- +**Source fingerprint (SHA-256):** `bbe9c0fba68369d8e9d3fb68e635869233804f3aac458e7c217d94977e77b9be` diff --git a/comfyui_embedded_docs/docs/MeshTextureToImage/ar.md b/comfyui_embedded_docs/docs/MeshTextureToImage/ar.md new file mode 100644 index 000000000..8178d9ecb --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshTextureToImage/ar.md @@ -0,0 +1,26 @@ +# MeshTextureToImage + +تستخرج هذه العقدة الأنسجة المخبوزة للشبكة وتعيدها كصور منفصلة: اللون الأساسي، المعدنية، الخشونة، الإطباق، وخريطة التطبيع. قنوات النسيج التي لم تُخبز تعود بقيم افتراضية محايدة — الأبيض للإطباق والأزرق المسطح لخريطة التطبيع. + +## المدخلات + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|-----------|-------------|-----------|----------|-------| +| `mesh` | الشبكة التي تُستخرج منها الأنسجة المخبوزة. يجب أن تحتوي الشبكة على نسيج لون أساسي؛ الشبكات التي تحتوي على ألوان رؤوس فقط (مثلًا بعد عقدة PaintMesh) لا تحتوي على نسيج وتسبب خطأً. | MESH | نعم | — | + +ملاحظة: يجب أن تحتوي الشبكة على نسيج لون أساسي مخبوز. إذا لم يوجد، ترفع العقدة خطأً وتوصي بتشغيل BakeTextureFromVoxel أولاً. عندما يكون نسيج المعدنية-الخشونة مفقودًا، يكون لون المخرجين `metallic` و`roughness` أسود (0). أما مخرج `occlusion` فيكون أبيض ما لم تحتوِ الشبكة على إطباق محيط مخبوز. أما مخرج `normal_map` فيكون أزرق محايدًا مسطحًا عند عدم وجود خريطة تطبيع مخبوزة. + +## المخرجات + +| اسم المخرج | الوصف | نوع البيانات | +|-------------|-------------|-----------| +| `base_color` | نسيج اللون الأساسي للشبكة كصورة. | IMAGE | +| `metallic` | القناة المعدنية من نسيج الإطباق-الخشونة-المعدنية للشبكة، كصورة بتدرج رمادي. الأسود (0) يعني غير معدني، والأبيض (1) يعني معدني بالكامل. يكون المخرج أسود عند غياب النسيج. | IMAGE | +| `roughness` | قناة الخشونة من نسيج الإطباق-الخشونة-المعدنية للشبكة، كصورة بتدرج رمادي. يكون المخرج أسود عند غياب النسيج. | IMAGE | +| `occlusion` | قناة الإطباق المحيط من نسيج الإطباق-الخشونة-المعدنية للشبكة، كصورة بتدرج رمادي. يكون المخرج أبيض (بدون إطباق) عندما لا يكون الإطباق المحيط مخبوزًا. | IMAGE | +| `normal_map` | نسيج خريطة التطبيع للشبكة. يكون المخرج خريطة تطبيع محايدة مسطحة (0.5، 0.5، 1.0، وتظهر كلون أزرق مسطح) عند عدم وجود خريطة تطبيع مخبوزة. | IMAGE | + +> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshTextureToImage/ar.md) + +--- +**Source fingerprint (SHA-256):** `775fd50601ed9ebfc48abf1832c58acbac0f48b5faaebb5f7f46ae4a501278c4` diff --git a/comfyui_embedded_docs/docs/MeshTextureToImage/en.md b/comfyui_embedded_docs/docs/MeshTextureToImage/en.md new file mode 100644 index 000000000..bb225e558 --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshTextureToImage/en.md @@ -0,0 +1,26 @@ +# MeshTextureToImage + +This node extracts a mesh's baked textures and returns them as separate images: base color, metallic, roughness, occlusion, and normal map. Texture channels that were not baked come back as neutral defaults — white for occlusion and a flat blue for the normal map. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `mesh` | The mesh whose baked textures are extracted. The mesh must have a base color texture; meshes that only have vertex colors (for example after a PaintMesh node) do not contain a texture and cause an error. | MESH | Yes | — | + +Note: The mesh must have a baked base color texture. If it does not, the node raises an error and recommends running BakeTextureFromVoxel first. When the metallic-roughness texture is missing, the `metallic` and `roughness` outputs are black (0). The `occlusion` output is white unless the mesh contains baked ambient occlusion. The `normal_map` output is a flat neutral blue when no normal map was baked. + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `base_color` | The base color texture of the mesh as an image. | IMAGE | +| `metallic` | The metallic channel from the mesh's occlusion-roughness-metallic texture, as a grayscale image. Black (0) means non-metallic, white (1) means fully metallic. Black when the texture is missing. | IMAGE | +| `roughness` | The roughness channel from the mesh's occlusion-roughness-metallic texture, as a grayscale image. Black when the texture is missing. | IMAGE | +| `occlusion` | The ambient occlusion channel from the mesh's occlusion-roughness-metallic texture, as a grayscale image. White (no occlusion) when ambient occlusion was not baked. | IMAGE | +| `normal_map` | The normal map texture of the mesh. A flat neutral normal map (0.5, 0.5, 1.0, appearing as flat blue) when no normal map was baked. | IMAGE | + +> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshTextureToImage/en.md) + +--- +**Source fingerprint (SHA-256):** `775fd50601ed9ebfc48abf1832c58acbac0f48b5faaebb5f7f46ae4a501278c4` diff --git a/comfyui_embedded_docs/docs/MeshTextureToImage/es.md b/comfyui_embedded_docs/docs/MeshTextureToImage/es.md new file mode 100644 index 000000000..7e0d97ef9 --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshTextureToImage/es.md @@ -0,0 +1,26 @@ +# MeshTextureToImage + +Este nodo extrae las texturas horneadas de una malla y las devuelve como imágenes separadas: color base, metalness, rugosidad, oclusión y mapa normal. Los canales de textura que no fueron horneados se devuelven con valores neutros por defecto: blanco para la oclusión y azul plano para el mapa normal. + +## Entradas + +| Parámetro | Descripción | Tipo de dato | Requerido | Rango | +|-----------|-------------|--------------|-----------|-------| +| `mesh` | La malla cuyas texturas horneadas se extraen. La malla debe tener una textura de color base; las mallas que solo tienen colores de vértice (por ejemplo, después de un nodo PaintMesh) no contienen una textura y provocan un error. | MESH | Sí | — | + +Nota: La malla debe tener una textura de color base horneada. Si no la tiene, el nodo genera un error y recomienda ejecutar primero BakeTextureFromVoxel. Cuando la textura de metalness-rugosidad falta, las salidas `metallic` y `roughness` son negras (0). La salida `occlusion` es blanca a menos que la malla contenga oclusión ambiental horneada. La salida `normal_map` es un azul neutro plano cuando no se horneó ningún mapa normal. + +## Salidas + +| Nombre de salida | Descripción | Tipo de dato | +|------------------|-------------|--------------| +| `base_color` | La textura de color base de la malla como imagen. | IMAGE | +| `metallic` | El canal de metalness de la textura de oclusión-rugosidad-metalness de la malla, como imagen en escala de grises. Negro (0) significa no metálico, blanco (1) significa totalmente metálico. Negro cuando falta la textura. | IMAGE | +| `roughness` | El canal de rugosidad de la textura de oclusión-rugosidad-metalness de la malla, como imagen en escala de grises. Negro cuando falta la textura. | IMAGE | +| `occlusion` | El canal de oclusión ambiental de la textura de oclusión-rugosidad-metalness de la malla, como imagen en escala de grises. Blanco (sin oclusión) cuando la oclusión ambiental no fue horneada. | IMAGE | +| `normal_map` | La textura de mapa normal de la malla. Un mapa normal neutro plano (0.5, 0.5, 1.0, que aparece como azul plano) cuando no se horneó ningún mapa normal. | IMAGE | + +> Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshTextureToImage/es.md) + +--- +**Source fingerprint (SHA-256):** `775fd50601ed9ebfc48abf1832c58acbac0f48b5faaebb5f7f46ae4a501278c4` diff --git a/comfyui_embedded_docs/docs/MeshTextureToImage/fa.md b/comfyui_embedded_docs/docs/MeshTextureToImage/fa.md new file mode 100644 index 000000000..a68908fad --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshTextureToImage/fa.md @@ -0,0 +1,26 @@ +# MeshTextureToImage + +این گره بافت‌های پخته‌شدهٔ یک مش را استخراج می‌کند و آن‌ها را به‌صورت تصاویر جداگانه برمی‌گرداند: رنگ پایه، فلزی، زبری، انسداد و نرمال مپ. کانال‌هایی که پخته نشده‌اند به‌صورت مقادیر پیش‌فرض خنثی برمی‌گردند — سفید برای انسداد و آبی یکدست برای نرمال مپ. + +## ورودی‌ها + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `mesh` | مشی که بافت‌های پخته‌شدهٔ آن استخراج می‌شود. مش باید دارای بافت رنگ پایه باشد؛ مش‌هایی که فقط رنگ‌های رأس دارند (مثلاً پس از گره PaintMesh) بافتی ندارند و باعث خطا می‌شوند. | MESH | بله | — | + +نکته: مش باید دارای بافت رنگ پایهٔ پخته‌شده باشد. اگر چنین بافتی نداشته باشد، گره خطا صادر می‌کند و توصیه می‌کند ابتدا BakeTextureFromVoxel اجرا شود. وقتی بافت metallic-roughness وجود نداشته باشد، خروجی‌های `metallic` و `roughness` سیاه (0) هستند. خروجی `occlusion` سفید است، مگر اینکه مش دارای انسداد محیطی پخته‌شده باشد. خروجی `normal_map` وقتی نرمال مپ پخته نشده باشد، آبی خنثی یکدست است. + +## خروجی‌ها + +| نام خروجی | توضیحات | نوع داده | +|-------------|-------------|-----------| +| `base_color` | بافت رنگ پایهٔ مش به‌صورت تصویر. | IMAGE | +| `metallic` | کانال فلزی از بافت occlusion-roughness-metallic مش، به‌صورت تصویر مقیاس‌خاکستری. سیاه (0) یعنی غیرفلزی، سفید (1) یعنی کاملاً فلزی. در نبود بافت، سیاه است. | IMAGE | +| `roughness` | کانال زبری از بافت occlusion-roughness-metallic مش، به‌صورت تصویر مقیاس‌خاکستری. در نبود بافت، سیاه است. | IMAGE | +| `occlusion` | کانال انسداد محیطی از بافت occlusion-roughness-metallic مش، به‌صورت تصویر مقیاس‌خاکستری. وقتی انسداد محیطی پخته نشده باشد، سفید (بدون انسداد) است. | IMAGE | +| `normal_map` | بافت نرمال مپ مش. وقتی نرمال مپ پخته نشده باشد، یک نرمال مپ خنثی یکدست (0.5, 0.5, 1.0 که به‌صورت آبی تخت دیده می‌شود) است. | IMAGE | + +> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshTextureToImage/fa.md) + +--- +**Source fingerprint (SHA-256):** `775fd50601ed9ebfc48abf1832c58acbac0f48b5faaebb5f7f46ae4a501278c4` diff --git a/comfyui_embedded_docs/docs/MeshTextureToImage/fr.md b/comfyui_embedded_docs/docs/MeshTextureToImage/fr.md new file mode 100644 index 000000000..5877d7e7e --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshTextureToImage/fr.md @@ -0,0 +1,26 @@ +# MeshTextureToImage + +Ce nœud extrait les textures cuites d'un maillage et les renvoie sous forme d'images séparées : couleur de base, métallique, rugosité, occlusion et carte des normales. Les canaux de texture qui n'ont pas été cuits reviennent avec des valeurs neutres par défaut — blanc pour l'occlusion et bleu plat pour la carte des normales. + +## Entrées + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `mesh` | Le maillage dont les textures cuites sont extraites. Le maillage doit avoir une texture de couleur de base ; les maillages qui n'ont que des couleurs de sommet (par exemple après un nœud PaintMesh) ne contiennent pas de texture et provoquent une erreur. | MESH | Oui | — | + +Remarque : Le maillage doit avoir une texture de couleur de base cuite. Si ce n'est pas le cas, le nœud génère une erreur et recommande d'exécuter BakeTextureFromVoxel d'abord. Lorsque la texture métallique-rugosité est manquante, les sorties `metallic` et `roughness` sont noires (0). La sortie `occlusion` est blanche à moins que le maillage ne contienne une occlusion ambiante cuite. La sortie `normal_map` est un bleu neutre et plat lorsqu'aucune carte des normales n'a été cuite. + +## Sorties + +| Nom de sortie | Description | Type de données | +|---------------|-------------|-----------------| +| `base_color` | La texture de couleur de base du maillage sous forme d'image. | IMAGE | +| `metallic` | Le canal métallique de la texture occlusion-rugosité-métallique du maillage, sous forme d'image en niveaux de gris. Le noir (0) signifie non métallique, le blanc (1) signifie entièrement métallique. Noir lorsque la texture est manquante. | IMAGE | +| `roughness` | Le canal de rugosité de la texture occlusion-rugosité-métallique du maillage, sous forme d'image en niveaux de gris. Noir lorsque la texture est manquante. | IMAGE | +| `occlusion` | Le canal d'occlusion ambiante de la texture occlusion-rugosité-métallique du maillage, sous forme d'image en niveaux de gris. Blanc (pas d'occlusion) lorsque l'occlusion ambiante n'a pas été cuite. | IMAGE | +| `normal_map` | La texture de carte des normales du maillage. Une carte des normales neutre et plate (0,5, 0,5, 1,0, apparaissant comme un bleu plat) lorsqu'aucune carte des normales n'a été cuite. | IMAGE | + +> Cette documentation a été générée par IA. Si vous trouvez des erreurs ou avez des suggestions d'amélioration, n'hésitez pas à contribuer ! [Modifier sur GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshTextureToImage/fr.md) + +--- +**Source fingerprint (SHA-256):** `775fd50601ed9ebfc48abf1832c58acbac0f48b5faaebb5f7f46ae4a501278c4` diff --git a/comfyui_embedded_docs/docs/MeshTextureToImage/ja.md b/comfyui_embedded_docs/docs/MeshTextureToImage/ja.md new file mode 100644 index 000000000..995ac5d48 --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshTextureToImage/ja.md @@ -0,0 +1,26 @@ +# MeshTextureToImage + +このノードは、メッシュにベイクされたテクスチャを抽出し、ベースカラー、メタリック、ラフネス、オクルージョン、ノーマルマップとして個別の画像に出力します。ベイクされていないテクスチャチャンネルは、ニュートラルなデフォルト値(オクルージョンは白、ノーマルマップはフラットな青)で出力されます。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `mesh` | ベイクされたテクスチャを抽出するメッシュ。メッシュにはベースカラーテクスチャが必要です。頂点カラーのみを持つメッシュ(例:PaintMesh ノードの後)にはテクスチャが含まれず、エラーが発生します。 | MESH | はい | — | + +注:メッシュにはベースカラーテクスチャがベイクされている必要があります。ない場合は、ノードがエラーを発生させ、最初に BakeTextureFromVoxel を実行することを推奨します。メタリック・ラフネステクスチャがない場合、`metallic` 出力と `roughness` 出力は黒(0)になります。`occlusion` 出力は、ベイクされたアンビエントオクルージョンがメッシュに含まれていない限り、白になります。ノーマルマップがベイクされていない場合、`normal_map` 出力はフラットなニュートラルブルーになります。 + +## 出力 + +| 出力名 | 説明 | データ型 | +|-------------|-------------|-----------| +| `base_color` | メッシュのベースカラーテクスチャを画像として出力します。 | IMAGE | +| `metallic` | メッシュのオクルージョン・ラフネス・メタリックテクスチャから抽出したメタリックチャンネルをグレースケール画像として出力します。黒(0)は非金属、白(1)は完全な金属を意味します。テクスチャがない場合は黒になります。 | IMAGE | +| `roughness` | メッシュのオクルージョン・ラフネス・メタリックテクスチャから抽出したラフネスチャンネルをグレースケール画像として出力します。テクスチャがない場合は黒になります。 | IMAGE | +| `occlusion` | メッシュのオクルージョン・ラフネス・メタリックテクスチャから抽出したアンビエントオクルージョンチャンネルをグレースケール画像として出力します。アンビエントオクルージョンがベイクされていない場合は白(オクルージョンなし)になります。 | IMAGE | +| `normal_map` | メッシュのノーマルマップテクスチャを出力します。ノーマルマップがベイクされていない場合は、フラットなニュートラルノーマルマップ(0.5, 0.5, 1.0、フラットな青として表示)になります。 | IMAGE | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshTextureToImage/ja.md) + +--- +**Source fingerprint (SHA-256):** `775fd50601ed9ebfc48abf1832c58acbac0f48b5faaebb5f7f46ae4a501278c4` diff --git a/comfyui_embedded_docs/docs/MeshTextureToImage/ko.md b/comfyui_embedded_docs/docs/MeshTextureToImage/ko.md new file mode 100644 index 000000000..eee06332a --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshTextureToImage/ko.md @@ -0,0 +1,26 @@ +# MeshTextureToImage + +이 노드는 메시에 베이크된 텍스처를 추출하여 기본 색상, 금속성, 거칠기, 오클루전, 법선 맵의 개별 이미지로 반환합니다. 베이크되지 않은 텍스처 채널은 중립 기본값으로 반환됩니다 — 오클루전은 흰색, 법선 맵은 평평한 파란색입니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `mesh` | 베이크된 텍스처를 추출할 메시입니다. 메시에는 기본 색상 텍스처가 있어야 합니다. 정점 색상만 있는 메시(예: PaintMesh 노드 이후)는 텍스처를 포함하지 않으므로 오류가 발생합니다. | MESH | 예 | — | + +참고: 메시에는 베이크된 기본 색상 텍스처가 있어야 합니다. 없는 경우 노드는 오류를 발생시키며 먼저 BakeTextureFromVoxel을 실행할 것을 권장합니다. 금속성-거칠기 텍스처가 없는 경우 `metallic` 및 `roughness` 출력은 검은색(0)입니다. `occlusion` 출력은 메시에 베이크된 앰비언트 오클루전이 포함되지 않은 한 흰색입니다. 법선 맵이 베이크되지 않은 경우 `normal_map` 출력은 평평한 중립 파란색입니다. + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `base_color` | 메시의 기본 색상 텍스처를 이미지로 반환합니다. | IMAGE | +| `metallic` | 메시의 오클루전-거칠기-금속성 텍스처에서 금속성 채널을 회색조 이미지로 반환합니다. 검은색(0)은 비금속, 흰색(1)은 완전 금속을 의미합니다. 텍스처가 없는 경우 검은색입니다. | IMAGE | +| `roughness` | 메시의 오클루전-거칠기-금속성 텍스처에서 거칠기 채널을 회색조 이미지로 반환합니다. 텍스처가 없는 경우 검은색입니다. | IMAGE | +| `occlusion` | 메시의 오클루전-거칠기-금속성 텍스처에서 앰비언트 오클루전 채널을 회색조 이미지로 반환합니다. 앰비언트 오클루전이 베이크되지 않은 경우 흰색(오클루전 없음)입니다. | IMAGE | +| `normal_map` | 메시의 법선 맵 텍스처입니다. 법선 맵이 베이크되지 않은 경우 평평한 중립 법선 맵(0.5, 0.5, 1.0, 평평한 파란색으로 표시)입니다. | IMAGE | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshTextureToImage/ko.md) + +--- +**Source fingerprint (SHA-256):** `775fd50601ed9ebfc48abf1832c58acbac0f48b5faaebb5f7f46ae4a501278c4` diff --git a/comfyui_embedded_docs/docs/MeshTextureToImage/pt-BR.md b/comfyui_embedded_docs/docs/MeshTextureToImage/pt-BR.md new file mode 100644 index 000000000..18e783ae7 --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshTextureToImage/pt-BR.md @@ -0,0 +1,26 @@ +# MeshTextureToImage + +Este nó extrai as texturas assadas de uma malha e as retorna como imagens separadas: cor base, metálica, rugosidade, oclusão e mapa normal. Canais de textura que não foram assados retornam como padrões neutros — branco para oclusão e um azul neutro sólido para o mapa normal. + +## Entradas + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Faixa | +|-----------|-------------|-----------|----------|-------| +| `mesh` | A malha cujas texturas assadas são extraídas. A malha deve ter uma textura de cor base; malhas que possuem apenas cores de vértice (por exemplo, após um nó PaintMesh) não contêm textura e causam um erro. | MESH | Sim | — | + +Nota: A malha deve ter uma textura de cor base assada. Se não tiver, o nó gera um erro e recomenda executar BakeTextureFromVoxel primeiro. Quando a textura de metálica-rugosidade estiver ausente, as saídas `metallic` e `roughness` são pretas (0). A saída `occlusion` é branca, a menos que a malha contenha oclusão ambiente assada. A saída `normal_map` é um azul neutro sólido quando nenhum mapa normal foi assado. + +## Saídas + +| Nome da Saída | Descrição | Tipo de Dados | +|-------------|-------------|-----------| +| `base_color` | A textura de cor base da malha como uma imagem. | IMAGE | +| `metallic` | O canal de metálica da textura de oclusão-rugosidade-metálica da malha, como uma imagem em tons de cinza. Preto (0) significa não metálico, branco (1) significa totalmente metálico. Preto quando a textura estiver ausente. | IMAGE | +| `roughness` | O canal de rugosidade da textura de oclusão-rugosidade-metálica da malha, como uma imagem em tons de cinza. Preto quando a textura estiver ausente. | IMAGE | +| `occlusion` | O canal de oclusão ambiente da textura de oclusão-rugosidade-metálica da malha, como uma imagem em tons de cinza. Branco (sem oclusão) quando a oclusão ambiente não foi assada. | IMAGE | +| `normal_map` | A textura de mapa normal da malha. Um mapa normal neutro sólido (0.5, 0.5, 1.0, aparecendo como azul sólido) quando nenhum mapa normal foi assado. | IMAGE | + +> Esta documentação foi gerada por IA. Se você encontrar erros ou tiver sugestões de melhoria, sinta-se à vontade para contribuir! [Editar no GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshTextureToImage/pt-BR.md) + +--- +**Source fingerprint (SHA-256):** `775fd50601ed9ebfc48abf1832c58acbac0f48b5faaebb5f7f46ae4a501278c4` diff --git a/comfyui_embedded_docs/docs/MeshTextureToImage/ru.md b/comfyui_embedded_docs/docs/MeshTextureToImage/ru.md new file mode 100644 index 000000000..fd56d9b4f --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshTextureToImage/ru.md @@ -0,0 +1,26 @@ +# MeshTextureToImage + +Этот узел извлекает запечённые текстуры меша и возвращает их в виде отдельных изображений: базовый цвет, металличность, шероховатость, окклюзия и карта нормалей. Текстурные каналы, которые не были запечены, возвращаются в виде нейтральных значений по умолчанию — белый для окклюзии и плоский синий для карты нормалей. + +## Входы + +| Параметр | Описание | Тип данных | Обязательный | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `mesh` | Меш, из которого извлекаются запечённые текстуры. Меш должен иметь текстуру базового цвета; меши, у которых есть только цвета вершин (например, после узла PaintMesh), не содержат текстуры и вызывают ошибку. | MESH | Да | — | + +Примечание: Меш должен иметь запечённую текстуру базового цвета. Если она отсутствует, узел вызывает ошибку и рекомендует сначала запустить BakeTextureFromVoxel. Когда текстура металличности-шероховатости отсутствует, выходы `metallic` и `roughness` имеют чёрный цвет (0). Выход `occlusion` является белым, если меш не содержит запечённой окклюзии окружающей среды. Выход `normal_map` представляет собой плоскую нейтральную синюю карту, если карта нормалей не была запечена. + +## Выходы + +| Имя выхода | Описание | Тип данных | +|-------------|-------------|-----------| +| `base_color` | Текстура базового цвета меша в виде изображения. | IMAGE | +| `metallic` | Канал металличности из текстуры окклюзии-шероховатости-металличности меша в виде изображения в оттенках серого. Чёрный (0) означает неметаллический, белый (1) — полностью металлический. Чёрный, если текстура отсутствует. | IMAGE | +| `roughness` | Канал шероховатости из текстуры окклюзии-шероховатости-металличности меша в виде изображения в оттенках серого. Чёрный, если текстура отсутствует. | IMAGE | +| `occlusion` | Канал окклюзии окружающей среды из текстуры окклюзии-шероховатости-металличности меша в виде изображения в оттенках серого. Белый (отсутствие окклюзии), если окклюзия окружающей среды не была запечена. | IMAGE | +| `normal_map` | Текстура карты нормалей меша. Плоская нейтральная карта нормалей (0.5, 0.5, 1.0, выглядит как плоский синий), если карта нормалей не была запечена. | IMAGE | + +> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshTextureToImage/ru.md) + +--- +**Source fingerprint (SHA-256):** `775fd50601ed9ebfc48abf1832c58acbac0f48b5faaebb5f7f46ae4a501278c4` diff --git a/comfyui_embedded_docs/docs/MeshTextureToImage/tr.md b/comfyui_embedded_docs/docs/MeshTextureToImage/tr.md new file mode 100644 index 000000000..d0c9d881c --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshTextureToImage/tr.md @@ -0,0 +1,26 @@ +# MeshTextureToImage + +Bu düğüm, bir ağın pişirilmiş dokularını çıkarır ve bunları ayrı görüntüler olarak döndürür: temel renk, metalik, pürüzlülük, oklüzyon ve normal haritası. Pişirilmemiş doku kanalları nötr varsayılan değerler olarak gelir — oklüzyon için beyaz ve normal haritası için düz mavi. + +## Girdiler + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +|-----------|-------------|-----------|----------|-------| +| `mesh` | Pişirilmiş dokuları çıkarılan ağ. Ağın bir temel renk dokusuna sahip olması gerekir; yalnızca köşe noktası renklerine sahip ağlar (örneğin bir PaintMesh düğümünden sonra) doku içermez ve hataya neden olur. | MESH | Evet | — | + +Not: Ağın pişirilmiş bir temel renk dokusuna sahip olması gerekir. Eğer yoksa, düğüm bir hata verir ve önce BakeTextureFromVoxel çalıştırmayı önerir. Metalik-pürüzlülük dokusu eksik olduğunda, `metallic` ve `roughness` çıktıları siyah (0) olur. `occlusion` çıktısı, ağ pişirilmiş ortam oklüzyonu içermediği sürece beyazdır. `normal_map` çıktısı, normal haritası pişirilmediğinde düz nötr mavidir. + +## Çıktılar + +| Çıktı Adı | Açıklama | Veri Türü | +|-------------|-------------|-----------| +| `base_color` | Ağın temel renk dokusu, görüntü olarak. | IMAGE | +| `metallic` | Ağın oklüzyon-pürüzlülük-metalik dokusundaki metalik kanalı, gri tonlamalı görüntü olarak. Siyah (0) metalik olmadığını, beyaz (1) tamamen metalik olduğunu gösterir. Doku eksik olduğunda siyah. | IMAGE | +| `roughness` | Ağın oklüzyon-pürüzlülük-metalik dokusundaki pürüzlülük kanalı, gri tonlamalı görüntü olarak. Doku eksik olduğunda siyah. | IMAGE | +| `occlusion` | Ağın oklüzyon-pürüzlülük-metalik dokusundaki ortam oklüzyonu kanalı, gri tonlamalı görüntü olarak. Ortam oklüzyonu pişirilmediğinde beyaz (oklüzyon yok). | IMAGE | +| `normal_map` | Ağın normal haritası dokusu. Normal haritası pişirilmediğinde düz nötr normal haritası (0.5, 0.5, 1.0, düz mavi olarak görünür). | IMAGE | + +> Bu belge yapay zeka tarafından oluşturulmuştur. Herhangi bir hata bulursanız veya iyileştirme önerileriniz varsa, katkıda bulunmaktan çekinmeyin! [GitHub'da Düzenle](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshTextureToImage/tr.md) + +--- +**Source fingerprint (SHA-256):** `775fd50601ed9ebfc48abf1832c58acbac0f48b5faaebb5f7f46ae4a501278c4` diff --git a/comfyui_embedded_docs/docs/MeshTextureToImage/zh-TW.md b/comfyui_embedded_docs/docs/MeshTextureToImage/zh-TW.md new file mode 100644 index 000000000..2fca26cbf --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshTextureToImage/zh-TW.md @@ -0,0 +1,26 @@ +# MeshTextureToImage + +此節點提取網格的烘焙紋理,並將其作為獨立的影像傳回:基礎顏色、金屬度、粗糙度、環境光遮蔽和法線貼圖。未經烘焙的紋理通道會以中性預設值傳回——遮蔽為白色,法線貼圖為純藍色。 + +## 輸入 + +| 參數 | 說明 | 資料類型 | 必填 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `mesh` | 要提取烘焙紋理的網格。網格必須具有基礎顏色紋理;僅具有頂點顏色的網格(例如在 PaintMesh 節點之後)不包含紋理,並會導致錯誤。 | MESH | 是 | — | + +注意:網格必須具有烘焙的基礎顏色紋理。如果沒有,節點會引發錯誤,並建議先執行 BakeTextureFromVoxel。當缺少金屬度-粗糙度紋理時,`metallic` 和 `roughness` 輸出為黑色(0)。除非網格包含烘焙的環境光遮蔽,否則 `occlusion` 輸出為白色。當未烘焙法線貼圖時,`normal_map` 輸出為平坦的中性藍色。 + +## 輸出 + +| 輸出名 | 說明 | 資料類型 | +|-------------|-------------|-----------| +| `base_color` | 網格的基礎顏色紋理,以影像形式呈現。 | IMAGE | +| `metallic` | 來自網格之遮蔽-粗糙度-金屬度紋理的金屬度通道,以灰階影像呈現。黑色(0)表示非金屬,白色(1)表示完全金屬。當紋理缺失時為黑色。 | IMAGE | +| `roughness` | 來自網格之遮蔽-粗糙度-金屬度紋理的粗糙度通道,以灰階影像呈現。當紋理缺失時為黑色。 | IMAGE | +| `occlusion` | 來自網格之遮蔽-粗糙度-金屬度紋理的環境光遮蔽通道,以灰階影像呈現。當環境光遮蔽未經烘焙時為白色(無遮蔽)。 | IMAGE | +| `normal_map` | 網格的法線貼圖紋理。當未烘焙法線貼圖時,為平坦的中性法線貼圖(0.5, 0.5, 1.0,呈現為純藍色)。 | IMAGE | + +> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshTextureToImage/zh-TW.md) + +--- +**Source fingerprint (SHA-256):** `775fd50601ed9ebfc48abf1832c58acbac0f48b5faaebb5f7f46ae4a501278c4` diff --git a/comfyui_embedded_docs/docs/MeshTextureToImage/zh.md b/comfyui_embedded_docs/docs/MeshTextureToImage/zh.md new file mode 100644 index 000000000..dcd295abf --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshTextureToImage/zh.md @@ -0,0 +1,26 @@ +# MeshTextureToImage + +此节点提取网格的已烘焙纹理,并将其作为单独的图像返回:基础颜色、金属度、粗糙度、环境光遮蔽和法线贴图。未烘焙的纹理通道会以中性默认值返回——环境光遮蔽为白色,法线贴图为纯蓝色。 + +## 输入 + +| 参数 | 描述 | 数据类型 | 必填 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `mesh` | 要提取烘焙纹理的网格。该网格必须具有基础颜色纹理;仅具有顶点颜色的网格(例如经 PaintMesh 节点处理后的网格)不包含纹理,会导致错误。 | MESH | 是 | — | + +注意:网格必须具有已烘焙的基础颜色纹理。如果没有,节点将报错,并建议先运行 BakeTextureFromVoxel。当金属度-粗糙度纹理缺失时,`metallic` 和 `roughness` 输出为黑色(0)。`occlusion` 输出为白色,除非网格包含已烘焙的环境光遮蔽。`normal_map` 输出为平坦的中性蓝色(当未烘焙法线贴图时)。 + +## 输出 + +| 输出名称 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `base_color` | 网格的基础颜色纹理,以图像形式呈现。 | IMAGE | +| `metallic` | 来自网格的环境光遮蔽-粗糙度-金属度纹理的金属度通道,以灰度图像形式呈现。黑色(0)表示非金属,白色(1)表示完全金属。当纹理缺失时为黑色。 | IMAGE | +| `roughness` | 来自网格的环境光遮蔽-粗糙度-金属度纹理的粗糙度通道,以灰度图像形式呈现。当纹理缺失时为黑色。 | IMAGE | +| `occlusion` | 来自网格的环境光遮蔽-粗糙度-金属度纹理的环境光遮蔽通道,以灰度图像形式呈现。当未烘焙环境光遮蔽时为白色(无遮蔽)。 | IMAGE | +| `normal_map` | 网格的法线贴图纹理。当未烘焙法线贴图时,输出平坦的中性法线贴图(0.5, 0.5, 1.0,呈纯蓝色)。 | IMAGE | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshTextureToImage/zh.md) + +--- +**Source fingerprint (SHA-256):** `775fd50601ed9ebfc48abf1832c58acbac0f48b5faaebb5f7f46ae4a501278c4` diff --git a/comfyui_embedded_docs/docs/MeshToFile3D/ar.md b/comfyui_embedded_docs/docs/MeshToFile3D/ar.md new file mode 100644 index 000000000..137d68a17 --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshToFile3D/ar.md @@ -0,0 +1,22 @@ +# MeshToFile3D + +تقوم هذه العقدة بتحويل شبكة (Mesh) إلى كائن ملف GLB يمكن تمريره إلى عقدتي Save 3D أو Preview 3D. وتحمل جميع بيانات الشبكة، بما في ذلك إحداثيات الأشعة فوق البنفسجية (UVs) والألوان والعموديات والنسيج وخرائط العمودية/الإطباق/الانبعاث وإعدادات المواد. يتم استخدام العنصر الأول فقط من دفعة متعددة العناصر. + +## المدخلات + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `mesh` | الشبكة المراد تحويلها إلى ملف GLB، بما في ذلك إحداثيات الأشعة فوق البنفسجية (UVs) والألوان والعموديات والنسيج وخرائط العمودية/الإطباق/الانبعاث والمواد. يُدعم عنصر واحد فقط لكل دفعة؛ إذا كانت الدفعة تحتوي على عناصر متعددة، فسيتم استخدام العنصر الأول. | MESH | Yes | شبكة واحدة | + +ملاحظة: تدعم العقدة عنصرًا واحدًا فقط لكل دفعة. إذا كانت الشبكة المدخلة تحتوي على أكثر من عنصر في دفعة، فسيتم تسجيل تحذير واستخدام العنصر الأول. يجب أن تحتوي الشبكة على رأس (Vertex) واحد ووجه (Face) واحد على الأقل؛ فالشبكة الفارغة تتسبب في حدوث خطأ. + +## المخرجات + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `model_3d` | كائن ملف GLB (glTF ثنائي) يحتوي على الشبكة المسلسلة، وجاهز للحفظ أو المعاينة بواسطة عقد ثلاثية الأبعاد أخرى. | FILE3D | + +> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshToFile3D/ar.md) + +--- +**Source fingerprint (SHA-256):** `f004c2907c0df2e0127e49b4767d1624bf89c72665fc7028347a0b8a63a5772e` diff --git a/comfyui_embedded_docs/docs/MeshToFile3D/en.md b/comfyui_embedded_docs/docs/MeshToFile3D/en.md new file mode 100644 index 000000000..3033e4288 --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshToFile3D/en.md @@ -0,0 +1,22 @@ +# MeshToFile3D + +This node serializes a mesh into a GLB file object that can be passed to Save 3D or Preview 3D nodes. It carries all mesh data along, including UVs, colors, normals, texture, normal/occlusion/emissive maps, and material settings. Only the first item of a multi-item batch is used. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `mesh` | The mesh to convert into a GLB file, including UVs, colors, normals, texture, normal/occlusion/emissive maps, and material. Only one item per batch is supported; if a batch contains multiple items, the first one is used. | MESH | Yes | Single mesh | + +Note: The node supports one item per batch only. If the input mesh contains more than one item in its batch, a warning is logged and the first item is used. The mesh must contain at least one vertex and one face; an empty mesh raises an error. + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `model_3d` | A GLB (glTF Binary) file object containing the serialized mesh, ready to be saved or previewed by other 3D nodes. | FILE3D | + +> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshToFile3D/en.md) + +--- +**Source fingerprint (SHA-256):** `f004c2907c0df2e0127e49b4767d1624bf89c72665fc7028347a0b8a63a5772e` diff --git a/comfyui_embedded_docs/docs/MeshToFile3D/es.md b/comfyui_embedded_docs/docs/MeshToFile3D/es.md new file mode 100644 index 000000000..e5a50204e --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshToFile3D/es.md @@ -0,0 +1,22 @@ +# MeshToFile3D + +Este nodo serializa una malla en un objeto de archivo GLB que puede pasarse a los nodos Save 3D o Preview 3D. Transporta todos los datos de la malla, incluidos UVs, colores, normales, textura, mapas de normales/oclusión/emisión y ajustes de material. Solo se utiliza el primer elemento de un lote de múltiples elementos. + +## Entradas + +| Parámetro | Descripción | Tipo de datos | Requerido | Rango | +|-----------|-------------|---------------|-----------|-------| +| `mesh` | La malla a convertir en un archivo GLB, incluidos UVs, colores, normales, textura, mapas de normales/oclusión/emisión y material. Solo se admite un elemento por lote; si un lote contiene varios elementos, se utiliza el primero. | MESH | Sí | Malla única | + +Nota: El nodo solo admite un elemento por lote. Si la malla de entrada contiene más de un elemento en su lote, se registra una advertencia y se utiliza el primer elemento. La malla debe contener al menos un vértice y una cara; una malla vacía genera un error. + +## Salidas + +| Nombre de salida | Descripción | Tipo de datos | +|------------------|-------------|---------------| +| `model_3d` | Un objeto de archivo GLB (glTF binario) que contiene la malla serializada, listo para ser guardado o previsualizado por otros nodos 3D. | FILE3D | + +> Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshToFile3D/es.md) + +--- +**Source fingerprint (SHA-256):** `f004c2907c0df2e0127e49b4767d1624bf89c72665fc7028347a0b8a63a5772e` diff --git a/comfyui_embedded_docs/docs/MeshToFile3D/fa.md b/comfyui_embedded_docs/docs/MeshToFile3D/fa.md new file mode 100644 index 000000000..25efe377f --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshToFile3D/fa.md @@ -0,0 +1,22 @@ +# MeshToFile3D + +این گره یک مش را به یک شیء فایل GLB سریال‌سازی می‌کند که می‌توان آن را به گره‌های `Save 3D` یا `Preview 3D` ارسال کرد. تمام داده‌های مش را به همراه دارد، از جمله UVها، رنگ‌ها، نرمال‌ها، بافت، نقشه‌های نرمال/آکلوژن/امیسو، و تنظیمات متریال. فقط اولین آیتم از یک بچ چندآیتمی استفاده می‌شود. + +## ورودی‌ها + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|---------|-------------|-----------|----------|--------| +| `mesh` | مشی که به فایل GLB تبدیل می‌شود، شامل UVها، رنگ‌ها، نرمال‌ها، بافت، نقشه‌های نرمال/آکلوژن/امیسو، و متریال. فقط یک آیتم در هر بچ پشتیبانی می‌شود؛ اگر بچ شامل چند آیتم باشد، اولین آیتم استفاده می‌شود. | MESH | بله | تک مش | + +توجه: این گره تنها از یک آیتم در هر بچ پشتیبانی می‌کند. اگر مش ورودی بیش از یک آیتم در بچ خود داشته باشد، یک هشدار ثبت می‌شود و از اولین آیتم استفاده می‌شود. مش باید حداقل یک رأس و یک وجه داشته باشد؛ مش خالی باعث بروز خطا می‌شود. + +## خروجی‌ها + +| نام خروجی | توضیحات | نوع داده | +|-------------|-------------|-----------| +| `model_3d` | یک شیء فایل GLB (glTF Binary) حاوی مش سریال‌سازی‌شده، آماده برای ذخیره یا پیش‌نمایش توسط سایر گره‌های سه‌بعدی. | FILE3D | + +> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshToFile3D/fa.md) + +--- +**Source fingerprint (SHA-256):** `f004c2907c0df2e0127e49b4767d1624bf89c72665fc7028347a0b8a63a5772e` diff --git a/comfyui_embedded_docs/docs/MeshToFile3D/fr.md b/comfyui_embedded_docs/docs/MeshToFile3D/fr.md new file mode 100644 index 000000000..3ec8d518e --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshToFile3D/fr.md @@ -0,0 +1,22 @@ +# MeshToFile3D + +Ce nœud sérialise un maillage en un objet fichier GLB qui peut être passé aux nœuds Save 3D ou Preview 3D. Il transporte toutes les données du maillage, y compris les UV, les couleurs, les normales, la texture, les cartes de normale/occlusion/émissive et les paramètres de matériau. Seul le premier élément d'un lot multi-éléments est utilisé. + +## Entrées + +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `mesh` | Le maillage à convertir en fichier GLB, y compris les UV, les couleurs, les normales, la texture, les cartes de normale/occlusion/émissive et le matériau. Un seul élément par lot est pris en charge ; si un lot contient plusieurs éléments, le premier est utilisé. | MESH | Oui | Maillage unique | + +Remarque : Le nœud ne prend en charge qu'un seul élément par lot. Si le maillage d'entrée contient plus d'un élément dans son lot, un avertissement est enregistré et le premier élément est utilisé. Le maillage doit contenir au moins un sommet et une face ; un maillage vide génère une erreur. + +## Sorties + +| Nom de sortie | Description | Type de données | +|---------------|-------------|-----------------| +| `model_3d` | Un objet fichier GLB (glTF binaire) contenant le maillage sérialisé, prêt à être enregistré ou prévisualisé par d'autres nœuds 3D. | FILE3D | + +> Cette documentation a été générée par IA. Si vous trouvez des erreurs ou avez des suggestions d'amélioration, n'hésitez pas à contribuer ! [Modifier sur GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshToFile3D/fr.md) + +--- +**Source fingerprint (SHA-256):** `f004c2907c0df2e0127e49b4767d1624bf89c72665fc7028347a0b8a63a5772e` diff --git a/comfyui_embedded_docs/docs/MeshToFile3D/ja.md b/comfyui_embedded_docs/docs/MeshToFile3D/ja.md new file mode 100644 index 000000000..3c7ce810b --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshToFile3D/ja.md @@ -0,0 +1,22 @@ +# MeshToFile3D + +このノードは、メッシュをGLBファイルオブジェクトにシリアライズし、Save 3DノードやPreview 3Dノードに渡せるようにします。UV、カラー、法線、テクスチャ、法線/オクルージョン/エミッシブマップ、マテリアル設定など、すべてのメッシュデータを保持します。マルチアイテムバッチの場合は、最初のアイテムのみが使用されます。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `mesh` | GLBファイルに変換するメッシュ。UV、カラー、法線、テクスチャ、法線/オクルージョン/エミッシブマップ、マテリアルを含みます。バッチごとに1アイテムのみサポートされており、バッチに複数のアイテムが含まれる場合は最初のアイテムが使用されます。 | MESH | はい | 単一メッシュ | + +注:このノードはバッチごとに1アイテムのみ対応しています。入力メッシュのバッチに複数のアイテムが含まれる場合、警告がログに記録され、最初のアイテムが使用されます。メッシュには少なくとも1つの頂点と1つの面が含まれている必要があります。空のメッシュはエラーを発生させます。 + +## 出力 + +| 出力名 | 説明 | データ型 | +|-------------|-------------|-----------| +| `model_3d` | シリアライズされたメッシュを含むGLB(glTF Binary)ファイルオブジェクト。他の3Dノードで保存またはプレビューする準備ができています。 | FILE3D | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshToFile3D/ja.md) + +--- +**Source fingerprint (SHA-256):** `f004c2907c0df2e0127e49b4767d1624bf89c72665fc7028347a0b8a63a5772e` diff --git a/comfyui_embedded_docs/docs/MeshToFile3D/ko.md b/comfyui_embedded_docs/docs/MeshToFile3D/ko.md new file mode 100644 index 000000000..aef41a120 --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshToFile3D/ko.md @@ -0,0 +1,22 @@ +# MeshToFile3D + +이 노드는 메시를 GLB 파일 객체로 직렬화하여 Save 3D 또는 Preview 3D 노드에 전달할 수 있게 합니다. UV, 색상, 법선, 텍스처, 노멀/오클루전/발광 맵 및 재질 설정을 포함한 모든 메시 데이터를 함께 전달합니다. 여러 항목으로 구성된 배치에서는 첫 번째 항목만 사용됩니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `mesh` | GLB 파일로 변환할 메시로, UV, 색상, 법선, 텍스처, 노멀/오클루전/발광 맵 및 재질을 포함합니다. 배치당 하나의 항목만 지원되며, 배치에 여러 항목이 포함된 경우 첫 번째 항목이 사용됩니다. | MESH | 예 | Single mesh | + +참고: 이 노드는 배치당 하나의 항목만 지원합니다. 입력 메시의 배치에 항목이 두 개 이상 포함된 경우 경고가 기록되고 첫 번째 항목이 사용됩니다. 메시에는 최소한 하나의 정점과 하나의 면이 포함되어야 하며, 빈 메시는 오류를 발생시킵니다. + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `model_3d` | 직렬화된 메시를 포함하는 GLB(glTF Binary) 파일 객체로, 다른 3D 노드에서 저장하거나 미리 볼 수 있는 상태입니다. | FILE3D | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshToFile3D/ko.md) + +--- +**Source fingerprint (SHA-256):** `f004c2907c0df2e0127e49b4767d1624bf89c72665fc7028347a0b8a63a5772e` diff --git a/comfyui_embedded_docs/docs/MeshToFile3D/pt-BR.md b/comfyui_embedded_docs/docs/MeshToFile3D/pt-BR.md new file mode 100644 index 000000000..9b3ea5ada --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshToFile3D/pt-BR.md @@ -0,0 +1,22 @@ +# MeshToFile3D + +Este nó serializa uma malha em um objeto de arquivo GLB que pode ser passado para os nós Save 3D ou Preview 3D. Ele carrega todos os dados da malha, incluindo UVs, cores, normais, textura, mapas de normal/oclusão/emissão e configurações de material. Apenas o primeiro item de um lote com vários itens é usado. + +## Entradas + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Faixa | +|-----------|-------------|---------------|-------------|-------| +| `mesh` | A malha a ser convertida em um arquivo GLB, incluindo UVs, cores, normais, textura, mapas de normal/oclusão/emissão e material. Apenas um item por lote é suportado; se um lote contiver vários itens, o primeiro é usado. | MESH | Sim | Malha única | + +Nota: O nó suporta apenas um item por lote. Se a malha de entrada contiver mais de um item em seu lote, um aviso é registrado e o primeiro item é usado. A malha deve conter pelo menos um vértice e uma face; uma malha vazia gera um erro. + +## Saídas + +| Nome da Saída | Descrição | Tipo de Dados | +|---------------|-------------|---------------| +| `model_3d` | Um objeto de arquivo GLB (glTF Binário) contendo a malha serializada, pronto para ser salvo ou visualizado por outros nós 3D. | FILE3D | + +> Esta documentação foi gerada por IA. Se você encontrar erros ou tiver sugestões de melhoria, sinta-se à vontade para contribuir! [Editar no GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshToFile3D/pt-BR.md) + +--- +**Source fingerprint (SHA-256):** `f004c2907c0df2e0127e49b4767d1624bf89c72665fc7028347a0b8a63a5772e` diff --git a/comfyui_embedded_docs/docs/MeshToFile3D/ru.md b/comfyui_embedded_docs/docs/MeshToFile3D/ru.md new file mode 100644 index 000000000..4d8fd3e5a --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshToFile3D/ru.md @@ -0,0 +1,22 @@ +# MeshToFile3D + +Этот узел сериализует сетку (mesh) в объект GLB-файла, который можно передать в узлы Save 3D или Preview 3D. Он сохраняет все данные сетки, включая UV-развертку, цвета, нормали, текстуру, карты нормалей/окклюзии/эмиссии и настройки материала. Используется только первый элемент мульти-элементного пакета (batch). + +## Входные параметры + +| Параметр | Описание | Тип данных | Обязательность | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `mesh` | Сетка для преобразования в GLB-файл, включая UV-развертку, цвета, нормали, текстуру, карты нормалей/окклюзии/эмиссии и материал. Поддерживается только один элемент на пакет; если пакет содержит несколько элементов, используется первый. | MESH | Да | Single mesh | + +Примечание: узел поддерживает только один элемент на пакет. Если входная сетка содержит более одного элемента в пакете, регистрируется предупреждение и используется первый элемент. Сетка должна содержать как минимум одну вершину и одну грань; пустая сетка вызывает ошибку. + +## Выходные параметры + +| Имя выхода | Описание | Тип данных | +|-------------|-------------|-----------| +| `model_3d` | Объект GLB-файла (glTF Binary), содержащий сериализованную сетку, готовый к сохранению или предпросмотру другими 3D-узлами. | FILE3D | + +> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshToFile3D/ru.md) + +--- +**Source fingerprint (SHA-256):** `f004c2907c0df2e0127e49b4767d1624bf89c72665fc7028347a0b8a63a5772e` diff --git a/comfyui_embedded_docs/docs/MeshToFile3D/tr.md b/comfyui_embedded_docs/docs/MeshToFile3D/tr.md new file mode 100644 index 000000000..f62d9352d --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshToFile3D/tr.md @@ -0,0 +1,22 @@ +# MeshToFile3D + +Bu düğüm, bir mesh'i GLB dosya nesnesine serileştirir ve bu nesne Save 3D veya Preview 3D düğümlerine aktarılabilir. UV'ler, renkler, normaller, doku, normal/occlusion/emissive haritaları ve malzeme ayarları dahil tüm mesh verilerini taşır. Çok öğeli bir grubun yalnızca ilk öğesi kullanılır. + +## Girdiler + +| Parametre | Açıklama | Veri Türü | Zorunlu | Aralık | +|-----------|-------------|-----------|----------|-------| +| `mesh` | GLB dosyasına dönüştürülecek mesh; UV'ler, renkler, normaller, doku, normal/occlusion/emissive haritaları ve malzemeyi içerir. Grup başına yalnızca bir öğe desteklenir; bir grupta birden fazla öğe varsa ilki kullanılır. | MESH | Evet | Single mesh | + +Not: Bu düğüm yalnızca grup başına bir öğeyi destekler. Girdi mesh'i, grubunda birden fazla öğe içeriyorsa bir uyarı günlüğe kaydedilir ve ilk öğe kullanılır. Mesh en az bir köşe (vertex) ve bir yüz (face) içermelidir; boş bir mesh hata verir. + +## Çıktılar + +| Çıktı Adı | Açıklama | Veri Türü | +|-------------|-------------|-----------| +| `model_3d` | Serileştirilmiş meshi içeren, diğer 3D düğümleri tarafından kaydedilmeye veya önizlenmeye hazır bir GLB (glTF Binary) dosya nesnesi. | FILE3D | + +> Bu belge yapay zeka tarafından oluşturulmuştur. Herhangi bir hata bulursanız veya iyileştirme önerileriniz varsa, katkıda bulunmaktan çekinmeyin! [GitHub'da Düzenle](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshToFile3D/tr.md) + +--- +**Source fingerprint (SHA-256):** `f004c2907c0df2e0127e49b4767d1624bf89c72665fc7028347a0b8a63a5772e` diff --git a/comfyui_embedded_docs/docs/MeshToFile3D/zh-TW.md b/comfyui_embedded_docs/docs/MeshToFile3D/zh-TW.md new file mode 100644 index 000000000..c3d67a66f --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshToFile3D/zh-TW.md @@ -0,0 +1,22 @@ +# MeshToFile3D + +此節點將網格序列化為 GLB 檔案物件,可傳遞給 Save 3D 或 Preview 3D 節點。它隨附攜帶所有網格資料,包括 UV、顏色、法線、紋理、法線/遮蔽/自發光貼圖,以及材質設定。僅會使用多項目批次中的第一個項目。 + +## 輸入 + +| 參數 | 描述 | 資料類型 | 必要 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `mesh` | 要轉換為 GLB 檔案的網格,包含 UV、顏色、法線、紋理、法線/遮蔽/自發光貼圖,以及材質。每個批次僅支援一個項目;若批次包含多個項目,則使用第一個項目。 | MESH | 是 | Single mesh | + +注意:此節點僅支援每批次一個項目。若輸入網格的批次包含多個項目,會記錄警告並使用第一個項目。網格必須至少包含一個頂點和一個面;空網格會引發錯誤。 + +## 輸出 + +| 輸出名 | 描述 | 資料類型 | +|-------------|-------------|-----------| +| `model_3d` | 包含已序列化網格的 GLB(glTF Binary)檔案物件,可準備由其他 3D 節點儲存或預覽。 | FILE3D | + +> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshToFile3D/zh-TW.md) + +--- +**Source fingerprint (SHA-256):** `f004c2907c0df2e0127e49b4767d1624bf89c72665fc7028347a0b8a63a5772e` diff --git a/comfyui_embedded_docs/docs/MeshToFile3D/zh.md b/comfyui_embedded_docs/docs/MeshToFile3D/zh.md new file mode 100644 index 000000000..53586becd --- /dev/null +++ b/comfyui_embedded_docs/docs/MeshToFile3D/zh.md @@ -0,0 +1,22 @@ +# MeshToFile3D + +此节点将网格序列化为 GLB 文件对象,该对象可传递给 Save 3D 或 Preview 3D 节点。它会携带所有网格数据,包括 UV、颜色、法线、纹理、法线/环境光遮蔽/自发光贴图以及材质设置。多项目批次中仅使用第一项。 + +## 输入 + +| 参数 | 描述 | 数据类型 | 是否必需 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `mesh` | 要转换为 GLB 文件的网格,包括 UV、颜色、法线、纹理、法线/环境光遮蔽/自发光贴图和材质。每个批次仅支持一项;如果批次包含多项,则使用第一项。 | MESH | 是 | 单个网格 | + +注意:此节点仅支持每个批次一项。如果输入网格的批次包含多项,则会记录一条警告并使用第一项。网格必须至少包含一个顶点和一个面;空网格会引发错误。 + +## 输出 + +| 输出名称 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `model_3d` | 包含已序列化网格的 GLB(glTF 二进制)文件对象,可供其他 3D 节点保存或预览。 | FILE3D | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MeshToFile3D/zh.md) + +--- +**Source fingerprint (SHA-256):** `f004c2907c0df2e0127e49b4767d1624bf89c72665fc7028347a0b8a63a5772e` diff --git a/comfyui_embedded_docs/docs/MeshyImageToModelNode/en.md b/comfyui_embedded_docs/docs/MeshyImageToModelNode/en.md index 361026db2..b19198cfb 100644 --- a/comfyui_embedded_docs/docs/MeshyImageToModelNode/en.md +++ b/comfyui_embedded_docs/docs/MeshyImageToModelNode/en.md @@ -8,28 +8,29 @@ The Meshy: Image to Model node uses the Meshy API to generate a 3D model from a | --- | --- | --- | --- | --- | | `model` | Specifies the AI model version to use for generation. | COMBO | Yes | `"latest"` | | `image` | The input image to convert into a 3D model. | IMAGE | Yes | - | -| `should_remesh` | Determines if the generated mesh should be processed. When set to `"false"`, the node returns an unprocessed triangular mesh. | DYNAMIC COMBO | Yes | `"true"`
`"false"` | +| `should_remesh` | When set to `"false"`, returns an unprocessed triangular mesh. | DYNAMIC_COMBO | Yes | `"true"`
`"false"` | | `topology` | The target polygon topology for the remeshed model. This input is only available when `should_remesh` is set to `"true"`. | COMBO | No* | `"triangle"`
`"quad"` | -| `target_polycount` | The target number of polygons for the remeshed model. This input is only available when `should_remesh` is set to `"true"`. The default value is 300000. | INT | No* | 100 - 300000 | +| `target_polycount` | The target number of polygons for the remeshed model. This input is only available when `should_remesh` is set to `"true"`. Default: 300000. | INT | No* | 100 - 300000 | | `symmetry_mode` | Controls the symmetry applied to the generated 3D model. | COMBO | Yes | `"auto"`
`"on"`
`"off"` | -| `should_texture` | Determines whether textures are generated for the model. Setting it to `"false"` skips the texture phase and returns a mesh without textures. | DYNAMIC COMBO | Yes | `"true"`
`"false"` | -| `enable_pbr` | When `should_texture` is `"true"`, this option generates PBR maps (metallic, roughness, normal) in addition to the base color. The default value is `False`. | BOOLEAN | No* | - | -| `texture_prompt` | A text prompt to guide the texturing process (maximum 600 characters). This input is only available when `should_texture` is `"true"`. It cannot be used at the same time as `texture_image`. | STRING | No* | - | -| `texture_image` | An image to guide the texturing process. This input is only available when `should_texture` is `"true"`. It cannot be used at the same time as `texture_prompt`. | IMAGE | No* | - | -| `pose_mode` | Specifies the pose mode for the generated model. This is an advanced parameter. | COMBO | Yes | `""` (empty)
`"A-pose"`
`"T-pose"` | -| `seed` | A seed value for the generation process. The results are non-deterministic regardless of the seed value. The default value is 0. | INT | Yes | 0 - 2147483647 | +| `should_texture` | Determines whether textures are generated. Setting it to `"false"` skips the texture phase and returns a mesh without textures. | DYNAMIC_COMBO | Yes | `"true"`
`"false"` | +| `enable_pbr` | Generate PBR Maps (metallic, roughness, normal) in addition to the base color. This input is only available when `should_texture` is set to `"true"`. Default: `False`. | BOOLEAN | No* | - | +| `texture_prompt` | Provide a text prompt to guide the texturing process. Maximum 600 characters. Cannot be used at the same time as `texture_image`. This input is only available when `should_texture` is set to `"true"`. Default: empty string. | STRING | No* | - | +| `texture_image` | Only one of `texture_image` or `texture_prompt` may be used at the same time. This input is only available when `should_texture` is set to `"true"`. | IMAGE | No* | - | +| `pose_mode` | Specify the pose mode for the generated model. This is an advanced parameter. | COMBO | Yes | `""` (empty)
`"A-pose"`
`"T-pose"` | +| `seed` | Seed controls whether the node should re-run; results are non-deterministic regardless of seed. Default: 0. | INT | Yes | 0 - 2147483647 | **Note on Parameter Constraints:** * The `topology` and `target_polycount` inputs are only available when `should_remesh` is set to `"true"`. * The `enable_pbr`, `texture_prompt`, and `texture_image` inputs are only available when `should_texture` is set to `"true"`. -* You cannot use `texture_prompt` and `texture_image` at the same time. If both are provided when `should_texture` is `"true"`, the node will raise an error. +* When `should_texture` is set to `"true"`, `texture_prompt` and `texture_image` cannot be used at the same time. If both are provided, the node raises an error. +* `texture_prompt` has a maximum length of 600 characters. ## Outputs | Output Name | Description | Data Type | | --- | --- | --- | -| `model_file` | The filename of the generated GLB model. (Maintained for backward compatibility). | STRING | +| `model_file` | The filename of the generated GLB model. Maintained for backward compatibility only. | STRING | | `meshy_task_id` | The unique identifier for the Meshy API task, which can be used for reference or troubleshooting. | MESHY_TASK_ID | | `GLB` | The generated 3D model in the GLB file format. | FILE3DGLB | | `FBX` | The generated 3D model in the FBX file format. | FILE3DFBX | diff --git a/comfyui_embedded_docs/docs/MeshyMultiImageToModelNode/en.md b/comfyui_embedded_docs/docs/MeshyMultiImageToModelNode/en.md index 4d078c6df..d76a3f9d2 100644 --- a/comfyui_embedded_docs/docs/MeshyMultiImageToModelNode/en.md +++ b/comfyui_embedded_docs/docs/MeshyMultiImageToModelNode/en.md @@ -4,33 +4,51 @@ This node uses the Meshy API to generate a 3D model from multiple input images. ## Inputs +### Common Inputs + | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | | `model` | Specifies the AI model version to use. | COMBO | Yes | `"latest"` | -| `images` | A set of images used to generate the 3D model. You must provide between 2 and 4 images. | IMAGE | Yes | 2 to 4 images | -| `should_remesh` | Determines if the generated mesh should be processed. When set to `"false"`, the node returns an unprocessed triangular mesh. | COMBO | Yes | `"true"`
`"false"` | -| `topology` | The target polygon type for the remeshed output. This parameter is only available when `should_remesh` is set to `"true"`. | COMBO | No | `"triangle"`
`"quad"` | -| `target_polycount` | The target number of polygons for the remeshed model (default: 300000). This parameter is only available when `should_remesh` is set to `"true"`. | INT | No | 100 to 300000 | +| `should_remesh` | Determines if the generated mesh should be processed. When set to `"false"`, the node returns an unprocessed triangular mesh. When set to `"true"`, the remesh settings below are shown. | DYNAMIC_COMBO | Yes | `"true"`
`"false"` | | `symmetry_mode` | Controls whether symmetry is applied to the generated model. | COMBO | Yes | `"auto"`
`"on"`
`"off"` | -| `should_texture` | Determines whether textures are generated. Setting it to `"false"` skips the texture phase and returns a mesh without textures. | COMBO | Yes | `"true"`
`"false"` | -| `enable_pbr` | When `should_texture` is `"true"`, this option generates PBR Maps (metallic, roughness, normal) in addition to the base color (default: False). | BOOLEAN | No | True / False | -| `texture_prompt` | A text prompt to guide the texturing process (maximum 600 characters). Cannot be used at the same time as `texture_image`. This parameter is only available when `should_texture` is set to `"true"`. | STRING | No | - | -| `texture_image` | An image to guide the texturing process. Only one of `texture_image` or `texture_prompt` may be used at the same time. This parameter is only available when `should_texture` is set to `"true"`. | IMAGE | No | - | -| `pose_mode` | Specifies the pose mode for the generated model. | COMBO | Yes | `""` (empty)
`"A-pose"`
`"T-pose"` | -| `seed` | A seed value for the generation process (default: 0). Results are non-deterministic regardless of the seed, but changing the seed can trigger the node to re-run. | INT | Yes | 0 to 2147483647 | +| `should_texture` | Determines whether textures are generated. Setting it to `"false"` skips the texture phase and returns a mesh without textures. When set to `"true"`, the texture settings below are shown. | DYNAMIC_COMBO | Yes | `"true"`
`"false"` | +| `pose_mode` | Specify the pose mode for the generated model. | COMBO | Yes | `""` (empty)
`"A-pose"`
`"T-pose"` | +| `seed` | Seed controls whether the node should re-run; results are non-deterministic regardless of seed. (default: 0) | INT | Yes | 0 to 2147483647 | + +### Remesh Settings (visible when `should_remesh` is set to `"true"`) + +| Parameter | Description | Data Type | Required | Range | +| --- | --- | --- | --- | --- | +| `topology` | The target polygon type for the remeshed output. | COMBO | No | `"triangle"`
`"quad"` | +| `target_polycount` | The target number of polygons for the remeshed model (default: 300000). | INT | No | 100 to 300000 | + +### Texture Settings (visible when `should_texture` is set to `"true"`) + +| Parameter | Description | Data Type | Required | Range | +| --- | --- | --- | --- | --- | +| `enable_pbr` | Generate PBR Maps (metallic, roughness, normal) in addition to the base color. (default: False) | BOOLEAN | No | True / False | +| `texture_prompt` | Provide a text prompt to guide the texturing process. Maximum 600 characters. Cannot be used at the same time as `texture_image`. (default: empty) | STRING | No | - | +| `texture_image` | Only one of `texture_image` or `texture_prompt` may be used at the same time. | IMAGE | No | - | + +### Image Inputs + +| Parameter | Description | Data Type | Required | Range | +| --- | --- | --- | --- | --- | +| `images` | Growable slot: connect 2 to 4 input images (`image_1`, `image_2`, `image_3`, `image_4`). These images are used to generate the 3D model. | IMAGE | Yes | 2 to 4 images | -**Parameter Constraints:** +**Notes** * You must provide between 2 and 4 images for the `images` input. * The `topology` and `target_polycount` parameters are only active when `should_remesh` is set to `"true"`. * The `enable_pbr`, `texture_prompt`, and `texture_image` parameters are only active when `should_texture` is set to `"true"`. -* You cannot use `texture_prompt` and `texture_image` at the same time; they are mutually exclusive. +* `texture_prompt` and `texture_image` are mutually exclusive; you cannot use both at the same time. `texture_prompt` is limited to 600 characters. +* The `seed` value does not make results deterministic; changing it simply causes the node to re-run the generation task. ## Outputs | Output Name | Description | Data Type | | --- | --- | --- | -| `model_file` | The filename of the generated GLB model. This output is provided for backward compatibility. | STRING | +| `model_file` | The filename of the generated GLB model. This output is provided for backward compatibility only. | STRING | | `meshy_task_id` | The unique identifier for the Meshy API task. | MESHY_TASK_ID | | `GLB` | The generated 3D model in GLB format. | FILE3DGLB | | `FBX` | The generated 3D model in FBX format. | FILE3DFBX | diff --git a/comfyui_embedded_docs/docs/MeshyTextToModelNode/en.md b/comfyui_embedded_docs/docs/MeshyTextToModelNode/en.md index de8ad3965..f66aefbd7 100644 --- a/comfyui_embedded_docs/docs/MeshyTextToModelNode/en.md +++ b/comfyui_embedded_docs/docs/MeshyTextToModelNode/en.md @@ -9,12 +9,12 @@ The Meshy: Text to Model node uses the Meshy API to generate a 3D model from a t | `model` | Specifies the AI model version to use. Currently, only the "latest" version is available. | COMBO | Yes | `"latest"` | | `prompt` | The text description of the 3D model you want to generate. Must be between 1 and 600 characters long. | STRING | Yes | - | | `style` | The artistic style for the generated 3D model. | COMBO | Yes | `"realistic"`
`"sculpture"` | -| `should_remesh` | Controls whether the generated mesh is processed. When set to "false", the node returns an unprocessed triangular mesh. Selecting "true" reveals additional parameters for topology and polycount. | DYNAMIC COMBO | Yes | `"true"`
`"false"` | +| `should_remesh` | Controls whether the generated mesh is processed. When set to "false", the node returns an unprocessed triangular mesh. Selecting "true" reveals additional parameters for topology and polycount. | DYNAMIC_COMBO | Yes | `"true"`
`"false"` | | `topology` | The target polygon type for the remeshed model. This parameter is only available when `should_remesh` is set to "true". | COMBO | No* | `"triangle"`
`"quad"` | | `target_polycount` | The target number of polygons for the remeshed model. Default is 300000. This parameter is only available when `should_remesh` is set to "true". | INT | No* | 100 - 300000 | -| `symmetry_mode` | Controls symmetry in the generated model. | COMBO | Yes | `"auto"`
`"on"`
`"off"` | -| `pose_mode` | Specifies the pose mode for the generated model. An empty string means no specific pose is requested. | COMBO | Yes | `""`
`"A-pose"`
`"T-pose"` | -| `seed` | A seed value for generation. Setting this controls whether the node should re-run, but results are non-deterministic regardless of the seed value. Default is 0. | INT | Yes | 0 - 2147483647 | +| `symmetry_mode` | Controls symmetry in the generated model. This is an advanced parameter. | COMBO | Yes | `"auto"`
`"on"`
`"off"` | +| `pose_mode` | Specify the pose mode for the generated model. An empty string means no specific pose is requested. This is an advanced parameter. | COMBO | Yes | `""`
`"A-pose"`
`"T-pose"` | +| `seed` | Seed controls whether the node should re-run; results are non-deterministic regardless of seed. Default is 0. | INT | Yes | 0 - 2147483647 | *Note: The `topology` and `target_polycount` parameters are conditionally available. They only appear when the `should_remesh` parameter is set to "true". diff --git a/comfyui_embedded_docs/docs/MiniMaxH3ImageToVideo/en.md b/comfyui_embedded_docs/docs/MiniMaxH3ImageToVideo/en.md index 90dd83989..47db3704f 100644 --- a/comfyui_embedded_docs/docs/MiniMaxH3ImageToVideo/en.md +++ b/comfyui_embedded_docs/docs/MiniMaxH3ImageToVideo/en.md @@ -15,16 +15,16 @@ This node prepares the conditioning and empty latent needed to generate a video | `first_frame` | Optional image used as the first frame of the video. It is stretched to the full canvas size, so its aspect ratio is not preserved. Only the first image of the input batch is used. | IMAGE | No | | | `last_frame` | Optional image used as the last frame of the video. It is cropped to cover the canvas while preserving its aspect ratio. Only the first image of the input batch is used. | IMAGE | No | | -When `first_frame` and/or `last_frame` are provided, the keyframe images are encoded with the VAE and attached to the conditioning at frame 0 and at the final frame, respectively. When neither is provided, the node works from the prompt alone. +When `first_frame` and/or `last_frame` are provided, the keyframe images are encoded with the VAE and attached to the conditioning at frame 0 and at the final frame, respectively. When neither is provided, the node works from the prompt alone. The requested `length` is snapped up to the nearest valid frame count (17k + 5), so the effective frame count may be slightly higher than requested. ## Outputs | Output Name | Description | Data Type | |-------------|-------------|-----------| | `positive` | Conditioning containing the encoded prompt and, when keyframe images are provided, the encoded keyframes and frame count for the MiniMax H3 model. | CONDITIONING | -| `latent` | Empty latent representing the video to be generated, with the requested width, height, and frame count. | LATENT | +| `latent` | Empty audio-video latent representing the content to be generated, with the requested width, height, and frame count. | LATENT | > This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MiniMaxH3ImageToVideo/en.md) --- -**Source fingerprint (SHA-256):** `46efc87bd46f4a86cb6df37c75f960419a2a98b34480e7dc0023c9d87903870b` +**Source fingerprint (SHA-256):** `d1bdf3f8c66ef20ff11c35203d2c266a88dcf8cc00c65dbb0aea2b1dd16befd6` diff --git a/comfyui_embedded_docs/docs/MiniMaxH3ReferenceToVideo/en.md b/comfyui_embedded_docs/docs/MiniMaxH3ReferenceToVideo/en.md index 1ea217a55..ddd5838c5 100644 --- a/comfyui_embedded_docs/docs/MiniMaxH3ReferenceToVideo/en.md +++ b/comfyui_embedded_docs/docs/MiniMaxH3ReferenceToVideo/en.md @@ -1,6 +1,6 @@ # MiniMax H3 Reference to Video -MiniMax H3 Reference to Video creates the text conditioning and the empty video latent needed for MiniMax H3 reference-to-video generation. You provide a prompt plus optional reference images, videos, and audio clips, and the node encodes these references into tokens the model can use while generating. The prompt refers to the references with ``, `