diff --git a/comfyui_embedded_docs/docs/AdjustBrightness/ar.md b/comfyui_embedded_docs/docs/AdjustBrightness/ar.md index 3db08830b..bec478299 100644 --- a/comfyui_embedded_docs/docs/AdjustBrightness/ar.md +++ b/comfyui_embedded_docs/docs/AdjustBrightness/ar.md @@ -1,19 +1,21 @@ # ضبط السطوع -تعدّل عقدة «Adjust Brightness» سطوع صورة الإدخال. تعمل عن طريق ضرب قيمة كل بكسل في عامل محدد، ثم قصّ القيم الناتجة لتظل ضمن نطاق صالح. العامل 1.0 يُبقي الصورة دون تغيير، والقيم الأقل من 1.0 تجعلها أغمق، والقيم الأعلى من 1.0 تجعلها أكثر سطوعًا. إذا كانت صورة الإدخال تحتوي على قناة ألفا، فإنها تمر دون تغيير للحفاظ على الشفافية. +تعمل عقدة Adjust Brightness على تغيير مدى سطوع الصورة. فهي تضرب قيم ألوان الصورة في `factor` وتُبقي النتائج ضمن النطاق الصحيح من 0.0 إلى 1.0. عندما يساوي المعامل 1.0 تبقى الصورة دون تغيير، والقيم الأقل من 1.0 تجعلها أغمق، والقيم الأعلى من 1.0 تجعلها أكثر سطوعًا. ## المدخلات | المعامل | الوصف | نوع البيانات | مطلوب | النطاق | | --- | --- | --- | --- | --- | -| `image` | صورة الإدخال المراد تعديلها. | IMAGE | نعم | - | -| `عامل السطوع` | عامل السطوع. 1.0 = بدون تغيير، <1.0 = أغمق، >1.0 = أكثر سطوعًا. (الافتراضي: 1.0) | FLOAT | لا | 0.0 - 2.0 | +| `image` | صورة الإدخال المراد ضبطها. تقبل صورة واحدة أو دفعة من الصور. | IMAGE | نعم | - | +| `عامل السطوع` | معامل السطوع. 1.0 = بدون تغيير، <1.0 = أغمق، >1.0 = أكثر سطوعًا. (الافتراضي: 1.0) | FLOAT | لا | 0.0 - 2.0 | + +ملاحظة: إذا كانت صورة الإدخال تحتوي على قناة ألفا (RGBA)، فسيتم ضبط قنوات الألوان فقط. تُنسخ قناة ألفا من الإدخال دون تغيير لأنها تخزّن الشفافية، وليس اللون. ## المخرجات -| اسم المخرَج | الوصف | نوع البيانات | +| اسم الإخراج | الوصف | نوع البيانات | | --- | --- | --- | -| `الصور` | صورة الإخراج مع سطوع معدَّل. | IMAGE | +| `الصور` | صورة الإخراج ذات السطوع المُعدَّل. إذا كانت الصورة المدخلة تحتوي على قناة ألفا، تظل قيم ألفا دون تغيير. | IMAGE | > تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/AdjustBrightness/ar.md) diff --git a/comfyui_embedded_docs/docs/AdjustBrightness/en.md b/comfyui_embedded_docs/docs/AdjustBrightness/en.md index da9fc9925..78772868e 100644 --- a/comfyui_embedded_docs/docs/AdjustBrightness/en.md +++ b/comfyui_embedded_docs/docs/AdjustBrightness/en.md @@ -1,19 +1,21 @@ # Adjust Brightness -The Adjust Brightness node modifies the brightness of an input image. It works by multiplying each pixel's value by a specified factor, then clamping the resulting values to stay within a valid range. A factor of 1.0 leaves the image unchanged, values below 1.0 make it darker, and values above 1.0 make it brighter. If the input image has an alpha channel, the alpha channel is passed through unchanged so transparency is preserved. +The Adjust Brightness node changes how bright an image looks. It multiplies the image's color values by a `factor` and keeps the results within the valid 0.0 to 1.0 range. A factor of 1.0 leaves the image unchanged, values below 1.0 make it darker, and values above 1.0 make it brighter. ## Inputs | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `image` | The input image to adjust. | IMAGE | Yes | - | +| `image` | The input image to adjust. Accepts a single image or a batch of images. | IMAGE | Yes | - | | `factor` | Brightness factor. 1.0 = no change, <1.0 = darker, >1.0 = brighter. (default: 1.0) | FLOAT | No | 0.0 - 2.0 | +Note: If the input image has an alpha channel (RGBA), only the color channels are adjusted. The alpha channel is copied from the input unchanged because it stores transparency, not color. + ## Outputs | Output Name | Description | Data Type | | --- | --- | --- | -| `image` | The output image with adjusted brightness. | IMAGE | +| `image` | The output image with adjusted brightness. If the input has an alpha channel, the alpha values remain unchanged. | 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/AdjustBrightness/en.md) diff --git a/comfyui_embedded_docs/docs/AdjustBrightness/es.md b/comfyui_embedded_docs/docs/AdjustBrightness/es.md index 42d723139..27ad7b79e 100644 --- a/comfyui_embedded_docs/docs/AdjustBrightness/es.md +++ b/comfyui_embedded_docs/docs/AdjustBrightness/es.md @@ -1,19 +1,21 @@ # Ajustar brillo -El nodo Adjust Brightness modifica el brillo de una imagen de entrada. Funciona multiplicando el valor de cada píxel por un factor especificado y luego limitando los valores resultantes para que se mantengan dentro de un rango válido. Un factor de 1.0 deja la imagen sin cambios, los valores inferiores a 1.0 la oscurecen y los valores superiores a 1.0 la aclaran. Si la imagen de entrada tiene un canal alfa, este se mantiene sin cambios para preservar la transparencia. +El nodo Adjust Brightness cambia el brillo de una imagen. Multiplica los valores de color de la imagen por un `factor` y mantiene los resultados dentro del rango válido de 0.0 a 1.0. Un factor de 1.0 deja la imagen sin cambios, los valores inferiores a 1.0 la oscurecen y los valores superiores a 1.0 la hacen más brillante. ## Entradas | Parámetro | Descripción | Tipo de datos | Requerido | Rango | | --- | --- | --- | --- | --- | -| `image` | La imagen de entrada a ajustar. | IMAGE | Sí | - | +| `image` | La imagen de entrada a ajustar. Acepta una sola imagen o un lote de imágenes. | IMAGE | Sí | - | | `factor` | Factor de brillo. 1.0 = sin cambios, <1.0 = más oscuro, >1.0 = más brillante. (predeterminado: 1.0) | FLOAT | No | 0.0 - 2.0 | +Nota: Si la imagen de entrada tiene un canal alfa (RGBA), solo se ajustan los canales de color. El canal alfa se copia de la entrada sin cambios porque almacena transparencia, no color. + ## Salidas | Nombre de salida | Descripción | Tipo de datos | | --- | --- | --- | -| `imágenes` | La imagen de salida con el brillo ajustado. | IMAGE | +| `imágenes` | La imagen de salida con el brillo ajustado. Si la entrada tiene un canal alfa, los valores alfa permanecen sin cambios. | 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/AdjustBrightness/es.md) diff --git a/comfyui_embedded_docs/docs/AdjustBrightness/fa.md b/comfyui_embedded_docs/docs/AdjustBrightness/fa.md index 1093f1b0d..4ab50a68a 100644 --- a/comfyui_embedded_docs/docs/AdjustBrightness/fa.md +++ b/comfyui_embedded_docs/docs/AdjustBrightness/fa.md @@ -1,19 +1,21 @@ # تنظیم روشنایی -گره تنظیم روشنایی، روشنایی یک تصویر ورودی را تغییر می‌دهد. این کار با ضرب کردن مقدار هر پیکسل در یک ضریب مشخص انجام می‌شود و سپس مقادیر به‌دست‌آمده برای باقی‌ماندن در محدوده‌ی معتبر، محدود (clamp) می‌شوند. ضریب 1.0 تصویر را بدون تغییر می‌گذارد، مقادیر کمتر از 1.0 آن را تیره‌تر و مقادیر بیشتر از 1.0 آن را روشن‌تر می‌کنند. اگر تصویر ورودی کانال آلفا داشته باشد، کانال آلفا بدون تغییر منتقل می‌شود تا شفافیت حفظ شود. +گره Adjust Brightness روشنایی ظاهری تصویر را تغییر می‌دهد. مقادیر رنگ تصویر را در `factor` ضرب می‌کند و نتایج را در محدوده معتبر 0.0 تا 1.0 نگه می‌دارد. ضریب 1.0 تصویر را بدون تغییر می‌گذارد، مقادیر کمتر از 1.0 آن را تیره‌تر و مقادیر بیشتر از 1.0 آن را روشن‌تر می‌کنند. ## ورودی‌ها | پارامتر | توضیحات | نوع داده | الزامی | محدوده | | --- | --- | --- | --- | --- | -| `image` | تصویر ورودی برای تنظیم. | IMAGE | بله | - | -| `ضریب` | ضریب روشنایی. 1.0 = بدون تغییر، <1.0 = تیره‌تر، >1.0 = روشن‌تر. (پیش‌فرض: 1.0) | FLOAT | خیر | 0.0 - 2.0 | +| `image` | تصویر ورودی برای تنظیم. یک تصویر یا یک دسته تصویر را می‌پذیرد. | IMAGE | بله | - | +| `ضریب` | ضریب روشنایی. 1.0 = بدون تغییر، کمتر از 1.0 = تیره‌تر، بیشتر از 1.0 = روشن‌تر. (پیش‌فرض: 1.0) | FLOAT | خیر | 0.0 - 2.0 | + +توجه: اگر تصویر ورودی دارای کانال آلفا (RGBA) باشد، فقط کانال‌های رنگ تنظیم می‌شوند. کانال آلفا بدون تغییر از ورودی کپی می‌شود، زیرا شفافیت را ذخیره می‌کند، نه رنگ را. ## خروجی‌ها | نام خروجی | توضیحات | نوع داده | | --- | --- | --- | -| `تصاویر` | تصویر خروجی با روشنایی تنظیم‌شده. | IMAGE | +| `تصاویر` | تصویر خروجی با روشنایی تنظیم‌شده. اگر ورودی دارای کانال آلفا باشد، مقادیر آلفا بدون تغییر باقی می‌مانند. | IMAGE | > این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/AdjustBrightness/fa.md) diff --git a/comfyui_embedded_docs/docs/AdjustBrightness/fr.md b/comfyui_embedded_docs/docs/AdjustBrightness/fr.md index bfb93791a..fa88b4b99 100644 --- a/comfyui_embedded_docs/docs/AdjustBrightness/fr.md +++ b/comfyui_embedded_docs/docs/AdjustBrightness/fr.md @@ -1,19 +1,21 @@ # Ajuster la luminosité -Le nœud Adjust Brightness modifie la luminosité d'une image d'entrée. Il fonctionne en multipliant la valeur de chaque pixel par un facteur spécifié, puis en limitant les valeurs résultantes pour qu'elles restent dans une plage valide. Un facteur de 1.0 laisse l'image inchangée, les valeurs inférieures à 1.0 l'assombrissent, et les valeurs supérieures à 1.0 l'éclaircissent. Si l'image d'entrée possède un canal alpha, celui-ci est conservé tel quel afin de préserver la transparence. +Le nœud Adjust Brightness modifie la luminosité apparente d'une image. Il multiplie les valeurs de couleur de l'image par un facteur `factor` et conserve les résultats dans la plage valide de 0.0 à 1.0. Un facteur de 1.0 laisse l'image inchangée, les valeurs inférieures à 1.0 l'assombrissent, et les valeurs supérieures à 1.0 l'éclaircissent. ## Entrées | Paramètre | Description | Type de données | Requis | Plage | | --- | --- | --- | --- | --- | -| `image` | L'image d'entrée à ajuster. | IMAGE | Oui | - | -| `facteur` | Facteur de luminosité. 1.0 = aucun changement, <1.0 = plus sombre, >1.0 = plus clair. (défaut : 1.0) | FLOAT | Non | 0.0 - 2.0 | +| `image` | L'image d'entrée à ajuster. Accepte une image unique ou un lot d'images. | IMAGE | Oui | - | +| `facteur` | Facteur de luminosité. 1.0 = aucun changement, <1.0 = plus sombre, >1.0 = plus clair. (valeur par défaut : 1.0) | FLOAT | Non | 0.0 - 2.0 | + +Remarque : si l'image d'entrée possède un canal alpha (RGBA), seuls les canaux de couleur sont ajustés. Le canal alpha est copié depuis l'entrée sans modification, car il stocke la transparence, pas la couleur. ## Sorties | Nom de sortie | Description | Type de données | | --- | --- | --- | -| `images` | L'image de sortie avec une luminosité ajustée. | IMAGE | +| `images` | L'image de sortie avec la luminosité ajustée. Si l'entrée possède un canal alpha, les valeurs alpha restent inchangées. | 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/AdjustBrightness/fr.md) diff --git a/comfyui_embedded_docs/docs/AdjustBrightness/ja.md b/comfyui_embedded_docs/docs/AdjustBrightness/ja.md index 684360126..6e36dc751 100644 --- a/comfyui_embedded_docs/docs/AdjustBrightness/ja.md +++ b/comfyui_embedded_docs/docs/AdjustBrightness/ja.md @@ -1,19 +1,21 @@ # 明るさを調整 -Adjust Brightness ノードは、入力画像の明るさを調整します。各ピクセルの値に指定された係数を乗算し、その結果の値を有効な範囲内に収めるようにクランプすることで動作します。係数が 1.0 の場合は画像は変更されず、1.0 未満の値では暗くなり、1.0 を超える値では明るくなります。入力画像にアルファチャンネルがある場合、アルファチャンネルは変更されずにそのまま維持され、透明度が保持されます。 +Adjust Brightness ノードは、画像の明るさの見え方を変更します。画像のカラー値を `factor` で乗算し、結果が有効な 0.0〜1.0 の範囲内に収まるようにします。係数が 1.0 の場合、画像は変化しません。1.0 未満の値では暗くなり、1.0 を超える値では明るくなります。 ## 入力 | パラメータ | 説明 | データ型 | 必須 | 範囲 | | --- | --- | --- | --- | --- | -| `image` | 調整する入力画像。 | IMAGE | はい | - | -| `係数` | 明るさ係数。1.0 = 変更なし、<1.0 = 暗く、>1.0 = 明るく。(デフォルト: 1.0) | FLOAT | いいえ | 0.0 - 2.0 | +| `image` | 調整する入力画像。単一の画像または画像のバッチを受け入れます。 | IMAGE | はい | - | +| `係数` | 明るさ係数。1.0 = 変化なし、<1.0 = 暗く、>1.0 = 明るく。(デフォルト:1.0) | FLOAT | いいえ | 0.0 - 2.0 | + +注:入力画像にアルファチャンネル(RGBA)がある場合、色チャンネルのみが調整されます。アルファチャンネルは色ではなく透明度を格納するため、入力から変更されずにコピーされます。 ## 出力 | 出力名 | 説明 | データ型 | | --- | --- | --- | -| `画像` | 明るさが調整された出力画像。 | IMAGE | +| `画像` | 明るさが調整された出力画像。入力にアルファチャンネルがある場合、アルファ値は変更されません。 | IMAGE | > このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/AdjustBrightness/ja.md) diff --git a/comfyui_embedded_docs/docs/AdjustBrightness/ko.md b/comfyui_embedded_docs/docs/AdjustBrightness/ko.md index 61e0d9021..f1561350e 100644 --- a/comfyui_embedded_docs/docs/AdjustBrightness/ko.md +++ b/comfyui_embedded_docs/docs/AdjustBrightness/ko.md @@ -1,19 +1,21 @@ # 밝기 조정 -Adjust Brightness 노드는 입력 이미지의 밝기를 조정합니다. 각 픽셀의 값에 지정된 계수를 곱한 다음 결과 값을 유효 범위 내에 유지하도록 클램핑하는 방식으로 작동합니다. 계수가 1.0이면 이미지가 변경되지 않고, 1.0 미만이면 더 어두워지며, 1.0 초과이면 더 밝아집니다. 입력 이미지에 알파 채널이 있는 경우 알파 채널은 변경되지 않고 그대로 유지되어 투명도가 보존됩니다. +Adjust Brightness 노드는 이미지의 밝기를 조정합니다. 이미지의 색상 값에 `factor`를 곱하고 결과가 유효한 0.0~1.0 범위 내에 유지되도록 합니다. factor가 1.0이면 이미지가 변경되지 않고, 1.0보다 낮으면 더 어두워지며, 1.0보다 높으면 더 밝아집니다. ## 입력 | 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | | --- | --- | --- | --- | --- | -| `image` | 조정할 입력 이미지입니다. | IMAGE | 예 | - | -| `factor` | 밝기 계수입니다. 1.0 = 변경 없음, <1.0 = 더 어두움, >1.0 = 더 밝음. (기본값: 1.0) | FLOAT | 아니오 | 0.0 - 2.0 | +| `image` | 조정할 입력 이미지입니다. 단일 이미지 또는 이미지 배치(batch)를 허용합니다. | IMAGE | 예 | - | +| `factor` | 밝기 배율입니다. 1.0 = 변경 없음, <1.0 = 더 어두움, >1.0 = 더 밝음. (기본값: 1.0) | FLOAT | 아니요 | 0.0 - 2.0 | + +참고: 입력 이미지에 알파 채널(RGBA)이 있는 경우 색상 채널만 조정됩니다. 알파 채널은 색상이 아닌 투명도를 저장하므로 입력에서 변경 없이 그대로 복사됩니다. ## 출력 | 출력 이름 | 설명 | 데이터 타입 | | --- | --- | --- | -| `images` | 밝기가 조정된 출력 이미지입니다. | IMAGE | +| `images` | 밝기가 조정된 출력 이미지입니다. 입력에 알파 채널이 있는 경우 알파 값은 변경되지 않습니다. | IMAGE | > 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/AdjustBrightness/ko.md) diff --git a/comfyui_embedded_docs/docs/AdjustBrightness/pt-BR.md b/comfyui_embedded_docs/docs/AdjustBrightness/pt-BR.md index 52d9087ca..7904af37c 100644 --- a/comfyui_embedded_docs/docs/AdjustBrightness/pt-BR.md +++ b/comfyui_embedded_docs/docs/AdjustBrightness/pt-BR.md @@ -1,19 +1,21 @@ # Ajustar Brilho -O nó Adjust Brightness modifica o brilho de uma imagem de entrada. Ele funciona multiplicando o valor de cada pixel por um fator especificado e, em seguida, limitando os valores resultantes para permanecerem dentro de um intervalo válido. Um fator de 1.0 mantém a imagem inalterada, valores abaixo de 1.0 a tornam mais escura e valores acima de 1.0 a tornam mais brilhante. Se a imagem de entrada tiver um canal alfa, ele será mantido inalterado para preservar a transparência. +O nó Adjust Brightness modifica o quão brilhante uma imagem parece. Ele multiplica os valores de cor da imagem por um `factor` e mantém os resultados dentro do intervalo válido de 0.0 a 1.0. Um fator de 1.0 deixa a imagem inalterada, valores abaixo de 1.0 a deixam mais escura e valores acima de 1.0 a deixam mais clara. ## Entradas -| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Faixa | +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | | --- | --- | --- | --- | --- | -| `image` | A imagem de entrada para ajustar. | IMAGE | Sim | - | -| `fator` | Fator de brilho. 1.0 = sem alteração, <1.0 = mais escura, >1.0 = mais brilhante. (padrão: 1.0) | FLOAT | Não | 0.0 - 2.0 | +| `image` | A imagem de entrada para ajustar. Aceita uma única imagem ou um lote de imagens. | IMAGE | Sim | - | +| `fator` | Fator de brilho. 1.0 = sem alteração, <1.0 = mais escura, >1.0 = mais clara. (padrão: 1.0) | FLOAT | Não | 0.0 - 2.0 | + +Observação: Se a imagem de entrada tiver um canal alfa (RGBA), apenas os canais de cor serão ajustados. O canal alfa é copiado da entrada sem alterações, pois ele armazena transparência, não cor. ## Saídas | Nome da Saída | Descrição | Tipo de Dados | | --- | --- | --- | -| `imagens` | A imagem de saída com brilho ajustado. | IMAGE | +| `imagens` | A imagem de saída com o brilho ajustado. Se a entrada tiver um canal alfa, os valores alfa permanecem inalterados. | 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/AdjustBrightness/pt-BR.md) diff --git a/comfyui_embedded_docs/docs/AdjustBrightness/ru.md b/comfyui_embedded_docs/docs/AdjustBrightness/ru.md index 5449a00ff..97c359e0e 100644 --- a/comfyui_embedded_docs/docs/AdjustBrightness/ru.md +++ b/comfyui_embedded_docs/docs/AdjustBrightness/ru.md @@ -1,19 +1,21 @@ # Регулировка яркости -Узел Adjust Brightness изменяет яркость входного изображения. Он работает путём умножения значения каждого пикселя на заданный коэффициент, а затем ограничивает полученные значения, чтобы они оставались в допустимом диапазоне. Коэффициент 1.0 оставляет изображение без изменений, значения ниже 1.0 делают его темнее, а значения выше 1.0 — ярче. Если входное изображение содержит альфа-канал, он передаётся без изменений, сохраняя прозрачность. +Узел Adjust Brightness изменяет яркость изображения. Он умножает цветовые значения изображения на `factor` и удерживает результат в допустимом диапазоне от 0.0 до 1.0. Коэффициент 1.0 оставляет изображение без изменений, значения ниже 1.0 делают его темнее, а значения выше 1.0 — ярче. ## Входы | Параметр | Описание | Тип данных | Обязательный | Диапазон | | --- | --- | --- | --- | --- | -| `image` | Входное изображение для настройки. | IMAGE | Да | - | +| `image` | Входное изображение для корректировки. Принимает одно изображение или пакет изображений. | IMAGE | Да | - | | `коэффициент` | Коэффициент яркости. 1.0 = без изменений, <1.0 = темнее, >1.0 = ярче. (по умолчанию: 1.0) | FLOAT | Нет | 0.0 - 2.0 | +Примечание: Если входное изображение имеет альфа-канал (RGBA), корректируются только цветовые каналы. Альфа-канал копируется из входа без изменений, так как он хранит прозрачность, а не цвет. + ## Выходы | Имя выхода | Описание | Тип данных | | --- | --- | --- | -| `изображения` | Выходное изображение с отрегулированной яркостью. | IMAGE | +| `изображения` | Выходное изображение с скорректированной яркостью. Если входное изображение имеет альфа-канал, значения альфа остаются без изменений. | IMAGE | > Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/AdjustBrightness/ru.md) diff --git a/comfyui_embedded_docs/docs/AdjustBrightness/tr.md b/comfyui_embedded_docs/docs/AdjustBrightness/tr.md index 13d06caca..c1a0923ae 100644 --- a/comfyui_embedded_docs/docs/AdjustBrightness/tr.md +++ b/comfyui_embedded_docs/docs/AdjustBrightness/tr.md @@ -1,19 +1,21 @@ # Parlaklığı Ayarla -Adjust Brightness düğümü, bir girdi görüntüsünün parlaklığını değiştirir. Her pikselin değerini belirtilen bir faktörle çarparak ve ardından sonuç değerlerini geçerli bir aralıkta kalacak şekilde sınırlayarak çalışır. 1.0 faktörü görüntüyü değiştirmez, 1.0'ın altındaki değerler onu koyulaştırır ve 1.0'ın üzerindeki değerler onu aydınlatır. Girdi görüntüsü bir alfa kanalı içeriyorsa, şeffaflığı korumak için alfa kanalı değiştirilmeden aktarılır. +Adjust Brightness düğümü, bir görüntünün ne kadar parlak göründüğünü değiştirir. Görüntünün renk değerlerini bir `factor` ile çarpar ve sonuçları geçerli 0.0 ile 1.0 aralığında tutar. 1.0 faktörü görüntüyü olduğu gibi bırakır; 1.0'ın altındaki değerler görüntüyü daha koyu, 1.0'ın üzerindeki değerler ise görüntüyü daha parlak yapar. ## Girdiler | Parametre | Açıklama | Veri Türü | Gerekli | Aralık | | --- | --- | --- | --- | --- | -| `image` | Ayarlanacak girdi görüntüsü. | IMAGE | Evet | - | -| `faktör` | Parlaklık faktörü. 1.0 = değişiklik yok, <1.0 = koyulaştırır, >1.0 = aydınlatır. (varsayılan: 1.0) | FLOAT | Hayır | 0.0 - 2.0 | +| `image` | Ayarlanacak girdi görüntüsü. Tek bir görüntü veya bir grup görüntü kabul eder. | IMAGE | Evet | - | +| `faktör` | Parlaklık faktörü. 1.0 = değişiklik yok, <1.0 = daha koyu, >1.0 = daha parlak. (varsayılan: 1.0) | FLOAT | Hayır | 0.0 - 2.0 | + +Not: Girdi görüntüsünde bir alfa kanalı (RGBA) varsa yalnızca renk kanalları ayarlanır. Alfa kanalı, renk değil saydamlık bilgisi sakladığı için girdiden değiştirilmeden kopyalanır. ## Çıktılar | Çıktı Adı | Açıklama | Veri Türü | | --- | --- | --- | -| `görseller` | Parlaklığı ayarlanmış çıktı görüntüsü. | IMAGE | +| `görseller` | Parlaklığı ayarlanmış çıktı görüntüsü. Girdide alfa kanalı varsa, alfa değerleri değişmeden kalı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/AdjustBrightness/tr.md) diff --git a/comfyui_embedded_docs/docs/AdjustBrightness/zh-TW.md b/comfyui_embedded_docs/docs/AdjustBrightness/zh-TW.md index dbcf69326..2cb39814f 100644 --- a/comfyui_embedded_docs/docs/AdjustBrightness/zh-TW.md +++ b/comfyui_embedded_docs/docs/AdjustBrightness/zh-TW.md @@ -1,19 +1,21 @@ # 調整亮度 -Adjust Brightness 節點會修改輸入影像的亮度。其運作方式是將每個像素的值乘以指定係數,然後將結果值限制在有效範圍內。係數為 1.0 時影像保持不變,低於 1.0 時影像變暗,高於 1.0 時影像變亮。如果輸入影像帶有透明通道,透明通道將原樣保留,以保持透明度。 +調整亮度節點用於改變影像的明暗程度。它會將影像的色彩值乘以一個 `factor` 係數,並將結果限制在有效的 0.0 到 1.0 範圍內。係數為 1.0 時影像保持不變,小於 1.0 會使影像變暗,大於 1.0 則會使影像變亮。 ## 輸入 -| 參數 | 說明 | 資料類型 | 必要 | 範圍 | +| 參數 | 描述 | 資料類型 | 必要 | 範圍 | | --- | --- | --- | --- | --- | -| `image` | 要調整的輸入影像。 | IMAGE | 是 | - | +| `image` | 要調整的輸入影像。接受單張影像或一批影像。 | IMAGE | 是 | - | | `亮度係數` | 亮度係數。1.0 = 不變,<1.0 = 變暗,>1.0 = 變亮。(預設值:1.0) | FLOAT | 否 | 0.0 - 2.0 | +注意:如果輸入影像帶有 Alpha 色版(RGBA),只會調整色彩色版。Alpha 色版會原封不動地從輸入複製過來,因為它儲存的是透明度,而非色彩。 + ## 輸出 -| 輸出名稱 | 說明 | 資料類型 | +| 輸出名稱 | 描述 | 資料類型 | | --- | --- | --- | -| `影像` | 已調整亮度的輸出影像。 | IMAGE | +| `影像` | 調整亮度後的輸出影像。如果輸入帶有 Alpha 色版,Alpha 數值會保持不變。 | IMAGE | > 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/AdjustBrightness/zh-TW.md) diff --git a/comfyui_embedded_docs/docs/AdjustBrightness/zh.md b/comfyui_embedded_docs/docs/AdjustBrightness/zh.md index 772959004..753657272 100644 --- a/comfyui_embedded_docs/docs/AdjustBrightness/zh.md +++ b/comfyui_embedded_docs/docs/AdjustBrightness/zh.md @@ -1,19 +1,21 @@ # 调整亮度 -调整亮度节点用于修改输入图像的亮度。其工作原理是将每个像素的值乘以指定系数,然后将结果值限制在有效范围内。系数为 1.0 时图像保持不变,低于 1.0 时图像变暗,高于 1.0 时图像变亮。如果输入图像带有透明通道,透明通道将原样保留,以保持透明度。 +Adjust Brightness 节点用于调整图像的亮度。它通过将图像的颜色值与 `factor` 相乘,并将结果限制在有效的 0.0 到 1.0 范围内来实现。当 `factor` 为 1.0 时,图像保持不变;小于 1.0 时图像变暗;大于 1.0 时图像变亮。 ## 输入 -| 参数 | 描述 | 数据类型 | 是否必需 | 范围 | +| 参数 | 描述 | 数据类型 | 是否必填 | 范围 | | --- | --- | --- | --- | --- | -| `image` | 要调整的输入图像。 | IMAGE | 是 | - | -| `系数` | 亮度系数。1.0 = 不变,<1.0 = 变暗,>1.0 = 变亮。(默认值:1.0) | FLOAT | 否 | 0.0 - 2.0 | +| `image` | 要调整的输入图像。支持单个图像或一批图像。 | IMAGE | 是 | - | +| `系数` | 亮度因子。1.0 = 不变,<1.0 = 变暗,>1.0 = 变亮。(默认值:1.0) | FLOAT | 否 | 0.0 - 2.0 | + +注意:如果输入图像带有 Alpha 通道(RGBA),则仅调整颜色通道。Alpha 通道将原样从输入中复制,因为它存储的是透明度而非颜色。 ## 输出 | 输出名称 | 描述 | 数据类型 | | --- | --- | --- | -| `图像` | 亮度调整后的输出图像。 | IMAGE | +| `图像` | 调整亮度后的输出图像。如果输入带有 Alpha 通道,则 Alpha 值保持不变。 | IMAGE | > 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/AdjustBrightness/zh.md) diff --git a/comfyui_embedded_docs/docs/AdjustContrast/ar.md b/comfyui_embedded_docs/docs/AdjustContrast/ar.md index d64f57bca..83493a49a 100644 --- a/comfyui_embedded_docs/docs/AdjustContrast/ar.md +++ b/comfyui_embedded_docs/docs/AdjustContrast/ar.md @@ -1,19 +1,19 @@ # ضبط التباين -تعمل عقدة Adjust Contrast على تعديل مستوى التباين في صورة الإدخال. وهي تعمل عن طريق ضبط الفرق بين المناطق الفاتحة والداكنة في الصورة. العامل 1.0 يترك الصورة دون تغيير، والقيم الأقل من 1.0 تقلل التباين، والقيم الأعلى من 1.0 تزيده. إذا كانت صورة الإدخال تحتوي على قناة ألفا، فإنها تمر دون تغيير للحفاظ على الشفافية. +تقوم عقدة Adjust Contrast بضبط تباين الصورة المدخلة عن طريق تحجيم الفرق بين المناطق الفاتحة والداكنة حول نقطة منتصف نطاق الألوان. تُبقي القيمة 1.0 الصورة دون تغيير، بينما تقلّل القيم الأقل من 1.0 التباين، وتزيده القيم الأعلى من 1.0. ## المدخلات -| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +| Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `image` | صورة الإدخال التي سيتم ضبط تباينها. | IMAGE | نعم | - | -| `عامل التباين` | معامل التباين. 1.0 = بدون تغيير، <1.0 = تباين أقل، >1.0 = تباين أكبر. (الافتراضي: 1.0) | FLOAT | لا | 0.0 - 2.0 | +| `image` | الصورة المدخلة التي سيتم ضبط تباينها. | IMAGE | نعم | - | +| `عامل التباين` | عامل التباين. 1.0 = بدون تغيير، <1.0 = تباين أقل، >1.0 = تباين أكبر. (الافتراضي: 1.0) | FLOAT | لا | 0.0 - 2.0 | ## المخرجات -| اسم المخرج | الوصف | نوع البيانات | +| Output Name | Description | Data Type | | --- | --- | --- | -| `الصور` | الصورة الناتجة ذات التباين المضبوط. يتم تقييد قيم البكسل إلى النطاق 0.0–1.0. | IMAGE | +| `الصور` | الصورة الناتجة مع ضبط التباين. يتم تقييد قيم البكسلات إلى النطاق 0.0–1.0. إذا كانت الصورة المدخلة تحتوي على قناة ألفا، يتم الحفاظ على تلك القناة دون تغيير. | IMAGE | > تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/AdjustContrast/ar.md) diff --git a/comfyui_embedded_docs/docs/AdjustContrast/en.md b/comfyui_embedded_docs/docs/AdjustContrast/en.md index 19c66c6eb..623c09cce 100644 --- a/comfyui_embedded_docs/docs/AdjustContrast/en.md +++ b/comfyui_embedded_docs/docs/AdjustContrast/en.md @@ -1,6 +1,6 @@ # Adjust Contrast -The Adjust Contrast node modifies the contrast level of an input image. It works by adjusting the difference between the light and dark areas of the image. A factor of 1.0 leaves the image unchanged, values below 1.0 reduce contrast, and values above 1.0 increase it. If the input image has an alpha channel, the alpha channel is passed through unchanged so transparency is preserved. +The Adjust Contrast node adjusts the contrast of an input image by scaling the difference between light and dark areas around the midpoint of the color range. A factor of 1.0 leaves the image unchanged, values below 1.0 reduce contrast, and values above 1.0 increase contrast. ## Inputs @@ -13,7 +13,7 @@ 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. Pixel values are clamped to the 0.0–1.0 range. | IMAGE | +| `image` | The resulting image with adjusted contrast. Pixel values are clamped to the 0.0–1.0 range. If the input image has an alpha channel, that channel is preserved unchanged. | 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) diff --git a/comfyui_embedded_docs/docs/AdjustContrast/es.md b/comfyui_embedded_docs/docs/AdjustContrast/es.md index e73934ec2..232abece1 100644 --- a/comfyui_embedded_docs/docs/AdjustContrast/es.md +++ b/comfyui_embedded_docs/docs/AdjustContrast/es.md @@ -1,19 +1,19 @@ # Ajustar contraste -El nodo Adjust Contrast modifica el nivel de contraste de una imagen de entrada. Funciona ajustando la diferencia entre las áreas claras y oscuras de la imagen. Un factor de 1.0 deja la imagen sin cambios, los valores por debajo de 1.0 reducen el contraste y los valores por encima de 1.0 lo aumentan. Si la imagen de entrada tiene un canal alfa, este se mantiene sin cambios para preservar la transparencia. +El nodo Adjust Contrast ajusta el contraste de una imagen de entrada escalando la diferencia entre las áreas claras y oscuras alrededor del punto medio del rango de color. Un factor de 1.0 deja la imagen sin cambios, los valores inferiores a 1.0 reducen el contraste y los valores superiores a 1.0 lo aumentan. ## Entradas -| Parámetro | Descripción | Tipo de dato | Requerido | Rango | +| Parámetro | Descripción | Tipo de datos | Requerido | Rango | | --- | --- | --- | --- | --- | | `image` | La imagen de entrada cuyo contraste se ajustará. | IMAGE | Sí | - | | `factor` | Factor de contraste. 1.0 = sin cambios, <1.0 = menos contraste, >1.0 = más contraste. (por defecto: 1.0) | FLOAT | No | 0.0 - 2.0 | ## Salidas -| Nombre de salida | Descripción | Tipo de dato | +| Nombre de salida | Descripción | Tipo de datos | | --- | --- | --- | -| `imágenes` | La imagen resultante con el contraste ajustado. Los valores de píxeles se limitan al rango 0.0–1.0. | IMAGE | +| `imágenes` | La imagen resultante con el contraste ajustado. Los valores de píxeles se limitan al rango de 0.0 a 1.0. Si la imagen de entrada tiene un canal alfa, ese canal se conserva sin cambios. | 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/AdjustContrast/es.md) diff --git a/comfyui_embedded_docs/docs/AdjustContrast/fa.md b/comfyui_embedded_docs/docs/AdjustContrast/fa.md index 3089a0330..10d539735 100644 --- a/comfyui_embedded_docs/docs/AdjustContrast/fa.md +++ b/comfyui_embedded_docs/docs/AdjustContrast/fa.md @@ -1,19 +1,19 @@ # تنظیم کنتراست -گره Adjust Contrast سطح کنتراست یک تصویر ورودی را اصلاح می‌کند. این کار با تنظیم تفاوت بین نواحی روشن و تاریک تصویر انجام می‌شود. ضریب 1.0 تصویر را بدون تغییر باقی می‌گذارد، مقادیر کمتر از 1.0 کنتراست را کاهش می‌دهند و مقادیر بیشتر از 1.0 آن را افزایش می‌دهند. اگر تصویر ورودی کانال آلفا داشته باشد، کانال آلفا بدون تغییر منتقل می‌شود تا شفافیت حفظ شود. +گره Adjust Contrast کنتراست یک تصویر ورودی را با مقیاس‌بندی تفاوت بین نواحی روشن و تیره حول نقطه میانی محدوده رنگ تنظیم می‌کند. ضریب 1.0 تصویر را بدون تغییر می‌گذارد، مقادیر کمتر از 1.0 کنتراست را کاهش می‌دهند و مقادیر بیشتر از 1.0 کنتراست را افزایش می‌دهند. ## ورودی‌ها | پارامتر | توضیحات | نوع داده | الزامی | محدوده | | --- | --- | --- | --- | --- | -| `image` | تصویر ورودی که قرار است کنتراست آن تنظیم شود. | IMAGE | بله | - | +| `image` | تصویر ورودی که کنتراست آن باید تنظیم شود. | IMAGE | بله | - | | `ضریب` | ضریب کنتراست. 1.0 = بدون تغییر، <1.0 = کنتراست کمتر، >1.0 = کنتراست بیشتر. (پیش‌فرض: 1.0) | FLOAT | خیر | 0.0 - 2.0 | ## خروجی‌ها | نام خروجی | توضیحات | نوع داده | | --- | --- | --- | -| `تصاویر` | تصویر نهایی با کنتراست تنظیم‌شده. مقادیر پیکسل‌ها در بازه 0.0–1.0 محدود می‌شوند. | IMAGE | +| `تصاویر` | تصویر حاصل با کنتراست تنظیم‌شده. مقادیر پیکسل در محدوده 0.0–1.0 محدود می‌شوند. اگر تصویر ورودی کانال آلفا داشته باشد، آن کانال بدون تغییر حفظ می‌شود. | IMAGE | > این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/AdjustContrast/fa.md) diff --git a/comfyui_embedded_docs/docs/AdjustContrast/fr.md b/comfyui_embedded_docs/docs/AdjustContrast/fr.md index e6b5a6d01..425130901 100644 --- a/comfyui_embedded_docs/docs/AdjustContrast/fr.md +++ b/comfyui_embedded_docs/docs/AdjustContrast/fr.md @@ -1,19 +1,19 @@ # Ajuster le contraste -Le nœud Adjust Contrast modifie le niveau de contraste d'une image d'entrée. Il fonctionne en ajustant la différence entre les zones claires et sombres de l'image. Un facteur de 1.0 laisse l'image inchangée, des valeurs inférieures à 1.0 réduisent le contraste, et des valeurs supérieures à 1.0 l'augmentent. Si l'image d'entrée possède un canal alpha, celui-ci est conservé tel quel afin de préserver la transparence. +Le nœud Adjust Contrast ajuste le contraste d'une image d'entrée en mettant à l'échelle la différence entre les zones claires et sombres autour du point médian de la plage de couleurs. Un facteur de 1.0 laisse l'image inchangée, les valeurs inférieures à 1.0 réduisent le contraste et les valeurs supérieures à 1.0 l'augmentent. ## Entrées | Paramètre | Description | Type de données | Requis | Plage | | --- | --- | --- | --- | --- | | `image` | L'image d'entrée dont le contraste doit être ajusté. | IMAGE | Oui | - | -| `facteur` | Facteur de contraste. 1.0 = aucun changement, <1.0 = moins de contraste, >1.0 = plus de contraste. (défaut : 1.0) | FLOAT | Non | 0.0 - 2.0 | +| `facteur` | Facteur de contraste. 1.0 = aucun changement, <1.0 = moins de contraste, >1.0 = plus de contraste. (par défaut : 1.0) | FLOAT | Non | 0.0 - 2.0 | ## Sorties | Nom de sortie | Description | Type de données | | --- | --- | --- | -| `images` | L'image résultante avec un contraste ajusté. Les valeurs des pixels sont bornées à la plage 0.0–1.0. | IMAGE | +| `images` | L'image résultante avec le contraste ajusté. Les valeurs de pixel sont limitées à la plage 0.0–1.0. Si l'image d'entrée possède un canal alpha, ce canal est conservé inchangé. | 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/AdjustContrast/fr.md) diff --git a/comfyui_embedded_docs/docs/AdjustContrast/ja.md b/comfyui_embedded_docs/docs/AdjustContrast/ja.md index c758483bf..0f53a3845 100644 --- a/comfyui_embedded_docs/docs/AdjustContrast/ja.md +++ b/comfyui_embedded_docs/docs/AdjustContrast/ja.md @@ -1,19 +1,19 @@ # コントラストを調整 -Adjust Contrast ノードは、入力画像のコントラストレベルを変更します。画像の明るい部分と暗い部分の差を調整することで機能します。ファクターが 1.0 の場合は画像は変化せず、1.0 未満の値ではコントラストが減少し、1.0 を超える値ではコントラストが増加します。入力画像にアルファチャンネルがある場合、アルファチャンネルは変更されずにそのまま維持され、透明度が保持されます。 +「Adjust Contrast」ノードは、色域の中間点を基準に明部と暗部の差を拡大・縮小することで、入力画像のコントラストを調整します。係数が1.0の場合は画像は変化せず、1.0未満ではコントラストが低下し、1.0を超えるとコントラストが増加します。 ## 入力 | パラメータ | 説明 | データ型 | 必須 | 範囲 | | --- | --- | --- | --- | --- | -| `image` | コントラストを調整する入力画像。 | IMAGE | 必須 | - | -| `係数` | コントラストファクター。1.0 = 変更なし、<1.0 = コントラスト減少、>1.0 = コントラスト増加。(デフォルト: 1.0) | FLOAT | 任意 | 0.0 - 2.0 | +| `image` | コントラストを調整する入力画像です。 | IMAGE | はい | - | +| `係数` | コントラスト係数です。1.0 = 変化なし、<1.0 = コントラスト減少、>1.0 = コントラスト増加です。(デフォルト: 1.0) | FLOAT | いいえ | 0.0 - 2.0 | ## 出力 | 出力名 | 説明 | データ型 | | --- | --- | --- | -| `画像` | コントラストが調整された結果の画像。ピクセル値は 0.0~1.0 の範囲にクランプされます。 | IMAGE | +| `画像` | コントラストが調整された結果の画像です。ピクセル値は0.0~1.0の範囲にクランプされます。入力画像にアルファチャンネルがある場合は、そのチャンネルは変更されずに保持されます。 | IMAGE | > このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/AdjustContrast/ja.md) diff --git a/comfyui_embedded_docs/docs/AdjustContrast/ko.md b/comfyui_embedded_docs/docs/AdjustContrast/ko.md index 01596b054..f18f45a96 100644 --- a/comfyui_embedded_docs/docs/AdjustContrast/ko.md +++ b/comfyui_embedded_docs/docs/AdjustContrast/ko.md @@ -1,10 +1,10 @@ # 명암 조정 -Adjust Contrast 노드는 입력 이미지의 대비 수준을 수정합니다. 이 노드는 이미지의 밝은 영역과 어두운 영역 간의 차이를 조정하는 방식으로 작동합니다. 대비 계수(factor)가 1.0이면 이미지가 변경되지 않고, 1.0보다 낮으면 대비가 감소하며, 1.0보다 높으면 대비가 증가합니다. 입력 이미지에 알파 채널이 있는 경우 알파 채널은 변경되지 않고 그대로 유지되어 투명도가 보존됩니다. +Adjust Contrast 노드는 색상 범위의 중간점을 기준으로 밝은 영역과 어두운 영역 간의 차이를 스케일링하여 입력 이미지의 대비를 조정합니다. factor 값이 1.0이면 이미지가 변경되지 않으며, 1.0 미만이면 대비가 감소하고, 1.0 초과이면 대비가 증가합니다. ## 입력 -| 매개변수 | 설명 | 데이터 타입 | 필수 여부 | 범위 | +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | | --- | --- | --- | --- | --- | | `image` | 대비를 조정할 입력 이미지입니다. | IMAGE | 예 | - | | `factor` | 대비 계수입니다. 1.0 = 변경 없음, <1.0 = 대비 감소, >1.0 = 대비 증가. (기본값: 1.0) | FLOAT | 아니요 | 0.0 - 2.0 | @@ -13,7 +13,7 @@ Adjust Contrast 노드는 입력 이미지의 대비 수준을 수정합니다. | 출력 이름 | 설명 | 데이터 타입 | | --- | --- | --- | -| `images` | 대비가 조정된 결과 이미지입니다. 픽셀 값은 0.0–1.0 범위로 제한됩니다. | IMAGE | +| `images` | 대비가 조정된 결과 이미지입니다. 픽셀 값은 0.0~1.0 범위로 제한됩니다. 입력 이미지에 알파 채널이 있는 경우 해당 채널은 변경되지 않고 그대로 유지됩니다. | IMAGE | > 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/AdjustContrast/ko.md) diff --git a/comfyui_embedded_docs/docs/AdjustContrast/pt-BR.md b/comfyui_embedded_docs/docs/AdjustContrast/pt-BR.md index 21270d2f5..7b5c2ca97 100644 --- a/comfyui_embedded_docs/docs/AdjustContrast/pt-BR.md +++ b/comfyui_embedded_docs/docs/AdjustContrast/pt-BR.md @@ -1,10 +1,10 @@ # Ajustar Contraste -O nó Adjust Contrast modifica o nível de contraste de uma imagem de entrada. Ele funciona ajustando a diferença entre as áreas claras e escuras da imagem. Um fator de 1.0 mantém a imagem inalterada, valores abaixo de 1.0 reduzem o contraste e valores acima de 1.0 aumentam. Se a imagem de entrada tiver um canal alfa, ele será mantido inalterado para preservar a transparência. +O nó Adjust Contrast ajusta o contraste de uma imagem de entrada escalando a diferença entre as áreas claras e escuras em torno do ponto médio da faixa de cores. Um fator de 1.0 mantém a imagem inalterada, valores abaixo de 1.0 reduzem o contraste e valores acima de 1.0 aumentam o contraste. ## Entradas -| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Faixa | +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | | --- | --- | --- | --- | --- | | `image` | A imagem de entrada que terá o contraste ajustado. | IMAGE | Sim | - | | `fator` | Fator de contraste. 1.0 = sem alteração, <1.0 = menos contraste, >1.0 = mais contraste. (padrão: 1.0) | FLOAT | Não | 0.0 - 2.0 | @@ -13,7 +13,7 @@ O nó Adjust Contrast modifica o nível de contraste de uma imagem de entrada. E | Nome da Saída | Descrição | Tipo de Dados | | --- | --- | --- | -| `imagens` | A imagem resultante com contraste ajustado. Os valores de pixel são limitados ao intervalo de 0.0–1.0. | IMAGE | +| `imagens` | A imagem resultante com o contraste ajustado. Os valores de pixel são limitados ao intervalo de 0.0 a 1.0. Se a imagem de entrada tiver um canal alfa, esse canal é preservado inalterado. | 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/AdjustContrast/pt-BR.md) diff --git a/comfyui_embedded_docs/docs/AdjustContrast/ru.md b/comfyui_embedded_docs/docs/AdjustContrast/ru.md index e0574def8..18dc0c2a1 100644 --- a/comfyui_embedded_docs/docs/AdjustContrast/ru.md +++ b/comfyui_embedded_docs/docs/AdjustContrast/ru.md @@ -1,19 +1,19 @@ # Регулировка контрастности -Узел Adjust Contrast изменяет уровень контрастности входного изображения. Он работает, регулируя разницу между светлыми и темными областями изображения. Фактор 1.0 оставляет изображение без изменений, значения ниже 1.0 уменьшают контраст, а значения выше 1.0 увеличивают его. Если входное изображение содержит альфа-канал, он передаётся без изменений, сохраняя прозрачность. +Узел Adjust Contrast регулирует контраст входного изображения, масштабируя разницу между светлыми и тёмными областями вокруг середины цветового диапазона. Коэффициент 1.0 оставляет изображение без изменений, значения ниже 1.0 уменьшают контраст, а значения выше 1.0 увеличивают контраст. ## Входы | Параметр | Описание | Тип данных | Обязательный | Диапазон | | --- | --- | --- | --- | --- | -| `image` | Входное изображение, для которого выполняется настройка контраста. | IMAGE | Да | - | -| `коэффициент` | Коэффициент контраста. 1.0 = без изменений, <1.0 = меньше контраста, >1.0 = больше контраста. (по умолчанию: 1.0) | FLOAT | Нет | 0.0 - 2.0 | +| `image` | Входное изображение, для которого требуется отрегулировать контраст. | IMAGE | Да | - | +| `коэффициент` | Коэффициент контраста. 1.0 — без изменений, <1.0 — меньше контраста, >1.0 — больше контраста. (по умолчанию: 1.0) | FLOAT | Нет | 0.0 - 2.0 | ## Выходы | Имя выхода | Описание | Тип данных | | --- | --- | --- | -| `изображения` | Результирующее изображение с отрегулированным контрастом. Значения пикселей ограничены диапазоном 0.0–1.0. | IMAGE | +| `изображения` | Результирующее изображение с отрегулированным контрастом. Значения пикселей ограничены диапазоном 0.0–1.0. Если входное изображение имеет альфа-канал, этот канал сохраняется без изменений. | IMAGE | > Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/AdjustContrast/ru.md) diff --git a/comfyui_embedded_docs/docs/AdjustContrast/tr.md b/comfyui_embedded_docs/docs/AdjustContrast/tr.md index 108979ef2..a0cef9dd3 100644 --- a/comfyui_embedded_docs/docs/AdjustContrast/tr.md +++ b/comfyui_embedded_docs/docs/AdjustContrast/tr.md @@ -1,6 +1,6 @@ # Kontrastı Ayarla -Adjust Contrast düğümü, bir girdi görüntüsünün kontrast düzeyini değiştirir. Bu, görüntünün açık ve koyu alanları arasındaki farkı ayarlayarak çalışır. 1.0 faktörü görüntüyü değiştirmez, 1.0'ın altındaki değerler kontrastı azaltır, 1.0'ın üzerindeki değerler ise artırır. Girdi görüntüsü bir alfa kanalı içeriyorsa, şeffaflığı korumak için alfa kanalı değiştirilmeden aktarılır. +Kontrast Ayarı düğümü, renk aralığının orta noktası etrafında açık ve koyu alanlar arasındaki farkı ölçekleyerek girdi görüntüsünün kontrastını ayarlar. 1.0 faktörü görüntüyü değiştirmez, 1.0'ın altındaki değerler kontrastı azaltır ve 1.0'ın üzerindeki değerler kontrastı artırır. ## Girdiler @@ -13,7 +13,7 @@ Adjust Contrast düğümü, bir girdi görüntüsünün kontrast düzeyini deği | Çıktı Adı | Açıklama | Veri Türü | | --- | --- | --- | -| `görseller` | Kontrastı ayarlanmış sonuç görüntüsü. Piksel değerleri 0.0–1.0 aralığına sınırlandırılmıştır. | IMAGE | +| `görseller` | Kontrastı ayarlanmış sonuç görüntüsü. Piksel değerleri 0.0–1.0 aralığına sınırlandırılır. Girdi görüntüsünün bir alfa kanalı varsa, bu kanal değiştirilmeden korunur. | 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/AdjustContrast/tr.md) diff --git a/comfyui_embedded_docs/docs/AdjustContrast/zh-TW.md b/comfyui_embedded_docs/docs/AdjustContrast/zh-TW.md index c776ced5b..83c80a941 100644 --- a/comfyui_embedded_docs/docs/AdjustContrast/zh-TW.md +++ b/comfyui_embedded_docs/docs/AdjustContrast/zh-TW.md @@ -1,19 +1,19 @@ # 調整對比度 -Adjust Contrast 節點會修改輸入影像的對比度等級。其運作方式是調整影像中亮部與暗部之間的差異。係數為 1.0 時影像保持不變,低於 1.0 的值會降低對比度,高於 1.0 的值則會增加對比度。如果輸入影像帶有透明通道,透明通道將原樣保留,以保持透明度。 +「Adjust Contrast」節點透過在色彩範圍的中點附近縮放亮部與暗部之間的差異,來調整輸入影像的對比度。係數為 1.0 時影像維持不變;低於 1.0 會降低對比度;高於 1.0 則會增強對比度。 ## 輸入 -| 參數 | 描述 | 資料類型 | 必填 | 範圍 | +| 參數 | 描述 | 資料型別 | 必填 | 範圍 | | --- | --- | --- | --- | --- | -| `image` | 要調整對比度的輸入影像。 | IMAGE | 是 | - | -| `對比度係數` | 對比度係數。1.0 = 不變,<1.0 = 降低對比度,>1.0 = 增加對比度。(預設值:1.0) | FLOAT | 否 | 0.0 - 2.0 | +| `image` | 輸入影像,將調整其對比度。 | IMAGE | 是 | - | +| `對比度係數` | 對比度係數。1.0 = 無變化,<1.0 = 降低對比度,>1.0 = 增強對比度。(預設值:1.0) | FLOAT | 否 | 0.0 - 2.0 | ## 輸出 -| 輸出名 | 描述 | 資料類型 | +| 輸出名 | 描述 | 資料型別 | | --- | --- | --- | -| `影像` | 調整對比度後產生的影像。像素值會限制在 0.0–1.0 範圍內。 | IMAGE | +| `影像` | 調整對比度後產生的影像。像素值會被限制在 0.0–1.0 範圍內。若輸入影像含有 Alpha 色版,該色版會原樣保留。 | IMAGE | > 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/AdjustContrast/zh-TW.md) diff --git a/comfyui_embedded_docs/docs/AdjustContrast/zh.md b/comfyui_embedded_docs/docs/AdjustContrast/zh.md index 509992da8..b87a5def0 100644 --- a/comfyui_embedded_docs/docs/AdjustContrast/zh.md +++ b/comfyui_embedded_docs/docs/AdjustContrast/zh.md @@ -1,19 +1,19 @@ # 调整对比度 -调整对比度节点用于修改输入图像的对比度级别。它通过调整图像亮部与暗部之间的差异来实现。因子为 1.0 时图像保持不变,低于 1.0 的值降低对比度,高于 1.0 的值则提高对比度。如果输入图像带有透明通道,透明通道将原样保留,以保持透明度。 +Adjust Contrast 节点通过围绕颜色范围中点缩放亮部与暗部之间的差异来调整输入图像的对比度。因子为 1.0 时图像保持不变,低于 1.0 时降低对比度,高于 1.0 时增加对比度。 ## 输入 -| 参数 | 说明 | 数据类型 | 是否必填 | 范围 | +| 参数 | 描述 | 数据类型 | 是否必需 | 范围 | | --- | --- | --- | --- | --- | | `image` | 需要调整对比度的输入图像。 | IMAGE | 是 | - | -| `系数` | 对比度因子。1.0 = 不变,<1.0 = 降低对比度,>1.0 = 提高对比度。(默认值:1.0) | FLOAT | 否 | 0.0 - 2.0 | +| `系数` | 对比度因子。1.0 = 无变化,<1.0 = 降低对比度,>1.0 = 提高对比度。(默认值:1.0) | FLOAT | 否 | 0.0 - 2.0 | ## 输出 -| 输出名称 | 说明 | 数据类型 | +| 输出名称 | 描述 | 数据类型 | | --- | --- | --- | -| `图像` | 调整对比度后生成的图像。像素值将被限制在 0.0–1.0 范围内。 | IMAGE | +| `图像` | 调整对比度后得到的图像。像素值会被限制在 0.0–1.0 范围内。如果输入图像带有 alpha 通道,则该通道保持不变。 | IMAGE | > 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/AdjustContrast/zh.md) diff --git a/comfyui_embedded_docs/docs/BlockSparseAttention/ar.md b/comfyui_embedded_docs/docs/BlockSparseAttention/ar.md index 29a14b418..60f36f30b 100644 --- a/comfyui_embedded_docs/docs/BlockSparseAttention/ar.md +++ b/comfyui_embedded_docs/docs/BlockSparseAttention/ar.md @@ -1,44 +1,53 @@ -# Block Sparse Attention +# انتباه متناثر للكتل في النموذج -## ملخص +## المقدمة -يطبق عقد Block Sparse Attention ميكانيكية الانتباه الكتلة المتباينة على نموذج ComfyUI، مما يقلل من حساب الانتباه من خلال السماح لكل مكتبة استعلام بإجراء الانتباه إلى مجموعة مختارة من مكتبات المفاتيح فقط. +يُعد مكون التركيز الفقري المتباين يُعدد نموذج ComfyUI لتحليل ميكانيكية التركيز الفقري المتباين. تُقلل هذه الميكانيكية الحمل الحسابي عن طريق السماح لكل مكتبة استعلام بالتركيز على مجموعة فرعية من مكتبات المفاتيح بدلاً من التركيز على جميع المكتبات المحتملة، وهو أمر مفيد بشكل خاص للسلاسل الطويلة. ## المدخلات | المعامل | الوصف | نوع البيانات | إلزامي | نطاق | |-----------|-------------|-----------|----------|-------| -| `model` | النموذج ComfyUI الذي سيتم تطبيق ميكانيكية الانتباه الكتلة المتباينة عليه. | MODEL | نعم | لا يوجد نطاق | -| `selection` | طريقة التحديد لاختيار مكتبات المفاتيح التي سيتم الانتباه إليها. | DYNAMIC_COMBO | نعم | خيارات: Sol-Attn (tau متغير)، top-k (SLA)، VSA (FastVideo) | -| `tau` | الحد الأدنى في sigmas التوزيع السعري لـ Sol-Attn (tau متغير) التحديد. | FLOAT | لا | افتراضي: 1.3، الحد الأدنى: 0.0، الحد الأعلى: 4.0، الخطوة: 0.05 | -| `keep_percent` | النسبة المئوية لمكتبات المفاتيح التي يحتفظ بها كل مكتبة استعلام بالضبط لـ top-k (SLA) التحديد. | FLOAT | لا | افتراضي: 10.0، الحد الأدنى: 0.5، الحد الأعلى: 95.0، الخطوة: 0.5 | -| `start_percent` | النسبة المئوية من الجدول قبل استخدام النموذج الانتباه الكثيف. | FLOAT | لا | افتراضي: 0.2، الحد الأدنى: 0.0، الحد الأعلى: 1.0، الخطوة: 0.01 | -| `end_percent` | النسبة المئوية من الجدول بعد استخدام النموذج الانتباه الكثيف. | FLOAT | لا | افتراضي: 1.0، الحد الأدنى: 0.0، الحد الأعلى: 1.0، الخطوة: 0.01 | -| `dense_blocks` | نص يمثل مكتبات المعالجة النصية التي تشتغل دائمًا الانتباه الكثيف. | STRING | لا | افتراضي: "" | -| `min_tokens` | عدد الأحرف الأدنى في السلسلة التي يستخدم فيها النموذج الانتباه الكثيف. | INT | لا | افتراضي: 12288، الحد الأدنى: 0، الحد الأعلى: 1 << 20، الخطوة: 512 | -| `extra_tokens` | عدد الأحرف الإضافية التي ينتبه إليها كل مكتبة استعلام بعيدًا عن مكتباتها المختارة. | INT | لا | افتراضي: 256، الحد الأدنى: 0، الحد الأعلى: 256، الخطوة: 64 | -| `sink_conditioning` | الصفوف المرجعية MiniMax-H3 للاستخدام في التبريد. | COMBO | لا | خيارات: exact_kv، exact_kv_and_rows، off | -| `verbose` | ما إذا كان يجب تمكين التسجيل التفصيلي. | BOOLEAN | لا | افتراضي: False | +| `model` | النموذج ComfyUI الذي سيُطبق عليه التركيز الفقري المتباين. | نموذج | نعم | غير محدد | +| `selection` | الطريقة المستخدمة لتحديد مكتبات المفاتيح التي سيتم التركيز عليها. | خيار متغير | نعم | خيارات: sol-attn (tau متغير)، sla (top-k)، vsa (Video Sparse Attention) | +| `tau` | الحد الأدنى في sigmas توزيع النقاط لطريقة sol-attn. | عدد عشري | لا | افتراضي: 1.3، أقل من 0.0، أكبر من 4.0، خطوة: 0.05 | +| `keep_percent` | النسبة المئوية لمكتبات المفاتيح التي يحتفظ بها كل مكتبة استعلام بدقة للطريقة sla. | عدد عشري | لا | افتراضي: 10.0، أقل من 0.5، أكبر من 95.0، خطوة: 0.5 | +| `start_percent` | النسبة المئوية للنقطة التي يبدأ فيها التركيز الفقري. | عدد عشري | لا | افتراضي: 0.2، أقل من 0.0، أكبر من 1.0، خطوة: 0.01 | +| `end_percent` | النسبة المئوية للنقطة التي ينتهي فيها التركيز الفقري. | عدد عشري | لا | افتراضي: 1.0، أقل من 0.0، أكبر من 1.0، خطوة: 0.01 | +| `dense_blocks` | نص يمثل مكتبات التحويل التي تشتغل دائمًا باستخدام التركيز الكثيف. | نص | لا | افتراضي: "" | +| `min_tokens` | عدد الأشكال الأدنى في السلسلة التي يستخدمها النموذج التركيز الكثيف. | عدد صحيح | لا | افتراضي: 12288، أقل من 0، أكبر من 1 << 20، خطوة: 512 | +| `extra_tokens` | عدد الأشكال الإضافية التي يركز عليها كل مكتبة استعلام خارج مكتباتها المختارة. | عدد صحيح | لا | افتراضي: 256، أقل من 0، أكبر من 256، خطوة: 64 | +| `sink_conditioning` | الصفوف التكميلية MiniMax-H3 التي سيتم استخدامها للتكميل. | خيار | لا | خيارات: exact_kv، exact_kv_and_rows، off | +| `verbose` | يُمكّن من تسجيل المعلومات التفصيلية. | منطقي | لا | افتراضي: False | + +### ملاحظات + +- يُمكنك استخدام معامل `selection` لاختيار بين طرق مختلفة لتحديد مكتبات المفاتيح: + - `sol-attn`: يستخدم حدًا متغيرًا لتحديد مكتبات المفاتيح بناءً على توزيع النقاط. + - `sla`: يحتفظ بنسبة ثابتة من المكتبات المفاتيح الأعلى النقاط. + - `vsa`: يطبق التركيز الفقري المتباين في الفيديو، باستخدام تلاسمية مكعب الفيديو وفرع التركيز الخفيف المكتسب. +- يمكن استخدام معامل `dense_blocks` لتحديد مكتبات التحويل التي يجب أن تستخدم دائمًا التركيز الكثيف. +- يُحدد معامل `min_tokens` عدد الأشكال الأدنى في السلسلة التي يستخدمها النموذج التركيز الكثيف. +- يُمكنك استخدام معامل `extra_tokens` لتحديد عدد الأشكال الإضافية التي يجب أن يركز عليها كل مكتبة استعلام. +- يُعتبر معامل `sink_conditioning` ذا صلة فقط بالنماذج MiniMax-H3 ويحدد كيفية التعامل مع الصفوف التكميلية. +- يُمكّن معامل `verbose` من تسجيل المعلومات التفصيلية، وهو أمر مفيد للتصحيح. ## المخرجات | اسم المخرج | الوصف | نوع البيانات | |-------------|-------------|-----------| -| `model` | النموذج ComfyUI الذي تم تطبيق ميكانيكية الانتباه الكتلة المتباينة عليه. | MODEL | +| `model` | النموذج ComfyUI الذي تم تطبيق التركيز الفقري المتباين عليه. | نموذج | -### ملاحظات +### القيود والحدود -- يحدد المعامل `selection` كيف يتم اختيار مكتبات المفاتيح. الخيارات هي: - - Sol-Attn (tau متغير): تنتبه كل مكتبة استعلام إلى مجموعة مختارة من مكتبات المفاتيح بناءً على حد أدنى متغير. - - top-k (SLA): تحتفظ كل مكتبة استعلام بنسبة مئوية ثابتة من مكتبات المفاتيح بالضبط. - - VSA (FastVideo): تحتفظ كل مكتبة استعلام بنسبة مئوية ثابتة من مكعبات الفيديو بالضبط، باستخدام تقطيع مكعبات FastH3-VSA وفرع مسبق. -- يسمح المعامل `dense_blocks` بتحديد مكتبات المعالجة النصية التي تشتغل دائمًا الانتباه الكثيف. -- يحدد المعامل `min_tokens` عدد الأحرف الأدنى في السلسلة التي يستخدم فيها النموذج الانتباه الكثيف. -- يسمح المعامل `extra_tokens` بتحديد عدد الأحرف الإضافية التي ينتبه إليها كل مكتبة استعلام بعيدًا عن مكتباتها المختارة. -- يحدد المعامل `sink_conditioning` الصفوف المرجعية MiniMax-H3 للاستخدام في التبريد. -- يتيح المعامل `verbose` تمكين التسجيل التفصيلي. +- يتطلب طريقة `sol-attn` قيمة `tau` بين 0.0 و4.0. +- يتطلب طريقة `sla` قيمة `keep_percent` بين 0.5 و95.0. +- يُعتبر طريقة `vsa` متوافقة فقط مع نماذج MiniMax-H3 ويجب أن يحتوي النموذج على طبقة `to_gate_compress`. +- يجب أن يكون معامل `min_tokens` عددًا صحيحًا غير سالب (القيمة 0 تُبقي الانتباه كثيفًا بالكامل). +- يجب أن يكون معامل `extra_tokens` عددًا صحيحًا غير سالب. +- يُعتبر خيارات `sink_conditioning` ذا صلة فقط بالنماذج MiniMax-H3. > تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BlockSparseAttention/ar.md) --- -**Source fingerprint (SHA-256):** `6a27aee45593883f5958ae1aac74a2077362742a0fdf74fc9dbfd68eddc6d259` +**Source fingerprint (SHA-256):** `0c34876b49a04db0ab265526e2bb5f784e150591aab631713ad2ab420a3327c4` diff --git a/comfyui_embedded_docs/docs/BlockSparseAttention/en.md b/comfyui_embedded_docs/docs/BlockSparseAttention/en.md index 753e42e8d..91d3ee943 100644 --- a/comfyui_embedded_docs/docs/BlockSparseAttention/en.md +++ b/comfyui_embedded_docs/docs/BlockSparseAttention/en.md @@ -2,23 +2,35 @@ ## Overview -The Block Sparse Attention node applies a block-sparse attention mechanism to a ComfyUI model, reducing attention computation by allowing each query block to attend only a selected subset of key blocks exactly. +The Block Sparse Attention node modifies a ComfyUI model to apply a block-sparse attention mechanism. This mechanism reduces the computational load by allowing each query block to focus on a subset of key blocks, rather than attending to all possible blocks, which is particularly beneficial for long sequences. ## Inputs | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| | `model` | The ComfyUI model to apply the block-sparse attention to. | MODEL | Yes | N/A | -| `selection` | The selection method for choosing which key blocks to attend to. | DYNAMIC_COMBO | Yes | Options: Sol-Attn (adaptive tau), top-k (SLA), VSA (FastVideo) | -| `tau` | The threshold in score-distribution sigmas for Sol-Attn (adaptive tau) selection. | FLOAT | No | default: 1.3, min: 0.0, max: 4.0, step: 0.05 | -| `keep_percent` | The percentage of key blocks each query block keeps exactly for top-k (SLA) selection. | FLOAT | No | default: 10.0, min: 0.5, max: 95.0, step: 0.5 | -| `start_percent` | The percentage of the schedule before which the model uses dense attention. | FLOAT | No | default: 0.2, min: 0.0, max: 1.0, step: 0.01 | -| `end_percent` | The percentage of the schedule after which the model uses dense attention. | FLOAT | No | default: 1.0, min: 0.0, max: 1.0, step: 0.01 | +| `selection` | The method used to determine which key blocks to attend to. | DYNAMIC_COMBO | Yes | Options: sol-attn (adaptive tau), sla (top-k), vsa (Video Sparse Attention) | +| `tau` | The threshold in score-distribution sigmas for the sol-attn method. | FLOAT | No | default: 1.3, min: 0.0, max: 4.0, step: 0.05 | +| `keep_percent` | The percentage of key blocks each query block keeps exactly for the sla method. | FLOAT | No | default: 10.0, min: 0.5, max: 95.0, step: 0.5 | +| `start_percent` | The percentage point when sparse attention begins. | FLOAT | No | default: 0.2, min: 0.0, max: 1.0, step: 0.01 | +| `end_percent` | The percentage point when sparse attention ends. | FLOAT | No | default: 1.0, min: 0.0, max: 1.0, step: 0.01 | | `dense_blocks` | A string representing the transformer blocks that always run dense attention. | STRING | No | default: "" | | `min_tokens` | The minimum number of tokens in a sequence for which the model uses dense attention. | INT | No | default: 12288, min: 0, max: 1 << 20, step: 512 | | `extra_tokens` | The number of extra top-scoring tokens each query block attends beyond its selected blocks. | INT | No | default: 256, min: 0, max: 256, step: 64 | | `sink_conditioning` | The MiniMax-H3 conditioning rows to use for sink conditioning. | COMBO | No | Options: exact_kv, exact_kv_and_rows, off | -| `verbose` | Whether to enable verbose logging. | BOOLEAN | No | default: False | +| `verbose` | Enables verbose logging. | BOOLEAN | No | default: False | + +### Notes + +- The `selection` parameter allows you to choose between different methods for selecting key blocks: + - `sol-attn`: Uses an adaptive threshold to select key blocks based on the score distribution. + - `sla`: Keeps a fixed percentage of the highest-scoring key blocks. + - `vsa`: Applies Video Sparse Attention, which uses 3D video-cube tiling and a learned coarse attention branch. +- The `dense_blocks` parameter can be used to specify transformer blocks that should always use dense attention. +- The `min_tokens` parameter sets the minimum number of tokens in a sequence for which dense attention is used. +- The `extra_tokens` parameter allows you to specify the number of additional top-scoring tokens that each query block should attend to. +- The `sink_conditioning` parameter is relevant only for MiniMax-H3 models and determines how the conditioning rows are handled. +- The `verbose` parameter enables detailed logging, which can be useful for debugging. ## Outputs @@ -26,19 +38,16 @@ The Block Sparse Attention node applies a block-sparse attention mechanism to a |-------------|-------------|-----------| | `model` | The ComfyUI model with block-sparse attention applied. | MODEL | -### Notes +### Constraints and Limitations -- The `selection` parameter determines how key blocks are chosen. The options are: - - Sol-Attn (adaptive tau): Each query block attends a selected subset of key blocks based on an adaptive threshold. - - top-k (SLA): Each query block keeps a fixed percentage of key blocks exactly. - - VSA (FastVideo): Each query block keeps a fixed percentage of video cubes exactly, using FastH3-VSA's cube tiling and coarse branch. -- The `dense_blocks` parameter allows you to specify transformer blocks that always run dense attention. -- The `min_tokens` parameter sets the minimum number of tokens in a sequence for which the model uses dense attention. -- The `extra_tokens` parameter allows you to specify the number of extra top-scoring tokens each query block attends beyond its selected blocks. -- The `sink_conditioning` parameter determines the MiniMax-H3 conditioning rows to use for sink conditioning. -- The `verbose` parameter enables verbose logging. +- The `sol-attn` method requires a `tau` value between 0.0 and 4.0. +- The `sla` method requires a `keep_percent` value between 0.5 and 95.0. +- The `vsa` method is only compatible with MiniMax-H3 models and requires the model to have a `to_gate_compress` layer. +- The `min_tokens` parameter must be a non-negative integer (setting it to 0 keeps attention fully dense). +- The `extra_tokens` parameter must be a non-negative integer. +- The `sink_conditioning` options are only applicable to MiniMax-H3 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/BlockSparseAttention/en.md) --- -**Source fingerprint (SHA-256):** `6a27aee45593883f5958ae1aac74a2077362742a0fdf74fc9dbfd68eddc6d259` +**Source fingerprint (SHA-256):** `0c34876b49a04db0ab265526e2bb5f784e150591aab631713ad2ab420a3327c4` diff --git a/comfyui_embedded_docs/docs/BlockSparseAttention/es.md b/comfyui_embedded_docs/docs/BlockSparseAttention/es.md index a322de526..d442ad482 100644 --- a/comfyui_embedded_docs/docs/BlockSparseAttention/es.md +++ b/comfyui_embedded_docs/docs/BlockSparseAttention/es.md @@ -1,44 +1,53 @@ -# Block Sparse Attention +# Atención dispersa por bloques del modelo ## Resumen -El nodo de Atención Esparsa por Bloques aplica un mecanismo de atención esparsa por bloques a un modelo ComfyUI, reduciendo el cálculo de atención permitiendo que cada bloque de consulta atienda solo un subconjunto seleccionado de bloques clave exactamente. +El nodo de Atención Esparsa de Bloque modifica un modelo de ComfyUI para aplicar un mecanismo de atención esparsa de bloque. Este mecanismo reduce la carga computacional permitiendo que cada bloque de consulta se centre en un subconjunto de bloques clave, en lugar de atender a todos los posibles bloques, lo cual es particularmente beneficioso para secuencias largas. ## Entradas -| Parámetro | Descripción | Tipo de Datos | Requerido | Rango | +| Parámetro | Descripción | Tipo de Datos | Obligatorio | Rango | |-----------|-------------|-----------|----------|-------| -| `model` | El modelo ComfyUI al que aplicar la atención esparsa por bloques. | MODEL | Sí | N/A | -| `selection` | El método de selección para elegir qué bloques clave atender. | DYNAMIC_COMBO | Sí | Opciones: Sol-Attn (tau adaptativo), top-k (SLA), VSA (FastVideo) | -| `tau` | El umbral en sigmas de distribución de puntuaciones para la selección Sol-Attn (tau adaptativo). | FLOAT | No | predeterminado: 1.3, min: 0.0, max: 4.0, paso: 0.05 | -| `keep_percent` | El porcentaje de bloques clave que cada bloque de consulta mantiene exactamente para la selección top-k (SLA). | FLOAT | No | predeterminado: 10.0, min: 0.5, max: 95.0, paso: 0.5 | -| `start_percent` | El porcentaje del horario antes del cual el modelo utiliza atención densa. | FLOAT | No | predeterminado: 0.2, min: 0.0, max: 1.0, paso: 0.01 | -| `end_percent` | El porcentaje del horario después del cual el modelo utiliza atención densa. | FLOAT | No | predeterminado: 1.0, min: 0.0, max: 1.0, paso: 0.01 | -| `dense_blocks` | Una cadena que representa los bloques de transformador que siempre ejecutan atención densa. | STRING | No | predeterminado: "" | -| `min_tokens` | El número mínimo de tokens en una secuencia para el que el modelo utiliza atención densa. | INT | No | predeterminado: 12288, min: 0, max: 1 << 20, paso: 512 | -| `extra_tokens` | El número de tokens de alta puntuación adicionales que cada bloque de consulta atiende más allá de sus bloques seleccionados. | INT | No | predeterminado: 256, min: 0, max: 256, paso: 64 | +| `model` | El modelo de ComfyUI al que aplicar la atención esparsa de bloque. | MODEL | Sí | N/A | +| `selection` | El método utilizado para determinar qué bloques clave atender. | DYNAMIC_COMBO | Sí | Opciones: sol-attn (tau adaptativo), sla (top-k), vsa (Atención Esparsa de Video) | +| `tau` | El umbral en sigmas de distribución de puntuaciones para el método sol-attn. | FLOAT | No | predeterminado: 1.3, mínimo: 0.0, máximo: 4.0, paso: 0.05 | +| `keep_percent` | El porcentaje de bloques clave que cada bloque de consulta mantiene exactamente para el método sla. | FLOAT | No | predeterminado: 10.0, mínimo: 0.5, máximo: 95.0, paso: 0.5 | +| `start_percent` | El punto porcentual cuando comienza la atención esparsa. | FLOAT | No | predeterminado: 0.2, mínimo: 0.0, máximo: 1.0, paso: 0.01 | +| `end_percent` | El punto porcentual cuando termina la atención esparsa. | FLOAT | No | predeterminado: 1.0, mínimo: 0.0, máximo: 1.0, paso: 0.01 | +| `dense_blocks` | Una cadena que representa los bloques del transformador que siempre ejecutan atención densa. | STRING | No | predeterminado: "" | +| `min_tokens` | El número mínimo de tokens en una secuencia para el que el modelo utiliza atención densa. | INT | No | predeterminado: 12288, mínimo: 0, máximo: 1 << 20, paso: 512 | +| `extra_tokens` | El número de tokens de alta puntuación adicionales a los que cada bloque de consulta debe prestar atención más allá de sus bloques seleccionados. | INT | No | predeterminado: 256, mínimo: 0, máximo: 256, paso: 64 | | `sink_conditioning` | Las filas de condicionamiento MiniMax-H3 a usar para el condicionamiento de sumidero. | COMBO | No | Opciones: exact_kv, exact_kv_and_rows, off | -| `verbose` | Si se debe activar el registro detallado. | BOOLEAN | No | predeterminado: Falso | +| `verbose` | Habilita el registro detallado. | BOOLEAN | No | predeterminado: Falso | + +### Notas + +- El parámetro `selection` le permite elegir entre diferentes métodos para seleccionar bloques clave: + - `sol-attn`: Utiliza un umbral adaptativo para seleccionar bloques clave basado en la distribución de puntuaciones. + - `sla`: Mantiene un porcentaje fijo de los bloques clave de mayor puntuación. + - `vsa`: Aplica Atención Esparsa de Video, que utiliza mosaico de cubo 3D de video y una rama de atención gruesa aprendida. +- El parámetro `dense_blocks` puede utilizarse para especificar los bloques del transformador que deben utilizar siempre atención densa. +- El parámetro `min_tokens` establece el número mínimo de tokens en una secuencia para el que se utiliza atención densa. +- El parámetro `extra_tokens` permite especificar el número adicional de tokens de alta puntuación a los que cada bloque de consulta debe prestar atención. +- El parámetro `sink_conditioning` es relevante solo para modelos MiniMax-H3 y determina cómo se manejan las filas de condicionamiento. +- El parámetro `verbose` habilita el registro detallado, lo cual puede ser útil para la depuración. ## Salidas | Nombre de Salida | Descripción | Tipo de Datos | |-------------|-------------|-----------| -| `model` | El modelo ComfyUI con la atención esparsa por bloques aplicada. | MODEL | +| `model` | El modelo de ComfyUI con la atención esparsa de bloque aplicada. | MODEL | -### Notas +### Restricciones y Limitaciones -- El parámetro `selection` determina cómo se eligen los bloques clave. Las opciones son: - - Sol-Attn (tau adaptativo): Cada bloque de consulta atiende un subconjunto seleccionado de bloques clave basado en un umbral adaptativo. - - top-k (SLA): Cada bloque de consulta mantiene un porcentaje fijo de bloques clave exactamente. - - VSA (FastVideo): Cada bloque de consulta mantiene un porcentaje fijo de cubos de video exactamente, utilizando el mosaico de cubos y la rama gruesa de FastH3-VSA. -- El parámetro `dense_blocks` permite especificar los bloques de transformador que siempre ejecutan atención densa. -- El parámetro `min_tokens` establece el número mínimo de tokens en una secuencia para el que el modelo utiliza atención densa. -- El parámetro `extra_tokens` permite especificar el número de tokens de alta puntuación adicionales que cada bloque de consulta atiende más allá de sus bloques seleccionados. -- El parámetro `sink_conditioning` determina las filas de condicionamiento MiniMax-H3 a usar para el condicionamiento de sumidero. -- El parámetro `verbose` activa el registro detallado. +- El método `sol-attn` requiere un valor de `tau` entre 0.0 y 4.0. +- El método `sla` requiere un valor de `keep_percent` entre 0.5 y 95.0. +- El método `vsa` es compatible solo con modelos MiniMax-H3 y requiere que el modelo tenga una capa `to_gate_compress`. +- El parámetro `min_tokens` debe ser un entero no negativo (con 0, toda la atención permanece densa). +- El parámetro `extra_tokens` debe ser un entero no negativo. +- Las opciones de `sink_conditioning` solo son aplicables a modelos MiniMax-H3. > 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/BlockSparseAttention/es.md) --- -**Source fingerprint (SHA-256):** `6a27aee45593883f5958ae1aac74a2077362742a0fdf74fc9dbfd68eddc6d259` +**Source fingerprint (SHA-256):** `0c34876b49a04db0ab265526e2bb5f784e150591aab631713ad2ab420a3327c4` diff --git a/comfyui_embedded_docs/docs/BlockSparseAttention/fa.md b/comfyui_embedded_docs/docs/BlockSparseAttention/fa.md index b15889f76..9662d5df1 100644 --- a/comfyui_embedded_docs/docs/BlockSparseAttention/fa.md +++ b/comfyui_embedded_docs/docs/BlockSparseAttention/fa.md @@ -1,44 +1,53 @@ -# Block Sparse Attention +# توجه تنک مدل -## بررسی کلی +## مقدمه -نود Block Sparse Attention از مکانیزم توجه بلوک-سبک (block-sparse attention) استفاده می‌کند و آن را به مدل ComfyUI اعمال می‌نماید. این مکانیزم توجه محاسبات توجه را کاهش می‌دهد تا هر بلوک جستجو (query block) فقط به یک زیر مجموعه انتخاب شده از بلوک‌های کلید (key blocks) توجه کند. +گره توجه ناپیوسته بلوک مدل ComfyUI را تغییر می‌دهد تا مکانیزم توجه ناپیوسته بلوک را اعمال کند. این مکانیزم بار محاسباتی را کاهش می‌دهد زیرا به هر بلوک پرسش اجازه می‌دهد تا بر روی یک زیرگروه از بلوک‌های کلید تمرکز کند، به جای توجه به تمام بلوک‌های ممکن، که برای توالی‌های بلند بسیار مفید است. ## ورودی‌ها | پارامتر | توضیح | نوع داده | الزامی | محدوده | |-----------|-------------|-----------|----------|-------| -| `model` | مدل ComfyUI که باید بلوک-سبک توجه به آن اعمال شود. | MODEL | بله | N/A | -| `selection` | روش انتخاب بلوک‌های کلیدی که باید به آن‌ها توجه شود. | DYNAMIC_COMBO | بله | گزینه‌ها: Sol-Attn (自适应 tau)، top-k (SLA)، VSA (FastVideo) | -| `tau` | محدوده‌ی پارامتر score-distribution sigmas برای انتخاب Sol-Attn (自适应 tau). | FLOAT | خیر | پیش‌فرض: 1.3، حداقل: 0.0، حداکثر: 4.0، قدم: 0.05 | -| `keep_percent` | درصد بلوک‌های کلیدی که هر بلوک جستجو دقیقاً نگه می‌دارد برای top-k (SLA). | FLOAT | خیر | پیش‌فرض: 10.0، حداقل: 0.5، حداکثر: 95.0، قدم: 0.5 | -| `start_percent` | درصد برنامه قبل از آن که مدل از توجه چگال (dense attention) استفاده کند. | FLOAT | خیر | پیش‌فرض: 0.2، حداقل: 0.0، حداکثر: 1.0، قدم: 0.01 | -| `end_percent` | درصد برنامه بعد از آن که مدل از توجه چگال استفاده کند. | FLOAT | خیر | پیش‌فرض: 1.0، حداقل: 0.0، حداکثر: 1.0، قدم: 0.01 | -| `dense_blocks` | رشته‌ای که بلوک‌های ترانسفورمر که همیشه از توجه چگال استفاده می‌کنند را نشان می‌دهد. | STRING | خیر | پیش‌فرض: "" | -| `min_tokens` | تعداد حداقلی توکن‌ها در یک توالی برای آن که مدل از توجه چگال استفاده کند. | INT | خیر | پیش‌فرض: 12288، حداقل: 0، حداکثر: 1 << 20، قدم: 512 | -| `extra_tokens` | تعداد توکن‌های اضافی که هر بلوک جستجو به آن‌ها توجه می‌کند و فراتر از بلوک‌های انتخاب شده خود است. | INT | خیر | پیش‌فرض: 256، حداقل: 0، حداکثر: 256، قدم: 64 | -| `sink_conditioning` | ردیف‌های MiniMax-H3 برای استفاده در conditionining sink. | COMBO | خیر | گزینه‌ها: exact_kv، exact_kv_and_rows، off | -| `verbose` | اینکه آیا گزارش‌دهی دقیق (verbose logging) را فعال کنید یا خیر. | BOOLEAN | خیر | پیش‌فرض: False | +| `model` | مدل ComfyUI که باید به آن توجه ناپیوسته بلوک اعمال شود. | MODEL | بله | N/A | +| `selection` | روشی که برای تعیین بلوک‌های کلیدی که باید به آن‌ها توجه شود استفاده می‌شود. | DYNAMIC_COMBO | بله | گزینه‌ها: sol-attn (tau تطبیقی)، sla (top-k)، vsa (Video Sparse Attention) | +| `tau` | محدوده‌ی پارامتر در sigmas توزیع نمره برای روش sol-attn. | FLOAT | خیر | پیش‌فرض: 1.3، حداقل: 0.0، حداکثر: 4.0، قدم: 0.05 | +| `keep_percent` | درصدی از بلوک‌های کلیدی که هر بلوک پرسش دقیقاً نگه می‌دارد برای روش sla. | FLOAT | خیر | پیش‌فرض: 10.0، حداقل: 0.5، حداکثر: 95.0، قدم: 0.5 | +| `start_percent` | نقطه‌ی درصدی که توجه ناپیوسته شروع می‌شود. | FLOAT | خیر | پیش‌فرض: 0.2، حداقل: 0.0، حداکثر: 1.0، قدم: 0.01 | +| `end_percent` | نقطه‌ی درصدی که توجه ناپیوسته پایان می‌یابد. | FLOAT | خیر | پیش‌فرض: 1.0، حداقل: 0.0، حداکثر: 1.0، قدم: 0.01 | +| `dense_blocks` | رشته‌ای که بلوک‌های ترانسفورمر که همیشه باید از توجه چگال استفاده کنند را نشان می‌دهد. | STRING | خیر | پیش‌فرض: "" | +| `min_tokens` | تعداد حداقلی توکن‌ها در یک توالی که مدل از توجه چگال استفاده می‌کند. | INT | خیر | پیش‌فرض: 12288، حداقل: 0، حداکثر: 1 << 20، قدم: 512 | +| `extra_tokens` | تعداد توکن‌های اضافی برجسته که هر بلوک پرسش به آن‌ها توجه می‌کند. | INT | خیر | پیش‌فرض: 256، حداقل: 0، حداکثر: 256، قدم: 64 | +| `sink_conditioning` | ردیف‌های MiniMax-H3 برای استفاده در توجه نزولی. | COMBO | خیر | گزینه‌ها: exact_kv، exact_kv_and_rows، off | +| `verbose` | فعال‌سازی لاگ‌های دقیق. | BOOLEAN | خیر | پیش‌فرض: False | + +### یادداشت‌ها + +- پارامتر `selection` به شما اجازه می‌دهد تا بین روش‌های مختلف برای انتخاب بلوک‌های کلیدی انتخاب کنید: + - `sol-attn`: از یک محدوده تطبیقی برای انتخاب بلوک‌های کلیدی بر اساس توزیع نمره استفاده می‌کند. + - `sla`: یک درصد ثابت از بلوک‌های کلیدی برجسته را نگه می‌دارد. + - `vsa`: توجه ناپیوسته ویدیویی (Video Sparse Attention) را اعمال می‌کند که از کاشی‌بندی کره ویدئویی 3D و یک شاخه توجه خشناب شده یاد گرفته شده استفاده می‌کند. +- پارامتر `dense_blocks` می‌تواند برای مشخص کردن بلوک‌های ترانسفورمر که همیشه باید از توجه چگال استفاده کنند استفاده شود. +- پارامتر `min_tokens` تعداد حداقلی توکن‌ها در یک توالی را برای استفاده از توجه چگال تنظیم می‌کند. +- پارامتر `extra_tokens` به شما اجازه می‌دهد تعداد توکن‌های اضافی برجسته که هر بلوک پرسش به آن‌ها توجه می‌کند را مشخص کنید. +- پارامتر `sink_conditioning` تنها برای مدل‌های MiniMax-H3 مرتبط است و تعیین می‌کند که چگونه ردیف‌های توجه نزولی پردازش می‌شوند. +- پارامتر `verbose` لاگ‌های دقیق را فعال می‌کند که می‌تواند برای اشکال‌زدایی مفید باشد. ## خروجی‌ها | نام خروجی | توضیح | نوع داده | |-------------|-------------|-----------| -| `model` | مدل ComfyUI با توجه بلوک-سبک اعمال شده. | MODEL | +| `model` | مدل ComfyUI با توجه ناپیوسته بلوک اعمال شده. | MODEL | -### یادداشت‌ها +### محدودیت‌ها و محدودیت‌ها -- پارامتر `selection` روش انتخاب بلوک‌های کلیدی را تعیین می‌کند. گزینه‌ها عبارتند از: - - Sol-Attn (自适应 tau): هر بلوک جستجو به یک زیر مجموعه انتخاب شده از بلوک‌های کلیدی بر اساس یک محدوده‌ی自适应 توجه می‌کند. - - top-k (SLA): هر بلوک جستجو دقیقاً یک درصد ثابت از بلوک‌های کلیدی را نگه می‌دارد. - - VSA (FastVideo): هر بلوک جستجو دقیقاً یک درصد ثابت از بلوک‌های ویدیویی را نگه می‌دارد، از تiling و شاخه‌ی خشن FastH3-VSA استفاده می‌کند. -- پارامتر `dense_blocks` به شما اجازه می‌دهد تا بلوک‌های ترانسفورمر که همیشه از توجه چگال استفاده می‌کنند را مشخص کنید. -- پارامتر `min_tokens` تعداد حداقلی توکن‌ها در یک توالی را برای استفاده از توجه چگال تنظیم می‌کند. -- پارامتر `extra_tokens` تعداد توکن‌های اضافی را که هر بلوک جستجو به آن‌ها توجه می‌کند و فراتر از بلوک‌های انتخاب شده خود است، مشخص می‌کند. -- پارامتر `sink_conditioning` ردیف‌های MiniMax-H3 برای استفاده در conditionining sink را تعیین می‌کند. -- پارامتر `verbose` گزارش‌دهی دقیق (verbose logging) را فعال می‌کند. +- روش `sol-attn` نیاز به یک مقدار `tau` بین 0.0 و 4.0 دارد. +- روش `sla` نیاز به یک مقدار `keep_percent` بین 0.5 و 95.0 دارد. +- روش `vsa` تنها با مدل‌های MiniMax-H3 سازگار است و نیاز به داشتن لایه `to_gate_compress` در مدل دارد. +- پارامتر `min_tokens` باید یک عدد صحیح نامنفی باشد (با مقدار 0، تمام توجه‌ها متراکم باقی می‌مانند). +- پارامتر `extra_tokens` باید یک عدد غیرمنفی باشد. +- گزینه‌های `sink_conditioning` تنها برای مدل‌های MiniMax-H3 قابل اعمال هستند. > این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BlockSparseAttention/fa.md) --- -**Source fingerprint (SHA-256):** `6a27aee45593883f5958ae1aac74a2077362742a0fdf74fc9dbfd68eddc6d259` +**Source fingerprint (SHA-256):** `0c34876b49a04db0ab265526e2bb5f784e150591aab631713ad2ab420a3327c4` diff --git a/comfyui_embedded_docs/docs/BlockSparseAttention/fr.md b/comfyui_embedded_docs/docs/BlockSparseAttention/fr.md index ce4582763..013e00ff2 100644 --- a/comfyui_embedded_docs/docs/BlockSparseAttention/fr.md +++ b/comfyui_embedded_docs/docs/BlockSparseAttention/fr.md @@ -1,44 +1,53 @@ -# Block Sparse Attention +# Attention clairsemée par blocs du modèle ## Aperçu -Le nœud Block Sparse Attention applique un mécanisme d'attention bloc-sparse à un modèle ComfyUI, réduisant les calculs d'attention en permettant à chaque bloc de requête d'attendre uniquement un sous-ensemble sélectionné de blocs de clé exactement. +Le nœud Bloc d'Attention Sparse modifie un modèle ComfyUI pour appliquer un mécanisme d'attention sparse par bloc. Ce mécanisme réduit la charge computationnelle en permettant à chaque bloc de requête de se concentrer sur un sous-ensemble de blocs de clé, plutôt que de s'attacher à tous les blocs possibles, ce qui est particulièrement bénéfique pour les séquences longues. ## Entrées -| Paramètre | Description | Type de données | Obligatoire | Gamme | +| Paramètre | Description | Type de données | Obligatoire | Plage | |-----------|-------------|-----------|----------|-------| -| `model` | Le modèle ComfyUI auquel appliquer l'attention bloc-sparse. | MODEL | Oui | N/A | -| `selection` | La méthode de sélection pour choisir quels blocs de clé attendre. | DYNAMIC_COMBO | Oui | Options : Sol-Attn (tau adaptatif), top-k (SLA), VSA (FastVideo) | -| `tau` | Le seuil en sigmas de distribution des scores pour la sélection Sol-Attn (tau adaptatif). | FLOAT | Non | par défaut : 1.3, min : 0.0, max : 4.0, étape : 0.05 | -| `keep_percent` | Le pourcentage de blocs de clé que chaque bloc de requête conserve exactement pour la sélection top-k (SLA). | FLOAT | Non | par défaut : 10.0, min : 0.5, max : 95.0, étape : 0.5 | -| `start_percent` | Le pourcentage du programme avant lequel le modèle utilise une attention dense. | FLOAT | Non | par défaut : 0.2, min : 0.0, max : 1.0, étape : 0.01 | -| `end_percent` | Le pourcentage du programme après lequel le modèle utilise une attention dense. | FLOAT | Non | par défaut : 1.0, min : 0.0, max : 1.0, étape : 0.01 | -| `dense_blocks` | Une chaîne représentant les blocs de transfo qui utilisent toujours une attention dense. | STRING | Non | par défaut : "" | -| `min_tokens` | Le nombre minimum de tokens dans une séquence pour lequel le modèle utilise une attention dense. | INT | Non | par défaut : 12288, min : 0, max : 1 << 20, étape : 512 | -| `extra_tokens` | Le nombre de tokens supplémentaires de haute note que chaque bloc de requête attend au-delà de ses blocs sélectionnés. | INT | Non | par défaut : 256, min : 0, max : 256, étape : 64 | -| `sink_conditioning` | Les lignes de conditionnement MiniMax-H3 à utiliser pour le conditionnement de puits. | COMBO | Non | Options : exact_kv, exact_kv_and_rows, off | -| `verbose` | Si activer le journalisation verbeuse. | BOOLEAN | Non | par défaut : False | +| `model` | Le modèle ComfyUI auquel appliquer l'attention sparse par bloc. | MODEL | Oui | N/A | +| `selection` | La méthode utilisée pour déterminer quels blocs de clé doivent être pris en compte. | COMBO DYNAMIQUE | Oui | Options : sol-attn (tau adaptatif), sla (top-k), vsa (Video Sparse Attention) | +| `tau` | Le seuil en sigmas de distribution des scores pour la méthode sol-attn. | FLOAT | Non | par défaut : 1.3, min : 0.0, max : 4.0, pas : 0.05 | +| `keep_percent` | Le pourcentage de blocs de clé que chaque bloc de requête conserve exactement pour la méthode sla. | FLOAT | Non | par défaut : 10.0, min : 0.5, max : 95.0, pas : 0.5 | +| `start_percent` | Le pourcentage de point où l'attention sparse commence. | FLOAT | Non | par défaut : 0.2, min : 0.0, max : 1.0, pas : 0.01 | +| `end_percent` | Le pourcentage de point où l'attention sparse se termine. | FLOAT | Non | par défaut : 1.0, min : 0.0, max : 1.0, pas : 0.01 | +| `dense_blocks` | Une chaîne représentant les blocs de transformer qui doivent toujours utiliser l'attention dense. | STRING | Non | par défaut : "" | +| `min_tokens` | Le nombre minimum de tokens dans une séquence pour lequel le modèle utilise l'attention dense. | INTÉGRAL | Non | par défaut : 12288, min : 0, max : 1 << 20, pas : 512 | +| `extra_tokens` | Le nombre de tokens supplémentaires de score le plus élevé que chaque bloc de requête prend en compte au-delà de ses blocs sélectionnés. | INTÉGRAL | Non | par défaut : 256, min : 0, max : 256, pas : 64 | +| `sink_conditioning` | Les rangées de conditionnement MiniMax-H3 à utiliser pour le conditionnement de puits. | COMBO | Non | Options : exact_kv, exact_kv_and_rows, off | +| `verbose` | Active le journalisation verbale. | BOOLEEN | Non | par défaut : Faux | + +### Notes + +- Le paramètre `selection` vous permet de choisir entre différentes méthodes pour sélectionner les blocs de clé : + - `sol-attn` : Utilise un seuil adaptatif pour sélectionner les blocs de clé en fonction de la distribution des scores. + - `sla` : Conserve un pourcentage fixe des blocs de clé les plus bien notés. + - `vsa` : Applique l'Attention Sparse Vidéo, qui utilise le tiling en cube vidéo 3D et une branche d'attention grossière apprise. +- Le paramètre `dense_blocks` peut être utilisé pour spécifier les blocs de transformer qui doivent toujours utiliser l'attention dense. +- Le paramètre `min_tokens` définit le nombre minimum de tokens dans une séquence pour lequel l'attention dense est utilisée. +- Le paramètre `extra_tokens` permet de spécifier le nombre de tokens supplémentaires de score le plus élevé que chaque bloc de requête doit prendre en compte. +- Le paramètre `sink_conditioning` est pertinent uniquement pour les modèles MiniMax-H3 et détermine comment les rangées de conditionnement sont traitées. +- Le paramètre `verbose` active la journalisation détaillée, ce qui peut être utile pour le débogage. ## Sorties -| Nom de sortie | Description | Type de données | +| Nom de la sortie | Description | Type de données | |-------------|-------------|-----------| -| `model` | Le modèle ComfyUI avec l'attention bloc-sparse appliquée. | MODEL | +| `model` | Le modèle ComfyUI auquel l'attention sparse par bloc a été appliquée. | MODEL | -### Notes +### Contraintes et Limites -- Le paramètre `selection` détermine comment les blocs de clé sont choisis. Les options sont : - - Sol-Attn (tau adaptatif) : Chaque bloc de requête attend un sous-ensemble sélectionné de blocs de clé en fonction d'un seuil adaptatif. - - top-k (SLA) : Chaque bloc de requête conserve un pourcentage fixe de blocs de clé exactement. - - VSA (FastVideo) : Chaque bloc de requête conserve un pourcentage fixe de cubes vidéo exactement, en utilisant le tiling de cube et la branche grossière de FastH3-VSA. -- Le paramètre `dense_blocks` permet de spécifier les blocs de transfo qui utilisent toujours une attention dense. -- Le paramètre `min_tokens` définit le nombre minimum de tokens dans une séquence pour lequel le modèle utilise une attention dense. -- Le paramètre `extra_tokens` permet de spécifier le nombre de tokens supplémentaires de haute note que chaque bloc de requête attend au-delà de ses blocs sélectionnés. -- Le paramètre `sink_conditioning` détermine les lignes de conditionnement MiniMax-H3 à utiliser pour le conditionnement de puits. -- Le paramètre `verbose` active la journalisation verbeuse. +- La méthode `sol-attn` nécessite une valeur de `tau` entre 0.0 et 4.0. +- La méthode `sla` nécessite une valeur de `keep_percent` entre 0.5 et 95.0. +- La méthode `vsa` est compatible uniquement avec les modèles MiniMax-H3 et nécessite que le modèle ait une couche `to_gate_compress`. +- Le paramètre `min_tokens` doit être un entier positif ou nul (0 conserve toute l'attention en mode dense). +- Le paramètre `extra_tokens` doit être un entier non négatif. +- Les options `sink_conditioning` sont pertinentes uniquement pour les modèles MiniMax-H3. > 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/BlockSparseAttention/fr.md) --- -**Source fingerprint (SHA-256):** `6a27aee45593883f5958ae1aac74a2077362742a0fdf74fc9dbfd68eddc6d259` +**Source fingerprint (SHA-256):** `0c34876b49a04db0ab265526e2bb5f784e150591aab631713ad2ab420a3327c4` diff --git a/comfyui_embedded_docs/docs/BlockSparseAttention/ja.md b/comfyui_embedded_docs/docs/BlockSparseAttention/ja.md index cf8fee379..bb8097721 100644 --- a/comfyui_embedded_docs/docs/BlockSparseAttention/ja.md +++ b/comfyui_embedded_docs/docs/BlockSparseAttention/ja.md @@ -1,44 +1,53 @@ -# Block Sparse Attention +# モデルのブロックスパースアテンション ## 概要 -Block Sparse Attention ノードは、ComfyUI モデルにブロック稀疏な注意機構を適用し、各クエリブロックが選択されたキーブロックの一部のみに注意を払うことで、注意計算を減少させます。 +ブロックスパースアテンションノードは、ComfyUIモデルにブロックスパースアテンションメカニズムを適用するために使用されます。このメカニズムは、各クエリブロックが全ての可能性のあるブロックではなく、キーブロックの一部にのみ焦点を当てることを許可することで、計算負荷を削減します。これは特に長いシークエンスに対して非常に有益です。 ## 入力 -| パラメータ | 説明 | データ型 | 必須 | 范囲 | -|-----------|-------------|-----------|----------|-------| -| `model` | ブロック稀疏な注意を適用する ComfyUI モデル。 | MODEL | はい | なし | -| `selection` | キーブロックの選択方法。 | DYNAMIC_COMBO | はい | オプション: Sol-Attn (適応的な tau), top-k (SLA), VSA (FastVideo) | -| `tau` | Sol-Attn (適応的な tau) 選択のためのスコア分布シグマの閾値。 | FLOAT | いいえ | デフォルト: 1.3, 最小: 0.0, 最大: 4.0, ステップ: 0.05 | -| `keep_percent` | top-k (SLA) 選択において、各クエリブロックが正確に保持するキーブロックの割合。 | FLOAT | いいえ | デフォルト: 10.0, 最小: 0.5, 最大: 95.0, ステップ: 0.5 | -| `start_percent` | モデルが dense attention を使用するスケジュールの前にまでの割合。 | FLOAT | いいえ | デフォルト: 0.2, 最小: 0.0, 最大: 1.0, ステップ: 0.01 | -| `end_percent` | モデルが dense attention を使用するスケジュールの後までの割合。 | FLOAT | いいえ | デフォルト: 1.0, 最小: 0.0, 最大: 1.0, ステップ: 0.01 | -| `dense_blocks` | 恒に dense attention を実行するトランスフォーマーブロックを表す文字列。 | STRING | いいえ | デフォルト: "" | -| `min_tokens` | モデルが dense attention を使用するシーケンスのトークンの最小数。 | INT | いいえ | デフォルト: 12288, 最小: 0, 最大: 1 << 20, ステップ: 512 | -| `extra_tokens` | 各クエリブロックが選択されたブロックの他に注意を払う最高評価トークンの数。 | INT | いいえ | デフォルト: 256, 最小: 0, 最大: 256, ステップ: 64 | -| `sink_conditioning` | MiniMax-H3 condition rows を使用するシンクコーディング。 | COMBO | いいえ | オプション: exact_kv, exact_kv_and_rows, off | -| `verbose` | 詳細なログ出力を有効にするかどうか。 | BOOLEAN | いいえ | デフォルト: False | +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|------------|------|---------|------|-------| +| `model` | ブロックスパースアテンションを適用するComfyUIモデル | MODEL | はい | N/A | +| `selection` | キーブロックの選択に使用される方法 | DYNAMIC_COMBO | はい | オプション: sol-attn (適応型tau), sla (top-k), vsa (Video Sparse Attention) | +| `tau` | sol-attnメソッドのスコア分布シグマの閾値 | FLOAT | いいえ | デフォルト: 1.3, 最小: 0.0, 最大: 4.0, ステップ: 0.05 | +| `keep_percent` | slaメソッドの各クエリブロックが正確に保持するキーブロックの割合 | FLOAT | いいえ | デフォルト: 10.0, 最小: 0.5, 最大: 95.0, ステップ: 0.5 | +| `start_percent` | スパースアテンションが開始するパーセントポイント | FLOAT | いいえ | デフォルト: 0.2, 最小: 0.0, 最大: 1.0, ステップ: 0.01 | +| `end_percent` | スパースアテンションが終了するパーセントポイント | FLOAT | いいえ | デフォルト: 1.0, 最小: 0.0, 最大: 1.0, ステップ: 0.01 | +| `dense_blocks` | 常に稠密注意力を使用するトランスフォーマーブロックを表す文字列 | STRING | いいえ | デフォルト: "" | +| `min_tokens` | モデルが稠密注意力を使用するシークエンスのトークン数の最小値 | INT | いいえ | デフォルト: 12288, 最小: 0, 最大: 1 << 20, ステップ: 512 | +| `extra_tokens` | 各クエリブロックが選択したブロックを超えて注目する最高評価トークンの数 | INT | いいえ | デフォルト: 256, 最小: 0, 最大: 256, ステップ: 64 | +| `sink_conditioning` | 使用するMiniMax-H3の条件行のMiniMax-H3条件 | COMBO | いいえ | オプション: exact_kv, exact_kv_and_rows, off | +| `verbose` | 詳細なログ出力を有効にします | BOOLEAN | いいえ | デフォルト: False | + +### 注意事項 + +- `selection`パラメータを使用して、キーブロックの選択方法を選択できます: + - `sol-attn`: スコア分布に基づいて適応型閾値を使用してキーブロックを選択します。 + - `sla`: 最高評価のキーブロックの固定割合を保持します。 + - `vsa`: Video Sparse Attentionを適用し、3Dビデオキューブタイルと学習済みの粗い注意力ブランチを使用します。 +- `dense_blocks`パラメータを使用して、常に稠密注意力を使用するトランスフォーマーブロックを指定できます。 +- `min_tokens`パラメータは、稠密注意力が使用されるシークエンスのトークン数の最小値を設定します。 +- `extra_tokens`パラメータを使用して、各クエリブロックが注目する追加の最高評価トークンの数を指定できます。 +- `sink_conditioning`パラメータは、MiniMax-H3モデルにのみ関連しており、条件行の処理方法を決定します。 +- `verbose`パラメータは、詳細なログ出力を有効にし、デバッグに役立ちます。 ## 出力 | 出力名 | 説明 | データ型 | -|-------------|-------------|-----------| -| `model` | ブロック稀疏な注意が適用された ComfyUI モデル。 | MODEL | +|--------|------|---------| +| `model` | ブロックスパースアテンションが適用されたComfyUIモデル | MODEL | -### ノート +### 制約と制限 -- `selection` パラメータは、キーブロックの選択方法を決定します。オプションは以下の通りです: - - Sol-Attn (適応的な tau): 各クエリブロックが適応的な閾値に基づいて選択されたキーブロックの一部に注意を払います。 - - top-k (SLA): 各クエリブロックが正確に保持するキーブロックの固定割合を保持します。 - - VSA (FastVideo): 各クエリブロックが固定割合のビデオキューブに注意を払います。FastH3-VSAのキューブタイルとコースブランチを使用します。 -- `dense_blocks` パラメータは、恒に dense attention を実行するトランスフォーマーブロックを指定できます。 -- `min_tokens` パラメータは、モデルが dense attention を使用するシーケンスのトークンの最小数を設定します。 -- `extra_tokens` パラメータは、各クエリブロックが選択されたブロックの他に注意を払う最高評価トークンの数を指定できます。 -- `sink_conditioning` パラメータは、シンクコーディングに使用する MiniMax-H3 condition rows を決定します。 -- `verbose` パラメータは、詳細なログ出力を有効にします。 +- `sol-attn`メソッドは、0.0から4.0の間の`tau`値が必要です。 +- `sla`メソッドは、0.5から95.0の間の`keep_percent`値が必要です。 +- `vsa`メソッドは、MiniMax-H3モデルと互換性があり、モデルに`to_gate_compress`レイヤーがある必要があります。 +- `min_tokens`パラメータは、0以上の整数である必要があります(0に設定するとすべてのアテンションが密になります)。 +- `extra_tokens`パラメータは、非負の整数でなければなりません。 +- `sink_conditioning`オプションは、MiniMax-H3モデルにのみ適用されます。 > このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BlockSparseAttention/ja.md) --- -**Source fingerprint (SHA-256):** `6a27aee45593883f5958ae1aac74a2077362742a0fdf74fc9dbfd68eddc6d259` +**Source fingerprint (SHA-256):** `0c34876b49a04db0ab265526e2bb5f784e150591aab631713ad2ab420a3327c4` diff --git a/comfyui_embedded_docs/docs/BlockSparseAttention/ko.md b/comfyui_embedded_docs/docs/BlockSparseAttention/ko.md index e1d0b6b66..24bba5a49 100644 --- a/comfyui_embedded_docs/docs/BlockSparseAttention/ko.md +++ b/comfyui_embedded_docs/docs/BlockSparseAttention/ko.md @@ -1,44 +1,53 @@ -# Block Sparse Attention +# 모델 희소 어텐션 ## 개요 -Block Sparse Attention 노드는 ComfyUI 모델에 블록-스파스 어텐션 메커니즘을 적용하여, 각 쿼리 블록이 선택된 키 블록 집합에만 어텐션을 주도록 하여 어텐션 계산을 줄입니다. +블록 스파르스 어텐션 노드는 ComfyUI 모델에 블록 스파르스 어텐션 기제를 적용하도록 변경합니다. 이 기제는 각 쿼리 블록이 모든 가능한 블록 대신 일부 키 블록에만 집중할 수 있도록 하여 계산 부담을 줄입니다. 이는 특히 장순열에 매우 유익합니다. ## 입력 | 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | |-----------|-------------|-----------|----------|-------| -| `model` | 블록-스파스 어텐션을 적용할 ComfyUI 모델. | MODEL | 예 | N/A | -| `selection` | 어텐션할 키 블록을 선택하는 선택 방법. | DYNAMIC_COMBO | 예 | 옵션: Sol-Attn (적응형 tau), top-k (SLA), VSA (FastVideo) | -| `tau` | Sol-Attn (적응형 tau) 선택에 사용할 스코어 분포 시그마의 임계값. | FLOAT | 아님 | 기본: 1.3, 최소: 0.0, 최대: 4.0, 단위: 0.05 | -| `keep_percent` | top-k (SLA) 선택에서 각 쿼리 블록이 정확히 유지할 키 블록의 비율. | FLOAT | 아님 | 기본: 10.0, 최소: 0.5, 최대: 95.0, 단위: 0.5 | -| `start_percent` | 모델이 밀집형 어텐션을 사용할 스케줄의 시작 비율. | FLOAT | 아님 | 기본: 0.2, 최소: 0.0, 최대: 1.0, 단위: 0.01 | -| `end_percent` | 모델이 밀집형 어텐션을 사용할 스케줄의 종료 비율. | FLOAT | 아님 | 기본: 1.0, 최소: 0.0, 최대: 1.0, 단위: 0.01 | -| `dense_blocks` | 항상 밀집형 어텐션을 실행하는 트랜스포머 블록을 나타내는 문자열. | STRING | 아님 | 기본: "" | -| `min_tokens` | 모델이 밀집형 어텐션을 사용할 시퀀스의 토큰 수의 최소값. | INT | 아님 | 기본: 12288, 최소: 0, 최대: 1 << 20, 단위: 512 | -| `extra_tokens` | 각 쿼리 블록이 선택된 블록 이상으로 어텐션할 최고 점수 토큰의 수. | INT | 아님 | 기본: 256, 최소: 0, 최대: 256, 단위: 64 | -| `sink_conditioning` | sink conditioning에 사용할 MiniMax-H3 조건 행. | COMBO | 아님 | 옵션: exact_kv, exact_kv_and_rows, off | -| `verbose` | 상세 로깅을 활성화할지 여부. | BOOLEAN | 아님 | 기본: False | +| `model` | 블록 스파르스 어텐션을 적용할 ComfyUI 모델. | MODEL | 예 | N/A | +| `selection` | 어느 키 블록을 어텐션할지 결정하는 방법. | 다이나믹 콤보 | 예 | 옵션: sol-attn (적응형 tau), sla (top-k), vsa (비디오 스파르스 어텐션) | +| `tau` | sol-attn 방법에서 스코어 분포의 스케일에서의 임계값. | FLOAT | 아님 | 기본: 1.3, 최소: 0.0, 최대: 4.0, 단위: 0.05 | +| `keep_percent` | sla 방법에서 각 쿼리 블록이 정확히 유지할 키 블록의 비율. | FLOAT | 아님 | 기본: 10.0, 최소: 0.5, 최대: 95.0, 단위: 0.5 | +| `start_percent` | 스파르스 어텐션이 시작할 비율 점. | FLOAT | 아님 | 기본: 0.2, 최소: 0.0, 최대: 1.0, 단위: 0.01 | +| `end_percent` | 스파르스 어텐션이 끝날 비율 점. | FLOAT | 아님 | 기본: 1.0, 최소: 0.0, 최대: 1.0, 단위: 0.01 | +| `dense_blocks` | 항상 밀집 어텐션을 사용할 트랜스포머 블록을 나타내는 문자열. | STRING | 아님 | 기본: "" | +| `min_tokens` | 모델이 밀집 어텐션을 사용할 순서의 토큰 수의 최소값. | INT | 아님 | 기본: 12288, 최소: 0, 최대: 1 << 20, 단위: 512 | +| `extra_tokens` | 각 쿼리 블록이 선택된 블록 이상으로 어텐션할 최상급 토큰 수. | INT | 아님 | 기본: 256, 최소: 0, 최대: 256, 단위: 64 | +| `sink_conditioning` | 사용할 MiniMax-H3 조건 행을 나타내는 MiniMax-H3 조건. | COMBO | 아님 | 옵션: exact_kv, exact_kv_and_rows, off | +| `verbose` | 상세 로깅을 활성화합니다. | BOOLEAN | 아님 | 기본: False | + +### 주의사항 + +- `selection` 매개변수는 다른 키 블록 선택 방법 중 하나를 선택할 수 있습니다: + - `sol-attn`: 스코어 분포에 기반하여 적응형 임계값을 사용하여 키 블록을 선택합니다. + - `sla`: 가장 높은 점수를 가진 키 블록의 일정 비율을 유지합니다. + - `vsa`: 비디오 스파르스 어텐션을 적용하며, 3D 비디오-큐브 타일링과 학습된 대략적인 어텐션 브랜치를 사용합니다. +- `dense_blocks` 매개변수는 항상 밀집 어텐션을 사용할 트랜스포머 블록을 지정할 수 있습니다. +- `min_tokens` 매개변수는 밀집 어텐션을 사용할 순서의 토큰 수의 최소값을 설정합니다. +- `extra_tokens` 매개변수는 각 쿼리 블록이 선택된 블록 이상으로 어텐션할 추가적인 최상급 토큰 수를 지정합니다. +- `sink_conditioning` 매개변수는 MiniMax-H3 모델에만 관련이 있으며, 조건 행을 처리하는 방법을 결정합니다. +- `verbose` 매개변수는 상세 로깅을 활성화하여 디버깅에 유용할 수 있습니다. ## 출력 | 출력 이름 | 설명 | 데이터 타입 | |-------------|-------------|-----------| -| `model` | 블록-스파스 어텐션을 적용한 ComfyUI 모델. | MODEL | +| `model` | 블록 스파르스 어텐션을 적용한 ComfyUI 모델. | MODEL | -### 주의사항 +### 제약 사항 및 제한 사항 -- `selection` 매개변수는 키 블록 선택 방법을 결정합니다. 옵션은 다음과 같습니다: - - Sol-Attn (적응형 tau): 각 쿼리 블록이 적응형 임계값에 기반하여 선택된 키 블록 집합에 어텐션을 합니다. - - top-k (SLA): 각 쿼리 블록이 정확히 유지할 키 블록의 비율을 고정합니다. - - VSA (FastVideo): 각 쿼리 블록이 FastH3-VSA의 쿼드 블록 타일링과 코arse branch를 사용하여 정확히 유지할 비디오 쿼드 블록의 비율을 고정합니다. -- `dense_blocks` 매개변수는 항상 밀집형 어텐션을 실행하는 트랜스포머 블록을 지정할 수 있습니다. -- `min_tokens` 매개변수는 모델이 밀집형 어텐션을 사용할 시퀀스의 토큰 수의 최소값을 설정합니다. -- `extra_tokens` 매개변수는 각 쿼리 블록이 선택된 블록 이상으로 어텐션할 최고 점수 토큰의 수를 지정할 수 있습니다. -- `sink_conditioning` 매개변수는 sink conditioning에 사용할 MiniMax-H3 조건 행을 결정합니다. -- `verbose` 매개변수는 상세 로깅을 활성화합니다. +- `sol-attn` 방법은 0.0과 4.0 사이의 `tau` 값을 요구합니다. +- `sla` 방법은 0.5과 95.0 사이의 `keep_percent` 값을 요구합니다. +- `vsa` 방법은 MiniMax-H3 모델과 호환되며, 모델이 `to_gate_compress` 레이어를 가지고 있어야 합니다. +- `min_tokens` 매개변수는 0 이상의 정수여야 합니다 (0이면 모든 어텐션이 밀집 상태로 유지됩니다). +- `extra_tokens` 매개변수는 음수여야 합니다. +- `sink_conditioning` 옵션은 MiniMax-H3 모델에만 적용됩니다. > 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BlockSparseAttention/ko.md) --- -**Source fingerprint (SHA-256):** `6a27aee45593883f5958ae1aac74a2077362742a0fdf74fc9dbfd68eddc6d259` +**Source fingerprint (SHA-256):** `0c34876b49a04db0ab265526e2bb5f784e150591aab631713ad2ab420a3327c4` diff --git a/comfyui_embedded_docs/docs/BlockSparseAttention/pt-BR.md b/comfyui_embedded_docs/docs/BlockSparseAttention/pt-BR.md index 03ec37cff..dad070c68 100644 --- a/comfyui_embedded_docs/docs/BlockSparseAttention/pt-BR.md +++ b/comfyui_embedded_docs/docs/BlockSparseAttention/pt-BR.md @@ -1,44 +1,53 @@ -# Block Sparse Attention +# Atenção Esparsa em Blocos do Modelo ## Visão Geral -O nó de Atenção Esparsa por Bloco aplica um mecanismo de atenção esparsa por bloco a um modelo do ComfyUI, reduzindo a computação de atenção permitindo que cada bloco de consulta atenda apenas a um subconjunto selecionado de blocos de chave exatamente. +O nó de Bloco de Atenção Esparsa modifica um modelo do ComfyUI para aplicar um mecanismo de atenção esparsa por bloco. Este mecanismo reduz a carga computacional permitindo que cada bloco de consulta se concentre em um subconjunto de blocos de chave, em vez de atender a todos os possíveis blocos, o que é particularmente benéfico para sequências longas. ## Entradas | Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | |-----------|-------------|-----------|----------|-------| | `model` | O modelo do ComfyUI ao qual aplicar a atenção esparsa por bloco. | MODEL | Sim | N/A | -| `selection` | O método de seleção para escolher quais blocos de chave atender. | DYNAMIC_COMBO | Sim | Opções: Sol-Attn (tau adaptativo), top-k (SLA), VSA (FastVideo) | -| `tau` | O limiar na distribuição de scores sigmas para a seleção Sol-Attn (tau adaptativo). | FLOAT | Não | padrão: 1.3, min: 0.0, max: 4.0, passo: 0.05 | -| `keep_percent` | A porcentagem de blocos de chave que cada bloco de consulta mantém exatamente para a seleção top-k (SLA). | FLOAT | Não | padrão: 10.0, min: 0.5, max: 95.0, passo: 0.5 | -| `start_percent` | A porcentagem do cronograma antes da qual o modelo usa atenção densa. | FLOAT | Não | padrão: 0.2, min: 0.0, max: 1.0, passo: 0.01 | -| `end_percent` | A porcentagem do cronograma após a qual o modelo usa atenção densa. | FLOAT | Não | padrão: 1.0, min: 0.0, max: 1.0, passo: 0.01 | +| `selection` | O método usado para determinar quais blocos de chave devem ser atendidos. | DYNAMIC_COMBO | Sim | Opções: sol-attn (tau adaptativo), sla (top-k), vsa (Video Sparse Attention) | +| `tau` | O limiar na distribuição de scores em sigmas para o método sol-attn. | FLOAT | Não | padrão: 1.3, min: 0.0, max: 4.0, passo: 0.05 | +| `keep_percent` | A porcentagem de blocos de chave que cada bloco de consulta mantém exatamente para o método sla. | FLOAT | Não | padrão: 10.0, min: 0.5, max: 95.0, passo: 0.5 | +| `start_percent` | O ponto percentual quando a atenção esparsa começa. | FLOAT | Não | padrão: 0.2, min: 0.0, max: 1.0, passo: 0.01 | +| `end_percent` | O ponto percentual quando a atenção esparsa termina. | FLOAT | Não | padrão: 1.0, min: 0.0, max: 1.0, passo: 0.01 | | `dense_blocks` | Uma string que representa os blocos do transformador que sempre executam atenção densa. | STRING | Não | padrão: "" | | `min_tokens` | O número mínimo de tokens em uma sequência para o qual o modelo usa atenção densa. | INT | Não | padrão: 12288, min: 0, max: 1 << 20, passo: 512 | -| `extra_tokens` | O número de tokens extra de alto score que cada bloco de consulta atende além dos seus blocos selecionados. | INT | Não | padrão: 256, min: 0, max: 256, passo: 64 | +| `extra_tokens` | O número de tokens de alto score adicionais que cada bloco de consulta deve atender além dos seus blocos selecionados. | INT | Não | padrão: 256, min: 0, max: 256, passo: 64 | | `sink_conditioning` | As linhas de condição MiniMax-H3 a serem usadas para condição de escoamento. | COMBO | Não | Opções: exact_kv, exact_kv_and_rows, off | -| `verbose` | Se habilitar o log detalhado. | BOOLEAN | Não | padrão: Falso | +| `verbose` | Habilita log detalhado. | BOOLEAN | Não | padrão: Falso | + +### Notas + +- O parâmetro `selection` permite escolher entre diferentes métodos para selecionar blocos de chave: + - `sol-attn`: Usa um limiar adaptativo para selecionar blocos de chave com base na distribuição de scores. + - `sla`: Mantém uma porcentagem fixa dos blocos de chave de alto score. + - `vsa`: Aplica Atenção Esparsa de Vídeo (Video Sparse Attention), que usa mosaico de cubo 3D de vídeo e uma ramificação de atenção grossa aprendida. +- O parâmetro `dense_blocks` pode ser usado para especificar blocos do transformador que devem sempre usar atenção densa. +- O parâmetro `min_tokens` define o número mínimo de tokens em uma sequência para o qual é usada atenção densa. +- O parâmetro `extra_tokens` permite especificar o número de tokens de alto score adicionais que cada bloco de consulta deve atender. +- O parâmetro `sink_conditioning` é relevante apenas para modelos MiniMax-H3 e determina como as linhas de condição são tratadas. +- O parâmetro `verbose` habilita log detalhado, o que pode ser útil para depuração. ## Saídas | Nome da Saída | Descrição | Tipo de Dados | |-------------|-------------|-----------| -| `model` | O modelo do ComfyUI com atenção esparsa por bloco aplicada. | MODEL | +| `model` | O modelo do ComfyUI com a atenção esparsa por bloco aplicada. | MODEL | -### Notas +### Restrições e Limitações -- O parâmetro `selection` determina como os blocos de chave são escolhidos. As opções são: - - Sol-Attn (tau adaptativo): Cada bloco de consulta atende a um subconjunto selecionado de blocos de chave com base em um limiar adaptativo. - - top-k (SLA): Cada bloco de consulta mantém uma porcentagem fixa de blocos de chave exatamente. - - VSA (FastVideo): Cada bloco de consulta mantém uma porcentagem fixa de cubos de vídeo exatamente, usando o mosaico de cubos e rama grossa do FastH3-VSA. -- O parâmetro `dense_blocks` permite que você especifique os blocos do transformador que sempre executam atenção densa. -- O parâmetro `min_tokens` define o número mínimo de tokens em uma sequência para o qual o modelo usa atenção densa. -- O parâmetro `extra_tokens` permite que você especifique o número de tokens extra de alto score que cada bloco de consulta atende além dos seus blocos selecionados. -- O parâmetro `sink_conditioning` determina as linhas de condição MiniMax-H3 a serem usadas para condição de escoamento. -- O parâmetro `verbose` habilita o log detalhado. +- O método `sol-attn` requer um valor de `tau` entre 0.0 e 4.0. +- O método `sla` requer um valor de `keep_percent` entre 0.5 e 95.0. +- O método `vsa` é compatível apenas com modelos MiniMax-H3 e requer que o modelo tenha uma camada `to_gate_compress`. +- O parâmetro `min_tokens` deve ser um inteiro não negativo (com 0, toda a atenção permanece densa). +- O parâmetro `extra_tokens` deve ser um inteiro não negativo. +- As opções de `sink_conditioning` são aplicáveis apenas a modelos MiniMax-H3. > 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/BlockSparseAttention/pt-BR.md) --- -**Source fingerprint (SHA-256):** `6a27aee45593883f5958ae1aac74a2077362742a0fdf74fc9dbfd68eddc6d259` +**Source fingerprint (SHA-256):** `0c34876b49a04db0ab265526e2bb5f784e150591aab631713ad2ab420a3327c4` diff --git a/comfyui_embedded_docs/docs/BlockSparseAttention/ru.md b/comfyui_embedded_docs/docs/BlockSparseAttention/ru.md index 463039047..240618992 100644 --- a/comfyui_embedded_docs/docs/BlockSparseAttention/ru.md +++ b/comfyui_embedded_docs/docs/BlockSparseAttention/ru.md @@ -1,44 +1,53 @@ -# Block Sparse Attention +# Блочно-разреженное внимание модели ## Обзор -Узел Block Sparse Attention applies блок-спарсинговую механизму внимания к модели ComfyUI, что уменьшает вычисления внимания, позволяя каждому блоку запроса attending только выбранному подмножеству блоков ключей точно. +Узел Block Sparse Attention модифицирует модель ComfyUI для применения механизма блок-спарсинга внимания. Этот механизм уменьшает вычислительную нагрузку, позволяя каждому блоку запроса фокусироваться на подмножестве блоков ключей, а не на всех возможных блоках, что особенно полезно для длинных последовательностей. ## Входы | Параметр | Описание | Тип данных | Обязателен | Диапазон | |-----------|-------------|-----------|----------|-------| -| `model` | Модель ComfyUI, к которой applies блок-спарсинговую механизму внимания. | МОДЕЛЬ | Да | N/A | -| `selection` | Метод выбора, который используется для выбора, какие блоки ключей attending. | ДИНАМИЧЕСКАЯ КОМБО | Да | Опции: Sol-Attn (адаптивный tau), top-k (SLA), VSA (FastVideo) | -| `tau` | Порог в сигмах распределения оценок для Sol-Attn (адаптивный tau) выбора. | ФЛОАТ | Нет | по умолчанию: 1.3, мин: 0.0, макс: 4.0, шаг: 0.05 | -| `keep_percent` | Процент блоков ключей, которые каждый блок запроса сохраняет точно для top-k (SLA) выбора. | ФЛОАТ | Нет | по умолчанию: 10.0, мин: 0.5, макс: 95.0, шаг: 0.5 | -| `start_percent` | Процент расписания до которого модель использует сплошное внимание. | ФЛОАТ | Нет | по умолчанию: 0.2, мин: 0.0, макс: 1.0, шаг: 0.01 | -| `end_percent` | Процент расписания после которого модель использует сплошное внимание. | ФЛОАТ | Нет | по умолчанию: 1.0, мин: 0.0, макс: 1.0, шаг: 0.01 | -| `dense_blocks` | Строка, представляющая трансформаторные блоки, которые всегда выполняют сплошное внимание. | СТРОКА | Нет | по умолчанию: "", | +| `model` | Модель ComfyUI, к которой применяется блок-спарсинг внимания. | MODEL | Да | N/A | +| `selection` | Метод, используемый для определения, какие блоки ключей следует учитывать. | ДИНАМИЧЕСКАЯ КОМБО | Да | Опции: sol-attn (адаптивный tau), sla (top-k), vsa (Video Sparse Attention) | +| `tau` | Порог в сигмах распределения оценок для метода sol-attn. | ФЛОАТ | Нет | по умолчанию: 1.3, мин: 0.0, макс: 4.0, шаг: 0.05 | +| `keep_percent` | Процент блоков ключей, которые каждый блок запроса сохраняет точно для метода sla. | ФЛОАТ | Нет | по умолчанию: 10.0, мин: 0.5, макс: 95.0, шаг: 0.5 | +| `start_percent` | Процентный пункт, когда начинается спарсинг внимания. | ФЛОАТ | Нет | по умолчанию: 0.2, мин: 0.0, макс: 1.0, шаг: 0.01 | +| `end_percent` | Процентный пункт, когда заканчивается спарсинг внимания. | ФЛОАТ | Нет | по умолчанию: 1.0, мин: 0.0, макс: 1.0, шаг: 0.01 | +| `dense_blocks` | Строка, представляющая трансформаторные блоки, которые всегда используют сплошное внимание. | STRING | Нет | по умолчанию: "" | | `min_tokens` | Минимальное количество токенов в последовательности, для которой модель использует сплошное внимание. | ИНТ | Нет | по умолчанию: 12288, мин: 0, макс: 1 << 20, шаг: 512 | -| `extra_tokens` | Количество дополнительных топ-оценочных токенов, которые каждый блок запроса attends за пределами своих выбранных блоков. | ИНТ | Нет | по умолчанию: 256, мин: 0, макс: 256, шаг: 64 | +| `extra_tokens` | Количество дополнительных топ-оценочных токенов, которые каждый блок запроса учитывает сверх своих выбранных блоков. | ИНТ | Нет | по умолчанию: 256, мин: 0, макс: 256, шаг: 64 | | `sink_conditioning` | Строки MiniMax-H3 для использования в sink conditioning. | КОМБО | Нет | Опции: exact_kv, exact_kv_and_rows, off | -| `verbose` | Включить ли verbose logging. | БОЛЕЕ-МЕНЕЕ | Нет | по умолчанию: False | +| `verbose` | Включает подробное логирование. | MODEL | Нет | по умолчанию: False | + +### Замечания + +- Параметр `selection` позволяет выбрать между различными методами для выбора блоков ключей: + - `sol-attn`: Использует адаптивный порог для выбора блоков ключей на основе распределения оценок. + - `sla`: Сохраняет фиксированный процент самых высокооцененных блоков ключей. + - `vsa`: Применяет Video Sparse Attention, который использует тiling 3D видео-куб и обученный粗ый ветвь внимания. +- Параметр `dense_blocks` можно использовать для указания трансформаторных блоков, которые всегда должны использовать сплошное внимание. +- Параметр `min_tokens` устанавливает минимальное количество токенов в последовательности, для которой используется сплошное внимание. +- Параметр `extra_tokens` позволяет указать количество дополнительных топ-оценочных токенов, которые каждый блок запроса должен учитывать. +- Параметр `sink_conditioning` относится только к моделям MiniMax-H3 и определяет, как обрабатываются строки conditioning. +- Параметр `verbose` включает подробное логирование, которое может быть полезно для отладки. ## Выходы | Название выхода | Описание | Тип данных | |-------------|-------------|-----------| -| `model` | Модель ComfyUI с applied блок-спарсинговой механизму внимания. | МОДЕЛЬ | +| `model` | Модель ComfyUI с примененным блок-спарсингом внимания. | MODEL | -### Замечания +### Ограничения и ограничения -- Параметр `selection` определяет, как выбираются блоки ключей. Опции: - - Sol-Attn (адаптивный tau): Каждый блок запроса attends выбранный подмножество блоков ключей на основе адаптивного порога. - - top-k (SLA): Каждый блок запроса сохраняет фиксированный процент блоков ключей точно. - - VSA (FastVideo): Каждый блок запроса сохраняет фиксированный процент кубов видео точно, используя тiling cube и грубый ветвь FastH3-VSA. -- Параметр `dense_blocks` позволяет вам specify трансформаторные блоки, которые всегда выполняют сплошное внимание. -- Параметр `min_tokens` устанавливает минимальное количество токенов в последовательности, для которой модель использует сплошное внимание. -- Параметр `extra_tokens` позволяет specify количество дополнительных топ-оценочных токенов, которые каждый блок запроса attends за пределами своих выбранных блоков. -- Параметр `sink_conditioning` определяет строки MiniMax-H3 для использования в sink conditioning. -- Параметр `verbose` включает verbose logging. +- Метод `sol-attn` требует значения `tau` между 0.0 и 4.0. +- Метод `sla` требует значения `keep_percent` между 0.5 и 95.0. +- Метод `vsa` совместим только с моделями MiniMax-H3 и требует, чтобы модель имела слой `to_gate_compress`. +- Параметр `min_tokens` должен быть неотрицательным целым числом (при 0 всё внимание остаётся плотным). +- Параметр `extra_tokens` должен быть неотрицательным целым числом. +- Опции `sink_conditioning` относятся только к моделям MiniMax-H3. > Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BlockSparseAttention/ru.md) --- -**Source fingerprint (SHA-256):** `6a27aee45593883f5958ae1aac74a2077362742a0fdf74fc9dbfd68eddc6d259` +**Source fingerprint (SHA-256):** `0c34876b49a04db0ab265526e2bb5f784e150591aab631713ad2ab420a3327c4` diff --git a/comfyui_embedded_docs/docs/BlockSparseAttention/tr.md b/comfyui_embedded_docs/docs/BlockSparseAttention/tr.md index 6531650d8..d1f322524 100644 --- a/comfyui_embedded_docs/docs/BlockSparseAttention/tr.md +++ b/comfyui_embedded_docs/docs/BlockSparseAttention/tr.md @@ -1,44 +1,53 @@ -# Block Sparse Attention +# Model Seyrek Dikkat ## Genel Bakış -Block Sparse Attention düğümü, bir ComfyUI modeline blok-sparse dikkat mekanizmasını uygular ve her sorgu bloğunun yalnızca seçilmiş bir anahtar blok kümesine dikkat etmesine izin vererek dikkat hesaplama işlemini azaltır. +Blok Düzenli Dikkat düğümü, bir ComfyUI modeline blok-düzenli dikkat mekanizmasını uygulamak için kullanılır. Bu mekanizma, her sorgu bloğunun tüm olası bloklara değil, sadece belirli bir alt küme bloklara odaklanmasına izin vererek hesaplama yükünü azaltır ve uzun diziler için özellikle faydalıdır. ## Girdiler | Parametre | Açıklama | Veri Türü | Gerekli | Aralık | |-----------|-------------|-----------|----------|-------| -| `model` | Blok-sparse dikkat mekanizmasını uygulamak için kullanılacak ComfyUI modeli. | MODEL | Evet | N/A | -| `selection` | Anahtar bloklara dikkat etmeyi seçmek için kullanılan seçim yöntemi. | DYNAMIC_COMBO | Evet | Seçenekler: Sol-Attn (uyumlu tau), top-k (SLA), VSA (FastVideo) | -| `tau` | Sol-Attn (uyumlu tau) seçimi için puan dağılım sigmalarındaki eşiğin değeri. | FLOAT | Hayır | varsayılan: 1.3, min: 0.0, max: 4.0, adım: 0.05 | -| `keep_percent` | Her sorgu bloğunun top-k (SLA) seçimi için kesin olarak tuttuğu anahtar blokların yüzdesi. | FLOAT | Hayır | varsayılan: 10.0, min: 0.5, max: 95.0, adım: 0.5 | -| `start_percent` | Modelin yoğun dikkat kullanmaya başlayacağı programın yüzdesi. | FLOAT | Hayır | varsayılan: 0.2, min: 0.0, max: 1.0, adım: 0.01 | -| `end_percent` | Modelin yoğun dikkat kullanmaya devam edeceği programın yüzdesi. | FLOAT | Hayır | varsayılan: 1.0, min: 0.0, max: 1.0, adım: 0.01 | -| `dense_blocks` | Her zaman yoğun dikkat çalıştıran transformer bloklarını temsil eden bir dizi. | STRING | Hayır | varsayılan: "", | +| `model` | Blok-düzenli dikkat uygulamak için kullanılacak ComfyUI modeli. | MODEL | Evet | N/A | +| `selection` | Anahtar blokları belirlemek için kullanılan yöntem. | DYNAMIC_COMBO | Evet | Seçenekler: sol-attn (uyumlu tau), sla (top-k), vsa (Video Düzenli Dikkat) | +| `tau` | sol-attn yönteminde puan dağılımı sigmalarında kullanılan eşiğin değeri. | FLOAT | Hayır | varsayılan: 1.3, min: 0.0, max: 4.0, adım: 0.05 | +| `keep_percent` | sla yönteminde her sorgu bloğunun kesin olarak tuttuğu anahtar blokların yüzdesi. | FLOAT | Hayır | varsayılan: 10.0, min: 0.5, max: 95.0, adım: 0.5 | +| `start_percent` | Düzenli dikkat başlamaya başladığı yüzdesi noktası. | FLOAT | Hayır | varsayılan: 0.2, min: 0.0, max: 1.0, adım: 0.01 | +| `end_percent` | Düzenli dikkat bittiği yüzdesi noktası. | FLOAT | Hayır | varsayılan: 1.0, min: 0.0, max: 1.0, adım: 0.01 | +| `dense_blocks` | Her zaman yoğun dikkat kullanacak transformer bloklarını temsil eden bir string. | STRING | Hayır | varsayılan: "", | | `min_tokens` | Modelin yoğun dikkat kullanacağı dizideki en az token sayısı. | INT | Hayır | varsayılan: 12288, min: 0, max: 1 << 20, adım: 512 | -| `extra_tokens` | Her sorgu bloğunun seçilmiş bloklarının ötesinde dikkat ettiği ek en yüksek puanlı token sayısı. | INT | Hayır | varsayılan: 256, min: 0, max: 256, adım: 64 | -| `sink_conditioning` | Sink conditioning için kullanılacak MiniMax-H3 şartlandırma satırları. | COMBO | Hayır | Seçenekler: exact_kv, exact_kv_and_rows, off | -| `verbose` | Açıklamalı günlüklemeyi etkinleştirme. | BOOLEAN | Hayır | varsayılan: False | +| `extra_tokens` | Her sorgu bloğunun seçili bloklarının ötesinde dikkat ettiği ekstra en yüksek puanlı token sayısı. | INT | Hayır | varsayılan: 256, min: 0, max: 256, adım: 64 | +| `sink_conditioning` | Kullanılacak MiniMax-H3 şartlandırma satırları. | COMBO | Hayır | Seçenekler: exact_kv, exact_kv_and_rows, off | +| `verbose` | Ayrıntılı günlüklemeyi etkinleştirir. | BOOLEAN | Hayır | varsayılan: False | + +### Notlar + +- `selection` parametresi, anahtar blokları seçmek için farklı yöntemler arasında seçim yapmanıza olanak tanır: + - `sol-attn`: Puan dağılımına dayalı olarak anahtar blokları seçmek için uyumlu bir eşiği kullanır. + - `sla`: En yüksek puanlı anahtar blokların sabit bir yüzdesini tutar. + - `vsa`: 3B video-küp döşeme ve öğrenilmiş ince dikkat dalığını kullanarak Video Düzenli Dikkat uygular. +- `dense_blocks` parametresi, her zaman yoğun dikkat kullanacak transformer bloklarını belirtmek için kullanılır. +- `min_tokens` parametresi, yoğun dikkatin kullanılacağı dizideki en az token sayısını ayarlar. +- `extra_tokens` parametresi, her sorgu bloğunun seçili bloklarının ötesinde dikkat ettiği ekstra en yüksek puanlı token sayısını belirler. +- `sink_conditioning` parametresi yalnızca MiniMax-H3 modelleri için geçerlidir ve şartlandırma satırlarının nasıl ele alınacağını belirler. +- `verbose` parametresi, ayrıntılı günlüklemeyi etkinleştirir ve hata ayıklamada faydalı olabilir. ## Çıktılar | Çıktı Adı | Açıklama | Veri Türü | |-------------|-------------|-----------| -| `model` | Blok-sparse dikkat mekanizması uygulanmış ComfyUI modeli. | MODEL | +| `model` | Blok-düzenli dikkat uygulandıktan sonra olan ComfyUI modeli. | MODEL | -### Notlar +### Kısıtlamalar ve Sınırlamalar -- `selection` parametresi, anahtar blokların nasıl seçileceğini belirler. Seçenekler: - - Sol-Attn (uyumlu tau): Her sorgu bloğu, uyumlu bir eşiğe dayanarak seçilmiş bir anahtar blok kümesine dikkat eder. - - top-k (SLA): Her sorgu bloğu, kesin olarak belirli bir yüzdedeki anahtar blokları tutar. - - VSA (FastVideo): Her sorgu bloğu, FastH3-VSA'nın küp döşeme ve ince dal kullanarak kesin olarak belirli bir yüzdedeki video kübelerine dikkat eder. -- `dense_blocks` parametresi, her zaman yoğun dikkat çalıştıran transformer bloklarını belirtmenize olanak tanır. -- `min_tokens` parametresi, modelin yoğun dikkat kullanacağı dizideki en az token sayısını ayarlar. -- `extra_tokens` parametresi, her sorgu bloğunun seçilmiş bloklarının ötesinde dikkat ettiği ek en yüksek puanlı token sayısını belirler. -- `sink_conditioning` parametresi, sink conditioning için kullanılacak MiniMax-H3 şartlandırma satırlarını belirler. -- `verbose` parametresi, açıklamalı günlüklemeyi etkinleştirir. +- `sol-attn` yöntemi için `tau` değeri 0.0 ile 4.0 arasında olmalıdır. +- `sla` yöntemi için `keep_percent` değeri 0.5 ile 95.0 arasında olmalıdır. +- `vsa` yöntemi yalnızca MiniMax-H3 modelleri ile uyumludur ve modelin `to_gate_compress` katmanına sahip olması gerekmektedir. +- `min_tokens` parametresi negatif olmayan bir tamsayı olmalıdır (0 ayarlanırsa tüm dikkat işlemi yoğun kalır). +- `extra_tokens` parametresi negatif olmayan bir tamsayı olmalıdır. +- `sink_conditioning` seçenekleri yalnızca MiniMax-H3 modelleri için geçerlidir. > 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/BlockSparseAttention/tr.md) --- -**Source fingerprint (SHA-256):** `6a27aee45593883f5958ae1aac74a2077362742a0fdf74fc9dbfd68eddc6d259` +**Source fingerprint (SHA-256):** `0c34876b49a04db0ab265526e2bb5f784e150591aab631713ad2ab420a3327c4` diff --git a/comfyui_embedded_docs/docs/BlockSparseAttention/zh-TW.md b/comfyui_embedded_docs/docs/BlockSparseAttention/zh-TW.md index 594020df4..75181dd93 100644 --- a/comfyui_embedded_docs/docs/BlockSparseAttention/zh-TW.md +++ b/comfyui_embedded_docs/docs/BlockSparseAttention/zh-TW.md @@ -1,44 +1,53 @@ -# Block Sparse Attention +# 模型區塊稀疏注意力 ## 概述 -Block Sparse Attention 節點將塊稀疏注意力機制應用於 ComfyUI 模型,透過允許每個查詢塊只對選定的關鍵塊進行精確的注意力,從而減少注意力計算。 +Block Sparse Attention 節點用於修改 ComfyUI 模型,以應用塊稀疏注意力機制。此機制透過允許每個查詢塊只關注鍵塊的子集,而不是關注所有可能的塊,從而減少計算負擔,對於長序列特別有益。 ## 輸入 | 參數 | 描述 | 資料類型 | 必需 | 范圍 | |-----------|-------------|-----------|----------|-------| -| `model` | 將塊稀疏注意力應用於的 ComfyUI 模型。 | MODEL | 是 | N/A | -| `selection` | 選擇要參與注意力的關鍵塊的選擇方法。 | DYNAMIC_COMBO | 是 | 選項:Sol-Attn (自適應 tau), top-k (SLA), VSA (FastVideo) | -| `tau` | Sol-Attn (自適應 tau) 選擇中,分數分佈 sigmas 的閾值。 | FLOAT | 否 | 默認:1.3,最小:0.0,最大:4.0,步進:0.05 | -| `keep_percent` | top-k (SLA) 選擇中,每個查詢塊精確保持的關鍵塊的百分比。 | FLOAT | 否 | 默認:10.0,最小:0.5,最大:95.0,步進:0.5 | -| `start_percent` | 模型在計劃中使用稠密注意力的時間百分比。 | FLOAT | 否 | 默認:0.2,最小:0.0,最大:1.0,步進:0.01 | -| `end_percent` | 模型在計劃中使用稠密注意力的時間百分比。 | FLOAT | 否 | 默認:1.0,最小:0.0,最大:1.0,步進:0.01 | -| `dense_blocks` | 表示總是運行稠密注意力的 Transformer 塊的字符串。 | STRING | 否 | 默認:"" | -| `min_tokens` | 模型使用稠密注意力的序列中最小 token 數量。 | INT | 否 | 默認:12288,最小:0,最大:1 << 20,步進:512 | -| `extra_tokens` | 每個查詢塊在其選定的塊之外,參與的額外最高分 token 數量。 | INT | 否 | 默認:256,最小:0,最大:256,步進:64 | +| `model` | 將塊稀疏注意力應用到其上的 ComfyUI 模型。 | MODEL | 是 | N/A | +| `selection` | 用於確定要關注哪些鍵塊的方法。 | DYNAMIC_COMBO | 是 | 選項:sol-attn (自適應 tau), sla (top-k), vsa (Video Sparse Attention) | +| `tau` | sol-attn 方法中,分數分佈 sigmas 的閾值。 | FLOAT | 否 | 默認:1.3,最小:0.0,最大:4.0,步進:0.05 | +| `keep_percent` | sla 方法中,每個查詢塊精確保持的鍵塊百分比。 | FLOAT | 否 | 默認:10.0,最小:0.5,最大:95.0,步進:0.5 | +| `start_percent` | 稀疏注意力開始的百分比點。 | FLOAT | 否 | 默認:0.2,最小:0.0,最大:1.0,步進:0.01 | +| `end_percent` | 稀疏注意力結束的百分比點。 | FLOAT | 否 | 默認:1.0,最小:0.0,最大:1.0,步進:0.01 | +| `dense_blocks` | 表示總是運行密集注意力的 Transformer 塊的字符串。 | STRING | 否 | 默認:"" | +| `min_tokens` | 模型使用密集注意力的序列中的最小 token 數量。 | INT | 否 | 默認:12288,最小:0,最大:1 << 20,步進:512 | +| `extra_tokens` | 每個查詢塊在其選定的塊之外關注的額外高分 token 數量。 | INT | 否 | 默認:256,最小:0,最大:256,步進:64 | | `sink_conditioning` | 用於 sink condition 的 MiniMax-H3 condition rows。 | COMBO | 否 | 選項:exact_kv, exact_kv_and_rows, off | -| `verbose` | 是否啟用詳細記錄。 | BOOLEAN | 否 | 默認:False | +| `verbose` | 啟用詳細記錄。 | BOOLEAN | 否 | 默認:False | + +### 注意事項 + +- `selection` 參數允許您在選擇鍵塊的不同方法之間進行選擇: + - `sol-attn`:使用自適應閾值,基於分數分佈選擇鍵塊。 + - `sla`:保持固定百分比的最高分鍵塊。 + - `vsa`:應用 Video Sparse Attention,該方法使用 3D 觀看立體體塊拼貼和學習的粗略注意力分支。 +- `dense_blocks` 參數可用於指定應該總是使用密集注意力的 Transformer 塊。 +- `min_tokens` 參數設定了使用密集注意力的序列中的最小 token 數量。 +- `extra_tokens` 參數允許您指定每個查詢塊應該關注的額外高分 token 數量。 +- `sink_conditioning` 參數僅與 MiniMax-H3 模型相關,並確定如何處理 condition rows。 +- `verbose` 參數啟用詳細記錄,對於除錯可能很有用。 ## 輸出 -| 輸出名 | 描述 | 資料類型 | +| 輸出名稱 | 描述 | 資料類型 | |-------------|-------------|-----------| -| `model` | 應用塊稀疏注意力後的 ComfyUI 模型。 | MODEL | +| `模型` | 應用塊稀疏注意力後的 ComfyUI 模型。 | MODEL | -### 註釋 +### 續約和限制 -- `selection` 參數決定了如何選擇關鍵塊。選項包括: - - Sol-Attn (自適應 tau):每個查詢塊基於自適應閾值參與選定的關鍵塊子集。 - - top-k (SLA):每個查詢塊精確保持固定百分比的關鍵塊。 - - VSA (FastVideo):每個查詢塊精確保持固定百分比的視頻塊,使用 FastH3-VSA 的塊拼貼和粗略分支。 -- `dense_blocks` 參數允許您指定總是運行稠密注意力的 Transformer 塊。 -- `min_tokens` 參數設定了模型使用稠密注意力的序列中 token 的最小數量。 -- `extra_tokens` 參數允許您指定每個查詢塊在其選定的塊之外,參與的額外最高分 token 數量。 -- `sink_conditioning` 參數決定了用於 sink condition 的 MiniMax-H3 condition rows。 -- `verbose` 參數啟用詳細記錄。 +- `sol-attn` 方法需要介於 0.0 和 4.0 之間的 `tau` 值。 +- `sla` 方法需要介於 0.5 和 95.0 之間的 `keep_percent` 值。 +- `vsa` 方法僅與 MiniMax-H3 模型兼容,並要求模型具有 `to_gate_compress` 層。 +- `min_tokens` 參數必須是非負整數(設為 0 時所有注意力都保持稠密)。 +- `extra_tokens` 參數必須是非負整數。 +- `sink_conditioning` 選項僅適用於 MiniMax-H3 模型。 > 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BlockSparseAttention/zh-TW.md) --- -**Source fingerprint (SHA-256):** `6a27aee45593883f5958ae1aac74a2077362742a0fdf74fc9dbfd68eddc6d259` +**Source fingerprint (SHA-256):** `0c34876b49a04db0ab265526e2bb5f784e150591aab631713ad2ab420a3327c4` diff --git a/comfyui_embedded_docs/docs/BlockSparseAttention/zh.md b/comfyui_embedded_docs/docs/BlockSparseAttention/zh.md index eb9193cba..129fa1052 100644 --- a/comfyui_embedded_docs/docs/BlockSparseAttention/zh.md +++ b/comfyui_embedded_docs/docs/BlockSparseAttention/zh.md @@ -1,44 +1,53 @@ -# Block Sparse Attention +# 模型稀疏注意力 ## 概述 -Block Sparse Attention 节点将块稀疏注意力机制应用于 ComfyUI 模型,通过允许每个查询块仅精确地关注所选子集的关键块,从而减少注意力计算。 +块稀疏注意力节点通过应用块稀疏注意力机制来修改 ComfyUI 模型。这种机制通过允许每个查询块只关注关键块的子集,而不是关注所有可能的块,从而减少计算负载,这对于长序列特别有益。 ## 输入 | 参数 | 描述 | 数据类型 | 必需 | 范围 | |-----------|-------------|-----------|----------|-------| | `model` | 要应用块稀疏注意力的 ComfyUI 模型。 | MODEL | 是 | N/A | -| `selection` | 选择要关注哪些关键块的选取方法。 | DYNAMIC_COMBO | 是 | 选项:Sol-Attn (自适应 tau),top-k (SLA),VSA (FastVideo) | -| `tau` | Sol-Attn (自适应 tau) 选取中用于分数分布 sigmas 的阈值。 | FLOAT | 否 | 默认:1.3,最小:0.0,最大:4.0,步长:0.05 | -| `keep_percent` | top-k (SLA) 选取中每个查询块精确保留的关键块百分比。 | FLOAT | 否 | 默认:10.0,最小:0.5,最大:95.0,步长:0.5 | -| `start_percent` | 模型在哪个时间表百分比之前使用密集注意力。 | FLOAT | 否 | 默认:0.2,最小:0.0,最大:1.0,步长:0.01 | -| `end_percent` | 模型在哪个时间表百分比之后使用密集注意力。 | FLOAT | 否 | 默认:1.0,最小:0.0,最大:1.0,步长:0.01 | +| `selection` | 用于确定要关注哪些关键块的方法。 | 动态组合 | 是 | 选项:sol-attn(自适应 tau)、sla(top-k)、vsa(视频稀疏注意力) | +| `tau` | sol-attn 方法的分数分布 sigmas 中的阈值。 | 浮点数 | 否 | 默认:1.3,最小:0.0,最大:4.0,步长:0.05 | +| `keep_percent` | sla 方法中每个查询块精确保留的关键块百分比。 | 浮点数 | 否 | 默认:10.0,最小:0.5,最大:95.0,步长:0.5 | +| `start_percent` | 稀疏注意力开始时的百分比点。 | 浮点数 | 否 | 默认:0.2,最小:0.0,最大:1.0,步长:0.01 | +| `end_percent` | 稀疏注意力结束时的百分比点。 | 浮点数 | 否 | 默认:1.0,最小:0.0,最大:1.0,步长:0.01 | | `dense_blocks` | 表示始终运行密集注意力的 Transformer 块的字符串。 | STRING | 否 | 默认:"" | | `min_tokens` | 模型使用密集注意力的序列中令牌的最小数量。 | INT | 否 | 默认:12288,最小:0,最大:1 << 20,步长:512 | -| `extra_tokens` | 每个查询块在其所选块之外关注的额外最高分令牌数量。 | INT | 否 | 默认:256,最小:0,最大:256,步长:64 | -| `sink_conditioning` | 用于 sink conditioning 的 MiniMax-H3 条件行。 | COMBO | 否 | 选项:exact_kv,exact_kv_and_rows,off | -| `verbose` | 是否启用详细日志记录。 | BOOLEAN | 否 | 默认:False | +| `extra_tokens` | 每个查询块在其所选块之外关注的额外最高得分令牌的数量。 | INT | 否 | 默认:256,最小:0,最大:256,步长:64 | +| `sink_conditioning` | 用于下沉条件化的 MiniMax-H3 条件行。 | 组合 | 否 | 选项:exact_kv、exact_kv_and_rows、off | +| `verbose` | 启用详细日志记录。 | 布尔值 | 否 | 默认:False | + +### 注意事项 + +- `selection` 参数允许您在以下不同的方法之间选择用于选择关键块: + - `sol-attn`:使用自适应阈值根据分数分布选择关键块。 + - `sla`:保留固定百分比的最高得分关键块。 + - `vsa`:应用视频稀疏注意力,它使用 3D 视频立方体贴图和一个学习到的粗略注意力分支。 +- `dense_blocks` 参数可以用来指定始终使用密集注意力的 Transformer 块。 +- `min_tokens` 参数设置用于密集注意力的序列中令牌的最小数量。 +- `extra_tokens` 参数允许您指定每个查询块应关注的额外最高得分令牌的数量。 +- `sink_conditioning` 参数仅适用于 MiniMax-H3 模型,并确定如何处理条件行。 +- `verbose` 参数启用详细日志记录,这对于调试可能很有用。 ## 输出 | 输出名称 | 描述 | 数据类型 | |-------------|-------------|-----------| -| `model` | 应用了块稀疏注意力的 ComfyUI 模型。 | MODEL | +| `模型` | 应用了块稀疏注意力的 ComfyUI 模型。 | MODEL | -### 注意事项 +### 约束和限制 -- `selection` 参数确定如何选择关键块。选项包括: - - Sol-Attn (自适应 tau):每个查询块根据自适应阈值关注所选子集的关键块。 - - top-k (SLA):每个查询块精确保留固定百分比的关键块。 - - VSA (FastVideo):每个查询块精确保留固定百分比的视频立方体,使用 FastH3-VSA 的立方体贴图和粗分支。 -- `dense_blocks` 参数允许您指定始终运行密集注意力的 Transformer 块。 -- `min_tokens` 参数设置模型使用密集注意力的序列中令牌的最小数量。 -- `extra_tokens` 参数允许您指定每个查询块在其所选块之外关注的额外最高分令牌数量。 -- `sink_conditioning` 参数确定用于 sink conditioning 的 MiniMax-H3 条件行。 -- `verbose` 参数启用详细日志记录。 +- `sol-attn` 方法需要介于 0.0 和 4.0 之间的 `tau` 值。 +- `sla` 方法需要介于 0.5 和 95.0 之间的 `keep_percent` 值。 +- `vsa` 方法仅与 MiniMax-H3 模型兼容,并要求模型具有 `to_gate_compress` 层。 +- `min_tokens` 参数必须是非负整数(设为 0 时所有注意力都保持稠密)。 +- `extra_tokens` 参数必须是非负整数。 +- `sink_conditioning` 选项仅适用于 MiniMax-H3 模型。 > 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BlockSparseAttention/zh.md) --- -**Source fingerprint (SHA-256):** `6a27aee45593883f5958ae1aac74a2077362742a0fdf74fc9dbfd68eddc6d259` +**Source fingerprint (SHA-256):** `0c34876b49a04db0ab265526e2bb5f784e150591aab631713ad2ab420a3327c4` diff --git a/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/ar.md b/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/ar.md index f8bae234a..56f8d4a83 100644 --- a/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/ar.md +++ b/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/ar.md @@ -1,42 +1,30 @@ # تحويل الإطار الأول-الأخير من ByteDance إلى فيديو -# بداية-نهاية إطار إلى فيديو - -هذا العقد يولد فيديو باستخدام نص إرشادي بالإضافة إلى الإطار الأول والأخير لصورة. إنه يخلق انتقالًا سلسًا بين الإطارين، مما يؤدي إلى سلسلة كاملة من الفيديو. يقدم العقد مجموعة من الخيارات لتحديد دقة الفيديو، نسبة الأبعاد، المدة، ومعاملات الإنتاج الإضافية. +يولّد هذا العقدة فيديو باستخدام موجه نصي مع صورتي الإطار الأول والأخير. تأخذ وصفك والإطارين الرئيسيين لإنشاء تسلسل فيديو كامل ينتقل بينهما. توفر العقدة خيارات متنوعة للتحكم في دقة الفيديو ونسبة الأبعاد والمدة وغيرها من معاملات التوليد. ## المدخلات -| المعامل | الوصف | نوع البيانات | إلزامي | نطاق | -|-----------|-------------|-----------|----------|-------| -| `النموذج` | النموذج الذي سيتم استخدامه لإنشاء الفيديو. اختر من الخيارات المتاحة (الافتراضي: `"seedance-1-5-pro-251215"`). | خيار | نعم | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"` | -| `المطالبة النصية` | النص الإرشادي المستخدم لإنشاء الفيديو. يجب ألا يحتوي هذا النص على معاملات محددة مثل دقة الفيديو، نسبة الأبعاد، المدة، البذرة، الكاميرا الثابتة، أو المائية. | نص | نعم | - | -| `الإطار_الأول` | الإطار الأول الذي سيتم استخدامه للفيديو. يجب أن تكون الصورة بين 300x300 و6000x6000 بكسل وأن يكون نسبة الأبعاد بين 0.4 و2.5. | صورة | نعم | - | -| `الإطار_الأخير` | الإطار الأخير الذي سيتم استخدامه للفيديو. يجب أن تكون الصورة بين 300x300 و6000x6000 بكسل وأن يكون نسبة الأبعاد بين 0.4 و2.5. | صورة | نعم | - | -| `الدقة` | دقة الفيديو الناتج. اختر من الخيارات المتاحة (الافتراضي: `"480p"`). | خيار | نعم | `"480p"`
`"720p"`
`"1080p"` | -| `نسبة_الجانب` | نسبة الأبعاد للفيديو الناتج. اختر من الخيارات المتاحة (الافتراضي: `"adaptive"`). | خيار | نعم | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | -| `المدة` | مدة الفيديو الناتج بالثواني (الافتراضي: 5). بالنسبة لنموذج `seedance-1-5-pro-251215`، أطول فترة دعمها هي 4 ثانية. | عدد | نعم | 3 - 12 | -| `البذرة` | البذرة التي سيتم استخدامه للإنتاج (الافتراضي: 0). هذا المعامل هو اختياري. | عدد | لا | 0 - 2147483647 | -| `الكاميرا_ثابتة` | يحدد ما إذا كان يجب إبقاء الكاميرا ثابتة في الفيديو. يضيف المنصة تعليمات لإبقاء الكاميرا ثابتة في النص الخاص بك، ولكن تأثيرها ليس مضمونًا (الافتراضي: لا). | منطقي | لا | - | -| `علامة_مائية` | يحدد ما إذا كان يجب إضافة علامة مائية "مولد بواسطة الذكاء الاصطناعي" إلى الفيديو (الافتراضي: لا). | منطقي | لا | - | -| `توليد الصوت` | هذا المعامل يتم تجاهله لجميع النماذج عدا `seedance-1-5-pro-251215` (الافتراضي: لا). | منطقي | لا | - | +| المعامل | الوصف | نوع البيانات | إلزامي | النطاق | +| --- | --- | --- | --- | --- | +| `النموذج` | النموذج المستخدم لتوليد الفيديو (الافتراضي: `"seedance-1-5-pro-251215"`). | COMBO | نعم | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"` | +| `المطالبة النصية` | الموجّه النصي المستخدم لتوليد الفيديو. يجب ألا يكون فارغًا. | STRING | نعم | - | +| `الإطار_الأول` | الإطار الأول المستخدم في الفيديو. يجب أن تتراوح أبعاده بين 300x300 و6000x6000 بكسل، مع نسبة أبعاد بين 0.4 و2.5. | IMAGE | نعم | - | +| `الإطار_الأخير` | الإطار الأخير المستخدم في الفيديو. يجب أن تتراوح أبعاده بين 300x300 و6000x6000 بكسل، مع نسبة أبعاد بين 0.4 و2.5. | IMAGE | نعم | - | +| `الدقة` | دقة الفيديو الناتج. | COMBO | نعم | `"480p"`
`"720p"`
`"1080p"` | +| `نسبة_الجانب` | نسبة الأبعاد للفيديو الناتج. | COMBO | نعم | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `المدة` | مدة الفيديو الناتج بالثواني. عند استخدام `seedance-1-5-pro-251215`، تكون المدة الدنيا 4 ثوانٍ. (الافتراضي: 5) | INT | نعم | 3 - 12 | +| `البذرة` | البذرة المستخدمة في التوليد. (الافتراضي: 0) | INT | لا | 0 - 2147483647 | +| `الكاميرا_ثابتة` | يحدد ما إذا كان سيتم تثبيت الكاميرا. تضيف المنصة تعليمة لتثبيت الكاميرا إلى الموجّه الخاص بك، ولكنها لا تضمن التأثير الفعلي. (الافتراضي: False) | BOOLEAN | لا | - | +| `علامة_مائية` | ما إذا كان سيتم إضافة علامة مائية "منشأ بالذكاء الاصطناعي" إلى الفيديو. (الافتراضي: False) | BOOLEAN | لا | - | +| `توليد الصوت` | يتم تجاهل هذا المعامل لأي نموذج باستثناء `seedance-1-5-pro-251215`. (الافتراضي: False) | BOOLEAN | لا | - | + +**ملاحظة:** بالنسبة لنموذج `seedance-1-5-pro-251215`، يجب أن تكون مدة `duration` 4 ثوانٍ أو أكثر. يجب أن تكون كل من `first_frame` و`last_frame` بين 300x300 و6000x6000 بكسل وأن تكون نسبة الأبعاد بين 0.4 و2.5. ## المخرجات -| اسم المخرج | الوصف | نوع البيانات | -|-------------|-------------|-----------| -| `output` | ملف الفيديو المولد. | فيديو | - -## ملاحظات - -- يحدد معامل `model` قدرات وتقييدات عملية إنشاء الفيديو. -- يجب أن يكون النص الإرشادي مبدعًا وواضحًا، لأنه سيقود عملية إنشاء الفيديو. -- يجب أن تكون الصور `first_frame` و `last_frame` ممثلين للمنتج المراد تحقيقه في الفيديو. -- سيفؤثر معاملات `resolution` و `aspect_ratio` على جودة وابعاد الفيديو النهائي. -- يحدد معامل `duration` طول الفيديو، مع أطول فترة دعمها 3 ثواني وأطول فترة دعمها 12 ثانية. -- يمكن استخدام معامل `seed` بشكل اختياري لضمان تكرار عملية إنشاء الفيديو. -- يمكن استخدام معامل `camera_fixed` كخيار متقدم قد لا يؤدي دائمًا إلى التأثير المتوقع. -- يمكن استخدام معامل `watermark` لإضافة علامة مائية إلى الفيديو، مما يشير إلى أن الفيديو تم إنشاؤه بواسطة الذكاء الاصطناعي. -- يتم تجاهل معامل `generate_audio` لجميع النماذج عدا `seedance-1-5-pro-251215`. +| اسم المخرجات | الوصف | نوع البيانات | +| --- | --- | --- | +| `output` | ملف الفيديو المُولّد. | VIDEO | > تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/ar.md) diff --git a/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/en.md b/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/en.md index 0b366b689..24f21436e 100644 --- a/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/en.md +++ b/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/en.md @@ -1,41 +1,31 @@ # ByteDance First-Last-Frame to Video -This node generates a video by using a text prompt along with the first and last frames of an image. It creates a seamless transition between the two frames, resulting in a complete video sequence. The node offers a range of options to customize the video's resolution, aspect ratio, duration, and additional generation parameters. +This node generates a video using a text prompt along with first and last frame images. It takes your description and the two key frames to create a complete video sequence that transitions between them. The node provides various options to control the video's resolution, aspect ratio, duration, and other generation parameters. ## Inputs | Parameter | Description | Data Type | Required | Range | -|-----------|-------------|-----------|----------|-------| -| `model` | The model to use for video generation. Select from available options (default: `"seedance-1-5-pro-251215"`). | COMBO | Yes | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"` | -| `prompt` | The text prompt used to generate the video. This prompt should not contain specific parameters such as resolution, ratio, duration, seed, camerafixed, or watermark. | STRING | Yes | - | -| `first_frame` | The first frame to be used for the video. The image must be between 300x300 and 6000x6000 pixels and have an aspect ratio between 0.4 and 2.5. | IMAGE | Yes | - | -| `last_frame` | The last frame to be used for the video. The image must be between 300x300 and 6000x6000 pixels and have an aspect ratio between 0.4 and 2.5. | IMAGE | Yes | - | -| `resolution` | The resolution of the output video. Choose from the available options (default: `"480p"`). | COMBO | Yes | `"480p"`
`"720p"`
`"1080p"` | -| `aspect_ratio` | The aspect ratio of the output video. Select from the available options (default: `"adaptive"`). | COMBO | Yes | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | -| `duration` | The duration of the output video in seconds (default: 5). For the `seedance-1-5-pro-251215` model, the minimum supported duration is 4 seconds. | INT | Yes | 3 - 12 | -| `seed` | The seed to use for generation (default: 0). This parameter is optional. | INT | No | 0 - 2147483647 | -| `camera_fixed` | Specifies whether to fix the camera in the video. The platform appends an instruction to fix the camera to your prompt, but the actual effect is not guaranteed (default: False). | BOOLEAN | No | - | -| `watermark` | Determines whether to add an "AI generated" watermark to the video (default: False). | BOOLEAN | No | - | -| `generate_audio` | This parameter is ignored for all models except `seedance-1-5-pro-251215` (default: False). | BOOLEAN | No | - | +| --- | --- | --- | --- | --- | +| `model` | The model used for video generation (default: `"seedance-1-5-pro-251215"`). | COMBO | Yes | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"` | +| `prompt` | The text prompt used to generate the video. Must not be empty. | STRING | Yes | - | +| `first_frame` | First frame to be used for the video. Must be between 300x300 and 6000x6000 pixels, with an aspect ratio between 0.4 and 2.5. | IMAGE | Yes | - | +| `last_frame` | Last frame to be used for the video. Must be between 300x300 and 6000x6000 pixels, with an aspect ratio between 0.4 and 2.5. | IMAGE | Yes | - | +| `resolution` | The resolution of the output video. | COMBO | Yes | `"480p"`
`"720p"`
`"1080p"` | +| `aspect_ratio` | The aspect ratio of the output video. | COMBO | Yes | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `duration` | The duration of the output video in seconds. When using `seedance-1-5-pro-251215`, the minimum duration is 4 seconds. (default: 5) | INT | Yes | 3 - 12 | +| `seed` | Seed to use for generation. (default: 0) | INT | No | 0 - 2147483647 | +| `camera_fixed` | Specifies whether to fix the camera. The platform appends an instruction to fix the camera to your prompt, but does not guarantee the actual effect. (default: False) | BOOLEAN | No | - | +| `watermark` | Whether to add an "AI generated" watermark to the video. (default: False) | BOOLEAN | No | - | +| `generate_audio` | This parameter is ignored for any model except `seedance-1-5-pro-251215`. (default: False) | BOOLEAN | No | - | + +**Note:** For the `seedance-1-5-pro-251215` model, `duration` must be 4 seconds or greater. Both `first_frame` and `last_frame` must be between 300x300 and 6000x6000 pixels and have an aspect ratio between 0.4 and 2.5. ## Outputs | Output Name | Description | Data Type | -|-------------|-------------|-----------| +| --- | --- | --- | | `output` | The generated video file. | VIDEO | -## Notes - -- The `model` parameter determines the capabilities and limitations of the video generation process. -- The `prompt` should be creative and clear, as it will guide the video generation. -- The `first_frame` and `last_frame` images should be representative of the desired video content. -- The `resolution` and `aspect_ratio` parameters will affect the final output video's quality and dimensions. -- The `duration` parameter sets the length of the video, with a minimum of 3 seconds and a maximum of 12 seconds. -- The `seed` parameter is optional and can be used for reproducibility of the video generation process. -- The `camera_fixed` parameter is an advanced option that may not always result in the expected effect. -- The `watermark` parameter can be used to add a watermark to the video, indicating that it was generated by an AI. -- The `generate_audio` parameter is currently ignored for all models except `seedance-1-5-pro-251215`. - > 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/ByteDanceFirstLastFrameNode/en.md) --- diff --git a/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/es.md b/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/es.md index a6d3cb196..19291982d 100644 --- a/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/es.md +++ b/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/es.md @@ -1,43 +1,31 @@ # ByteDance Primer-Último-Fotograma a Video -# ByteDance First-Last-Frame to Video - -Este nodo genera un video utilizando un texto de indicación junto con los primeros y últimos cuadros de una imagen. Crea una transición suave entre los dos cuadros, resultando en una secuencia de video completa. El nodo ofrece una gama de opciones para personalizar la resolución, relación de aspecto, duración y parámetros adicionales de generación del video. +Este nodo genera un video utilizando un prompt de texto junto con imágenes de primer y último fotograma. Toma tu descripción y los dos fotogramas clave para crear una secuencia de video completa que realiza la transición entre ellos. El nodo ofrece diversas opciones para controlar la resolución, la relación de aspecto, la duración y otros parámetros de generación del video. ## Entradas | Parámetro | Descripción | Tipo de datos | Requerido | Rango | -|-----------|-------------|-----------|----------|-------| -| `modelo` | El modelo a utilizar para la generación de video. Seleccione de las opciones disponibles (por defecto: `"seedance-1-5-pro-251215"`). | COMBO | Sí | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"` | -| `prompt` | El texto de indicación utilizado para generar el video. Este indicación no debe contener parámetros específicos como resolución, relación de aspecto, duración, seed, camerafixed o watermark. | STRING | Sí | - | -| `primer_fotograma` | El primer cuadro a ser utilizado para el video. La imagen debe estar entre 300x300 y 6000x6000 píxeles y tener un relación de aspecto entre 0.4 y 2.5. | IMAGE | Sí | - | -| `último_fotograma` | El último cuadro a ser utilizado para el video. La imagen debe estar entre 300x300 y 6000x6000 píxeles y tener un relación de aspecto entre 0.4 y 2.5. | IMAGE | Sí | - | -| `resolución` | La resolución del video de salida. Elija de las opciones disponibles (por defecto: `"480p"`). | COMBO | Sí | `"480p"`
`"720p"`
`"1080p"` | -| `relación_de_aspecto` | El relación de aspecto del video de salida. Seleccione de las opciones disponibles (por defecto: `"adaptive"`). | COMBO | Sí | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | -| `duración` | La duración del video de salida en segundos (por defecto: 5). Para el modelo `seedance-1-5-pro-251215`, la duración mínima soportada es de 4 segundos. | INT | Sí | 3 - 12 | -| `semilla` | La semilla a utilizar para la generación (por defecto: 0). Este parámetro es opcional. | INT | No | 0 - 2147483647 | -| `cámara_fija` | Especifica si se debe fijar la cámara en el video. La plataforma adjunta una instrucción para fijar la cámara a su indicación, pero el efecto real no está garantizado (por defecto: Falso). | BOOLEAN | No | - | -| `marca_de_agua` | Determina si se debe agregar una marca de agua "Generado por IA" al video (por defecto: Falso). | BOOLEAN | No | - | -| `generate_audio` | Este parámetro se ignora para todos los modelos excepto `seedance-1-5-pro-251215` (por defecto: Falso). | BOOLEAN | No | - | +| --- | --- | --- | --- | --- | +| `modelo` | El modelo utilizado para la generación de video (predeterminado: `"seedance-1-5-pro-251215"`). | COMBO | Sí | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"` | +| `prompt` | El prompt de texto utilizado para generar el video. No debe estar vacío. | STRING | Sí | - | +| `primer_fotograma` | Primer fotograma que se utilizará en el video. Debe tener entre 300x300 y 6000x6000 píxeles, con una relación de aspecto entre 0.4 y 2.5. | IMAGE | Sí | - | +| `último_fotograma` | Último fotograma que se utilizará en el video. Debe tener entre 300x300 y 6000x6000 píxeles, con una relación de aspecto entre 0.4 y 2.5. | IMAGE | Sí | - | +| `resolución` | La resolución del video de salida. | COMBO | Sí | `"480p"`
`"720p"`
`"1080p"` | +| `relación_de_aspecto` | La relación de aspecto del video de salida. | COMBO | Sí | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `duración` | La duración del video de salida en segundos. Cuando se utiliza `seedance-1-5-pro-251215`, la duración mínima es de 4 segundos. (predeterminado: 5) | INT | Sí | 3 - 12 | +| `semilla` | Semilla a utilizar para la generación. (predeterminado: 0) | INT | No | 0 - 2147483647 | +| `cámara_fija` | Especifica si se debe fijar la cámara. La plataforma añade una instrucción para fijar la cámara a tu prompt, pero no garantiza el efecto real. (predeterminado: False) | BOOLEAN | No | - | +| `marca_de_agua` | Si se debe añadir una marca de agua "AI generated" al video. (predeterminado: False) | BOOLEAN | No | - | +| `generate_audio` | Este parámetro se ignora para todos los modelos excepto `seedance-1-5-pro-251215`. (predeterminado: False) | BOOLEAN | No | - | + +**Nota:** Para el modelo `seedance-1-5-pro-251215`, `duration` debe ser de 4 segundos o más. Tanto `first_frame` como `last_frame` deben tener entre 300x300 y 6000x6000 píxeles y una relación de aspecto entre 0.4 y 2.5. ## Salidas | Nombre de salida | Descripción | Tipo de datos | -|-------------|-------------|-----------| +| --- | --- | --- | | `output` | El archivo de video generado. | VIDEO | -## Notas - -- El parámetro `model` determina las capacidades y limitaciones del proceso de generación de video. -- El indicación `prompt` debe ser creativo y claro, ya que guiará la generación del video. -- Las imágenes `first_frame` y `last_frame` deben ser representativas del contenido deseado del video. -- Los parámetros `resolution` y `aspect_ratio` afectarán la calidad y dimensiones finales del video de salida. -- El parámetro `duration` establece la longitud del video, con un mínimo de 3 segundos y un máximo de 12 segundos. -- El parámetro `seed` es opcional y puede ser utilizado para la reproducibilidad del proceso de generación de video. -- El parámetro `camera_fixed` es una opción avanzada que puede no siempre resultar en el efecto esperado. -- El parámetro `watermark` puede ser utilizado para agregar una marca de agua al video, indicando que fue generado por una IA. -- El parámetro `generate_audio` se ignora actualmente para todos los modelos excepto `seedance-1-5-pro-251215`. - > 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/ByteDanceFirstLastFrameNode/es.md) --- diff --git a/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/fa.md b/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/fa.md index c05ffa278..ba960c077 100644 --- a/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/fa.md +++ b/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/fa.md @@ -1,42 +1,30 @@ # تبدیل اولین و آخرین فریم به ویدیو ByteDance -# تبدیل اولین و آخرین فریم به ویدیو - -این گره ویدیویی‌ای تولید می‌کند که از یک پیام متنی و اولین و آخرین فریم یک تصویر استفاده می‌کند. این گره انتقال بدون شکاف بین دو فریم را ایجاد می‌کند و در نتیجه یک توالی کامل از ویدیو را تولید می‌کند. این گره مجموعه‌ای از گزینه‌ها را برای شخصی‌سازی رزولوشن، نسبت ابعاد، مدت زمان و پارامترهای اضافی تولید ارائه می‌دهد. +این گره ویدیویی را با استفاده از یک پرامپت متنی همراه با تصاویر فریم اول و آخر تولید می‌کند. توضیح شما و دو فریم کلیدی را می‌گیرد تا یک توالی ویدیویی کامل ایجاد کند که بین آن‌ها انتقال برقرار می‌شود. این گره گزینه‌های متنوعی برای کنترل رزولوشن، نسبت تصویر، مدت‌زمان و سایر پارامترهای تولید ویدیو فراهم می‌کند. ## ورودی‌ها -| پارامتر | توضیح | نوع داده | الزامی | محدوده | -|-----------|-------------|-----------|----------|-------| -| `مدل` | مدل استفاده‌شده برای تولید ویدیو. از گزینه‌های موجود انتخاب کنید (پیش‌فرض: `"seedance-1-5-pro-251215"`). | COMBO | بله | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"` | -| `پرامپت` | پیام متنی استفاده‌شده برای تولید ویدیو. این پیام نباید شامل پارامترهای خاصی مانند رزولوشن، نسبت ابعاد، مدت زمان، seed، camerafixed یا watermark باشد. | STRING | بله | - | -| `اولین فریم` | فریم اول استفاده‌شده برای ویدیو. تصویر باید بین 300x300 و 6000x6000 پیکسل باشد و نسبت ابعاد بین 0.4 و 2.5 داشته باشد. | IMAGE | بله | - | -| `آخرین فریم` | فریم آخر استفاده‌شده برای ویدیو. تصویر باید بین 300x300 و 6000x6000 پیکسل باشد و نسبت ابعاد بین 0.4 و 2.5 داشته باشد. | IMAGE | بله | - | -| `وضوح تصویر` | رزولوشن ویدیوی خروجی. از گزینه‌های موجود انتخاب کنید (پیش‌فرض: `"480p"`). | COMBO | بله | `"480p"`
`"720p"`
`"1080p"` | -| `نسبت تصویر` | نسبت ابعاد ویدیوی خروجی. از گزینه‌های موجود انتخاب کنید (پیش‌فرض: `"adaptive"`). | COMBO | بله | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | -| `مدت زمان` | مدت زمان ویدیوی خروجی در ثانیه (پیش‌فرض: 5). برای مدل `seedance-1-5-pro-251215`، مدت زمان کمینه پشتیبانی شده 4 ثانیه است. | INT | بله | 3 - 12 | -| `seed` | seed استفاده‌شده برای تولید (پیش‌فرض: 0). این پارامتر اختیاری است. | INT | خیر | 0 - 2147483647 | -| `ثابت بودن دوربین` | مشخص می‌کند که آیا دوربین در ویدیو ثابت باشد یا خیر. پلتفرم دستوری برای ثابت کردن دوربین به پیام شما اضافه می‌کند، اما تأثیر واقعی تضمین نمی‌شود (پیش‌فرض: False). | BOOLEAN | خیر | - | -| `واترمارک` | مشخص می‌کند که آیا باید علامت آبی "AI generated" به ویدیو اضافه شود یا خیر (پیش‌فرض: False). | BOOLEAN | خیر | - | -| `تولید صدا` | این پارامتر برای تمام مدل‌ها به جز `seedance-1-5-pro-251215` نادیده گرفته می‌شود (پیش‌فرض: False). | BOOLEAN | خیر | - | +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +| --- | --- | --- | --- | --- | +| `مدل` | مدلی که برای تولید ویدیو استفاده می‌شود (پیش‌فرض: `"seedance-1-5-pro-251215"`). | COMBO | بله | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"` | +| `پرامپت` | پرامپت متنی مورد استفاده برای تولید ویدیو. نباید خالی باشد. | STRING | بله | - | +| `اولین فریم` | فریم اولی که برای ویدیو استفاده می‌شود. باید بین 300x300 و 6000x6000 پیکسل باشد و نسبت تصویر آن بین 0.4 و 2.5 قرار گیرد. | IMAGE | بله | - | +| `آخرین فریم` | فریم آخری که برای ویدیو استفاده می‌شود. باید بین 300x300 و 6000x6000 پیکسل باشد و نسبت تصویر آن بین 0.4 و 2.5 قرار گیرد. | IMAGE | بله | - | +| `وضوح تصویر` | رزولوشن ویدیوی خروجی. | COMBO | بله | `"480p"`
`"720p"`
`"1080p"` | +| `نسبت تصویر` | نسبت تصویر ویدیوی خروجی. | COMBO | بله | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `مدت زمان` | مدت‌زمان ویدیوی خروجی بر حسب ثانیه. هنگام استفاده از `seedance-1-5-pro-251215`، حداقل مدت‌زمان 4 ثانیه است. (پیش‌فرض: 5) | INT | بله | 3 - 12 | +| `seed` | مقدار seed برای استفاده در تولید. (پیش‌فرض: 0) | INT | خیر | 0 - 2147483647 | +| `ثابت بودن دوربین` | مشخص می‌کند که آیا دوربین ثابت باشد یا نه. پلتفرم دستوری برای ثابت نگه داشتن دوربین به پرامپت شما اضافه می‌کند، اما اثر واقعی آن را تضمین نمی‌کند. (پیش‌فرض: False) | BOOLEAN | خیر | - | +| `واترمارک` | اینکه آیا واترمارک «AI generated» به ویدیو اضافه شود یا نه. (پیش‌فرض: False) | BOOLEAN | خیر | - | +| `تولید صدا` | این پارامتر برای هر مدلی به‌جز `seedance-1-5-pro-251215` نادیده گرفته می‌شود. (پیش‌فرض: False) | BOOLEAN | خیر | - | + +**توجه:** برای مدل `seedance-1-5-pro-251215`، مقدار `duration` باید 4 ثانیه یا بیشتر باشد. هر دو `first_frame` و `last_frame` باید بین 300x300 و 6000x6000 پیکسل باشند و نسبت تصویر آن‌ها بین 0.4 و 2.5 باشد. ## خروجی‌ها -| نام خروجی | توضیح | نوع داده | -|-------------|-------------|-----------| -| `output` | فایل ویدیوی تولید شده. | VIDEO | - -## یادداشت‌ها - -- پارامتر `model` قابلیت‌ها و محدودیت‌های فرآیند تولید ویدیو را تعیین می‌کند. -- پیام `prompt` باید خلاقانه و واضح باشد، زیرا آن به تولید ویدیو راهنمایی می‌کند. -- تصاویر `first_frame` و `last_frame` باید نمونه‌ای از محتوای مورد انتظار ویدیو باشند. -- پارامترهای `resolution` و `aspect_ratio` بر کیفیت و ابعاد نهایی ویدیوی خروجی تأثیر می‌گذارند. -- پارامتر `duration` مدت زمان ویدیو را تنظیم می‌کند، با حداقل 3 ثانیه و حداکثر 12 ثانیه. -- پارامتر `seed` اختیاری است و می‌تواند برای تکرارپذیری فرآیند تولید ویدیو استفاده شود. -- پارامتر `camera_fixed` یک گزینه پیشرفته است که ممکن است همیشه تأثیر مورد انتظار را داشته باشد. -- پارامتر `watermark` می‌تواند برای اضافه کردن علامت آبی "AI generated" به ویدیو استفاده شود، نشان‌دهنده اینکه ویدیو توسط یک AI تولید شده است. -- پارامتر `generate_audio` در حال حاضر برای تمام مدل‌ها به جز `seedance-1-5-pro-251215` نادیده گرفته می‌شود. +| نام خروجی | توضیحات | نوع داده | +| --- | --- | --- | +| `output` | فایل ویدیوی تولیدشده. | VIDEO | > این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/fa.md) diff --git a/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/fr.md b/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/fr.md index 8f0a60472..d50cf4446 100644 --- a/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/fr.md +++ b/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/fr.md @@ -1,43 +1,31 @@ # ByteDance Première-Dernière Image vers Vidéo -# ByteDance First-Last-Frame to Video - -Ce nœud génère une vidéo en utilisant un texte d'invite ainsi que les premières et dernières images d'une image. Il crée une transition fluide entre les deux images, resulting in a complete video sequence. Le nœud offre une gamme d'options pour personnaliser la résolution, le ratio d'aspect, la durée et les paramètres de génération supplémentaires de la vidéo. +Ce nœud génère une vidéo à partir d’un prompt textuel ainsi que d’images de première et de dernière frame. Il utilise votre description et les deux images clés pour créer une séquence vidéo complète qui effectue une transition entre elles. Le nœud offre différentes options permettant de contrôler la résolution, le rapport hauteur/largeur, la durée et d’autres paramètres de génération de la vidéo. ## Entrées -| Paramètre | Description | Type de données | Obligatoire | Gamme | -|-----------|-------------|-----------|----------|-------| -| `modèle` | Le modèle à utiliser pour la génération de vidéo. Sélectionnez parmi les options disponibles (par défaut: `"seedance-1-5-pro-251215"`). | COMBO | Oui | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"` | -| `invite` | Le texte d'invite utilisé pour la génération de la vidéo. Cet invite ne doit pas contenir de paramètres spécifiques tels que la résolution, le ratio, la durée, le seed, camerafixed ou watermark. | STRING | Oui | - | -| `première_image` | La première image à utiliser pour la vidéo. L'image doit être entre 300x300 et 6000x6000 pixels et avoir un ratio d'aspect entre 0.4 et 2.5. | IMAGE | Oui | - | -| `dernière_image` | La dernière image à utiliser pour la vidéo. L'image doit être entre 300x300 et 6000x6000 pixels et avoir un ratio d'aspect entre 0.4 et 2.5. | IMAGE | Oui | - | -| `résolution` | La résolution de la vidéo de sortie. Choisissez parmi les options disponibles (par défaut: `"480p"`). | COMBO | Oui | `"480p"`
`"720p"`
`"1080p"` | -| `ratio_d'aspect` | Le ratio d'aspect de la vidéo de sortie. Sélectionnez parmi les options disponibles (par défaut: `"adaptive"`). | COMBO | Oui | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | -| `durée` | La durée de la vidéo de sortie en secondes (par défaut: 5). Pour le modèle `seedance-1-5-pro-251215`, la durée minimale supportée est de 4 secondes. | INT | Oui | 3 - 12 | -| `graine` | Le seed à utiliser pour la génération (par défaut: 0). Ce paramètre est optionnel. | INT | Non | 0 - 2147483647 | -| `camera_fixed` | Détermine si la caméra doit être fixée dans la vidéo. La plateforme ajoute une instruction pour fixer la caméra à votre invite, mais l'effet réel n'est pas garanti (par défaut: False). | BOOLEAN | Non | - | -| `watermark` | Détermine si un filigrane "Généré par l'IA" doit être ajouté à la vidéo (par défaut: False). | BOOLEAN | Non | - | -| `générer_audio` | Ce paramètre est ignoré pour tous les modèles sauf `seedance-1-5-pro-251215` (par défaut: False). | BOOLEAN | Non | - | +| Paramètre | Description | Type de données | Requis | Plage | +| --- | --- | --- | --- | --- | +| `modèle` | Le modèle utilisé pour la génération vidéo (défaut : `"seedance-1-5-pro-251215"`). | COMBO | Oui | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"` | +| `invite` | Le prompt textuel utilisé pour générer la vidéo. Ne doit pas être vide. | STRING | Oui | - | +| `première_image` | Première frame à utiliser pour la vidéo. Doit être comprise entre 300x300 et 6000x6000 pixels, avec un rapport hauteur/largeur compris entre 0.4 et 2.5. | IMAGE | Oui | - | +| `dernière_image` | Dernière frame à utiliser pour la vidéo. Doit être comprise entre 300x300 et 6000x6000 pixels, avec un rapport hauteur/largeur compris entre 0.4 et 2.5. | IMAGE | Oui | - | +| `résolution` | La résolution de la vidéo de sortie. | COMBO | Oui | `"480p"`
`"720p"`
`"1080p"` | +| `ratio_d'aspect` | Le rapport hauteur/largeur de la vidéo de sortie. | COMBO | Oui | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `durée` | La durée de la vidéo de sortie en secondes. Lorsque vous utilisez `seedance-1-5-pro-251215`, la durée minimale est de 4 secondes. (défaut : 5) | INT | Oui | 3 - 12 | +| `graine` | Graine (seed) à utiliser pour la génération. (défaut : 0) | INT | Non | 0 - 2147483647 | +| `camera_fixed` | Spécifie si la caméra doit être fixe. La plateforme ajoute une instruction pour fixer la caméra à votre prompt, mais ne garantit pas l’effet réel. (défaut : False) | BOOLEAN | Non | - | +| `watermark` | Indique si un filigrane « AI generated » doit être ajouté à la vidéo. (défaut : False) | BOOLEAN | Non | - | +| `générer_audio` | Ce paramètre est ignoré pour tous les modèles sauf `seedance-1-5-pro-251215`. (défaut : False) | BOOLEAN | Non | - | + +**Remarque :** Pour le modèle `seedance-1-5-pro-251215`, `duration` doit être d’au moins 4 secondes. `first_frame` et `last_frame` doivent tous deux être compris entre 300x300 et 6000x6000 pixels et avoir un rapport hauteur/largeur compris entre 0.4 et 2.5. ## Sorties | Nom de sortie | Description | Type de données | -|-------------|-------------|-----------| +| --- | --- | --- | | `output` | Le fichier vidéo généré. | VIDEO | -## Notes - -- Le paramètre `model` détermine les capacités et les limites du processus de génération de vidéo. -- L'invite `prompt` doit être créative et claire, car elle guidera la génération de la vidéo. -- Les images `first_frame` et `last_frame` doivent être représentatives du contenu de la vidéo souhaitée. -- Les paramètres `resolution` et `aspect_ratio` affecteront la qualité et les dimensions finales de la vidéo de sortie. -- Le paramètre `duration` définit la longueur de la vidéo, avec un minimum de 3 secondes et un maximum de 12 secondes. -- Le paramètre `seed` est optionnel et peut être utilisé pour la répétabilité du processus de génération de vidéo. -- Le paramètre `camera_fixed` est une option avancée qui peut ne pas toujours donner l'effet attendu. -- Le paramètre `watermark` peut être utilisé pour ajouter un filigrane à la vidéo, indiquant qu'elle a été générée par une IA. -- Le paramètre `generate_audio` est actuellement ignoré pour tous les modèles sauf `seedance-1-5-pro-251215`. - > 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/ByteDanceFirstLastFrameNode/fr.md) --- diff --git a/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/ja.md b/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/ja.md index 017675c45..4378b5506 100644 --- a/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/ja.md +++ b/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/ja.md @@ -1,42 +1,30 @@ # ByteDance 最初-最後フレームから動画生成 -# ByteDance First-Last-Frame to Video - -このノードは、テキストプロンプトと画像の最初および最後のフレームを使用してビデオを生成します。これにより、2つのフレーム間に滑らかな遷移が生まれ、完全なビデオシークエンスが作成されます。このノードは、ビデオの解像度、アスペクト比、長さ、および追加の生成パラメータをカスタマイズするためのオプションを提供します。 +このノードは、テキストプロンプトと最初と最後のフレーム画像を使用して動画を生成します。入力された説明文と2つのキーフレーム画像を基に、それらの間を遷移する動画シーケンスを生成します。また、動画の解像度、アスペクト比、長さ、その他の生成パラメータを制御するためのさまざまなオプションも提供します。 ## 入力 -| パラメータ | 説明 | データ型 | 必須 | 范囲 | -|-----------|-------------|-----------|----------|-------| -| `モデル` | ビデオ生成に使用するモデル。利用可能なオプションから選択してください(デフォルト: `"seedance-1-5-pro-251215"`)。 | COMBO | はい | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"` | -| `プロンプト` | ビデオ生成に使用するテキストプロンプト。このプロンプトには、解像度、比率、長さ、シード、カメラ固定、ウォーターマークなどの特定のパラメータを含めるべきではありません。 | STRING | はい | - | -| `最初のフレーム` | ビデオに使用する最初のフレーム。画像は300x300から6000x6000ピクセルの間で、アスペクト比は0.4から2.5の間でなければなりません。 | IMAGE | はい | - | -| `最後のフレーム` | ビデオに使用する最後のフレーム。画像は300x300から6000x6000ピクセルの間で、アスペクト比は0.4から2.5の間でなければなりません。 | IMAGE | はい | - | -| `解像度` | 出力ビデオの解像度。利用可能なオプションから選択してください(デフォルト: `"480p"`)。 | COMBO | はい | `"480p"`
`"720p"`
`"1080p"` | -| `アスペクト比` | 出力ビデオのアスペクト比。利用可能なオプションから選択してください(デフォルト: `"adaptive"`)。 | COMBO | はい | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | -| `再生時間` | 出力ビデオの長さ(秒)(デフォルト: 5)。`seedance-1-5-pro-251215`モデルの場合、サポートされる最小長さは4秒です。 | INT | はい | 3 - 12 | -| `シード` | 生成に使用するシード(デフォルト: 0)。このパラメータはオプションです。 | INT | いいえ | 0 - 2147483647 | -| `カメラ固定` | ビデオ内でカメラを固定するかどうかを指定します。プラットフォームはプロンプトにカメラを固定する指示を追加しますが、実際の効果は保証されません(デフォルト: False)。 | BOOLEAN | いいえ | - | -| `ウォーターマーク` | ビデオに「AI生成」というウォーターマークを追加するかどうかを決定します(デフォルト: False)。 | BOOLEAN | いいえ | - | -| `generate_audio` | このパラメータは、`seedance-1-5-pro-251215`モデル以外のすべてのモデルでは無視されます(デフォルト: False)。 | BOOLEAN | いいえ | - | +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +| --- | --- | --- | --- | --- | +| `モデル` | 動画生成に使用するモデルです(デフォルト: `"seedance-1-5-pro-251215"`)。 | COMBO | はい | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"` | +| `プロンプト` | 動画の生成に使用するテキストプロンプトです。空にすることはできません。 | STRING | はい | - | +| `最初のフレーム` | 動画の最初のフレームとして使用する画像です。画像サイズは300x300〜6000x6000ピクセル、アスペクト比は0.4〜2.5の範囲内である必要があります。 | IMAGE | はい | - | +| `最後のフレーム` | 動画の最後のフレームとして使用する画像です。画像サイズは300x300〜6000x6000ピクセル、アスペクト比は0.4〜2.5の範囲内である必要があります。 | IMAGE | はい | - | +| `解像度` | 出力動画の解像度です。 | COMBO | はい | `"480p"`
`"720p"`
`"1080p"` | +| `アスペクト比` | 出力動画のアスペクト比です。 | COMBO | はい | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `再生時間` | 出力動画の長さ(秒)です。`seedance-1-5-pro-251215` を使用する場合、最短時間は4秒です。(デフォルト: 5) | INT | はい | 3 - 12 | +| `シード` | 生成に使用するシード値です(デフォルト: 0)。 | INT | いいえ | 0 - 2147483647 | +| `カメラ固定` | カメラを固定するかどうかを指定します。プラットフォームはプロンプトにカメラを固定する指示を追加しますが、実際の効果は保証されません。(デフォルト: False) | BOOLEAN | いいえ | - | +| `ウォーターマーク` | 動画に「AI generated」の透かしを追加するかどうかを指定します。(デフォルト: False) | BOOLEAN | いいえ | - | +| `generate_audio` | このパラメータは、`seedance-1-5-pro-251215` 以外のモデルでは無視されます。(デフォルト: False) | BOOLEAN | いいえ | - | + +**注:** `seedance-1-5-pro-251215` モデルの場合、`duration` は4秒以上である必要があります。また、`first_frame` と `last_frame` はどちらも300x300〜6000x6000ピクセルの範囲内で、アスペクト比が0.4〜2.5の範囲内である必要があります。 ## 出力 | 出力名 | 説明 | データ型 | -|-------------|-------------|-----------| -| `output` | 生成されたビデオファイル。 | VIDEO | - -## 注意事項 - -- `model`パラメータは、ビデオ生成プロセスの機能と制限を決定します。 -- `prompt`は創造的で明確であるべきであり、ビデオ生成を導きます。 -- `first_frame`および`last_frame`の画像は、望むビデオコンテンツを代表するものを選んでください。 -- `resolution`および`aspect_ratio`パラメータは、最終出力ビデオの品質と寸法に影響を与えます。 -- `duration`パラメータは、ビデオの長さを設定し、最小3秒から最大12秒です。 -- `seed`パラメータはオプションであり、ビデオ生成プロセスの再現性を目的に使用できます。 -- `camera_fixed`パラメータは、期待される効果が常に得られない可能性のある高度なオプションです。 -- `watermark`パラメータは、ビデオにウォーターマークを追加して、AIによって生成されたことを示すことができます。 -- `generate_audio`パラメータは、現在、`seedance-1-5-pro-251215`モデル以外のすべてのモデルでは無視されます。 +| --- | --- | --- | +| `output` | 生成された動画ファイルです。 | VIDEO | > このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/ja.md) diff --git a/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/ko.md b/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/ko.md index 3957849e1..207f5be7f 100644 --- a/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/ko.md +++ b/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/ko.md @@ -1,42 +1,30 @@ # ByteDance 첫-마지막-프레임에서 비디오 생성 -# ByteDance 첫 번째-마지막 프레임을 비디오로 변환 - -이 노드는 텍스트 프롬프트와 이미지의 첫 번째 및 마지막 프레임을 사용하여 비디오를 생성합니다. 두 프레임 간의 원활한 전환을 통해 완전한 비디오 시퀀스를 생성합니다. 이 노드는 비디오의 해상도, 비율, 지속 시간 및 추가 생성 매개변수를 사용자 정의할 수 있는 다양한 옵션을 제공합니다. +이 노드는 텍스트 프롬프트와 첫 번째 및 마지막 프레임 이미지를 사용하여 비디오를 생성합니다. 사용자의 설명과 두 개의 키 프레임을 입력받아 두 프레임 사이를 전환하는 완전한 비디오 시퀀스를 만듭니다. 이 노드는 비디오의 해상도, 화면 비율, 길이 및 기타 생성 매개변수를 제어할 수 있는 다양한 옵션을 제공합니다. ## 입력 -| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | -|-----------|-------------|-----------|----------|-------| -| `model` | 비디오 생성을 위해 사용할 모델. 사용 가능한 옵션 중 선택하세요 (기본: `"seedance-1-5-pro-251215"`). | COMBO | 예 | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"` | -| `prompt` | 비디오 생성을 위해 사용할 텍스트 프롬프트. 이 프롬프트는 해상도, 비율, 지속 시간, 시드, 카메라 고정, 워터마크와 같은 특정 매개변수를 포함하지 않아야 합니다. | STRING | 예 | - | -| `first_frame` | 비디오에 사용할 첫 번째 프레임. 이미지는 300x300에서 6000x6000 픽셀 사이이며, 비율은 0.4에서 2.5 사이여야 합니다. | IMAGE | 예 | - | -| `last_frame` | 비디오에 사용할 마지막 프레임. 이미지는 300x300에서 6000x6000 픽셀 사이이며, 비율은 0.4에서 2.5 사이여야 합니다. | IMAGE | 예 | - | -| `resolution` | 출력 비디오의 해상도. 사용 가능한 옵션 중 선택하세요 (기본: `"480p"`). | COMBO | 예 | `"480p"`
`"720p"`
`"1080p"` | -| `aspect_ratio` | 출력 비디오의 비율. 사용 가능한 옵션 중 선택하세요 (기본: `"adaptive"`). | COMBO | 예 | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | -| `duration` | 출력 비디오의 지속 시간(초)(기본: 5). `seedance-1-5-pro-251215` 모델의 경우 최소 지원 지속 시간은 4초입니다. | INT | 예 | 3 - 12 | -| `seed` | 생성에 사용할 시드(기본: 0). 이 매개변수는 선택 사항입니다. | INT | 아님 | 0 - 2147483647 | -| `camera_fixed` | 비디오에서 카메라를 고정할지 여부를 지정합니다. 플랫폼은 프롬프트에 카메라 고정 명령을 추가하지만, 실제 효과는 보장되지 않습니다(기본: False). | BOOLEAN | 아님 | - | -| `watermark` | 비디오에 "AI 생성" 워터마크를 추가할지 여부를 결정합니다(기본: False). | BOOLEAN | 아님 | - | -| `generate_audio` | 이 매개변수는 모든 모델에서 `seedance-1-5-pro-251215` 모델을 제외하고 무시됩니다(기본: False). | BOOLEAN | 아님 | - | +| 매개변수 | 설명 | 데이터 타입 | 필수 여부 | 범위 | +| --- | --- | --- | --- | --- | +| `model` | 비디오 생성에 사용되는 모델입니다(기본값: `"seedance-1-5-pro-251215"`). | COMBO | 예 | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"` | +| `prompt` | 비디오 생성에 사용되는 텍스트 프롬프트입니다. 비어 있을 수 없습니다. | STRING | 예 | - | +| `first_frame` | 비디오에 사용할 첫 번째 프레임입니다. 300x300~6000x6000 픽셀이어야 하며, 화면 비율은 0.4~2.5 사이여야 합니다. | IMAGE | 예 | - | +| `last_frame` | 비디오에 사용할 마지막 프레임입니다. 300x300~6000x6000 픽셀이어야 하며, 화면 비율은 0.4~2.5 사이여야 합니다. | IMAGE | 예 | - | +| `resolution` | 출력 비디오의 해상도입니다. | COMBO | 예 | `"480p"`
`"720p"`
`"1080p"` | +| `aspect_ratio` | 출력 비디오의 화면 비율입니다. | COMBO | 예 | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `duration` | 출력 비디오의 지속 시간(초)입니다. `seedance-1-5-pro-251215`를 사용하는 경우 최소 지속 시간은 4초입니다. (기본값: 5) | INT | 예 | 3 - 12 | +| `seed` | 생성에 사용할 시드입니다. (기본값: 0) | INT | 아니오 | 0 - 2147483647 | +| `camera_fixed` | 카메라 고정 여부를 지정합니다. 플랫폼이 프롬프트에 카메라 고정 지시문을 추가하지만 실제 효과를 보장하지는 않습니다. (기본값: False) | BOOLEAN | 아니오 | - | +| `watermark` | 비디오에 "AI 생성" 워터마크를 추가할지 여부입니다. (기본값: False) | BOOLEAN | 아니오 | - | +| `generate_audio` | 이 매개변수는 `seedance-1-5-pro-251215`를 제외한 모든 모델에서 무시됩니다. (기본값: False) | BOOLEAN | 아니오 | - | + +**참고:** `seedance-1-5-pro-251215` 모델의 경우 `duration`은 4초 이상이어야 합니다. `first_frame`과 `last_frame`은 모두 300x300~6000x6000 픽셀이어야 하며, 화면 비율은 0.4~2.5 사이여야 합니다. ## 출력 | 출력 이름 | 설명 | 데이터 타입 | -|-------------|-------------|-----------| -| `output` | 생성된 비디오 파일. | VIDEO | - -## 주의사항 - -- `model` 매개변수는 비디오 생성 과정의 기능과 제한을 결정합니다. -- `prompt`은 창의적이고 명확해야 하며, 비디오 생성을 안내합니다. -- `first_frame` 및 `last_frame` 이미지는 원하는 비디오 내용을 대표해야 합니다. -- `resolution` 및 `aspect_ratio` 매개변수는 최종 출력 비디오의 품질과 크기를 영향을 미칩니다. -- `duration` 매개변수는 비디오의 길이를 설정하며, 최소 3초에서 최대 12초입니다. -- `seed` 매개변수는 선택 사항이며, 비디오 생성 과정의 재현성을 위해 사용할 수 있습니다. -- `camera_fixed` 매개변수는 고급 옵션으로, 항상 예상한 효과를 얻을 수는 없습니다. -- `watermark` 매개변수는 비디오에 워터마크를 추가하여 AI에 의해 생성된 것을 표시할 수 있습니다. -- `generate_audio` 매개변수는 현재 모든 모델에서 `seedance-1-5-pro-251215` 모델을 제외하고 무시됩니다. +| --- | --- | --- | +| `output` | 생성된 비디오 파일입니다. | VIDEO | > 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/ko.md) diff --git a/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/pt-BR.md b/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/pt-BR.md index 6159df0db..06fb0c46e 100644 --- a/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/pt-BR.md +++ b/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/pt-BR.md @@ -1,41 +1,31 @@ # ByteDance Primeiro-Último-Frame para Vídeo -Este nó gera um vídeo usando um prompt de texto juntamente com o primeiro e o último frames de uma imagem. Ele cria uma transição suave entre os dois frames, resultando em uma sequência de vídeo completa. O nó oferece uma variedade de opções para personalizar a resolução, proporção, duração e parâmetros adicionais de geração do vídeo. +Este nó gera um vídeo usando um prompt de texto juntamente com imagens do primeiro e do último quadro. Ele usa sua descrição e os dois quadros-chave para criar uma sequência de vídeo completa que faz a transição entre eles. O nó oferece várias opções para controlar a resolução, a proporção de aspecto, a duração e outros parâmetros de geração do vídeo. ## Entradas | Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | -|-----------|-------------|-----------|----------|-------| -| `model` | O modelo a ser usado para a geração de vídeo. Selecione entre as opções disponíveis (padrão: `"seedance-1-5-pro-251215"`). | COMBO | Sim | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"` | -| `prompt` | O prompt de texto usado para gerar o vídeo. Este prompt não deve conter parâmetros específicos como resolução, proporção, duração, seed, camerafixed ou watermark. | STRING | Sim | - | -| `first_frame` | O primeiro frame a ser usado para o vídeo. A imagem deve estar entre 300x300 e 6000x6000 pixels e ter uma proporção entre 0,4 e 2,5. | IMAGE | Sim | - | -| `last_frame` | O último frame a ser usado para o vídeo. A imagem deve estar entre 300x300 e 6000x6000 pixels e ter uma proporção entre 0,4 e 2,5. | IMAGE | Sim | - | -| `resolution` | A resolução do vídeo de saída. Escolha entre as opções disponíveis (padrão: `"480p"`). | COMBO | Sim | `"480p"`
`"720p"`
`"1080p"` | -| `aspect_ratio` | A proporção do vídeo de saída. Selecione entre as opções disponíveis (padrão: `"adaptive"`). | COMBO | Sim | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | -| `duration` | A duração do vídeo de saída em segundos (padrão: 5). Para o modelo `seedance-1-5-pro-251215`, a duração mínima suportada é 4 segundos. | INT | Sim | 3 - 12 | -| `seed` | O seed a ser usado para a geração (padrão: 0). Este parâmetro é opcional. | INT | Não | 0 - 2147483647 | -| `camera_fixed` | Especifica se o câmera deve ser fixada no vídeo. A plataforma adiciona uma instrução para fixar a câmera ao seu prompt, mas o efeito real não é garantido (padrão: Falso). | BOOLEAN | Não | - | -| `watermark` | Determina se deve ser adicionado um selo "Gerado por IA" ao vídeo (padrão: Falso). | BOOLEAN | Não | - | -| `generate_audio` | Este parâmetro é ignorado para todos os modelos exceto `seedance-1-5-pro-251215` (padrão: Falso). | BOOLEAN | Não | - | +| --- | --- | --- | --- | --- | +| `model` | O modelo usado para geração de vídeo (padrão: `"seedance-1-5-pro-251215"`). | COMBO | Sim | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"` | +| `prompt` | O prompt de texto usado para gerar o vídeo. Não deve estar vazio. | STRING | Sim | - | +| `first_frame` | Primeiro quadro a ser usado no vídeo. Deve ter entre 300x300 e 6000x6000 pixels, com uma proporção de aspecto entre 0.4 e 2.5. | IMAGE | Sim | - | +| `last_frame` | Último quadro a ser usado no vídeo. Deve ter entre 300x300 e 6000x6000 pixels, com uma proporção de aspecto entre 0.4 e 2.5. | IMAGE | Sim | - | +| `resolution` | A resolução do vídeo de saída. | COMBO | Sim | `"480p"`
`"720p"`
`"1080p"` | +| `aspect_ratio` | A proporção de aspecto do vídeo de saída. | COMBO | Sim | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `duration` | A duração do vídeo de saída em segundos. Ao usar `seedance-1-5-pro-251215`, a duração mínima é de 4 segundos. (padrão: 5) | INT | Sim | 3 - 12 | +| `seed` | Semente a ser usada para a geração. (padrão: 0) | INT | Não | 0 - 2147483647 | +| `camera_fixed` | Especifica se a câmera deve ser fixada. A plataforma acrescenta uma instrução para fixar a câmera ao seu prompt, mas não garante o efeito real. (padrão: False) | BOOLEAN | Não | - | +| `watermark` | Se deve adicionar uma marca d'água "AI generated" ao vídeo. (padrão: False) | BOOLEAN | Não | - | +| `generate_audio` | Este parâmetro é ignorado para qualquer modelo exceto `seedance-1-5-pro-251215`. (padrão: False) | BOOLEAN | Não | - | + +**Observação:** Para o modelo `seedance-1-5-pro-251215`, `duration` deve ser 4 segundos ou mais. Tanto `first_frame` quanto `last_frame` devem estar entre 300x300 e 6000x6000 pixels e ter uma proporção de aspecto entre 0.4 e 2.5. ## Saídas | Nome da Saída | Descrição | Tipo de Dados | -|-------------|-------------|-----------| +| --- | --- | --- | | `output` | O arquivo de vídeo gerado. | VIDEO | -## Notas - -- O parâmetro `model` determina as capacidades e limitações do processo de geração de vídeo. -- O `prompt` deve ser criativo e claro, pois ele guiará a geração do vídeo. -- As imagens `first_frame` e `last_frame` devem ser representativas do conteúdo desejado do vídeo. -- Os parâmetros `resolution` e `aspect_ratio` afetarão a qualidade e as dimensões finais do vídeo de saída. -- O parâmetro `duration` define a duração do vídeo, com um mínimo de 3 segundos e um máximo de 12 segundos. -- O parâmetro `seed` é opcional e pode ser usado para a reprodutibilidade do processo de geração de vídeo. -- O parâmetro `camera_fixed` é uma opção avançada que pode não sempre resultar no efeito esperado. -- O parâmetro `watermark` pode ser usado para adicionar um selo ao vídeo, indicando que ele foi gerado por uma IA. -- O parâmetro `generate_audio` é atualmente ignorado para todos os modelos exceto `seedance-1-5-pro-251215`. - > 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/ByteDanceFirstLastFrameNode/pt-BR.md) --- diff --git a/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/ru.md b/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/ru.md index de7ff737a..9ee6ec91a 100644 --- a/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/ru.md +++ b/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/ru.md @@ -1,42 +1,30 @@ # ByteDance - Преобразование первого-последнего кадра в видео -# ByteDance First-Last-Frame to Video - -Этот узел генерирует видео с использованием текстового запроса и первых и последних кадров изображения. Он создает плавный переход между двумя кадрами, что в результате создает целую последовательность видео. Узел предлагает множество опций для настройки разрешения видео, соотношения сторон, продолжительности и дополнительных параметров генерации. +Этот узел генерирует видео на основе текстового запроса и изображений первого и последнего кадров. Он принимает ваше описание и два ключевых кадра для создания полной видеопоследовательности с переходом между ними. Узел предоставляет различные опции для управления разрешением видео, соотношением сторон, длительностью и другими параметрами генерации. ## Входы -| Параметр | Описание | Тип данных | Обязателен | Диапазон | -|-----------|-------------|-----------|----------|-------| -| `модель` | Модель, которую использовать для генерации видео. Выберите из доступных вариантов (по умолчанию: `"seedance-1-5-pro-251215"`). | КОМБО | Да | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"` | -| `промпт` | Текстовый запрос, используемый для генерации видео. Этот запрос не должен содержать специфических параметров, таких как разрешение, соотношение сторон, продолжительность, seed, camerafixed или watermark. | STRING | Да | - | -| `first_frame` | Первый кадр, который будет использоваться для видео. Изображение должно быть между 300x300 и 6000x6000 пикселей и иметь соотношение сторон между 0.4 и 2.5. | IMAGE | Да | - | -| `last_frame` | Последний кадр, который будет использоваться для видео. Изображение должно быть между 300x300 и 6000x6000 пикселей и иметь соотношение сторон между 0.4 и 2.5. | IMAGE | Да | - | -| `resolution` | Разрешение выходного видео. Выберите из доступных вариантов (по умолчанию: `"480p"`). | КОМБО | Да | `"480p"`
`"720p"`
`"1080p"` | -| `aspect_ratio` | Соотношение сторон выходного видео. Выберите из доступных вариантов (по умолчанию: `"adaptive"`). | КОМБО | Да | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | -| `duration` | Продолжительность выходного видео в секундах (по умолчанию: 5). Для модели `seedance-1-5-pro-251215` минимальная поддерживаемая продолжительность составляет 4 секунды. | INT | Да | 3 - 12 | -| `seed` | Seed, который использовать для генерации (по умолчанию: 0). Этот параметр опционален. | INT | Нет | 0 - 2147483647 | -| `camera_fixed` | Определяет, следует ли фиксировать камеру в видео. Платформа добавляет инструкцию для фиксации камеры к вашему запросу, но фактический эффект не гарантируется (по умолчанию: False). | BOOLEAN | Нет | - | -| `watermark` | Определяет, следует ли добавлять водяной знак "AI generated" к видео (по умолчанию: False). | BOOLEAN | Нет | - | -| `generate_audio` | Этот параметр игнорируется для всех моделей, кроме `seedance-1-5-pro-251215` (по умолчанию: False). | BOOLEAN | Нет | - | +| Параметр | Описание | Тип данных | Обязательный | Диапазон | +| --- | --- | --- | --- | --- | +| `модель` | Модель, используемая для генерации видео (по умолчанию: `"seedance-1-5-pro-251215"`). | COMBO | Да | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"` | +| `промпт` | Текстовый запрос, используемый для генерации видео. Не должен быть пустым. | STRING | Да | - | +| `first_frame` | Первый кадр, используемый для видео. Должен иметь размер от 300x300 до 6000x6000 пикселей и соотношение сторон от 0.4 до 2.5. | IMAGE | Да | - | +| `last_frame` | Последний кадр, используемый для видео. Должен иметь размер от 300x300 до 6000x6000 пикселей и соотношение сторон от 0.4 до 2.5. | IMAGE | Да | - | +| `resolution` | Разрешение выходного видео. | COMBO | Да | `"480p"`
`"720p"`
`"1080p"` | +| `aspect_ratio` | Соотношение сторон выходного видео. | COMBO | Да | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `duration` | Длительность выходного видео в секундах. При использовании `seedance-1-5-pro-251215` минимальная длительность составляет 4 секунды. (по умолчанию: 5) | INT | Да | 3 - 12 | +| `seed` | Сид для генерации. (по умолчанию: 0) | INT | Нет | 0 - 2147483647 | +| `camera_fixed` | Указывает, нужно ли фиксировать камеру. Платформа добавляет инструкцию зафиксировать камеру к вашему запросу, но не гарантирует фактический эффект. (по умолчанию: False) | BOOLEAN | Нет | - | +| `watermark` | Определяет, нужно ли добавлять водяной знак «AI generated» на видео. (по умолчанию: False) | BOOLEAN | Нет | - | +| `generate_audio` | Этот параметр игнорируется для всех моделей, кроме `seedance-1-5-pro-251215`. (по умолчанию: False) | BOOLEAN | Нет | - | + +**Примечание:** Для модели `seedance-1-5-pro-251215` параметр `duration` должен быть не менее 4 секунд. Как `first_frame`, так и `last_frame` должны иметь размер от 300x300 до 6000x6000 пикселей и соотношение сторон от 0.4 до 2.5. ## Выходы -| Название выходного параметра | Описание | Тип данных | -|-------------|-------------|-----------| -| `output` | Генерируемый файл видео. | VIDEO | - -## Примечания - -- Параметр `model` определяет возможности и ограничения процесса генерации видео. -- Запрос `prompt` должен быть креативным и ясным, так как он будет направлять процесс генерации видео. -- Изображения `first_frame` и `last_frame` должны быть代表性 для желаемого контента видео. -- Параметры `resolution` и `aspect_ratio` будут влиять на качество и размеры конечного выходного видео. -- Параметр `duration` устанавливает продолжительность видео, с минимальным значением 3 секунды и максимальным значением 12 секунд. -- Параметр `seed` опционален и может быть использован для повторяемости процесса генерации видео. -- Параметр `camera_fixed` является продвинутым параметром и может не всегда давать ожидаемый эффект. -- Параметр `watermark` может быть использован для добавления водяного знака к видео, указывающего, что оно было сгенерировано AI. -- Параметр `generate_audio` в настоящее время игнорируется для всех моделей, кроме `seedance-1-5-pro-251215`. +| Имя выхода | Описание | Тип данных | +| --- | --- | --- | +| `output` | Сгенерированный видеофайл. | VIDEO | > Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/ru.md) diff --git a/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/tr.md b/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/tr.md index 25b12b0e3..aa8bb10e2 100644 --- a/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/tr.md +++ b/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/tr.md @@ -1,41 +1,31 @@ # ByteDance İlk-Son-Kare'den Videoya -Bu düğüm, bir metin ipucu ve bir resmin ilk ve son karelerini kullanarak bir video oluşturur. İki kare arasında sorunsuz bir geçiş yaparak tam bir video sırası oluşturur. Düğüm, videoyun çözünürlüğü, en boy oranı, süresi ve ilave oluşturma parametrelerini özelleştirmek için çeşitli seçenekler sunar. +Bu düğüm, bir metin istemi ile ilk ve son kare görsellerini kullanarak bir video oluşturur. Açıklamanızı ve iki ana kareyi alarak bunlar arasında geçiş yapan eksiksiz bir video dizisi üretir. Düğüm; videonun çözünürlüğünü, en-boy oranını, süresini ve diğer üretim parametrelerini kontrol etmek için çeşitli seçenekler sunar. ## Girdiler -| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | -|-----------|-------------|-----------|----------|-------| -| `model` | Video oluşturma için kullanılacak model. Mevcut seçeneklerden birini seçin (varsayılan: `"seedance-1-5-pro-251215"`). | COMBO | Evet | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"` | -| `prompt` | Video oluşturma için kullanılacak metin ipucu. Bu ipucu, çözünürlük, orans, süre, seed, camerafixed veya watermark gibi belirli parametreler içermemelidir. | STRING | Evet | - | -| `ilk_kare` | Video için kullanılacak ilk kare. Resmin 300x300 ve 6000x6000 piksel arasında olmalı ve 0.4 ile 2.5 arasında bir en boy oranı olmalıdır. | IMAGE | Evet | - | -| `son_kare` | Video için kullanılacak son kare. Resmin 300x300 ve 6000x6000 piksel arasında olmalı ve 0.4 ile 2.5 arasında bir en boy oranı olmalıdır. | IMAGE | Evet | - | -| `çözünürlük` | Çıkış videoyun çözünürlüğü. Mevcut seçeneklerden birini seçin (varsayılan: `"480p"`). | COMBO | Evet | `"480p"`
`"720p"`
`"1080p"` | -| `en_boy_oranı` | Çıkış videoyun en boy oranı. Mevcut seçeneklerden birini seçin (varsayılan: `"adaptive"`). | COMBO | Evet | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | -| `süre` | Çıkış videoyun süresi saniye cinsinden (varsayılan: 5). `seedance-1-5-pro-251215` modeli için en düşük desteklenen süre 4 saniyedir. | INT | Evet | 3 - 12 | -| `tohum` | Oluşturma için kullanılacak seed (varsayılan: 0). Bu parametre isteğe bağlıdır. | INT | Hayır | 0 - 2147483647 | -| `sabit_kamera` | Video içinde kamerayı sabitlemeyi belirtir. Platform, ipucunuza kamera sabitleme talimatı ekler, ancak gerçek etkisi garantilenmez (varsayılan: False). | BOOLEAN | Hayır | - | -| `filigran` | Videoya "AI generated" su izi eklemeyi belirler (varsayılan: False). | BOOLEAN | Hayır | - | -| `ses_oluştur` | Bu parametre, `seedance-1-5-pro-251215` dışındaki tüm modeller için göz ardı edilir (varsayılan: False). | BOOLEAN | Hayır | - | +| Parametre | Açıklama | Veri Türü | Zorunlu | Aralık | +| --- | --- | --- | --- | --- | +| `model` | Video oluşturmak için kullanılan model (varsayılan: `"seedance-1-5-pro-251215"`). | COMBO | Evet | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"` | +| `prompt` | Videoyu oluşturmak için kullanılan metin istemi. Boş olmamalıdır. | STRING | Evet | - | +| `ilk_kare` | Videoda kullanılacak ilk kare. 300x300 ile 6000x6000 piksel arasında ve en-boy oranı 0.4 ile 2.5 arasında olmalıdır. | IMAGE | Evet | - | +| `son_kare` | Videoda kullanılacak son kare. 300x300 ile 6000x6000 piksel arasında ve en-boy oranı 0.4 ile 2.5 arasında olmalıdır. | IMAGE | Evet | - | +| `çözünürlük` | Çıktı videosunun çözünürlüğü. | COMBO | Evet | `"480p"`
`"720p"`
`"1080p"` | +| `en_boy_oranı` | Çıktı videosunun en-boy oranı. | COMBO | Evet | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `süre` | Çıktı videosunun saniye cinsinden süresi. `seedance-1-5-pro-251215` kullanılırken minimum süre 4 saniyedir. (varsayılan: 5) | INT | Evet | 3 - 12 | +| `tohum` | Üretimde kullanılacak seed değeri. (varsayılan: 0) | INT | Hayır | 0 - 2147483647 | +| `sabit_kamera` | Kameranın sabitlenip sabitlenmeyeceğini belirtir. Platform, isteminize kamerayı sabitleme talimatını ekler ancak gerçek efektin garantisi yoktur. (varsayılan: False) | BOOLEAN | Hayır | - | +| `filigran` | Videoya "AI generated" filigranı eklenip eklenmeyeceğini belirtir. (varsayılan: False) | BOOLEAN | Hayır | - | +| `ses_oluştur` | Bu parametre, `seedance-1-5-pro-251215` dışındaki tüm modellerde yok sayılır. (varsayılan: False) | BOOLEAN | Hayır | - | + +**Not:** `seedance-1-5-pro-251215` modeli için `duration` en az 4 saniye olmalıdır. Hem `first_frame` hem de `last_frame` 300x300 ile 6000x6000 piksel arasında olmalı ve en-boy oranı 0.4 ile 2.5 arasında bulunmalıdır. ## Çıktılar | Çıktı Adı | Açıklama | Veri Türü | -|-------------|-------------|-----------| +| --- | --- | --- | | `output` | Oluşturulan video dosyası. | VIDEO | -## Notlar - -- `model` parametresi, video oluşturma sürecinin yetenekleri ve sınırlamalarını belirler. -- `prompt` yaratıcı ve açık olmalıdır, çünkü bu ipucu video oluşturmayı yönlendirecektir. -- `first_frame` ve `last_frame` kareleri, istenen video içeriğinin temsilcisi olmalıdır. -- `resolution` ve `aspect_ratio` parametreleri, son çıktı videoyun kalitesi ve boyutlarını etkileyecektir. -- `duration` parametresi, videoyun süresini ayarlar, en düşük 3 saniye ve en yüksek 12 saniye arasında olabilir. -- `seed` parametresi isteğe bağlıdır ve video oluşturma sürecinin tekrarlanabilirliğini sağlayabilir. -- `camera_fixed` parametresi, beklenen etkiyi her zaman sağlamayabilir olan ileri düzey bir seçenektir. -- `watermark` parametresi, videoya su izi eklemek için kullanılabilir ve bu, videoyun AI tarafından oluşturulduğunu belirtir. -- `generate_audio` parametresi, şu anda `seedance-1-5-pro-251215` dışındaki tüm modeller için göz ardı edilir. - > 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/ByteDanceFirstLastFrameNode/tr.md) --- diff --git a/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/zh-TW.md b/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/zh-TW.md index 5edaae0eb..06dc83429 100644 --- a/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/zh-TW.md +++ b/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/zh-TW.md @@ -1,43 +1,31 @@ # 字節跳動首尾幀轉影片 -# ByteDance 首尾畫面至影片 - -此節點透過使用文字提示以及圖片的第 一 個和最 後 一 個畫面來生成影片。它會在這兩個畫面之間創建一個流暢的過渡,從而產生一 個完整的影片序列。此節點提供了一系列選項,用於自 定義影片的解析度、畫面 比例、持續時間以及額外的生成參數。 +此節點使用文字提示以及首幀和末幀影像來生成影片。它會根據您的描述和兩個關鍵幀來建立完整的影片序列,並在兩者之間進行轉場。此節點提供多種選項,可控制影片的解析度、長寬比、時長及其他生成參數。 ## 輸入 -| 參數 | 描述 | 資料類型 | 必需 | 范圍 | -|-----------|-------------|-----------|----------|-------| -| `模型` | 使用於影片生成的模型。從可選選項中選擇(默認:`"seedance-1-5-pro-251215"`)。 | COMBO | 是 | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"` | -| `提示詞` | 用於生成影片的文字提示。此提示不應包含具體參數,例如解析度、比例、持續時間、種子、相機固定或水印。 | STRING | 是 | - | -| `首幀` | 用於影片的第一個畫面。圖片必須在 300x300 和 6000x6000 像素之間,並具有 0.4 和 2.5 之間的畫面 比例。 | IMAGE | 是 | - | -| `尾幀` | 用於影片的最後一個畫面。圖片必須在 300x300 和 6000x6000 像素之間,並具有 0.4 和 2.5 之間的畫面 比例。 | IMAGE | 是 | - | -| `解析度` | 輸出影片的解析度。從可選選項中選擇(默認:`"480p"`)。 | COMBO | 是 | `"480p"`
`"720p"`
`"1080p"` | -| `長寬比` | 輸出影片的畫面比例。從可選選項中選擇(默認:`"adaptive"`)。 | COMBO | 是 | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | -| `持續時間` | 輸出影片的持續時間(以秒為單位,默認:5)。對於 `seedance-1-5-pro-251215` 模型,最低支援的持續時間為 4 秒。 | INT | 是 | 3 - 12 | -| `種子值` | 用於生成的種子(默認:0)。此參數為選擇性。 | INT | 否 | 0 - 2147483647 | -| `固定攝影機` | 指定是否在影片中固定相機。平台會將固定相機的指示添加到您的提示中,但實際效果不保證(默認:False)。 | BOOLEAN | 否 | - | -| `浮水印` | 確定是否在影片中添加 "AI generated" 水印(默認:False)。 | BOOLEAN | 否 | - | -| `generate_audio` | 此參數對除 `seedance-1-5-pro-251215` 以外的所有模型都無效(默認:False)。 | BOOLEAN | 否 | - | +| 參數 | 描述 | 資料型別 | 必填 | 範圍 | +| --- | --- | --- | --- | --- | +| `模型` | 用於影片生成的模型(預設:`"seedance-1-5-pro-251215"`)。 | COMBO | 是 | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"` | +| `提示詞` | 用於生成影片的文字提示。不能為空。 | STRING | 是 | - | +| `首幀` | 用於影片的首幀。必須介於 300x300 和 6000x6000 像素之間,且長寬比介於 0.4 與 2.5 之間。 | IMAGE | 是 | - | +| `尾幀` | 用於影片的末幀。必須介於 300x300 和 6000x6000 像素之間,且長寬比介於 0.4 與 2.5 之間。 | IMAGE | 是 | - | +| `解析度` | 輸出影片的解析度。 | COMBO | 是 | `"480p"`
`"720p"`
`"1080p"` | +| `長寬比` | 輸出影片的長寬比。 | COMBO | 是 | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `持續時間` | 輸出影片的時長(以秒為單位)。使用 `seedance-1-5-pro-251215` 時,最短時長為 4 秒。(預設:5) | INT | 是 | 3 - 12 | +| `種子值` | 用於生成的種子。(預設:0) | INT | 否 | 0 - 2147483647 | +| `固定攝影機` | 指定是否固定相機。平台會將固定相機的指令附加到您的提示中,但不保證實際效果。(預設:False) | BOOLEAN | 否 | - | +| `浮水印` | 是否在影片中加入 "AI generated" 浮水印。(預設:False) | BOOLEAN | 否 | - | +| `generate_audio` | 除了 `seedance-1-5-pro-251215` 之外,此參數對任何模型都會被忽略。(預設:False) | BOOLEAN | 否 | - | + +**注意:** 對於 `seedance-1-5-pro-251215` 模型,`duration` 必須為 4 秒或以上。`first_frame` 和 `last_frame` 均必須介於 300x300 和 6000x6000 像素之間,且長寬比介於 0.4 與 2.5 之間。 ## 輸出 -| 輸出名 | 描述 | 資料類型 | -|-------------|-------------|-----------| +| 輸出名稱 | 描述 | 資料型別 | +| --- | --- | --- | | `output` | 生成的影片檔案。 | VIDEO | -## 記錄 - -- `model` 參數決定了影片生成過程的功能和限制。 -- `prompt` 必須具有創意和清晰性,因為它將引導影片的生成。 -- `first_frame` 和 `last_frame` 圖片應該代表期望的影片內容。 -- `resolution` 和 `aspect_ratio` 參數將影響最終輸出影片的質量和尺寸。 -- `duration` 參數設定了影片的長度,最小為 3 秒,最大為 12 秒。 -- `seed` 參數為選擇性,可用於確保影片生成過程的可重複性。 -- `camera_fixed` 參數是一個高級選項,可能不總是會產生預期的效果。 -- `watermark` 參數可用於在影片中添加水印,指示其由 AI 生成的。 -- `generate_audio` 參數目前對除 `seedance-1-5-pro-251215` 以外的所有模型都無效。 - > 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/zh-TW.md) --- diff --git a/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/zh.md b/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/zh.md index 7872bb58f..ebf855573 100644 --- a/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/zh.md +++ b/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/zh.md @@ -1,43 +1,31 @@ # 字节跳动首尾帧转视频 -# ByteDance 首帧-末帧到视频 - -此节点通过使用文本提示以及图像的首帧和末帧来生成视频。它在这两个帧之间创建无缝的过渡,从而形成一个完整的视频序列。该节点提供了一系列选项,用于自定义视频的分辨率、宽高比、时长以及额外的生成参数。 +此节点使用文本提示词以及首帧和末帧图像生成视频。它会根据你的描述和这两个关键帧,创建一段在它们之间过渡的完整视频序列。该节点提供了多种选项,用于控制视频的分辨率、宽高比、时长及其他生成参数。 ## 输入 -| 参数 | 描述 | 数据类型 | 必需 | 范围 | -|-----------|-------------|-----------|----------|-------| -| `模型` | 用于视频生成的模型。从可用选项中选择(默认:`"seedance-1-5-pro-251215"`)。 | COMBO | 是 | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"` | -| `提示` | 用于生成视频的文本提示。此提示不应包含特定参数,如分辨率、比例、时长、种子、相机固定或水印。 | STRING | 是 | - | -| `第一帧` | 用于视频的首帧。图像大小必须在 300x300 到 6000x6000 像素之间,并且宽高比必须在 0.4 到 2.5 之间。 | IMAGE | 是 | - | -| `最后一帧` | 用于视频的末帧。图像大小必须在 300x300 到 6000x6000 像素之间,并且宽高比必须在 0.4 到 2.5 之间。 | IMAGE | 是 | - | -| `分辨率` | 输出视频的分辨率。从可用选项中选择(默认:`"480p"`)。 | COMBO | 是 | `"480p"`
`"720p"`
`"1080p"` | -| `宽高比` | 输出视频的宽高比。从可用选项中选择(默认:`"adaptive"`)。 | COMBO | 是 | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | -| `时长` | 输出视频的时长(以秒为单位,默认:5)。对于 `seedance-1-5-pro-251215` 模型,最小支持的时长为 4 秒。 | INT | 是 | 3 - 12 | -| `种子` | 用于生成的种子(默认:0)。此参数为可选。 | INT | 否 | 0 - 2147483647 | -| `相机固定` | 指定是否在视频中固定相机。平台会在您的提示中附加一个固定相机的指令,但实际效果不能保证(默认:False)。 | BOOLEAN | 否 | - | -| `水印` | 确定是否在视频中添加“AI生成”水印(默认:False)。 | BOOLEAN | 否 | - | -| `generate_audio` | 此参数仅对 `seedance-1-5-pro-251215` 模型以外的所有模型忽略(默认:False)。 | BOOLEAN | 否 | - | +| 参数 | 描述 | 数据类型 | 是否必需 | 范围 | +| --- | --- | --- | --- | --- | +| `模型` | 用于视频生成的模型(默认值:`"seedance-1-5-pro-251215"`)。 | COMBO | 是 | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"` | +| `提示` | 用于生成视频的文本提示词。不能为空。 | STRING | 是 | - | +| `第一帧` | 用于视频的第一帧。必须介于 300x300 与 6000x6000 像素之间,且宽高比介于 0.4 与 2.5 之间。 | IMAGE | 是 | - | +| `最后一帧` | 用于视频的最后一帧。必须介于 300x300 与 6000x6000 像素之间,且宽高比介于 0.4 与 2.5 之间。 | IMAGE | 是 | - | +| `分辨率` | 输出视频的分辨率。 | COMBO | 是 | `"480p"`
`"720p"`
`"1080p"` | +| `宽高比` | 输出视频的宽高比。 | COMBO | 是 | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `时长` | 输出视频的时长(秒)。使用 `seedance-1-5-pro-251215` 时,最短时长为 4 秒。(默认值:5) | INT | 是 | 3 - 12 | +| `种子` | 用于生成的种子。(默认值:0) | INT | 否 | 0 - 2147483647 | +| `相机固定` | 指定是否固定镜头。平台会在你的提示词后面附加一条固定镜头的指令,但不保证实际效果。(默认值:False) | BOOLEAN | 否 | - | +| `水印` | 是否在视频中添加“AI 生成”水印。(默认值:False) | BOOLEAN | 否 | - | +| `generate_audio` | 对于除 `seedance-1-5-pro-251215` 之外的任何模型,此参数均会被忽略。(默认值:False) | BOOLEAN | 否 | - | + +**注意:** 对于 `seedance-1-5-pro-251215` 模型,`duration` 必须大于或等于 4 秒。`first_frame` 和 `last_frame` 都必须介于 300x300 与 6000x6000 像素之间,并且宽高比需要在 0.4 与 2.5 之间。 ## 输出 | 输出名称 | 描述 | 数据类型 | -|-------------|-------------|-----------| +| --- | --- | --- | | `output` | 生成的视频文件。 | VIDEO | -## 注意事项 - -- `model` 参数决定了视频生成过程的功能和限制。 -- `prompt` 应该富有创意且清晰,因为它将指导视频生成。 -- `first_frame` 和 `last_frame` 图像应该代表期望的视频内容。 -- `resolution` 和 `aspect_ratio` 参数将影响最终输出视频的质量和尺寸。 -- `duration` 参数设置视频的长度,最小为 3 秒,最大为 12 秒。 -- `seed` 参数为可选,可用于视频生成过程的可重复性。 -- `camera_fixed` 参数是一个高级选项,可能不会总是产生预期的效果。 -- `watermark` 参数可用于在视频中添加水印,表明它是由 AI 生成的。 -- `generate_audio` 参数目前仅对 `seedance-1-5-pro-251215` 模型以外的所有模型忽略。 - > 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceFirstLastFrameNode/zh.md) --- diff --git a/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/ar.md b/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/ar.md index 455dc84e4..6e4d6ea47 100644 --- a/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/ar.md +++ b/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/ar.md @@ -1,31 +1,29 @@ # ByteDance من صورة إلى فيديو -# وحدة تحويل الصورة إلى فيديو من ByteDance - -تقوم وحدة تحويل الصورة إلى فيديو من ByteDance بإنشاء فيديو من صورة مدخلة وتعليمات نصية باستخدام API من ByteDance. تخلق سلسلة فيديو تعكس بشكل مرئي الوصف المقدم، مع خيارات تخصيص دقة الخروج، نسبة الأبعاد، المدة، وغيرها من المعلمات. +تُنشئ عقدة ByteDance لتحويل الصورة إلى فيديو مقاطع فيديو باستخدام نماذج ByteDance عبر واجهة برمجة التطبيقات، وذلك بناءً على صورة إدخال وموجه نصي. تأخذ إطارًا أوليًا للصورة وتُنشئ تسلسل فيديو يتبع الوصف المقدَّم. وتوفر العقدة خيارات تخصيص متنوعة لدقة الفيديو ونسبة العرض إلى الارتفاع والمدة وسائر معاملات التوليد. ## المدخلات -| المعامل | الوصف | نوع البيانات | إلزامي | نطاق | +| المعامل | الوصف | نوع البيانات | إلزامي | النطاق | |-----------|-------------|-----------|----------|-------| -| `model` | النموذج من ByteDance الذي سيتم استخدامه لإنشاء الفيديو. الخيارات المتاحة هي:
`"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | STRING | نعم | كما هو مذكور أعلاه | -| `prompt` | التعليمات النصية المستخدمة لإنشاء الفيديو. يجب أن يكون الطول بعد إزالة البيانات الزائدة على الأقل 1 حرف. | STRING | نعم | - | -| `image` | الصورة الأولى التي سيتم استخدامها للفيديو. يجب أن تكون الصورة بين 300x300 و 6000x6000 بكسل، مع نسبة الأبعاد بين 0.4 و 2.5. | IMAGE | نعم | - | -| `resolution` | دقة الفيديو الخروج. الخيارات المتاحة هي:
`"480p"`
`"720p"`
`"1080p"` | STRING | نعم | كما هو مذكور أعلاه | -| `aspect_ratio` | نسبة الأبعاد للفيديو الخروج. الخيارات المتاحة هي:
`"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | STRING | نعم | كما هو مذكور أعلاه | -| `duration` | مدة الفيديو الخروج بالثواني. بالنسبة لنموذج `seedance-1-5-pro-251215`، هي الأقل مدة مدعومة 4 ثانية. | INT | نعم | 3 - 12 | -| `seed` | البذرة التي سيتم استخدامها للإنشاء. اختياري، مع قيمة افتراضية 0. | INT | لا | 0 - 2147483647 | -| `camera_fixed` | تحديد ما إذا كان يجب تثبيت الكاميرا. يضيف المنصة تعليمات لتثبيت الكاميرا إلى التعليمات النصية الخاصة بك، ولكن لا يضمن التأثير الفعلي. اختياري، مع قيمة افتراضية False. | BOOLEAN | لا | - | -| `watermark` | ما إذا كان يجب إضافة علامة مائية "مولد بواسطة AI" إلى الفيديو. اختياري، مع قيمة افتراضية False. | BOOLEAN | لا | - | -| `توليد الصوت` | يتم تجاهل هذا المعامل لجميع النماذج باستثناء `seedance-1-5-pro-251215`. اختياري، مع قيمة افتراضية False. | BOOLEAN | لا | - | - -**ملاحظة:** يجب ألا تحتوي التعليمات النصية على الكلمات التالية (بغض النظر عن الحالة): `resolution`، `ratio`، `duration`، `seed`، `camerafixed`، `watermark`. يتم ضبط هذه المعلمات عبر المدخلات المخصصة لها. +| `model` | نموذج ByteDance المستخدم في توليد الفيديو (الافتراضي: `"seedance-1-0-pro-fast-251015"`). | COMBO | نعم | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | +| `prompt` | الموجه النصي المستخدم لتوليد الفيديو. يجب أن يبلغ طوله حرفًا واحدًا على الأقل بعد إزالة الفراغات من الأطراف. | STRING | نعم | - | +| `image` | الإطار الأول المستخدم في الفيديو. يجب أن يكون بين 300×300 و6000×6000 بكسل، مع نسبة عرض إلى ارتفاع بين 0.4 و2.5. | IMAGE | نعم | - | +| `resolution` | دقة الفيديو الناتج. | COMBO | نعم | `"480p"`
`"720p"`
`"1080p"` | +| `aspect_ratio` | نسبة العرض إلى الارتفاع للفيديو الناتج. | COMBO | نعم | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `duration` | مدة الفيديو الناتج بالثواني (الافتراضي: 5). بالنسبة لنموذج `seedance-1-5-pro-251215`، الحد الأدنى للمدة المدعومة هو 4 ثوانٍ. | INT | نعم | 3 - 12 | +| `seed` | البذرة المستخدمة في التوليد (الافتراضي: 0). | INT | لا | 0 - 2147483647 | +| `camera_fixed` | يحدد ما إذا كان سيتم تثبيت الكاميرا. تُضيف المنصة تعليمةً إلى موجهك لتثبيت الكاميرا، لكنها لا تضمن التأثير الفعلي (الافتراضي: False). | BOOLEAN | لا | `False`
`True` | +| `watermark` | يحدد ما إذا كان سيتم إضافة علامة مائية بعبارة "AI generated" إلى الفيديو (الافتراضي: False). | BOOLEAN | لا | `False`
`True` | +| `توليد الصوت` | يتم تجاهل هذا المعامل لأي نموذج ما عدا `seedance-1-5-pro-251215` (الافتراضي: False). | BOOLEAN | لا | `False`
`True` | + +**ملاحظة:** يجب ألا يحتوي الموجه النصي على الكلمات التالية (بغض النظر عن حالة الأحرف): `resolution`, `ratio`, `duration`, `seed`, `camerafixed`, `watermark`. يتم ضبط هذه المعاملات عبر مدخلاتها المخصصة. ## المخرجات -| اسم المخرج | الوصف | نوع البيانات | +| اسم المخرَج | الوصف | نوع البيانات | |-------------|-------------|-----------| -| `output` | ملف الفيديو المولد بناءً على المعلمات المدخلة للصورة والتعليمات النصية. | VIDEO | +| `output` | ملف الفيديو الناتج استنادًا إلى صورة الإدخال ومعاملات الموجه النصي. | VIDEO | > تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/ar.md) diff --git a/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/en.md b/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/en.md index 980fdcfba..8fbb8b0ad 100644 --- a/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/en.md +++ b/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/en.md @@ -1,23 +1,21 @@ # ByteDance Image to Video -# ByteDance Image to Video Node - -The ByteDance Image to Video node generates a video from an input image and a text prompt using ByteDance's API. It creates a video sequence that visually represents the provided description, with options to customize the output's resolution, aspect ratio, duration, and other parameters. +The ByteDance Image to Video node generates videos using ByteDance models through an API based on an input image and text prompt. It takes a starting image frame and creates a video sequence that follows the provided description. The node offers various customization options for video resolution, aspect ratio, duration, and other generation parameters. ## Inputs | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `model` | The ByteDance model to use for video generation. Available options are:
`"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | STRING | Yes | As listed above | +| `model` | The ByteDance model to use for video generation (default: `"seedance-1-0-pro-fast-251015"`). | COMBO | Yes | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | | `prompt` | The text prompt used to generate the video. Must be at least 1 character long after trimming whitespace. | STRING | Yes | - | -| `image` | The first frame to be used for the video. The image must be between 300x300 and 6000x6000 pixels, with an aspect ratio between 0.4 and 2.5. | IMAGE | Yes | - | -| `resolution` | The resolution of the output video. Available options are:
`"480p"`
`"720p"`
`"1080p"` | STRING | Yes | As listed above | -| `aspect_ratio` | The aspect ratio of the output video. Available options are:
`"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | STRING | Yes | As listed above | -| `duration` | The duration of the output video in seconds. For the `seedance-1-5-pro-251215` model, the minimum supported duration is 4 seconds. | INT | Yes | 3 - 12 | -| `seed` | Seed to use for generation. Optional, with a default value of 0. | INT | No | 0 - 2147483647 | -| `camera_fixed` | Specifies whether to fix the camera. The platform appends an instruction to fix the camera to your prompt, but does not guarantee the actual effect. Optional, with a default value of False. | BOOLEAN | No | - | -| `watermark` | Whether to add an "AI generated" watermark to the video. Optional, with a default value of False. | BOOLEAN | No | - | -| `generate_audio` | This parameter is ignored for any model except `seedance-1-5-pro-251215`. Optional, with a default value of False. | BOOLEAN | No | - | +| `image` | First frame to be used for the video. Must be between 300x300 and 6000x6000 pixels, with an aspect ratio between 0.4 and 2.5. | IMAGE | Yes | - | +| `resolution` | The resolution of the output video. | COMBO | Yes | `"480p"`
`"720p"`
`"1080p"` | +| `aspect_ratio` | The aspect ratio of the output video. | COMBO | Yes | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `duration` | The duration of the output video in seconds (default: 5). For the `seedance-1-5-pro-251215` model, the minimum supported duration is 4 seconds. | INT | Yes | 3 - 12 | +| `seed` | Seed to use for generation (default: 0). | INT | No | 0 - 2147483647 | +| `camera_fixed` | Specifies whether to fix the camera. The platform appends an instruction to fix the camera to your prompt, but does not guarantee the actual effect (default: False). | BOOLEAN | No | `False`
`True` | +| `watermark` | Whether to add an "AI generated" watermark to the video (default: False). | BOOLEAN | No | `False`
`True` | +| `generate_audio` | This parameter is ignored for any model except `seedance-1-5-pro-251215` (default: False). | BOOLEAN | No | `False`
`True` | **Note:** The prompt must not contain the following words (case-insensitive): `resolution`, `ratio`, `duration`, `seed`, `camerafixed`, `watermark`. These parameters are set via their dedicated inputs. @@ -27,8 +25,6 @@ The ByteDance Image to Video node generates a video from an input image and a te |-------------|-------------|-----------| | `output` | The generated video file based on the input image and prompt parameters. | VIDEO | -The documentation provided above reflects the information extracted from the source code and adheres to the guidelines specified for the structure and content of the documentation. - > 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/ByteDanceImageToVideoNode/en.md) --- diff --git a/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/es.md b/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/es.md index b3078f149..446b6c4b2 100644 --- a/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/es.md +++ b/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/es.md @@ -1,31 +1,29 @@ # ByteDance Imagen a Video -# Nodo ByteDance: Imagen a Vídeo - -El nodo ByteDance: Imagen a Vídeo genera un vídeo a partir de una imagen de entrada y un texto de sugerencia utilizando la API de ByteDance. Crea una secuencia de vídeo que visualmente representa la descripción proporcionada, con opciones para personalizar la resolución, el aspecto, la duración y otros parámetros de la salida. +El nodo ByteDance Image to Video genera videos utilizando modelos ByteDance a través de una API a partir de una imagen de entrada y un prompt de texto. Toma un primer fotograma de inicio y crea una secuencia de video que sigue la descripción proporcionada. El nodo ofrece diversas opciones de personalización para la resolución del video, la relación de aspecto, la duración y otros parámetros de generación. ## Entradas -| Parámetro | Descripción | Tipo de Datos | Obligatorio | Rango | +| Parámetro | Descripción | Tipo de dato | Requerido | Rango | |-----------|-------------|-----------|----------|-------| -| `modelo` | El modelo ByteDance a utilizar para la generación de vídeo. Las opciones disponibles son:
`"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | STRING | Sí | Como se lista arriba | -| `prompt` | El texto de sugerencia utilizado para generar el vídeo. Debe tener al menos 1 carácter después de quitar los espacios en blanco. | STRING | Sí | - | -| `imagen` | La primera imagen a ser utilizada para el vídeo. La imagen debe estar entre 300x300 y 6000x6000 píxeles, con un aspecto entre 0.4 y 2.5. | IMAGE | Sí | - | -| `resolución` | La resolución del vídeo de salida. Las opciones disponibles son:
`"480p"`
`"720p"`
`"1080p"` | STRING | Sí | Como se lista arriba | -| `relación_de_aspecto` | El aspecto del vídeo de salida. Las opciones disponibles son:
`"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | STRING | Sí | Como se lista arriba | -| `duración` | La duración del vídeo de salida en segundos. Para el modelo `seedance-1-5-pro-251215`, la duración mínima soportada es de 4 segundos. | INT | Sí | 3 - 12 | -| `semilla` | Semilla a utilizar para la generación. Opcional, con un valor predeterminado de 0. | INT | No | 0 - 2147483647 | -| `cámara_fija` | Especifica si se debe fijar la cámara. La plataforma adjunta una instrucción para fijar la cámara a su sugerencia, pero no garantiza el efecto real. Opcional, con un valor predeterminado de Falso. | BOOLEAN | No | - | -| `marca_de_agua` | Si se debe agregar una marca de agua "Generado por IA" al vídeo. Opcional, con un valor predeterminado de Falso. | BOOLEAN | No | - | -| `generate_audio` | Este parámetro se ignora para cualquier modelo excepto `seedance-1-5-pro-251215`. Opcional, con un valor predeterminado de Falso. | BOOLEAN | No | - | - -**Nota:** El texto de sugerencia no debe contener las siguientes palabras (sin distinción de mayúsculas y minúsculas): `resolution`, `ratio`, `duration`, `seed`, `camerafixed`, `watermark`. Estos parámetros se configuran a través de sus entradas dedicadas. +| `modelo` | El modelo ByteDance a usar para la generación de video (predeterminado: `"seedance-1-0-pro-fast-251015"`). | COMBO | Sí | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | +| `prompt` | El prompt de texto utilizado para generar el video. Debe tener al menos 1 carácter después de recortar los espacios en blanco. | STRING | Sí | - | +| `imagen` | Primer fotograma que se usará para el video. Debe estar entre 300x300 y 6000x6000 píxeles, con una relación de aspecto entre 0.4 y 2.5. | IMAGE | Sí | - | +| `resolución` | La resolución del video de salida. | COMBO | Sí | `"480p"`
`"720p"`
`"1080p"` | +| `relación_de_aspecto` | La relación de aspecto del video de salida. | COMBO | Sí | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `duración` | La duración del video de salida en segundos (predeterminado: 5). Para el modelo `seedance-1-5-pro-251215`, la duración mínima admitida es de 4 segundos. | INT | Sí | 3 - 12 | +| `semilla` | Semilla a usar para la generación (predeterminado: 0). | INT | No | 0 - 2147483647 | +| `cámara_fija` | Especifica si se debe fijar la cámara. La plataforma añade una instrucción para fijar la cámara a tu prompt, pero no garantiza el efecto real (predeterminado: False). | BOOLEAN | No | `False`
`True` | +| `marca_de_agua` | Si se debe añadir una marca de agua "AI generated" al video (predeterminado: False). | BOOLEAN | No | `False`
`True` | +| `generate_audio` | Este parámetro se ignora para cualquier modelo excepto `seedance-1-5-pro-251215` (predeterminado: False). | BOOLEAN | No | `False`
`True` | + +**Nota:** El prompt no debe contener las siguientes palabras (sin distinción de mayúsculas y minúsculas): `resolution`, `ratio`, `duration`, `seed`, `camerafixed`, `watermark`. Estos parámetros se configuran mediante sus entradas dedicadas. ## Salidas -| Nombre de Salida | Descripción | Tipo de Datos | +| Nombre de salida | Descripción | Tipo de dato | |-------------|-------------|-----------| -| `output` | El archivo de vídeo generado basado en los parámetros de imagen de entrada y sugerencia. | VIDEO | +| `output` | El archivo de video generado a partir de la imagen de entrada y los parámetros del prompt. | 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/ByteDanceImageToVideoNode/es.md) diff --git a/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/fa.md b/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/fa.md index dddd5571c..026c4b6bd 100644 --- a/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/fa.md +++ b/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/fa.md @@ -1,29 +1,29 @@ # تبدیل تصویر به ویدیو ByteDance -گره تصویر به ویدیو ByteDance ویدیویی از یک تصویر ورودی و یک پیام متنی با استفاده از API ByteDance تولید می‌کند. این گره یک توالی ویدیویی ایجاد می‌کند که به صورت تصویری توضیحات ارائه شده را نمایش می‌دهد، با امکانات شخصی‌سازی رزولوشن، نسبت ابعاد، مدت زمان و پارامترهای دیگر خروجی. +گره ByteDance Image to Video ویدئوهایی را با استفاده از مدل‌های ByteDance از طریق یک API و بر اساس تصویر ورودی و پرامپت متنی تولید می‌کند. این گره یک فریم تصویر آغازین را می‌گیرد و یک دنباله ویدئویی مطابق با توضیحات ارائه‌شده ایجاد می‌کند. این گره گزینه‌های سفارشی‌سازی متنوعی برای رزولوشن ویدئو، نسبت ابعاد، مدت‌زمان و سایر پارامترهای تولید ارائه می‌دهد. ## ورودی‌ها -| پارامتر | توضیح | نوع داده | الزامی | محدوده | +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | |-----------|-------------|-----------|----------|-------| -| `مدل` | مدل ByteDance برای تولید ویدیو. گزینه‌های موجود عبارتند از:
`"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | STRING | بله | همان‌گونه که در بالا لیست شده‌اند | -| `پرامپت` | پیام متنی استفاده شده برای تولید ویدیو. باید حداقل 1 کاراکتر باشد پس از حذف فضاهای خالی. | STRING | بله | - | -| `تصویر` | فریم اول که برای ویدیو استفاده می‌شود. تصویر باید بین 300x300 و 6000x6000 پیکسل باشد و نسبت ابعاد بین 0.4 و 2.5 داشته باشد. | IMAGE | بله | - | -| `رزولوشن` | رزولوشن ویدیوی خروجی. گزینه‌های موجود عبارتند از:
`"480p"`
`"720p"`
`"1080p"` | STRING | بله | همان‌گونه که در بالا لیست شده‌اند | -| `نسبت تصویر` | نسبت ابعاد ویدیوی خروجی. گزینه‌های موجود عبارتند از:
`"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | STRING | بله | همان‌گونه که در بالا لیست شده‌اند | -| `مدت زمان` | مدت زمان ویدیوی خروجی به ثانیه. برای مدل `seedance-1-5-pro-251215`، مدت زمان پشتیبانی شده حداقل 4 ثانیه است. | INT | بله | 3 - 12 | -| `seed` | عدد اول برای تولید. با مقدار پیش‌فرض 0. | INT | خیر | 0 - 2147483647 | -| `ثابت بودن دوربین` | مشخص می‌کند که آیا دوربین را ثابت نگه داریم یا خیر. پلتفرم دستوری برای ثابت نگه داشتن دوربین به پیام شما اضافه می‌کند، اما تضمین نمی‌کند که تأثیر واقعی. با مقدار پیش‌فرض False. | BOOLEAN | خیر | - | -| `واترمارک` | مشخص می‌کند که آیا باید علامت "تولید شده توسط AI" به ویدیو اضافه شود یا خیر. با مقدار پیش‌فرض False. | BOOLEAN | خیر | - | -| `تولید صدا` | این پارامتر برای هر مدل به جز `seedance-1-5-pro-251215` نادیده گرفته می‌شود. با مقدار پیش‌فرض False. | BOOLEAN | خیر | - | - -**توجه:** پیام نباید شامل کلمات زیر (حساس به حروف بزرگ): `resolution`، `ratio`، `duration`، `seed`، `camerafixed`، `watermark`. این پارامترها از طریق ورودی‌های اختصاصی خود تنظیم می‌شوند. +| `مدل` | مدل ByteDance برای تولید ویدئو (پیش‌فرض: `"seedance-1-0-pro-fast-251015"`). | COMBO | بله | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | +| `پرامپت` | پرامپت متنی برای تولید ویدئو. باید پس از حذف فاصله‌های اضافی حداقل 1 کاراکتر باشد. | STRING | بله | - | +| `تصویر` | فریم اول مورد استفاده برای ویدئو. باید بین 300x300 و 6000x6000 پیکسل باشد و نسبت ابعاد آن بین 0.4 و 2.5 قرار گیرد. | IMAGE | بله | - | +| `رزولوشن` | رزولوشن ویدئوی خروجی. | COMBO | بله | `"480p"`
`"720p"`
`"1080p"` | +| `نسبت تصویر` | نسبت ابعاد ویدئوی خروجی. | COMBO | بله | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `مدت زمان` | مدت‌زمان ویدئوی خروجی بر حسب ثانیه (پیش‌فرض: 5). برای مدل `seedance-1-5-pro-251215`، حداقل مدت‌زمان پشتیبانی‌شده 4 ثانیه است. | INT | بله | 3 - 12 | +| `seed` | مقدار seed برای تولید (پیش‌فرض: 0). | INT | خیر | 0 - 2147483647 | +| `ثابت بودن دوربین` | مشخص می‌کند آیا دوربین ثابت بماند یا نه. پلتفرم یک دستور برای ثابت کردن دوربین به پرامپت شما اضافه می‌کند، اما اثر واقعی را تضمین نمی‌کند (پیش‌فرض: False). | BOOLEAN | خیر | `False`
`True` | +| `واترمارک` | آیا واترمارک «AI generated» به ویدئو اضافه شود (پیش‌فرض: False). | BOOLEAN | خیر | `False`
`True` | +| `تولید صدا` | این پارامتر برای همه مدل‌ها به‌جز `seedance-1-5-pro-251215` نادیده گرفته می‌شود (پیش‌فرض: False). | BOOLEAN | خیر | `False`
`True` | + +**توجه:** پرامپت نباید شامل واژه‌های زیر باشد (بدون حساسیت به بزرگی و کوچکی حروف): `resolution`، `ratio`، `duration`، `seed`، `camerafixed`، `watermark`. این پارامترها از طریق ورودی‌های اختصاصی خود تنظیم می‌شوند. ## خروجی‌ها -| نام خروجی | توضیح | نوع داده | +| نام خروجی | توضیحات | نوع داده | |-------------|-------------|-----------| -| `output` | ویدیوی تولید شده بر اساس پارامترهای ورودی تصویر و پیام. | VIDEO | +| `output` | فایل ویدئوی تولیدشده بر اساس تصویر ورودی و پارامترهای پرامپت. | VIDEO | > این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/fa.md) diff --git a/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/fr.md b/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/fr.md index c9208e8b1..7be5f8c5b 100644 --- a/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/fr.md +++ b/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/fr.md @@ -1,31 +1,29 @@ # ByteDance Image en vidéo -# Nœud Image à Vidéo de ByteDance - -Le nœud Image à Vidéo de ByteDance génère une vidéo à partir d'une image d'entrée et d'un texte d'indication en utilisant l'API de ByteDance. Il crée une séquence vidéo qui représente visuellement la description fournie, avec des options pour personnaliser la résolution, le rapport d'aspect, la durée et d'autres paramètres de la sortie. +Le nœud ByteDance Image to Video génère des vidéos à l'aide des modèles ByteDance via une API à partir d'une image d'entrée et d'une invite textuelle. Il prend une image initiale comme première image et crée une séquence vidéo qui suit la description fournie. Le nœud offre diverses options de personnalisation pour la résolution vidéo, le format d'image, la durée et d'autres paramètres de génération. ## Entrées -| Paramètre | Description | Type de données | Obligatoire | Gamme | +| Paramètre | Description | Type de données | Requis | Plage | |-----------|-------------|-----------|----------|-------| -| `modèle` | Le modèle ByteDance à utiliser pour la génération de vidéo. Les options disponibles sont :
`"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | STRING | Oui | Comme listé ci-dessus | -| `prompt` | Le texte d'indication utilisé pour générer la vidéo. Doit contenir au moins 1 caractère après l'élimination des espaces. | STRING | Oui | - | -| `image` | La première image à utiliser pour la vidéo. L'image doit être entre 300x300 et 6000x6000 pixels, avec un rapport d'aspect entre 0,4 et 2,5. | IMAGE | Oui | - | -| `résolution` | La résolution de la vidéo de sortie. Les options disponibles sont :
`"480p"`
`"720p"`
`"1080p"` | STRING | Oui | Comme listé ci-dessus | -| `ratio_d'aspect` | Le rapport d'aspect de la vidéo de sortie. Les options disponibles sont :
`"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | STRING | Oui | Comme listé ci-dessus | -| `durée` | La durée de la vidéo de sortie en secondes. Pour le modèle `seedance-1-5-pro-251215`, la durée minimale supportée est de 4 secondes. | INT | Oui | 3 - 12 | -| `graine` | Grain à utiliser pour la génération. Optionnel, avec une valeur par défaut de 0. | INT | Non | 0 - 2147483647 | -| `caméra_fixe` | Spécifie si la caméra doit être fixée. La plateforme ajoute une instruction pour fixer la caméra à votre indication, mais ne garantit pas l'effet réel. Optionnel, avec une valeur par défaut de False. | BOOLEAN | Non | - | -| `filigrane` | Si ajouter une marque d'eau "Généré par l'IA" à la vidéo. Optionnel, avec une valeur par défaut de False. | BOOLEAN | Non | - | -| `générer_audio` | Ce paramètre est ignoré pour tout modèle sauf `seedance-1-5-pro-251215`. Optionnel, avec une valeur par défaut de False. | BOOLEAN | Non | - | - -**Note :** L'indication ne doit pas contenir les mots suivants (sensibilité aux majuscules et minuscules) : `resolution`, `ratio`, `duration`, `seed`, `camerafixed`, `watermark`. Ces paramètres sont définis via leurs entrées dédiées. +| `modèle` | Le modèle ByteDance à utiliser pour la génération vidéo (par défaut : `"seedance-1-0-pro-fast-251015"`). | COMBO | Oui | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | +| `prompt` | L'invite textuelle utilisée pour générer la vidéo. Doit contenir au moins 1 caractère après suppression des espaces. | STRING | Oui | - | +| `image` | Première image à utiliser pour la vidéo. Doit être comprise entre 300x300 et 6000x6000 pixels, avec un rapport hauteur/largeur entre 0.4 et 2.5. | IMAGE | Oui | - | +| `résolution` | La résolution de la vidéo de sortie. | COMBO | Oui | `"480p"`
`"720p"`
`"1080p"` | +| `ratio_d'aspect` | Le rapport hauteur/largeur de la vidéo de sortie. | COMBO | Oui | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `durée` | La durée de la vidéo de sortie en secondes (par défaut : 5). Pour le modèle `seedance-1-5-pro-251215`, la durée minimale prise en charge est de 4 secondes. | INT | Oui | 3 - 12 | +| `graine` | Graine à utiliser pour la génération (par défaut : 0). | INT | Non | 0 - 2147483647 | +| `caméra_fixe` | Spécifie si la caméra doit être fixe. La plateforme ajoute une instruction de fixation de la caméra à votre invite, mais ne garantit pas l'effet réel (par défaut : False). | BOOLEAN | Non | `False`
`True` | +| `filigrane` | Indique s'il faut ajouter un filigrane « généré par IA » à la vidéo (par défaut : False). | BOOLEAN | Non | `False`
`True` | +| `générer_audio` | Ce paramètre est ignoré pour tous les modèles sauf `seedance-1-5-pro-251215` (par défaut : False). | BOOLEAN | Non | `False`
`True` | + +**Remarque :** L'invite ne doit pas contenir les mots suivants (insensibles à la casse) : `resolution`, `ratio`, `duration`, `seed`, `camerafixed`, `watermark`. Ces paramètres sont définis via leurs entrées dédiées. ## Sorties -| Nom de la sortie | Description | Type de données | +| Nom de sortie | Description | Type de données | |-------------|-------------|-----------| -| `output` | Le fichier vidéo généré sur la base de l'image d'entrée et des paramètres de l'indication. | VIDEO | +| `output` | Le fichier vidéo généré à partir de l'image d'entrée et des paramètres de l'invite. | 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/ByteDanceImageToVideoNode/fr.md) diff --git a/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/ja.md b/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/ja.md index 2653db522..1d276babd 100644 --- a/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/ja.md +++ b/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/ja.md @@ -1,29 +1,29 @@ # ByteDance Image to Video -ByteDance Image to Video ノードは、入力画像とテキストプロンプトを使用してByteDanceのAPIを利用してビデオを生成します。提供された説明を視覚的に表現するビデオシークエンスを作成し、出力の解像度、アスペクト比、長さ、その他のパラメータをカスタマイズするオプションがあります。 +ByteDance Image to Video ノードは、入力画像とテキストプロンプトに基づいて、API 経由で ByteDance モデルを使用して動画を生成します。開始フレームとなる画像を受け取り、指定された説明に従った動画シーケンスを作成します。このノードは、動画の解像度、アスペクト比、長さ、その他の生成パラメータに関するさまざまなカスタマイズオプションを提供します。 ## 入力 -| パラメータ | 説明 | データ型 | 必須 | 范囲 | -|------------|------|----------|------|-------| -| `model` | ビデオ生成に使用するByteDanceのモデルです。利用可能なオプションは:
`"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | STRING | はい | 上記に記載の通り | -| `prompt` | ビデオ生成に使用するテキストプロンプトです。スペースを削除した後でも少なくとも1文字以上である必要があります。 | STRING | はい | - | -| `image` | ビデオの最初のフレームとして使用される画像です。画像は300x300から6000x6000ピクセルの間で、アスペクト比は0.4から2.5の間でなければなりません。 | IMAGE | はい | - | -| `resolution` | 出力ビデオの解像度です。利用可能なオプションは:
`"480p"`
`"720p"`
`"1080p"` | STRING | はい | 上記に記載の通り | -| `aspect_ratio` | 出力ビデオのアスペクト比です。利用可能なオプションは:
`"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | STRING | はい | 上記に記載の通り | -| `duration` | 出力ビデオの長さ(秒)です。`seedance-1-5-pro-251215`モデルの場合、サポートされる最小長さは4秒です。 | INT | はい | 3 - 12 | -| `seed` | 生成に使用するシードです。オプションで、デフォルト値は0です。 | INT | いいえ | 0 - 2147483647 | -| `camera_fixed` | カメラを固定するかどうかを指定します。プラットフォームはプロンプトにカメラを固定する指示を追加しますが、実際の効果を保証しません。オプションで、デフォルト値はFalseです。 | BOOLEAN | いいえ | - | -| `watermark` | ビデオに「AI生成」というウォーターマークを追加するかどうかを指定します。オプションで、デフォルト値はFalseです。 | BOOLEAN | いいえ | - | -| `generate_audio` | このパラメータは`seedance-1-5-pro-251215`以外のモデルでは無視されます。オプションで、デフォルト値はFalseです。 | BOOLEAN | いいえ | - | - -**注意:** プロンプトには以下の単語(大文字小文字を区別しない)を含めないでください:`resolution`、`ratio`、`duration`、`seed`、`camerafixed`、`watermark`。これらのパラメータは専用の入力で設定されます。 +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `model` | 動画の生成に使用する ByteDance モデルを指定します(デフォルト: `"seedance-1-0-pro-fast-251015"`)。 | COMBO | はい | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | +| `prompt` | 動画の生成に使用するテキストプロンプトを指定します。空白を除去した後、少なくとも 1 文字以上である必要があります。 | STRING | はい | - | +| `image` | 動画の最初のフレームとして使用する画像を指定します。300x300 ピクセル以上、6000x6000 ピクセル以下で、アスペクト比が 0.4 から 2.5 の間である必要があります。 | IMAGE | はい | - | +| `resolution` | 出力動画の解像度を指定します。 | COMBO | はい | `"480p"`
`"720p"`
`"1080p"` | +| `aspect_ratio` | 出力動画のアスペクト比を指定します。 | COMBO | はい | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `duration` | 出力動画の長さを秒単位で指定します(デフォルト: 5)。`seedance-1-5-pro-251215` モデルの場合、サポートされる最小の長さは 4 秒です。 | INT | はい | 3 - 12 | +| `seed` | 生成に使用するシード値を指定します(デフォルト: 0)。 | INT | いいえ | 0 - 2147483647 | +| `camera_fixed` | カメラを固定するかどうかを指定します。プラットフォームは、プロンプトにカメラを固定する指示を追加しますが、実際の効果は保証されません(デフォルト: False)。 | BOOLEAN | いいえ | `False`
`True` | +| `watermark` | 動画に「AI generated」ウォーターマークを追加するかどうかを指定します(デフォルト: False)。 | BOOLEAN | いいえ | `False`
`True` | +| `generate_audio` | このパラメータは、`seedance-1-5-pro-251215` 以外のモデルでは無視されます(デフォルト: False)。 | BOOLEAN | いいえ | `False`
`True` | + +**注記:** プロンプトに以下の単語を含めることはできません(大文字・小文字は区別されません): `resolution`、`ratio`、`duration`、`seed`、`camerafixed`、`watermark`。これらのパラメータは専用の入力フィールドで設定されます。 ## 出力 | 出力名 | 説明 | データ型 | -|--------|------|----------| -| `output` | 入力画像とプロンプトパラメータに基づいて生成されたビデオファイルです。 | VIDEO | +|-------------|-------------|-----------| +| `output` | 入力画像とプロンプトパラメータに基づいて生成された動画ファイル。 | VIDEO | > このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/ja.md) diff --git a/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/ko.md b/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/ko.md index fc0527d72..d7e8a927b 100644 --- a/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/ko.md +++ b/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/ko.md @@ -1,29 +1,29 @@ # ByteDance 이미지 투 비디오 -ByteDance 이미지에서 비디오로 변환 노드는 ByteDance의 API를 사용하여 입력 이미지와 텍스트 프롬프트로 비디오를 생성합니다. 제공된 설명을 시각적으로 표현하는 비디오 시퀀스를 생성하며, 출력의 해상도, 비율, 지속 시간 및 다른 매개변수를 사용자 정의할 수 있습니다. +ByteDance Image to Video 노드는 API를 통해 ByteDance 모델을 사용하여 입력 이미지와 텍스트 프롬프트를 기반으로 비디오를 생성합니다. 시작 이미지 프레임을 받아 제공된 설명을 따르는 비디오 시퀀스를 생성합니다. 이 노드는 비디오 해상도, 종횡비, 길이 및 기타 생성 매개변수에 대한 다양한 사용자 지정 옵션을 제공합니다. ## 입력 -| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +| 매개변수 | 설명 | 데이터 타입 | 필수 여부 | 범위 | |-----------|-------------|-----------|----------|-------| -| `모델` | 비디오 생성에 사용할 ByteDance 모델입니다. 사용 가능한 옵션은 다음과 같습니다:
`"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | STRING | 예 | 위에 나열된 것과 같습니다 | -| `프롬프트` | 비디오 생성에 사용할 텍스트 프롬프트입니다. 공백을 제거한 후 최소 1자리 이상이어야 합니다. | STRING | 예 | - | -| `이미지` | 비디오에 사용될 첫 번째 프레임입니다. 이미지는 300x300에서 6000x6000 픽셀 사이이며, 비율은 0.4에서 2.5 사이여야 합니다. | IMAGE | 예 | - | -| `해상도` | 출력 비디오의 해상도입니다. 사용 가능한 옵션은 다음과 같습니다:
`"480p"`
`"720p"`
`"1080p"` | STRING | 예 | 위에 나열된 것과 같습니다 | -| `화면비율` | 출력 비디오의 비율입니다. 사용 가능한 옵션은 다음과 같습니다:
`"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | STRING | 예 | 위에 나열된 것과 같습니다 | -| `지속 시간` | 출력 비디오의 지속 시간(초)입니다. `seedance-1-5-pro-251215` 모델의 경우 최소 지원 시간은 4초입니다. | INT | 예 | 3 - 12 | -| `시드` | 생성에 사용할 시드입니다. 기본 값은 0입니다. | INT | 아님 | 0 - 2147483647 | -| `카메라 고정` | 카메라를 고정할지 여부를 지정합니다. 플랫폼은 프롬프트에 카메라 고정 명령을 추가하지만, 실제 효과를 보장하지 않습니다. 기본 값은 False입니다. | BOOLEAN | 아님 | - | -| `워터마크` | 비디오에 "AI generated" 워터마크를 추가할지 여부입니다. 기본 값은 False입니다. | BOOLEAN | 아님 | - | -| `generate_audio` | 이 매개변수는 `seedance-1-5-pro-251215` 모델 외의 모델에서 무시됩니다. 기본 값은 False입니다. | BOOLEAN | 아님 | - | - -**주의:** 프롬프트에는 다음 단어(대소문자 구분 없이)가 포함되지 않아야 합니다: `resolution`, `ratio`, `duration`, `seed`, `camerafixed`, `watermark`. 이 매개변수는 그 전용 입력을 통해 설정됩니다. +| `모델` | 비디오 생성에 사용할 ByteDance 모델입니다(기본값: `"seedance-1-0-pro-fast-251015"`). | COMBO | 예 | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | +| `프롬프트` | 비디오 생성에 사용할 텍스트 프롬프트입니다. 앞뒤 공백을 제거한 후 최소 1자 이상이어야 합니다. | STRING | 예 | - | +| `이미지` | 비디오의 첫 번째 프레임으로 사용할 이미지입니다. 300x300 ~ 6000x6000 픽셀 사이이며, 종횡비는 0.4 ~ 2.5 사이여야 합니다. | IMAGE | 예 | - | +| `해상도` | 출력 비디오의 해상도입니다. | COMBO | 예 | `"480p"`
`"720p"`
`"1080p"` | +| `화면비율` | 출력 비디오의 종횡비입니다. | COMBO | 예 | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `지속 시간` | 출력 비디오의 길이(초)입니다(기본값: 5). `seedance-1-5-pro-251215` 모델의 경우 지원되는 최소 길이는 4초입니다. | INT | 예 | 3 - 12 | +| `시드` | 생성에 사용할 시드입니다(기본값: 0). | INT | 아니요 | 0 - 2147483647 | +| `카메라 고정` | 카메라 고정 여부를 지정합니다. 플랫폼에서 카메라를 고정하는 지시문을 프롬프트에 추가하지만 실제 효과는 보장하지 않습니다(기본값: False). | BOOLEAN | 아니요 | `False`
`True` | +| `워터마크` | 비디오에 "AI 생성" 워터마크를 추가할지 여부입니다(기본값: False). | BOOLEAN | 아니요 | `False`
`True` | +| `generate_audio` | 이 매개변수는 `seedance-1-5-pro-251215`를 제외한 모든 모델에서는 무시됩니다(기본값: False). | BOOLEAN | 아니요 | `False`
`True` | + +**참고:** 프롬프트에는 다음 단어가 포함되어서는 안 됩니다(대소문자 구분 없음): `resolution`, `ratio`, `duration`, `seed`, `camerafixed`, `watermark`. 이러한 매개변수는 전용 입력을 통해 설정됩니다. ## 출력 | 출력 이름 | 설명 | 데이터 타입 | |-------------|-------------|-----------| -| `output` | 입력 이미지와 프롬프트 매개변수에 기반한 생성된 비디오 파일입니다. | VIDEO | +| `output` | 입력 이미지와 프롬프트 매개변수를 기반으로 생성된 비디오 파일입니다. | VIDEO | > 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/ko.md) diff --git a/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/pt-BR.md b/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/pt-BR.md index a6904e9bd..4d117259e 100644 --- a/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/pt-BR.md +++ b/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/pt-BR.md @@ -1,25 +1,23 @@ # Imagem para Vídeo ByteDance -# Nó ByteDance Image to Video - -O nó ByteDance Image to Video gera um vídeo a partir de uma imagem de entrada e um prompt de texto usando a API da ByteDance. Ele cria uma sequência de vídeo que visualmente representa a descrição fornecida, com opções para personalizar a resolução, proporção de aspecto, duração e outros parâmetros de saída. +O nó ByteDance Image to Video gera vídeos usando modelos ByteDance por meio de uma API com base em uma imagem de entrada e um prompt de texto. Ele utiliza um quadro inicial da imagem e cria uma sequência de vídeo que segue a descrição fornecida. O nó oferece várias opções de personalização para resolução do vídeo, proporção de aspecto, duração e outros parâmetros de geração. ## Entradas | Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | |-----------|-------------|-----------|----------|-------| -| `modelo` | O modelo ByteDance a ser usado para a geração de vídeo. As opções disponíveis são:
`"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | STRING | Sim | Como listado acima | -| `prompt` | O prompt de texto usado para gerar o vídeo. Deve ter pelo menos 1 caractere após a remoção de espaços em branco. | STRING | Sim | - | -| `imagem` | A primeira imagem a ser usada para o vídeo. A imagem deve ter entre 300x300 e 6000x6000 pixels, com uma proporção de aspecto entre 0,4 e 2,5. | IMAGE | Sim | - | -| `resolução` | A resolução do vídeo de saída. As opções disponíveis são:
`"480p"`
`"720p"`
`"1080p"` | STRING | Sim | Como listado acima | -| `proporção` | A proporção de aspecto do vídeo de saída. As opções disponíveis são:
`"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | STRING | Sim | Como listado acima | -| `duração` | A duração do vídeo de saída em segundos. Para o modelo `seedance-1-5-pro-251215`, a duração mínima suportada é 4 segundos. | INT | Sim | 3 - 12 | -| `semente` | Semente a ser usada para a geração. Opcional, com valor padrão 0. | INT | Não | 0 - 2147483647 | -| `câmera fixa` | Especifica se deve fixar a câmera. A plataforma anexa uma instrução para fixar a câmera ao seu prompt, mas não garante o efeito real. Opcional, com valor padrão False. | BOOLEAN | Não | - | -| `marca d'água` | Se deve adicionar uma marca d'água "AI generated" ao vídeo. Opcional, com valor padrão False. | BOOLEAN | Não | - | -| `generate_audio` | Este parâmetro é ignorado para qualquer modelo exceto `seedance-1-5-pro-251215`. Opcional, com valor padrão False. | BOOLEAN | Não | - | - -**Nota:** O prompt não deve conter as seguintes palavras (sem distinção de maiúsculas e minúsculas): `resolution`, `ratio`, `duration`, `seed`, `camerafixed`, `watermark`. Esses parâmetros são configurados via suas entradas dedicadas. +| `modelo` | O modelo ByteDance a ser usado para geração de vídeo (padrão: `"seedance-1-0-pro-fast-251015"`). | COMBO | Sim | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | +| `prompt` | O prompt de texto usado para gerar o vídeo. Deve ter pelo menos 1 caractere após a remoção de espaços em branco nas extremidades. | STRING | Sim | - | +| `imagem` | Primeiro quadro a ser usado para o vídeo. Deve ter entre 300x300 e 6000x6000 pixels, com proporção de aspecto entre 0,4 e 2,5. | IMAGE | Sim | - | +| `resolução` | A resolução do vídeo de saída. | COMBO | Sim | `"480p"`
`"720p"`
`"1080p"` | +| `proporção` | A proporção de aspecto do vídeo de saída. | COMBO | Sim | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `duração` | A duração do vídeo de saída em segundos (padrão: 5). Para o modelo `seedance-1-5-pro-251215`, a duração mínima suportada é de 4 segundos. | INT | Sim | 3 - 12 | +| `semente` | Semente a ser usada para a geração (padrão: 0). | INT | Não | 0 - 2147483647 | +| `câmera fixa` | Especifica se a câmera deve ser fixada. A plataforma acrescenta uma instrução para fixar a câmera ao seu prompt, mas não garante o efeito real (padrão: False). | BOOLEAN | Não | `False`
`True` | +| `marca d'água` | Se deve adicionar uma marca d'água "gerado por IA" ao vídeo (padrão: False). | BOOLEAN | Não | `False`
`True` | +| `generate_audio` | Este parâmetro é ignorado para qualquer modelo, exceto `seedance-1-5-pro-251215` (padrão: False). | BOOLEAN | Não | `False`
`True` | + +**Nota:** o prompt não deve conter as seguintes palavras (sem diferenciar maiúsculas de minúsculas): `resolution`, `ratio`, `duration`, `seed`, `camerafixed`, `watermark`. Esses parâmetros são definidos por meio de suas entradas dedicadas. ## Saídas diff --git a/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/ru.md b/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/ru.md index c5210bc4e..038715498 100644 --- a/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/ru.md +++ b/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/ru.md @@ -1,31 +1,29 @@ # ByteDance Image to Video -# Узел ByteDance Image to Video - -Узел ByteDance Image to Video генерирует видео из входного изображения и текстового запроса с использованием API компании ByteDance. Он создает видеоряд, который визуально представляет предоставленную описание, с возможностью настроить разрешение, формат экрана, продолжительность и другие параметры вывода. +Узел ByteDance Image to Video генерирует видео с использованием моделей ByteDance через API на основе входного изображения и текстового запроса. Он принимает начальный кадр изображения и создает видеопоследовательность, соответствующую указанному описанию. Узел предоставляет различные параметры настройки разрешения видео, соотношения сторон, длительности и других параметров генерации. ## Входы -| Параметр | Описание | Тип данных | Обязателен | Диапазон | +| Параметр | Описание | Тип данных | Обязательный | Диапазон | |-----------|-------------|-----------|----------|-------| -| `model` | ByteDance модель для использования при генерации видео. Доступные опции:
`"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | STRING | Да | Как указано выше | -| `prompt` | Текстовый запрос для генерации видео. Длина запроса после удаления пробелов должна быть не менее 1 символа. | STRING | Да | - | -| `image` | Первый кадр, который будет использоваться для видео. Изображение должно быть между 300x300 и 6000x6000 пикселей, с соотношением сторон между 0.4 и 2.5. | IMAGE | Да | - | -| `resolution` | Разрешение выводного видео. Доступные опции:
`"480p"`
`"720p"`
`"1080p"` | STRING | Да | Как указано выше | -| `aspect_ratio` | Соотношение сторон выводного видео. Доступные опции:
`"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | STRING | Да | Как указано выше | -| `duration` | Продолжительность выводного видео в секундах. Для модели `seedance-1-5-pro-251215` минимальная поддерживаемая продолжительность составляет 4 секунды. | INT | Да | 3 - 12 | -| `seed` | Зародыш для использования при генерации. Опционален, значение по умолчанию 0. | INT | Нет | 0 - 2147483647 | -| `camera_fixed` | Указывает, следует ли фиксировать камеру. Платформа добавляет инструкцию для фиксации камеры к вашему запросу, но не гарантирует реальный эффект. Опционален, значение по умолчанию False. | BOOLEAN | Нет | - | -| `watermark` | Указывает, следует ли добавлять водяной знак "AI generated" к видео. Опционален, значение по умолчанию False. | BOOLEAN | Нет | - | -| `generate_audio` | Этот параметр игнорируется для всех моделей, кроме `seedance-1-5-pro-251215`. Опционален, значение по умолчанию False. | BOOLEAN | Нет | - | - -**Примечание:** Запрос не должен содержать следующих слов (без учета регистра): `resolution`, `ratio`, `duration`, `seed`, `camerafixed`, `watermark`. Эти параметры устанавливаются через их отдельные входы. +| `model` | Модель ByteDance, используемая для генерации видео (по умолчанию: `"seedance-1-0-pro-fast-251015"`). | COMBO | Да | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | +| `prompt` | Текстовый запрос, используемый для генерации видео. Должен содержать не менее 1 символа после удаления пробелов. | STRING | Да | - | +| `image` | Первый кадр для видео. Размер должен быть от 300x300 до 6000x6000 пикселей, соотношение сторон — от 0.4 до 2.5. | IMAGE | Да | - | +| `resolution` | Разрешение выходного видео. | COMBO | Да | `"480p"`
`"720p"`
`"1080p"` | +| `aspect_ratio` | Соотношение сторон выходного видео. | COMBO | Да | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `duration` | Длительность выходного видео в секундах (по умолчанию: 5). Для модели `seedance-1-5-pro-251215` минимальная поддерживаемая длительность — 4 секунды. | INT | Да | 3 - 12 | +| `seed` | Зерно (seed) для генерации (по умолчанию: 0). | INT | Нет | 0 - 2147483647 | +| `camera_fixed` | Указывает, следует ли зафиксировать камеру. Платформа добавляет инструкцию зафиксировать камеру к вашему запросу, но не гарантирует фактический результат (по умолчанию: False). | BOOLEAN | Нет | `False`
`True` | +| `watermark` | Добавлять ли водяной знак "AI generated" на видео (по умолчанию: False). | BOOLEAN | Нет | `False`
`True` | +| `generate_audio` | Этот параметр игнорируется для всех моделей, кроме `seedance-1-5-pro-251215` (по умолчанию: False). | BOOLEAN | Нет | `False`
`True` | + +**Примечание:** Запрос не должен содержать следующие слова (без учета регистра): `resolution`, `ratio`, `duration`, `seed`, `camerafixed`, `watermark`. Эти параметры задаются через соответствующие отдельные входы. ## Выходы -| Название выхода | Описание | Тип данных | +| Имя выхода | Описание | Тип данных | |-------------|-------------|-----------| -| `output` | Генерируемый видео файл на основе входного изображения и параметров запроса. | VIDEO | +| `output` | Сгенерированный видеофайл на основе входного изображения и параметров запроса. | VIDEO | > Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/ru.md) diff --git a/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/tr.md b/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/tr.md index d1501876e..f9b65b25e 100644 --- a/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/tr.md +++ b/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/tr.md @@ -1,29 +1,29 @@ # ByteDance Görüntüden Videoya -ByteDance Görüntüden Video düğümü, girdi görsel ve metin prompt kullanarak ByteDance'nin API'si ile video oluşturur. Sunulan açıklamayı görsel olarak temsil eden bir video sırası oluşturur. Çıktının çözünürlüğü, en boy oranı, süresi ve diğer parametreleri özelleştirmek için seçenekler sunar. +ByteDance Image to Video düğümü; bir girdi görüntüsü ve metin istemine dayalı olarak, ByteDance modellerini bir API aracılığıyla kullanarak videolar üretir. Bir başlangıç görüntü karesi alır ve sağlanan açıklamayı izleyen bir video dizisi oluşturur. Düğüm; video çözünürlüğü, en-boy oranı, süre ve diğer üretim parametreleri için çeşitli özelleştirme seçenekleri sunar. ## Girdiler -| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +| Parametre | Açıklama | Veri Türü | Zorunlu | Aralık | |-----------|-------------|-----------|----------|-------| -| `model` | Video oluşturmak için kullanılacak ByteDance modeli. Kullanılabilir seçenekler:
`"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | STRING | Evet | Yukarıda listelenenler | -| `prompt` | Video oluşturmak için kullanılacak metin prompt. Boşlukları kesildikten sonra en az 1 karakter uzunluğunda olmalıdır. | STRING | Evet | - | -| `görüntü` | Video için kullanılacak ilk kare. Görsel 300x300 ve 6000x6000 piksel arasında olmalı, en boy oranı 0.4 ve 2.5 arasında olmalıdır. | GÖRSEL | Evet | - | -| `çözünürlük` | Çıktı videoyunun çözünürlüğü. Kullanılabilir seçenekler:
`"480p"`
`"720p"`
`"1080p"` | STRING | Evet | Yukarıda listelenenler | -| `en-boy oranı` | Çıktı videoyunun en boy oranı. Kullanılabilir seçenekler:
`"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | STRING | Evet | Yukarıda listelenenler | -| `süre` | Çıktı videoyunun süresi saniye cinsinden. `seedance-1-5-pro-251215` modeli için en düşük desteklenen süre 4 saniyedir. | INT | Evet | 3 - 12 | -| `seed` | Oluşturma için kullanılacak seed. Seçmeli, varsayılan değeri 0'dır. | INT | Hayır | 0 - 2147483647 | -| `sabit kamera` | Kamerayı sabitlemeyi belirtir. Platform, promptınıza kamerayı sabitleme talimatı ekler, ancak gerçek etkisini garanti etmez. Seçmeli, varsayılan değeri False'dır. | BOOLEAN | Hayır | - | -| `filigran` | Videoya "AI generated" su izi eklemeyi belirtir. Seçmeli, varsayılan değeri False'dır. | BOOLEAN | Hayır | - | -| `ses_oluştur` | Bu parametre, `seedance-1-5-pro-251215` modeli dışındaki herhangi bir model için göz ardı edilir. Seçmeli, varsayılan değeri False'dır. | BOOLEAN | Hayır | - | - -**Not:** Prompt, aşağıdaki kelimeleri (büyük/küçük harfe duyarlı olmaksızın) içermemelidir: `resolution`, `ratio`, `duration`, `seed`, `camerafixed`, `watermark`. Bu parametreler, ilgili girdiler aracılığıyla ayarlanır. +| `model` | Video oluşturmada kullanılacak ByteDance modeli (varsayılan: `"seedance-1-0-pro-fast-251015"`). | COMBO | Evet | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | +| `prompt` | Videoyu oluşturmak için kullanılan metin istemi. Baştaki ve sondaki boşluklar temizlendikten sonra en az 1 karakter uzunluğunda olmalıdır. | STRING | Evet | - | +| `görüntü` | Video için kullanılacak ilk kare. 300x300 ile 6000x6000 piksel arasında ve en-boy oranı 0,4 ile 2,5 arasında olmalıdır. | IMAGE | Evet | - | +| `çözünürlük` | Çıktı videosunun çözünürlüğü. | COMBO | Evet | `"480p"`
`"720p"`
`"1080p"` | +| `en-boy oranı` | Çıktı videosunun en-boy oranı. | COMBO | Evet | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `süre` | Çıktı videosunun saniye cinsinden süresi (varsayılan: 5). `seedance-1-5-pro-251215` modeli için desteklenen en düşük süre 4 saniyedir. | INT | Evet | 3 - 12 | +| `seed` | Üretimde kullanılacak tohum (varsayılan: 0). | INT | Hayır | 0 - 2147483647 | +| `sabit kamera` | Kameranın sabitlenip sabitlenmeyeceğini belirtir. Platform, isteminize kamerayı sabitleme talimatını ekler ancak gerçek etkiyi garanti etmez (varsayılan: False). | BOOLEAN | Hayır | `False`
`True` | +| `filigran` | Videoya "AI generated" filigranı eklenip eklenmeyeceğini belirtir (varsayılan: False). | BOOLEAN | Hayır | `False`
`True` | +| `ses_oluştur` | Bu parametre, `seedance-1-5-pro-251215` dışındaki tüm modeller için yok sayılır (varsayılan: False). | BOOLEAN | Hayır | `False`
`True` | + +**Not:** İstem, aşağıdaki sözcükleri içermemelidir (büyük/küçük harf ayrımı gözetmeksizin): `resolution`, `ratio`, `duration`, `seed`, `camerafixed`, `watermark`. Bu parametreler kendilerine ayrılmış girdiler aracılığıyla ayarlanır. ## Çıktılar | Çıktı Adı | Açıklama | Veri Türü | |-------------|-------------|-----------| -| `output` | Girdi görsel ve prompt parametrelerine dayalı olarak oluşturulan çıktı video dosyası. | VIDEO | +| `output` | Girdi görüntüsüne ve istem parametrelerine dayalı olarak oluşturulan video dosyası. | 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/ByteDanceImageToVideoNode/tr.md) diff --git a/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/zh-TW.md b/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/zh-TW.md index e528477be..cf020c365 100644 --- a/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/zh-TW.md +++ b/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/zh-TW.md @@ -1,33 +1,29 @@ # 字節跳動圖片轉影片 -# ByteDance 圖片轉影片節點 - -ByteDance 圖片轉影片節點使用 ByteDance 的 API,從輸入圖片和文字提示生成影片。它會創建一個視覺上呈現所提供描述的影片序列,並提供選項以自訂輸出畫質、畫面比例、持續時間和其他參數。 +ByteDance Image to Video 節點會透過 API 使用 ByteDance 模型,根據輸入的圖片和文字提示來產生影片。它會採用一張起始圖片幀,並建立遵循所提供描述的影片序列。此節點提供各種自訂選項,包括影片解析度、長寬比、持續時間及其他生成參數。 ## 輸入 -| 參數 | 描述 | 資料類型 | 必需 | 范圍 | +| 參數 | 描述 | 資料型別 | 必填 | 範圍 | |-----------|-------------|-----------|----------|-------| -| `model` | 使用於影片生成的 ByteDance 模型。可用的選項有:
`"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | STRING | 是 | 如上所示 | -| `prompt` | 用於生成影片的文字提示。必須至少包含 1 個字符,在刪除空白後。 | STRING | 是 | - | -| `image` | 用於影片的第一個畫面。圖片大小必須在 300x300 和 6000x6000 像素之間,畫面比例在 0.4 和 2.5 之間。 | IMAGE | 是 | - | -| `resolution` | 輸出影片的畫質。可用的選項有:
`"480p"`
`"720p"`
`"1080p"` | STRING | 是 | 如上所示 | -| `aspect_ratio` | 輸出影片的畫面比例。可用的選項有:
`"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | STRING | 是 | 如上所示 | -| `duration` | 輸出影片的持續時間(秒)。對於 `seedance-1-5-pro-251215` 模型,最低支援持續時間為 4 秒。 | INT | 是 | 3 - 12 | -| `seed` | 用於生成的種子。選擇性,默認值為 0。 | INT | 否 | 0 - 2147483647 | -| `camera_fixed` | 指定是否固定攝影機。平台會將固定攝影機的指示添加到您的提示中,但不保證實際效果。選擇性,默認值為 False。 | BOOLEAN | 否 | - | -| `watermark` | 是否在影片中添加 "AI 生成的" 水印。選擇性,默認值為 False。 | BOOLEAN | 否 | - | -| `generate_audio` | 此參數對除 `seedance-1-5-pro-251215` 模型以外的任何模型都無效。選擇性,默認值為 False。 | BOOLEAN | 否 | - | - -**注意:** 提示中不得包含以下單詞(不區分大小寫):`resolution`、`ratio`、`duration`、`seed`、`camerafixed`、`watermark`。這些參數通過其專屬輸入設置。 +| `model` | 用於影片生成的 ByteDance 模型(預設值:`"seedance-1-0-pro-fast-251015"`)。 | COMBO | 是 | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | +| `prompt` | 用於產生影片的文字提示。移除開頭和結尾的空白後,長度必須至少為 1 個字元。 | STRING | 是 | - | +| `image` | 要用作影片的第一幀。尺寸必須介於 300x300 與 6000x6000 像素之間,長寬比介於 0.4 與 2.5 之間。 | IMAGE | 是 | - | +| `resolution` | 輸出影片的解析度。 | COMBO | 是 | `"480p"`
`"720p"`
`"1080p"` | +| `aspect_ratio` | 輸出影片的長寬比。 | COMBO | 是 | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `duration` | 輸出影片的持續時間(秒),預設值為 5。對於 `seedance-1-5-pro-251215` 模型,支援的最小持續時間為 4 秒。 | INT | 是 | 3 - 12 | +| `seed` | 用於生成的隨機種子(預設值:0)。 | INT | 否 | 0 - 2147483647 | +| `camera_fixed` | 指定是否固定攝影機。平台會在你的提示詞末尾附加固定攝影機的指令,但不保證實際效果(預設值:False)。 | BOOLEAN | 否 | `False`
`True` | +| `watermark` | 是否在影片中加入「AI generated」浮水印(預設值:False)。 | BOOLEAN | 否 | `False`
`True` | +| `generate_audio` | 除 `seedance-1-5-pro-251215` 之外,此參數對任何模型都會被忽略(預設值:False)。 | BOOLEAN | 否 | `False`
`True` | + +**注意:** 提示詞中不得包含以下詞語(不區分大小寫):`resolution`、`ratio`、`duration`、`seed`、`camerafixed`、`watermark`。這些參數會透過各自的專用輸入進行設定。 ## 輸出 -| 輸出名稱 | 描述 | 資料類型 | +| 輸出名稱 | 描述 | 資料型別 | |-------------|-------------|-----------| -| `output` | 基於輸入圖片和提示參數生成的影片文件。 | VIDEO | - -上述文檔反映了從源代碼中提取的信息,並遵守了對文檔結構和內容指定的指南。 +| `output` | 根據輸入圖片和提示參數所產生的影片檔案。 | VIDEO | > 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/zh-TW.md) diff --git a/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/zh.md b/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/zh.md index aaf44db64..ac7692b8c 100644 --- a/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/zh.md +++ b/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/zh.md @@ -1,33 +1,29 @@ # 字节跳动图片转视频 -# ByteDance 图像转视频节点 - -ByteDance 图像转视频节点使用 ByteDance 的 API,从输入图像和文本提示中生成视频。它创建一个视频序列,以视觉形式表示提供的描述,并提供自定义输出分辨率、宽高比、时长和其他参数的选项。 +ByteDance Image to Video 节点通过 API,基于输入图像和文本提示词,使用 ByteDance 模型生成视频。它以起始图像帧作为输入,生成符合所提供描述的视频序列。该节点提供了多种自定义选项,可控制视频分辨率、宽高比、时长及其他生成参数。 ## 输入 -| 参数 | 描述 | 数据类型 | 必需 | 范围 | +| 参数 | 描述 | 数据类型 | 是否必填 | 取值范围 | |-----------|-------------|-----------|----------|-------| -| `模型` | 用于视频生成的 ByteDance 模型。可用选项包括:
`"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | STRING | 是 | 如上所示 | -| `提示` | 用于生成视频的文本提示。去除空白字符后,必须至少有 1 个字符长。 | STRING | 是 | - | -| `图片` | 用于视频的第一帧。图像大小必须在 300x300 到 6000x6000 像素之间,宽高比在 0.4 到 2.5 之间。 | IMAGE | 是 | - | -| `分辨率` | 输出视频的分辨率。可用选项包括:
`"480p"`
`"720p"`
`"1080p"` | STRING | 是 | 如上所示 | -| `宽高比` | 输出视频的宽高比。可用选项包括:
`"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | STRING | 是 | 如上所示 | -| `时长` | 输出视频的时长(秒)。对于 `seedance-1-5-pro-251215` 模型,最小支持的时长为 4 秒。 | INT | 是 | 3 - 12 | -| `种子` | 用于生成的种子值。可选,默认值为 0。 | INT | 否 | 0 - 2147483647 | -| `摄像头已固定` | 指定是否固定相机。平台会在您的提示中添加固定相机的指令,但不保证实际效果。可选,默认值为 False。 | BOOLEAN | 否 | - | -| `水印` | 是否在视频中添加“AI 生成”水印。可选,默认值为 False。 | BOOLEAN | 否 | - | -| `generate_audio` | 此参数仅对 `seedance-1-5-pro-251215` 模型以外的任何模型忽略。可选,默认值为 False。 | BOOLEAN | 否 | - | - -**注意:** 提示中不得包含以下单词(不区分大小写):`resolution`、`ratio`、`duration`、`seed`、`camerafixed`、`watermark`。这些参数通过其专用输入设置。 +| `模型` | 用于视频生成的 ByteDance 模型(默认:`"seedance-1-0-pro-fast-251015"`)。 | COMBO | 是 | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | +| `提示` | 用于生成视频的文本提示词。去除首尾空白后,长度至少为 1 个字符。 | STRING | 是 | - | +| `图片` | 用作视频首帧的图像。分辨率必须在 300x300 到 6000x6000 像素之间,且宽高比在 0.4 到 2.5 之间。 | IMAGE | 是 | - | +| `分辨率` | 输出视频的分辨率。 | COMBO | 是 | `"480p"`
`"720p"`
`"1080p"` | +| `宽高比` | 输出视频的宽高比。 | COMBO | 是 | `"adaptive"`
`"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `时长` | 输出视频的时长(秒)(默认:5)。对于 `seedance-1-5-pro-251215` 模型,支持的最短时长为 4 秒。 | INT | 是 | 3 - 12 | +| `种子` | 用于生成的随机种子(默认:0)。 | INT | 否 | 0 - 2147483647 | +| `摄像头已固定` | 指定是否固定摄像机。平台会在你的提示词后附加一条固定摄像机的指令,但不保证实际效果(默认:False)。 | BOOLEAN | 否 | `False`
`True` | +| `水印` | 是否在视频中添加“AI 生成”水印(默认:False)。 | BOOLEAN | 否 | `False`
`True` | +| `generate_audio` | 对于除 `seedance-1-5-pro-251215` 之外的任何模型,此参数都会被忽略(默认:False)。 | BOOLEAN | 否 | `False`
`True` | + +**注意:** 提示词中不得包含以下词语(不区分大小写):`resolution`、`ratio`、`duration`、`seed`、`camerafixed`、`watermark`。这些参数已通过各自的专用输入项进行设置。 ## 输出 | 输出名称 | 描述 | 数据类型 | |-------------|-------------|-----------| -| `output` | 根据输入图像和提示参数生成的视频文件。 | VIDEO | - -以上文档反映了从源代码中提取的信息,并遵守了文档结构和内容的指定指南。 +| `output` | 根据输入图像和提示词参数生成的视频文件。 | VIDEO | > 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceImageToVideoNode/zh.md) diff --git a/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/ar.md b/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/ar.md index caa377144..78fb8f6e5 100644 --- a/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/ar.md +++ b/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/ar.md @@ -1,54 +1,35 @@ # ByteDance نص إلى فيديو -تقوم وحدة تحويل النص إلى فيديو من ByteDance بإنتاج الفيديوهات باستخدام نماذج ByteDance عبر واجهة برمجة التطبيقات (API) بناءً على إشارات نصية. تأخذ الوحدة نصوصًا نصية وضبطات فيديو متعددة كمدخلات، ثم تنتج فيديو يتطابق مع التفاصيل المقدمة. تقوم الوحدة بمعالجة اتصالات API وتعيد الفيديو المُنتج كخرج. - -## نظرة عامة - -تُصمم وحدة تحويل النص إلى فيديو من ByteDance لتحويل إشارات النص إلى فيديوهات باستخدام قدرات الذكاء الاصطناعي لـ ByteDance. يمكن للمستخدمين تحديد النموذج، دقة الفيديو، نسبة الأبعاد، المدة، وغيرها من المعلمات لتحكم في عملية إنشاء الفيديو. +عقدة ByteDance Text to Video لتوليد فيديو باستخدام نماذج ByteDance عبر واجهة برمجة التطبيقات (API) بناءً على موجه نصي. يمكنك تقديم موجه واختيار إعدادات مثل النموذج، الدقة، نسبة الأبعاد، والمدة؛ حيث تُرسل العقدة طلب التوليد وتُرجع الفيديو المُولَّد. ## المدخلات -| المعامل | الوصف | نوع البيانات | إلزامي | نطاق | +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | |-----------|-------------|-----------|----------|-------| -| `النموذج` | النموذج الذي سيُستخدم للإنشاء. | STRING | نعم | - - "seedance-1-5-pro-251215" - - "seedance-1-0-pro-250528" - - "seedance-1-0-pro-fast-251015" | -| `النص الموجه` | الإشارة النصية المستخدمة لإنتاج الفيديو. | STRING | نعم | إدخال نص متعدد الأسطر | -| `الدقة` | دقة الفيديو المُنتج. | STRING | نعم | - - "480p" - - "720p" - - "1080p" | -| `نسبة العرض إلى الارتفاع` | نسبة الأبعاد للفيديو المُنتج. | STRING | نعم | - - "16:9" - - "4:3" - - "1:1" - - "3:4" - - "9:16" - - "21:9" | -| `المدة` | مدة الفيديو المُنتج بالثواني. | INT | نعم | من 3 إلى 12 ثانية | -| `البذرة` | البذرة التي سيُستخدمها للإنشاء. | INT | لا | من 0 إلى 2,147,483,647 | -| `الكاميرا ثابتة` | تحديد ما إذا كان يجب تثبيت الكاميرا. | BOOLEAN | لا | - | -| `علامة مائية` | تحديد ما إذا كان يجب إضافة علامة مائية "مُنتج بواسطة الذكاء الاصطناعي" على الفيديو. | BOOLEAN | لا | - | -| `توليد الصوت` | هذا المعامل يتم تجاهله لجميع النماذج باستثناء `seedance-1-5-pro-251215`. | BOOLEAN | لا | - | - -**محدوديات المعاملات:** - -- يجب أن يحتوي المعامل `prompt` على على الأقل رمز واحد بعد إزالة البيانات الزائدة. -- لا يمكن أن يحتوي المعامل `prompt` على المعاملات النصية التالية: "resolution", "ratio", "duration", "seed", "camerafixed", "watermark". -- يتم تقييد `duration` إلى قيم بين 3 و 12 ثانية. -- بالنسبة لنموذج `seedance-1-5-pro-251215`، هي مدة الدعم الأدنى هي 4 ثانية. -- يقبل المعامل `seed` قيمًا من 0 إلى 2,147,483,647. -- يتم تجاهل المعامل `generate_audio` لجميع النماذج باستثناء `seedance-1-5-pro-251215`. +| `النموذج` | نموذج ByteDance المستخدم لتوليد الفيديو (الافتراضي: `"seedance-1-0-pro-fast-251015"`). | COMBO | نعم | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | +| `النص الموجه` | الموجه النصي المستخدم لتوليد الفيديو. | STRING | نعم | - | +| `الدقة` | دقة الفيديو الناتج. | COMBO | نعم | `"480p"`
`"720p"`
`"1080p"` | +| `نسبة العرض إلى الارتفاع` | نسبة الأبعاد للفيديو الناتج. | COMBO | نعم | `"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `المدة` | مدة الفيديو الناتج بالثواني (الافتراضي: 5). | INT | نعم | 3 إلى 12 | +| `البذرة` | البذرة (Seed) المستخدمة في التوليد (الافتراضي: 0). | INT | لا | 0 إلى 2147483647 | +| `الكاميرا ثابتة` | يحدد ما إذا كان سيتم تثبيت الكاميرا. تُلحق المنصة تعليمة تثبيت الكاميرا بالموجه الخاص بك، ولكنها لا تضمن التأثير الفعلي (الافتراضي: False). | BOOLEAN | لا | - | +| `علامة مائية` | ما إذا كان سيتم إضافة علامة مائية "AI generated" إلى الفيديو (الافتراضي: False). | BOOLEAN | لا | - | +| `توليد الصوت` | يتم تجاهل هذا المعامل لأي نموذج باستثناء `seedance-1-5-pro-251215` (الافتراضي: False). | BOOLEAN | لا | - | + +**قيود المعاملات:** + +- يجب أن يحتوي معامل `prompt` على حرف واحد على الأقل بعد إزالة المسافات البيضاء. +- لا يمكن أن يحتوي معامل `prompt` على المعاملات النصية التالية: "resolution", "ratio", "duration", "seed", "camerafixed", "watermark". +- تقوم العقدة ببناء الموجه النهائي بإلحاق الإعدادات المحددة لـ `resolution` و`aspect_ratio` و`duration` و`seed` و`camera_fixed` و`watermark` بنص الموجه. +- يقتصر معامل `duration` على قيم بين 3 و12 ثانية. بالنسبة لنموذج `seedance-1-5-pro-251215`، فإن الحد الأدنى للمدة المدعومة هو 4 ثوانٍ. +- يقبل معامل `seed` القيم من 0 إلى 2,147,483,647. +- يكون لمعامل `generate_audio` تأثير فقط عندما يكون `model` مضبوطًا على `seedance-1-5-pro-251215`؛ ويتم تجاهله لجميع النماذج الأخرى. ## المخرجات -| اسم المخرج | الوصف | نوع البيانات | +| اسم المخرَج | الوصف | نوع البيانات | |-------------|-------------|-----------| -| `output` | ملف الفيديو المُنتج. | فيديو | -``` - -**ملاحظة:** وحدة تحويل النص إلى فيديو من ByteDance هي وحدة API وتحتاج إلى وكلاء التحقق من الهوية وأسرار API لتعمل بشكل صحيح. يتم تقديم هذه الوكلاء من خلال المدخلات المخفية `auth_token_comfy_org` و `api_key_comfy_org`. +| `output` | ملف الفيديو المُولَّد | VIDEO | > تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/ar.md) diff --git a/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/en.md b/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/en.md index 6400b56b3..b0f18805d 100644 --- a/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/en.md +++ b/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/en.md @@ -1,55 +1,35 @@ # ByteDance Text to Video -# ByteDance Text to Video Node - -The ByteDance Text to Video node generates videos using ByteDance models via an API based on text prompts. It takes a text description and various video settings as input, then creates a video that matches the provided specifications. The node handles the API communication and returns the generated video as output. - -## Overview - -The ByteDance Text to Video Node is designed to convert text prompts into videos using ByteDance's AI capabilities. Users can specify the model, resolution, aspect ratio, duration, and other parameters to control the video generation process. +The ByteDance Text to Video node generates a video using ByteDance models through an API based on a text prompt. You provide a prompt and choose settings such as the model, resolution, aspect ratio, and duration; the node submits the generation request and returns the generated video. ## Inputs | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `model` | The ByteDance model to use for generation. | STRING | Yes | - - "seedance-1-5-pro-251215" - - "seedance-1-0-pro-250528" - - "seedance-1-0-pro-fast-251015" | -| `prompt` | The text prompt used to generate the video. | STRING | Yes | Multiline text input | -| `resolution` | The resolution of the output video. | STRING | Yes | - - "480p" - - "720p" - - "1080p" | -| `aspect_ratio` | The aspect ratio of the output video. | STRING | Yes | - - "16:9" - - "4:3" - - "1:1" - - "3:4" - - "9:16" - - "21:9" | -| `duration` | The duration of the output video in seconds. | INT | Yes | 3 to 12 seconds | -| `seed` | Seed to use for generation. | INT | No | 0 to 2,147,483,647 | -| `camera_fixed` | Specifies whether to fix the camera. | BOOLEAN | No | - | -| `watermark` | Whether to add an "AI generated" watermark to the video. | BOOLEAN | No | - | -| `generate_audio` | This parameter is ignored for any model except `seedance-1-5-pro-251215`. | BOOLEAN | No | - | +| `model` | The ByteDance model used to generate the video (default: `"seedance-1-0-pro-fast-251015"`). | COMBO | Yes | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | +| `prompt` | The text prompt used to generate the video. | STRING | Yes | - | +| `resolution` | The resolution of the output video. | COMBO | Yes | `"480p"`
`"720p"`
`"1080p"` | +| `aspect_ratio` | The aspect ratio of the output video. | COMBO | Yes | `"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `duration` | The duration of the output video in seconds (default: 5). | INT | Yes | 3 to 12 | +| `seed` | Seed to use for generation (default: 0). | INT | No | 0 to 2147483647 | +| `camera_fixed` | Specifies whether to fix the camera. The platform appends an instruction to fix the camera to your prompt, but does not guarantee the actual effect (default: False). | BOOLEAN | No | - | +| `watermark` | Whether to add an "AI generated" watermark to the video (default: False). | BOOLEAN | No | - | +| `generate_audio` | This parameter is ignored for any model except `seedance-1-5-pro-251215` (default: False). | BOOLEAN | No | - | **Parameter Constraints:** -- The `prompt` must contain at least 1 character after whitespace removal. -- The `prompt` cannot contain the following text parameters: "resolution", "ratio", "duration", "seed", "camerafixed", "watermark". -- The `duration` is limited to values between 3 and 12 seconds. -- For the `seedance-1-5-pro-251215` model, the minimum supported duration is 4 seconds. -- The `seed` accepts values from 0 to 2,147,483,647. +- The `prompt` parameter must contain at least 1 character after whitespace removal. +- The `prompt` parameter cannot contain the following text parameters: "resolution", "ratio", "duration", "seed", "camerafixed", "watermark". +- The node builds the final prompt by appending the selected `resolution`, `aspect_ratio`, `duration`, `seed`, `camera_fixed`, and `watermark` settings to the prompt text. +- The `duration` parameter is limited to values between 3 and 12 seconds. For the `seedance-1-5-pro-251215` model, the minimum supported duration is 4 seconds. +- The `seed` parameter accepts values from 0 to 2,147,483,647. - The `generate_audio` parameter only has an effect when the `model` is set to `seedance-1-5-pro-251215`; it is ignored for all other models. ## Outputs | Output Name | Description | Data Type | |-------------|-------------|-----------| -| `output` | The generated video file. | VIDEO | - -**Note:** The ByteDance Text to Video Node is an API node and requires authentication tokens and API keys to function properly. These are provided through the `auth_token_comfy_org` and `api_key_comfy_org` hidden inputs. +| `output` | The generated video file | 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/ByteDanceTextToVideoNode/en.md) diff --git a/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/es.md b/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/es.md index c3f0750a2..26ceacaac 100644 --- a/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/es.md +++ b/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/es.md @@ -1,55 +1,35 @@ # ByteDance Texto a Video -# Nodo de Texto a Vídeo de ByteDance - -El nodo de Texto a Vídeo de ByteDance genera videos utilizando modelos de ByteDance a través de una API basada en sugerencias de texto. Acepta una descripción de texto y varios ajustes de vídeo como entrada, luego crea un vídeo que coincida con las especificaciones proporcionadas. El nodo maneja la comunicación con la API y devuelve el vídeo generado como salida. - -## Resumen - -El nodo de Texto a Vídeo de ByteDance está diseñado para convertir sugerencias de texto en vídeos utilizando las capacidades de IA de ByteDance. Los usuarios pueden especificar el modelo, la resolución, el aspecto, la duración y otros parámetros para controlar el proceso de generación de vídeo. +El nodo ByteDance Text to Video genera un video a partir de un prompt de texto mediante modelos de ByteDance a través de una API. Se proporciona un prompt y se eligen ajustes como el modelo, la resolución, la relación de aspecto y la duración; el nodo envía la solicitud de generación y devuelve el video generado. ## Entradas -| Parámetro | Descripción | Tipo de Datos | Obligatorio | Rango | +| Parámetro | Descripción | Tipo de datos | Requerido | Rango | |-----------|-------------|-----------|----------|-------| -| `modelo` | El modelo de ByteDance a utilizar para la generación. | STRING | Sí | - - "seedance-1-5-pro-251215" - - "seedance-1-0-pro-250528" - - "seedance-1-0-pro-fast-251015" | -| `prompt` | La sugerencia de texto utilizada para generar el vídeo. | STRING | Sí | Entrada de texto multilinea | -| `resolución` | La resolución del vídeo de salida. | STRING | Sí | - - "480p" - - "720p" - - "1080p" | -| `relación_de_aspecto` | El aspecto del vídeo de salida. | STRING | Sí | - - "16:9" - - "4:3" - - "1:1" - - "3:4" - - "9:16" - - "21:9" | -| `duración` | La duración del vídeo de salida en segundos. | INT | Sí | 3 a 12 segundos | -| `semilla` | Semilla a utilizar para la generación. | INT | No | 0 a 2,147,483,647 | -| `cámara_fija` | Especifica si se debe fijar la cámara. | BOOLEAN | No | - | -| `marca_de_agua` | Si se debe agregar una marca de agua "Generado por IA" al vídeo. | BOOLEAN | No | - | -| `generate_audio` | Este parámetro se ignora para cualquier modelo excepto `seedance-1-5-pro-251215`. | BOOLEAN | No | - | - -**Restricciones del Parámetro:** - -- El `prompt` debe contener al menos 1 carácter después de la eliminación de espacios en blanco. -- El `prompt` no puede contener los siguientes parámetros de texto: "resolution", "ratio", "duration", "seed", "camerafixed", "watermark". -- La `duration` está limitada a valores entre 3 y 12 segundos. -- Para el modelo `seedance-1-5-pro-251215`, la duración mínima admitida es de 4 segundos. -- La `seed` acepta valores de 0 a 2,147,483,647. -- El parámetro `generate_audio` solo tiene efecto cuando el `model` está configurado en `seedance-1-5-pro-251215`; se ignora para todos los otros modelos. +| `modelo` | El modelo de ByteDance utilizado para generar el video (por defecto: `"seedance-1-0-pro-fast-251015"`). | COMBO | Sí | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | +| `prompt` | El prompt de texto utilizado para generar el video. | STRING | Sí | - | +| `resolución` | La resolución del video de salida. | COMBO | Sí | `"480p"`
`"720p"`
`"1080p"` | +| `relación_de_aspecto` | La relación de aspecto del video de salida. | COMBO | Sí | `"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `duración` | La duración del video de salida en segundos (por defecto: 5). | INT | Sí | 3 a 12 | +| `semilla` | Semilla que se utilizará para la generación (por defecto: 0). | INT | No | 0 a 2147483647 | +| `cámara_fija` | Especifica si se debe fijar la cámara. La plataforma añade al prompt una instrucción para fijar la cámara, pero no garantiza el efecto real (por defecto: False). | BOOLEAN | No | - | +| `marca_de_agua` | Indica si se debe añadir una marca de agua "AI generated" al video (por defecto: False). | BOOLEAN | No | - | +| `generate_audio` | Este parámetro se ignora para cualquier modelo excepto `seedance-1-5-pro-251215` (por defecto: False). | BOOLEAN | No | - | + +**Restricciones de los parámetros:** + +- El parámetro `prompt` debe contener al menos 1 carácter después de eliminar los espacios en blanco. +- El parámetro `prompt` no puede contener los siguientes parámetros de texto: "resolution", "ratio", "duration", "seed", "camerafixed", "watermark". +- El nodo construye el prompt final añadiendo los ajustes seleccionados de `resolution`, `aspect_ratio`, `duration`, `seed`, `camera_fixed` y `watermark` al texto del prompt. +- El parámetro `duration` está limitado a valores entre 3 y 12 segundos. Para el modelo `seedance-1-5-pro-251215`, la duración mínima admitida es de 4 segundos. +- El parámetro `seed` acepta valores de 0 a 2,147,483,647. +- El parámetro `generate_audio` solo tiene efecto cuando `model` está configurado como `seedance-1-5-pro-251215`; se ignora para todos los demás modelos. ## Salidas -| Nombre de Salida | Descripción | Tipo de Datos | +| Nombre de salida | Descripción | Tipo de datos | |-------------|-------------|-----------| -| `output` | El archivo de vídeo generado. | VIDEO | - -**Nota:** El nodo de Texto a Vídeo de ByteDance es un nodo de API y requiere tokens de autenticación y claves de API para funcionar adecuadamente. Estos se proporcionan a través de las entradas ocultas `auth_token_comfy_org` y `api_key_comfy_org`. +| `output` | El archivo de video generado | 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/ByteDanceTextToVideoNode/es.md) diff --git a/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/fa.md b/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/fa.md index c160f2e78..00e18883b 100644 --- a/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/fa.md +++ b/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/fa.md @@ -1,51 +1,35 @@ # تبدیل متن به ویدیو ByteDance -گره تبدیل متن به ویدیو ByteDance ویدیو‌هایی را با استفاده از مدل‌های ByteDance از طریق یک API بر اساس نکات نوشتاری تولید می‌کند. این گره نکات نوشتاری و تنظیمات مختلف ویدیو را به عنوان ورودی می‌گیرد، سپس ویدیویی که با مشخصات ارائه شده مطابقت دارد، ایجاد می‌کند. این گره ارتباط با API را مدیریت کرده و ویدیوی تولید شده را به عنوان خروجی بازمی‌گرداند. - -## مقدمه - -گره تبدیل متن به ویدیو ByteDance طراحی شده است تا نکات نوشتاری را به ویدیو‌ها تبدیل کند که از توانایی‌های هوش مصنوعی ByteDance استفاده می‌کند. کاربران می‌توانند مدل، رزولوشن، نسبت ابعاد، طول و سایر پارامترها را مشخص کنند تا فرآیند تولید ویدیو را کنترل کنند. +گره ByteDance Text to Video با استفاده از مدل‌های ByteDance و از طریق یک API، بر پایه یک پرامپت متنی ویدیو تولید می‌کند. شما یک پرامپت ارائه می‌دهید و تنظیماتی مانند مدل، رزولوشن، نسبت تصویر و مدت‌زمان را انتخاب می‌کنید؛ گره درخواست تولید را ارسال می‌کند و ویدیوی تولیدشده را برمی‌گرداند. ## ورودی‌ها -| پارامتر | توضیح | نوع داده | الزامی | محدوده | +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | |-----------|-------------|-----------|----------|-------| -| `مدل` | مدل ByteDance برای استفاده در تولید. | STRING | بله | - - "seedance-1-5-pro-251215" - - "seedance-1-0-pro-250528" - - "seedance-1-0-pro-fast-251015" | -| `پرامپت` | نکات نوشتاری استفاده شده برای تولید ویدیو. | STRING | بله | ورودی متن چند خطی | -| `وضوح` | رزولوشن ویدیوی خروجی. | STRING | بله | - - "480p" - - "720p" - - "1080p" | -| `نسبت تصویر` | نسبت ابعاد ویدیوی خروجی. | STRING | بله | - - "16:9" - - "4:3" - - "1:1" - - "3:4" - - "9:16" - - "21:9" | -| `مدت زمان` | طول ویدیوی خروجی به ثانیه. | INT | بله | 3 تا 12 ثانیه | -| `بذر` | عدد اول برای استفاده در تولید. | INT | خیر | 0 تا 2,147,483,647 | -| `ثابت بودن دوربین` | مشخص می‌کند که آیا دوربین را ثابت نگه داریم یا خیر. | BOOLEAN | خیر | - | -| `واترمارک` | مشخص می‌کند که آیا برچسب "تولید شده توسط AI" به ویدیو اضافه شود یا خیر. | BOOLEAN | خیر | - | -| `تولید صدا` | این پارامتر برای مدل‌های غیر `seedance-1-5-pro-251215` نادیده گرفته می‌شود. | BOOLEAN | خیر | - | - -**محدودیت‌های پارامتر:** - -- `prompt` باید حداقل 1 کاراکتر پس از حذف فاصله‌ها داشته باشد. -- `prompt` نمی‌تواند شامل پارامترهای نوشتاری زیر باشد: "resolution", "ratio", "duration", "seed", "camerafixed", "watermark". -- `duration` محدود به مقادیر بین 3 تا 12 ثانیه است. -- برای مدل `seedance-1-5-pro-251215`، طول حداقلی پشتیبانی شده 4 ثانیه است. -- `seed` مقادیر از 0 تا 2,147,483,647 را پذیرش می‌کند. -- پارامتر `generate_audio` فقط زمانی اثر دارد که `model` به `seedance-1-5-pro-251215` تنظیم شود؛ برای مدل‌های دیگر نادیده گرفته می‌شود. +| `مدل` | مدل ByteDance برای تولید ویدیو (پیش‌فرض: `"seedance-1-0-pro-fast-251015"`). | COMBO | بله | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | +| `پرامپت` | پرامپت متنی برای تولید ویدیو. | STRING | بله | - | +| `وضوح` | رزولوشن ویدیوی خروجی. | COMBO | بله | `"480p"`
`"720p"`
`"1080p"` | +| `نسبت تصویر` | نسبت تصویر ویدیوی خروجی. | COMBO | بله | `"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `مدت زمان` | مدت‌زمان ویدیوی خروجی بر حسب ثانیه (پیش‌فرض: 5). | INT | بله | 3 تا 12 | +| `بذر` | مقدار seed برای تولید (پیش‌فرض: 0). | INT | خیر | 0 تا 2147483647 | +| `ثابت بودن دوربین` | مشخص می‌کند که دوربین ثابت باشد یا نه. پلتفرم یک دستور برای ثابت نگه‌داشتن دوربین به پرامپت شما اضافه می‌کند، اما اثر واقعی را تضمین نمی‌کند (پیش‌فرض: False). | BOOLEAN | خیر | - | +| `واترمارک` | آیا واترمارک «تولیدشده با هوش مصنوعی» به ویدیو اضافه شود (پیش‌فرض: False). | BOOLEAN | خیر | - | +| `تولید صدا` | این پارامتر برای هر مدلی به‌جز `seedance-1-5-pro-251215` نادیده گرفته می‌شود (پیش‌فرض: False). | BOOLEAN | خیر | - | + +**محدودیت‌های پارامترها:** + +- پارامتر `prompt` باید پس از حذف فاصله‌های سفید حداقل 1 کاراکتر داشته باشد. +- پارامتر `prompt` نمی‌تواند شامل متن‌های پارامتری زیر باشد: "resolution"، "ratio"، "duration"، "seed"، "camerafixed"، "watermark". +- گره پرامپت نهایی را با افزودن تنظیمات انتخاب‌شده `resolution`، `aspect_ratio`، `duration`، `seed`، `camera_fixed` و `watermark` به متن پرامپت می‌سازد. +- پارامتر `duration` فقط به مقادیر بین 3 و 12 ثانیه محدود است. برای مدل `seedance-1-5-pro-251215`، حداقل مدت‌زمان پشتیبانی‌شده 4 ثانیه است. +- پارامتر `seed` مقادیر 0 تا 2,147,483,647 را می‌پذیرد. +- پارامتر `generate_audio` فقط زمانی اثر دارد که `model` روی `seedance-1-5-pro-251215` تنظیم شده باشد؛ برای همه مدل‌های دیگر نادیده گرفته می‌شود. ## خروجی‌ها -| نام خروجی | توضیح | نوع داده | +| نام خروجی | توضیحات | نوع داده | |-------------|-------------|-----------| -| `output` | فایل ویدیوی تولید شده. | VIDEO | +| `output` | فایل ویدیوی تولیدشده | VIDEO | > این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/fa.md) diff --git a/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/fr.md b/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/fr.md index 716530856..9cb99e4a3 100644 --- a/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/fr.md +++ b/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/fr.md @@ -1,55 +1,35 @@ # ByteDance Texte vers Vidéo -# Nœud Texte vers Vidéo ByteDance - -Le nœud Texte vers Vidéo ByteDance génère des vidéos à l'aide des modèles ByteDance via une API basée sur des prompts textuels. Il prend une description textuelle et divers réglages vidéo en entrée, puis crée une vidéo correspondant aux spécifications fournies. Le nœud gère la communication API et retourne la vidéo générée. - -## Aperçu - -Le nœud Texte vers Vidéo ByteDance est conçu pour convertir des prompts textuels en vidéos en utilisant les capacités IA de ByteDance. Les utilisateurs peuvent spécifier le modèle, la résolution, le ratio d'aspect, la durée et d'autres paramètres pour contrôler le processus de génération vidéo. +Le nœud ByteDance Text to Video génère une vidéo à l'aide des modèles ByteDance via une API, à partir d'une invite de texte. Vous fournissez une invite et choisissez des paramètres tels que le modèle, la résolution, le format d'image et la durée ; le nœud soumet la demande de génération et renvoie la vidéo générée. ## Entrées -| Paramètre | Description | Type de données | Obligatoire | Gamme | -|-----------|-------------|-----------|----------|-------| -| `model` | Le modèle ByteDance à utiliser pour la génération. | STRING | Oui | - - "seedance-1-5-pro-251215" - - "seedance-1-0-pro-250528" - - "seedance-1-0-pro-fast-251015" | -| `prompt` | Le prompt textuel utilisé pour générer la vidéo. | STRING | Oui | Entrée de texte multiligne | -| `resolution` | La résolution de la vidéo de sortie. | STRING | Oui | - - "480p" - - "720p" - - "1080p" | -| `aspect_ratio` | Le ratio d'aspect de la vidéo de sortie. | STRING | Oui | - - "16:9" - - "4:3" - - "1:1" - - "3:4" - - "9:16" - - "21:9" | -| `duration` | La durée de la vidéo de sortie en secondes. | INT | Oui | 3 à 12 secondes | -| `seed` | Graine à utiliser pour la génération. | INT | Non | 0 à 2,147,483,647 | -| `camera_fixed` | Spécifie si la caméra doit être fixée. | BOOLEAN | Non | - | -| `filigrane` | Indique si un filigrane "Généré par IA" doit être ajouté à la vidéo. | BOOLEAN | Non | - | -| `générer_audio` | Ce paramètre est ignoré pour tous les modèles sauf `seedance-1-5-pro-251215`. | BOOLEAN | Non | - | +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `model` | Le modèle ByteDance utilisé pour générer la vidéo (défaut : `"seedance-1-0-pro-fast-251015"`). | COMBO | Oui | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | +| `prompt` | L'invite de texte utilisée pour générer la vidéo. | STRING | Oui | - | +| `resolution` | La résolution de la vidéo de sortie. | COMBO | Oui | `"480p"`
`"720p"`
`"1080p"` | +| `aspect_ratio` | Le rapport d'aspect de la vidéo de sortie. | COMBO | Oui | `"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `duration` | La durée de la vidéo de sortie en secondes (défaut : 5). | INT | Oui | 3 à 12 | +| `seed` | Graine (seed) à utiliser pour la génération (défaut : 0). | INT | Non | 0 à 2147483647 | +| `camera_fixed` | Spécifie si la caméra doit être fixe. La plateforme ajoute une instruction pour fixer la caméra à votre invite, mais ne garantit pas l'effet réel (défaut : False). | BOOLEAN | Non | - | +| `filigrane` | Indique s'il faut ajouter un filigrane « généré par IA » à la vidéo (défaut : False). | BOOLEAN | Non | - | +| `générer_audio` | Ce paramètre est ignoré pour tous les modèles sauf `seedance-1-5-pro-251215` (défaut : False). | BOOLEAN | Non | - | **Contraintes des paramètres :** -- Le `prompt` doit contenir au moins 1 caractère après suppression des espaces. -- Le `prompt` ne peut pas contenir les paramètres textuels suivants : "resolution", "ratio", "duration", "seed", "camerafixed", "watermark". -- La `duration` est limitée aux valeurs entre 3 et 12 secondes. -- Pour le modèle `seedance-1-5-pro-251215`, la durée minimale supportée est de 4 secondes. -- Le `seed` accepte des valeurs de 0 à 2,147,483,647. -- Le paramètre `generate_audio` ne prend effet que lorsque le `model` est réglé sur `seedance-1-5-pro-251215` ; il est ignoré pour tous les autres modèles. +- Le paramètre `prompt` doit contenir au moins 1 caractère après suppression des espaces blancs. +- Le paramètre `prompt` ne peut pas contenir les paramètres de texte suivants : « resolution », « ratio », « duration », « seed », « camerafixed », « watermark ». +- Le nœud construit l'invite finale en ajoutant les paramètres sélectionnés `resolution`, `aspect_ratio`, `duration`, `seed`, `camera_fixed` et `watermark` au texte de l'invite. +- Le paramètre `duration` est limité à des valeurs comprises entre 3 et 12 secondes. Pour le modèle `seedance-1-5-pro-251215`, la durée minimale prise en charge est de 4 secondes. +- Le paramètre `seed` accepte des valeurs de 0 à 2 147 483 647. +- Le paramètre `generate_audio` n'a d'effet que lorsque le `model` est défini sur `seedance-1-5-pro-251215` ; il est ignoré pour tous les autres modèles. ## Sorties | Nom de sortie | Description | Type de données | -|-------------|-------------|-----------| -| `output` | Le fichier vidéo généré. | VIDÉO | - -**Note :** Le nœud Texte vers Vidéo ByteDance est un nœud API et nécessite des jetons d'authentification et des clés API pour fonctionner correctement. Ces éléments sont fournis via les entrées cachées `auth_token_comfy_org` et `api_key_comfy_org`. +|---------------|-------------|-----------------| +| `output` | Le fichier vidéo généré | 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/ByteDanceTextToVideoNode/fr.md) diff --git a/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/ja.md b/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/ja.md index ce53dff33..d04bbebd2 100644 --- a/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/ja.md +++ b/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/ja.md @@ -1,54 +1,35 @@ # ByteDance テキストから動画へ -ByteDance テキストからビデオノードは、テキストのプロンプトに基づいて API を通じて ByteDance モデルを使用してビデオを生成します。テキストの説明とさまざまなビデオ設定を入力として受け取り、提供された仕様に一致するビデオを作成します。ノードは API 通信を処理し、生成されたビデオを出力として返します。 - -## 概要 - -ByteDance テキストからビデオノードは、テキストのプロンプトをビデオに変換するために ByteDance の AI 機能を使用するように設計されています。ユーザーはモデル、解像度、アスペクト比、長さ、その他のパラメータを指定してビデオ生成プロセスを制御できます。 +The ByteDance Text to Video ノードは、テキストプロンプトに基づき、ByteDance モデルを API 経由で使用して動画を生成します。プロンプトを入力し、モデル、解像度、アスペクト比、長さなどの設定を選択すると、ノードが生成リクエストを送信し、生成された動画を返します。 ## 入力 -| パラメータ | 説明 | データ型 | 必須 | 范囲 | -|------------|------|----------|------|-------| -| `モデル` | 生成に使用する ByteDance モデル | STRING | はい | - - "seedance-1-5-pro-251215" - - "seedance-1-0-pro-250528" - - "seedance-1-0-pro-fast-251015" | -| `プロンプト` | ビデオ生成に使用するテキストプロンプト | STRING | はい | 多行テキスト入力 | -| `解像度` | 出力ビデオの解像度 | STRING | はい | - - "480p" - - "720p" - - "1080p" | -| `アスペクト比` | 出力ビデオのアスペクト比 | STRING | はい | - - "16:9" - - "4:3" - - "1:1" - - "3:4" - - "9:16" - - "21:9" | -| `長さ` | 出力ビデオの長さ(秒) | INT | はい | 3秒から12秒 | -| `シード` | 生成に使用するシード | INT | いいえ | 0から2,147,483,647 | -| `カメラ固定` | カメラを固定するかどうかを指定 | BOOLEAN | いいえ | - | -| `透かし` | ビデオに「AI 生成」というウォーターマークを追加するかどうか | BOOLEAN | いいえ | - | -| `generate_audio` | このパラメータは `seedance-1-5-pro-251215` 以外のモデルでは無視されます | BOOLEAN | いいえ | - | - -**パラメータ制約:** - -- `prompt` は、スペースを削除した後でも少なくとも1文字含まれている必要があります。 -- `prompt` には、以下のテキストパラメータを含めることはできません:「resolution」、「ratio」、「duration」、「seed」、「camerafixed」、「watermark」。 -- `duration` は、3秒から12秒の範囲で限定されます。 -- `seedance-1-5-pro-251215` モデルの場合、最小サポート長さは4秒です。 -- `seed` は、0から2,147,483,647の値を受け入れます。 -- `generate_audio` パラメータは、`model` が `seedance-1-5-pro-251215` に設定されている場合にのみ効果があります;他のすべてのモデルでは無視されます。 +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `モデル` | 動画の生成に使用する ByteDance モデル(デフォルト: `"seedance-1-0-pro-fast-251015"`)。 | COMBO | はい | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | +| `プロンプト` | 動画の生成に使用するテキストプロンプト。 | STRING | はい | - | +| `解像度` | 出力動画の解像度。 | COMBO | はい | `"480p"`
`"720p"`
`"1080p"` | +| `アスペクト比` | 出力動画のアスペクト比。 | COMBO | はい | `"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `長さ` | 出力動画の長さ(秒)(デフォルト: 5)。 | INT | はい | 3〜12 | +| `シード` | 生成に使用するシード(デフォルト: 0)。 | INT | いいえ | 0〜2147483647 | +| `カメラ固定` | カメラを固定するかどうかを指定します。プラットフォームはカメラを固定する指示をプロンプトに追加しますが、実際の効果は保証されません(デフォルト: False)。 | BOOLEAN | いいえ | - | +| `透かし` | 動画に「AI 生成」の透かしを追加するかどうか(デフォルト: False)。 | BOOLEAN | いいえ | - | +| `generate_audio` | このパラメータは、`seedance-1-5-pro-251215` 以外のモデルでは無視されます(デフォルト: False)。 | BOOLEAN | いいえ | - | + +**パラメータの制約事項:** + +- `prompt` パラメータには、空白を除去した後に少なくとも1文字が含まれている必要があります。 +- `prompt` パラメータには、次のテキストパラメータを含めることはできません: "resolution", "ratio", "duration", "seed", "camerafixed", "watermark"。 +- ノードは、選択した `resolution`、`aspect_ratio`、`duration`、`seed`、`camera_fixed`、`watermark` の各設定をプロンプトテキストに追加して、最終的なプロンプトを構築します。 +- `duration` パラメータは 3 秒から 12 秒の範囲に制限されます。`seedance-1-5-pro-251215` モデルの場合、サポートされる最小の長さは 4 秒です。 +- `seed` パラメータは 0 から 2,147,483,647 の値を受け入れます。 +- `generate_audio` パラメータは、`model` が `seedance-1-5-pro-251215` に設定されている場合にのみ効果があり、他のすべてのモデルでは無視されます。 ## 出力 | 出力名 | 説明 | データ型 | -|--------|------|----------| -| `output` | 生成されたビデオファイル | ビデオ | -``` - -**注意:** ByteDance テキストからビデオノードは API ノードであり、正常に機能するために認証トークンと API キーが必要です。これらは `auth_token_comfy_org` と `api_key_comfy_org` 隠し入力を通じて提供されます。 +|-------------|-------------|-----------| +| `output` | 生成された動画ファイル | VIDEO | > このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/ja.md) diff --git a/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/ko.md b/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/ko.md index b5889ffa8..478ccf28d 100644 --- a/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/ko.md +++ b/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/ko.md @@ -1,54 +1,35 @@ # ByteDance 텍스트-비디오 -ByteDance 텍스트로 비디오 노드는 텍스트 프롬프트를 기반으로 ByteDance 모델을 통해 API를 통해 비디오를 생성합니다. 텍스트 설명과 다양한 비디오 설정을 입력으로 받아, 제공된 사양에 맞는 비디오를 생성합니다. 노드는 API 통신을 처리하고 생성된 비디오를 출력으로 반환합니다. - -## 개요 - -ByteDance 텍스트로 비디오 노드는 ByteDance의 AI 기능을 사용하여 텍스트 프롬프트를 비디오로 변환하는 데 설계되었습니다. 사용자는 모델, 해상도, 비율, 지속 시간 등 다양한 매개변수를 지정하여 비디오 생성 과정을 제어할 수 있습니다. +ByteDance Text to Video 노드는 텍스트 프롬프트를 기반으로 API를 통해 ByteDance 모델을 사용하여 비디오를 생성합니다. 사용자는 프롬프트를 제공하고 모델, 해상도, 종횡비, 지속 시간 등의 설정을 선택합니다. 그러면 노드가 생성 요청을 제출하고 생성된 비디오를 반환합니다. ## 입력 -| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +| 매개변수 | 설명 | 데이터 타입 | 필수 여부 | 범위 | |-----------|-------------|-----------|----------|-------| -| `model` | 생성에 사용할 ByteDance 모델입니다. | STRING | 예 | - - "seedance-1-5-pro-251215" - - "seedance-1-0-pro-250528" - - "seedance-1-0-pro-fast-251015" | -| `prompt` | 비디오를 생성하는 데 사용할 텍스트 프롬프트입니다. | STRING | 예 | 다중 줄 텍스트 입력 | -| `resolution` | 출력 비디오의 해상도입니다. | STRING | 예 | - - "480p" - - "720p" - - "1080p" | -| `aspect_ratio` | 출력 비디오의 비율입니다. | STRING | 예 | - - "16:9" - - "4:3" - - "1:1" - - "3:4" - - "9:16" - - "21:9" | -| `duration` | 출력 비디오의 지속 시간(초)입니다. | INT | 예 | 3초에서 12초 사이 | -| `seed` | 생성에 사용할 시드입니다. | INT | 아님 | 0에서 2,147,483,647 사이 | -| `camera_fixed` | 카메라를 고정할지 여부를 지정합니다. | BOOLEAN | 아님 | - | -| `watermark` | 비디오에 "AI 생성" 워터마크를 추가할지 여부를 지정합니다. | BOOLEAN | 아님 | - | -| `generate_audio` | 이 매개변수는 `seedance-1-5-pro-251215` 모델을 제외한 모든 모델에서 무시됩니다. | BOOLEAN | 아님 | - | +| `model` | 비디오 생성에 사용되는 ByteDance 모델(기본값: `"seedance-1-0-pro-fast-251015"`). | COMBO | 예 | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | +| `prompt` | 비디오 생성에 사용되는 텍스트 프롬프트. | STRING | 예 | - | +| `resolution` | 출력 비디오의 해상도. | COMBO | 예 | `"480p"`
`"720p"`
`"1080p"` | +| `aspect_ratio` | 출력 비디오의 종횡비. | COMBO | 예 | `"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `duration` | 출력 비디오의 지속 시간(초) (기본값: 5). | INT | 예 | 3~12 | +| `seed` | 생성에 사용되는 시드(기본값: 0). | INT | 아니요 | 0~2,147,483,647 | +| `camera_fixed` | 카메라 고정 여부를 지정합니다. 플랫폼은 카메라를 고정하라는 지시문을 프롬프트에 추가하지만 실제 효과를 보장하지는 않습니다(기본값: False). | BOOLEAN | 아니요 | - | +| `watermark` | 비디오에 "AI 생성" 워터마크를 추가할지 여부(기본값: False). | BOOLEAN | 아니요 | - | +| `generate_audio` | 이 매개변수는 `seedance-1-5-pro-251215` 모델을 제외한 모든 모델에서 무시됩니다(기본값: False). | BOOLEAN | 아니요 | - | **매개변수 제약 조건:** -- `prompt`은 공백 제거 후 최소 1자리 이상이어야 합니다. -- `prompt`은 다음 텍스트 매개변수를 포함할 수 없습니다: "resolution", "ratio", "duration", "seed", "camerafixed", "watermark". -- `duration`은 3초에서 12초 사이의 값을 가지도록 제한됩니다. -- `seedance-1-5-pro-251215` 모델에서는 최소 지원 지속 시간이 4초입니다. -- `seed`은 0에서 2,147,483,647 사이의 값을 받아들입니다. -- `generate_audio` 매개변수는 `model`이 `seedance-1-5-pro-251215`으로 설정되었을 때만 효과가 있으며, 다른 모델에서는 무시됩니다. +- `prompt` 매개변수는 공백 제거 후 최소 1자를 포함해야 합니다. +- `prompt` 매개변수에는 다음 텍스트 매개변수를 포함할 수 없습니다: "resolution", "ratio", "duration", "seed", "camerafixed", "watermark". +- 노드는 선택한 `resolution`, `aspect_ratio`, `duration`, `seed`, `camera_fixed`, `watermark` 설정을 프롬프트 텍스트에 추가하여 최종 프롬프트를 구성합니다. +- `duration` 매개변수는 3초에서 12초 사이의 값으로 제한됩니다. `seedance-1-5-pro-251215` 모델의 경우 지원되는 최소 지속 시간은 4초입니다. +- `seed` 매개변수는 0부터 2,147,483,647까지의 값을 허용합니다. +- `generate_audio` 매개변수는 `model`이 `seedance-1-5-pro-251215`로 설정된 경우에만 적용되며, 다른 모든 모델에서는 무시됩니다. ## 출력 | 출력 이름 | 설명 | 데이터 타입 | |-------------|-------------|-----------| -| `output` | 생성된 비디오 파일입니다. | 비디오 | -``` - -**주의:** ByteDance 텍스트로 비디오 노드는 API 노드이며, 올바르게 작동하려면 인증 토큰과 API 키가 필요합니다. 이들은 `auth_token_comfy_org`과 `api_key_comfy_org` 숨겨진 입력을 통해 제공됩니다. +| `output` | 생성된 비디오 파일 | VIDEO | > 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/ko.md) diff --git a/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/pt-BR.md b/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/pt-BR.md index 7b9107554..04e6b05c0 100644 --- a/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/pt-BR.md +++ b/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/pt-BR.md @@ -1,51 +1,35 @@ # ByteDance Texto para Vídeo -O nó ByteDance Text to Video gera vídeos usando modelos da ByteDance por meio de uma API com base em prompts de texto. Ele recebe uma descrição de texto e vários ajustes de vídeo como entrada, então cria um vídeo que corresponda às especificações fornecidas. O nó lida com a comunicação da API e retorna o vídeo gerado como saída. - -## Visão Geral - -O nó ByteDance Text to Video foi projetado para converter prompts de texto em vídeos usando as capacidades de IA da ByteDance. Os usuários podem especificar o modelo, a resolução, a proporção de aspecto, a duração e outros parâmetros para controlar o processo de geração de vídeo. +O nó ByteDance Text to Video gera um vídeo usando modelos ByteDance por meio de uma API com base em um prompt de texto. Você fornece um prompt e escolhe configurações como modelo, resolução, proporção de aspecto e duração; o nó envia a solicitação de geração e retorna o vídeo gerado. ## Entradas | Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | |-----------|-------------|-----------|----------|-------| -| `model` | O modelo da ByteDance a ser usado para a geração. | STRING | Sim | - - "seedance-1-5-pro-251215" - - "seedance-1-0-pro-250528" - - "seedance-1-0-pro-fast-251015" | -| `prompt` | O prompt de texto usado para gerar o vídeo. | STRING | Sim | Entrada de texto multilinha | -| `resolution` | A resolução do vídeo de saída. | STRING | Sim | - - "480p" - - "720p" - - "1080p" | -| `aspect_ratio` | A proporção de aspecto do vídeo de saída. | STRING | Sim | - - "16:9" - - "4:3" - - "1:1" - - "3:4" - - "9:16" - - "21:9" | -| `duration` | A duração do vídeo de saída em segundos. | INT | Sim | 3 a 12 segundos | -| `seed` | Semente a ser usada para a geração. | INT | Não | 0 a 2,147,483,647 | -| `camera_fixed` | Especifica se a câmera deve ser fixada. | BOOLEAN | Não | - | -| `watermark` | Se deve ser adicionado um selo "Gerado por IA" ao vídeo. | BOOLEAN | Não | - | -| `generate_audio` | Este parâmetro é ignorado para qualquer modelo exceto `seedance-1-5-pro-251215`. | BOOLEAN | Não | - | - -**Restrições do Parâmetro:** - -- O `prompt` deve conter pelo menos 1 caractere após a remoção de espaços em branco. -- O `prompt` não pode conter os seguintes parâmetros de texto: "resolution", "ratio", "duration", "seed", "camerafixed", "watermark". -- A `duration` é limitada a valores entre 3 e 12 segundos. -- Para o modelo `seedance-1-5-pro-251215`, a duração mínima suportada é de 4 segundos. -- O `seed` aceita valores de 0 a 2,147,483,647. -- O parâmetro `generate_audio` tem efeito apenas quando o `model` é configurado para `seedance-1-5-pro-251215`; ele é ignorado para todos os outros modelos. +| `model` | O modelo ByteDance usado para gerar o vídeo (padrão: `"seedance-1-0-pro-fast-251015"`). | COMBO | Sim | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | +| `prompt` | O prompt de texto usado para gerar o vídeo. | STRING | Sim | - | +| `resolution` | A resolução do vídeo de saída. | COMBO | Sim | `"480p"`
`"720p"`
`"1080p"` | +| `aspect_ratio` | A proporção de aspecto do vídeo de saída. | COMBO | Sim | `"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `duration` | A duração do vídeo de saída em segundos (padrão: 5). | INT | Sim | 3 a 12 | +| `seed` | Semente a ser usada para a geração (padrão: 0). | INT | Não | 0 a 2147483647 | +| `camera_fixed` | Especifica se a câmera deve ser fixada. A plataforma acrescenta uma instrução para fixar a câmera ao seu prompt, mas não garante o efeito real (padrão: False). | BOOLEAN | Não | - | +| `watermark` | Se deve adicionar uma marca d'água "gerado por IA" ao vídeo (padrão: False). | BOOLEAN | Não | - | +| `generate_audio` | Este parâmetro é ignorado para qualquer modelo, exceto `seedance-1-5-pro-251215` (padrão: False). | BOOLEAN | Não | - | + +**Restrições dos Parâmetros:** + +- O parâmetro `prompt` deve conter pelo menos 1 caractere após a remoção de espaços em branco. +- O parâmetro `prompt` não pode conter os seguintes parâmetros de texto: "resolution", "ratio", "duration", "seed", "camerafixed", "watermark". +- O nó constrói o prompt final acrescentando as configurações selecionadas de `resolution`, `aspect_ratio`, `duration`, `seed`, `camera_fixed` e `watermark` ao texto do prompt. +- O parâmetro `duration` é limitado a valores entre 3 e 12 segundos. Para o modelo `seedance-1-5-pro-251215`, a duração mínima suportada é de 4 segundos. +- O parâmetro `seed` aceita valores de 0 a 2.147.483.647. +- O parâmetro `generate_audio` só tem efeito quando o `model` está definido como `seedance-1-5-pro-251215`; ele é ignorado para todos os outros modelos. ## Saídas | Nome da Saída | Descrição | Tipo de Dados | |-------------|-------------|-----------| -| `output` | O arquivo de vídeo gerado. | VIDEO | +| `output` | O arquivo de vídeo gerado | 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/ByteDanceTextToVideoNode/pt-BR.md) diff --git a/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/ru.md b/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/ru.md index 6a23b926a..8796fae53 100644 --- a/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/ru.md +++ b/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/ru.md @@ -1,55 +1,35 @@ # ByteDance Текст в Видео -# Узел Text to Video от ByteDance - -Узел Text to Video от ByteDance генерирует видео с использованием моделей ByteDance через API на основе текстовых подсказок. Он принимает текстовое описание и различные параметры видео в качестве входных данных, затем создает видео, соответствующее предоставленным спецификациям. Узел обрабатывает коммуникацию с API и возвращает сгенерированное видео в качестве выходных данных. - -## Обзор - -Узел Text to Video от ByteDance предназначен для преобразования текстовых подсказок в видео с использованием возможностей AI от ByteDance. Пользователи могут specify the model, resolution, aspect ratio, duration, и другие параметры для управления процессом генерации видео. +Узел ByteDance Text to Video генерирует видео с использованием моделей ByteDance через API на основе текстового запроса. Вы предоставляете текстовый запрос и выбираете такие настройки, как модель, разрешение, соотношение сторон и длительность; узел отправляет запрос на генерацию и возвращает сгенерированное видео. ## Входы | Параметр | Описание | Тип данных | Обязателен | Диапазон | |-----------|-------------|-----------|----------|-------| -| `модель` | Модель ByteDance, которую использовать для генерации. | STRING | Да | - - "seedance-1-5-pro-251215" - - "seedance-1-0-pro-250528" - - "seedance-1-0-pro-fast-251015" | -| `промпт` | Текстовая подсказка, используемая для генерации видео. | STRING | Да | Multiline text input | -| `разрешение` | Разрешение выходного видео. | STRING | Да | - - "480p" - - "720p" - - "1080p" | -| `соотношение_сторон` | Соотношение сторон выходного видео. | STRING | Да | - - "16:9" - - "4:3" - - "1:1" - - "3:4" - - "9:16" - - "21:9" | -| `длительность` | Продолжительность выходного видео в секундах. | INT | Да | 3 до 12 секунд | -| `сид` | Seed для использования при генерации. | INT | Нет | 0 до 2,147,483,647 | -| `камера_зафиксирована` | Указывает, следует ли фиксировать камеру. | BOOLEAN | Нет | - | -| `водяной_знак` | Указывает, следует ли добавить водяной знак "AI generated" на видео. | BOOLEAN | Нет | - | -| `generate_audio` | Этот параметр игнорируется для всех моделей, кроме `seedance-1-5-pro-251215`. | BOOLEAN | Нет | - | +| `модель` | Модель ByteDance, используемая для генерации видео (по умолчанию: `"seedance-1-0-pro-fast-251015"`). | COMBO | Да | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | +| `промпт` | Текстовый запрос, используемый для генерации видео. | STRING | Да | - | +| `разрешение` | Разрешение выходного видео. | COMBO | Да | `"480p"`
`"720p"`
`"1080p"` | +| `соотношение_сторон` | Соотношение сторон выходного видео. | COMBO | Да | `"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `длительность` | Длительность выходного видео в секундах (по умолчанию: 5). | INT | Да | от 3 до 12 | +| `сид` | Сид, используемый для генерации (по умолчанию: 0). | INT | Нет | от 0 до 2 147 483 647 | +| `камера_зафиксирована` | Указывает, нужно ли фиксировать камеру. Платформа добавляет к запросу инструкцию о фиксации камеры, но не гарантирует фактический результат (по умолчанию: False). | BOOLEAN | Нет | - | +| `водяной_знак` | Нужно ли добавлять на видео водяной знак «AI generated» (по умолчанию: False). | BOOLEAN | Нет | - | +| `generate_audio` | Этот параметр игнорируется для всех моделей, кроме `seedance-1-5-pro-251215` (по умолчанию: False). | BOOLEAN | Нет | - | **Ограничения параметров:** -- Подсказка `prompt` должна содержать по крайней мере 1 символ после удаления пробелов. -- Подсказка `prompt` не может содержать следующих текстовых параметров: "resolution", "ratio", "duration", "seed", "camerafixed", "watermark". -- Продолжительность `duration` ограничена значениями между 3 и 12 секунд. -- Для модели `seedance-1-5-pro-251215` минимальная поддерживаемая продолжительность составляет 4 секунды. -- Параметр `seed` принимает значения от 0 до 2,147,483,647. -- Параметр `generate_audio` имеет эффект только при установке `model` в `seedance-1-5-pro-251215`; он игнорируется для всех других моделей. +- Параметр `prompt` должен содержать не менее 1 символа после удаления пробельных символов. +- Параметр `prompt` не может содержать следующие текстовые параметры: "resolution", "ratio", "duration", "seed", "camerafixed", "watermark". +- Узел формирует итоговый текстовый запрос, добавляя к исходному тексту запроса выбранные значения параметров `resolution`, `aspect_ratio`, `duration`, `seed`, `camera_fixed` и `watermark`. +- Параметр `duration` ограничен значениями от 3 до 12 секунд. Для модели `seedance-1-5-pro-251215` минимальная поддерживаемая длительность составляет 4 секунды. +- Параметр `seed` принимает значения от 0 до 2 147 483 647. +- Параметр `generate_audio` действует только тогда, когда для параметра `model` установлено значение `seedance-1-5-pro-251215`; для всех остальных моделей он игнорируется. ## Выходы -| Название выходного параметра | Описание | Тип данных | +| Имя выхода | Описание | Тип данных | |-------------|-------------|-----------| -| `output` | Сгенерированный файл видео. | VIDEO | - -**Примечание:** Узел Text to Video от ByteDance является узлом API и требует токенов аутентификации и ключей API для правильной работы. Эти данные предоставляются через скрытые входы `auth_token_comfy_org` и `api_key_comfy_org`. +| `output` | Сгенерированный видеофайл | VIDEO | > Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/ru.md) diff --git a/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/tr.md b/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/tr.md index 2a1a313da..1ef0e1adc 100644 --- a/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/tr.md +++ b/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/tr.md @@ -1,51 +1,35 @@ # ByteDance Metinden Videoya -ByteDance Metinten Video Düğümü, metin ipuçlarına dayalı olarak ByteDance modellerini kullanarak bir API üzerinden videolar oluşturur. Bir metin açıklaması ve çeşitli video ayarları alır, ardından sağlanan spesifikasyonlara uygun bir video oluşturur. Düğüm API iletişimini yönetir ve oluşturulan videoyu çıktı olarak döndürür. - -## Genel Bakış - -ByteDance Metinten Video Düğümü, metin ipuçlarını ByteDance'nin AI yetenekleri kullanarak videolara dönüştürmek için tasarlanmıştır. Kullanıcılar model, çözünürlük, en boy oranı, sürekli ve diğer parametreleri belirleyerek video oluşturma sürecini kontrol edebilir. +ByteDance Text to Video düğümü, ByteDance modellerini kullanarak bir API aracılığıyla metin istemine dayalı bir video oluşturur. Bir istem sağlarsınız ve model, çözünürlük, en boy oranı ve süre gibi ayarları seçersiniz; düğüm, üretim isteğini gönderir ve oluşturulan videoyu döndürür. ## Girdiler | Parametre | Açıklama | Veri Türü | Gerekli | Aralık | |-----------|-------------|-----------|----------|-------| -| `model` | Kullanılacak ByteDance modeli. | STRING | Evet | - - "seedance-1-5-pro-251215" - - "seedance-1-0-pro-250528" - - "seedance-1-0-pro-fast-251015" | -| `prompt` | Videonun oluşturulmasında kullanılacak metin ipuçları. | STRING | Evet | Çok satırlı metin girdisi | -| `çözünürlük` | Çıktı videonun çözünürlüğü. | STRING | Evet | - - "480p" - - "720p" - - "1080p" | -| `en_boy_oranı` | Çıktı videonun en boy oranı. | STRING | Evet | - - "16:9" - - "4:3" - - "1:1" - - "3:4" - - "9:16" - - "21:9" | -| `süre` | Çıktı videonun süresi saniye cinsinden. | INT | Evet | 3 ila 12 saniye | -| `tohum` | Kullanılacak semptom. | INT | Hayır | 0 ila 2,147,483,647 | -| `sabit_kamera` | Kamerayı sabitlemeyi belirtir. | BOOLEAN | Hayır | - | -| `filigran` | Videoya "AI oluşturuldu" su izi eklemeyi belirtir. | BOOLEAN | Hayır | - | -| `ses_oluştur` | Bu parametre, `seedance-1-5-pro-251215` modeli dışındaki tüm modeller için göz ardı edilir. | BOOLEAN | Hayır | - | +| `model` | Videoyu oluşturmak için kullanılan ByteDance modeli (varsayılan: `"seedance-1-0-pro-fast-251015"`). | COMBO | Evet | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | +| `prompt` | Videoyu oluşturmak için kullanılan metin istemi. | STRING | Evet | - | +| `çözünürlük` | Çıktı videosunun çözünürlüğü. | COMBO | Evet | `"480p"`
`"720p"`
`"1080p"` | +| `en_boy_oranı` | Çıktı videosunun en boy oranı. | COMBO | Evet | `"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `süre` | Çıktı videosunun süresi (saniye cinsinden) (varsayılan: 5). | INT | Evet | 3 ila 12 | +| `tohum` | Üretim için kullanılacak tohum (varsayılan: 0). | INT | Hayır | 0 ila 2147483647 | +| `sabit_kamera` | Kameranın sabitlenip sabitlenmeyeceğini belirtir. Platform, isteminize kamerayı sabitlemek için bir talimat ekler ancak gerçek etkiyi garanti etmez (varsayılan: False). | BOOLEAN | Hayır | - | +| `filigran` | Videoya "AI generated" filigranı eklenip eklenmeyeceğini belirtir (varsayılan: False). | BOOLEAN | Hayır | - | +| `ses_oluştur` | Bu parametre, `seedance-1-5-pro-251215` dışındaki tüm modeller için yok sayılır (varsayılan: False). | BOOLEAN | Hayır | - | **Parametre Kısıtlamaları:** -- `prompt`, boşluk karakterlerinden arındırıldıktan sonra en az 1 karakter içermelidir. -- `prompt`, "resolution", "ratio", "duration", "seed", "camerafixed", "watermark" gibi metin parametrelerini içemez. -- `duration`, 3 ve 12 saniye arasında değerler alabilir. -- `seedance-1-5-pro-251215` modeli için en düşük desteklenen süre 4 saniyedir. -- `seed`, 0 ila 2,147,483,647 arasında değerleri kabul eder. -- `generate_audio` parametresi, `model` `seedance-1-5-pro-251215` olarak ayarlandığında etkili olur; diğer tüm modeller için göz ardı edilir. +- `prompt` parametresi, boşluk karakterleri kaldırıldıktan sonra en az 1 karakter içermelidir. +- `prompt` parametresi şu metin parametrelerini içeremez: "resolution", "ratio", "duration", "seed", "camerafixed", "watermark". +- Düğüm, son istemi, seçilen `resolution`, `aspect_ratio`, `duration`, `seed`, `camera_fixed` ve `watermark` ayarlarını istem metnine ekleyerek oluşturur. +- `duration` parametresi 3 ila 12 saniye arasındaki değerlerle sınırlıdır. `seedance-1-5-pro-251215` modeli için desteklenen minimum süre 4 saniyedir. +- `seed` parametresi 0 ile 2,147,483,647 arasındaki değerleri kabul eder. +- `generate_audio` parametresi yalnızca `model` `seedance-1-5-pro-251215` olarak ayarlandığında etkilidir; diğer tüm modellerde yok sayılır. ## Çıktılar | Çıktı Adı | Açıklama | Veri Türü | |-------------|-------------|-----------| -| `output` | Oluşturulan video dosyası. | VIDEO | +| `output` | Oluşturulan video dosyası | 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/ByteDanceTextToVideoNode/tr.md) diff --git a/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/zh-TW.md b/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/zh-TW.md index 1f23d5e1f..4d434b4a5 100644 --- a/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/zh-TW.md +++ b/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/zh-TW.md @@ -1,55 +1,35 @@ # 字節跳動文字轉影片 -# ByteDance 文本轉視頻節點 - -ByteDance 文本轉視頻節點透過基於文本提示的 API 使用 ByteDance 模型生成視頻。它接受文本描述和各種視頻設定作為輸入,然後創建符合提供規格的視頻。此節點處理 API 通訊並將生成的視頻作為輸出返回。 - -## 概述 - -ByteDance 文本轉視頻節點設計用於將文本提示轉換為視頻,利用 ByteDance 的 AI 能力。用戶可以指定模型、解析度、畫面比例、持續時間和其他參數以控制視頻生成過程。 +ByteDance Text to Video 節點會透過 API 使用 ByteDance 模型,根據文字提示生成影片。您可提供提示詞,並選擇模型、解析度、長寬比與時長等設定;節點會提交生成請求,並傳回生成的影片。 ## 輸入 -| 參數 | 描述 | 資料類型 | 必需 | 范圍 | +| 參數 | 說明 | 資料類型 | 必填 | 範圍 | |-----------|-------------|-----------|----------|-------| -| `模型` | 使用於生成的 ByteDance 模型。 | STRING | 是 | - - "seedance-1-5-pro-251215" - - "seedance-1-0-pro-250528" - - "seedance-1-0-pro-fast-251015" | -| `提示詞` | 用於生成視頻的文本提示。 | STRING | 是 | 多行文本輸入 | -| `解析度` | 輸出視頻的解析度。 | STRING | 是 | - - "480p" - - "720p" - - "1080p" | -| `長寬比` | 輸出視頻的畫面比例。 | STRING | 是 | - - "16:9" - - "4:3" - - "1:1" - - "3:4" - - "9:16" - - "21:9" | -| `持續時間` | 輸出視頻的持續時間(秒)。 | INT | 是 | 3 到 12 秒 | -| `種子值` | 用於生成的種子。 | INT | 否 | 0 到 2,147,483,647 | -| `固定攝影機` | 指定是否固定攝影機。 | BOOLEAN | 否 | - | -| `浮水印` | 是否在視頻中添加 "AI generated" 水印。 | BOOLEAN | 否 | - | -| `generate_audio` | 此參數對除 `seedance-1-5-pro-251215` 模型以外的任何模型都無效。 | BOOLEAN | 否 | - | +| `模型` | 用於生成影片的 ByteDance 模型(預設:`"seedance-1-0-pro-fast-251015"`)。 | COMBO | 是 | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | +| `提示詞` | 用於生成影片的文字提示。 | STRING | 是 | - | +| `解析度` | 輸出影片的解析度。 | COMBO | 是 | `"480p"`
`"720p"`
`"1080p"` | +| `長寬比` | 輸出影片的長寬比。 | COMBO | 是 | `"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `持續時間` | 輸出影片的時長(秒)(預設:5)。 | INT | 是 | 3至12 | +| `種子值` | 用於生成的種子(預設:0)。 | INT | 否 | 0至2147483647 | +| `固定攝影機` | 指定是否固定相機。平台會將固定相機的指令附加到您的提示詞,但不保證實際效果(預設:False)。 | BOOLEAN | 否 | - | +| `浮水印` | 是否在影片中加入「AI generated」浮水印(預設:False)。 | BOOLEAN | 否 | - | +| `generate_audio` | 除了 `seedance-1-5-pro-251215` 之外,此參數對任何模型皆會被忽略(預設:False)。 | BOOLEAN | 否 | - | **參數約束:** -- `prompt` 必須在去除空白後至少包含 1 個字符。 -- `prompt` 不可以包含以下文本參數:"resolution"、"ratio"、"duration"、"seed"、"camerafixed"、"watermark"。 -- `duration` 限制在 3 到 12 秒之間的值。 -- 對於 `seedance-1-5-pro-251215` 模型,最低支持的持續時間為 4 秒。 -- `seed` 接受從 0 到 2,147,483,647 的值。 -- `generate_audio` 參數只在 `model` 設置為 `seedance-1-5-pro-251215` 時有效;對於所有其他模型都會被忽略。 +- `prompt` 參數在移除空白字元後,必須至少包含 1 個字元。 +- `prompt` 參數不能包含下列文字參數:"resolution"、"ratio"、"duration"、"seed"、"camerafixed"、"watermark"。 +- 節點會將選定的 `resolution`、`aspect_ratio`、`duration`、`seed`、`camera_fixed` 與 `watermark` 設定附加到提示詞,以建構最終提示詞。 +- `duration` 參數限制在 3 到 12 秒之間。對於 `seedance-1-5-pro-251215` 模型,最小支援時長為 4 秒。 +- `seed` 參數接受 0 到 2,147,483,647 之間的值。 +- `generate_audio` 參數只有在 `model` 設定為 `seedance-1-5-pro-251215` 時才有效;對所有其他模型皆會被忽略。 ## 輸出 -| 輸出名稱 | 描述 | 資料類型 | -|-------------|-------------|-----------| -| `output` | 生成的視頻文件。 | VIDEO | - -**注意:** ByteDance 文本轉視頻節點是一個 API 節點,需要通過 `auth_token_comfy_org` 和 `api_key_comfy_org` 隱藏輸入來提供身份驗證令牌和 API 金鑰以正確運作。 +| 輸出名稱 | 說明 | 資料類型 | +|-----------|-------------|-----------| +| `output` | 生成的影片檔案 | VIDEO | > 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/zh-TW.md) diff --git a/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/zh.md b/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/zh.md index 7cee90b4a..1932166ec 100644 --- a/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/zh.md +++ b/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/zh.md @@ -1,51 +1,35 @@ # 字节跳动文生视频 -ByteDance 文本转视频节点通过基于文本提示的 API 使用 ByteDance 模型生成视频。它接受文本描述和多种视频设置作为输入,然后创建符合提供规格的视频。该节点处理 API 通信,并将生成的视频作为输出返回。 - -## 概述 - -ByteDance 文本转视频节点旨在利用 ByteDance 的 AI 能力将文本提示转换为视频。用户可以指定模型、分辨率、宽高比、时长以及其他参数,以控制视频生成过程。 +字节跳动文本转视频节点通过 API 基于文本提示词,使用字节跳动模型生成视频。您提供提示词并选择模型、分辨率、宽高比和时长等设置;该节点会提交生成请求并返回生成的视频。 ## 输入 -| 参数 | 描述 | 数据类型 | 必选 | 范围 | +| 参数 | 描述 | 数据类型 | 是否必需 | 取值范围 | |-----------|-------------|-----------|----------|-------| -| `模型` | 用于生成的 ByteDance 模型。 | STRING | 是 | - - "seedance-1-5-pro-251215" - - "seedance-1-0-pro-250528" - - "seedance-1-0-pro-fast-251015" | -| `提示` | 用于生成视频的文本提示。 | STRING | 是 | 多行文本输入 | -| `分辨率` | 输出视频的分辨率。 | STRING | 是 | - - "480p" - - "720p" - - "1080p" | -| `宽高比` | 输出视频的宽高比。 | STRING | 是 | - - "16:9" - - "4:3" - - "1:1" - - "3:4" - - "9:16" - - "21:9" | -| `时长` | 输出视频的时长(秒)。 | INT | 是 | 3 到 12 秒 | -| `种子` | 用于生成的种子。 | INT | 否 | 0 到 2,147,483,647 | -| `固定相机` | 指定是否固定相机。 | BOOLEAN | 否 | - | -| `水印` | 是否在视频上添加“AI生成”水印。 | BOOLEAN | 否 | - | -| `generate_audio` | 此参数除 `seedance-1-5-pro-251215` 模型外均被忽略。 | BOOLEAN | 否 | - | +| `模型` | 用于生成视频的字节跳动模型(默认值:`"seedance-1-0-pro-fast-251015"`)。 | COMBO | 是 | `"seedance-1-5-pro-251215"`
`"seedance-1-0-pro-250528"`
`"seedance-1-0-pro-fast-251015"` | +| `提示` | 用于生成视频的文本提示词。 | STRING | 是 | - | +| `分辨率` | 输出视频的分辨率。 | COMBO | 是 | `"480p"`
`"720p"`
`"1080p"` | +| `宽高比` | 输出视频的宽高比。 | COMBO | 是 | `"16:9"`
`"4:3"`
`"1:1"`
`"3:4"`
`"9:16"`
`"21:9"` | +| `时长` | 输出视频的时长(秒,默认值:5)。 | INT | 是 | 3到12 | +| `种子` | 用于生成视频的种子值(默认值:0)。 | INT | 否 | 0到2147483647 | +| `固定相机` | 指定是否固定镜头。平台会向您的提示词附加一条固定镜头的指令,但不保证实际效果(默认值:False)。 | BOOLEAN | 否 | - | +| `水印` | 是否为视频添加“AI 生成”水印(默认值:False)。 | BOOLEAN | 否 | - | +| `generate_audio` | 此参数对除 `seedance-1-5-pro-251215` 之外的任何模型都会忽略(默认值:False)。 | BOOLEAN | 否 | - | **参数约束:** -- `prompt` 必须在去除空白后至少包含 1 个字符。 -- `prompt` 不能包含以下文本参数:“resolution”、“ratio”、“duration”、“seed”、“camerafixed”、“watermark”。 -- `duration` 限制在 3 到 12 秒之间。 -- 对于 `seedance-1-5-pro-251215` 模型,最小支持的时长为 4 秒。 -- `seed` 接受从 0 到 2,147,483,647 的值。 -- `generate_audio` 参数仅在 `model` 设置为 `seedance-1-5-pro-251215` 时有效;对于其他所有模型均被忽略。 +- `prompt` 参数在去除空格后必须至少包含 1 个字符。 +- `prompt` 参数不能包含以下文本参数:“resolution”、“ratio”、“duration”、“seed”、“camerafixed”、“watermark”。 +- 节点会将所选 `resolution`、`aspect_ratio`、`duration`、`seed`、`camera_fixed` 和 `watermark` 设置附加到提示词文本之后,从而构建最终提示词。 +- `duration` 参数限制为 3到12 秒之间的值。对于 `seedance-1-5-pro-251215` 模型,支持的最短时长为 4 秒。 +- `seed` 参数接受从 0到2,147,483,647 的值。 +- `generate_audio` 参数仅在 `model` 设置为 `seedance-1-5-pro-251215` 时生效;对于所有其他模型,该参数会被忽略。 ## 输出 -| 输出名称 | 描述 | 数据类型 | +| 输出名 | 描述 | 数据类型 | |-------------|-------------|-----------| -| `output` | 生成的视频文件。 | 视频 | +| `output` | 生成的视频文件 | VIDEO | > 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDanceTextToVideoNode/zh.md) diff --git a/comfyui_embedded_docs/docs/ImageColorSpace/es.md b/comfyui_embedded_docs/docs/ImageColorSpace/es.md index e5ecf9d5c..ff7383e0c 100644 --- a/comfyui_embedded_docs/docs/ImageColorSpace/es.md +++ b/comfyui_embedded_docs/docs/ImageColorSpace/es.md @@ -8,7 +8,7 @@ El nodo ImageColorSpace convierte imágenes entre diferentes espacios de color, | Parámetro | Descripción | Tipo de datos | Requerido | Rango | |-----------|-------------|-----------|----------|-------| -| `image` | La imagen de entrada que debe ser convertida. | IMAGEN | Sí | Cualquier formato de imagen válido. | +| `image` | La imagen de entrada que debe ser convertida. | IMAGE | Sí | Cualquier formato de imagen válido. | | `source` | El espacio de color de los píxeles de entrada. | COMBO | Sí |
"sRGB"
"HDR"
"HDR PQ" | | `destination` | El espacio de color de los píxeles de salida. | COMBO | Sí |
"sRGB"
"HDR"
"HDR PQ" | @@ -16,7 +16,7 @@ El nodo ImageColorSpace convierte imágenes entre diferentes espacios de color, | Nombre de salida | Descripción | Tipo de datos | |-------------|-------------|-----------| -| `image` | La imagen convertida en el espacio de color de salida especificado. | IMAGEN | +| `image` | La imagen convertida en el espacio de color de salida especificado. | IMAGE | ## Notas diff --git a/comfyui_embedded_docs/docs/ImageColorSpace/ja.md b/comfyui_embedded_docs/docs/ImageColorSpace/ja.md index b30765c28..7e6451277 100644 --- a/comfyui_embedded_docs/docs/ImageColorSpace/ja.md +++ b/comfyui_embedded_docs/docs/ImageColorSpace/ja.md @@ -6,9 +6,9 @@ ImageColorSpace ノードは、sRGB、HDR(Rec.2020 HLG)、HDR PQ(Rec.2020 ## 入力 -| パラメータ | 説明 | データ型 | 必須 | 范囲 | +| パラメータ | 説明 | データ型 | 必須 | 範囲 | |------------|------|----------|------|------| -| `image` | 変換する入力画像。 | 画像 | はい | すべての有効な画像形式。 | +| `image` | 変換する入力画像。 | IMAGE | はい | すべての有効な画像形式。 | | `source` | 入力ピクセルの色空間。 | コンボボックス | はい |
"sRGB"
"HDR"
"HDR PQ" | | `destination` | 出力ピクセルの色空間。 | コンボボックス | はい |
"sRGB"
"HDR"
"HDR PQ" | @@ -16,7 +16,7 @@ ImageColorSpace ノードは、sRGB、HDR(Rec.2020 HLG)、HDR PQ(Rec.2020 | 出力名 | 説明 | データ型 | |--------|------|----------| -| `image` | 指定された出力色空間での変換された画像。 | 画像 | +| `image` | 指定された出力色空間での変換された画像。 | IMAGE | ## ノート diff --git a/comfyui_embedded_docs/docs/ImageColorSpace/pt-BR.md b/comfyui_embedded_docs/docs/ImageColorSpace/pt-BR.md index 74b26b2fa..532b4d8a0 100644 --- a/comfyui_embedded_docs/docs/ImageColorSpace/pt-BR.md +++ b/comfyui_embedded_docs/docs/ImageColorSpace/pt-BR.md @@ -8,7 +8,7 @@ O nó ImageColorSpace converte imagens entre diferentes espaços de cores, inclu | Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | |-----------|-------------|-----------|----------|-------| -| `image` | A imagem de entrada a ser convertida. | IMAGEM | Sim | Qualquer formato de imagem válido. | +| `image` | A imagem de entrada a ser convertida. | IMAGE | Sim | Qualquer formato de imagem válido. | | `source` | O espaço de cores dos pixels de entrada. | COMBO | Sim |
"sRGB"
"HDR"
"HDR PQ" | | `destination` | O espaço de cores dos pixels de saída. | COMBO | Sim |
"sRGB"
"HDR"
"HDR PQ" | @@ -16,7 +16,7 @@ O nó ImageColorSpace converte imagens entre diferentes espaços de cores, inclu | Nome da Saída | Descrição | Tipo de Dados | |-------------|-------------|-----------| -| `image` | A imagem convertida no espaço de cores de saída especificado. | IMAGEM | +| `image` | A imagem convertida no espaço de cores de saída especificado. | IMAGE | ## Notas diff --git a/comfyui_embedded_docs/docs/ImageRGBToYUV/ar.md b/comfyui_embedded_docs/docs/ImageRGBToYUV/ar.md index 116715522..a7770a8e5 100644 --- a/comfyui_embedded_docs/docs/ImageRGBToYUV/ar.md +++ b/comfyui_embedded_docs/docs/ImageRGBToYUV/ar.md @@ -1,24 +1,22 @@ # تحويل الصورة من RGB إلى YUV -# تحويل صورة RGB إلى YUV - -يقوم العقد ImageRGBToYUV بتحويل مساحة الألوان من RGB إلى YUV. يستقبل صورة RGB كمدخل ويقوم بإنتاج ثلاث صور منفصلة تمثل قنوات YUV: Y (الإضاءة)، U (الفرق في اللون الأزرق)، وV (الفرق في اللون الأحمر). +تقوم عقدة ImageRGBToYUV بتحويل صورة RGB إلى فضاء الألوان YUV. وتقسم الصورة إلى ثلاثة مكوّنات — Y (الإضاءة، أو السطوع)، U (مكوّن الفرق اللوني للأزرق)، و V (مكوّن الفرق اللوني للأحمر) — وتُرجِع كل مكوّن كصورة منفصلة بنفس حجم الصورة المدخلة. ## المدخلات -| المعامل | الوصف | نوع البيانات | إلزامي | نطاق | +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | |-----------|-------------|-----------|----------|-------| -| `الصورة` | الصورة RGB التي سيتم تحويلها إلى مساحة الألوان YUV. يجب أن تكون هذه الصورة ذات ثلاثة قنوات. | صورة | نعم | - | +| `الصورة` | الصورة المدخلة بصيغة RGB لتحويلها إلى YUV. إذا كانت الصورة تحتوي على قناة ألفا، يتم استخدام القنوات الثلاث الأولى (RGB) فقط. | IMAGE | نعم | - | ## المخرجات | اسم المخرج | الوصف | نوع البيانات | |-------------|-------------|-----------| -| `Y` | القناة Y تمثل الإضاءة (الإشراق) للصورة. | صورة | -| `U` | القناة U تمثل مكون الفرق في اللون الأزرق. | صورة | -| `V` | القناة V تمثل مكون الفرق في اللون الأحمر. | صورة | +| `Y` | مكوّن الإضاءة (السطوع) في فضاء الألوان YUV | IMAGE | +| `U` | مكوّن الفرق اللوني للأزرق في فضاء الألوان YUV | IMAGE | +| `V` | مكوّن الفرق اللوني للأحمر في فضاء الألوان YUV | IMAGE | -ستكون أبعاد الصور المخرجة نفسها التي تكون لها الصورة المدخلة. +لكل مخرج نفس العرض والارتفاع وعدد القنوات الموجودة في الصورة المدخلة. يتم تكرار المكوّن المقابل Y أو U أو V عبر جميع القنوات بحيث يكون كل مخرج صورة قياسية. > تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ImageRGBToYUV/ar.md) diff --git a/comfyui_embedded_docs/docs/ImageRGBToYUV/en.md b/comfyui_embedded_docs/docs/ImageRGBToYUV/en.md index ad2e6f5b2..d2e5ecf8e 100644 --- a/comfyui_embedded_docs/docs/ImageRGBToYUV/en.md +++ b/comfyui_embedded_docs/docs/ImageRGBToYUV/en.md @@ -1,22 +1,22 @@ # Image RGB to YUV -The ImageRGBToYUV node performs a color space conversion from RGB to YUV. It takes an RGB image as input and outputs three separate images representing the YUV channels: Y (luminance), U (blue-difference), and V (red-difference). +The ImageRGBToYUV node converts an RGB image into the YUV color space. It splits the image into three components — Y (luminance, or brightness), U (blue-difference chroma), and V (red-difference chroma) — and returns each component as a separate image of the same size as the input. ## Inputs | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `image` | The input RGB image to be converted to YUV color space. This should be a 3-channel image. | IMAGE | Yes | - | +| `image` | The input RGB image to convert to YUV. If the image contains an alpha channel, only the first three (RGB) channels are used. | IMAGE | Yes | - | ## Outputs | Output Name | Description | Data Type | |-------------|-------------|-----------| -| `Y` | The Y channel represents the luminance (brightness) of the image. | IMAGE | -| `U` | The U channel represents the blue-difference chroma component. | IMAGE | -| `V` | The V channel represents the red-difference chroma component. | IMAGE | +| `Y` | The luminance (brightness) component of the YUV color space | IMAGE | +| `U` | The blue-difference chroma component of the YUV color space | IMAGE | +| `V` | The red-difference chroma component of the YUV color space | IMAGE | -The output images will have the same dimensions as the input image. +Each output has the same width, height, and number of channels as the input image. The corresponding Y, U, or V component is repeated across all channels so that every output is returned as a standard 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/ImageRGBToYUV/en.md) diff --git a/comfyui_embedded_docs/docs/ImageRGBToYUV/es.md b/comfyui_embedded_docs/docs/ImageRGBToYUV/es.md index e59a223e3..6fd95e1fb 100644 --- a/comfyui_embedded_docs/docs/ImageRGBToYUV/es.md +++ b/comfyui_embedded_docs/docs/ImageRGBToYUV/es.md @@ -1,24 +1,22 @@ # ImageRGBToYUV -# Conversión de Imagen RGB a YUV - -El nodo ImageRGBToYUV realiza una conversión de espacio de color desde RGB a YUV. Toma una imagen RGB como entrada y produce tres imágenes separadas que representan los canales YUV: Y (luminancia), U (diferencia de azul) y V (diferencia de rojo). +El nodo ImageRGBToYUV convierte una imagen RGB al espacio de color YUV. Divide la imagen en tres componentes — Y (luminancia o brillo), U (crominancia de diferencia de azul) y V (crominancia de diferencia de rojo) — y devuelve cada componente como una imagen separada del mismo tamaño que la imagen de entrada. ## Entradas -| Parámetro | Descripción | Tipo de Datos | Obligatorio | Rango | -|-----------|-------------|-----------|----------|-------| -| `imagen` | La imagen RGB de entrada que debe ser convertida al espacio de color YUV. Esta debe ser una imagen de 3 canales. | IMAGEN | Sí | - | +| Parámetro | Descripción | Tipo de datos | Requerido | Rango | +|-----------|-------------|---------------|-----------|-------| +| `imagen` | La imagen RGB de entrada que se convertirá a YUV. Si la imagen contiene un canal alfa, solo se utilizan los primeros tres canales (RGB). | IMAGE | Sí | - | ## Salidas -| Nombre de Salida | Descripción | Tipo de Datos | -|-------------|-------------|-----------| -| `Y` | El canal Y representa la luminancia (brillo) de la imagen. | IMAGEN | -| `U` | El canal U representa el componente de croma de diferencia de azul. | IMAGEN | -| `V` | El canal V representa el componente de croma de diferencia de rojo. | IMAGEN | +| Nombre de salida | Descripción | Tipo de datos | +|------------------|-------------|---------------| +| `Y` | El componente de luminancia (brillo) del espacio de color YUV. | IMAGE | +| `U` | El componente de crominancia de diferencia de azul del espacio de color YUV. | IMAGE | +| `V` | El componente de crominancia de diferencia de rojo del espacio de color YUV. | IMAGE | -Las imágenes de salida tendrán las mismas dimensiones que la imagen de entrada. +Cada salida tiene el mismo ancho, alto y número de canales que la imagen de entrada. El componente Y, U o V correspondiente se repite en todos los canales para que cada salida se devuelva como una imagen estándar. > 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/ImageRGBToYUV/es.md) diff --git a/comfyui_embedded_docs/docs/ImageRGBToYUV/fa.md b/comfyui_embedded_docs/docs/ImageRGBToYUV/fa.md index a9f6fa8c6..6dc5955d3 100644 --- a/comfyui_embedded_docs/docs/ImageRGBToYUV/fa.md +++ b/comfyui_embedded_docs/docs/ImageRGBToYUV/fa.md @@ -1,22 +1,22 @@ # تبدیل تصویر RGB به YUV -گره ImageRGBToYUV یک تبدیل فضای رنگی از RGB به YUV انجام می‌دهد. این گره یک تصویر RGB به عنوان ورودی می‌گیرد و سه تصویر جداگانه به عنوان کانال‌های YUV تولید می‌کند: Y (نورانی)، U (تفاوت آبی) و V (تفاوت قرمز). +گره ImageRGBToYUV یک تصویر RGB را به فضای رنگی YUV تبدیل می‌کند. این گره تصویر را به سه مؤلفه تقسیم می‌کند — Y (روشنایی یا درخشندگی)، U (رنگ‌مایه تفاضل آبی) و V (رنگ‌مایه تفاضل قرمز) — و هر مؤلفه را به‌صورت یک تصویر جداگانه با همان اندازه تصویر ورودی برمی‌گرداند. ## ورودی‌ها -| پارامتر | توضیح | نوع داده | الزامی | محدوده | +| پارامتر | توضیحات | نوع داده | الزامی | بازه | |-----------|-------------|-----------|----------|-------| -| `تصویر` | تصویر RGB ورودی که باید به فضای رنگی YUV تبدیل شود. این تصویر باید یک تصویر سه کاناله باشد. | IMAGE | بله | - | +| `تصویر` | تصویر RGB ورودی برای تبدیل به YUV. اگر تصویر شامل کانال آلفا باشد، فقط سه کانال اول (RGB) استفاده می‌شوند. | IMAGE | بله | - | ## خروجی‌ها -| نام خروجی | توضیح | نوع داده | +| نام خروجی | توضیحات | نوع داده | |-------------|-------------|-----------| -| `Y` | کانال Y نمایانگر نورانی‌گی (نورپردازی) تصویر است. | IMAGE | -| `U` | کانال U نمایانگر جزء آبی رنگ‌های تفاوت‌یافته است. | IMAGE | -| `V` | کانال V نمایانگر جزء قرمز رنگ‌های تفاوت‌یافته است. | IMAGE | +| `Y` | مؤلفه روشنایی (درخشندگی) فضای رنگی YUV | IMAGE | +| `U` | مؤلفه رنگ‌مایه تفاضل آبی فضای رنگی YUV | IMAGE | +| `V` | مؤلفه رنگ‌مایه تفاضل قرمز فضای رنگی YUV | IMAGE | -تصاویر خروجی دارای ابعاد مشابه تصویر ورودی خواهند بود. +هر خروجی همان عرض، ارتفاع و تعداد کانال تصویر ورودی را دارد. مؤلفه متناظر Y، U یا V در همه کانال‌ها تکرار می‌شود تا هر خروجی به‌صورت یک تصویر استاندارد برگردانده شود. > این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ImageRGBToYUV/fa.md) diff --git a/comfyui_embedded_docs/docs/ImageRGBToYUV/fr.md b/comfyui_embedded_docs/docs/ImageRGBToYUV/fr.md index 8ce20dab1..d01b29e34 100644 --- a/comfyui_embedded_docs/docs/ImageRGBToYUV/fr.md +++ b/comfyui_embedded_docs/docs/ImageRGBToYUV/fr.md @@ -1,24 +1,22 @@ # ImageRGBToYUV -# Image RGB vers YUV - -Le nœud ImageRGBToYUV effectue une conversion de l'espace de couleur RGB vers YUV. Il prend une image RGB en entrée et produit trois images séparées représentant les canaux YUV : Y (luminance), U (différence bleue) et V (différence rouge). +Le nœud ImageRGBToYUV convertit une image RVB dans l’espace colorimétrique YUV. Il décompose l’image en trois composantes — Y (luminance, ou luminosité), U (chrominance de différence bleue) et V (chrominance de différence rouge) — et renvoie chaque composante sous forme d’image distincte, de même taille que l’image d’entrée. ## Entrées -| Paramètre | Description | Type de données | Obligatoire | Gamme | -|-----------|-------------|----------------|--------------|-------| -| `image` | L'image RGB en entrée à convertir en espace de couleur YUV. Cette image doit être à trois canaux. | IMAGE | Oui | - | +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `image` | L’image RVB d’entrée à convertir en YUV. Si l’image contient un canal alpha, seuls les trois premiers canaux (RVB) sont utilisés. | IMAGE | Oui | - | ## Sorties | Nom de sortie | Description | Type de données | -|---------------|-------------|-----------------| -| `Y` | Le canal Y représente la luminance (luminosité) de l'image. | IMAGE | -| `U` | Le canal U représente le composant chroma de différence bleue. | IMAGE | -| `V` | Le canal V représente le composant chroma de différence rouge. | IMAGE | +|-------------|-------------|-----------------| +| `Y` | La composante de luminance (luminosité) de l’espace colorimétrique YUV | IMAGE | +| `U` | La composante de chrominance de différence bleue de l’espace colorimétrique YUV | IMAGE | +| `V` | La composante de chrominance de différence rouge de l’espace colorimétrique YUV | IMAGE | -Les images de sortie auront les mêmes dimensions que l'image d'entrée. +Chaque sortie a la même largeur, la même hauteur et le même nombre de canaux que l’image d’entrée. La composante correspondante Y, U ou V est répétée sur tous les canaux afin que chaque sortie soit renvoyée sous forme d’image standard. > 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/ImageRGBToYUV/fr.md) diff --git a/comfyui_embedded_docs/docs/ImageRGBToYUV/ja.md b/comfyui_embedded_docs/docs/ImageRGBToYUV/ja.md index 8caadc6ba..59df9a85b 100644 --- a/comfyui_embedded_docs/docs/ImageRGBToYUV/ja.md +++ b/comfyui_embedded_docs/docs/ImageRGBToYUV/ja.md @@ -1,24 +1,22 @@ # ImageRGBToYUV -# Image RGB to YUV - -ImageRGBToYUV ノードは、RGBからYUVへの色空間変換を行います。RGB画像を入力として取り、YUVチャンネルを表す3つの別々の画像を出力します:Y(輝度)、U(青色差)、V(赤色差)。 +ImageRGBToYUV ノードは、RGB 画像を YUV 色空間に変換します。画像を 3 つのコンポーネント(Y(輝度・明るさ)、U(青の色差クロマ)、V(赤の色差クロマ))に分割し、各コンポーネントを入力と同じサイズの独立した画像として返します。 ## 入力 -| パラメータ | 説明 | データ型 | 必須 | 范囲 | -|------------|------|----------|------|-------| -| `画像` | YUV色空間に変換する入力RGB画像です。これは3チャンネルの画像でなければなりません。 | 画像 | はい | - | +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `画像` | YUV に変換する入力 RGB 画像です。画像にアルファチャンネルが含まれる場合、最初の3つのチャンネル(RGB)のみが使用されます。 | IMAGE | はい | - | ## 出力 | 出力名 | 説明 | データ型 | -|--------|------|----------| -| `Y` | 画像の輝度(明るさ)を表すYチャンネルです。 | 画像 | -| `U` | 青色差の色成分を表すUチャンネルです。 | 画像 | -| `V` | 赤色差の色成分を表すVチャンネルです。 | 画像 | +|-------------|-------------|-----------| +| `Y` | YUV 色空間の輝度(明るさ)コンポーネント | IMAGE | +| `U` | YUV 色空間の青の色差クロマコンポーネント | IMAGE | +| `V` | YUV 色空間の赤の色差クロマコンポーネント | IMAGE | -出力画像は入力画像と同じサイズになります。 +各出力は、入力画像と同じ幅、高さ、チャンネル数を持ちます。対応する Y、U、V コンポーネントがすべてのチャンネルに繰り返し配置されるため、すべての出力が標準的な画像として返されます。 > このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ImageRGBToYUV/ja.md) diff --git a/comfyui_embedded_docs/docs/ImageRGBToYUV/ko.md b/comfyui_embedded_docs/docs/ImageRGBToYUV/ko.md index da3def72c..0b05841ea 100644 --- a/comfyui_embedded_docs/docs/ImageRGBToYUV/ko.md +++ b/comfyui_embedded_docs/docs/ImageRGBToYUV/ko.md @@ -1,24 +1,22 @@ # ImageRGBToYUV -# 이미지 RGB to YUV - -ImageRGBToYUV 노드는 RGB에서 YUV 색 공간으로의 색 공간 변환을 수행합니다. RGB 이미지를 입력으로 받아 YUV 채널을 나타내는 세 개의 별도의 이미지를 출력합니다: Y (명도), U (파란색 차이), V (빨간색 차이). +ImageRGBToYUV 노드는 RGB 이미지를 YUV 색 공간으로 변환합니다. 이미지를 Y(휘도, 즉 밝기), U(청색 차분 색차), V(적색 차분 색차)의 세 가지 구성 요소로 분할하고, 각 구성 요소를 입력 이미지와 동일한 크기의 개별 이미지로 반환합니다. ## 입력 -| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +| 매개변수 | 설명 | 데이터 타입 | 필수 여부 | 범위 | |-----------|-------------|-----------|----------|-------| -| `이미지` | 변환할 RGB 이미지입니다. 이는 3 채널 이미지여야 합니다. | 이미지 | 예 | - | +| `이미지` | YUV로 변환할 입력 RGB 이미지입니다. 이미지에 알파 채널이 포함된 경우 처음 세 개(RGB) 채널만 사용됩니다. | IMAGE | 예 | - | ## 출력 | 출력 이름 | 설명 | 데이터 타입 | |-------------|-------------|-----------| -| `Y` | 이미지의 명도(밝기)를 나타냅니다. | 이미지 | -| `U` | 파란색 차이 색상 성분을 나타냅니다. | 이미지 | -| `V` | 빨간색 차이 색상 성분을 나타냅니다. | 이미지 | +| `Y` | YUV 색 공간의 휘도(밝기) 구성 요소 | IMAGE | +| `U` | YUV 색 공간의 청색 차분 색차 구성 요소 | IMAGE | +| `V` | YUV 색 공간의 적색 차분 색차 구성 요소 | IMAGE | -출력 이미지는 입력 이미지와 같은 크기를 가집니다. +각 출력은 입력 이미지와 동일한 너비, 높이 및 채널 수를 갖습니다. 해당 Y, U 또는 V 구성 요소가 모든 채널에 걸쳐 반복되므로 모든 출력이 표준 이미지로 반환됩니다. > 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ImageRGBToYUV/ko.md) diff --git a/comfyui_embedded_docs/docs/ImageRGBToYUV/pt-BR.md b/comfyui_embedded_docs/docs/ImageRGBToYUV/pt-BR.md index 480d6a484..4f7847910 100644 --- a/comfyui_embedded_docs/docs/ImageRGBToYUV/pt-BR.md +++ b/comfyui_embedded_docs/docs/ImageRGBToYUV/pt-BR.md @@ -1,24 +1,22 @@ # Converter RGB para YUV -# Imagem RGB para YUV - -O nó ImageRGBToYUV realiza uma conversão de espaço de cor de RGB para YUV. Ele recebe uma imagem RGB como entrada e gera três imagens separadas representando os canais YUV: Y (luminância), U (diferença de azul) e V (diferença de vermelho). +O nó ImageRGBToYUV converte uma imagem RGB para o espaço de cores YUV. Ele divide a imagem em três componentes — Y (luminância, ou brilho), U (croma de diferença de azul) e V (croma de diferença de vermelho) — e retorna cada componente como uma imagem separada, do mesmo tamanho da entrada. ## Entradas -| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Faixa | |-----------|-------------|-----------|----------|-------| -| `imagem` | A imagem RGB de entrada a ser convertida para o espaço de cor YUV. Esta deve ser uma imagem de 3 canais. | IMAGEM | Sim | - | +| `imagem` | A imagem RGB de entrada para converter em YUV. Se a imagem contiver um canal alfa, apenas os três primeiros canais (RGB) são usados. | IMAGE | Sim | - | ## Saídas | Nome da Saída | Descrição | Tipo de Dados | |-------------|-------------|-----------| -| `Y` | O canal Y representa a luminância (brilho) da imagem. | IMAGEM | -| `U` | O canal U representa o componente de croma de diferença de azul. | IMAGEM | -| `V` | O canal V representa o componente de croma de diferença de vermelho. | IMAGEM | +| `Y` | O componente de luminância (brilho) do espaço de cores YUV | IMAGE | +| `U` | O componente croma de diferença de azul do espaço de cores YUV | IMAGE | +| `V` | O componente croma de diferença de vermelho do espaço de cores YUV | IMAGE | -As imagens de saída terão as mesmas dimensões que a imagem de entrada. +Cada saída possui a mesma largura, altura e número de canais que a imagem de entrada. O componente Y, U ou V correspondente é repetido em todos os canais para que cada saída seja retornada como uma imagem padrão. > 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/ImageRGBToYUV/pt-BR.md) diff --git a/comfyui_embedded_docs/docs/ImageRGBToYUV/ru.md b/comfyui_embedded_docs/docs/ImageRGBToYUV/ru.md index 14690bbe0..202a5c9ee 100644 --- a/comfyui_embedded_docs/docs/ImageRGBToYUV/ru.md +++ b/comfyui_embedded_docs/docs/ImageRGBToYUV/ru.md @@ -1,24 +1,22 @@ # ImageRGBToYUV -# Изображение RGB в YUV - -Узел ImageRGBToYUV выполняет конверсию цветового пространства из RGB в YUV. Он принимает изображение RGB в качестве входа и outputs три отдельных изображения, представляющие каналы YUV: Y (луминанс), U (разность по синему) и V (разность по красному). +Узел ImageRGBToYUV преобразует RGB-изображение в цветовое пространство YUV. Он разделяет изображение на три компоненты — Y (яркость, luminance), U (синяя цветоразностная компонента) и V (красная цветоразностная компонента) — и возвращает каждую компоненту как отдельное изображение того же размера, что и входное. ## Входы -| Параметр | Описание | Тип данных | Обязателен | Диапазон | +| Параметр | Описание | Тип данных | Обязательность | Диапазон | |-----------|-------------|-----------|----------|-------| -| `изображение` | Входное изображение RGB, которое нужно преобразовать в цветовое пространство YUV. Это должно быть изображение с тремя каналами. | ИЗОБРАЖЕНИЕ | Да | - | +| `изображение` | Входное RGB-изображение для преобразования в YUV. Если изображение содержит альфа-канал, используются только первые три (RGB) канала. | IMAGE | Да | - | ## Выходы -| Название выхода | Описание | Тип данных | +| Имя выхода | Описание | Тип данных | |-------------|-------------|-----------| -| `Y` | Канал Y представляет луминанс (яркость) изображения. | ИЗОБРАЖЕНИЕ | -| `U` | Канал U представляет компонент разности по синему. | ИЗОБРАЖЕНИЕ | -| `V` | Канал V представляет компонент разности по красному. | ИЗОБРАЖЕНИЕ | +| `Y` | Яркостная компонента (яркость) цветового пространства YUV | IMAGE | +| `U` | Синяя цветоразностная компонента цветового пространства YUV | IMAGE | +| `V` | Красная цветоразностная компонента цветового пространства YUV | IMAGE | -Выходные изображения будут иметь те же размеры, что и входное изображение. +Каждый выход имеет ту же ширину, высоту и количество каналов, что и входное изображение. Соответствующая компонента Y, U или V повторяется по всем каналам, поэтому каждый выход возвращается в виде стандартного изображения. > Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ImageRGBToYUV/ru.md) diff --git a/comfyui_embedded_docs/docs/ImageRGBToYUV/tr.md b/comfyui_embedded_docs/docs/ImageRGBToYUV/tr.md index 99a450bef..22cd79ef7 100644 --- a/comfyui_embedded_docs/docs/ImageRGBToYUV/tr.md +++ b/comfyui_embedded_docs/docs/ImageRGBToYUV/tr.md @@ -1,22 +1,22 @@ # GörüntüRGB'denYUV'ye -ImageRGBToYUV düğümü, RGB renk alanından YUV renk alanına dönüşüm yapar. Bir RGB görüntü girdisini alır ve bu görüntüyü YUV renk alanına dönüştürerek üç ayrı görüntü çıktısı üretir: Y (parlaklık), U (mavi-farklılık) ve V (kırmızı-farklılık). +ImageRGBToYUV düğümü, bir RGB görüntüsünü YUV renk uzayına dönüştürür. Görüntüyü üç bileşene ayırır — Y (parlaklık), U (mavi-fark kroma) ve V (kırmızı-fark kroma) — ve her bileşeni, girdiyle aynı boyutta ayrı bir görüntü olarak döndürür. ## Girdiler | Parametre | Açıklama | Veri Türü | Gerekli | Aralık | |-----------|-----------|-----------|----------|-------| -| `görüntü` | Dönüştürülecek olan girdi RGB görüntüsü. Bu, 3 kanallı bir görüntü olmalıdır. | GÖRÜNTÜ | Evet | - | +| `görüntü` | YUV renk uzayına dönüştürülecek RGB girdi görüntüsü. Görüntü bir alfa kanalı içeriyorsa yalnızca ilk üç (RGB) kanal kullanılır. | IMAGE | Evet | - | ## Çıktılar | Çıktı Adı | Açıklama | Veri Türü | -|-----------|-----------|-----------| -| `Y` | Görüntünün Y kanalı, görüntünün parlaklığını (aydınlatma) temsil eder. | GÖRÜNTÜ | -| `U` | Görüntünün U kanalı, mavi-farklılık renk bileşenini temsil eder. | GÖRÜNTÜ | -| `V` | Görüntünün V kanalı, kırmızı-farklılık renk bileşenini temsil eder. | GÖRÜNTÜ | +|-------------|-------------|-----------| +| `Y` | YUV renk uzayının parlaklık bileşeni | IMAGE | +| `U` | YUV renk uzayının mavi-fark kroma bileşeni | IMAGE | +| `V` | YUV renk uzayının kırmızı-fark kroma bileşeni | IMAGE | -Çıktı görüntüleri, girdi görüntüsü ile aynı boyutlarda olacaktır. +Her çıktı, girdi görüntüsüyle aynı genişliğe, yüksekliğe ve kanal sayısına sahiptir. İlgili Y, U veya V bileşeni tüm kanallara kopyalanır; böylece her çıktı standart bir görüntü olarak döndürülür. > 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/ImageRGBToYUV/tr.md) diff --git a/comfyui_embedded_docs/docs/ImageRGBToYUV/zh-TW.md b/comfyui_embedded_docs/docs/ImageRGBToYUV/zh-TW.md index 4ebbde424..d885e6946 100644 --- a/comfyui_embedded_docs/docs/ImageRGBToYUV/zh-TW.md +++ b/comfyui_embedded_docs/docs/ImageRGBToYUV/zh-TW.md @@ -1,24 +1,22 @@ # RGB 轉 YUV -# 圖像 RGB 至 YUV 轉換 - -ImageRGBToYUV 節點進行從 RGB 至 YUV 的顏色空間轉換。它接受一個 RGB 圖像作為輸入,並輸出三個分開的圖像,分別代表 YUV 頻道:Y(亮度)、U(藍色差異)和 V(紅色差異)。 +ImageRGBToYUV 節點將 RGB 影像轉換為 YUV 色彩空間。它會將影像拆分為三個分量 — Y(亮度)、U(藍色色差色度)和 V(紅色色差色度)— 並將每個分量作為與輸入影像相同尺寸的獨立影像回傳。 ## 輸入 -| 參數 | 描述 | 資料類型 | 必需 | 范圍 | -|------|------|----------|------|-------| -| `影像` | 要轉換至 YUV 顏色空間的輸入 RGB 圖像。這應該是一個 3 個頻道的圖像。 | IMAGE | 是 | - | +| 參數 | 說明 | 資料型別 | 必填 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `影像` | 要轉換為 YUV 的輸入 RGB 影像。如果影像包含 alpha 通道,則只會使用前三個 (RGB) 通道。 | IMAGE | 是 | - | ## 輸出 -| 輸出名稱 | 描述 | 資料類型 | -|----------|------|-----------| -| `Y` | Y 頻道代表圖像的亮度(亮度)。 | IMAGE | -| `U` | U 頻道代表藍色差異色度組分。 | IMAGE | -| `V` | V 頻道代表紅色差異色度組分。 | IMAGE | +| 輸出名稱 | 說明 | 資料型別 | +|-------------|-------------|-----------| +| `Y` | YUV 色彩空間的亮度(明度)分量 | IMAGE | +| `U` | YUV 色彩空間的藍色色差色度分量 | IMAGE | +| `V` | YUV 色彩空間的紅色色差色度分量 | IMAGE | -輸出圖像將與輸入圖像具有相同的尺寸。 +每個輸出與輸入影像具有相同的寬度、高度和通道數量。對應的 Y、U 或 V 分量會重複到所有通道中,因此每個輸出都以標準影像形式回傳。 > 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ImageRGBToYUV/zh-TW.md) diff --git a/comfyui_embedded_docs/docs/ImageRGBToYUV/zh.md b/comfyui_embedded_docs/docs/ImageRGBToYUV/zh.md index 562a1f888..b11a6a038 100644 --- a/comfyui_embedded_docs/docs/ImageRGBToYUV/zh.md +++ b/comfyui_embedded_docs/docs/ImageRGBToYUV/zh.md @@ -1,24 +1,22 @@ # 图像RGB到YUV -# 图像 RGB 到 YUV 转换 - -ImageRGBToYUV 节点执行 RGB 到 YUV 的颜色空间转换。它接受一个 RGB 图像作为输入,并输出三个分别代表 YUV 通道的独立图像:Y(亮度)、U(蓝差色度)和 V(红差色度)。 +ImageRGBToYUV 节点将 RGB 图像转换到 YUV 颜色空间。它会将图像分解为三个分量——Y(亮度)、U(蓝色差色度)和 V(红色差色度)——并将每个分量作为与输入图像尺寸相同的独立图像返回。 ## 输入 -| 参数 | 描述 | 数据类型 | 必需 | 范围 | -|------|------|----------|------|------| -| `图像` | 要转换为 YUV 颜色空间的输入 RGB 图像。这应该是一个 3 通道图像。 | IMAGE | 是 | - | +| 参数 | 描述 | 数据类型 | 必填 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `图像` | 要转换为 YUV 的输入 RGB 图像。如果图像包含 alpha 通道,则仅使用前三个(RGB)通道。 | IMAGE | 是 | - | ## 输出 | 输出名称 | 描述 | 数据类型 | -|----------|------|----------| -| `Y` | Y 通道代表图像的亮度(亮度)。 | IMAGE | -| `U` | U 通道代表蓝差色度分量。 | IMAGE | -| `V` | V 通道代表红差色度分量。 | IMAGE | +|-------------|-------------|-----------| +| `Y` | YUV 颜色空间的亮度分量 | IMAGE | +| `U` | YUV 颜色空间的蓝色差色度分量 | IMAGE | +| `V` | YUV 颜色空间的红色差色度分量 | IMAGE | -输出图像将具有与输入图像相同的尺寸。 +每个输出的宽度、高度和通道数与输入图像一致。相应的 Y、U 或 V 分量会在所有通道中重复,因此每个输出都会以标准图像形式返回。 > 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ImageRGBToYUV/zh.md) diff --git a/comfyui_embedded_docs/docs/ImageYUVToRGB/ar.md b/comfyui_embedded_docs/docs/ImageYUVToRGB/ar.md index f34d443a5..2955971ff 100644 --- a/comfyui_embedded_docs/docs/ImageYUVToRGB/ar.md +++ b/comfyui_embedded_docs/docs/ImageYUVToRGB/ar.md @@ -1,28 +1,22 @@ # تحويل الصورة من YUV إلى RGB -يُصمم عقد ImageYUVToRGB لتحويل الصور من مساحة الألوان YUV إلى مساحة الألوان RGB. يقوم بذلك عن طريق أخذ ثلاثة صور إدخالية منفصلة تمثل القنوات Y (الإضاءة)، U (الفرق الأزرق)، وV (الفرق الأحمر) للصورة. ثم يتم دمج هذه القنوات في صورة RGB واحدة باستخدام تقنية تحويل مساحة الألوان. - -## نظرة عامة - -يقوم عقد ImageYUVToRGB بتحويل صور YUV إلى صور RGB عن طريق دمج القنوات Y، U، وV. هذا مفيد للعديد من التطبيقات التي تتطلب تحويل مساحة الألوان بين هذين المعياريين. +تقوم عقدة ImageYUVToRGB بتحويل الصور من مساحة الألوان YUV إلى مساحة الألوان RGB. تستقبل ثلاث صور إدخال منفصلة تمثل المكونات Y (الإضاءة)، وU (الإسقاط الأزرق)، وV (الإسقاط الأحمر)، وتجمعها في صورة RGB واحدة. ## المدخلات -| المعامل | الوصف | نوع البيانات | إلزامي | نطاق | -|-----------|-------------|-----------|----------|-------| -| `Y` | صورة القناة Y الإدخالية، تمثل معلومات الإضاءة. | صورة | نعم | - | -| `U` | صورة القناة U الإدخالية، تمثل الفرق الأزرق. | صورة | نعم | - | -| `V` | صورة القناة V الإدخالية، تمثل الفرق الأحمر. | صورة | نعم | - | +| المعامل | الوصف | نوع البيانات | إلزامي | النطاق | +| --- | --- | --- | --- | --- | +| `Y` | صورة الإدخال لمكوّن Y (الإضاءة) | IMAGE | نعم | - | +| `U` | صورة الإدخال لمكوّن U (الإسقاط الأزرق) | IMAGE | نعم | - | +| `V` | صورة الإدخال لمكوّن V (الإسقاط الأحمر) | IMAGE | نعم | - | -**ملاحظة:** يجب تقديم القنوات Y، U، وV معًا وأن تكون لها نفس الأبعاد لضمان تحويل صحيح. +**ملاحظة:** يجب توفير صور الإدخال الثلاث (Y وU وV) معًا، ويجب أن تكون أبعادها متوافقة لضمان التحويل بشكل صحيح. ## المخرجات -| اسم المخرج | الوصف | نوع البيانات | -|-------------|-------------|-----------| -| `output` | الصورة الناتجة بعد تحويل YUV إلى RGB. | صورة | - -سيكون حجم الصورة الناتجة نفس حجم الصور الإدخالية Y، U، وV، ولكن مع تمثيل معلومات الألوان في مساحة الألوان RGB. +| اسم المخرَج | الوصف | نوع البيانات | +| --- | --- | --- | +| `output` | صورة RGB المحوّلة | IMAGE | > تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ImageYUVToRGB/ar.md) diff --git a/comfyui_embedded_docs/docs/ImageYUVToRGB/en.md b/comfyui_embedded_docs/docs/ImageYUVToRGB/en.md index 107fefe9d..4be1bf755 100644 --- a/comfyui_embedded_docs/docs/ImageYUVToRGB/en.md +++ b/comfyui_embedded_docs/docs/ImageYUVToRGB/en.md @@ -1,28 +1,22 @@ # Image YUV to RGB -The ImageYUVToRGB node is designed to convert images from the YUV color space to the RGB color space. It does this by taking three separate input images that represent the Y (luma), U (blue projection), and V (red projection) channels of the image. These channels are then combined into a single RGB image using a color space conversion technique. - -## Overview - -The ImageYUVToRGB node converts YUV images to RGB images by combining the Y, U, and V channels. This is useful for applications that require color space conversion between these two standards. +The ImageYUVToRGB node converts YUV color space images to RGB color space. It takes three separate input images representing the Y (luma), U (blue projection), and V (red projection) components and combines them into a single RGB image. ## Inputs | Parameter | Description | Data Type | Required | Range | -|-----------|-------------|-----------|----------|-------| -| `Y` | The Y channel input image, representing the luminance information. | IMAGE | Yes | - | -| `U` | The U channel input image, representing the blue color difference. | IMAGE | Yes | - | -| `V` | The V channel input image, representing the red color difference. | IMAGE | Yes | - | +| --- | --- | --- | --- | --- | +| `Y` | The Y (luminance) component input image | IMAGE | Yes | - | +| `U` | The U (blue projection) component input image | IMAGE | Yes | - | +| `V` | The V (red projection) component input image | IMAGE | Yes | - | -**Note:** The Y, U, and V channels must be provided together and should have the same dimensions to ensure a correct conversion. +**Note:** All three input images (Y, U, and V) must be provided together and should have compatible dimensions for proper conversion. ## Outputs | Output Name | Description | Data Type | -|-------------|-------------|-----------| -| `output` | The resulting RGB image after the YUV to RGB conversion. | IMAGE | - -The output image will have the same dimensions as the input Y, U, and V images, but with the color information represented in the RGB color space. +| --- | --- | --- | +| `output` | The converted RGB image | 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/ImageYUVToRGB/en.md) diff --git a/comfyui_embedded_docs/docs/ImageYUVToRGB/es.md b/comfyui_embedded_docs/docs/ImageYUVToRGB/es.md index c26b2ccbd..b1711e50f 100644 --- a/comfyui_embedded_docs/docs/ImageYUVToRGB/es.md +++ b/comfyui_embedded_docs/docs/ImageYUVToRGB/es.md @@ -1,30 +1,22 @@ # ImageYUVToRGB -# Conversión de Imagen YUV a RGB - -El nodo ImageYUVToRGB está diseñado para convertir imágenes del espacio de color YUV al espacio de color RGB. Lo hace tomando tres imágenes de entrada separadas que representan los canales Y (luminancia), U (proyección de azul) y V (proyección de rojo) de la imagen. Estos canales se combinan luego en una imagen RGB utilizando una técnica de conversión de espacio de color. - -## Resumen - -El nodo ImageYUVToRGB convierte imágenes YUV a imágenes RGB combinando los canales Y, U y V. Esto es útil para aplicaciones que requieren la conversión de espacio de color entre estos dos estándares. +El nodo ImageYUVToRGB convierte imágenes en espacio de color YUV a espacio de color RGB. Toma tres imágenes de entrada separadas que representan los componentes Y (luminancia), U (proyección de azul) y V (proyección de rojo) y las combina en una única imagen RGB. ## Entradas -| Parámetro | Descripción | Tipo de Datos | Obligatorio | Rango | -|-----------|-------------|-----------|----------|-------| -| `Y` | La imagen de entrada del canal Y, que representa la información de luminancia. | IMAGEN | Sí | - | -| `U` | La imagen de entrada del canal U, que representa la diferencia de color azul. | IMAGEN | Sí | - | -| `V` | La imagen de entrada del canal V, que representa la diferencia de color rojo. | IMAGEN | Sí | - | +| Parámetro | Descripción | Tipo de datos | Requerido | Rango | +| --- | --- | --- | --- | --- | +| `Y` | Imagen de entrada del componente Y (luminancia) | IMAGE | Sí | - | +| `U` | Imagen de entrada del componente U (proyección de azul) | IMAGE | Sí | - | +| `V` | Imagen de entrada del componente V (proyección de rojo) | IMAGE | Sí | - | -**Nota:** Los canales Y, U y V deben proporcionarse juntos y deben tener las mismas dimensiones para asegurar una conversión correcta. +**Nota:** Las tres imágenes de entrada (Y, U y V) deben proporcionarse juntas y deben tener dimensiones compatibles para una conversión adecuada. ## Salidas -| Nombre de Salida | Descripción | Tipo de Datos | -|-------------|-------------|-----------| -| `output` | La imagen RGB resultante después de la conversión YUV a RGB. | IMAGEN | - -La imagen de salida tendrá las mismas dimensiones que las imágenes de entrada Y, U y V, pero con la información de color representada en el espacio de color RGB. +| Nombre de salida | Descripción | Tipo de datos | +| --- | --- | --- | +| `output` | La imagen RGB convertida | 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/ImageYUVToRGB/es.md) diff --git a/comfyui_embedded_docs/docs/ImageYUVToRGB/fa.md b/comfyui_embedded_docs/docs/ImageYUVToRGB/fa.md index fcc6b9037..f0372b3cc 100644 --- a/comfyui_embedded_docs/docs/ImageYUVToRGB/fa.md +++ b/comfyui_embedded_docs/docs/ImageYUVToRGB/fa.md @@ -1,30 +1,22 @@ # تبدیل YUV تصویر به RGB -# تبدیل تصویر YUV به RGB - -گره ImageYUVToRGB برای تبدیل تصاویر از فضای رنگی YUV به RGB طراحی شده است. این گره این کار را با گرفتن سه تصویر ورودی جداگانه انجام می‌دهد که هر کدام از کانال‌های Y (لومینانس)، U (پروژهکول رنگی آبی) و V (پروژهکول رنگی قرمز) تصویر را نشان می‌دهند. سپس این کانال‌ها با استفاده از یک روش تبدیل فضای رنگی به یک تصویر RGB ترکیب می‌شوند. - -## بررسی کلی - -گره ImageYUVToRGB تصاویر YUV را به تصاویر RGB تبدیل می‌کند توسط ترکیب کانال‌های Y، U و V. این تبدیل برای برنامه‌هایی که نیاز به تبدیل فضای رنگی بین این دو استاندارد دارند، مفید است. +گره ImageYUVToRGB تصاویر فضای رنگ YUV را به فضای رنگ RGB تبدیل می‌کند. این گره سه تصویر ورودی جداگانه شامل مؤلفه‌های Y (روشنایی)، U (پروجکشن آبی) و V (پروجکشن قرمز) را دریافت کرده و آن‌ها را در یک تصویر RGB واحد ترکیب می‌کند. ## ورودی‌ها -| پارامتر | توضیح | نوع داده | الزامی | محدوده | -|-----------|-------------|-----------|----------|-------| -| `Y` | تصویر ورودی کانال Y، که اطلاعات لومینانس را نشان می‌دهد. | IMAGE | بله | - | -| `U` | تصویر ورودی کانال U، که تفاوت رنگی آبی را نشان می‌دهد. | IMAGE | بله | - | -| `V` | تصویر ورودی کانال V، که تفاوت رنگی قرمز را نشان می‌دهد. | IMAGE | بله | - | +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +| --- | --- | --- | --- | --- | +| `Y` | تصویر ورودی مؤلفه Y (روشنایی) | IMAGE | بله | - | +| `U` | تصویر ورودی مؤلفه U (پروجکشن آبی) | IMAGE | بله | - | +| `V` | تصویر ورودی مؤلفه V (پروجکشن قرمز) | IMAGE | بله | - | -**توجه:** کانال‌های Y، U و V باید با هم ارائه شوند و باید اندازه یکسانی داشته باشند تا تبدیل صحیحی انجام شود. +**توجه:** هر سه تصویر ورودی (Y، U و V) باید همراه یکدیگر ارائه شوند و برای تبدیل صحیح، ابعاد سازگار داشته باشند. ## خروجی‌ها -| نام خروجی | توضیح | نوع داده | -|-------------|-------------|-----------| -| `output` | تصویر RGB نهایی پس از تبدیل YUV به RGB. | IMAGE | - -تصویر خروجی اندازه‌ای مشابه با تصاویر ورودی Y، U و V خواهد داشت، اما اطلاعات رنگی در فضای رنگی RGB نمایش داده می‌شود. +| نام خروجی | توضیحات | نوع داده | +| --- | --- | --- | +| `output` | تصویر RGB تبدیل‌شده | IMAGE | > این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ImageYUVToRGB/fa.md) diff --git a/comfyui_embedded_docs/docs/ImageYUVToRGB/fr.md b/comfyui_embedded_docs/docs/ImageYUVToRGB/fr.md index 96da0314e..67507caa6 100644 --- a/comfyui_embedded_docs/docs/ImageYUVToRGB/fr.md +++ b/comfyui_embedded_docs/docs/ImageYUVToRGB/fr.md @@ -1,30 +1,22 @@ # ImageYUVToRGB -# Image YUV vers RGB - -Le nœud ImageYUVToRGB est conçu pour convertir des images du espace de couleur YUV en espace de couleur RGB. Il le fait en prenant trois images d'entrée distinctes qui représentent les canaux Y (luminance), U (projection bleue) et V (projection rouge) de l'image. Ces canaux sont ensuite combinés pour former une image RGB unique à l'aide d'une technique de conversion d'espace de couleur. - -## Aperçu - -Le nœud ImageYUVToRGB convertit des images YUV en images RGB en combinant les canaux Y, U et V. Cela est utile pour les applications nécessitant une conversion d'espace de couleur entre ces deux normes. +Le nœud ImageYUVToRGB convertit des images de l'espace colorimétrique YUV vers l'espace colorimétrique RVB. Il prend trois images d'entrée distinctes correspondant aux composantes Y (luma), U (projection bleue) et V (projection rouge), puis les combine en une seule image RVB. ## Entrées -| Paramètre | Description | Type de données | Obligatoire | Gamme | -|-----------|-------------|-----------|----------|-------| -| `Y` | L'image d'entrée du canal Y, représentant les informations de luminance. | IMAGE | Oui | - | -| `U` | L'image d'entrée du canal U, représentant la différence de couleur bleue. | IMAGE | Oui | - | -| `V` | L'image d'entrée du canal V, représentant la différence de couleur rouge. | IMAGE | Oui | - | +| Paramètre | Description | Type de données | Requis | Plage | +| --- | --- | --- | --- | --- | +| `Y` | Image d’entrée pour la composante Y (luma) | IMAGE | Oui | - | +| `U` | Image d’entrée pour la composante U (projection bleue) | IMAGE | Oui | - | +| `V` | Image d’entrée pour la composante V (projection rouge) | IMAGE | Oui | - | -**Note:** Les canaux Y, U et V doivent être fournis ensemble et devraient avoir les mêmes dimensions pour assurer une conversion correcte. +**Remarque :** Les trois images d’entrée (Y, U et V) doivent être fournies ensemble et posséder des dimensions compatibles pour une conversion correcte. ## Sorties | Nom de sortie | Description | Type de données | -|-------------|-------------|-----------| -| `output` | L'image RGB resulting after the YUV to RGB conversion. | IMAGE | - -L'image de sortie aura les mêmes dimensions que les images d'entrée Y, U et V, mais avec les informations de couleur représentées dans l'espace de couleur RGB. +| --- | --- | --- | +| `output` | L’image RVB convertie | 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/ImageYUVToRGB/fr.md) diff --git a/comfyui_embedded_docs/docs/ImageYUVToRGB/ja.md b/comfyui_embedded_docs/docs/ImageYUVToRGB/ja.md index 96fab4d87..03d0127bb 100644 --- a/comfyui_embedded_docs/docs/ImageYUVToRGB/ja.md +++ b/comfyui_embedded_docs/docs/ImageYUVToRGB/ja.md @@ -1,30 +1,22 @@ # ImageYUVToRGB -# イメージ YUV から RGB - -ImageYUVToRGB ノードは、イメージを YUV 色空間から RGB 色空間に変換するために設計されています。これを行うために、イメージの Y(輝度)、U(青色プロジェクション)、V(赤色プロジェクション)チャンネルを表す3つの異なる入力イメージを取得し、これらのチャンネルを色空間変換技術を使用して単一の RGB イメージに組み合わせます。 - -## 概要 - -ImageYUVToRGB ノードは、YUV イメージを RGB イメージに変換することで、これら二つの標準間の色空間変換が必要なアプリケーションに有用です。 +ImageYUVToRGBノードは、YUV色空間の画像をRGB色空間に変換します。このノードは、Y(輝度)、U(青色差成分)、V(赤色差成分)を表す3つの個別の入力画像を受け取り、それらを1つのRGB画像に合成します。 ## 入力 -| パラメータ | 説明 | データ型 | 必須 | 范囲 | -|------------|------|----------|------|-------| -| `Y` | Yチャンネルの入力イメージ、輝度情報を表す。 | IMAGE | はい | - | -| `U` | Uチャンネルの入力イメージ、青色差分を表す。 | IMAGE | はい | - | -| `V` | Vチャンネルの入力イメージ、赤色差分を表す。 | IMAGE | はい | - | +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +| --- | --- | --- | --- | --- | +| `Y` | Y(輝度)成分の入力画像 | IMAGE | はい | - | +| `U` | U(青色差成分)の入力画像 | IMAGE | はい | - | +| `V` | V(赤色差成分)の入力画像 | IMAGE | はい | - | -**注意:** Y、U、Vチャンネルは一緒に提供され、正確な変換を確保するために同じサイズである必要があります。 +**注:** 3つの入力画像(Y、U、V)はすべて同時に指定する必要があり、正しく変換するには互換性のあるサイズが必要です。 ## 出力 | 出力名 | 説明 | データ型 | -|--------|------|----------| -| `output` | YUVからRGB変換後の結果となるRGBイメージ。 | IMAGE | - -出力イメージは、入力のY、U、Vイメージと同じサイズですが、RGB色空間で色情報が表現されます。 +| --- | --- | --- | +| `output` | 変換されたRGB画像 | IMAGE | > このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ImageYUVToRGB/ja.md) diff --git a/comfyui_embedded_docs/docs/ImageYUVToRGB/ko.md b/comfyui_embedded_docs/docs/ImageYUVToRGB/ko.md index 63d7e6d02..6f49ea259 100644 --- a/comfyui_embedded_docs/docs/ImageYUVToRGB/ko.md +++ b/comfyui_embedded_docs/docs/ImageYUVToRGB/ko.md @@ -1,30 +1,22 @@ # ImageYUVToRGB -# 이미지 YUV to RGB - -ImageYUVToRGB 노드는 이미지를 YUV 색 공간에서 RGB 색 공간으로 변환하는 데 사용됩니다. 이 노드는 이미지의 Y (명도), U (파란색 투영), V (빨간색 투영) 채널을 나타내는 세 개의 별도의 입력 이미지를 받아 이를 통해 RGB 이미지로 결합합니다. 이 채널들은 색 공간 변환 기술을 사용하여 결합됩니다. - -## 개요 - -ImageYUVToRGB 노드는 YUV 이미지를 RGB 이미지로 변환하여 Y, U, V 채널을 결합합니다. 이는 이 두 표준 간의 색 공간 변환을 필요로 하는 애플리케이션에 유용합니다. +ImageYUVToRGB 노드는 YUV 색상 공간 이미지를 RGB 색상 공간으로 변환합니다. Y(휘도), U(청색 투영), V(적색 투영) 구성 요소를 각각 나타내는 세 개의 개별 입력 이미지를 가져와 단일 RGB 이미지로 결합합니다. ## 입력 | 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | -|-----------|-------------|-----------|----------|-------| -| `Y` | 명도 정보를 나타내는 Y 채널 입력 이미지. | IMAGE | 예 | - | -| `U` | 파란색 차이를 나타내는 U 채널 입력 이미지. | IMAGE | 예 | - | -| `V` | 빨간색 차이를 나타내는 V 채널 입력 이미지. | IMAGE | 예 | - | +| --- | --- | --- | --- | --- | +| `Y` | Y(휘도) 구성 요소 입력 이미지 | IMAGE | 예 | - | +| `U` | U(청색 투영) 구성 요소 입력 이미지 | IMAGE | 예 | - | +| `V` | V(적색 투영) 구성 요소 입력 이미지 | IMAGE | 예 | - | -**주의:** Y, U, V 채널은 함께 제공되어야 하며, 올바른 변환을 위해 동일한 크기를 가져야 합니다. +**참고:** 세 입력 이미지(Y, U, V)는 모두 함께 제공되어야 하며 올바른 변환을 위해 호환 가능한 크기를 가져야 합니다. ## 출력 | 출력 이름 | 설명 | 데이터 타입 | -|-------------|-------------|-----------| -| `output` | YUV to RGB 변환 후 결과 RGB 이미지. | IMAGE | - -출력 이미지는 입력 Y, U, V 이미지와 동일한 크기를 가지지만, RGB 색 공간에서 색 정보가 표현됩니다. +| --- | --- | --- | +| `output` | 변환된 RGB 이미지 | IMAGE | > 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ImageYUVToRGB/ko.md) diff --git a/comfyui_embedded_docs/docs/ImageYUVToRGB/pt-BR.md b/comfyui_embedded_docs/docs/ImageYUVToRGB/pt-BR.md index 5ef08c6ac..3a8cdc0bf 100644 --- a/comfyui_embedded_docs/docs/ImageYUVToRGB/pt-BR.md +++ b/comfyui_embedded_docs/docs/ImageYUVToRGB/pt-BR.md @@ -1,30 +1,22 @@ # ImageYUVToRGB -# Imagem YUV para RGB - -O nó ImageYUVToRGB é projetado para converter imagens do espaço de cor YUV para o espaço de cor RGB. Ele faz isso ao tomar três imagens de entrada separadas que representam os canais Y (luminância), U (projeção azul) e V (projeção vermelha) da imagem. Esses canais são então combinados em uma única imagem RGB usando uma técnica de conversão de espaço de cor. - -## Visão Geral - -O nó ImageYUVToRGB converte imagens YUV para imagens RGB, combinando os canais Y, U e V. Isso é útil para aplicações que requerem conversão de espaço de cor entre esses dois padrões. +O nó ImageYUVToRGB converte imagens do espaço de cores YUV para o espaço de cores RGB. Ele recebe três imagens de entrada separadas que representam os componentes Y (luma), U (projeção azul) e V (projeção vermelha) e as combina em uma única imagem RGB. ## Entradas | Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | -|-----------|-------------|-----------|----------|-------| -| `Y` | A imagem de entrada do canal Y, representando a informação de luminância. | IMAGEM | Sim | - | -| `U` | A imagem de entrada do canal U, representando a diferença de cor azul. | IMAGEM | Sim | - | -| `V` | A imagem de entrada do canal V, representando a diferença de cor vermelha. | IMAGEM | Sim | - | +| --- | --- | --- | --- | --- | +| `Y` | A imagem de entrada do componente Y (luminância) | IMAGE | Sim | - | +| `U` | A imagem de entrada do componente U (projeção azul) | IMAGE | Sim | - | +| `V` | A imagem de entrada do componente V (projeção vermelha) | IMAGE | Sim | - | -**Nota:** Os canais Y, U e V devem ser fornecidos juntos e devem ter as mesmas dimensões para garantir uma conversão correta. +**Nota:** Todas as três imagens de entrada (Y, U e V) devem ser fornecidas juntas e devem ter dimensões compatíveis para uma conversão adequada. ## Saídas | Nome da Saída | Descrição | Tipo de Dados | -|-------------|-------------|-----------| -| `output` | A imagem RGB resultante após a conversão YUV para RGB. | IMAGEM | - -A imagem de saída terá as mesmas dimensões das imagens de entrada Y, U e V, mas com a informação de cor representada no espaço de cor RGB. +| --- | --- | --- | +| `output` | A imagem RGB convertida | 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/ImageYUVToRGB/pt-BR.md) diff --git a/comfyui_embedded_docs/docs/ImageYUVToRGB/ru.md b/comfyui_embedded_docs/docs/ImageYUVToRGB/ru.md index 19296f4aa..203940417 100644 --- a/comfyui_embedded_docs/docs/ImageYUVToRGB/ru.md +++ b/comfyui_embedded_docs/docs/ImageYUVToRGB/ru.md @@ -1,30 +1,22 @@ # ImageYUVToRGB -# Изображение YUV в RGB - -Узел ImageYUVToRGB предназначен для конвертации изображений из цветового пространства YUV в цветовое пространство RGB. Это происходит за счет объединения трех отдельных входных изображений, представляющих каналы Y (луминанс), U (проекция синего цвета) и V (проекция красного цвета) изображения. Затем эти каналы комбинируются в единое изображение RGB с использованием методики преобразования цветового пространства. - -## Обзор - -Узел ImageYUVToRGB конвертирует изображения YUV в изображения RGB, комбинируя каналы Y, U и V. Это полезно для приложений, требующих преобразования цветового пространства между этими двумя стандартами. +Узел ImageYUVToRGB преобразует изображения из цветового пространства YUV в цветовое пространство RGB. Он принимает три отдельных входных изображения, представляющих компоненты Y (яркость), U (синяя проекция) и V (красная проекция), и объединяет их в одно изображение RGB. ## Входы -| Параметр | Описание | Тип данных | Обязателен | Диапазон | -|-----------|-------------|-----------|----------|-------| -| `Y` | Входное изображение канала Y, представляющее информацию о луминансе. | ИЗОБРАЖЕНИЕ | Да | - | -| `U` | Входное изображение канала U, представляющее разницу в цвете синего. | ИЗОБРАЖЕНИЕ | Да | - | -| `V` | Входное изображение канала V, представляющее разницу в цвете красного. | ИЗОБРАЖЕНИЕ | Да | - | +| Параметр | Описание | Тип данных | Обязательность | Диапазон | +| --- | --- | --- | --- | --- | +| `Y` | Входное изображение компонента Y (яркость) | IMAGE | Да | - | +| `U` | Входное изображение компонента U (синяя проекция) | IMAGE | Да | - | +| `V` | Входное изображение компонента V (красная проекция) | IMAGE | Да | - | -**Примечание:** Каналы Y, U и V должны предоставляться вместе и должны иметь одинаковые размеры для обеспечения правильного преобразования. +**Примечание:** Все три входных изображения (Y, U и V) должны подаваться вместе и иметь совместимые размеры для корректного преобразования. ## Выходы -| Название выхода | Описание | Тип данных | -|-------------|-------------|-----------| -| `output` | Результатирующее изображение RGB после преобразования YUV в RGB. | ИЗОБРАЖЕНИЕ | - -Результатирующее изображение будет иметь такие же размеры, как и входные изображения Y, U и V, но с цветовой информацией, представленной в цветовом пространстве RGB. +| Имя выхода | Описание | Тип данных | +| --- | --- | --- | +| `output` | Преобразованное изображение RGB | IMAGE | > Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ImageYUVToRGB/ru.md) diff --git a/comfyui_embedded_docs/docs/ImageYUVToRGB/tr.md b/comfyui_embedded_docs/docs/ImageYUVToRGB/tr.md index 0ee590d6c..c1984f695 100644 --- a/comfyui_embedded_docs/docs/ImageYUVToRGB/tr.md +++ b/comfyui_embedded_docs/docs/ImageYUVToRGB/tr.md @@ -1,28 +1,22 @@ # GörüntüYUV'denRGB'ye -GörüntüYUVToRGB düğümü, görüntüleri YUV renk alanından RGB renk alanına dönüştürmek için tasarlanmıştır. Bu, görüntünün Y (aydınlatma), U (mavi projeksiyon) ve V (kırmızı projeksiyon) kanallarını temsil eden üç ayrı giriş görüntüsünü alarak bu kanalları renk alanı dönüşüm teknikleri kullanarak tek bir RGB görüntüsüne birleştirmek suretiyle yapılır. - -## Genel Bakış - -GörüntüYUVToRGB düğümü, YUV görüntüleri RGB görüntülere dönüştürmek için kullanılır. Bu, bu iki standart arasında renk alanı dönüşümü gerektiren uygulamalar için faydalıdır. +ImageYUVToRGB düğümü, YUV renk uzayı görüntülerini RGB renk uzayına dönüştürür. Y (parlaklık), U (mavi projeksiyon) ve V (kırmızı projeksiyon) bileşenlerini temsil eden üç ayrı girdi görüntüsünü alır ve bunları tek bir RGB görüntüsünde birleştirir. ## Girdiler | Parametre | Açıklama | Veri Türü | Gerekli | Aralık | -|-----------|-----------|-----------|----------|-------| -| `Y` | Görüntüün Y kanalı giriş görüntüsü, aydınlatma bilgilerini temsil eder. | GÖRÜNTÜ | Evet | - | -| `U` | Görüntüün U kanalı giriş görüntüsü, mavi renk farkını temsil eder. | GÖRÜNTÜ | Evet | - | -| `V` | Görüntüün V kanalı giriş görüntüsü, kırmızı renk farkını temsil eder. | GÖRÜNTÜ | Evet | - | +| --- | --- | --- | --- | --- | +| `Y` | Y (parlaklık) bileşeni girdi görüntüsü | IMAGE | Evet | - | +| `U` | U (mavi projeksiyon) bileşeni girdi görüntüsü | IMAGE | Evet | - | +| `V` | V (kırmızı projeksiyon) bileşeni girdi görüntüsü | IMAGE | Evet | - | -**Not:** Y, U ve V kanallarının birlikte sağlanması ve doğru dönüşüm sağlamak için aynı boyutlarda olması gerekmektedir. +**Not:** Üç girdi görüntüsünün tümü (Y, U ve V) birlikte sağlanmalı ve doğru dönüşüm için uyumlu boyutlara sahip olmalıdır. ## Çıktılar | Çıktı Adı | Açıklama | Veri Türü | -|-----------|-----------|-----------| -| `output` | YUV'dan RGB'ye dönüşüm sonrası elde edilen sonuç görüntüsü. | GÖRÜNTÜ | - -Çıkış görüntüsü, giriş Y, U ve V görüntülerinin aynı boyutlarında olacaktır, ancak renk bilgileri RGB renk alanında temsil edilecektir. +| --- | --- | --- | +| `output` | Dönüştürülmüş RGB görüntüsü | 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/ImageYUVToRGB/tr.md) diff --git a/comfyui_embedded_docs/docs/ImageYUVToRGB/zh-TW.md b/comfyui_embedded_docs/docs/ImageYUVToRGB/zh-TW.md index 579b5dec8..c4aac32e4 100644 --- a/comfyui_embedded_docs/docs/ImageYUVToRGB/zh-TW.md +++ b/comfyui_embedded_docs/docs/ImageYUVToRGB/zh-TW.md @@ -1,30 +1,22 @@ # YUV 轉 RGB -# 圖像 YUV 轉 RGB - -ImageYUVToRGB 節點設計用於將圖像從 YUV 颜色空間轉換為 RGB 颜色空間。它通過取三個分離的輸入圖像來完成這項工作,這些圖像分別代表圖像的 Y(亮度)、U(藍色投影)和 V(紅色投影)通道。然後,這些通道使用顏色空間轉換技術合併成單一個 RGB 圖像。 - -## 概述 - -ImageYUVToRGB 節點通過合併 Y、U 和 V 通道將 YUV 圖像轉換為 RGB 圖像。這對於需要在這兩種標準之間進行顏色空間轉換的應用程序非常有用。 +ImageYUVToRGB 節點將 YUV 色彩空間的影像轉換為 RGB 色彩空間。它接受三個分別代表 Y(亮度)、U(藍色投影)和 V(紅色投影)分量的獨立輸入影像,並將它們組合成單張 RGB 影像。 ## 輸入 -| 參數 | 描述 | 資料類型 | 必需 | 范圍 | -|------|------|----------|------|------| -| `Y` | Y 通道輸入圖像,代表亮度信息。 | IMAGE | 是 | - | -| `U` | U 通道輸入圖像,代表藍色色差。 | IMAGE | 是 | - | -| `V` | V 通道輸入圖像,代表紅色色差。 | IMAGE | 是 | - | +| 參數 | 描述 | 資料類型 | 必填 | Range | +| --- | --- | --- | --- | --- | +| `Y` | Y(亮度)分量輸入影像 | IMAGE | 是 | - | +| `U` | U(藍色投影)分量輸入影像 | IMAGE | 是 | - | +| `V` | V(紅色投影)分量輸入影像 | IMAGE | 是 | - | -**注意:** Y、U 和 V 通道必須一起提供,並應具有相同的尺寸,以確保正確的轉換。 +**注意:** 三個輸入影像(Y、U 和 V)必須同時提供,且尺寸應相容,才能正確進行轉換。 ## 輸出 -| 輸出名稱 | 描述 | 資料類型 | -|----------|------|-----------| -| `output` | YUV 到 RGB 轉換後的結果 RGB 圖像。 | IMAGE | - -輸出圖像將具有與輸入的 Y、U 和 V 圖像相同的尺寸,但將顏色信息表示在 RGB 颜色空間中。 +| 輸出名 | 描述 | 資料類型 | +| --- | --- | --- | +| `output` | 轉換後的 RGB 影像 | IMAGE | > 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ImageYUVToRGB/zh-TW.md) diff --git a/comfyui_embedded_docs/docs/ImageYUVToRGB/zh.md b/comfyui_embedded_docs/docs/ImageYUVToRGB/zh.md index 56d6d953b..b504c62af 100644 --- a/comfyui_embedded_docs/docs/ImageYUVToRGB/zh.md +++ b/comfyui_embedded_docs/docs/ImageYUVToRGB/zh.md @@ -1,30 +1,22 @@ # 图像YUV到RGB -# 图像 YUV 到 RGB 转换 - -ImageYUVToRGB 节点旨在将图像从 YUV 颜色空间转换为 RGB 颜色空间。它通过接收三个分别代表图像的 Y(亮度)、U(蓝色分量)和 V(红色分量)通道的输入图像来实现。然后,使用颜色空间转换技术将这些通道组合成一个单一的 RGB 图像。 - -## 概述 - -ImageYUVToRGB 节点通过合并 Y、U 和 V 通道将 YUV 图像转换为 RGB 图像。这对于需要在 YUV 和 RGB 两种标准之间进行颜色空间转换的应用程序非常有用。 +ImageYUVToRGB 节点可将 YUV 色彩空间的图像转换为 RGB 色彩空间。它接收三张独立的输入图像,分别代表 Y(亮度)、U(蓝色投影)和 V(红色投影)分量,并将它们组合成一张 RGB 图像。 ## 输入 -| 参数 | 描述 | 数据类型 | 必需 | 范围 | -|-----------|-------------|-----------|----------|-------| -| `Y` | Y 通道输入图像,表示亮度信息。 | IMAGE | 是 | - | -| `U` | U 通道输入图像,表示蓝色色差。 | IMAGE | 是 | - | -| `V` | V 通道输入图像,表示红色色差。 | IMAGE | 是 | - | +| 参数 | 描述 | 数据类型 | 是否必需 | 范围 | +| --- | --- | --- | --- | --- | +| `Y` | Y(亮度)分量输入图像 | IMAGE | 是 | - | +| `U` | U(蓝色投影)分量输入图像 | IMAGE | 是 | - | +| `V` | V(红色投影)分量输入图像 | IMAGE | 是 | - | -**注意:** Y、U 和 V 通道必须一起提供,并且应该具有相同的尺寸,以确保正确的转换。 +**注意:** 三张输入图像(Y、U 和 V)必须同时提供,并且尺寸应兼容,才能正确转换。 ## 输出 | 输出名称 | 描述 | 数据类型 | -|-------------|-------------|-----------| -| `output` | YUV 到 RGB 转换后的结果 RGB 图像。 | IMAGE | - -输出图像将具有与输入 Y、U 和 V 图像相同的尺寸,但使用 RGB 颜色空间表示颜色信息。 +| --- | --- | --- | +| `output` | 转换后的 RGB 图像 | IMAGE | > 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ImageYUVToRGB/zh.md) diff --git a/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/ar.md b/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/ar.md new file mode 100644 index 000000000..b94de7293 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/ar.md @@ -0,0 +1,38 @@ +# LTXVAddGeneratedKeyframes + +## المقدمة + +يضيف عقدة LTXV إطارات المفاتيح المولدة تفاصيل إطارات المفاتيح إلى الفيديو المكتسب. يمثل كل إطار مفاتيح إطارًا مكتسبًا من رموز تغطي إطارًا بكسليًا واحدًا، ويتم تعدينه باستخدام الفيديو وليس جزءًا من المخرجات المفككة. يتم تحديد الموقع بواسطة معامل interval_frames، الذي يحدد خطوة الإطار البصري للترتيب التلقائي. + +## المدخلات + +| المعامل | الوصف | نوع البيانات | مطلوب | نطاق | +|-----------|-------------|-----------|----------|-------| +| `positive` | التشغيل الإيجابي الذي يتم إلصاق إطارات المفاتيح إليه. | CONDITIONING | نعم | غير محدد | +| `negative` | التشغيل السلبي الذي يتم إلصاق إطارات المفاتيح إليه. | CONDITIONING | نعم | غير محدد | +| `vae` | يستخدم فقط لقراءة معاملات المكتسب. | VAE | نعم | غير محدد | +| `latent` | مكتسب فيديو عادي 5D لإنشاء إطارات المفاتيح بجانبه. أضفهم قبل Concat AV Latent. | LATENT | نعم | غير محدد | +| `interval_frames` | خطوة الإطار البصري للترتيب التلقائي. القيمة الافتراضية 24 تُعادل إطار مفاتيح واحد في الثانية عند 24 إطارًا في الثانية. تُتخطى البكسلات المحتلة. يُتغاضى عنه عندما يتم تعيين frame_indices. | INT | لا | 1-1024 | +| `keyframes` | محتوى اختياري لبدء إطارات المفاتيح الجديدة به. ربط إطارات المفاتيح من Separate سابق (نفس حجم المساحة المكانيّة) أو مكتسب فيديو عادي لنسخ الإطار الأقرب في كل سлот جديد (مثل بعد التوسع الزمني). تُعدين هذه أيضًا، وليست موثقة كإرشادات. تُتجاهل أرقام السجلات في مكتسب إطارات المفاتيح إلا إذا تم تعيين frame_indices. يكون له تأثير فقط عند بدء التسلسل تحت sigma 1. | LATENT | لا | غير محدد | +| `frame_indices` | أرقام الإطارات البصرية. اتركها فارغة لتوضع من interval_frames على اللوحة الحالية. عندما يتم تعيينها، هذه القائمة هي الموقع (تُناقش إطارات المفاتيح المتصلة في ترتيب). يُسمح بالإطار الأخير؛ الإطار 0 لا (إنه رمز مستقل). | STRING | لا | غير محدد | + +## المخرجات + +| اسم المخرج | الوصف | نوع البيانات | +|-------------|-------------|-----------| +| `positive` | التشغيل الإيجابي مع إضافة انتباه إطارات المفاتيح المولدة. | CONDITIONING | +| `negative` | التشغيل السلبي مع إضافة انتباه إطارات المفاتيح المولدة. | CONDITIONING | +| `latent` | مكتسب فيديو يحتوي على إطارات المفاتيح المضافة على T. | LATENT | + +## الملاحظات + +- يحدد معامل `interval_frames` مسافة إطارات المفاتيح في الفيديو. يؤدي القيمة الأعلى إلى عدد أقل من إطارات المفاتيح وتردد أقل. +- يسمح مدخل `keyframes` بإعداد إطارات المفاتيح الجديدة باستخدام إطارات المفاتيح الموجودة أو مكتسب فيديو. إذا تم توفيرها، تُعدين هذه الإطارات وتُضاف إلى مكتسب الفيديو. +- يسمح معامل `frame_indices` بتحديد أرقام الإطارات البصرية حيث يجب وضع إطارات المفاتيح. إذا تم توفيرها، يُتغاضى عن معامل `interval_frames`. +- تحتوي المخرجات `positive` و `negative` على التشغيل مع إضافة انتباه إطارات المفاتيح المولدة، التي يمكن استخدامها للمعالجة أو التحليل المزيدي. +- يحتوي المخرج `latent` على مكتسب الفيديو يحتوي على إطارات المفاتيح المضافة على T، الذي يمكن استخدامه للمعالجة أو التحليل المزيدي. + +> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/ar.md) + +--- +**Source fingerprint (SHA-256):** `43053d15eceb61f37223c46dd46417c71f0503ef3a412ee50a3b2f764f310a64` diff --git a/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/en.md b/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/en.md new file mode 100644 index 000000000..d178d6441 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/en.md @@ -0,0 +1,38 @@ +# LTXVAddGeneratedKeyframes + +## Overview + +The LTXV Add Generated Keyframes node appends detailing keyframes to a video latent. Each keyframe represents one latent frame of tokens spanning a single pixel frame, which are denoised with the video and not part of the decoded output. Placement is determined by the interval_frames parameter, which specifies the pixel-frame stride for auto placement. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `positive` | Positive conditioning the keyframes are attached to. | CONDITIONING | Yes | N/A | +| `negative` | Negative conditioning the keyframes are attached to. | CONDITIONING | Yes | N/A | +| `vae` | Only used to read the latent scale factors. | VAE | Yes | N/A | +| `latent` | Plain 5D video latent to generate keyframes alongside. Add them before Concat AV Latent. | LATENT | Yes | N/A | +| `interval_frames` | Pixel-frame stride for auto placement. Default 24 is about one keyframe per second at 24 fps. Occupied pixels are skipped. Ignored when frame_indices is set. | INT | No | 1-1024 | +| `keyframes` | Optional content to initialize the new keyframes with. Connect keyframes from an earlier Separate (same spatial size), or a plain video latent to copy the nearest frame at each new slot (e.g. after temporal upscale). These are still denoised, not pinned as guides. Recorded indices on a keyframes latent are ignored unless frame_indices is set. Only has an effect when sampling starts below sigma 1. | LATENT | No | N/A | +| `frame_indices` | Optional pixel-frame indices. Leave empty to place from interval_frames on the current canvas. When set, this list is the placement (connected keyframes are matched in order). The last frame is allowed; frame 0 is not (it is already a standalone token). | STRING | No | N/A | + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `positive` | Positive conditioning with generated-keyframe attention attached. | CONDITIONING | +| `negative` | Negative conditioning with generated-keyframe attention attached. | CONDITIONING | +| `latent` | Video latent with generated keyframes appended on T. | LATENT | + +## Notes + +- The `interval_frames` parameter determines the spacing of keyframes in the video. A higher value results in fewer keyframes and a lower frame rate. +- The `keyframes` input allows you to initialize the new keyframes with existing keyframes or a video latent. If provided, these keyframes will be denoised and appended to the video latent. +- The `frame_indices` parameter allows you to specify the exact pixel-frame indices where keyframes should be placed. If provided, the `interval_frames` parameter is ignored. +- The `positive` and `negative` outputs contain the conditioning with generated-keyframe attention attached, which can be used for further processing or analysis. +- The `latent` output contains the video latent with generated keyframes appended on T, which can be used for further processing or analysis. + +> 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/LTXVAddGeneratedKeyframes/en.md) + +--- +**Source fingerprint (SHA-256):** `43053d15eceb61f37223c46dd46417c71f0503ef3a412ee50a3b2f764f310a64` diff --git a/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/es.md b/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/es.md new file mode 100644 index 000000000..2f377fc57 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/es.md @@ -0,0 +1,38 @@ +# LTXVAddGeneratedKeyframes + +## Resumen + +El nodo LTXV Agregar Keyframes Generados añade detalles de keyframes a un video latente. Cada keyframe representa un solo cuadro latente de tokens que abarca un solo cuadro de píxeles, que se suaviza con el video y no forma parte de la salida decodificada. La ubicación se determina por el parámetro interval_frames, que especifica el paso de cuadro de píxeles para el autoajuste. + +## Entradas + +| Parámetro | Descripción | Tipo de Datos | Obligatorio | Rango | +|-----------|-------------|-----------|----------|-------| +| `positive` | Condicionamiento positivo al que se adjuntan los keyframes. | CONDITIONING | Sí | N/A | +| `negative` | Condicionamiento negativo al que se adjuntan los keyframes. | CONDITIONING | Sí | N/A | +| `vae` | Únicamente utilizado para leer los factores de escala latentes. | VAE | Sí | N/A | +| `latent` | Latente de video plano 5D al que se generan keyframes junto. Añádalo antes de Concat AV Latent. | LATENT | Sí | N/A | +| `interval_frames` | Paso de cuadro de píxeles para el autoajuste. El valor predeterminado 24 es aproximadamente un keyframe por segundo a 24 fps. Los píxeles ocupados se saltan. Se ignora cuando frame_indices está configurado. | INT | No | 1-1024 | +| `keyframes` | Contenido opcional para inicializar los nuevos keyframes. Conecte keyframes de un Separar (tamaño espacial similar) o un latente de video plano para copiar el cuadro más cercano en cada nuevo espacio (por ejemplo, después de un upscale temporal). Estos aún se suavizan, no se fijan como guías. Los índices grabados en un latente de keyframes se ignoran a menos que frame_indices esté configurado. Solo tiene efecto cuando se comienza a muestrear por debajo de sigma 1. | LATENT | No | N/A | +| `frame_indices` | Índices de cuadro de píxeles opcionales. Deje en blanco para ubicar desde interval_frames en el lienzo actual. Cuando se configura, esta lista es la ubicación (los keyframes conectados se coinciden en orden). El último cuadro está permitido; el cuadro 0 no (ya es un token autónomo). | STRING | No | N/A | + +## Salidas + +| Nombre de Salida | Descripción | Tipo de Datos | +|-------------|-------------|-----------| +| `positive` | Condicionamiento positivo con atención de keyframes generados adjunta. | CONDITIONING | +| `negative` | Condicionamiento negativo con atención de keyframes generados adjunta. | CONDITIONING | +| `latent` | Latente de video con keyframes generados añadidos en T. | LATENT | + +## Notas + +- El parámetro `interval_frames` determina el espaciado de los keyframes en el video. Un valor más alto resulta en menos keyframes y una tasa de cuadros más baja. +- La entrada `keyframes` le permite inicializar los nuevos keyframes con keyframes existentes o un latente de video. Si se proporciona, estos keyframes se suavizarán y se añadirán al latente de video. +- El parámetro `frame_indices` le permite especificar los índices de cuadro de píxeles exactos donde deben ubicarse los keyframes. Si se proporciona, se ignora el parámetro `interval_frames`. +- Las salidas `positive` y `negative` contienen el condicionamiento con atención de keyframes generados adjunta, que se puede utilizar para procesamiento o análisis adicionales. +- La salida `latent` contiene el latente de video con keyframes generados añadidos en T, que se puede utilizar para procesamiento o análisis adicionales. + +> 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/LTXVAddGeneratedKeyframes/es.md) + +--- +**Source fingerprint (SHA-256):** `43053d15eceb61f37223c46dd46417c71f0503ef3a412ee50a3b2f764f310a64` diff --git a/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/fa.md b/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/fa.md new file mode 100644 index 000000000..dc735ef7e --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/fa.md @@ -0,0 +1,38 @@ +# LTXVAddGeneratedKeyframes + +## مقدمه + +نود LTXV Add Generated Keyframes فریم‌های کلیدی توصیفی را به یک لاتنت ویدیویی اضافه می‌کند. هر فریم کلیدی یک فریم لاتنت یک‌پیکسلی را در یک فریم پیکسلی پوشش می‌دهد که با ویدیو دENOISE می‌شود و بخشی از خروجی رمزگشایی نیست. قرارگیری توسط پارامتر interval_frames تعیین می‌شود که قدم پیکسلی برای قرارگیری خودکار را مشخص می‌کند. + +## ورودی‌ها + +| پارامتر | توضیح | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `positive` | شروط مثبت که فریم‌های کلیدی به آن‌ها متصل می‌شوند. | CONDITIONING | بله | N/A | +| `negative` | شروط منفی که فریم‌های کلیدی به آن‌ها متصل می‌شوند. | CONDITIONING | بله | N/A | +| `vae` | فقط برای خواندن عوامل مقیاس لاتنت استفاده می‌شود. | VAE | بله | N/A | +| `latent` | لاتنت ویدیویی ساده 5D برای تولید فریم‌های کلیدی به همراه آن. آن‌ها را قبل از Concat AV Latent اضافه کنید. | LATENT | بله | N/A | +| `interval_frames` | قدم پیکسلی برای قرارگیری خودکار. مقدار پیش‌فرض 24 تقریباً یک فریم کلیدی در هر ثانیه در 24 فریم بر ثانیه است. پیکسل‌های اشغال شده نادیده گرفته می‌شوند. در صورت تنظیم frame_indices نادیده گرفته می‌شود. | INT | خیر | 1-1024 | +| `keyframes` | محتوای اختصاصی برای شروع فریم‌های کلیدی جدید استفاده می‌شود. فریم‌های کلیدی از یک Separate قبلی (اندازه فضایی مشابه) یا یک لاتنت ویدیویی ساده برای کپی کردن نزدیک‌ترین فریم در هر جایگاه جدید (مثلاً پس از temporal upscale) متصل کنید. این فریم‌ها همچنان دENOISE می‌شوند، به عنوان راهنماها ثابت نمی‌شوند. شمارنده‌های ضبط شده در لاتنت فریم‌های کلیدی نادیده گرفته می‌شوند مگر اینکه frame_indices تنظیم شود. فقط زمانی اثر دارد که فرآیند نمونه‌گیری زیر sigma 1 شروع می‌شود. | LATENT | خیر | N/A | +| `frame_indices` | شمارنده‌های پیکسلی اختصاصی. خالی بگذارید تا از interval_frames برای قرارگیری در نقشه فعلی استفاده شود. وقتی تنظیم شود، این لیست قرارگیری است (فریم‌های کلیدی متصل شده در ترتیب مرتبط می‌شوند). فریم آخر مجاز است؛ فریم 0 نیست (این یک توکن مستقل است). | STRING | خیر | N/A | + +## خروجی‌ها + +| نام خروجی | توضیح | نوع داده | +|-------------|-------------|-----------| +| `positive` | شروط مثبت با توجه به فریم‌های کلیدی تولید شده متصل شده. | CONDITIONING | +| `negative` | شروط منفی با توجه به فریم‌های کلیدی تولید شده متصل شده. | CONDITIONING | +| `latent` | لاتنت ویدیویی با فریم‌های کلیدی تولید شده اضافه شده بر روی T. | LATENT | + +## یادداشت‌ها + +- پارامتر `interval_frames` فاصله فریم‌های کلیدی در ویدیو را مشخص می‌کند. مقدار بالاتر تعداد کمتری فریم کلیدی و فریم‌برثانیه کمتری را به ارمغان می‌آورد. +- ورودی `keyframes` به شما اجازه می‌دهد تا فریم‌های کلیدی جدید را با فریم‌های کلیدی موجود یا یک لاتنت ویدیویی شروع کنید. اگر ارائه شود، این فریم‌ها دENOISE می‌شوند و به لاتنت ویدیویی اضافه می‌شوند. +- پارامتر `frame_indices` به شما اجازه می‌دهد تا شمارنده‌های پیکسلی دقیق جایی که فریم‌های کلیدی باید قرار گیرند را مشخص کنید. اگر ارائه شود، پارامتر `interval_frames` نادیده گرفته می‌شود. +- خروجی‌های `positive` و `negative` شامل شروط با توجه به توجه به فریم‌های کلیدی تولید شده متصل شده هستند که می‌توانند برای پردازش یا تحلیل بیشتر استفاده شوند. +- خروجی `latent` شامل لاتنت ویدیویی با فریم‌های کلیدی تولید شده اضافه شده بر روی T است که می‌تواند برای پردازش یا تحلیل بیشتر استفاده شود. + +> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/fa.md) + +--- +**Source fingerprint (SHA-256):** `43053d15eceb61f37223c46dd46417c71f0503ef3a412ee50a3b2f764f310a64` diff --git a/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/fr.md b/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/fr.md new file mode 100644 index 000000000..add43d7b4 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/fr.md @@ -0,0 +1,38 @@ +# LTXVAddGeneratedKeyframes + +## Aperçu + +Le nœud LTXV Add Generated Keyframes ajoute des keyframes détaillés à un latent vidéo. Chaque keyframe représente un cadre latent de tokens couvrant un cadre de pixels unique, qui sont débruités avec la vidéo et ne font pas partie de la sortie décodée. Le placement est déterminé par le paramètre interval_frames, qui spécifie le pas de cadre de pixels pour le placement automatique. + +## Entrées + +| Paramètre | Description | Type de données | Obligatoire | Plage | +|-----------|-------------|-----------|----------|-------| +| `positive` | Conditionnement positif auxquels les keyframes sont attachés. | CONDITIONING | Oui | N/A | +| `negative` | Conditionnement négatif auxquels les keyframes sont attachés. | CONDITIONING | Oui | N/A | +| `vae` | Utilisé uniquement pour lire les facteurs de scale latents. | VAE | Oui | N/A | +| `latent` | Latent vidéo 5D brut pour générer des keyframes en même temps. Ajoutez-les avant Concat AV Latent. | LATENT | Oui | N/A | +| `interval_frames` | Pas de cadre de pixels pour le placement automatique. La valeur par défaut 24 correspond à environ un keyframe par seconde à 24 ips. Les pixels occupés sont ignorés. Ignoré lorsque frame_indices est défini. | INT | Non | 1-1024 | +| `keyframes` | Contenu optionnel pour initialiser les nouveaux keyframes. Connectez les keyframes d'un Séparer (même taille spatiale) précédent ou un latent vidéo brut pour copier le cadre le plus proche à chaque nouveau emplacement (par exemple, après un upscale temporel). Ces keyframes sont toujours débruités, mais pas fixés comme guides. Les indices enregistrés sur un latent keyframes sont ignorés sauf si frame_indices est défini. Ne prend effet que lorsque le sampling commence en dessous de sigma 1. | LATENT | Non | N/A | +| `frame_indices` | Indices de cadre de pixels optionnels. Laissez vide pour placer à partir de interval_frames sur le canevas actuel. Lorsque défini, cette liste est le placement (les keyframes connectés sont alignés dans l'ordre). Le dernier cadre est autorisé ; le cadre 0 ne l'est pas (il est déjà un token autonome). | STRING | Non | N/A | + +## Sorties + +| Nom de sortie | Description | Type de données | +|-------------|-------------|-----------| +| `positive` | Conditionnement positif avec l'attention des keyframes générés attachée. | CONDITIONING | +| `negative` | Conditionnement négatif avec l'attention des keyframes générés attachée. | CONDITIONING | +| `latent` | Latent vidéo avec des keyframes générés ajoutés sur T. | LATENT | + +## Notes + +- Le paramètre `interval_frames` détermine l'espacement des keyframes dans la vidéo. Une valeur plus élevée entraîne moins de keyframes et une fréquence d'images inférieure. +- L'entrée `keyframes` vous permet d'initialiser les nouveaux keyframes avec des keyframes existants ou un latent vidéo. Si fourni, ces keyframes seront débruités et ajoutés au latent vidéo. +- Le paramètre `frame_indices` permet de spécifier les indices de cadre de pixels exacts où les keyframes doivent être placés. Si fourni, le paramètre `interval_frames` est ignoré. +- Les sorties `positive` et `negative` contiennent le conditionnement avec l'attention des keyframes générés attachée, ce qui peut être utilisé pour une traitement ou une analyse ultérieure. +- La sortie `latent` contient le latent vidéo avec des keyframes générés ajoutés sur T, ce qui peut être utilisé pour une traitement ou une analyse ultérieure. + +> 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/LTXVAddGeneratedKeyframes/fr.md) + +--- +**Source fingerprint (SHA-256):** `43053d15eceb61f37223c46dd46417c71f0503ef3a412ee50a3b2f764f310a64` diff --git a/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/ja.md b/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/ja.md new file mode 100644 index 000000000..74a06afcb --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/ja.md @@ -0,0 +1,38 @@ +# LTXVAddGeneratedKeyframes + +## 概要 + +LTXV Add Generated Keyframes ノードは、ビデオのラテンシティに詳細なキーフレームを追加します。各キーフレームは、単一のピクセルフレームを跨ぐトークンのラテンシティフレームを表し、ビデオとともにデノイズされますが、デコードされた出力の一部ではありません。配置は interval_frames パラメータによって決定され、自動配置のためのピクセルフレームのストライドを指定します。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|------------|------|----------|------|-------| +| `positive` | キーフレームに付加されるポジティブな条件付け | CONDITIONING | はい | N/A | +| `negative` | キーフレームに付加されるネガティブな条件付け | CONDITIONING | はい | N/A | +| `vae` | ラテンシティスケールファクターを読み取るためにのみ使用 | VAE | はい | N/A | +| `latent` | キーフレームとともに生成するために使用される、プラインな5Dビデオラテンシティ | LATENT | はい | N/A | +| `interval_frames` | 自动配置のためのピクセルフレームのストライド | INT | いいえ | 1-1024 | +| `keyframes` | 新しいキーフレームに初期化するためにオプションのコンテンツ | LATENT | いいえ | N/A | +| `frame_indices` | オプションのピクセルフレームインデックス | STRING | いいえ | N/A | + +## 出力 + +| 出力名 | 説明 | データ型 | +|--------|------|----------| +| `positive` | 生成されたキーフレームのアテンションが付加されたポジティブな条件付け | CONDITIONING | +| `negative` | 生成されたキーフレームのアテンションが付加されたネガティブな条件付け | CONDITIONING | +| `latent` | 生成されたキーフレームが T に追加されたビデオラテンシティ | LATENT | + +## 注意事項 + +- `interval_frames` パラメータは、ビデオ内のキーフレームのスペーシングを決定します。高い値はキーフレームが少なくなり、フレームレートが低くなります。 +- `keyframes` 入力は、既存のキーフレームやビデオラテンシティで新しいキーフレームを初期化するために使用できます。提供された場合、これらのキーフレームはデノイズされ、ビデオラテンシティに追加されます。 +- `frame_indices` パラメータは、キーフレームが配置される正確なピクセルフレームインデックスを指定するために使用できます。提供された場合、`interval_frames` パラメータは無視されます。 +- `positive` と `negative` 出力は、生成されたキーフレームのアテンションが付加された条件付けを含み、さらなる処理や分析に使用できます。 +- `latent` 出力は、生成されたキーフレームが T に追加されたビデオラテンシティを含み、さらなる処理や分析に使用できます。 + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/ja.md) + +--- +**Source fingerprint (SHA-256):** `43053d15eceb61f37223c46dd46417c71f0503ef3a412ee50a3b2f764f310a64` diff --git a/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/ko.md b/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/ko.md new file mode 100644 index 000000000..052e3c942 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/ko.md @@ -0,0 +1,38 @@ +# LTXVAddGeneratedKeyframes + +## 개요 + +LTXV 추가된 키 프레임 노드는 비디오 레이턴에 키 프레임을 추가합니다. 각 키 프레임은 단일 픽셀 프레임을 범위로 한 토큰 레이턴 프레임을 나타내며, 비디오와 함께 데노이즈되지만 디코딩된 출력의 일부는 아닙니다. 배치는 `interval_frames` 매개변수에 의해 결정되며, 이 매개변수는 자동 배치를 위한 픽셀 프레임 스타일을 지정합니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `positive` | 키 프레임이 부착된 긍정적인 조건부. | CONDITIONING | 예 | N/A | +| `negative` | 키 프레임이 부착된 부정적인 조건부. | CONDITIONING | 예 | N/A | +| `vae` | 레이턴 스케일 팩터를 읽기 위해 사용됩니다. | VAE | 예 | N/A | +| `latent` | 키 프레임과 함께 생성할 5D 비디오 레이턴. Concat AV 레이턴 전에 추가합니다. | LATENT | 예 | N/A | +| `interval_frames` | 자동 배치를 위한 픽셀 프레임 스타일. 기본 값 24는 24 fps에서 한 키 프레임 당 초로 설정됩니다. 점유된 픽셀은 건너뜁니다. `frame_indices`가 설정되었을 때 무시됩니다. | INT | 아님 | 1-1024 | +| `keyframes` | 새 키 프레임을 초기화하기 위해 사용할 선택 사항 내용. 이전 Separate (같은 공간 크기)에서 키 프레임을 연결하거나, 평범한 비디오 레이턴을 연결하여 각 새 슬롯에서 가장 가까운 프레임을 복사합니다 (예: 시간 확대 후). 이들은 여전히 데노이즈되지만 가이드로 고정되지 않습니다. 키 프레임 레이턴에 기록된 인덱스는 `frame_indices`가 설정되지 않았을 때 무시됩니다. 샘플링이 sigma 1 이하로 시작할 때만 효과가 있습니다. | LATENT | 아님 | N/A | +| `frame_indices` | 선택 사항 픽셀 프레임 인덱스. 현재 캔버스에서 `interval_frames`에 의해 배치할 때 빈 값으로 두세요. 설정되었을 때, 이 목록은 배치입니다 (연결된 키 프레임은 순서대로 일치됩니다). 마지막 프레임은 허용됩니다; 프레임 0은 아닙니다 (그것은 독립된 토큰입니다). | STRING | 아님 | N/A | + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `positive` | 생성된 키 프레임 주의를 부착한 긍정적인 조건부. | CONDITIONING | +| `negative` | 생성된 키 프레임 주의를 부착한 부정적인 조건부. | CONDITIONING | +| `latent` | 생성된 키 프레임이 추가된 T에 비디오 레이턴. | LATENT | + +## 주의사항 + +- `interval_frames` 매개변수는 비디오에서 키 프레임의 간격을 결정합니다. 높은 값은 키 프레임이 적고 프레임 레이트가 낮아집니다. +- `keyframes` 입력은 기존 키 프레임이나 비디오 레이턴으로 새 키 프레임을 초기화할 수 있도록 합니다. 제공되면, 이 키 프레임은 데노이즈되고 비디오 레이턴에 추가됩니다. +- `frame_indices` 매개변수는 키 프레임이 배치되는 정확한 픽셀 프레임 인덱스를 지정할 수 있습니다. 제공되면, `interval_frames` 매개변수는 무시됩니다. +- `positive`과 `negative` 출력은 생성된 키 프레임 주의를 부착한 조건부를 포함하며, 이는 추가 처리나 분석에 사용할 수 있습니다. +- `latent` 출력은 생성된 키 프레임이 추가된 비디오 레이턴을 포함하며, 추가 처리나 분석에 사용할 수 있습니다. + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/ko.md) + +--- +**Source fingerprint (SHA-256):** `43053d15eceb61f37223c46dd46417c71f0503ef3a412ee50a3b2f764f310a64` diff --git a/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/pt-BR.md b/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/pt-BR.md new file mode 100644 index 000000000..2d7548f8a --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/pt-BR.md @@ -0,0 +1,38 @@ +# LTXVAddGeneratedKeyframes + +## Visão Geral + +O nó LTXV Adicionar Chaves Geradas anexa detalhes de chaves a um vídeo latente. Cada chave representa um quadro latente de tokens que span um único quadro de pixel, que são desnuvidos com o vídeo e não fazem parte da saída decodificada. A localização é determinada pelo parâmetro interval_frames, que especifica o passo do quadro de pixel para a localização automática. + +## Entradas + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | +|-----------|-------------|-----------|----------|-------| +| `positive` | Condicionamento positivo aos quais as chaves são anexadas. | CONDITIONING | Sim | N/A | +| `negative` | Condicionamento negativo aos quais as chaves são anexadas. | CONDITIONING | Sim | N/A | +| `vae` | Usado apenas para ler os fatores de escala latentes. | VAE | Sim | N/A | +| `latent` | Vídeo latente plano 5D para gerar chaves ao lado. Adicione antes de Concat AV Latent. | LATENT | Sim | N/A | +| `interval_frames` | Passo do quadro de pixel para a localização automática. O padrão 24 é aproximadamente uma chave a cada segundo em 24 fps.像素已被占用则跳过。当frame_indices estiver definido, é ignorado. | INT | Não | 1-1024 | +| `keyframes` | Conteúdo opcional para inicializar novas chaves com. Conecte chaves de um Separar (mesmo tamanho espacial) anterior ou um vídeo latente plano para copiar o quadro mais próximo em cada novo slot (por exemplo, após o upscale temporal). Essas ainda são desnuvidas, não fixadas como guias. Índices gravados em um vídeo latente de chaves são ignorados a menos que frame_indices esteja definido. Tem efeito apenas quando a amostragem começa abaixo de sigma 1. | LATENT | Não | N/A | +| `frame_indices` | Índices de quadro de pixel opcionais. Deixe vazio para localizar a partir de interval_frames no canvas atual. Quando definido, essa lista é a localização (chaves conectadas são correspondidas na ordem). O último quadro é permitido; o quadro 0 não é (já é um token autônomo). | STRING | Não | N/A | + +## Saídas + +| Nome da Saída | Descrição | Tipo de Dados | +|-------------|-------------|-----------| +| `positive` | Condicionamento positivo com atenção de chave gerada anexada. | CONDITIONING | +| `negative` | Condicionamento negativo com atenção de chave gerada anexada. | CONDITIONING | +| `latent` | Vídeo latente com chaves geradas anexadas no T. | LATENT | + +## Notas + +- O parâmetro `interval_frames` determina o espaçamento das chaves no vídeo. Um valor mais alto resulta em menos chaves e uma taxa de quadros mais baixa. +- A entrada `keyframes` permite que você inicialize novas chaves com chaves existentes ou um vídeo latente. Se fornecido, essas chaves serão desnuvidas e anexadas ao vídeo latente. +- O parâmetro `frame_indices` permite que você especifique os índices exatos de quadro de pixel onde as chaves devem ser colocadas. Se fornecido, o parâmetro `interval_frames` é ignorado. +- As saídas `positive` e `negative` contêm o condicionamento com atenção de chave gerada anexada, que pode ser usado para processamento ou análise adicional. +- A saída `latent` contém o vídeo latente com chaves geradas anexadas no T, que pode ser usado para processamento ou análise adicional. + +> 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/LTXVAddGeneratedKeyframes/pt-BR.md) + +--- +**Source fingerprint (SHA-256):** `43053d15eceb61f37223c46dd46417c71f0503ef3a412ee50a3b2f764f310a64` diff --git a/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/ru.md b/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/ru.md new file mode 100644 index 000000000..bd0dc211e --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/ru.md @@ -0,0 +1,38 @@ +# LTXVAddGeneratedKeyframes + +## Обзор + +Нод LTXV Add Generated Keyframes добавляет детализированные кейфреймы к видео latent. Каждый кейфрейм представляет один latent кадр токенов, охватывающий один пكسель кадра, который денoisится с видео и не является частью декодированного вывода. Размещение определяется параметром interval_frames, который specifies the pixel-frame stride для автоматического размещения. + +## Входы + +| Параметр | Описание | Тип данных | Обязателен | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `positive` | Положительное условие, к которому добавляются кейфреймы. | CONDITIONING | Да | N/A | +| `negative` | Отрицательное условие, к которому добавляются кейфреймы. | CONDITIONING | Да | N/A | +| `vae` | Используется только для чтения масштабных факторов latent. | VAE | Да | N/A | +| `latent` | Простой 5D видео latent, к которому генерируются кейфреймы. Добавляйте их перед Concat AV Latent. | LATENT | Да | N/A | +| `interval_frames` | Шаг пكسель кадра для автоматического размещения. По умолчанию 24 соответствует примерно одному кейфрейму в секунду при 24 fps. Занятые пكسели пропускаются. При установке frame_indices параметр игнорируется. | INT | Нет | 1-1024 | +| `keyframes` | Дополнительное содержимое для инициализации новых кейфреймов. Подключите кейфреймы из более раннего Separate (одинакового пространственного размера) или простого видео latent для копирования ближайшего кадра в каждом новом слоте (например, после временного upscale). Эти кейфреймы также денoisятся, но не закрепляются в качестве направляющих. Записанные индексы на latent кейфреймов игнорируются, если не установлен frame_indices. Имеет эффект только при начале сэмплинга ниже sigma 1. | LATENT | Нет | N/A | +| `frame_indices` | Дополнительные пكسель кадры. Оставьте пустым, чтобы разместить из interval_frames на текущем канвасе. При установке этот список является размещением (подключенные кейфреймы соответствуют в порядке). Последний кадр допускается; кадр 0 не допускается (он уже является отдельным токеном). | STRING | Нет | N/A | + +## Выходы + +| Название выхода | Описание | Тип данных | +|-------------|-------------|-----------| +| `positive` | Положительное условие с добавленным вниманием к кейфреймам. | CONDITIONING | +| `negative` | Отрицательное условие с добавленным вниманием к кейфреймам. | CONDITIONING | +| `latent` | Видео latent с добавленными кейфреймами на T. | LATENT | + +## Примечания + +- Параметр `interval_frames` определяет интервал кейфреймов в видео. Высокое значение приводит к меньшему количеству кейфреймов и более низкой частоте кадров. +- Вход `keyframes` позволяет вам инициализировать новые кейфреймы с существующими кейфреймами или видео latent. Если предоставлено, эти кейфреймы будут денoisироваться и добавляться к видео latent. +- Параметр `frame_indices` позволяет вам specify точные пكسель кадры, где должны быть размещены кейфреймы. При установке параметр `interval_frames` игнорируется. +- Выводы `positive` и `negative` содержат условие с добавленным вниманием к кейфреймам, которое можно использовать для дальнейшей обработки или анализа. +- Вывод `latent` содержит видео latent с добавленными кейфреймами на T, который можно использовать для дальнейшей обработки или анализа. + +> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/ru.md) + +--- +**Source fingerprint (SHA-256):** `43053d15eceb61f37223c46dd46417c71f0503ef3a412ee50a3b2f764f310a64` diff --git a/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/tr.md b/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/tr.md new file mode 100644 index 000000000..7c9bc478f --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/tr.md @@ -0,0 +1,38 @@ +# LTXVAddGeneratedKeyframes + +## Genel Bakış + +LTXV Oluşturulan Anahtar Çerçeveleri düğümü, bir video latentine ayrıntılı anahtar çerçeveler ekler. Her anahtar çerçeve, tek bir piksel çerçevesini kapsayan bir latent çerçevesi temsil eder ve bu çerçeveler video ile denoize edilir, ancak çözülen çıktının bir parçası değildir. Konumlandırma, interval_frames parametresi tarafından belirlenir ve bu parametre, otomatik konumlandırma için piksel çerçeve adımını belirtir. + +## Girdiler + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +|-----------|-------------|-----------|----------|-------| +| `positive` | Anahtar çerçevelerin eklenmesi için pozitif koşullama. | KOŞULLAMA | Evet | N/A | +| `negative` | Anahtar çerçevelerin eklenmesi için negatif koşullama. | KOŞULLAMA | Evet | N/A | +| `vae` | Yalnızca latent ölçek faktörlerini okumak için kullanılır. | VAE | Evet | N/A | +| `latent` | Anahtar çerçevelerle birlikte oluşturulacak temiz 5D video latenti. Concat AV Latent öncesinde ekleyin. | LATENT | Evet | N/A | +| `interval_frames` | Otomatik konumlandırma için piksel çerçeve adımı. Standart 24, 24 fps'de bir saniyede bir anahtar çerçeve anlamına gelir. İşgal edilmiş pikseller atlanır. frame_indices ayarlandığında yoksayılmıştır. | INT | Hayır | 1-1024 | +| `keyframes` | Yeni anahtar çerçeveleri başlatmak için seçmeli içerik. Daha erken bir Ayır (aynı alan boyutu) veya temiz bir video latentine bağlanarak mevcut her yeni yuva için en yakın çerçeveyi kopyalayın (örneğin, zamansal yükseltme sonrası). Bu çerçeveler hala denoize edilir, rehber olarak sabitlenmez. Anahtar çerçeveler latentindeki kaydedilen indeksler, frame_indices ayarlandığında yoksayılmaz. Yalnızca sigma 1 altında başlangıçta örnek alındığında etkili olur. | LATENT | Hayır | N/A | +| `frame_indices` | Seçmeli piksel çerçeve indeksleri. Boş bırakarak mevcut canvas üzerinde interval_frames ile konumlandırma yapın. Ayarlandığında, bu liste konumlandırma (bağlantılı anahtar çerçeveler sırayla eşleştirilir). Son çerçeve izin verilir; çerçeve 0 izin verilmez (zaten bağımsız bir token). | STRING | Hayır | N/A | + +## Çıktılar + +| Çıktı Adı | Açıklama | Veri Türü | +|-------------|-------------|-----------| +| `positive` | Oluşturulan-anahtar çerçeve dikkatini eklediği pozitif koşullama. | KOŞULLAMA | +| `negative` | Oluşturulan-anahtar çerçeve dikkatini eklediği negatif koşullama. | KOŞULLAMA | +| `latent` | Oluşturulan anahtar çerçevelerle eklenen T'ye eklenen video latenti. | LATENT | + +## Notlar + +- `interval_frames` parametresi, videodaki anahtar çerçevelerin aralığını belirler. Daha yüksek bir değer, daha az anahtar çerçeve ve daha düşük kare hızı anlamına gelir. +- `keyframes` girdisi, mevcut anahtar çerçeveler veya video latenti ile yeni anahtar çerçeveleri başlatmanıza olanak tanır. Sağlandığında, bu çerçeveler denoize edilir ve video latentine eklenir. +- `frame_indices` parametresi, anahtar çerçevelerin yerleştirileceği kesin piksel çerçeve indekslerini belirlemenize olanak tanır. Ayarlandığında, `interval_frames` parametresi yoksayılmaz. +- `positive` ve `negative` çıktıları, oluşturulan-anahtar çerçeve dikkatini eklediği koşullamalar içerir ve bu çıktılar ileri işleme veya analiz için kullanılabilir. +- `latent` çıktısı, oluşturulan anahtar çerçevelerle eklenen video latenti içerir ve bu çıktı ileri işleme veya analiz için kullanılabilir. + +> 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/LTXVAddGeneratedKeyframes/tr.md) + +--- +**Source fingerprint (SHA-256):** `43053d15eceb61f37223c46dd46417c71f0503ef3a412ee50a3b2f764f310a64` diff --git a/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/zh-TW.md b/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/zh-TW.md new file mode 100644 index 000000000..20f51b3a4 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/zh-TW.md @@ -0,0 +1,38 @@ +# LTXVAddGeneratedKeyframes + +## 概述 + +LTXV 添加生成的關鍵幀節點將詳細關鍵幀附加到視頻潛在變數上。每個關鍵幀代表一個潛在的像素幀的 token,這些 token 會與視頻進行去噪,但不屬於解碼輸出的部分。位置由 interval_frames 參數決定,該參數指定了像素幀步進以進行自動放置。 + +## 輸入 + +| 參數 | 描述 | 資料類型 | 必需 | 范圍 | +|-----------|-------------|-----------|----------|-------| +| `positive` | 關鍵幀附加到的正向條件。 | CONDITIONING | 是 | N/A | +| `negative` | 關鍵幀附加到的負向條件。 | CONDITIONING | 是 | N/A | +| `vae` | 只用於讀取潛在尺度因子。 | VAE | 是 | N/A | +| `latent` | 普通的五維視頻潛在變數,用於與之一起生成關鍵幀。在合併 AV 潛在變數之前添加它們。 | LATENT | 是 | N/A | +| `interval_frames` | 像素幀步進以進行自動放置。默認值 24 約為每秒一個關鍵幀,在 24 fps 下。佔用的像素會被跳過。當 frame_indices 設定時,將忽略。 | INT | 否 | 1-1024 | +| `keyframes` | 可選內容,用於初始化新關鍵幀。從早期的分離(相同的空間大小)或普通視頻潛在變數連接關鍵幀,以在每個新槽位中複製最近的幀(例如,在時空上掃後)。這些仍然會去噪,不會作為參考。在關鍵幀潛在變數上記錄的索引將被忽略,除非 frame_indices 設定。只有當樣本採樣開始於 sigma 1 以下時才有效。 | LATENT | 否 | N/A | +| `frame_indices` | 可選的像素幀索引。留空以從 interval_frames 在當前畫布上放置。當設定時,此列表是放置位置(連接的關鍵幀將按順序匹配)。最後一幀是允許的;第 0 幀不是(它已經是一個獨立的 token)。 | STRING | 否 | N/A | + +## 輸出 + +| 輸出名稱 | 描述 | 資料類型 | +|-------------|-------------|-----------| +| `positive` | 附加了生成關鍵幀注意力的正向條件。 | CONDITIONING | +| `negative` | 附加了生成關鍵幀注意力的負向條件。 | CONDITIONING | +| `latent` | 在 T 上附加了生成關鍵幀的視頻潛在變數。 | LATENT | + +## 註釋 + +- `interval_frames` 參數決定了視頻中關鍵幀的間隔。較高的值會導致關鍵幀更少,並降低幀率。 +- `keyframes` 輸入允許您使用現有的關鍵幀或視頻潛在變數初始化新關鍵幀。如果提供,這些關鍵幀將會去噪並附加到視頻潛在變數上。 +- `frame_indices` 參數允許您指定關鍵幀應該放置的確切像素幀索引。如果提供,將忽略 `interval_frames` 參數。 +- `positive` 和 `negative` 輸出包含附加了生成關鍵幀注意力的條件,可以用於進一步處理或分析。 +- `latent` 輸出包含附加了生成關鍵幀的視頻潛在變數,可以用於進一步處理或分析。 + +> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/zh-TW.md) + +--- +**Source fingerprint (SHA-256):** `43053d15eceb61f37223c46dd46417c71f0503ef3a412ee50a3b2f764f310a64` diff --git a/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/zh.md b/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/zh.md new file mode 100644 index 000000000..2b01995ee --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/zh.md @@ -0,0 +1,38 @@ +# LTXVAddGeneratedKeyframes + +## 概述 + +LTXV 添加生成的关键帧节点将详细关键帧附加到视频潜在数据上。每个关键帧代表一个跨越单个像素帧的潜在帧,这些帧与视频一起去噪,但不属于解码输出的一部分。位置由 interval_frames 参数确定,该参数指定了自动放置的像素帧步长。 + +## 输入 + +| 参数 | 描述 | 数据类型 | 必需 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `positive` | 关键帧附加到的正条件。 | CONDITIONING | 是 | N/A | +| `negative` | 关键帧附加到的负条件。 | CONDITIONING | 是 | N/A | +| `vae` | 仅用于读取潜在尺度因子。 | VAE | 是 | N/A | +| `latent` | 普通的 5D 视频潜在数据,用于生成与关键帧一起的关键帧。在 Concat AV Latent 之前添加它们。 | LATENT | 是 | N/A | +| `interval_frames` | 自动放置的像素帧步长。默认 24 大约是每秒一个关键帧,在 24 fps 的情况下。占用像素将被跳过。当 frame_indices 设置时被忽略。 | INT | 否 | 1-1024 | +| `keyframes` | 可选内容,用于初始化新的关键帧。从较早的 Separate(相同的空间大小)或普通视频潜在数据连接关键帧,以在每个新槽中复制最近的帧(例如,在时间上采样之后)。这些帧仍然会被去噪,不会作为引导固定。除非 frame_indices 设置,否则忽略关键帧潜在数据上的记录索引。只有当采样开始低于 sigma 1 时才有效。 | LATENT | 否 | N/A | +| `frame_indices` | 可选的像素帧索引。留空以从 interval_frames 在当前画布上放置。当设置时,此列表是放置位置(按顺序匹配连接的关键帧)。允许最后一个帧;帧 0 不允许(它已经是一个独立的标记)。 | STRING | 否 | N/A | + +## 输出 + +| 输出名称 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `positive` | 附加了生成关键帧注意力的正条件。 | CONDITIONING | +| `negative` | 附加了生成关键帧注意力的负条件。 | CONDITIONING | +| `latent` | 在 T 上附加了生成关键帧的视频潜在数据。 | LATENT | + +## 注意事项 + +- `interval_frames` 参数确定视频中关键帧的间隔。值越大,关键帧越少,帧率越低。 +- `keyframes` 输入允许您使用现有的关键帧或视频潜在数据初始化新的关键帧。如果提供,这些关键帧将被去噪并附加到视频潜在数据上。 +- `frame_indices` 参数允许您指定关键帧应放置的确切像素帧索引。如果提供,则忽略 `interval_frames` 参数。 +- `positive` 和 `negative` 输出包含附加了生成关键帧注意力的条件,可用于进一步处理或分析。 +- `latent` 输出包含附加了生成关键帧的视频潜在数据,可用于进一步处理或分析。 + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/zh.md) + +--- +**Source fingerprint (SHA-256):** `43053d15eceb61f37223c46dd46417c71f0503ef3a412ee50a3b2f764f310a64` diff --git a/comfyui_embedded_docs/docs/LTXVAddGuide/ar.md b/comfyui_embedded_docs/docs/LTXVAddGuide/ar.md index 53d181a72..4b102e9b4 100644 --- a/comfyui_embedded_docs/docs/LTXVAddGuide/ar.md +++ b/comfyui_embedded_docs/docs/LTXVAddGuide/ar.md @@ -1,34 +1,38 @@ # إضافة دليل LTXV -تضيف عقدة LTXVAddGuide توجيهًا شرطيًا للفيديو إلى التسلسلات الكامنة (latent sequences) عن طريق ترميز الصور أو مقاطع الفيديو المدخلة ودمجها كإطارات مفتاحية في بيانات التوجيه الشرطي. تقوم بمعالجة المدخلات عبر مشفّر VAE وتضع النتائج الكامنة الناتجة بشكل استراتيجي في مواضع إطارات محددة، مع تحديث كل من التوجيه الشرطي الإيجابي والسلبي بمعلومات الإطارات المفتاحية. تتعامل العقدة مع قيود محاذاة الإطارات وتتيح التحكم في قوة تأثير التوجيه الشرطي. +تضيف عقدة `LTXVAddGuide` توجيه تكييف الفيديو إلى التسلسلات الكامنة عن طريق تشفير الصور أو الفيديوهات المدخلة ودمجها كإطارات مفتاحية في بيانات التكييف. تعالج العقدة المدخلات عبر مشفّر VAE، وتضع الكمونات الناتجة في مواضع إطارات محددة بشكلٍ استراتيجي، مع تحديث كلٍّ من التكييف الإيجابي والسلبي بمعلومات الإطارات المفتاحية. تتعامل العقدة مع قيود محاذاة الإطارات وتتيح التحكم في قوة تأثير التكييف. ## المدخلات | المعامل | الوصف | نوع البيانات | مطلوب | النطاق | | --- | --- | --- | --- | --- | -| `إيجابي` | مدخل التوجيه الشرطي الإيجابي الذي سيتم تعديله بتوجيه الإطارات المفتاحية | CONDITIONING | نعم | - | -| `سلبي` | مدخل التوجيه الشرطي السلبي الذي سيتم تعديله بتوجيه الإطارات المفتاحية | CONDITIONING | نعم | - | -| `VAE` | نموذج VAE المستخدم لترميز إطارات الصورة/الفيديو المدخلة | VAE | نعم | - | -| `كامن` | التسلسل الكامن المدخل الذي سيستقبل إطارات التوجيه الشرطي | LATENT | نعم | - | -| `صورة` | صورة أو فيديو لتوجيه الفيديو الكامن بناءً عليه. يجب أن يكون عدد الإطارات 8*n + 1. إذا لم يكن الفيديو 8*n + 1 إطارًا، فسيتم قصّه إلى أقرب عدد إطارات يتبع النمط 8*n + 1. | IMAGE | نعم | - | -| `مؤشر الإطار` | فهرس الإطار الذي يبدأ عنده التوجيه الشرطي. بالنسبة للصور ذات الإطار الواحد أو مقاطع الفيديو التي تحتوي على 1-8 إطارات، تكون أي قيمة لـ frame_idx مقبولة. بالنسبة لمقاطع الفيديو التي تحتوي على 9 إطارات أو أكثر، يجب أن يكون frame_idx قابلاً للقسمة على 8، وإلا فسيتم تقريبه إلى أقرب مضاعف للرقم 8. تُحسب القيم السالبة من نهاية الفيديو. (الافتراضي: 0) | INT | نعم | -9999 إلى 9999 | -| `القوة` | قوة تأثير التوجيه الشرطي، حيث تعني 1.0 تطبيق توجيه شرطي كامل و0.0 عدم تطبيق أي توجيه شرطي (الافتراضي: 1.0) | FLOAT | نعم | 0.0 إلى 10.0 | -| `attention_mask` | قناع مكاني اختياري في مساحة البكسل. يتحكم في تأثير التوجيه الشرطي لكل منطقة عبر الانتباه الذاتي، ويُضرب في قوة التأثير (strength). | MASK | لا | - | -| `iclora_parameters` | معاملات IC-LoRA اختيارية من عقدة Get IC-LoRA Parameters. تُستخدم لضبط معالجة التوجيه وفقًا لما تتطلبه بعض IC-LoRAs (مثل تلك التي تحتوي على reference_downscale_factor > 1). عند التسلسل، تستخدم كل عقدة LTXVAddGuide المعاملات المتصلة بها فقط. | IC_LORA_PARAMETERS | لا | - | +| `إيجابي` | مدخل التكييف الإيجابي الذي سيتم تعديله بتوجيه الإطارات المفتاحية | CONDITIONING | نعم | - | +| `سلبي` | مدخل التكييف السلبي الذي سيتم تعديله بتوجيه الإطارات المفتاحية | CONDITIONING | نعم | - | +| `VAE` | نموذج VAE المستخدم لتشفير إطارات الصورة/الفيديو المدخلة | VAE | نعم | - | +| `كامن` | التسلسل الكامن المدخل الذي سيستقبل إطارات التكييف | LATENT | نعم | - | +| `صورة` | الصورة أو الفيديو الذي يُكيَّف عليه الفيديو الكامن. يجب أن يكون عدد إطاره وفق نمط 8*n + 1. إذا لم يكن الفيديو ضمن هذا النمط، فسيتم قصّه إلى أقرب عدد إطارات يطابق 8*n + 1. | IMAGE | نعم | - | +| `مؤشر الإطار` | مؤشر الإطار الذي يبدأ عنده التكييف. بالنسبة للصور أحادية الإطار أو الفيديوهات ذات الإطارات من 1 إلى 8، تكون أي قيمة `frame_idx` مقبولة. أما الفيديوهات التي تحتوي على 9 إطارات أو أكثر، فيجب أن يكون `frame_idx` قابلاً للقسمة على 8، وإلا فسيتم تقريبه لأسفل إلى أقرب مضاعف للعدد 8. تُحسب القيم السالبة من نهاية الفيديو. (الافتراضي: 0) | INT | نعم | -9999 إلى 9999 | +| `القوة` | قوة تأثير التكييف، حيث تعني القيمة 1.0 تطبيق التكييف بالكامل، والقيمة 0.0 عدم تطبيق أي تكييف (الافتراضي: 1.0) | FLOAT | نعم | 0.0 إلى 10.0 | +| `attention_mask` | قناع مكاني اختياري في فضاء البكسل. يتحكم في تأثير التكييف لكل منطقة عبر آلية الانتباه الذاتي، ويُضرب بقيمة `strength`. | MASK | لا | - | +| `iclora_parameters` | معاملات IC-LoRA اختيارية من عقدة Get IC-LoRA Parameters. تُستخدم لضبط معالجة التوجيه وفقًا لمتطلبات بعض IC-LoRAs (مثل تلك التي تحتوي على `reference_downscale_factor` > 1). عند الربط التسلسلي، تستخدم كل عقدة LTXVAddGuide المعاملات المتصلة بها فقط. | IC_LORA_PARAMETERS | لا | - | -**ملاحظة:** يجب أن يحتوي الإدخال (صورة/فيديو) على عدد إطارات يتبع النمط 8*n + 1 (مثل 1، 9، 17، 25 إطارًا). إذا تجاوز الإدخال هذا النمط، فسيتم قصّه تلقائيًا إلى أقرب عدد إطارات صالح. +**ملاحظة:** يجب أن يكون عدد إطارات الصورة/الفيديو المدخل مطابقًا لنمط 8*n + 1 (مثل 1، 9، 17، 25 إطارًا). إذا تجاوز المدخل هذا النمط، فسيتم قصّه تلقائيًا إلى أقرب عدد إطارات صالح. -**ملاحظة حول `iclora_parameters`:** عند استخدام معاملات IC-LoRA مع `reference_downscale_factor` أكبر من 1، يجب أن تكون الأبعاد المكانية الكامنة (العرض والارتفاع) قابلة للقسمة على هذا العامل. ستقوم العقدة برفع خطأ إذا لم يتم استيفاء هذا الشرط. +**ملاحظة بشأن `iclora_parameters`:** عند استخدام معاملات IC-LoRA مع قيمة `reference_downscale_factor` أكبر من 1، يجب أن تكون الأبعاد المكانية للتسلسل الكامن (العرض والارتفاع) قابلة للقسمة على هذا المعامل. سيرفع العقدة خطأً إذا لم يتم استيفاء هذا الشرط. + +**ملاحظة:** يجب أن تتسع إطارات التوجيه المشفّرة داخل التسلسل الكامن عند موضع الإطار المحدد. إذا تجاوزت الإطارات المشروطة طول التسلسل الكامن، يرفع العقدة خطأً. + +**ملاحظة:** إضافة توجيه إلى تسلسل كامن يجمع بين قنوات الصوت والفيديو غير مدعومة، وسيؤدي ذلك إلى رفع خطأ. ## المخرجات -| اسم المخرَج | الوصف | نوع البيانات | +| اسم المخرج | الوصف | نوع البيانات | | --- | --- | --- | -| `إيجابي` | توجيه شرطي إيجابي تم تحديثه بمعلومات توجيه الإطارات المفتاحية | CONDITIONING | -| `سلبي` | توجيه شرطي سلبي تم تحديثه بمعلومات توجيه الإطارات المفتاحية | CONDITIONING | -| `كامن` | تسلسل كامن يتضمن إطارات توجيه شرطي مدمجة وقناع ضوضاء محدّث | LATENT | +| `إيجابي` | تكييف إيجابي محدّث بمعلومات توجيه الإطارات المفتاحية | CONDITIONING | +| `سلبي` | تكييف سلبي محدّث بمعلومات توجيه الإطارات المفتاحية | CONDITIONING | +| `كامن` | تسلسل كامن يتضمن إطارات التكييف المدمجة وقناع ضوضاء محدّث | LATENT | > تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVAddGuide/ar.md) --- -**Source fingerprint (SHA-256):** `3e0d1422fbd1b5b3e4c69e641af2ecdb5ae8de3f4368b336917a0dce4286771e` +**Source fingerprint (SHA-256):** `031bc9030dafed85b5ff1cbceae36234e9d5f77f7f4b040267067ecd16a27929` diff --git a/comfyui_embedded_docs/docs/LTXVAddGuide/en.md b/comfyui_embedded_docs/docs/LTXVAddGuide/en.md index 5fba4457f..3d18035d7 100644 --- a/comfyui_embedded_docs/docs/LTXVAddGuide/en.md +++ b/comfyui_embedded_docs/docs/LTXVAddGuide/en.md @@ -1,11 +1,15 @@ # LTXVAddGuide -The LTXVAddGuide node adds video conditioning guidance to latent sequences by encoding input images or videos and incorporating them as keyframes into the conditioning data. It processes the input through a VAE encoder and strategically places the resulting latents at specified frame positions while updating both positive and negative conditioning with keyframe information. The node handles frame alignment constraints and allows control over the strength of the conditioning influence. +The LTXVAddGuide node is designed to add video conditioning guidance to latent sequences by encoding input images or videos and incorporating them as keyframes into the conditioning data. It processes the input through a VAE encoder and strategically places the resulting latents at specified frame positions while updating both positive and negative conditioning with keyframe information. The node handles frame alignment constraints and allows control over the strength of the conditioning influence. + +## Overview + +The LTXVAddGuide node encodes input images or videos, processes them through a VAE encoder, and uses the encoded latents to condition a latent video sequence. It allows for specifying a frame index to start the conditioning at and adjusts the strength of the conditioning influence. The node also supports optional pixel-space spatial masks for per-region conditioning influence and can handle IC-LoRA parameters for specific guide processing adjustments. ## Inputs | Parameter | Description | Data Type | Required | Range | -| --- | --- | --- | --- | --- | +|-----------|-------------|-----------|----------|-------| | `positive` | Positive conditioning input to be modified with keyframe guidance | CONDITIONING | Yes | - | | `negative` | Negative conditioning input to be modified with keyframe guidance | CONDITIONING | Yes | - | | `vae` | VAE model used for encoding the input image/video frames | VAE | Yes | - | @@ -20,15 +24,26 @@ The LTXVAddGuide node adds video conditioning guidance to latent sequences by en **Note on `iclora_parameters`:** When using IC-LoRA parameters with a `reference_downscale_factor` greater than 1, the latent spatial dimensions (width and height) must be divisible by that factor. The node will raise an error if this condition is not met. +**Note:** The encoded guide frames must fit within the latent sequence at the selected frame position. If the conditioned frames exceed the length of the latent sequence, the node raises an error. + +**Note:** Adding a guide to a latent that combines audio and video channels is not supported and will raise an error. + ## Outputs | Output Name | Description | Data Type | -| --- | --- | --- | +|-------------|-------------|-----------| | `positive` | Positive conditioning updated with keyframe guidance information | CONDITIONING | | `negative` | Negative conditioning updated with keyframe guidance information | CONDITIONING | | `latent` | Latent sequence with incorporated conditioning frames and updated noise mask | LATENT | +``` + +The documentation provided above is based on the source code and includes the following updates: + +- The `frame_idx` parameter now includes a tooltip with the constraint that for videos with 9+ frames, `frame_idx` must be divisible by 8. +- The `iclora_parameters` parameter includes a note about the requirement for latent spatial dimensions to be divisible by the `reference_downscale_factor` when using IC-LoRA parameters. +- The Overview section has been updated to reflect the node's functionality based on the source code. > 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):** `3e0d1422fbd1b5b3e4c69e641af2ecdb5ae8de3f4368b336917a0dce4286771e` +**Source fingerprint (SHA-256):** `031bc9030dafed85b5ff1cbceae36234e9d5f77f7f4b040267067ecd16a27929` diff --git a/comfyui_embedded_docs/docs/LTXVAddGuide/es.md b/comfyui_embedded_docs/docs/LTXVAddGuide/es.md index 48e954a4b..d35c687fc 100644 --- a/comfyui_embedded_docs/docs/LTXVAddGuide/es.md +++ b/comfyui_embedded_docs/docs/LTXVAddGuide/es.md @@ -1,34 +1,38 @@ # LTXVAddGuide -El nodo LTXVAddGuide añade guía de condicionamiento de video a secuencias latentes codificando imágenes o videos de entrada e incorporándolos como fotogramas clave en los datos de condicionamiento. Procesa la entrada a través de un codificador VAE y coloca estratégicamente los latentes resultantes en posiciones de fotograma especificadas, actualizando tanto el condicionamiento positivo como el negativo con información de fotogramas clave. El nodo maneja restricciones de alineación de fotogramas y permite controlar la fuerza de la influencia del condicionamiento. +El nodo LTXVAddGuide añade guía de condicionamiento de video a secuencias latentes codificando imágenes o videos de entrada e incorporándolos como fotogramas clave en los datos de condicionamiento. Procesa la entrada a través de un codificador VAE y coloca estratégicamente los latentes resultantes en posiciones de fotograma especificadas, actualizando tanto el condicionamiento positivo como el negativo con información de fotogramas clave. El nodo gestiona las restricciones de alineación de fotogramas y permite controlar la fuerza de la influencia del condicionamiento. ## Entradas -| Parámetro | Descripción | Tipo de datos | Requerido | Rango | +| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango | | --- | --- | --- | --- | --- | -| `positivo` | Entrada de condicionamiento positivo que se modificará con la guía de fotogramas clave | CONDITIONING | Sí | - | -| `negativo` | Entrada de condicionamiento negativo que se modificará con la guía de fotogramas clave | CONDITIONING | Sí | - | -| `vae` | Modelo VAE utilizado para codificar los fotogramas de la imagen/video de entrada | VAE | Sí | - | -| `latente` | Secuencia latente de entrada que recibirá los fotogramas de condicionamiento | LATENT | Sí | - | -| `imagen` | Imagen o video para condicionar el video latente. Debe tener 8*n + 1 fotogramas. Si el video no tiene 8*n + 1 fotogramas, se recortará a los 8*n + 1 fotogramas más cercanos. | IMAGE | Sí | - | -| `indice_fotograma` | Índice de fotograma para iniciar el condicionamiento. Para imágenes de un solo fotograma o videos de 1 a 8 fotogramas, cualquier valor de frame_idx es aceptable. Para videos de 9 o más fotogramas, frame_idx debe ser divisible por 8; de lo contrario, se redondeará hacia abajo al múltiplo de 8 más cercano. Los valores negativos se cuentan desde el final del video. (por defecto: 0) | INT | Sí | -9999 a 9999 | +| `positivo` | Entrada de condicionamiento positivo que se modificará con la guía de fotogramas clave. | CONDITIONING | Sí | - | +| `negativo` | Entrada de condicionamiento negativo que se modificará con la guía de fotogramas clave. | CONDITIONING | Sí | - | +| `vae` | Modelo VAE utilizado para codificar los fotogramas de imagen/video de entrada. | VAE | Sí | - | +| `latente` | Secuencia latente de entrada que recibirá los fotogramas de condicionamiento. | LATENT | Sí | - | +| `imagen` | Imagen o video para condicionar el video latente. Debe tener 8*n + 1 fotogramas. Si el video no tiene 8*n + 1 fotogramas, se recortará al número más cercano de 8*n + 1 fotogramas. | IMAGE | Sí | - | +| `indice_fotograma` | Índice de fotograma para iniciar el condicionamiento. Para imágenes de un solo fotograma o videos con 1-8 fotogramas, cualquier valor de frame_idx es aceptable. Para videos con 9 o más fotogramas, frame_idx debe ser divisible por 8; de lo contrario, se redondeará hacia abajo al múltiplo de 8 más cercano. Los valores negativos se cuentan desde el final del video. (por defecto: 0) | INT | Sí | -9999 a 9999 | | `fuerza` | Fuerza de la influencia del condicionamiento, donde 1.0 aplica el condicionamiento completo y 0.0 no aplica condicionamiento (por defecto: 1.0) | FLOAT | Sí | 0.0 a 10.0 | -| `attention_mask` | Máscara espacial opcional en el espacio de píxeles. Controla la influencia del condicionamiento por región mediante autoatención, multiplicada por la fuerza. | MASK | No | - | -| `iclora_parameters` | Parámetros IC-LoRA opcionales de un nodo Get IC-LoRA Parameters. Se utilizan para ajustar el procesamiento de la guía según lo requieran ciertos IC-LoRA (por ejemplo, aquellos con un reference_downscale_factor > 1). Cuando se encadenan, cada LTXVAddGuide utiliza solo los parámetros conectados a él. | IC_LORA_PARAMETERS | No | - | +| `attention_mask` | Máscara espacial opcional en el espacio de píxeles. Controla la influencia del condicionamiento por región mediante la autoatención, multiplicada por strength. | MASK | No | - | +| `iclora_parameters` | Parámetros IC-LoRA opcionales de un nodo Get IC-LoRA Parameters. Se utilizan para ajustar el procesamiento de la guía según lo requerido por ciertos IC-LoRA (por ejemplo, aquellos con un reference_downscale_factor > 1). Cuando se encadenan, cada LTXVAddGuide utiliza solo los parámetros conectados a este. | IC_LORA_PARAMETERS | No | - | -**Nota:** La imagen/video de entrada debe tener un número de fotogramas que siga el patrón 8*n + 1 (p. ej., 1, 9, 17, 25 fotogramas). Si la entrada supera este patrón, se recortará automáticamente al número de fotogramas válido más cercano. +**Nota:** La imagen/video de entrada debe tener un número de fotogramas que siga el patrón 8*n + 1 (por ejemplo, 1, 9, 17, 25 fotogramas). Si la entrada supera este patrón, se recortará automáticamente al número de fotogramas válido más cercano. -**Nota sobre `iclora_parameters`:** Al usar parámetros IC-LoRA con un `reference_downscale_factor` mayor que 1, las dimensiones espaciales latentes (ancho y alto) deben ser divisibles por ese factor. El nodo generará un error si no se cumple esta condición. +**Nota sobre `iclora_parameters`:** Al usar parámetros IC-LoRA con un `reference_downscale_factor` mayor que 1, las dimensiones espaciales del latente (ancho y alto) deben ser divisibles por ese factor. El nodo generará un error si no se cumple esta condición. + +**Nota:** Los fotogramas de guía codificados deben caber dentro de la secuencia latente en la posición de fotograma seleccionada. Si los fotogramas condicionados exceden la longitud de la secuencia latente, el nodo generará un error. + +**Nota:** No se admite agregar una guía a un latente que combine canales de audio y video; esto generará un error. ## Salidas | Nombre de salida | Descripción | Tipo de datos | | --- | --- | --- | -| `positivo` | Condicionamiento positivo actualizado con información de guía de fotogramas clave | CONDITIONING | -| `negativo` | Condicionamiento negativo actualizado con información de guía de fotogramas clave | CONDITIONING | -| `latente` | Secuencia latente con fotogramas de condicionamiento incorporados y máscara de ruido actualizada | LATENT | +| `positivo` | Condicionamiento positivo actualizado con información de guía de fotogramas clave. | CONDITIONING | +| `negativo` | Condicionamiento negativo actualizado con información de guía de fotogramas clave. | CONDITIONING | +| `latente` | Secuencia latente con fotogramas de condicionamiento incorporados y máscara de ruido actualizada. | 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/LTXVAddGuide/es.md) --- -**Source fingerprint (SHA-256):** `3e0d1422fbd1b5b3e4c69e641af2ecdb5ae8de3f4368b336917a0dce4286771e` +**Source fingerprint (SHA-256):** `031bc9030dafed85b5ff1cbceae36234e9d5f77f7f4b040267067ecd16a27929` diff --git a/comfyui_embedded_docs/docs/LTXVAddGuide/fa.md b/comfyui_embedded_docs/docs/LTXVAddGuide/fa.md index 55bede4d4..e7b9bd711 100644 --- a/comfyui_embedded_docs/docs/LTXVAddGuide/fa.md +++ b/comfyui_embedded_docs/docs/LTXVAddGuide/fa.md @@ -1,34 +1,38 @@ # LTXVAddGuide -گره LTXVAddGuide با رمزگذاری تصاویر یا ویدیوهای ورودی و گنجاندن آن‌ها به‌عنوان کلیدفریم در داده‌های شرط‌گذاری، راهنمایی شرط‌گذاری ویدیو را به توالی‌های لاتنت اضافه می‌کند. این گره ورودی را از طریق یک رمزگذار VAE پردازش می‌کند و لاتنت‌های حاصل را به‌صورت راهبردی در موقعیت‌های فریم مشخص قرار می‌دهد و هم‌زمان هر دو شرط‌گذاری مثبت و منفی را با اطلاعات کلیدفریم به‌روزرسانی می‌کند. گره محدودیت‌های هم‌ترازی فریم را مدیریت کرده و امکان کنترل قدرت تأثیر شرط‌گذاری را فراهم می‌سازد. +گره LTXVAddGuide راهنمای شرط‌سازی ویدیو را با رمزگذاری تصاویر یا ویدیوهای ورودی و گنجاندن آن‌ها به‌عنوان فریم‌های کلیدی در داده‌های شرط‌سازی، به دنباله‌های latent اضافه می‌کند. این گره ورودی را از طریق رمزگذار VAE پردازش می‌کند و latentهای حاصل را به‌صورت هدفمند در موقعیت‌های فریم مشخص قرار می‌دهد و هم‌زمان شرط‌سازی مثبت و منفی را با اطلاعات فریم کلیدی به‌روزرسانی می‌کند. این گره محدودیت‌های هم‌ترازی فریم را مدیریت می‌کند و امکان کنترل قدرت تأثیر شرط‌سازی را فراهم می‌آورد. ## ورودی‌ها | پارامتر | توضیحات | نوع داده | الزامی | محدوده | | --- | --- | --- | --- | --- | -| `مثبت` | ورودی شرط‌گذاری مثبت که باید با راهنمایی کلیدفریم اصلاح شود | CONDITIONING | بله | - | -| `منفی` | ورودی شرط‌گذاری منفی که باید با راهنمایی کلیدفریم اصلاح شود | CONDITIONING | بله | - | +| `مثبت` | ورودی شرط‌سازی مثبت که با راهنمای فریم کلیدی اصلاح می‌شود | CONDITIONING | بله | - | +| `منفی` | ورودی شرط‌سازی منفی که با راهنمای فریم کلیدی اصلاح می‌شود | CONDITIONING | بله | - | | `vae` | مدل VAE مورد استفاده برای رمزگذاری فریم‌های تصویر/ویدیوی ورودی | VAE | بله | - | -| `latent` | توالی لاتنت ورودی که فریم‌های شرط‌گذاری را دریافت می‌کند | LATENT | بله | - | -| `تصویر` | تصویر یا ویدیویی که ویدیوی لاتنت روی آن شرط‌گذاری می‌شود. باید 8*n + 1 فریم باشد. اگر ویدیو 8*n + 1 فریم نباشد، به نزدیک‌ترین تعداد فریم معتبر 8*n + 1 برش داده می‌شود. | IMAGE | بله | - | -| `اندیس فریم` | شاخص فریم برای شروع شرط‌گذاری. برای تصاویر تک‌فریمی یا ویدیوهای با 1-8 فریم، هر مقدار frame_idx قابل قبول است. برای ویدیوهای با 9 فریم یا بیشتر، frame_idx باید بر 8 بخش‌پذیر باشد، در غیر این صورت به نزدیک‌ترین مضرب 8 گرد می‌شود. مقادیر منفی از انتهای ویدیو شمارش می‌شوند. (پیش‌فرض: 0) | INT | بله | -9999 تا 9999 | -| `شدت` | قدرت تأثیر شرط‌گذاری، که 1.0 شرط‌گذاری کامل و 0.0 بدون شرط‌گذاری را اعمال می‌کند (پیش‌فرض: 1.0) | FLOAT | بله | 0.0 تا 10.0 | -| `attention_mask` | ماسک فضایی اختیاری در فضای پیکسل. تأثیر شرط‌گذاری ناحیه‌ای را از طریق خودتوجهی کنترل می‌کند و در strength ضرب می‌شود. | MASK | خیر | - | -| `iclora_parameters` | پارامترهای اختیاری IC-LoRA از گره Get IC-LoRA Parameters. برای تنظیم پردازش راهنما مطابق نیاز برخی IC-LoRAها (به‌عنوان مثال آن‌هایی که `reference_downscale_factor` بزرگ‌تر از 1 دارند) استفاده می‌شود. هنگام زنجیره‌شدن، هر LTXVAddGuide فقط از پارامترهای متصل به خودش استفاده می‌کند. | IC_LORA_PARAMETERS | خیر | - | +| `latent` | دنباله latent ورودی که فریم‌های شرط‌سازی را دریافت می‌کند | LATENT | بله | - | +| `تصویر` | تصویر یا ویدیویی که ویدیوی latent بر اساس آن شرط‌سازی می‌شود. باید 8*n + 1 فریم باشد. اگر ویدیو 8*n + 1 فریم نباشد، به نزدیک‌ترین 8*n + 1 فریم برش داده می‌شود. | IMAGE | بله | - | +| `اندیس فریم` | شاخص فریمی که شرط‌سازی از آن آغاز می‌شود. برای تصاویر تک‌فریمی یا ویدیوهای دارای 1 تا 8 فریم، هر مقدار `frame_idx` قابل قبول است. برای ویدیوهای دارای 9 فریم یا بیشتر، `frame_idx` باید بر 8 بخش‌پذیر باشد؛ در غیر این صورت به نزدیک‌ترین مضرب 8 (به سمت پایین) گرد می‌شود. مقادیر منفی از انتهای ویدیو شمرده می‌شوند. (پیش‌فرض: 0) | INT | بله | -9999 تا 9999 | +| `شدت` | قدرت تأثیر شرط‌سازی؛ به‌طوری‌که 1.0 شرط‌سازی کامل و 0.0 بدون شرط‌سازی اعمال می‌کند (پیش‌فرض: 1.0) | FLOAT | بله | 0.0 تا 10.0 | +| `attention_mask` | ماسک فضایی اختیاری در فضای پیکسل. تأثیر شرط‌سازی را به‌صورت منطقه‌ای از طریق خودتوجهی کنترل می‌کند و در `strength` ضرب می‌شود. | MASK | خیر | - | +| `iclora_parameters` | پارامترهای اختیاری IC-LoRA از یک گره Get IC-LoRA Parameters. برای تنظیم پردازش راهنما بنا به نیاز برخی IC-LoRAها (مثلاً آن‌هایی که `reference_downscale_factor` بزرگ‌تر از 1 دارند) استفاده می‌شود. هنگام زنجیره‌سازی، هر LTXVAddGuide فقط از پارامترهای متصل به خودش استفاده می‌کند. | IC_LORA_PARAMETERS | خیر | - | -**نکته:** تصویر/ویدیوی ورودی باید تعداد فریم‌های الگوی 8*n + 1 را داشته باشد (مثلاً 1، 9، 17، 25 فریم). اگر ورودی از این الگو فراتر رود، به‌طور خودکار به نزدیک‌ترین تعداد فریم معتبر برش داده می‌شود. +**نکته:** تصویر/ویدیوی ورودی باید تعداد فریمی مطابق الگوی 8*n + 1 داشته باشد (مثلاً 1، 9، 17، 25 فریم). اگر ورودی از این الگو فراتر برود، به‌طور خودکار به نزدیک‌ترین تعداد فریم معتبر برش داده می‌شود. -**نکته درباره `iclora_parameters`:** هنگام استفاده از پارامترهای IC-LoRA با `reference_downscale_factor` بزرگ‌تر از 1، ابعاد فضایی لاتنت (عرض و ارتفاع) باید بر آن عامل بخش‌پذیر باشند. در صورت برقرار نبودن این شرط، گره خطا ایجاد می‌کند. +**نکته درباره `iclora_parameters`:** هنگام استفاده از پارامترهای IC-LoRA با `reference_downscale_factor` بزرگ‌تر از 1، ابعاد فضایی latent (عرض و ارتفاع) باید بر آن ضریب بخش‌پذیر باشند. اگر این شرط برآورده نشود، گره خطا می‌دهد. + +**نکته:** فریم‌های راهنمای رمزگذاری‌شده باید در موقعیت فریم انتخاب‌شده درون دنباله latent جای بگیرند. اگر فریم‌های شرط‌سازی‌شده از طول دنباله latent فراتر بروند، گره خطا می‌دهد. + +**نکته:** افزودن راهنما به latentی که کانال‌های صوتی و تصویری را ترکیب می‌کند پشتیبانی نمی‌شود و باعث خطا می‌شود. ## خروجی‌ها | نام خروجی | توضیحات | نوع داده | | --- | --- | --- | -| `مثبت` | شرط‌گذاری مثبت به‌روزرسانی‌شده با اطلاعات راهنمایی کلیدفریم | CONDITIONING | -| `منفی` | شرط‌گذاری منفی به‌روزرسانی‌شده با اطلاعات راهنمایی کلیدفریم | CONDITIONING | -| `latent` | توالی لاتنت با فریم‌های شرط‌گذاری گنجانده‌شده و ماسک نویز به‌روزرسانی‌شده | LATENT | +| `مثبت` | شرط‌سازی مثبت به‌روزرسانی‌شده با اطلاعات راهنمای فریم کلیدی | CONDITIONING | +| `منفی` | شرط‌سازی منفی به‌روزرسانی‌شده با اطلاعات راهنمای فریم کلیدی | CONDITIONING | +| `latent` | دنباله latent با فریم‌های شرط‌سازی گنجانده‌شده و ماسک نویز به‌روزرسانی‌شده | LATENT | > این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVAddGuide/fa.md) --- -**Source fingerprint (SHA-256):** `3e0d1422fbd1b5b3e4c69e641af2ecdb5ae8de3f4368b336917a0dce4286771e` +**Source fingerprint (SHA-256):** `031bc9030dafed85b5ff1cbceae36234e9d5f77f7f4b040267067ecd16a27929` diff --git a/comfyui_embedded_docs/docs/LTXVAddGuide/fr.md b/comfyui_embedded_docs/docs/LTXVAddGuide/fr.md index 1ea164c7a..5b59c12ff 100644 --- a/comfyui_embedded_docs/docs/LTXVAddGuide/fr.md +++ b/comfyui_embedded_docs/docs/LTXVAddGuide/fr.md @@ -1,6 +1,6 @@ # LTXVAddGuide -Le nœud LTXVAddGuide ajoute un guidage de conditionnement vidéo aux séquences latentes en encodant des images ou vidéos d'entrée et en les incorporant comme images clés dans les données de conditionnement. Il traite l'entrée via un encodeur VAE et place stratégiquement les latents résultants à des positions de frames spécifiées, tout en mettant à jour le conditionnement positif et négatif avec les informations des images clés. Le nœud gère les contraintes d'alignement des frames et permet de contrôler la force de l'influence du conditionnement. +Le nœud LTXVAddGuide ajoute un guidage de conditionnement vidéo aux séquences latentes en encodant les images ou vidéos d'entrée et en les incorporant comme images clés dans les données de conditionnement. Il traite l'entrée via un encodeur VAE et place stratégiquement les latents résultants à des positions de frames spécifiées, tout en mettant à jour le conditionnement positif et négatif avec les informations des images clés. Le nœud gère les contraintes d'alignement des frames et permet de contrôler la force de l'influence du conditionnement. ## Entrées @@ -10,15 +10,19 @@ Le nœud LTXVAddGuide ajoute un guidage de conditionnement vidéo aux séquences | `négatif` | Conditionnement négatif d'entrée à modifier avec le guidage par images clés | CONDITIONING | Oui | - | | `vae` | Modèle VAE utilisé pour encoder les frames de l'image/vidéo d'entrée | VAE | Oui | - | | `latent` | Séquence latente d'entrée qui recevra les frames de conditionnement | LATENT | Oui | - | -| `image` | Image ou vidéo pour conditionner la vidéo latente. Doit contenir 8*n + 1 frames. Si la vidéo n'a pas 8*n + 1 frames, elle sera recadrée à la valeur la plus proche de 8*n + 1 frames. | IMAGE | Oui | - | -| `indice_de_l'image` | Index de frame où commencer le conditionnement. Pour les images à frame unique ou les vidéos de 1 à 8 frames, toute valeur de `frame_idx` est acceptable. Pour les vidéos de 9 frames ou plus, `frame_idx` doit être divisible par 8, sinon il sera arrondi à l'inférieur au multiple de 8 le plus proche. Les valeurs négatives sont comptées à partir de la fin de la vidéo. (défaut : 0) | INT | Oui | -9999 à 9999 | -| `force` | Force de l'influence du conditionnement, où 1,0 applique un conditionnement complet et 0,0 aucun conditionnement (défaut : 1,0) | FLOAT | Oui | 0,0 à 10,0 | -| `attention_mask` | Masque spatial optionnel en espace pixel. Contrôle l'influence du conditionnement par région via l'auto-attention, multiplié par `strength`. | MASK | Non | - | -| `iclora_parameters` | Paramètres IC-LoRA facultatifs provenant d'un nœud Get IC-LoRA Parameters. Utilisés pour ajuster le traitement du guidage selon les exigences de certains IC-LoRA (par exemple, ceux avec un `reference_downscale_factor` > 1). En chaînage, chaque LTXVAddGuide n'utilise que les paramètres qui lui sont connectés. | IC_LORA_PARAMETERS | Non | - | +| `image` | Image ou vidéo pour conditionner la vidéo latente. Doit avoir 8*n + 1 frames. Si la vidéo n'a pas 8*n + 1 frames, elle sera recadrée à la valeur la plus proche de 8*n + 1 frames. | IMAGE | Oui | - | +| `indice_de_l'image` | Index de frame auquel commencer le conditionnement. Pour les images monoframe ou les vidéos de 1 à 8 frames, toute valeur de `frame_idx` est acceptable. Pour les vidéos de 9 frames ou plus, `frame_idx` doit être divisible par 8, sinon il sera arrondi à l'inférieur au multiple de 8 le plus proche. Les valeurs négatives sont comptées à partir de la fin de la vidéo. (défaut : 0) | INT | Oui | -9999 à 9999 | +| `force` | Force de l'influence du conditionnement, où 1.0 applique un conditionnement complet et 0.0 n'applique aucun conditionnement (défaut : 1.0) | FLOAT | Oui | 0.0 à 10.0 | +| `attention_mask` | Masque spatial optionnel dans l'espace des pixels. Contrôle l'influence du conditionnement par région via l'auto-attention, multiplié par la force. | MASK | Non | - | +| `iclora_parameters` | Paramètres IC-LoRA facultatifs provenant d'un nœud Get IC-LoRA Parameters. Utilisés pour ajuster le traitement du guidage selon les exigences de certains IC-LoRA (par exemple, ceux avec un `reference_downscale_factor` > 1). En chaînage, chaque LTXVAddGuide utilise uniquement les paramètres qui lui sont connectés. | IC_LORA_PARAMETERS | Non | - | **Remarque :** L'image/vidéo d'entrée doit avoir un nombre de frames suivant le motif 8*n + 1 (par exemple, 1, 9, 17, 25 frames). Si l'entrée dépasse ce motif, elle sera automatiquement recadrée au nombre de frames valide le plus proche. -**Remarque sur `iclora_parameters` :** Lors de l'utilisation de paramètres IC-LoRA avec un `reference_downscale_factor` supérieur à 1, les dimensions spatiales latentes (largeur et hauteur) doivent être divisibles par ce facteur. Le nœud lèvera une erreur si cette condition n'est pas respectée. +**Remarque sur `iclora_parameters` :** Lors de l'utilisation de paramètres IC-LoRA avec un `reference_downscale_factor` supérieur à 1, les dimensions spatiales latentes (largeur et hauteur) doivent être divisibles par ce facteur. Le nœud lèvera une erreur si cette condition n'est pas satisfaite. + +**Remarque :** Les frames de guidage encodées doivent tenir dans la séquence latente à la position de frame sélectionnée. Si les frames conditionnées dépassent la longueur de la séquence latente, le nœud lève une erreur. + +**Remarque :** L'ajout d'un guidage à un latent combinant des canaux audio et vidéo n'est pas pris en charge et lèvera une erreur. ## Sorties @@ -26,9 +30,9 @@ Le nœud LTXVAddGuide ajoute un guidage de conditionnement vidéo aux séquences | --- | --- | --- | | `positive` | Conditionnement positif mis à jour avec les informations de guidage par images clés | CONDITIONING | | `négatif` | Conditionnement négatif mis à jour avec les informations de guidage par images clés | CONDITIONING | -| `latent` | Séquence latente avec les frames de conditionnement incorporées et le masque de bruit mis à jour | LATENT | +| `latent` | Séquence latente avec frames de conditionnement incorporées et masque de bruit mis à jour | 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/LTXVAddGuide/fr.md) --- -**Source fingerprint (SHA-256):** `3e0d1422fbd1b5b3e4c69e641af2ecdb5ae8de3f4368b336917a0dce4286771e` +**Source fingerprint (SHA-256):** `031bc9030dafed85b5ff1cbceae36234e9d5f77f7f4b040267067ecd16a27929` diff --git a/comfyui_embedded_docs/docs/LTXVAddGuide/ja.md b/comfyui_embedded_docs/docs/LTXVAddGuide/ja.md index 7b867619c..947bb3dec 100644 --- a/comfyui_embedded_docs/docs/LTXVAddGuide/ja.md +++ b/comfyui_embedded_docs/docs/LTXVAddGuide/ja.md @@ -1,34 +1,38 @@ # LTXVAddGuide -LTXVAddGuideノードは、入力画像またはビデオをエンコードし、それらをキーフレームとして条件付けデータに組み込むことで、潜在シーケンスにビデオ条件付けガイダンスを追加します。このノードはVAEエンコーダーを介して入力を処理し、結果の潜在表現を指定されたフレーム位置に戦略的に配置しながら、ポジティブ条件付けとネガティブ条件付けの両方をキーフレーム情報で更新します。また、フレーム配置の制約を処理し、条件付けの影響の強さを制御できます。 +LTXVAddGuide ノードは、入力画像またはビデオをエンコードし、それらをキーフレームとしてコンディショニングデータに組み込むことで、潜在シーケンスにビデオコンディショニングガイダンスを追加します。このノードは、入力を VAE エンコーダーで処理し、結果として得られる潜在表現を指定されたフレーム位置に戦略的に配置するとともに、キーフレーム情報でポジティブコンディショニングとネガティブコンディショニングの両方を更新します。また、ノードはフレームの位置合わせ制約を処理し、コンディショニングの影響の強さを制御できます。 ## 入力 | パラメータ | 説明 | データ型 | 必須 | 範囲 | | --- | --- | --- | --- | --- | -| `ポジティブ` | キーフレームガイダンスで変更されるポジティブ条件付け入力 | CONDITIONING | はい | - | -| `ネガティブ` | キーフレームガイダンスで変更されるネガティブ条件付け入力 | CONDITIONING | はい | - | -| `vae` | 入力画像/ビデオフレームのエンコードに使用されるVAEモデル | VAE | はい | - | -| `潜在` | 条件付けフレームを受け取る入力潜在シーケンス | LATENT | はい | - | -| `画像` | 潜在ビデオを条件付けるための画像またはビデオ。8*n + 1フレームである必要があります。ビデオが8*n + 1フレームでない場合、最も近い8*n + 1フレームにクロップされます。 | IMAGE | はい | - | -| `フレームインデックス` | 条件付けを開始するフレームインデックス。単一フレームの画像または1〜8フレームのビデオの場合、任意のframe_idx値が許容されます。9フレーム以上のビデオの場合、frame_idxは8で割り切れる必要があり、そうでない場合は最も近い8の倍数に切り捨てられます。負の値はビデオの末尾から数えます。(デフォルト:0) | INT | はい | -9999〜9999 | -| `強度` | 条件付けの影響の強さ。1.0で完全な条件付けが適用され、0.0で条件付けが適用されません(デフォルト:1.0) | FLOAT | はい | 0.0〜10.0 | -| `アテンションマスク` | オプションのピクセル空間マスク。セルフアテンションを介して領域ごとの条件付けの影響を制御し、strengthで乗算されます。 | MASK | いいえ | - | -| `iclora_parameters` | Get IC-LoRA ParametersノードからのオプションのIC-LoRAパラメータ。特定のIC-LoRA(reference_downscale_factor > 1など)で必要とされるガイド処理の調整に使用されます。チェーン化された場合、各LTXVAddGuideはそれに接続されたパラメータのみを使用します。 | IC_LORA_PARAMETERS | いいえ | - | +| `ポジティブ` | キーフレームガイダンスによって変更されるポジティブコンディショニング入力です。 | CONDITIONING | 必須 | - | +| `ネガティブ` | キーフレームガイダンスによって変更されるネガティブコンディショニング入力です。 | CONDITIONING | 必須 | - | +| `vae` | 入力画像/ビデオのフレームをエンコードするために使用される VAE モデルです。 | VAE | 必須 | - | +| `潜在` | コンディショニングフレームを受け取る入力潜在シーケンスです。 | LATENT | 必須 | - | +| `画像` | 潜在ビデオをコンディショニングするための画像またはビデオです。8*n + 1 フレームでなければなりません。ビデオが 8*n + 1 フレームでない場合は、最も近い 8*n + 1 フレーム数にクロップされます。 | IMAGE | 必須 | - | +| `フレームインデックス` | コンディショニングを開始するフレームインデックスです。単一フレームの画像、または 1〜8 フレームのビデオの場合、`frame_idx` は任意の値で問題ありません。9 フレーム以上のビデオの場合、`frame_idx` は 8 で割り切れる必要があり、割り切れない場合は最も近い 8 の倍数に切り捨てられます。負の値はビデオの末尾から数えます。(デフォルト: 0) | INT | 必須 | -9999〜9999 | +| `強度` | コンディショニングの影響の強さです。1.0 では完全なコンディショニングが適用され、0.0 ではコンディショニングが適用されません。(デフォルト: 1.0) | FLOAT | 必須 | 0.0〜10.0 | +| `アテンションマスク` | オプションのピクセル空間の空間マスクです。セルフアテンションを介して領域ごとのコンディショニングの影響を制御し、`strength` と乗算されます。 | MASK | 任意 | - | +| `iclora_parameters` | 「Get IC-LoRA Parameters」ノードから取得されるオプションの IC-LoRA パラメータです。特定の IC-LoRA(例: `reference_downscale_factor` > 1 のもの)で必要とされるガイド処理の調整に使用されます。チェーン接続されている場合、各 LTXVAddGuide は自身に接続されているパラメータのみを使用します。 | IC_LORA_PARAMETERS | 任意 | - | -**注記:** 入力画像/ビデオは、8*n + 1パターン(例:1、9、17、25フレーム)に従ったフレーム数である必要があります。入力がこのパターンを超える場合、最も近い有効なフレーム数に自動的にクロップされます。 +**注記:** 入力画像/ビデオは、8*n + 1 パターン(例: 1、9、17、25 フレーム)のフレーム数に従う必要があります。入力がこのパターンを超える場合、最も近い有効なフレーム数に自動的にクロップされます。 -**`iclora_parameters`に関する注記:** `reference_downscale_factor`が1より大きいIC-LoRAパラメータを使用する場合、潜在表現の空間次元(幅と高さ)はその係数で割り切れる必要があります。この条件が満たされない場合、ノードはエラーを発生させます。 +**`iclora_parameters` に関する注記:** `reference_downscale_factor` が 1 より大きい IC-LoRA パラメータを使用する場合、潜在表現の空間次元(幅と高さ)はその係数で割り切れる必要があります。この条件を満たさない場合、ノードはエラーを発生させます。 + +**注記:** エンコードされたガイドフレームは、選択したフレーム位置で潜在シーケンス内に収まる必要があります。コンディショニングされたフレームが潜在シーケンスの長さを超える場合、ノードはエラーを発生させます。 + +**注記:** オーディオチャンネルとビデオチャンネルを組み合わせた潜在表現にガイドを追加することはサポートされておらず、エラーが発生します。 ## 出力 | 出力名 | 説明 | データ型 | | --- | --- | --- | -| `ポジティブ` | キーフレームガイダンス情報で更新されたポジティブ条件付け | CONDITIONING | -| `ネガティブ` | キーフレームガイダンス情報で更新されたネガティブ条件付け | CONDITIONING | -| `潜在` | 条件付けフレームと更新されたノイズマスクが組み込まれた潜在シーケンス | LATENT | +| `ポジティブ` | キーフレームガイダンス情報で更新されたポジティブコンディショニングです。 | CONDITIONING | +| `ネガティブ` | キーフレームガイダンス情報で更新されたネガティブコンディショニングです。 | CONDITIONING | +| `潜在` | コンディショニングフレームが組み込まれ、ノイズマスクが更新された潜在シーケンスです。 | LATENT | > このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVAddGuide/ja.md) --- -**Source fingerprint (SHA-256):** `3e0d1422fbd1b5b3e4c69e641af2ecdb5ae8de3f4368b336917a0dce4286771e` +**Source fingerprint (SHA-256):** `031bc9030dafed85b5ff1cbceae36234e9d5f77f7f4b040267067ecd16a27929` diff --git a/comfyui_embedded_docs/docs/LTXVAddGuide/ko.md b/comfyui_embedded_docs/docs/LTXVAddGuide/ko.md index f588dc966..b123eef9b 100644 --- a/comfyui_embedded_docs/docs/LTXVAddGuide/ko.md +++ b/comfyui_embedded_docs/docs/LTXVAddGuide/ko.md @@ -1,34 +1,38 @@ # LTXV 가이드 추가 -LTXVAddGuide 노드는 입력 이미지 또는 비디오를 인코딩하여 키프레임으로 conditioning 데이터에 통합함으로써 잠재(latent) 시퀀스에 비디오 conditioning 가이드를 추가합니다. VAE 인코더를 통해 입력을 처리하고 결과로 생성된 잠재(latent)를 지정된 프레임 위치에 전략적으로 배치하면서 긍정 및 부정 conditioning을 키프레임 정보로 업데이트합니다. 이 노드는 프레임 정렬 제약 조건을 처리하고 conditioning 영향의 강도를 제어할 수 있게 합니다. +LTXVAddGuide 노드는 입력 이미지 또는 비디오를 인코딩하고 이를 키프레임으로 컨디셔닝 데이터에 통합하여 잠재 시퀀스에 비디오 컨디셔닝 가이드를 추가합니다. 이 노드는 입력을 VAE 인코더로 처리하고, 결과로 생성된 잠재(latent) 표현을 지정된 프레임 위치에 배치하며, 키프레임 정보로 포지티브 및 네거티브 컨디셔닝을 업데이트합니다. 또한 이 노드는 프레임 정렬 제약 조건을 처리하고 컨디셔닝 영향의 강도를 제어할 수 있게 합니다. ## 입력 -| 매개변수 | 설명 | 데이터 유형 | 필수 | 범위 | +| 매개변수 | 설명 | 데이터 타입 | 필수 여부 | 범위 | | --- | --- | --- | --- | --- | -| `긍정 조건` | 키프레임 가이드로 수정할 긍정 conditioning 입력 | CONDITIONING | 예 | - | -| `부정 조건` | 키프레임 가이드로 수정할 부정 conditioning 입력 | CONDITIONING | 예 | - | -| `vae` | 입력 이미지/비디오 프레임을 인코딩하는 데 사용되는 VAE 모델 | VAE | 예 | - | -| `잠재 비디오` | conditioning 프레임을 전달받을 입력 잠재(latent) 시퀀스 | LATENT | 예 | - | -| `이미지` | 잠재 비디오를 conditioning하는 데 사용할 이미지 또는 비디오. 8*n + 1 프레임이어야 합니다. 비디오가 8*n + 1 프레임이 아닌 경우 가장 가까운 8*n + 1 프레임으로 크롭됩니다. | IMAGE | 예 | - | -| `프레임 번호` | conditioning을 시작할 프레임 인덱스. 단일 프레임 이미지 또는 1~8프레임 비디오의 경우 frame_idx 값은 무엇이든 허용됩니다. 9프레임 이상의 비디오의 경우 frame_idx는 8로 나누어 떨어져야 하며, 그렇지 않으면 가장 가까운 8의 배수로 내림 처리됩니다. 음수 값은 비디오의 끝에서부터 계산됩니다. (기본값: 0) | INT | 예 | -9999 ~ 9999 | -| `강도` | conditioning 영향의 강도. 1.0은 전체 conditioning을 적용하고 0.0은 conditioning을 적용하지 않습니다. (기본값: 1.0) | FLOAT | 예 | 0.0 ~ 10.0 | -| `attention_mask` | 선택적 픽셀 공간 마스크. self-attention을 통해 지역별 conditioning 영향을 제어하며 strength에 곱해집니다. | MASK | 아니요 | - | -| `iclora_parameters` | Get IC-LoRA Parameters 노드에서 가져온 선택적 IC-LoRA 매개변수. 특정 IC-LoRA(예: reference_downscale_factor > 1인 IC-LoRA)에서 요구하는 대로 가이드 처리를 조정하는 데 사용됩니다. 체인으로 연결된 경우 각 LTXVAddGuide는 자신에게 연결된 매개변수만 사용합니다. | IC_LORA_PARAMETERS | 아니요 | - | +| `긍정 조건` | 키프레임 가이드에 의해 수정될 포지티브 컨디셔닝 입력입니다. | CONDITIONING | 예 | - | +| `부정 조건` | 키프레임 가이드에 의해 수정될 네거티브 컨디셔닝 입력입니다. | CONDITIONING | 예 | - | +| `vae` | 입력 이미지/비디오 프레임을 인코딩하는 데 사용되는 VAE 모델입니다. | VAE | 예 | - | +| `잠재 비디오` | 컨디셔닝 프레임을 전달받을 입력 잠재 시퀀스입니다. | LATENT | 예 | - | +| `이미지` | 잠재 비디오를 컨디셔닝하는 데 사용할 이미지 또는 비디오입니다. 프레임 수는 8*n + 1이어야 합니다. 비디오의 프레임 수가 8*n + 1이 아닌 경우 가장 가까운 8*n + 1 프레임 수로 잘립니다. | IMAGE | 예 | - | +| `프레임 번호` | 컨디셔닝을 시작할 프레임 인덱스입니다. 단일 프레임 이미지 또는 1~8프레임 비디오에서는 `frame_idx` 값이 무엇이든 허용됩니다. 9프레임 이상의 비디오에서는 `frame_idx`가 8로 나누어 떨어져야 하며, 그렇지 않으면 가장 가까운 8의 배수로 내림됩니다. 음수 값은 비디오의 끝에서부터 계산됩니다. (기본값: 0) | INT | 예 | -9999~9999 | +| `강도` | 컨디셔닝 영향의 강도입니다. 1.0은 컨디셔닝을 완전히 적용하고 0.0은 컨디셔닝을 적용하지 않습니다. (기본값: 1.0) | FLOAT | 예 | 0.0~10.0 | +| `attention_mask` | 픽셀 공간에서 정의되는 선택적 공간 마스크입니다. 자기 어텐션(self-attention)을 통해 영역별 컨디셔닝 영향을 제어하며, `strength` 값에 곱해집니다. | MASK | 아니요 | - | +| `iclora_parameters` | Get IC-LoRA Parameters 노드에서 얻은 선택적 IC-LoRA 매개변수입니다. 특정 IC-LoRA(예: `reference_downscale_factor`가 1보다 큰 IC-LoRA)에서 요구하는 가이드 처리를 조정하는 데 사용됩니다. 연결(체이닝) 시 각 LTXVAddGuide 노드는 자신에게 연결된 매개변수만 사용합니다. | IC_LORA_PARAMETERS | 아니요 | - | -**참고:** 입력 이미지/비디오는 8*n + 1 패턴(예: 1, 9, 17, 25프레임)의 프레임 수를 따라야 합니다. 입력 프레임 수가 이 패턴을 벗어나는 경우 가장 가까운 유효한 프레임 수로 자동 크롭됩니다. +**참고:** 입력 이미지/비디오의 프레임 수는 8*n + 1 패턴(예: 1, 9, 17, 25프레임)을 따라야 합니다. 입력이 이 패턴을 벗어나면 가장 가까운 유효 프레임 수로 자동으로 잘립니다. -**`iclora_parameters` 참고:** `reference_downscale_factor`가 1보다 큰 IC-LoRA 매개변수를 사용하는 경우 잠재(latent) 공간 차원(너비 및 높이)이 해당 인자로 나누어 떨어져야 합니다. 이 조건이 충족되지 않으면 노드에서 오류가 발생합니다. +**`iclora_parameters` 관련 참고:** `reference_downscale_factor`가 1보다 큰 IC-LoRA 매개변수를 사용하는 경우 잠재 표현의 공간 차원(너비 및 높이)이 해당 인자로 나누어 떨어져야 합니다. 이 조건이 충족되지 않으면 노드에서 오류가 발생합니다. + +**참고:** 인코딩된 가이드 프레임은 선택한 프레임 위치에서 잠재 시퀀스 길이 안에 맞아야 합니다. 컨디셔닝된 프레임이 잠재 시퀀스의 길이를 초과하면 노드에서 오류가 발생합니다. + +**참고:** 오디오 및 비디오 채널이 결합된 잠재에 가이드를 추가하는 것은 지원되지 않으며, 오류가 발생합니다. ## 출력 -| 출력 이름 | 설명 | 데이터 유형 | +| 출력 이름 | 설명 | 데이터 타입 | | --- | --- | --- | -| `긍정 조건` | 키프레임 가이드 정보로 업데이트된 긍정 conditioning | CONDITIONING | -| `부정 조건` | 키프레임 가이드 정보로 업데이트된 부정 conditioning | CONDITIONING | -| `잠재 비디오` | conditioning 프레임이 통합되고 노이즈 마스크가 업데이트된 잠재(latent) 시퀀스 | LATENT | +| `긍정 조건` | 키프레임 가이드 정보로 업데이트된 포지티브 컨디셔닝입니다. | CONDITIONING | +| `부정 조건` | 키프레임 가이드 정보로 업데이트된 네거티브 컨디셔닝입니다. | CONDITIONING | +| `잠재 비디오` | 컨디셔닝 프레임과 업데이트된 노이즈 마스크가 통합된 잠재 시퀀스입니다. | LATENT | > 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVAddGuide/ko.md) --- -**Source fingerprint (SHA-256):** `3e0d1422fbd1b5b3e4c69e641af2ecdb5ae8de3f4368b336917a0dce4286771e` +**Source fingerprint (SHA-256):** `031bc9030dafed85b5ff1cbceae36234e9d5f77f7f4b040267067ecd16a27929` diff --git a/comfyui_embedded_docs/docs/LTXVAddGuide/pt-BR.md b/comfyui_embedded_docs/docs/LTXVAddGuide/pt-BR.md index 76174eb75..577b118b7 100644 --- a/comfyui_embedded_docs/docs/LTXVAddGuide/pt-BR.md +++ b/comfyui_embedded_docs/docs/LTXVAddGuide/pt-BR.md @@ -1,34 +1,38 @@ # LTXVAddGuide -O nó LTXVAddGuide adiciona orientação de condicionamento de vídeo a sequências latentes, codificando imagens ou vídeos de entrada e incorporando-os como keyframes nos dados de condicionamento. Ele processa a entrada por meio de um codificador VAE e posiciona estrategicamente os latents resultantes em posições de quadro especificadas, atualizando tanto o condicionamento positivo quanto o negativo com informações de keyframe. O nó lida com restrições de alinhamento de quadros e permite controlar a força da influência do condicionamento. +O nó LTXVAddGuide adiciona orientação de condicionamento de vídeo às sequências latentes codificando imagens ou vídeos de entrada e incorporando-os como quadros-chave nos dados de condicionamento. Ele processa a entrada por meio de um codificador VAE e posiciona estrategicamente os latentes resultantes em posições de quadro especificadas, atualizando o condicionamento positivo e o negativo com as informações dos quadros-chave. O nó lida com restrições de alinhamento de quadros e permite controlar a força da influência do condicionamento. ## Entradas -| Parâmetro | Descrição | Tipo de Dado | Obrigatório | Intervalo | +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | | --- | --- | --- | --- | --- | -| `positive` | Entrada de condicionamento positivo a ser modificada com a orientação por keyframes | CONDITIONING | Sim | - | -| `negative` | Entrada de condicionamento negativo a ser modificada com a orientação por keyframes | CONDITIONING | Sim | - | +| `positive` | Entrada de condicionamento positivo a ser modificada com orientação por quadros-chave | CONDITIONING | Sim | - | +| `negative` | Entrada de condicionamento negativo a ser modificada com orientação por quadros-chave | CONDITIONING | Sim | - | | `vae` | Modelo VAE usado para codificar os quadros de imagem/vídeo de entrada | VAE | Sim | - | | `latent` | Sequência latente de entrada que receberá os quadros de condicionamento | LATENT | Sim | - | -| `image` | Imagem ou vídeo para condicionar o vídeo latente. Deve ter 8*n + 1 quadros. Se o vídeo não tiver 8*n + 1 quadros, ele será cortado para o valor mais próximo de 8*n + 1 quadros. | IMAGE | Sim | - | -| `frame_idx` | Índice do quadro no qual o condicionamento começará. Para imagens de quadro único ou vídeos com 1 a 8 quadros, qualquer valor de `frame_idx` é aceitável. Para vídeos com 9 ou mais quadros, `frame_idx` deve ser divisível por 8; caso contrário, será arredondado para baixo até o múltiplo de 8 mais próximo. Valores negativos são contados a partir do final do vídeo. (padrão: 0) | INT | Sim | -9999 a 9999 | -| `strength` | Força da influência do condicionamento, em que 1.0 aplica condicionamento total e 0.0 não aplica condicionamento (padrão: 1.0) | FLOAT | Sim | 0.0 a 10.0 | -| `attention_mask` | Máscara espacial opcional no espaço dos pixels. Controla a influência do condicionamento por região por meio da autoatenção, multiplicada pela `strength`. | MASK | Não | - | -| `iclora_parameters` | Parâmetros IC-LoRA opcionais de um nó Get IC-LoRA Parameters. Usados para ajustar o processamento da orientação conforme exigido por determinados IC-LoRAs (por exemplo, aqueles com `reference_downscale_factor` > 1). Quando encadeados, cada LTXVAddGuide usa apenas os parâmetros conectados a ele. | IC_LORA_PARAMETERS | Não | - | +| `image` | Imagem ou vídeo para condicionar o vídeo latente. Deve ter 8*n + 1 quadros. Se o vídeo não tiver 8*n + 1 quadros, ele será cortado para a quantidade válida mais próxima de 8*n + 1 quadros. | IMAGE | Sim | - | +| `frame_idx` | Índice do quadro no qual o condicionamento começa. Para imagens de quadro único ou vídeos com 1 a 8 quadros, qualquer valor de `frame_idx` é aceitável. Para vídeos com 9 ou mais quadros, `frame_idx` deve ser divisível por 8; caso contrário, será arredondado para baixo até o múltiplo de 8 mais próximo. Valores negativos são contados a partir do final do vídeo. (padrão: 0) | INT | Sim | -9999 a 9999 | +| `strength` | Força da influência do condicionamento, em que 1.0 aplica condicionamento total e 0.0 não aplica condicionamento algum (padrão: 1.0) | FLOAT | Sim | 0.0 a 10.0 | +| `attention_mask` | Máscara espacial opcional no espaço de pixels. Controla a influência do condicionamento por região por meio da autoatenção, sendo multiplicada pela força. | MASK | Não | - | +| `iclora_parameters` | Parâmetros IC-LoRA opcionais provenientes de um nó Get IC-LoRA Parameters. Usados para ajustar o processamento da orientação conforme exigido por determinados IC-LoRAs (por exemplo, aqueles com `reference_downscale_factor` maior que 1). Quando encadeados, cada LTXVAddGuide usa somente os parâmetros conectados a ele. | IC_LORA_PARAMETERS | Não | - | -**Observação:** A imagem/vídeo de entrada deve ter uma contagem de quadros seguindo o padrão 8*n + 1 (por exemplo, 1, 9, 17, 25 quadros). Se a entrada exceder esse padrão, ela será automaticamente cortada para a contagem de quadros válida mais próxima. +**Observação:** A imagem/vídeo de entrada deve ter uma contagem de quadros que siga o padrão 8*n + 1 (por exemplo, 1, 9, 17, 25 quadros). Se a entrada estiver fora desse padrão, ela será automaticamente cortada para a contagem de quadros válida mais próxima. -**Observação sobre `iclora_parameters`:** Ao usar parâmetros IC-LoRA com `reference_downscale_factor` maior que 1, as dimensões espaciais latentes (largura e altura) devem ser divisíveis por esse fator. O nó gerará um erro se essa condição não for atendida. +**Observação sobre `iclora_parameters`:** Ao usar parâmetros IC-LoRA com `reference_downscale_factor` maior que 1, as dimensões espaciais do latente (largura e altura) devem ser divisíveis por esse fator. O nó gerará um erro se essa condição não for atendida. + +**Observação:** Os quadros de orientação codificados devem caber dentro da sequência latente na posição de quadro selecionada. Se esses quadros excederem o comprimento da sequência latente, o nó gerará um erro. + +**Observação:** Não há suporte para adicionar uma orientação a um latente que combine canais de áudio e vídeo; isso gerará um erro. ## Saídas -| Nome da Saída | Descrição | Tipo de Dado | +| Nome da Saída | Descrição | Tipo de Dados | | --- | --- | --- | -| `positive` | Condicionamento positivo atualizado com informações de orientação por keyframes | CONDITIONING | -| `negative` | Condicionamento negativo atualizado com informações de orientação por keyframes | CONDITIONING | +| `positive` | Condicionamento positivo atualizado com informações de orientação por quadros-chave | CONDITIONING | +| `negative` | Condicionamento negativo atualizado com informações de orientação por quadros-chave | CONDITIONING | | `latent` | Sequência latente com quadros de condicionamento incorporados e máscara de ruído atualizada | 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/LTXVAddGuide/pt-BR.md) --- -**Source fingerprint (SHA-256):** `3e0d1422fbd1b5b3e4c69e641af2ecdb5ae8de3f4368b336917a0dce4286771e` +**Source fingerprint (SHA-256):** `031bc9030dafed85b5ff1cbceae36234e9d5f77f7f4b040267067ecd16a27929` diff --git a/comfyui_embedded_docs/docs/LTXVAddGuide/ru.md b/comfyui_embedded_docs/docs/LTXVAddGuide/ru.md index dab9f25d3..52f305dd5 100644 --- a/comfyui_embedded_docs/docs/LTXVAddGuide/ru.md +++ b/comfyui_embedded_docs/docs/LTXVAddGuide/ru.md @@ -1,34 +1,38 @@ # LTXVAddGuide -Узел LTXVAddGuide добавляет к латентным последовательностям направляющее кондиционирование видео: он кодирует входные изображения или видео через VAE-энкодер и встраивает полученные латентные представления в данные кондиционирования в качестве ключевых кадров. При этом положительное и отрицательное кондиционирование обновляются информацией о ключевых кадрах. Узел учитывает ограничения выравнивания кадров и позволяет управлять силой влияния кондиционирования. +Узел LTXVAddGuide добавляет управляющее видеокондиционирование к последовательностям скрытых представлений (latent), кодируя входные изображения или видео и встраивая их в данные кондиционирования в качестве ключевых кадров. Он обрабатывает входные данные через VAE-энкодер и стратегически размещает полученные скрытые представления в указанных позициях кадров, обновляя при этом как позитивное, так и негативное кондиционирование информацией о ключевых кадрах. Узел обрабатывает ограничения выравнивания кадров и позволяет контролировать силу влияния кондиционирования. ## Входы -| Параметр | Описание | Тип данных | Обязательность | Диапазон | +| Параметр | Описание | Тип данных | Обязательный | Диапазон | | --- | --- | --- | --- | --- | -| `положительный` | Входное положительное кондиционирование, которое будет изменено с использованием направляющей информации о ключевых кадрах | CONDITIONING | Да | - | -| `отрицательный` | Входное отрицательное кондиционирование, которое будет изменено с использованием направляющей информации о ключевых кадрах | CONDITIONING | Да | - | +| `положительный` | Позитивное кондиционирование, которое будет изменено с помощью ключевых кадров управления | CONDITIONING | Да | - | +| `отрицательный` | Негативное кондиционирование, которое будет изменено с помощью ключевых кадров управления | CONDITIONING | Да | - | | `vae` | Модель VAE, используемая для кодирования входных кадров изображения/видео | VAE | Да | - | -| `скрытое пространство` | Входная латентная последовательность, в которую будут добавлены кадры кондиционирования | LATENT | Да | - | -| `изображение` | Изображение или видео для кондиционирования латентного видео. Количество кадров должно быть вида 8*n + 1. Если количество кадров видео не равно 8*n + 1, оно будет обрезано до ближайшего количества кадров вида 8*n + 1. | IMAGE | Да | - | -| `индекс кадра` | Индекс кадра, с которого начинается кондиционирование. Для однокадровых изображений или видео с 1–8 кадрами допустимо любое значение frame_idx. Для видео с 9 и более кадрами frame_idx должен делиться на 8; в противном случае он будет округлен вниз до ближайшего числа, кратного 8. Отрицательные значения отсчитываются от конца видео. (по умолчанию: 0) | INT | Да | -9999 до 9999 | -| `сила` | Сила влияния кондиционирования, где 1.0 применяет полное кондиционирование, а 0.0 — не применяет кондиционирования (по умолчанию: 1.0) | FLOAT | Да | 0.0 до 10.0 | -| `attention_mask` | Необязательная пространственная маска в пиксельном пространстве. Управляет влиянием кондиционирования на отдельные области через механизм самовнимания; значение умножается на strength. | MASK | Нет | - | -| `iclora_parameters` | Необязательные параметры IC-LoRA из узла Get IC-LoRA Parameters. Используются для настройки обработки направляющего кондиционирования в соответствии с требованиями некоторых IC-LoRA (например, тех, у которых `reference_downscale_factor` больше 1). При последовательном подключении каждый узел LTXVAddGuide использует только параметры, подключенные к нему. | IC_LORA_PARAMETERS | Нет | - | +| `скрытое пространство` | Входная последовательность скрытых представлений, которая получит кадры кондиционирования | LATENT | Да | - | +| `изображение` | Изображение или видео, используемое для кондиционирования скрытого видео. Должно содержать кадры в количестве 8*n + 1. Если видео содержит не 8*n + 1 кадров, оно будет обрезано до ближайшего количества кадров вида 8*n + 1. | IMAGE | Да | - | +| `индекс кадра` | Индекс кадра, с которого начинается кондиционирование. Для одиночных изображений или видео с 1–8 кадрами допустимо любое значение `frame_idx`. Для видео с 9+ кадрами `frame_idx` должен делиться на 8, иначе он будет округлён вниз до ближайшего кратного 8. Отрицательные значения отсчитываются от конца видео. (по умолчанию: 0) | INT | Да | -9999 до 9999 | +| `сила` | Сила влияния кондиционирования, где 1.0 применяет полное кондиционирование, а 0.0 — не применяет кондиционирование (по умолчанию: 1.0) | FLOAT | Да | 0.0 до 10.0 | +| `attention_mask` | Необязательная пространственная маска в пространстве пикселей. Управляет влиянием кондиционирования на отдельные области через механизм самовнимания, умножается на `strength`. | MASK | Нет | - | +| `iclora_parameters` | Необязательные параметры IC-LoRA из узла Get IC-LoRA Parameters. Используются для настройки обработки управления в соответствии с требованиями определённых IC-LoRA (например, тех, у которых `reference_downscale_factor` > 1). При последовательном соединении каждый узел LTXVAddGuide использует только подключённые к нему параметры. | IC_LORA_PARAMETERS | Нет | - | -**Примечание:** Входное изображение/видео должно иметь количество кадров, соответствующее шаблону 8*n + 1 (например, 1, 9, 17, 25 кадров). Если входные данные не соответствуют этому шаблону, они будут автоматически обрезаны до ближайшего допустимого количества кадров. +**Примечание:** Входное изображение/видео должно иметь количество кадров, следующее шаблону 8*n + 1 (например, 1, 9, 17, 25 кадров). Если входные данные превышают этот шаблон, они будут автоматически обрезаны до ближайшего допустимого количества кадров. -**Примечание о `iclora_parameters`:** При использовании параметров IC-LoRA с `reference_downscale_factor` больше 1 пространственные размеры латентного представления (ширина и высота) должны делиться на этот коэффициент. Если это условие не выполняется, узел выдаст ошибку. +**Примечание об `iclora_parameters`:** При использовании параметров IC-LoRA с `reference_downscale_factor` больше 1 пространственные размеры скрытого представления (ширина и высота) должны быть кратны этому коэффициенту. Узел выдаст ошибку, если это условие не выполнено. + +**Примечание:** Закодированные кадры управления должны помещаться в последовательность скрытого представления в выбранной позиции кадра. Если обработанные кадры превышают длину последовательности скрытого представления, узел выдаёт ошибку. + +**Примечание:** Добавление управления к скрытому представлению, объединяющему аудио- и видеоканалы, не поддерживается и вызовет ошибку. ## Выходы -| Имя выхода | Описание | Тип данных | +| Выходное имя | Описание | Тип данных | | --- | --- | --- | -| `положительный` | Положительное кондиционирование, обновленное с учетом направляющей информации о ключевых кадрах | CONDITIONING | -| `отрицательный` | Отрицательное кондиционирование, обновленное с учетом направляющей информации о ключевых кадрах | CONDITIONING | -| `скрытое пространство` | Латентная последовательность со встроенными кадрами кондиционирования и обновленной маской шума | LATENT | +| `положительный` | Позитивное кондиционирование, обновлённое информацией о ключевых кадрах управления | CONDITIONING | +| `отрицательный` | Негативное кондиционирование, обновлённое информацией о ключевых кадрах управления | CONDITIONING | +| `скрытое пространство` | Последовательность скрытого представления со встроенными кадрами кондиционирования и обновлённой маской шума | LATENT | > Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVAddGuide/ru.md) --- -**Source fingerprint (SHA-256):** `3e0d1422fbd1b5b3e4c69e641af2ecdb5ae8de3f4368b336917a0dce4286771e` +**Source fingerprint (SHA-256):** `031bc9030dafed85b5ff1cbceae36234e9d5f77f7f4b040267067ecd16a27929` diff --git a/comfyui_embedded_docs/docs/LTXVAddGuide/tr.md b/comfyui_embedded_docs/docs/LTXVAddGuide/tr.md index 1aeed7316..99917eafc 100644 --- a/comfyui_embedded_docs/docs/LTXVAddGuide/tr.md +++ b/comfyui_embedded_docs/docs/LTXVAddGuide/tr.md @@ -1,34 +1,38 @@ # LTXVRehberEkle -LTXVAddGuide düğümü, giriş görüntülerini veya videolarını kodlayarak ve bunları koşullandırma verilerine anahtar kareler olarak dahil ederek latent dizilere video koşullandırma rehberliği ekler. Girişi bir VAE kodlayıcı aracılığıyla işler ve ortaya çıkan latentleri belirtilen kare konumlarına stratejik olarak yerleştirirken, hem pozitif hem de negatif koşullandırmayı anahtar kare bilgileriyle günceller. Düğüm, kare hizalama kısıtlamalarını yönetir ve koşullandırma etkisinin gücü üzerinde kontrol sağlar. +LTXVAddGuide düğümü, girdi görüntülerini veya videolarını kodlayıp bunları koşullandırma verisine ana kareler olarak ekleyerek latent dizilere video koşullandırma rehberliği ekler. Girdiyi bir VAE kodlayıcıdan geçirir ve elde edilen latentleri belirtilen kare konumlarına stratejik olarak yerleştirirken, hem pozitif hem de negatif koşullandırmayı ana kare bilgisiyle günceller. Düğüm, kare hizalama kısıtlamalarını yönetir ve koşullandırma etkisinin gücü üzerinde kontrol sağlar. ## Girdiler | Parametre | Açıklama | Veri Türü | Gerekli | Aralık | | --- | --- | --- | --- | --- | -| `pozitif` | Anahtar kare rehberliğiyle değiştirilecek pozitif koşullandırma girdisi | CONDITIONING | Evet | - | -| `negatif` | Anahtar kare rehberliğiyle değiştirilecek negatif koşullandırma girdisi | CONDITIONING | Evet | - | -| `vae` | Giriş görüntüsünü/video karelerini kodlamak için kullanılan VAE modeli | VAE | Evet | - | -| `gizli` | Koşullandırma karelerini alacak giriş latent dizisi | LATENT | Evet | - | -| `görüntü` | Latent videonun koşullandırılacağı görüntü veya video. 8*n + 1 kare olmalıdır. Video 8*n + 1 kare değilse, en yakın 8*n + 1 kareye kırpılır. | IMAGE | Evet | - | -| `kare_indeksi` | Koşullandırmanın başlayacağı kare dizini. Tek karelik görüntüler veya 1-8 kareli videolar için herhangi bir frame_idx değeri kabul edilebilir. 9+ kareli videolar için frame_idx 8'e bölünebilir olmalıdır, aksi takdirde 8'in en yakın katına aşağı yuvarlanır. Negatif değerler videonun sonundan itibaren sayılır. (varsayılan: 0) | INT | Evet | -9999 ila 9999 | -| `güç` | Koşullandırma etkisinin gücü; 1.0 tam koşullandırma uygular, 0.0 koşullandırma uygulamaz (varsayılan: 1.0) | FLOAT | Evet | 0.0 ila 10.0 | -| `attention_mask` | İsteğe bağlı piksel uzayı uzamsal maskesi. Öz-dikkat yoluyla bölge bazında koşullandırma etkisini kontrol eder, strength ile çarpılır. | MASK | Hayır | - | -| `iclora_parameters` | Get IC-LoRA Parameters düğümünden alınan isteğe bağlı IC-LoRA parametreleri. Belirli IC-LoRA'ların gerektirdiği şekilde rehber işlemeyi ayarlamak için kullanılır (örn. reference_downscale_factor > 1 olanlar). Zincirlendiğinde, her LTXVAddGuide yalnızca kendisine bağlı parametreleri kullanır. | IC_LORA_PARAMETERS | Hayır | - | +| `pozitif` | Ana kare rehberliğiyle değiştirilecek pozitif koşullandırma girdisi | CONDITIONING | Evet | - | +| `negatif` | Ana kare rehberliğiyle değiştirilecek negatif koşullandırma girdisi | CONDITIONING | Evet | - | +| `vae` | Girdi görüntü/video karelerini kodlamak için kullanılan VAE modeli | VAE | Evet | - | +| `gizli` | Koşullandırma karelerini alacak girdi latent dizisi | LATENT | Evet | - | +| `görüntü` | Latent videoyu koşullandırmak için kullanılacak görüntü veya video. 8*n + 1 kare olmalıdır. Video 8*n + 1 kare değilse, en yakın 8*n + 1 kare sayısına kırpılır. | IMAGE | Evet | - | +| `kare_indeksi` | Koşullandırmanın başlatılacağı kare dizini. Tek kare görüntüler veya 1-8 kare içeren videolar için herhangi bir frame_idx değeri kabul edilebilir. 9 veya daha fazla kare içeren videolar için frame_idx 8'e bölünebilir olmalıdır; aksi takdirde en yakın 8'in katına aşağı yuvarlanır. Negatif değerler videonun sonundan itibaren sayılır. (varsayılan: 0) | INT | Evet | -9999 - 9999 | +| `güç` | Koşullandırma etkisinin gücü; 1.0 tam koşullandırma uygular, 0.0 koşullandırma uygulamaz (varsayılan: 1.0) | FLOAT | Evet | 0.0 - 10.0 | +| `attention_mask` | İsteğe bağlı piksel uzayında uzamsal maske. Kendine dikkat (self-attention) mekanizması aracılığıyla bölge bazında koşullandırma etkisini kontrol eder; strength değeriyle çarpılır. | MASK | Hayır | - | +| `iclora_parameters` | Get IC-LoRA Parameters düğümünden alınan isteğe bağlı IC-LoRA parametreleri. Belirli IC-LoRA'ların gerektirdiği şekilde rehber işlemesini ayarlamak için kullanılır (örn. reference_downscale_factor > 1 olanlar). Zincirleme kullanımda her LTXVAddGuide yalnızca kendisine bağlı parametreleri kullanır. | IC_LORA_PARAMETERS | Hayır | - | -**Not:** Giriş görüntüsü/videosu, 8*n + 1 desenini izleyen bir kare sayısına sahip olmalıdır (örn. 1, 9, 17, 25 kare). Giriş bu deseni aşarsa, otomatik olarak en yakın geçerli kare sayısına kırpılır. +**Not:** Girdi görüntü/video, 8*n + 1 düzenini izleyen bir kare sayısına sahip olmalıdır (örn. 1, 9, 17, 25 kare). Girdi bu düzeni aşarsa, otomatik olarak en yakın geçerli kare sayısına kırpılır. -**`iclora_parameters` hakkında not:** `reference_downscale_factor` değeri 1'den büyük olan IC-LoRA parametreleri kullanılırken, latent uzamsal boyutları (genişlik ve yükseklik) bu faktöre bölünebilir olmalıdır. Bu koşul sağlanmazsa düğüm bir hata verir. +**`iclora_parameters` hakkında not:** `reference_downscale_factor` değeri 1'den büyük olan IC-LoRA parametreleri kullanıldığında, latent uzamsal boyutları (genişlik ve yükseklik) bu faktöre bölünebilir olmalıdır. Bu koşul sağlanmazsa düğüm bir hata verir. + +**Not:** Kodlanmış rehber kareleri, seçilen kare konumunda latent dizinin içine sığmalıdır. Koşullandırılan kareler latent dizinin uzunluğunu aşarsa düğüm bir hata verir. + +**Not:** Ses ve video kanallarını birleştiren bir latente rehber eklenmesi desteklenmez ve hata verir. ## Çıktılar | Çıktı Adı | Açıklama | Veri Türü | | --- | --- | --- | -| `pozitif` | Anahtar kare rehberlik bilgileriyle güncellenmiş pozitif koşullandırma | CONDITIONING | -| `negatif` | Anahtar kare rehberlik bilgileriyle güncellenmiş negatif koşullandırma | CONDITIONING | -| `gizli` | Dahil edilmiş koşullandırma kareleri ve güncellenmiş gürültü maskesi içeren latent dizisi | LATENT | +| `pozitif` | Ana kare rehberlik bilgisiyle güncellenmiş pozitif koşullandırma | CONDITIONING | +| `negatif` | Ana kare rehberlik bilgisiyle güncellenmiş negatif koşullandırma | CONDITIONING | +| `gizli` | Koşullandırma kareleri eklenmiş ve gürültü maskesi güncellenmiş latent dizi | 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/LTXVAddGuide/tr.md) --- -**Source fingerprint (SHA-256):** `3e0d1422fbd1b5b3e4c69e641af2ecdb5ae8de3f4368b336917a0dce4286771e` +**Source fingerprint (SHA-256):** `031bc9030dafed85b5ff1cbceae36234e9d5f77f7f4b040267067ecd16a27929` diff --git a/comfyui_embedded_docs/docs/LTXVAddGuide/zh-TW.md b/comfyui_embedded_docs/docs/LTXVAddGuide/zh-TW.md index 23995a8ca..d3443b851 100644 --- a/comfyui_embedded_docs/docs/LTXVAddGuide/zh-TW.md +++ b/comfyui_embedded_docs/docs/LTXVAddGuide/zh-TW.md @@ -1,34 +1,36 @@ # LTXV 添加引導 -LTXVAddGuide 節點透過編碼輸入的影像或影片,並將其作為關鍵幀納入條件資料中,為潛在序列加入影片條件引導。它會透過 VAE 編碼器處理輸入,並將產生的潛在向量策略性地放置在指定的幀位置,同時以關鍵幀資訊更新正向與負向條件。此節點負責處理幀對齊約束,並可控制條件影響的強度。 +LTXVAddGuide 節點透過編碼輸入的圖像或影片,並將其作為關鍵影格整合到條件資料中,為潛在序列加入影片條件引導。它會透過 VAE 編碼器處理輸入,並將產生的潛在資料策略性地放置在指定的影格位置,同時以關鍵影格資訊更新正向與負向條件。此節點會處理影格對齊限制,並允許控制條件影響的強度。 ## 輸入 - -| 參數 | 描述 | 資料類型 | 必要 | 範圍 | +| 參數 | 描述 | 資料類型 | 必填 | 範圍 | | --- | --- | --- | --- | --- | -| `正向` | 要透過關鍵幀引導修改的正向條件輸入 | CONDITIONING | 是 | - | -| `負向` | 要透過關鍵幀引導修改的負向條件輸入 | CONDITIONING | 是 | - | -| `vae` | 用於編碼輸入影像/影片幀的 VAE 模型 | VAE | 是 | - | -| `潛在空間` | 將接收條件幀的輸入潛在序列 | LATENT | 是 | - | -| `影像` | 用於對潛在影片進行條件的影像或影片。必須是 8*n + 1 幀。如果影片不是 8*n + 1 幀,則會裁剪至最近的 8*n + 1 幀。 | IMAGE | 是 | - | -| `起始幀索引` | 開始條件化的幀索引。對於單幀影像或具有 1-8 幀的影片,任何 `frame_idx` 值都可以接受。對於具有 9 幀以上的影片,`frame_idx` 必須能被 8 整除,否則將向下取整至最接近的 8 的倍數。負值從影片結尾開始計算。(預設值:0) | INT | 是 | -9999 至 9999 | -| `強度` | 條件影響的強度,其中 1.0 套用完整條件化,0.0 不套用任何條件化。(預設值:1.0) | FLOAT | 是 | 0.0 至 10.0 | -| `注意力遮罩` | 選用的像素空間空間遮罩。透過自注意力控制各區域的條件影響,並與 `strength` 相乘。 | MASK | 否 | - | -| `iclora_parameters` | 選用的 IC-LoRA 參數,來自 Get IC-LoRA Parameters 節點。用於根據特定 IC-LoRA(例如具有 `reference_downscale_factor` > 1 的 IC-LoRA)的需求調整引導處理。當串接時,每個 LTXVAddGuide 只使用連接到它的參數。 | IC_LORA_PARAMETERS | 否 | - | +| `正向` | 將以關鍵影格引導進行修改的正向條件輸入 | CONDITIONING | 是 | - | +| `負向` | 將以關鍵影格引導進行修改的負向條件輸入 | CONDITIONING | 是 | - | +| `vae` | 用於編碼輸入圖像/影片影格的 VAE 模型 | VAE | 是 | - | +| `潛在空間` | 將接收條件影格的輸入潛在序列 | LATENT | 是 | - | +| `影像` | 用於對潛在影片進行條件化的圖像或影片。必須為 8*n + 1 個影格。如果影片並非 8*n + 1 個影格,則會自動裁切至最接近的有效影格數 | IMAGE | 是 | - | +| `起始幀索引` | 開始進行條件化的影格索引。對於單影格圖像或 1-8 個影格的影片,任何 `frame_idx` 值皆可接受。對於 9 個影格以上的影片,`frame_idx` 必須能被 8 整除,否則會向下取整至最接近的 8 的倍數。負值會從影片末尾開始倒數計算。(預設值:0) | INT | 是 | -9999至9999 | +| `強度` | 條件影響的強度,1.0 表示完全套用條件化,0.0 表示不套用條件化(預設值:1.0) | FLOAT | 是 | 0.0至10.0 | +| `注意力遮罩` | 選用的像素空間空間遮罩。透過自注意力控制每個區域的條件化影響,並與 `strength` 相乘 | MASK | 否 | - | +| `iclora_parameters` | 選用的 IC-LoRA 參數,來自 Get IC-LoRA Parameters 節點。用於依照特定 IC-LoRA(例如具有 `reference_downscale_factor` > 1 的 IC-LoRA)的需求調整引導處理。當串接使用時,每個 LTXVAddGuide 只會使用與其連接的參數 | IC_LORA_PARAMETERS | 否 | - | -**注意:** 輸入的影像/影片必須具有符合 8*n + 1 模式的幀數(例如 1、9、17、25 幀)。如果輸入超出此模式,將自動裁剪至最接近的有效幀數。 +**注意:** 輸入的圖像/影片必須具有符合 8*n + 1 模式的影格數量(例如 1、9、17、25 個影格)。如果輸入未符合此模式,則會自動裁切至最接近的有效影格數。 -**關於 `iclora_parameters` 的注意事項:** 當使用 `reference_downscale_factor` 大於 1 的 IC-LoRA 參數時,潛在空間的尺寸(寬度和高度)必須能被該因子整除。如果未滿足此條件,節點將引發錯誤。 +**關於 `iclora_parameters` 的注意事項:** 當使用的 IC-LoRA 參數具有大於 1 的 `reference_downscale_factor` 時,潛在空間的空間維度(寬度和高度)必須能被該因子整除。若不符合此條件,節點將引發錯誤。 -## 輸出 +**注意:** 編碼後的引導影格必須能容納於選定影格位置所在的潛在序列中。如果條件化的影格超過潛在序列的長度,節點將引發錯誤。 +**注意:** 不支援在結合了音訊與視訊通道的潛在資料上加入引導,否則將引發錯誤。 + +## 輸出 | 輸出名稱 | 描述 | 資料類型 | | --- | --- | --- | -| `正向` | 以關鍵幀引導資訊更新的正向條件 | CONDITIONING | -| `負向` | 以關鍵幀引導資訊更新的負向條件 | CONDITIONING | -| `潛在空間` | 已納入條件幀並更新雜訊遮罩的潛在序列 | LATENT | +| `正向` | 以關鍵影格引導資訊更新的正向條件 | CONDITIONING | +| `負向` | 以關鍵影格引導資訊更新的負向條件 | CONDITIONING | +| `潛在空間` | 已納入條件影格並更新雜訊遮罩的潛在序列 | LATENT | > 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVAddGuide/zh-TW.md) --- -**Source fingerprint (SHA-256):** `3e0d1422fbd1b5b3e4c69e641af2ecdb5ae8de3f4368b336917a0dce4286771e` +**Source fingerprint (SHA-256):** `031bc9030dafed85b5ff1cbceae36234e9d5f77f7f4b040267067ecd16a27929` diff --git a/comfyui_embedded_docs/docs/LTXVAddGuide/zh.md b/comfyui_embedded_docs/docs/LTXVAddGuide/zh.md index 7300129ad..88a5d8ba2 100644 --- a/comfyui_embedded_docs/docs/LTXVAddGuide/zh.md +++ b/comfyui_embedded_docs/docs/LTXVAddGuide/zh.md @@ -1,32 +1,38 @@ # LTXV添加指导 -LTXVAddGuide 节点通过编码输入图像或视频,并将其作为关键帧合并到条件数据中,为潜在序列添加视频条件引导。它通过 VAE 编码器处理输入,并将生成的潜在表示策略性地放置到指定的帧位置,同时用关键帧信息更新正向和负向条件。该节点处理帧对齐约束,并允许控制条件影响的强度。 +LTXVAddGuide 节点通过编码输入图像或视频,并将其作为关键帧合并到 conditioning 数据中,从而向潜在序列添加视频 conditioning 引导。它通过 VAE 编码器处理输入,并将生成的潜在表示策略性地放置在指定的帧位置,同时使用关键帧信息更新正向和负向 conditioning。该节点处理帧对齐约束,并允许控制 conditioning 影响的强度。 ## 输入 -| 参数 | 描述 | 数据类型 | 必需 | 范围 | + +| 参数 | 描述 | 数据类型 | 必填 | 范围 | | --- | --- | --- | --- | --- | -| `正向` | 将使用关键帧引导修改的正向条件输入 | CONDITIONING | 是 | - | -| `负向` | 将使用关键帧引导修改的负向条件输入 | CONDITIONING | 是 | - | +| `正向` | 将使用关键帧引导修改的正向 conditioning 输入 | CONDITIONING | 是 | - | +| `负向` | 将使用关键帧引导修改的负向 conditioning 输入 | CONDITIONING | 是 | - | | `vae` | 用于编码输入图像/视频帧的 VAE 模型 | VAE | 是 | - | -| `潜在空间` | 将接收条件帧的输入 latent 序列 | LATENT | 是 | - | -| `图像` | 用于对潜在视频进行条件约束的图像或视频。必须是 8*n + 1 帧。如果视频不是 8*n + 1 帧,则会被裁剪到最近的 8*n + 1 帧。 | IMAGE | 是 | - | -| `帧索引` | 开始条件约束的帧索引。对于单帧图像或 1-8 帧的视频,任何 frame_idx 值均可接受。对于 9 帧及以上的视频,frame_idx 必须可被 8 整除,否则将向下舍入到最接近的 8 的倍数。负值从视频末尾开始计数。(默认值:0) | INT | 是 | -9999 到 9999 | -| `强度` | 条件约束影响的强度,其中 1.0 表示完全应用条件约束,0.0 表示不应用条件约束(默认值:1.0) | FLOAT | 是 | 0.0 到 10.0 | -| `attention_mask` | 可选的像素空间掩码。通过自注意力控制每个区域的条件约束影响,并与 strength 相乘。 | MASK | 否 | - | -| `iclora_parameters` | 来自 Get IC-LoRA Parameters 节点的可选 IC-LoRA 参数。用于根据某些 IC-LoRA(例如 reference_downscale_factor > 1 的 IC-LoRA)的要求调整引导处理。当链接时,每个 LTXVAddGuide 仅使用连接到它的参数。 | IC_LORA_PARAMETERS | 否 | - | +| `潜在空间` | 将接收 conditioning 帧的输入潜在序列 | LATENT | 是 | - | +| `图像` | 用于对潜在视频进行条件化的图像或视频。必须为 8*n + 1 帧。如果视频不是 8*n + 1 帧,则会被裁剪到最接近的 8*n + 1 帧。 | IMAGE | 是 | - | +| `帧索引` | 开始 condition 的帧索引。对于单帧图像或包含 1-8 帧的视频,任何 `frame_idx` 值均可接受。对于包含 9 帧及以上的视频,`frame_idx` 必须能被 8 整除,否则将向下舍入到最接近的 8 的倍数。负值从视频末尾开始计数。(默认值:0) | INT | 是 | -9999到9999 | +| `强度` | conditioning 影响的强度,其中 1.0 表示应用完整 conditioning,0.0 表示不应用 conditioning(默认值:1.0) | FLOAT | 是 | 0.0到10.0 | +| `attention_mask` | 可选的像素空间空间掩码。通过自注意力控制每个区域的 conditioning 影响,并与 `strength` 相乘。 | MASK | 否 | - | +| `iclora_parameters` | 可选的 IC-LoRA 参数,来自“获取 IC-LoRA 参数”节点。用于根据特定 IC-LoRA 的要求调整引导处理(例如,具有 `reference_downscale_factor` > 1 的 IC-LoRA)。当链式连接时,每个 LTXVAddGuide 仅使用与其连接的参数。 | IC_LORA_PARAMETERS | 否 | - | + +**注意:** 输入图像/视频的帧数必须符合 8*n + 1 模式(例如,1、9、17、25 帧)。如果输入超出此模式,将自动裁剪到最接近的有效帧数。 -**注意:** 输入图像/视频的帧数必须符合 8*n + 1 模式(例如 1、9、17、25 帧)。如果输入超出此模式,将自动裁剪到最接近的有效帧数。 +**关于 `iclora_parameters` 的说明:** 当使用的 IC-LoRA 参数的 `reference_downscale_factor` 大于 1 时,潜在空间维度(宽度和高度)必须能被该因子整除。如果不满足此条件,节点将报错。 -**关于 `iclora_parameters` 的说明:** 当使用的 IC-LoRA 参数的 `reference_downscale_factor` 大于 1 时,潜在表示的空间尺寸(宽度和高度)必须能被该因子整除。如果不满足此条件,节点将引发错误。 +**注意:** 编码后的引导帧必须能适合所选帧位置处的潜在序列。如果 conditioning 帧超过潜在序列的长度,节点将报错。 + +**注意:** 不支持向包含音频和视频通道的潜在表示添加引导,否则将报错。 ## 输出 + | 输出名称 | 描述 | 数据类型 | | --- | --- | --- | -| `正向` | 已使用关键帧引导信息更新的正向条件 | CONDITIONING | -| `负向` | 已使用关键帧引导信息更新的负向条件 | CONDITIONING | -| `潜在空间` | 已包含条件帧和更新后的噪声掩码的潜在序列 | LATENT | +| `正向` | 已使用关键帧引导信息更新的正向 conditioning | CONDITIONING | +| `负向` | 已使用关键帧引导信息更新的负向 conditioning | CONDITIONING | +| `潜在空间` | 已包含 conditioning 帧并更新噪声掩码的潜在序列 | LATENT | > 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVAddGuide/zh.md) --- -**Source fingerprint (SHA-256):** `3e0d1422fbd1b5b3e4c69e641af2ecdb5ae8de3f4368b336917a0dce4286771e` +**Source fingerprint (SHA-256):** `031bc9030dafed85b5ff1cbceae36234e9d5f77f7f4b040267067ecd16a27929` diff --git a/comfyui_embedded_docs/docs/LTXVAddLatentGuide/ar.md b/comfyui_embedded_docs/docs/LTXVAddLatentGuide/ar.md new file mode 100644 index 000000000..37cd9d34e --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVAddLatentGuide/ar.md @@ -0,0 +1,38 @@ +# LTXVAddLatentGuide + +## المقدمة + +يُربط عقدة دليل إضافة المخرجات الكامنة `LTXV Add Latent Guide` مخرجات كامنة مسبقًا بتقريب كامن، مما يسمح باستخدام دليل يخرج من مرحلة سابقة بدلاً من الصورة. تجنب هذه العقدة دورة التفكير/التقريب في VAE، ويمكنها توسيع دليل صغيرًا من الناحية المكاني إلى شبكة فقيرة لتغطية لوحة الهدف. + +## المدخلات + +| المعامل | الوصف | نوع البيانات | إلزامي | نطاق | +|-----------|-------------|-----------|----------|-------| +| `positive` | مدخل التقييد الإيجابي. | CONDITIONING | نعم | غير محدد | +| `negative` | مدخل التقييد السلبي. | CONDITIONING | نعم | غير محدد | +| `vae` | نموذج VAE الذي سيتم استخدامه. | MODEL | نعم | غير محدد | +| `latent` | الفيديو الكامن الهدف الذي سيتم ربط الدليل عليه. | LATENT | نعم | غير محدد | +| `guiding_latent` | كامن الدليل. يجب أن يكون حجمه يُقسم حجم `latent` بنفس العدد الكامل على كلا المحاور؛ إذا كان الحجم متساويًا، يتم ربطه كما هو، وإذا كان الحجم نصفًا يتم التعامل معه كمرجع IC-LoRA مضاعف x2. | LATENT | نعم | غير محدد | +| `latent_idx` | مؤشر إطار الكامن الذي يبدأ به الدليل، يتم حسابه في إطارات الكامن وليس في إطارات البكسل. القيم السلبية تضع الدليل في إطارات قبل بداية الكامن، وليس من نهايته. | INT | نعم | من -9999 إلى 9999 | +| `strength` | محدودة عند 1.0. يدل دليل التوسع على مواضع الت扩充 الخاصة به بغطاء سلبية للتعقيم بحيث يرفضها النموذج؛ إذا كانت القيم أعلى من 1.0، فإن المواضع المحفوظة ستكون سلبية أيضًا ويتم رفض الدليل بالكامل. استخدم `attention_mask` بدلاً من ذلك لتضخيم ما يزيد عن 1.0. | FLOAT | نعم | من 0.0 إلى 1.0، بخطوة 0.01 | +| `attention_mask` | غطاء مكاني اختياري. يتحكم في تأثير التقييد على كل منطقة عبر التركيز الذاتي، ويُضاعف بمعدل القوة. | MASK | لا | غير محدد | + +## المخرجات + +| اسم المخرج | الوصف | نوع البيانات | +|-------------|-------------|-----------| +| `positive` | مخرج التقييد الإيجابي. | CONDITIONING | +| `negative` | مخرج التقييد السلبي. | CONDITIONING | +| `latent` | مخرج الكامن بعد تطبيق الدليل. | LATENT | + +## ملاحظات + +- يجب أن يكون حجم `guiding_latent` يُقسم حجم `latent` بنفس العدد الكامل على كلا المحاور. +- يسمح معامل `latent_idx` بوضع دقيق للدليل داخل إطارات الكامن. +- يتحكم معامل `strength` في شدة الدليل، ويجب استخدام `attention_mask` لضمان عدم وجود مواضع سلبية عند القيم أعلى من 1.0. +- يمكن استخدام معامل `attention_mask` بشكل اختياري لتعديل تأثير الدليل في مناطق معينة من الصورة. + +> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVAddLatentGuide/ar.md) + +--- +**Source fingerprint (SHA-256):** `19542500484dbc57fdbeeab8ba05bc2978246b3be5decc413825f616cab46f73` diff --git a/comfyui_embedded_docs/docs/LTXVAddLatentGuide/en.md b/comfyui_embedded_docs/docs/LTXVAddLatentGuide/en.md new file mode 100644 index 000000000..36b63e115 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVAddLatentGuide/en.md @@ -0,0 +1,38 @@ +# LTXVAddLatentGuide + +## Overview + +The LTXV Add Latent Guide node pins an already-encoded latent as a guide, allowing for the use of a guide that comes out of an earlier stage rather than an image. This node avoids the VAE decode/encode round trip, and it can dilate a spatially smaller guide onto a sparse grid to cover the target canvas. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `positive` | Positive conditioning input. | CONDITIONING | Yes | N/A | +| `negative` | Negative conditioning input. | CONDITIONING | Yes | N/A | +| `vae` | The VAE model to use. | MODEL | Yes | N/A | +| `latent` | Target video latent the guide is pinned onto. | LATENT | Yes | N/A | +| `guiding_latent` | Guide latent. Its spatial size must divide the target's by the same whole number on both axes; equal size pins it as-is, half size is treated as an x2 IC-LoRA reference. | LATENT | Yes | N/A | +| `latent_idx` | Latent frame index to start the guide at, counted in latent frames rather than pixel frames. Negative values place the guide on frames before the start of the latent, not counted back from its end. | INT | Yes | -9999 to 9999 | +| `strength` | Capped at 1.0. A dilated guide marks its padding positions with a negative denoise mask so the model drops them; above 1.0 the kept positions would go negative too and the whole guide would be dropped. Amplify beyond 1.0 with attention_mask instead. | FLOAT | Yes | 0.0 to 1.0, step 0.01 | +| `attention_mask` | Optional pixel-space spatial mask. Controls per-region conditioning influence via self-attention, multiplied by strength. | MASK | No | N/A | + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `positive` | Positive conditioning output. | CONDITIONING | +| `negative` | Negative conditioning output. | CONDITIONING | +| `latent` | Latent output with the guide applied. | LATENT | + +## Notes + +- The `guiding_latent` spatial size must divide the `latent` size by the same whole number on both axes. +- The `latent_idx` parameter allows for precise placement of the guide within the latent frames. +- The `strength` parameter controls the intensity of the guide, with values above 1.0 requiring the use of `attention_mask` to avoid negative positions. +- The `attention_mask` parameter is optional but can be used to fine-tune the influence of the guide in specific regions of the 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/LTXVAddLatentGuide/en.md) + +--- +**Source fingerprint (SHA-256):** `19542500484dbc57fdbeeab8ba05bc2978246b3be5decc413825f616cab46f73` diff --git a/comfyui_embedded_docs/docs/LTXVAddLatentGuide/es.md b/comfyui_embedded_docs/docs/LTXVAddLatentGuide/es.md new file mode 100644 index 000000000..38ed828dc --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVAddLatentGuide/es.md @@ -0,0 +1,38 @@ +# LTXVAddLatentGuide + +## Resumen + +El nodo Guía de Añadir Latente LTXV fija un latente ya codificado como una guía, permitiendo el uso de una guía que proviene de una etapa anterior en lugar de una imagen. Este nodo evita el viaje de decodificación/encodificación del VAE y puede dilatar una guía espacialmente más pequeña en una cuadrícula dispersa para cubrir el lienzo objetivo. + +## Entradas + +| Parámetro | Descripción | Tipo de Datos | Requerido | Rango | +|-----------|-------------|-----------|----------|-------| +| `positive` | Entrada de condicionamiento positivo. | CONDITIONING | Sí | N/A | +| `negative` | Entrada de condicionamiento negativo. | CONDITIONING | Sí | N/A | +| `vae` | El modelo VAE a usar. | MODEL | Sí | N/A | +| `latent` | Latente de video objetivo al que se fija la guía. | LATENTE | Sí | N/A | +| `guiding_latent` | Latente de guía. Su tamaño espacial debe dividir el tamaño del objetivo por el mismo número entero en ambos ejes; un tamaño igual fija la guía tal cual, la mitad del tamaño se trata como una referencia IC-LoRA x2. | LATENTE | Sí | N/A | +| `latent_idx` | Índice de cuadro de latente para comenzar la guía, contado en cuadros latentes en lugar de cuadros de píxeles. Valores negativos colocan la guía en cuadros antes del inicio del latente, no contados hacia atrás desde su final. | INT | Sí | -9999 a 9999 | +| `strength` | Acotado en 1.0. Una guía dilatada marca sus posiciones de relleno con una máscara de desenoise negativa para que el modelo los descarte; valores por encima de 1.0 los posiciones mantenidas también serían negativas y toda la guía sería descartada. Amplifique más allá de 1.0 con attention_mask en su lugar. | FLOAT | Sí | 0.0 a 1.0, paso 0.01 | +| `attention_mask` | Máscara espacial opcional en espacio de píxeles. Controla la influencia de condicionamiento por región a través de auto-consideración, multiplicada por la fuerza. | MASK | No | N/A | + +## Salidas + +| Nombre de Salida | Descripción | Tipo de Datos | +|-------------|-------------|-----------| +| `positive` | Salida de condicionamiento positivo. | CONDITIONING | +| `negative` | Salida de condicionamiento negativo. | CONDITIONING | +| `latent` | Salida latente con la guía aplicada. | LATENTE | + +## Notas + +- El tamaño espacial del `guiding_latent` debe dividir el tamaño `latent` por el mismo número entero en ambos ejes. +- El parámetro `latent_idx` permite una colocación precisa de la guía dentro de los cuadros latentes. +- El parámetro `strength` controla la intensidad de la guía, con valores por encima de 1.0 que requieren el uso de `attention_mask` para evitar posiciones negativas. +- El parámetro `attention_mask` es opcional pero se puede usar para afinar la influencia de la guía en regiones específicas de la imagen. + +> 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/LTXVAddLatentGuide/es.md) + +--- +**Source fingerprint (SHA-256):** `19542500484dbc57fdbeeab8ba05bc2978246b3be5decc413825f616cab46f73` diff --git a/comfyui_embedded_docs/docs/LTXVAddLatentGuide/fa.md b/comfyui_embedded_docs/docs/LTXVAddLatentGuide/fa.md new file mode 100644 index 000000000..50b42c0b8 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVAddLatentGuide/fa.md @@ -0,0 +1,38 @@ +# LTXVAddLatentGuide + +## مقدمه + +گره LTXV Add Latent Guide یک لاتنت رمزگذاری شده موجود را به عنوان یک راهنما می‌چسباند، که به استفاده از راهنمایی که از مرحله‌ای قبلی آمده است، بجای یک تصویر، امکان‌پذیر می‌کند. این گره از چرخه بازگشت/رمزگذاری VAE جلوگیری می‌کند و می‌تواند یک راهنمای کوچکتر از نظر فضایی را به یک شبکه پراکنده گسترش دهد تا کانواس هدف را پوشش دهد. + +## ورودی‌ها + +| پارامتر | توضیح | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `positive` | ورودی شرایط مثبت. | CONDITIONING | بله | N/A | +| `negative` | ورودی شرایط منفی. | CONDITIONING | بله | N/A | +| `vae` | مدل VAE مورد استفاده. | MODEL | بله | N/A | +| `latent` | لاتنت ویدیویی هدف که راهنما به آن می‌چسبانده می‌شود. | LATENT | بله | N/A | +| `guiding_latent` | لاتنت راهنما. اندازه فضایی آن باید بر اندازه هدف به همان عدد صحیح در هر دو محور تقسیم شود؛ اندازه برابر به صورت مستقیم می‌چسبانده می‌شود، اندازه نصف شده به عنوان یک مرجع IC-LoRA x2 در نظر گرفته می‌شود. | LATENT | بله | N/A | +| `latent_idx` | شماره فریم لاتنت برای شروع راهنما، به تعداد فریم‌های لاتنت شمارش می‌شود و نه فریم‌های پیکسلی. مقادیر منفی راهنما را در فریم‌های قبل از شروع لاتنت قرار می‌دهد، نه به تعداد بازگشت از انتهای آن. | INT | بله | -9999 تا 9999 | +| `strength` | محدود به 1.0 می‌شود. یک راهنمای گسترش شده موقعیت‌های پرانتزی خود را با ماسک کاهش‌یابنده‌ای علامت‌گذاری می‌کند تا مدل آن‌ها را حذف کند؛ مقادیر بالاتر از 1.0 موقعیت‌های حفظ شده را منفی می‌کند و کل راهنما حذف می‌شود. برای تقویت بیشتر از 1.0 از attention_mask استفاده کنید. | FLOAT | بله | 0.0 تا 1.0، قدم 0.01 | +| `attention_mask` | ماسک فضایی پیکسلی اختیاری. تأثیر شرایط هر منطقه را از طریق توجه خودکار کنترل می‌کند، ضرب در strength. | MASK | خیر | N/A | + +## خروجی‌ها + +| نام خروجی | توضیح | نوع داده | +|-------------|-------------|-----------| +| `positive` | خروجی شرایط مثبت. | CONDITIONING | +| `negative` | خروجی شرایط منفی. | CONDITIONING | +| `latent` | خروجی لاتنت با اعمال راهنما. | LATENT | + +## یادداشت‌ها + +- اندازه فضایی `guiding_latent` باید بر اندازه `latent` به همان عدد صحیح در هر دو محور تقسیم شود. +- پارامتر `latent_idx` امکان قرارگیری دقیق راهنما در فریم‌های لاتنت را فراهم می‌کند. +- پارامتر `strength` شدت راهنما را کنترل می‌کند، با مقادیر بالاتر از 1.0 نیاز به استفاده از `attention_mask` برای جلوگیری از موقعیت‌های منفی است. +- پارامتر `attention_mask` اختیاری است اما می‌تواند برای بهینه‌سازی تأثیر راهنما در مناطق خاص از آن استفاده شود. + +> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVAddLatentGuide/fa.md) + +--- +**Source fingerprint (SHA-256):** `19542500484dbc57fdbeeab8ba05bc2978246b3be5decc413825f616cab46f73` diff --git a/comfyui_embedded_docs/docs/LTXVAddLatentGuide/fr.md b/comfyui_embedded_docs/docs/LTXVAddLatentGuide/fr.md new file mode 100644 index 000000000..66a687e3c --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVAddLatentGuide/fr.md @@ -0,0 +1,38 @@ +# LTXVAddLatentGuide + +## Aperçu + +Le nœud LTXV Add Latent Guide fixe un latent déjà encodé comme guide, permettant d'utiliser un guide provenant d'une étape précédente plutôt qu'une image. Ce nœud évite le voyage d'encodage/décodage du VAE et peut dilater un guide spatialement plus petit sur une grille rare pour couvrir le canevas cible. + +## Entrées + +| Paramètre | Description | Type de données | Obligatoire | Gamme | +|-----------|-------------|-----------|----------|-------| +| `positive` | Entrée de conditionnement positive. | CONDITIONING | Oui | N/A | +| `negative` | Entrée de conditionnement négative. | CONDITIONING | Oui | N/A | +| `vae` | Le modèle VAE à utiliser. | MODEL | Oui | N/A | +| `latent` | Latent vidéo cible sur lequel le guide est fixé. | LATENT | Oui | N/A | +| `guiding_latent` | Latent guide. Sa taille spatiale doit diviser la taille du cible par le même nombre entier sur les deux axes ; une taille égale le fixe tel quel, une moitié de taille est traitée comme une référence IC-LoRA x2. | LATENT | Oui | N/A | +| `latent_idx` | Index de trame latent pour commencer le guide, compté en trames latentes plutôt qu'en trames pixel. Les valeurs négatives placent le guide sur des trames avant le début du latent, non comptées à partir de sa fin. | INT | Oui | -9999 à 9999 | +| `strength` | Limité à 1.0. Un guide dilaté marque ses positions de remplissage avec un masque de débruit négatif afin que le modèle les ignore ; au-delà de 1.0, les positions conservées deviendraient négatives et tout le guide serait ignoré. Amplifiez au-delà de 1.0 à l'aide de attention_mask. | FLOAT | Oui | 0.0 à 1.0, pas 0.01 | +| `attention_mask` | Masque spatial optionnel en espace pixel. Contrôle l'influence de conditionnement par région via l'auto-attention, multiplié par la force. | MASK | Non | N/A | + +## Sorties + +| Nom de sortie | Description | Type de données | +|-------------|-------------|-----------| +| `positive` | Sortie de conditionnement positive. | CONDITIONING | +| `negative` | Sortie de conditionnement négative. | CONDITIONING | +| `latent` | Sortie latente avec le guide appliqué. | LATENT | + +## Notes + +- La taille spatiale du `guiding_latent` doit diviser la taille `latent` par le même nombre entier sur les deux axes. +- Le paramètre `latent_idx` permet de placer précisément le guide au sein des trames latentes. +- Le paramètre `strength` contrôle l'intensité du guide, avec des valeurs au-delà de 1.0 nécessitant l'utilisation de `attention_mask` pour éviter des positions négatives. +- Le paramètre `attention_mask` est optionnel mais peut être utilisé pour affiner l'influence du guide dans des régions spécifiques de l'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/LTXVAddLatentGuide/fr.md) + +--- +**Source fingerprint (SHA-256):** `19542500484dbc57fdbeeab8ba05bc2978246b3be5decc413825f616cab46f73` diff --git a/comfyui_embedded_docs/docs/LTXVAddLatentGuide/ja.md b/comfyui_embedded_docs/docs/LTXVAddLatentGuide/ja.md new file mode 100644 index 000000000..cc2741395 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVAddLatentGuide/ja.md @@ -0,0 +1,38 @@ +# LTXVAddLatentGuide + +## 概要 + +LTXV アドダー・ラテンガイドノードは、既にエンコードされたラテンをガイドとしてピン留め、以前のステージから出てくるガイドを使用するようにします。このノードはVAEのデコード/エンコードのラウンドトリップを避け、空間的に小さいガイドをスパースグリッドに拡張してターゲットキャンバスをカバーすることができます。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|------------|------|----------|------|-------| +| `positive` | 正の条件入力。 | CONDITIONING | はい | なし | +| `negative` | 負の条件入力。 | CONDITIONING | はい | なし | +| `vae` | 使用するVAEモデル。 | MODEL | はい | なし | +| `latent` | ガイドがピン留めされるターゲットビデオのラテン。 | LATENT | はい | なし | +| `guiding_latent` | ガイドラテン。その空間サイズは、ターゲットのサイズを両軸で同じ完全数で割ることが必要です;同じサイズでピン留めするとそのまま、半分のサイズはx2 IC-LoRA参照として扱われます。 | LATENT | はい | なし | +| `latent_idx` | ガイドを開始するラテンフレームインデックス、ラテンフレームで数えられます(ピクセルフレームではありません)。負の値はラテン開始前にガイドを配置し、ラテンの終わりからは数えられません。 | INT | はい | -9999 から 9999 | +| `strength` | 1.0でカップリングされます。拡張されたガイドはパディング位置を負のノイズマスクでマークし、モデルがそれらをドロップします;1.0を超える値では保持される位置が負の値になるため、全体のガイドがドロップされます。1.0を超える場合は、attention_maskを使用して拡大してください。 | FLOAT | はい | 0.0 から 1.0、ステップ 0.01 | +| `attention_mask` | オプションのピクセル空間の空間マスク。self-attentionを通じて各領域の条件影響を制御し、強度に乗算されます。 | MASK | いいえ | なし | + +## 出力 + +| 出力名 | 説明 | データ型 | +|--------|------|----------| +| `positive` | 正の条件出力。 | CONDITIONING | +| `negative` | 負の条件出力。 | CONDITIONING | +| `latent` | ガイドが適用されたラテン出力。 | LATENT | + +## 注意事項 + +- `guiding_latent`の空間サイズは、`latent`のサイズを両軸で同じ完全数で割ることが必要です。 +- `latent_idx`パラメータは、ラテンフレーム内のガイドの正確な配置を可能にします。 +- `strength`パラメータは、ガイドの強度を制御し、1.0を超える値では`attention_mask`を使用して負の位置を避ける必要があります。 +- `attention_mask`パラメータはオプションですが、画像の特定の領域におけるガイドの影響を微調整するために使用できます。 + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVAddLatentGuide/ja.md) + +--- +**Source fingerprint (SHA-256):** `19542500484dbc57fdbeeab8ba05bc2978246b3be5decc413825f616cab46f73` diff --git a/comfyui_embedded_docs/docs/LTXVAddLatentGuide/ko.md b/comfyui_embedded_docs/docs/LTXVAddLatentGuide/ko.md new file mode 100644 index 000000000..48cc6867e --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVAddLatentGuide/ko.md @@ -0,0 +1,38 @@ +# LTXVAddLatentGuide + +## 개요 + +LTXV Add Latent Guide 노드는 이미编码된 잠재 변수를 지침으로 고정하여, 이전 단계에서 나오는 지침을 사용할 수 있게 합니다. 이 노드는 VAE 디코딩/인코딩 라운드 트립을 피하고, 공간적으로 작은 지침을 희소 그리드에 확장하여 타겟 캔버스를 덮을 수 있습니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `positive` | 긍정적인 조건 입력. | CONDITIONING | 예 | N/A | +| `negative` | 부정적인 조건 입력. | CONDITIONING | 예 | N/A | +| `vae` | 사용할 VAE 모델. | MODEL | 예 | N/A | +| `latent` | 지침이 고정된 타겟 비디오 잠재 변수. | LATENT | 예 | N/A | +| `guiding_latent` | 지침 잠재 변수. 그 공간 크기는 타겟의 크기를 양쪽 축에서 같은 전체 수로 나누어야 합니다; 동일한 크기는 그대로 고정되고, 반 크기는 x2 IC-LoRA 참조로 처리됩니다. | LATENT | 예 | N/A | +| `latent_idx` | 지침을 시작할 잠재 프레임 인덱스, 잠재 프레임으로부터 계산됩니다. 픽셀 프레임보다 잠재 프레임을 기준으로 합니다. 음수 값은 잠재의 시작 이전의 프레임에 지침을 배치합니다. | INT | 예 | -9999 ~ 9999 | +| `strength` | 1.0으로 제한됩니다. 확장된 지침은 패딩 위치를 음수 데노이즈 마스크로 표시하여 모델이 그들을 제거합니다; 1.0 이상의 값은 유지된 위치가 음수가 되어 전체 지침이 제거됩니다. 1.0 이상의 값은 대신 attention_mask를 사용하여 증폭하세요. | FLOAT | 예 | 0.0 ~ 1.0, 단계 0.01 | +| `attention_mask` | 선택 사항입니다. 픽셀 공간 마스크입니다. 강도와 함께 지침의 영향을 지역별로 제어합니다. | MASK | 아님 | N/A | + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `positive` | 긍정적인 조건 출력. | CONDITIONING | +| `negative` | 부정적인 조건 출력. | CONDITIONING | +| `latent` | 지침이 적용된 잠재 출력. | LATENT | + +## 주의사항 + +- `guiding_latent`의 공간 크기는 `latent` 크기를 양쪽 축에서 같은 전체 수로 나누어야 합니다. +- `latent_idx` 매개변수는 지침이 잠재 프레임 내에서 정확하게 배치되도록 합니다. +- `strength` 매개변수는 지침의 강도를 제어하며, 1.0 이상의 값은 `attention_mask`를 사용하여 음수 위치를 피해야 합니다. +- `attention_mask` 매개변수는 선택 사항이지만, 이미지의 특정 지역에서 지침의 영향을 미세 조정할 수 있습니다. + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVAddLatentGuide/ko.md) + +--- +**Source fingerprint (SHA-256):** `19542500484dbc57fdbeeab8ba05bc2978246b3be5decc413825f616cab46f73` diff --git a/comfyui_embedded_docs/docs/LTXVAddLatentGuide/pt-BR.md b/comfyui_embedded_docs/docs/LTXVAddLatentGuide/pt-BR.md new file mode 100644 index 000000000..ddccbcd39 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVAddLatentGuide/pt-BR.md @@ -0,0 +1,38 @@ +# LTXVAddLatentGuide + +## Visão Geral + +O nó Guia de Adição de Latente LTXV fixa um latente já codificado como um guia, permitindo o uso de um guia que sai de uma etapa anterior em vez de uma imagem. Este nó evita a viagem de decodificação/encodificação do VAE e pode dilatar um guia espacialmente menor em uma grade rala para cobrir o canvas alvo. + +## Entradas + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | +|-----------|-------------|-----------|----------|-------| +| `positive` | Entrada de condicionamento positivo. | CONDICIONAMENTO | Sim | N/A | +| `negative` | Entrada de condicionamento negativo. | CONDICIONAMENTO | Sim | N/A | +| `vae` | O modelo VAE a ser usado. | MODEL | Sim | N/A | +| `latent` | Latente de vídeo alvo em que o guia é fixado. | LATENTE | Sim | N/A | +| `guiding_latent` | Latente de guia. Seu tamanho espacial deve dividir o tamanho do alvo pelo mesmo número inteiro em ambos os eixos; tamanho igual fixa-o como está, metade do tamanho é tratado como uma referência IC-LoRA x2. | LATENTE | Sim | N/A | +| `latent_idx` | Índice do quadro latente para começar o guia, contado em quadros latentes em vez de quadros de pixel. Valores negativos colocam o guia em quadros antes do início do latente, não contados a partir do final. | INTEIRO | Sim | -9999 a 9999 | +| `strength` | Limitado a 1.0. Um guia dilatado marca suas posições de preenchimento com uma máscara de denoising negativa para que o modelo os descarte; valores acima de 1.0 farão com que as posições mantidas se tornem negativas e todo o guia será descartado. Amplifique além de 1.0 usando attention_mask em vez disso. | FLUTUANTE | Sim | 0.0 a 1.0, passo 0.01 | +| `attention_mask` | Máscara espacial opcional no espaço de pixels. Controla a influência de condicionamento por região via auto-atenção, multiplicada por força. | MASK | Não | N/A | + +## Saídas + +| Nome da Saída | Descrição | Tipo de Dados | +|-------------|-------------|-----------| +| `positive` | Saída de condicionamento positivo. | CONDICIONAMENTO | +| `negative` | Saída de condicionamento negativo. | CONDICIONAMENTO | +| `latent` | Saída latente com o guia aplicado. | LATENTE | + +## Notas + +- O tamanho espacial do `guiding_latent` deve dividir o tamanho do `latent` pelo mesmo número inteiro em ambos os eixos. +- O parâmetro `latent_idx` permite a colocação precisa do guia dentro dos quadros latentes. +- O parâmetro `strength` controla a intensidade do guia, com valores acima de 1.0 exigindo o uso de `attention_mask` para evitar posições negativas. +- O parâmetro `attention_mask` é opcional mas pode ser usado para ajustar a influência do guia em regiões específicas da imagem. + +> 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/LTXVAddLatentGuide/pt-BR.md) + +--- +**Source fingerprint (SHA-256):** `19542500484dbc57fdbeeab8ba05bc2978246b3be5decc413825f616cab46f73` diff --git a/comfyui_embedded_docs/docs/LTXVAddLatentGuide/ru.md b/comfyui_embedded_docs/docs/LTXVAddLatentGuide/ru.md new file mode 100644 index 000000000..c4f86e483 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVAddLatentGuide/ru.md @@ -0,0 +1,38 @@ +# LTXVAddLatentGuide + +## Обзор + +Нод ЛТХВ Добавление латентного гида привязывает уже закодированный латентный код в качестве гида, что позволяет использовать гид, вышедший из более ранней стадии, а не изображение. Этот нод избегает vòng tri回路 VAE декодирования/кодирования и может расширить гида, имеющего меньшие размеры в пространстве, на спарсgrid для покрытия целевого канваса. + +## Входы + +| Параметр | Описание | Тип данных | Обязателен | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `positive` | Положительное условное вхождение. | CONDITIONING | Да | Не определено | +| `negative` | Отрицательное условное вхождение. | CONDITIONING | Да | Не определено | +| `vae` | Модель VAE, которую нужно использовать. | MODEL | Да | Не определено | +| `latent` | Целевое видео латентный код, на который привязывается гид. | LATENT | Да | Не определено | +| `guiding_latent` | Латентный код гида. Его пространственный размер должен делиться размером целевого кода на одинаковое целое число по обеим осям; равный размер привязывает его так, как есть, размер в половину рассматривается как x2 IC-LoRA эталонный гид. | LATENT | Да | Не определено | +| `latent_idx` | Индекс кадра латентного кода, с которого начинается гид, учитываемый в кадрах латентного кода, а не в кадрах пикселей. Отрицательные значения помещают гид на кадры до начала латентного кода, не учитывая обратного отсчета от его конца. | INT | Да | -9999 до 9999 | +| `strength` | Ограничено до 1.0. Расширенный гид помечает свои позиции заполнения с помощью отрицательного маскирования денoise, чтобы модель их отбросила; значения выше 1.0 приведут к отрицательным позициям сохраняемых позиций и весь гид будет отброшен. Увеличивайте за пределами 1.0 с помощью attention_mask. | FLOAT | Да | 0.0 до 1.0, шаг 0.01 | +| `attention_mask` | Опциональный пространственный маска в пространственной области. Контролирует влияние условного вхождения на каждую область через само-внимание, умноженное на силу. | MASK | Нет | Не определено | + +## Выходы + +| Название выхода | Описание | Тип данных | +|-------------|-------------|-----------| +| `positive` | Положительное условное выход. | CONDITIONING | +| `negative` | Отрицательное условное выход. | CONDITIONING | +| `latent` | Латентный выход с примененным гидом. | LATENT | + +## Примечания + +- Пространственный размер `guiding_latent` должен делиться размером `latent` на одинаковое целое число по обеим осям. +- Параметр `latent_idx` позволяет точно разместить гид в кадрах латентного кода. +- Параметр `strength` контролирует интенсивность гида, значения выше 1.0 требуют использования `attention_mask`, чтобы избежать отрицательных позиций. +- Параметр `attention_mask` опционален, но может быть использован для тонкой настройки влияния гида в конкретных областях изображения. + +> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVAddLatentGuide/ru.md) + +--- +**Source fingerprint (SHA-256):** `19542500484dbc57fdbeeab8ba05bc2978246b3be5decc413825f616cab46f73` diff --git a/comfyui_embedded_docs/docs/LTXVAddLatentGuide/tr.md b/comfyui_embedded_docs/docs/LTXVAddLatentGuide/tr.md new file mode 100644 index 000000000..49237292f --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVAddLatentGuide/tr.md @@ -0,0 +1,38 @@ +# LTXVAddLatentGuide + +## Özet + +LTXV Add Latent rehberi, zaten kodlanmış bir gizli latenti bir rehber olarak sabitler ve daha erken bir aşamadan gelen bir rehber kullanmayı sağlar. Bu node, VAE decode/encode turunu önler ve daha küçük bir rehberi genişleterek hedef canvas'ı kapsayan bir azaltılmış ızgara üzerine yerleştirir. + +## Girdiler + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +|-----------|-------------|-----------|----------|-------| +| `positive` | Pozitif koşullandırma girdisi. | KOŞULLANDIRMA | Evet | N/A | +| `negative` | Negatif koşullandırma girdisi. | KOŞULLANDIRMA | Evet | N/A | +| `vae` | Kullanılacak VAE modeli. | MODEL | Evet | N/A | +| `latent` | Rehberin sabitleneceği hedef video gizli latenti. | LATENT | Evet | N/A | +| `guiding_latent` | Rehber latenti. Uzay boyutu, hedefin her iki eksende de aynı tam sayı ile bölünmelidir; eşit boyutta sabitlenir, yarım boyutta x2 IC-LoRA referans olarak işlenir. | LATENT | Evet | N/A | +| `latent_idx` | Rehberin başlayacağı latent çerçeve indeksi, latent çerçeveler olarak sayılır. Negatif değerler, gizli latentin sonundan geri sayılmadan başlangıçtan önceki çerçevelere yerleştirir. | INT | Evet | -9999 ile 9999 arasında | +| `strength` | 1.0 ile sınırlı. Genişletilmiş bir rehber, dolgu pozisyonlarını negatif denoising mask ile işaretler ve model bunları atar; 1.0'dan büyük değerler, tutulan pozisyonlar negatif olacaktır ve tüm rehber atılacaktır. 1.0'dan büyük artışları dikkat maskesi ile artırın. | FLOAT | Evet | 0.0 ile 1.0 arasında, adım 0.01 | +| `attention_mask` | Opsiyonel piksel alanı spesifik maskesi. Her bölgeye özel koşullandırma etkisini kendiliğinden dikkat ile çarpıp artırır. | MASK | Hayır | N/A | + +## Çıktılar + +| Çıktı Adı | Açıklama | Veri Türü | +|-------------|-------------|-----------| +| `positive` | Pozitif koşullandırma çıktısı. | KOŞULLANDIRMA | +| `negative` | Negatif koşullandırma çıktısı. | KOŞULLANDIRMA | +| `latent` | Rehber uygulanmış latent çıktısı. | LATENT | + +## Notlar + +- `guiding_latent` uzay boyutu, `latent` boyutunu her iki eksende de aynı tam sayı ile bölünmelidir. +- `latent_idx` parametresi, rehberin latent çerçeveler içindeki yerleşimini kesin olarak belirler. +- `strength` parametresi, rehberin yoğunluğunu kontrol eder, 1.0'dan büyük değerler `attention_mask` kullanılarak kaçınılmalıdır. +- `attention_mask` parametresi opsiyoneldir ancak resmin belirli bölgelerindeki rehber etkisini ince ayarlamak için kullanılabilir. + +> 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/LTXVAddLatentGuide/tr.md) + +--- +**Source fingerprint (SHA-256):** `19542500484dbc57fdbeeab8ba05bc2978246b3be5decc413825f616cab46f73` diff --git a/comfyui_embedded_docs/docs/LTXVAddLatentGuide/zh-TW.md b/comfyui_embedded_docs/docs/LTXVAddLatentGuide/zh-TW.md new file mode 100644 index 000000000..72b0555cd --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVAddLatentGuide/zh-TW.md @@ -0,0 +1,38 @@ +# LTXVAddLatentGuide + +## 概述 + +LTXV 添加潛在導引節點將已編碼的潛在量作為導引,允許使用來自早期階段的導引而不是圖像。此節點避免 VAE 解碼/編碼迴圈,並能將空間較小的導引擴散到稀疏網格上,以覆蓋目標畫布。 + +## 輸入 + +| 參數 | 描述 | 資料類型 | 必需 | 范圍 | +|-----------|-------------|-----------|----------|-------| +| `positive` | 正向條件輸入。 | CONDITIONING | 是 | N/A | +| `negative` | 負向條件輸入。 | CONDITIONING | 是 | N/A | +| `vae` | 要使用的 VAE 模型。 | MODEL | 是 | N/A | +| `latent` | 導引所釘定的目標影片潛在量。 | LATENT | 是 | N/A | +| `guiding_latent` | 導引潛在量。其空間大小必須在兩個軸向上都能被目標的大小整除相同的整數;等大小釘定保持原狀,半大小作為 x2 IC-LoRA 參考處理。 | LATENT | 是 | N/A | +| `latent_idx` | 導引開始的潛在框架索引,以潛在框架計數,而不是像素框架。負值將導引放置在潛在開始之前的框架上,不從其結束處反向計數。 | INT | 是 | -9999 到 9999 | +| `strength` | 限制在 1.0。擴散導引使用負去噪掩罩標記其填充位置,以便模型將其丟棄;大於 1.0 的值將使保留位置變為負值,整個導引將被丟棄。使用 attention_mask 來放大超過 1.0 的值。 | FLOAT | 是 | 0.0 到 1.0,步長 0.01 | +| `attention_mask` | 可選的像素空間空間掩罩。通過自注意力控制每個區域的條件影響,乘以強度。 | MASK | 否 | N/A | + +## 輸出 + +| 輸出名稱 | 描述 | 資料類型 | +|-------------|-------------|-----------| +| `positive` | 正向條件輸出。 | CONDITIONING | +| `negative` | 負向條件輸出。 | CONDITIONING | +| `latent` | 應用導引的潛在輸出。 | LATENT | + +## 記錄 + +- `guiding_latent` 的空間大小必須在兩個軸向上都能被 `latent` 的大小整除相同的整數。 +- `latent_idx` 參數允許在潛在框架內精確放置導引。 +- `strength` 參數控制導引的強度,值大於 1.0 需要使用 `attention_mask` 以避免負位置。 +- `attention_mask` 參數是可選的,但可以用來精調導引在圖像特定區域的影響。 + +> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVAddLatentGuide/zh-TW.md) + +--- +**Source fingerprint (SHA-256):** `19542500484dbc57fdbeeab8ba05bc2978246b3be5decc413825f616cab46f73` diff --git a/comfyui_embedded_docs/docs/LTXVAddLatentGuide/zh.md b/comfyui_embedded_docs/docs/LTXVAddLatentGuide/zh.md new file mode 100644 index 000000000..845392207 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVAddLatentGuide/zh.md @@ -0,0 +1,38 @@ +# LTXVAddLatentGuide + +## 概述 + +LTXV 添加潜在引导节点将已编码的潜在变量作为引导,允许使用来自早期阶段的引导而不是图像。此节点避免了 VAE 解码/编码往返,并且可以将空间上较小的引导扩展到稀疏网格上,以覆盖目标画布。 + +## 输入 + +| 参数 | 描述 | 数据类型 | 必需 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `positive` | 正向条件输入。 | CONDITIONING | 是 | N/A | +| `negative` | 负向条件输入。 | CONDITIONING | 是 | N/A | +| `vae` | 要使用的 VAE 模型。 | MODEL | 是 | N/A | +| `latent` | 引导附加到的目标视频潜在变量。 | LATENT | 是 | N/A | +| `guiding_latent` | 引导潜在变量。其空间大小必须在两个轴上都能被目标的大小整除相同的整数;相同大小则按原样固定,半大小被视为 x2 IC-LoRA 参考。 | LATENT | 是 | N/A | +| `latent_idx` | 从中开始引导的潜在帧索引,按潜在帧计算,而不是像素帧。负值将引导放置在潜在变量开始之前的帧上,而不是从其末尾回退计算。 | INT | 是 | -9999 到 9999 | +| `strength` | 限制在 1.0。扩展的引导使用负去噪掩码标记其填充位置,以便模型丢弃它们;超过 1.0 的值会使保留的位置变为负数,整个引导将被丢弃。使用 attention_mask 替代放大超过 1.0 的值。 | FLOAT | 是 | 0.0 到 1.0,步长 0.01 | +| `attention_mask` | 可选的像素空间空间掩码。通过自注意力控制每个区域的条件影响,乘以强度。 | MASK | 否 | N/A | + +## 输出 + +| 输出名称 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `positive` | 正向条件输出。 | CONDITIONING | +| `negative` | 负向条件输出。 | CONDITIONING | +| `latent` | 应用了引导的潜在变量输出。 | LATENT | + +## 注意事项 + +- `guiding_latent` 的空间大小必须在两个轴上都能被 `latent` 的大小整除相同的整数。 +- `latent_idx` 参数允许在潜在帧内精确放置引导。 +- `strength` 参数控制引导的强度,值超过 1.0 需要使用 `attention_mask` 以避免出现负数位置。 +- `attention_mask` 参数是可选的,但可用于微调图像特定区域的引导影响。 + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVAddLatentGuide/zh.md) + +--- +**Source fingerprint (SHA-256):** `19542500484dbc57fdbeeab8ba05bc2978246b3be5decc413825f616cab46f73` diff --git a/comfyui_embedded_docs/docs/LTXVFreezeLatent/ar.md b/comfyui_embedded_docs/docs/LTXVFreezeLatent/ar.md new file mode 100644 index 000000000..0a63cbb76 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVFreezeLatent/ar.md @@ -0,0 +1,32 @@ +# LTXVFreezeLatent + +## نظرة عامة + +يُصمم عقدة LTXVFreezeLatent لتعيين noise_mask إلى 0 لأي latent معين، مما يضمن بقاء latent نظيفًا أثناء الاستنساخ. إنه مفيد بشكل خاص لتجميد latents للأصوات أو الفيديوهات لمنع التمويه، الذي يمكن تطبيقه قبل دمج الأصوات والفيديوهات للانتباه المتقاطع أو لأي latent لا يجب تمويهه. + +## المدخلات + +| المعامل | الوصف | نوع البيانات | إلزامي | نطاق | +|-----------|-------------|-----------|----------|-------| +| `كامن` | latent الفيديو أو الصوت الذي سيتم تجميده. الصوت هو 4D؛ الفيديو هو 5D. | LATENT | نعم | غير محدد | +| `samples` | tensor يحتوي على عينات latent. الصوت هو 4D (المجموعة، القنوات، الإطارات، العينات); الفيديو هو 5D (المجموعة، القنوات، الارتفاع، العرض، الإطارات) | TENSOR | نعم | Audio: 4D (batch, channels, frames, samples); Video: 5D (batch, channels, height, width, frames) | + +## المخرجات + +| اسم المخرج | الوصف | نوع البيانات | +|-------------|-------------|-----------| +| `كامن` | latent مع تعيين noise_mask إلى 0، مما يضمن بقاءه نظيفًا أثناء الاستنساخ. | LATENT | + +## ملاحظات + +- يجب أن يكون tensor `samples` tensor عاديًا وليس latent مدمجًا. إذا كان latent مدمجًا، يجب تقسيمه أولاً باستخدام عقدة Separate AV Latent. +- ستكون المخرج `latent` تحتوي على noise_mask صفر، مما يمنع التمويه للlatent المحدد. +- يدعم العقدة latents الصوتية والفيديوية، مع أشكال tensor مختلفة لكل منها. +- إذا لم تتناسب شكل tensor `samples` مع الشكل المتوقع للصوت أو الفيديو، سيُرفع خطأ ValueError. + +**ملاحظة:** قد تحتوي التنفيذ الفعلي على قيود أو سلوكيات إضافية غير مذكورة هنا. دائمًا تابع أحدث الشيفرة المصدرية للحصول على معلومات دقيقة أحدث. + +> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVFreezeLatent/ar.md) + +--- +**Source fingerprint (SHA-256):** `d5d228687f0a124644323c0448dcce53ed6eb2224d3f44d1756079b2a71539ca` diff --git a/comfyui_embedded_docs/docs/LTXVFreezeLatent/en.md b/comfyui_embedded_docs/docs/LTXVFreezeLatent/en.md new file mode 100644 index 000000000..e4f9bd70b --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVFreezeLatent/en.md @@ -0,0 +1,33 @@ +# LTXVFreezeLatent + +## Overview + +The LTXV Freeze Latent node is designed to set the noise_mask to 0 for a given latent, ensuring that the latent remains clean during sampling. It is particularly useful for freezing audio or video latents to prevent denoising, which can be applied before concatenating audio and video for cross-attention or for any latent that should not be denoised. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `latent` | Video or audio latent to freeze. Audio is 4D; video is 5D. | LATENT | Yes | N/A | +| `samples` | The tensor containing the latent samples. | TENSOR | Yes | Audio: 4D (batch, channels, frames, samples); Video: 5D (batch, channels, height, width, frames) | + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `latent` | The latent with a noise_mask set to 0, ensuring it remains clean during sampling. | LATENT | + +## Notes + +- The `samples` tensor must be a plain tensor and not a concatenated audio-video latent. If it is a concatenated latent, it should be split using the Separate AV Latent node first. +- The output `latent` will have a noise_mask of zeros, which prevents denoising for the specified latent. +- The node supports both audio and video latents, with different tensor shapes for each. +- If the shape of the `samples` tensor does not match the expected audio or video shape, a ValueError will be raised. +``` + +**Note:** The actual implementation may have additional constraints or behaviors not explicitly documented here. Always refer to the latest source code for the most accurate information. + +> 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/LTXVFreezeLatent/en.md) + +--- +**Source fingerprint (SHA-256):** `d5d228687f0a124644323c0448dcce53ed6eb2224d3f44d1756079b2a71539ca` diff --git a/comfyui_embedded_docs/docs/LTXVFreezeLatent/es.md b/comfyui_embedded_docs/docs/LTXVFreezeLatent/es.md new file mode 100644 index 000000000..00608ed55 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVFreezeLatent/es.md @@ -0,0 +1,33 @@ +# LTXVFreezeLatent + +## Resumen + +El nodo LTXV Freeze Latent está diseñado para establecer el noise_mask en 0 para un latente dado, asegurando que el latente permanezca limpio durante la muestreo. Es particularmente útil para congelar latentes de audio o video para evitar la desENOISE, que puede aplicarse antes de concatenar audio y video para la atención cruzada o para cualquier latente que no deba ser desenoisado. + +## Entradas + +| Parámetro | Descripción | Tipo de datos | Requerido | Rango | +|-----------|-------------|-----------|----------|-------| +| `latent` | Latente de video o audio que se debe congelar. El audio es de 4D; el video es de 5D. | LATENT | Sí | N/A | +| `samples` | El tensores que contiene las muestras latentes. | TENSOR | Sí | Audio: 4D (batch, canales, cuadros, muestras); Video: 5D (batch, canales, altura, anchura, cuadros) | + +## Salidas + +| Nombre de salida | Descripción | Tipo de datos | +|-------------|-------------|-----------| +| `latent` | El latente con un noise_mask establecido en 0, asegurando que permanezca limpio durante el muestreo. | LATENT | + +## Notas + +- El tensores `samples` debe ser un tensores plano y no un latente concatenado audio-video. Si es un latente concatenado, debe dividirse primero usando el nodo Separar Latente AV. +- La salida `latent` tendrá un noise_mask de ceros, lo que impide la desenoise para el latente especificado. +- El nodo admite tanto latentes de audio como de video, con diferentes formas tensoriales para cada uno. +- Si la forma del tensores `samples` no coincide con la forma esperada de audio o video, se lanzará un ValueError. +``` + +**Nota:** La implementación real puede tener restricciones o comportamientos adicionales no documentados aquí. Siempre referirse al código fuente más reciente para obtener la información más precisa. + +> 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/LTXVFreezeLatent/es.md) + +--- +**Source fingerprint (SHA-256):** `d5d228687f0a124644323c0448dcce53ed6eb2224d3f44d1756079b2a71539ca` diff --git a/comfyui_embedded_docs/docs/LTXVFreezeLatent/fa.md b/comfyui_embedded_docs/docs/LTXVFreezeLatent/fa.md new file mode 100644 index 000000000..77487e366 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVFreezeLatent/fa.md @@ -0,0 +1,31 @@ +# LTXVFreezeLatent + +## مقدمه + +گره LTXV Freeze Latent برای تنظیم noise_mask به 0 برای یک latent معین طراحی شده است، تا latent در طول نمونه‌گیری تمیز باقی بماند. این گره به ویژه برای فریز کردن latents صوتی یا تصویری برای جلوگیری از کاهش نویز مفید است، که می‌تواند قبل از ترکیب صوتی و تصویری برای توجه متقابل یا برای هر latent که نباید کاهش نویز شود، اعمال شود. + +## ورودی‌ها + +| پارامتر | توضیح | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `latent` | latent ویدیویی یا صوتی که باید فریز شود. صوت 4D است؛ ویدیو 5D. | LATENT | بله | N/A | +| `samples` | توری که شامل نمونه‌های latent است. | TENSOR | بله | صوت: 4D (بخش، کانال‌ها، فریم‌ها، نمونه‌ها); ویدیو: 5D (بخش، کانال‌ها، ارتفاع، عرض، فریم‌ها) | + +## خروجی‌ها + +| نام خروجی | توضیح | نوع داده | +|-------------|-------------|-----------| +| `latent` | latent با تنظیم noise_mask به 0، که اطمینان حاصل می‌کند که در طول نمونه‌گیری تمیز باقی می‌ماند. | LATENT | + +## یادداشت‌ها + +- توری `samples` باید یک توری ساده باشد و نه یک latent پیوسته صوتی-تصویری. اگر یک latent پیوسته است، باید ابتدا با استفاده از گره Separate AV Latent تقسیم شود. +- خروجی `latent` دارای noise_mask صفر خواهد بود که از کاهش نویز برای latent مشخص شده جلوگیری می‌کند. +- این گره از latents صوتی و تصویری پشتیبانی می‌کند، با شکل‌های توری متفاوت برای هر کدام. +- اگر شکل توری `samples` با شکل مورد انتظار صوتی یا تصویری مطابقت ندارد، یک ValueError ایجاد خواهد شد. +- توجه داشته باشید که اجرای واقعی ممکن است محدودیت‌ها یا رفتارهای اضافی داشته باشد که در اینجا به طور خاص مستند نشده‌اند. همیشه به منبع کد جدیدترین برای اطلاعات دقیق‌تر مراجعه کنید. + +> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVFreezeLatent/fa.md) + +--- +**Source fingerprint (SHA-256):** `d5d228687f0a124644323c0448dcce53ed6eb2224d3f44d1756079b2a71539ca` diff --git a/comfyui_embedded_docs/docs/LTXVFreezeLatent/fr.md b/comfyui_embedded_docs/docs/LTXVFreezeLatent/fr.md new file mode 100644 index 000000000..2c2a79db1 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVFreezeLatent/fr.md @@ -0,0 +1,33 @@ +# LTXVFreezeLatent + +## Aperçu + +Le nœud LTXV Freeze Latent est conçu pour définir le noise_mask sur 0 pour un latent donné, assurant ainsi que le latent reste propre pendant l'échantillonnage. Il est particulièrement utile pour geler les latents audio ou vidéo pour éviter le débruitage, qui peut être appliqué avant la concaténation audio et vidéo pour l'attention croisée ou pour tout latent qui ne devrait pas être débruité. + +## Entrées + +| Paramètre | Description | Type de données | Obligatoire | Gamme | +|-----------|-------------|-----------|----------|-------| +| `latent` | Latent vidéo ou audio à geler. L'audio est 4D ; la vidéo est 5D. | LATENT | Oui | N/A | +| `samples` | Le tenseur contenant les échantillons latents. | TENSOR | Oui | Audio : 4D (batch, channels, frames, samples) ; Vidéo : 5D (batch, channels, height, width, frames) | + +## Sorties + +| Nom de sortie | Description | Type de données | +|-------------|-------------|-----------| +| `latent` | Le latent avec un noise_mask défini sur 0, assurant ainsi qu'il reste propre pendant l'échantillonnage. | LATENT | + +## Notes + +- Le tenseur `samples` doit être un tenseur simple et non un latent audio-video concaténé. Si c'est un latent concaténé, il doit être divisé à l'aide du nœud Séparer le latent audio-video en premier. +- La sortie `latent` aura un noise_mask de zéros, ce qui empêche le débruitage pour le latent spécifié. +- Le nœud prend en charge à la fois les latents audio et vidéo, avec des formes de tenseurs différentes pour chacun. +- Si la forme du tenseur `samples` ne correspond pas à la forme audio ou vidéo attendue, une ValueError sera levée. +``` + +**Note:** La mise en œuvre réelle peut avoir des contraintes ou des comportements supplémentaires non explicitement documentés ici. Toujours vous référer au code source le plus récent pour obtenir les informations les plus précises. + +> 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/LTXVFreezeLatent/fr.md) + +--- +**Source fingerprint (SHA-256):** `d5d228687f0a124644323c0448dcce53ed6eb2224d3f44d1756079b2a71539ca` diff --git a/comfyui_embedded_docs/docs/LTXVFreezeLatent/ja.md b/comfyui_embedded_docs/docs/LTXVFreezeLatent/ja.md new file mode 100644 index 000000000..a31a92146 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVFreezeLatent/ja.md @@ -0,0 +1,32 @@ +# LTXVFreezeLatent + +## 概要 + +LTXV Freeze Latent ノードは、特定の潜在変数に対してノイズマスクを0に設定し、サンプリング中に潜在変数がクリーンなままになるように設計されています。特に、クロスアテンションやデノイズを防ぐために、オーディオやビデオの潜在変数をフリーザーにするのに非常に有用です。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|------------|------|---------|------|------| +| `潜在` | フリーザーにするビデオやオーディオの潜在変数。オーディオは4次元;ビデオは5次元。 | LATENT | はい | N/A | +| `samples` | 潜在サンプルを含むテンソル。 | TENSOR | はい | オーディオ:4次元(バッチ、チャンネル、フレーム、サンプル);ビデオ:5次元(バッチ、チャンネル、高さ、幅、フレーム) | + +## 出力 + +| 出力名 | 説明 | データ型 | +|--------|------|---------| +| `潜在` | ノイズマスクが0に設定され、サンプリング中にクリーンなままになる潜在変数。 | LATENT | + +## 注意事項 + +- `samples` テンソルはプラインテンソルでなければなりません。連結された潜在変数である場合、まず Separate AV Latent ノードを使用して分割する必要があります。 +- 出力 `latent` はノイズマスクがゼロで、指定された潜在変数に対してデノイズを防ぎます。 +- ノードはオーディオおよびビデオの潜在変数の両方をサポートし、それぞれ異なるテンソル形状を持ちます。 +- `samples` テンソルの形状が期待されるオーディオまたはビデオの形状に一致しない場合、ValueError が発生します。 + +**注意:** 実際の実装にはここに明示的に記載されていない追加の制約や動作がある可能性があります。最も正確な情報を得るために、常に最新のソースコードを参照してください。 + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVFreezeLatent/ja.md) + +--- +**Source fingerprint (SHA-256):** `d5d228687f0a124644323c0448dcce53ed6eb2224d3f44d1756079b2a71539ca` diff --git a/comfyui_embedded_docs/docs/LTXVFreezeLatent/ko.md b/comfyui_embedded_docs/docs/LTXVFreezeLatent/ko.md new file mode 100644 index 000000000..17f24ef66 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVFreezeLatent/ko.md @@ -0,0 +1,31 @@ +# LTXVFreezeLatent + +## 개요 + +LTXV Freeze Latent 노드는 주어진 latent에 대해 noise_mask를 0으로 설정하여 샘플링 중에 latent이 깨끗하게 유지되도록 설계되었습니다. 오디오나 비디오 latent을 언뜨리는 것을 방지하기 위해 특히 유용하며, 이는 오디오와 비디오를 결합하여 � Cre-attention을 적용하거나 언뜨리지 않아야 할 모든 latent에 적용할 수 있습니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `latent` | 언뜨리기 위해 설정할 비디오나 오디오 latent. 오디오는 4D; 비디오는 5D입니다. | LATENT | 예 | N/A | +| `samples` | latent 샘플을 포함하는 텐서. | TENSOR | 예 | 오디오: 4D (batch, channels, frames, samples); 비디오: 5D (batch, channels, height, width, frames) | + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `latent` | 샘플링 중에 noise_mask를 0으로 설정하여 깨끗하게 유지되도록 한 latent. | LATENT | + +## 주의사항 + +- `samples` 텐서는 평면 텐서여야 하며, 결합된 오디오-비디오 latent이 아니어야 합니다. 결합된 latent이면 먼저 Separate AV Latent 노드를 사용하여 분리해야 합니다. +- 출력 `latent`은 zero noise_mask를 가지며, 지정된 latent에 대한 언뜨리기를 방지합니다. +- 노드는 오디오와 비디오 latent 모두를 지원하며, 각각 다른 텐서 형상을 가집니다. +- `samples` 텐서의 형상이 예상된 오디오나 비디오 형상과 일치하지 않으면 ValueError가 발생합니다. +- **Note:** 실제 구현은 여기에 명시되지 않은 추가 제약 사항이나 동작이 있을 수 있습니다. 가장 정확한 정보를 얻기 위해 항상 최신 소스 코드를 참조하세요. + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVFreezeLatent/ko.md) + +--- +**Source fingerprint (SHA-256):** `d5d228687f0a124644323c0448dcce53ed6eb2224d3f44d1756079b2a71539ca` diff --git a/comfyui_embedded_docs/docs/LTXVFreezeLatent/pt-BR.md b/comfyui_embedded_docs/docs/LTXVFreezeLatent/pt-BR.md new file mode 100644 index 000000000..2f80abbdc --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVFreezeLatent/pt-BR.md @@ -0,0 +1,30 @@ +# LTXVFreezeLatent + +## Visão Geral + +O nó LTXV Freeze Latent foi projetado para definir o noise_mask como 0 para um latent específico, garantindo que o latent permaneça limpo durante a amostragem. É particularmente útil para congelar latentes de áudio ou vídeo para evitar a desnuvem, que pode ser aplicada antes de concatenar áudio e vídeo para cross-attention ou para qualquer latent que não deve ser desnuvem. + +## Entradas + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | +|-----------|-------------|-----------|----------|-------| +| `latent` | Latente de vídeo ou áudio a ser congelado. O áudio é 4D; o vídeo é 5D. | LATENT | Sim | N/A | +| `samples` | O tensor contendo as amostras do latent. | TENSOR | Sim | Áudio: 4D (lote, canais, quadros, amostras); Vídeo: 5D (lote, canais, altura, largura, quadros) | + +## Saídas + +| Nome da Saída | Descrição | Tipo de Dados | +|-------------|-------------|-----------| +| `latent` | O latent com o noise_mask definido como 0, garantindo que ele permaneça limpo durante a amostragem. | LATENT | + +## Notas + +- O tensor `samples` deve ser um tensor simples e não um latent concatenado áudio-vídeo. Se for um latent concatenado, ele deve ser dividido usando o nó Separate AV Latent primeiro. +- A saída `latent` terá um noise_mask de zeros, que impede a desnuvem para o latent especificado. +- O nó suporta tanto latentes de áudio quanto de vídeo, com diferentes formas de tensor para cada um. +- Se a forma do tensor `samples` não corresponder à forma esperada de áudio ou vídeo, um ValueError será levantado. + +> 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/LTXVFreezeLatent/pt-BR.md) + +--- +**Source fingerprint (SHA-256):** `d5d228687f0a124644323c0448dcce53ed6eb2224d3f44d1756079b2a71539ca` diff --git a/comfyui_embedded_docs/docs/LTXVFreezeLatent/ru.md b/comfyui_embedded_docs/docs/LTXVFreezeLatent/ru.md new file mode 100644 index 000000000..34bec3781 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVFreezeLatent/ru.md @@ -0,0 +1,33 @@ +# LTXVFreezeLatent + +## Обзор + +Узел LTXV Freeze Latent предназначен для установки значения noise_mask в 0 для заданного латентного значения, что обеспечивает сохранение чистоты латентного значения в процессе采样. Он особенно полезен для замораживания латентных данных аудио или видео, чтобы предотвратить деноising, который может быть применен перед объединением аудио и видео для кросс-внимания или для любого латентного значения, которое не должно быть деноised. + +## Входы + +| Параметр | Описание | Тип данных | Обязателен | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `latent` | Видео или аудио латентное значение для замораживания. Аудио — 4D; видео — 5D. | LATENT | Да | N/A | +| `samples` | Тензор, содержащий латентные образцы. | TENSOR | Да | Аудио: 4D (batch, channels, frames, samples); Видео: 5D (batch, channels, height, width, frames) | + +## Выходы + +| Название выхода | Описание | Тип данных | +|-------------|-------------|-----------| +| `latent` | Латентное значение с установленным noise_mask в 0, что обеспечивает его сохранение чистым в процессе采样. | LATENT | + +## Замечания + +- Тензор `samples` должен быть простым тензором и не должен быть объединенным аудио-видео латентным. Если это объединенный латент, его следует разделить с помощью узла Separate AV Latent сначала. +- Выход `latent` будет иметь noise_mask с нулями, что предотвращает деноising для указанного латентного значения. +- Узел поддерживает как аудио, так и видео латентные значения, с различной структурой тензоров для каждого. +- Если форма тензора `samples` не соответствует ожидаемой структуре аудио или видео, будет выведено ValueError. +``` + +**Примечание:** Реальное выполнение может иметь дополнительные ограничения или поведение, не указанные здесь. Всегда ссылайтесь на последнюю версию исходного кода для получения наиболее точной информации. + +> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVFreezeLatent/ru.md) + +--- +**Source fingerprint (SHA-256):** `d5d228687f0a124644323c0448dcce53ed6eb2224d3f44d1756079b2a71539ca` diff --git a/comfyui_embedded_docs/docs/LTXVFreezeLatent/tr.md b/comfyui_embedded_docs/docs/LTXVFreezeLatent/tr.md new file mode 100644 index 000000000..26d855ec7 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVFreezeLatent/tr.md @@ -0,0 +1,33 @@ +# LTXVFreezeLatent + +## Özet + +LTXV Freeze Latent düğümü, belirli bir latent için noise_mask'ı 0'a ayarlayarak, latent'in örnekleme sırasında temiz kalmasını sağlamak üzere tasarlanmıştır. Özellikle, audio veya video latent'leri denoising'den korumak için kullanılır ve bu, audio ve videoyu cross-attention için birleştirmeden önce veya denoising'e tabi tutulmaması gereken herhangi bir latent için uygulanabilir. + +## Girdiler + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +|-----------|-------------|-----------|----------|-------| +| `latent` | Dondurulacak video veya audio latent. Audio 4D; video 5D. | LATENT | Evet | N/A | +| `samples` | Latent örneklerini içeren tensor. | TENSOR | Evet | Audio: 4D (batch, kanallar, kareler, örnekler); Video: 5D (batch, kanallar, yükseklik, genişlik, kareler) | + +## Çıktılar + +| Çıktı Adı | Açıklama | Veri Türü | +|-------------|-------------|-----------| +| `latent` | Örnekleme sırasında temiz kalmasını sağlamak için noise_mask'ı 0'a ayarlanmış latent. | LATENT | + +## Notlar + +- `samples` tensor'ı düz bir tensor olmalıdır ve birleştirilmiş audio-video latent olmamalıdır. Birleştirilmiş latentse, önce Ayır AV Latent düğümü kullanılarak bölünmelidir. +- Çıktı `latent`, belirtilen latent için denoising'i önlemek için noise_mask'ı sıfırlardan oluşur. +- Düğüm hem audio hem de video latent'lerini destekler ve her biri için farklı tensor şekilleri vardır. +- `samples` tensor'ının şekli audio veya video şekline uygun değilse, bir ValueError hatası alınacaktır. +``` + +**Not:** Gerçek uygulamanın burada açıkça belirtilmeyen ek kısıtlamaları veya davranışları olabilir. En doğru bilgi için her zaman en son kaynak koduna başvurun. + +> 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/LTXVFreezeLatent/tr.md) + +--- +**Source fingerprint (SHA-256):** `d5d228687f0a124644323c0448dcce53ed6eb2224d3f44d1756079b2a71539ca` diff --git a/comfyui_embedded_docs/docs/LTXVFreezeLatent/zh-TW.md b/comfyui_embedded_docs/docs/LTXVFreezeLatent/zh-TW.md new file mode 100644 index 000000000..4da432b43 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVFreezeLatent/zh-TW.md @@ -0,0 +1,32 @@ +# LTXVFreezeLatent + +## 概述 + +LTXV 冻結潛在節點設計用於將給定潛在的 noise_mask 設為 0,確保在採樣過程中潛在保持乾淨。它特別適用於凍結音頻或視頻潛在以防止去噪,這可以在合併音頻和視頻進行交叉注意力之前或對於任何不應該去噪的潛在應用。 + +## 輸入 + +| 參數 | 描述 | 資料類型 | 必需 | 范圍 | +|-----------|-------------|-----------|----------|-------| +| `latent` | 要凍結的視頻或音頻潛在。音頻為 4D;視頻為 5D。 | LATENT | 是 | N/A | +| `samples` | 包含潛在樣本的張量。 | TENSOR | 是 | 音頻:4D(批次,通道,幀,樣本);視頻:5D(批次,通道,高度,寬度,幀) | + +## 輸出 + +| 輸出名 | 描述 | 資料類型 | +|-------------|-------------|-----------| +| `latent` | 將 noise_mask 設為 0 的潛在,確保它在採樣過程中保持乾淨。 | LATENT | + +## 注意事項 + +- `samples` 張量必須是普通張量,而不是合併的音頻-視頻潛在。如果它是合併的潛在,應先使用分離 AV 潛在節點進行分割。 +- 輸出的 `latent` 將具有零的 noise_mask,這會防止對指定潛在進行去噪。 +- 此節點支持音頻和視頻潛在,每種潛在具有不同的張量形状。 +- 如果 `samples` 張量的形状與預期的音頻或視頻形状不匹配,將引發 ValueError。 + +## 注意:**實際實現可能具有此處未明確記載的附加約束或行為。請始終參考最新的源代碼以獲取最準確的信息。** + +> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVFreezeLatent/zh-TW.md) + +--- +**Source fingerprint (SHA-256):** `d5d228687f0a124644323c0448dcce53ed6eb2224d3f44d1756079b2a71539ca` diff --git a/comfyui_embedded_docs/docs/LTXVFreezeLatent/zh.md b/comfyui_embedded_docs/docs/LTXVFreezeLatent/zh.md new file mode 100644 index 000000000..3a1d51aa7 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVFreezeLatent/zh.md @@ -0,0 +1,32 @@ +# LTXVFreezeLatent + +## 简介 + +LTXV 冻结潜在值节点旨在将给定潜在值的噪声掩码设置为 0,确保在采样过程中潜在值保持干净。它特别适用于冻结音频或视频潜在值以防止去噪,这可以在音频和视频连接用于交叉注意力之前或对于任何不应进行去噪的潜在值应用。 + +## 输入 + +| 参数 | 描述 | 数据类型 | 必需 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `潜空间` | 要冻结的视频或音频潜在值。音频为 4D;视频为 5D。 | LATENT | 是 | N/A | +| `samples` | 包含潜在样本的张量。 | TENSOR | 是 | 音频:4D(批次,通道,帧,样本);视频:5D(批次,通道,高度,宽度,帧) | + +## 输出 + +| 输出名称 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `潜空间` | 噪声掩码设置为 0 的潜在值,确保在采样过程中保持干净。 | LATENT | + +## 注意事项 + +- `samples` 张量必须是一个纯张量,而不是连接的音频-视频潜在值。如果是连接的潜在值,应首先使用分离 AV 潜在值节点进行拆分。 +- 输出 `latent` 将具有零噪声掩码,这会防止对指定的潜在值进行去噪。 +- 节点支持音频和视频潜在值,每种都有不同的张量形状。 +- 如果 `samples` 张量的形状与预期的音频或视频形状不匹配,将引发 ValueError。 + +## 注意:**实际的实现可能具有此处未明确记录的额外约束或行为。请始终参考最新的源代码以获取最准确的信息。** + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVFreezeLatent/zh.md) + +--- +**Source fingerprint (SHA-256):** `d5d228687f0a124644323c0448dcce53ed6eb2224d3f44d1756079b2a71539ca` diff --git a/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/ar.md b/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/ar.md new file mode 100644 index 000000000..fda21fbec --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/ar.md @@ -0,0 +1,44 @@ +# LTXVGeneratedKeyframesToGuides + +## نظرة عامة + +يُربط عقدة تحويل الكفانات المولدة إلى إرشادات الكفانات المولدة من المراحل السابقة كإرشادات صور ثابتة على لوحة رسم لاحقة. يفكode الكفانات كإطارات مستقلة، يغير حجمها إذا لزم الأمر، ويكتبها مع قناع ضجيج بـ 0 لمنع التمويه المزيدي. يتم تقييم الفهارس المسجلة من اللوحة التي تم إنشاء الكفانات عليها إلى اللوحة الهدف، ويمكنك تغيير الفهارس الإطارية لتحديد المواضع بشكل مباشر. + +## المدخلات + +| المعامل | الوصف | نوع البيانات | إلزامي | نطاق | +|-----------|-----------------------------------------------------------------------------|-----------|----------|-------| +| `إيجابي` | التشغيل الإيجابي مع الكفانات المربوطة كإرشادات صور. | CONDITIONING | نعم | | +| `سلبي` | التشغيل السلبي مع الكفانات المربوطة كإرشادات صور. | CONDITIONING | نعم | | +| `vae` | نموذج VAE الذي سيتم استخدامه لفكode الكفانات. | MODEL | نعم | | +| `كامن` | الفيديو المظلم المستهدف الذي سيتم إضافة الإرشادات إليه، على سبيل المثال، الفيديو المضاعف زمنيًا. | LATENT | نعم | | +| `الإطارات الرئيسية` | مخرجات الكفانات من LTXV Separate Generated Keyframes، التي تحمل فهرس إطار كل كفاءة تم إنشاؤها في إطار بكسل. | LATENT | نعم | | +| `القوة` | قوة الإرشاد. 1.0 هو ربط قوي؛ القيم الأقل ترفقها. | FLOAT | نعم | 0.0 - 10.0 | +| `override_frame_indices` | اختياري — ربط في هذه الإطارات البكسلية بدلاً من المواضع المسجلة (أو المقياس تلقائيًا). قدم فهرسًا واحدًا لكل كفاءة. اتركه فارغًا لإعادة استخدام المواضع المسجلة، أو لقياسها عند تكون اللوحة الهدف طولًا مختلفًا (على سبيل المثال، بعد مضاعفة الوقت). | STRING | لا | | + +## المخرجات + +| اسم المخرج | الوصف | نوع البيانات | +|-------------|-----------------------------------------------------------------------------|-----------| +| `إيجابي` | التشغيل الإيجابي مع الكفانات المربوطة كإرشادات صور. | CONDITIONING | +| `سلبي` | التشغيل السلبي مع الكفانات المربوطة كإرشادات صور. | CONDITIONING | +| `كامن` | الفيديو المظلم المستهدف مع إضافة الكفانات كإرشادات ثابتة. | LATENT | + +## ملاحظات + +- يتحكم المعامل `strength` في قوة ربط الكفانات كإرشادات. يخلق القيمة 1.0 ربطًا قويًا، بينما ترفق القيم الأقل. +- يسمح المعامل `override_frame_indices` بتخصيص الإطارات البكسلية المحددة حيث يجب ربط الكفانات. إذا تم تركه فارغًا، سيستخدم العقدة المواضع المسجلة أو يقيسها إذا لزم الأمر. +- يفترض العقدة أن يحتوي الفهارس المظلمة `keyframes` على فهرس إطار البكسل للكفاءة لكل كفاءة. إذا لم يكن ذلك الحال، سيقوم العقدة بإصدار `ValueError`. +- يدعم العقدة حجم مجموعة واحدة فقط. كل إرشاد يتم ترميزه من صورة واحدة، لذا لا يمكن أن يختلف عبر عناصر المجموعة. +- سيقوم العقدة بإصدار `ValueError` إذا لم يكن tensor `samples` في المدخل `latent` هو tensor 5D أو إذا كان حجم المجموعة ليس 1. +- سيقوم العقدة بإصدار `ValueError` إذا لم يكن tensor `samples` في المدخل `keyframes` هو tensor 5D أو إذا كان حجم المجموعة ليس 1. +- سيقوم العقدة بإصدار `ValueError` إذا لم يكن شكل tensor `samples` في المدخل `keyframes` يتطابق مع شكل tensor `samples` في المدخل `latent` بعد تغيير الحجم. +- سيقوم العقدة بإصدار `ValueError` إذا كان المعامل `strength` خارج النطاق من 0.0 إلى 10.0. +- سيقوم العقدة بإصدار `ValueError` إذا كان المعامل `override_frame_indices` ليس قائمة مكونة من أرقام مفصولة بالكوما أو إذا لم يكن عدد الأرقام يتطابق مع عدد الكفوات. +- سيقوم العقدة بإصدار `ValueError` إذا كان أي من الأرقام في المعامل `override_frame_indices` خارج النطاق من 1 إلى عدد الإطارات البكسلية في اللوحة الهدف. +- سيقوم العقدة بإصدار `ValueError` إذا كان أعلى فهرس في المعامل `override_frame_indices` أكبر من عدد الإطارات البكسلية في اللوحة الهدف. + +> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/ar.md) + +--- +**Source fingerprint (SHA-256):** `b5dbf302fad5a7ffd3522d468d1a51b993145d90277592058315499f08e17e7b` diff --git a/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/en.md b/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/en.md new file mode 100644 index 000000000..7eee81865 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/en.md @@ -0,0 +1,44 @@ +# LTXVGeneratedKeyframesToGuides + +## Overview + +The LTXV Generated Keyframes to Guides node pins generated keyframes from an earlier stage as frozen image guides on a later canvas. It decodes the keyframes as standalone frames, resizes them if needed, and writes them with a noise mask of 0 to prevent further denoising. The recorded indices are scaled from the canvas they were generated on to the target canvas, and you can override the frame indices to set positions explicitly. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|---------------------------|-----------------------------------------------------------------------------|-----------|----------|-------| +| `positive` | Positive conditioning with the keyframes pinned as image guides. | CONDITIONING | Yes | | +| `negative` | Negative conditioning with the keyframes pinned as image guides. | CONDITIONING | Yes | | +| `vae` | The VAE model to use for decoding the keyframes. | MODEL | Yes | | +| `latent` | The target video latent to add the guides to, e.g., the temporally upscaled one. | LATENT | Yes | | +| `keyframes` | The keyframes output of LTXV Separate Generated Keyframes, which carries the pixel frame index each keyframe was generated at. | LATENT | Yes | | +| `strength` | Guide strength. 1.0 is a hard pin; lower values relax it. | FLOAT | Yes | 0.0 - 10.0 | +| `override_frame_indices` | Optional — pin at these pixel frames instead of the recorded (or auto-scaled) positions. Provide one index per keyframe. Leave empty to reuse recorded positions, or to scale them when the target canvas is a different length (e.g., after temporal x2). | STRING | No | | + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-----------------------------------------------------------------------------|-----------| +| `positive` | Positive conditioning with the keyframes pinned as image guides. | CONDITIONING | +| `negative` | Negative conditioning with the keyframes pinned as image guides. | CONDITIONING | +| `latent` | Target video latent with the keyframes added as frozen guides. | LATENT | + +## Notes + +- The `strength` parameter controls how strongly the keyframes are pinned as guides. A value of 1.0 creates a hard pin, while lower values relax the pinning. +- The `override_frame_indices` parameter allows you to specify the exact pixel frames where the keyframes should be pinned. If left empty, the node will use the recorded positions or scale them if necessary. +- The node assumes that the `keyframes` latent contains the pixel frame index for each keyframe. If this is not the case, the node will raise a `ValueError`. +- The node only supports a batch size of 1. Each guide is encoded from one image, so it cannot differ across batch elements. +- The node will raise a `ValueError` if the `samples` tensor in the `latent` input is not a 5D tensor or if the batch size is not 1. +- The node will raise a `ValueError` if the `samples` tensor in the `keyframes` input is not a 5D tensor or if the batch size is not 1. +- The node will raise a `ValueError` if the shape of the `samples` tensor in the `keyframes` input does not match the shape of the `samples` tensor in the `latent` input after resizing. +- The node will raise a `ValueError` if the `strength` parameter is outside the range of 0.0 to 10.0. +- The node will raise a `ValueError` if the `override_frame_indices` parameter is not a comma-separated list of integers or if the number of indices does not match the number of keyframes. +- The node will raise a `ValueError` if any of the indices in the `override_frame_indices` parameter are outside the range of 1 to the number of pixel frames in the target canvas. +- The node will raise a `ValueError` if the maximum index in the `override_frame_indices` parameter is greater than the number of pixel frames in the target canvas. + +> 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/LTXVGeneratedKeyframesToGuides/en.md) + +--- +**Source fingerprint (SHA-256):** `b5dbf302fad5a7ffd3522d468d1a51b993145d90277592058315499f08e17e7b` diff --git a/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/es.md b/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/es.md new file mode 100644 index 000000000..94eb8ef0e --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/es.md @@ -0,0 +1,44 @@ +# LTXVGeneratedKeyframesToGuides + +## Resumen + +El nodo LTXV Generados Claveframes a Guías fija los claveframes generados en una etapa anterior como guías de imagen congeladas en un lienzo posterior. Decodifica los claveframes como cuadros independientes, los redimensiona si es necesario y los escribe con una máscara de ruido de 0 para evitar el desenoising adicional. Los índices grabados se escalan desde el lienzo en el que se generaron al lienzo objetivo, y puedes anular los índices de cuadros para establecer posiciones explícitamente. + +## Entradas + +| Parámetro | Descripción | Tipo de Datos | Requerido | Rango | +|---------------------------|-----------------------------------------------------------------------------|---------------|-----------|-------| +| `positive` | Condicionamiento positivo con los claveframes fijados como guías de imagen. | CONDITIONING | Sí | | +| `negative` | Condicionamiento negativo con los claveframes fijados como guías de imagen. | CONDITIONING | Sí | | +| `vae` | El modelo VAE a usar para decodificar los claveframes. | MODEL | Sí | | +| `latent` | El video latente objetivo al que agregar las guías, por ejemplo, el temporalmente escalado. | LATENT | Sí | | +| `keyframes` | La salida claveframes de LTXV Separar Claveframes Generados, que lleva el índice de cuadro de píxeles en el que se generó cada claveframe. | LATENT | Sí | | +| `strength` | Fuerteza de la guía. 1.0 es un fijo duro; valores más bajos lo relajan. | FLOAT | Sí | 0.0 - 10.0 | +| `override_frame_indices` | Opcional — fija en estos cuadros de píxeles en lugar de las posiciones grabadas (o escaladas automáticamente). Proporciona un índice por claveframe. Deja vacío para reutilizar las posiciones grabadas o para escalarlas cuando el lienzo objetivo tiene una longitud diferente (por ejemplo, después de temporal x2). | STRING | No | | + +## Salidas + +| Nombre de Salida | Descripción | Tipo de Datos | +|------------------|-----------------------------------------------------------------------------|---------------| +| `positive` | Condicionamiento positivo con los claveframes fijados como guías de imagen. | CONDITIONING | +| `negative` | Condicionamiento negativo con los claveframes fijados como guías de imagen. | CONDITIONING | +| `latent` | Video latente objetivo con los claveframes agregados como guías congeladas. | LATENT | + +## Notas + +- El parámetro `strength` controla cuán fuertemente los claveframes se fijan como guías. Un valor de 1.0 crea un fijo duro, mientras que valores más bajos relajan el fijo. +- El parámetro `override_frame_indices` permite especificar los cuadros de píxeles exactos donde deben fijarse los claveframes. Si se deja vacío, el nodo utilizará las posiciones grabadas o las escalará si es necesario. +- El nodo asume que el latente `keyframes` contiene el índice de cuadro de píxeles para cada claveframe. Si esto no es el caso, el nodo lanzará un `ValueError`. +- El nodo solo admite un tamaño de lote de 1. Cada guía se codifica a partir de una imagen, por lo que no puede diferir entre elementos del lote. +- El nodo lanzará un `ValueError` si la tensores `samples` en la entrada `latent` no es una tensores de 5D o si el tamaño del lote no es 1. +- El nodo lanzará un `ValueError` si la tensores `samples` en la entrada `keyframes` no es una tensores de 5D o si el tamaño del lote no es 1. +- El nodo lanzará un `ValueError` si la forma de la tensores `samples` en la entrada `keyframes` no coincide con la forma de la tensores `samples` en la entrada `latent` después de redimensionar. +- El nodo lanzará un `ValueError` si el parámetro `strength` está fuera del rango de 0.0 a 10.0. +- El nodo lanzará un `ValueError` si el parámetro `override_frame_indices` no es una lista de enteros separados por comas o si el número de índices no coincide con el número de claveframes. +- El nodo lanzará un `ValueError` si algún índice en el parámetro `override_frame_indices` está fuera del rango de 1 al número de cuadros de píxeles en el lienzo objetivo. +- El nodo lanzará un `ValueError` si el índice máximo en el parámetro `override_frame_indices` es mayor que el número de cuadros de píxeles en el lienzo objetivo. + +> 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/LTXVGeneratedKeyframesToGuides/es.md) + +--- +**Source fingerprint (SHA-256):** `b5dbf302fad5a7ffd3522d468d1a51b993145d90277592058315499f08e17e7b` diff --git a/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/fa.md b/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/fa.md new file mode 100644 index 000000000..809bfbbf3 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/fa.md @@ -0,0 +1,44 @@ +# LTXVGeneratedKeyframesToGuides + +## مقدمه + +گره‌ی تبدیل کلایمز کلیدفریم‌های تولید شده به راهنماهای تصویری کلیدفریم‌های تولید شده در مرحله‌های پیشین را به عنوان راهنماهای تصویری فریز شده بر روی کانواس‌های بعدی ثابت می‌کند. این گره کلیدفریم‌ها را به عنوان فریم‌های مستقل رمزگشایی می‌کند، اگر نیاز باشد آن‌ها را تغییر اندازه می‌دهد و آن‌ها را با ماسک نویز ۰ می‌نویسد تا از دنوایزینگ بیشتر جلوگیری شود. شمارنده‌های ضبط شده از کانواس‌هایی که در آن‌ها تولید شده‌اند به کانواس هدف مقیاس‌بندی می‌شوند و شما می‌توانید شمارنده‌های فریم را تغییر دهید تا موقعیت‌ها را به صورت مشخص تنظیم کنید. + +## ورودی‌ها + +| پارامتر | توضیح | نوع داده | الزامی | محدوده | +|---------------------------|-----------------------------------------------------------------------------|-----------|----------|-------| +| `positive` | شروط مثبت با کلیدفریم‌هایی که به عنوان راهنماهای تصویری ثابت شده‌اند. | CONDITIONING | بله | | +| `negative` | شروط منفی با کلیدفریم‌هایی که به عنوان راهنماهای تصویری ثابت شده‌اند. | CONDITIONING | بله | | +| `vae` | مدل VAE برای رمزگشایی کلیدفریم‌ها. | MODEL | بله | | +| `latent` | ویدیوی latent هدف برای افزودن راهنماهای به آن، به عنوان مثال، ویدیوی افزایش‌یافته زمانی. | LATENT | بله | | +| `keyframes` | خروجی کلیدفریم‌های LTXV Separate Generated Keyframes که شامل شمارنده‌ی فریم پیکسلی هر کلیدفریم تولید شده است. | LATENT | بله | | +| `strength` | قدرت راهنما. ۱.۰ یک ثابت سخت است؛ مقادیر پایین‌تر آن را آرام می‌کنند. | FLOAT | بله | ۰.۰ - ۱۰.۰ | +| `override_frame_indices` | اختیاری — در این فریم‌های پیکسلی ثابت کنید به جای موقعیت‌های ضبط شده (یا مقیاس‌بندی شده) به صورت خودکار. یک شمارنده برای هر کلیدفریم ارائه دهید. خالی بگذارید تا موقعیت‌های ضبط شده استفاده شوند یا مقیاس‌بندی شوند زمانی که کانواس هدف طول متفاوتی دارد (به عنوان مثال، بعد از افزایش زمانی x۲). | STRING | خیر | | + +## خروجی‌ها + +| نام خروجی | توضیح | نوع داده | +|-------------|-----------------------------------------------------------------------------|-----------| +| `positive` | شروط مثبت با کلیدفریم‌هایی که به عنوان راهنماهای تصویری ثابت شده‌اند. | CONDITIONING | +| `negative` | شروط منفی با کلیدفریم‌هایی که به عنوان راهنماهای تصویری ثابت شده‌اند. | CONDITIONING | +| `latent` | ویدیوی latent هدف با کلیدفریم‌هایی که به عنوان راهنماهای فریز شده اضافه شده‌اند. | LATENT | + +## یادداشت‌ها + +- پارامتر `strength` قدرت چسبندگی کلیدفریم‌ها به عنوان راهنماهای را کنترل می‌کند. مقدار ۱.۰ یک چسبندگی سخت ایجاد می‌کند، در حالی که مقادیر پایین‌تر آن را آرام می‌کنند. +- پارامتر `override_frame_indices` به شما اجازه می‌دهد تا فریم‌های پیکسلی دقیقی را که کلیدفریم‌ها باید در آن‌ها ثابت شوند، مشخص کنید. اگر خالی باشد، گره موقعیت‌های ضبط شده را استفاده می‌کند یا آن‌ها را مقیاس‌بندی می‌کند اگر نیاز باشد. +- گره فرض می‌کند که latent `keyframes` شامل شمارنده‌ی فریم پیکسلی برای هر کلیدفریم است. اگر اینطور نباشد، گره خطای `ValueError` ایجاد می‌کند. +- گره تنها از حجم باتچ ۱ پشتیبانی می‌کند. هر راهنما از یک تصویر یکپارچه شده است، بنابراین نمی‌تواند بین عناصر باتچ متفاوت باشد. +- گره خطای `ValueError` ایجاد می‌کند اگر تانسور `samples` در ورودی `latent` یک تانسور ۵D نباشد یا اگر حجم باتچ ۱ نباشد. +- گره خطای `ValueError` ایجاد می‌کند اگر تانسور `samples` در ورودی `keyframes` یک تانسور ۵D نباشد یا اگر حجم باتچ ۱ نباشد. +- گره خطای `ValueError` ایجاد می‌کند اگر شکل تانسور `samples` در ورودی `keyframes` با شکل تانسور `samples` در ورودی `latent` بعد از تغییر اندازه‌گذاری مطابقت نداشته باشد. +- گره خطای `ValueError` ایجاد می‌کند اگر پارامتر `strength` خارج از محدوده‌ی ۰.۰ تا ۱۰.۰ باشد. +- گره خطای `ValueError` ایجاد می‌کند اگر پارامتر `override_frame_indices` یک لیست از اعداد جدا شده با کاما نباشد یا اگر تعداد شمارنده‌ها با تعداد کلیدفریم‌ها مطابقت نداشته باشد. +- گره خطای `ValueError` ایجاد می‌کند اگر هیچ‌یک از شمارنده‌ها در پارامتر `override_frame_indices` خارج از محدوده‌ی ۱ تا تعداد فریم‌های پیکسلی در کانواس هدف باشد. +- گره خطای `ValueError` ایجاد می‌کند اگر بیشترین شمارنده در پارامتر `override_frame_indices` از تعداد فریم‌های پیکسلی در کانواس هدف بیشتر باشد. + +> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/fa.md) + +--- +**Source fingerprint (SHA-256):** `b5dbf302fad5a7ffd3522d468d1a51b993145d90277592058315499f08e17e7b` diff --git a/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/fr.md b/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/fr.md new file mode 100644 index 000000000..6631d012c --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/fr.md @@ -0,0 +1,44 @@ +# LTXVGeneratedKeyframesToGuides + +## Aperçu + +Le nœud LTXV Générés Clés à Guides fixe les clés générées à une étape précédente en tant que guides d'image figées sur un canevas ultérieur. Il décode les clés comme des images indépendantes, les redimensionne si nécessaire, et les écrit avec un masque de bruit à 0 pour éviter un débruitage supplémentaire. Les indices enregistrés sont étalonnés à partir du canevas où ils ont été générés vers le canevas cible, et vous pouvez remplacer les indices de cadre pour définir des positions explicitement. + +## Entrées + +| Paramètre | Description | Type de données | Obligatoire | Gamme | +|---------------------------|-----------------------------------------------------------------------------|-----------------|--------------|-------| +| `positive` | Conditionnement positif avec les clés fixées en tant que guides d'image. | CONDITIONING | Oui | | +| `negative` | Conditionnement négatif avec les clés fixées en tant que guides d'image. | CONDITIONING | Oui | | +| `vae` | Le modèle VAE à utiliser pour décoder les clés. | MODEL | Oui | | +| `latent` | La vidéo latente cible auxquelles ajouter les guides, par exemple, la version temporellement agrandie. | LATENT | Oui | | +| `keyframes` | Les clés en sortie de LTXV Séparer Générés Clés, qui contient l'index de cadre pixelique à chaque clé générée. | LATENT | Oui | | +| `strength` | Force du guide. 1.0 est un fixation rigide ; les valeurs inférieures le relâchent. | FLOAT | Oui | 0.0 - 10.0 | +| `override_frame_indices` | Optionnel — fixer à ces cadres pixeliques au lieu des positions enregistrées (ou étalonnées) automatiquement. Fournir un index par clé. Laisser vide pour réutiliser les positions enregistrées ou les étaler si nécessaire. | STRING | Non | | + +## Sorties + +| Nom de sortie | Description | Type de données | +|---------------|-----------------------------------------------------------------------------|-----------------| +| `positive` | Conditionnement positif avec les clés fixées en tant que guides d'image. | CONDITIONING | +| `negative` | Conditionnement négatif avec les clés fixées en tant que guides d'image. | CONDITIONING | +| `latent` | Vidéo latente cible avec les clés ajoutées en tant que guides figés. | LATENT | + +## Notes + +- Le paramètre `strength` contrôle la force avec laquelle les clés sont fixées en tant que guides. Une valeur de 1.0 crée une fixation rigide, tandis que les valeurs inférieures la relâchent. +- Le paramètre `override_frame_indices` permet de spécifier les cadres pixeliques exacts où les clés doivent être fixées. Si laissé vide, le nœud utilisera les positions enregistrées ou les étalonnera si nécessaire. +- Le nœud suppose que la latente `keyframes` contient l'index de cadre pixelique pour chaque clé. Si ce n'est pas le cas, le nœud lèvera une `ValueError`. +- Le nœud ne prend en charge qu'une taille de lot de 1. Chaque guide est codé à partir d'une image, donc il ne peut pas différer entre les éléments du lot. +- Le nœud lèvera une `ValueError` si le tenseur `samples` dans l'entrée `latent` n'est pas un tenseur 5D ou si la taille de lot n'est pas de 1. +- Le nœud lèvera une `ValueError` si le tenseur `samples` dans l'entrée `keyframes` n'est pas un tenseur 5D ou si la taille de lot n'est pas de 1. +- Le nœud lèvera une `ValueError` si la forme du tenseur `samples` dans l'entrée `keyframes` ne correspond pas à la forme du tenseur `samples` dans l'entrée `latent` après redimensionnement. +- Le nœud lèvera une `ValueError` si le paramètre `strength` est en dehors de la gamme de 0.0 à 10.0. +- Le nœud lèvera une `ValueError` si le paramètre `override_frame_indices` n'est pas une liste de nombres entiers séparés par des virgules ou si le nombre d'indices ne correspond pas au nombre de clés. +- Le nœud lèvera une `ValueError` si l'un des indices dans le paramètre `override_frame_indices` est en dehors de la gamme de 1 à la nombre de cadres pixeliques dans le canevas cible. +- Le nœud lèvera une `ValueError` si l'index maximal dans le paramètre `override_frame_indices` est supérieur au nombre de cadres pixeliques dans le canevas cible. + +> 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/LTXVGeneratedKeyframesToGuides/fr.md) + +--- +**Source fingerprint (SHA-256):** `b5dbf302fad5a7ffd3522d468d1a51b993145d90277592058315499f08e17e7b` diff --git a/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/ja.md b/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/ja.md new file mode 100644 index 000000000..566ad7fe9 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/ja.md @@ -0,0 +1,44 @@ +# LTXVGeneratedKeyframesToGuides + +## 概要 + +LTXV 生成キーフレームをガイドにノードは、前のステージから生成されたキーフレームを後のキャンバス上に凍結した画像ガイドとしてピン留めします。キーフレームを独立したフレームとしてデコードし、必要に応じてリサイズし、ノイズをさらに除去しないように 0 のノイズマスクで書き込みます。記録されたインデックスは、生成されたキャンバスからターゲットキャンバスにスケールされ、フレームインデックスを明示的に設定するためにオーバーライドできます。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-------------|-----------------------------------------------------------------------------|-----------|----------|-------| +| `ポジティブ` | キーフレームを画像ガイドとしてピン留めされたポジティブコンディショニング | CONDITIONING | はい | | +| `ネガティブ` | キーフレームを画像ガイドとしてピン留めされたネガティブコンディショニング | CONDITIONING | はい | | +| `vae` | キーフレームをデコードするために使用する VAE モデル | MODEL | はい | | +| `潜在` | キーフレームを追加するターゲットビデオのラテンシティ | LATENT | はい | | +| `キーフレーム` | LTXV 分離生成キーフレームの出力キーフレーム、各キーフレームが生成されたピクセルフレームインデックスを持ちます | LATENT | はい | | +| `強度` | ガイドの強度。1.0 はハードピン;低い値はピン留めを緩めます | FLOAT | はい | 0.0 - 10.0 | +| `override_frame_indices` | オプション - これらのピクセルフレームにピン留めします。各キーフレームごとにインデックスを提供します。空のままにすると、記録された位置を再利用するか、ターゲットキャンバスの長さが異なる場合(例:時間的に x2 した後)にスケールします | STRING | いいえ | | + +## 出力 + +| 出力名 | 説明 | データ型 | +|-------------|-----------------------------------------------------------------------------|-----------| +| `ポジティブ` | キーフレームを画像ガイドとしてピン留めされたポジティブコンディショニング | CONDITIONING | +| `ネガティブ` | キーフレームを画像ガイドとしてピン留めされたネガティブコンディショニング | CONDITIONING | +| `潜在` | キーフレームを凍結したガイドとして追加されたターゲットビデオのラテンシティ | LATENT | + +## 注意事項 + +- `strength` パラメータは、キーフレームがガイドとしてどれだけ強くピン留めされるかを制御します。1.0 の値はハードピンを作成し、低い値はピン留めを緩めます。 +- `override_frame_indices` パラメータは、キーフレームがピン留めされる正確なピクセルフレームを指定するのに使用されます。空のままにすると、記録された位置を使用するか、必要に応じてスケールします。 +- ノードは、`keyframes` ラテンシティが各キーフレームのピクセルフレームインデックスを含むと仮定します。これがそうでない場合、ノードは `ValueError` を発生させます。 +- ノードはバッチサイズ 1 をサポートしています。各ガイドは 1 つの画像からエンコードされるため、バッチ要素間で異なることはできません。 +- `latent` 入力の `samples` テンソルが 5D テンソルでない場合またはバッチサイズが 1 でない場合、ノードは `ValueError` を発生させます。 +- `keyframes` 入力の `samples` テンソルが 5D テンソルでない場合またはバッチサイズが 1 でない場合、ノードは `ValueError` を発生させます。 +- `keyframes` 入力の `samples` テンソルの `samples` テンソルの形状がリサイズ後に `latent` 入力の `samples` テンソルの形状と一致しない場合、ノードは `ValueError` を発生させます。 +- `strength` パラメータが 0.0 から 10.0 の範囲外にある場合、ノードは `ValueError` を発生させます。 +- `override_frame_indices` パラメータがカンマ区切りの整数リストでない場合またはインデックスの数がキーフレームの数と一致しない場合、ノードは `ValueError` を発生させます。 +- `override_frame_indices` パラメータのインデックスのいずれかが 1 からターゲットキャンバスのピクセルフレームの数までの範囲外にある場合、ノードは `ValueError` を発生させます。 +- `override_frame_indices` パラメータの最大インデックスがターゲットキャンバスのピクセルフレームの数を超える場合、ノードは `ValueError` を発生させます。 + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/ja.md) + +--- +**Source fingerprint (SHA-256):** `b5dbf302fad5a7ffd3522d468d1a51b993145d90277592058315499f08e17e7b` diff --git a/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/ko.md b/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/ko.md new file mode 100644 index 000000000..a687c5a33 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/ko.md @@ -0,0 +1,44 @@ +# LTXVGeneratedKeyframesToGuides + +## 개요 + +LTXV Generated Keyframes to Guides 노드는 이전 단계에서 생성된 키 프레임을 나중에 캔버스에 고정된 이미지 가이드로 변환합니다. 키 프레임을 독립된 프레임으로 디코딩한 후 필요에 따라 크기를 조정하고, 더 이상의 데노이즈를 방지하기 위해 0의 노이즈 마스크로 기록합니다. 기록된 인덱스는 생성된 캔버스에서 타겟 캔버스로 스케일링되며, 프레임 인덱스를 명시적으로 설정할 수 있습니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|---------------------------|-----------------------------------------------------------------------------|-----------|----------|-------| +| `positive` | 키 프레임이 이미지 가이드로 고정된 긍정 조건. | CONDITIONING | 예 | | +| `negative` | 키 프레임이 이미지 가이드로 고정된 부정 조건. | CONDITIONING | 예 | | +| `vae` | 키 프레임을 디코딩하는 데 사용할 VAE 모델. | MODEL | 예 | | +| `latent` | 가이드를 추가할 목표 비디오 렌탈, 예를 들어 시간적으로 업스케일된 것. | LATENT | 예 | | +| `keyframes` | LTXV Separate Generated Keyframes의 키 프레임 출력, 각 키 프레임이 생성된 픽셀 프레임 인덱스를 포함합니다. | LATENT | 예 | | +| `강도` | 가이드 강도. 1.0은 단단한 고정; 낮은 값은 고정을 완화합니다. | FLOAT | 예 | 0.0 - 10.0 | +| `override_frame_indices` | 선택적 — 이 픽셀 프레임에 고정합니다. 기록된 (또는 자동 스케일링된) 위치 대신 제공하십시오. 각 키 프레임당 하나의 인덱스를 제공합니다. 비어 있으면 기록된 위치를 재사용하거나 타겟 캔버스가 다른 길이일 때 (예: 시간적으로 x2 후) 스케일링합니다. | STRING | 아님 | | + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-----------------------------------------------------------------------------|-----------| +| `positive` | 키 프레임이 이미지 가이드로 고정된 긍정 조건. | CONDITIONING | +| `negative` | 키 프레임이 이미지 가이드로 고정된 부정 조건. | CONDITIONING | +| `latent` | 키 프레임이 추가된 렌탈로 변환된 목표 비디오. | LATENT | + +## 주의사항 + +- `strength` 매개변수는 키 프레임이 가이드로 고정되는 강도를 제어합니다. 1.0은 단단한 고정을 만들고, 낮은 값은 고정을 완화합니다. +- `override_frame_indices` 매개변수는 키 프레임이 고정될 정확한 픽셀 프레임을 지정할 수 있습니다. 비어 있으면 기록된 위치를 사용하거나 필요에 따라 스케일링합니다. +- 노드는 `keyframes` 렌탈이 각 키 프레임의 픽셀 프레임 인덱스를 포함하는 것을 가정합니다. 이렇지 않으면 노드는 `ValueError`를 발생시킵니다. +- 노드는 배치 크기가 1인 것만 지원합니다. 각 가이드는 하나의 이미지에서 인코딩되므로 배치 요소 간에 차이가 있을 수 없습니다. +- 노드는 `latent` 입력의 `samples` 텐서가 5D 텐서가 아니거나 배치 크기가 1이 아니면 `ValueError`를 발생시킵니다. +- 노드는 `keyframes` 입력의 `samples` 텐서가 5D 텐서가 아니거나 배치 크기가 1이 아니면 `ValueError`를 발생시킵니다. +- 노드는 `keyframes` 입력의 `samples` 텐서의 `samples` 텐서의 크기가 조정된 후 `latent` 입력의 `samples` 텐서의 크기와 일치하지 않으면 `ValueError`를 발생시킵니다. +- 노드는 `strength` 매개변수가 0.0에서 10.0 범위를 벗어나면 `ValueError`를 발생시킵니다. +- 노드는 `override_frame_indices` 매개변수가 콤마로 구분된 정수 목록이 아니거나 인덱스 수가 키 프레임 수와 일치하지 않으면 `ValueError`를 발생시킵니다. +- 노드는 `override_frame_indices` 매개변수의 인덱스가 타겟 캔버스의 픽셀 프레임 수 범위를 벗어나면 `ValueError`를 발생시킵니다. +- 노드는 `override_frame_indices` 매개변수의 최대 인덱스가 타겟 캔버스의 픽셀 프레임 수를 초과하면 `ValueError`를 발생시킵니다. + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/ko.md) + +--- +**Source fingerprint (SHA-256):** `b5dbf302fad5a7ffd3522d468d1a51b993145d90277592058315499f08e17e7b` diff --git a/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/pt-BR.md b/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/pt-BR.md new file mode 100644 index 000000000..f53cd04c5 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/pt-BR.md @@ -0,0 +1,44 @@ +# LTXVGeneratedKeyframesToGuides + +## Visão Geral + +O nó LTXV Gerados Keyframes para Guias fixa os keyframes gerados em uma etapa anterior como guias de imagem congelados em um canvas posterior. Ele decodifica os keyframes como quadros independentes, redimensiona-os se necessário e os escreve com uma máscara de ruído de 0 para evitar denoising adicional. Os índices registrados são escalados do canvas onde foram gerados para o canvas alvo, e você pode sobrescrever os índices de quadro para definir posições explicitamente. + +## Entradas + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | +|---------------------------|-----------------------------------------------------------------------------|-----------|----------|-------| +| `positive` | Condicionamento positivo com os keyframes fixados como guias de imagem. | CONDITIONING | Sim | | +| `negative` | Condicionamento negativo com os keyframes fixados como guias de imagem. | CONDITIONING | Sim | | +| `vae` | O modelo VAE a ser usado para decodificar os keyframes. | MODEL | Sim | | +| `latent` | O vídeo latente alvo para adicionar os guias, por exemplo, o temporariamente escalado. | LATENT | Sim | | +| `keyframes` | Saída de keyframes do LTXV Separar Gerados Keyframes, que carrega o índice de quadro de pixel em que cada keyframe foi gerado. | LATENT | Sim | | +| `strength` | Força do guia. 1.0 é um pin rígido; valores mais baixos relaxam. | FLOAT | Sim | 0.0 - 10.0 | +| `override_frame_indices` | Opcional — fixe em esses quadros de pixel em vez das posições registradas (ou escaladas) automaticamente. Forneça um índice por keyframe. Deixe em branco para reutilizar posições registradas ou para escalá-las quando o canvas alvo tiver um comprimento diferente (por exemplo, após temporal x2). | STRING | Não | | + +## Saídas + +| Nome da Saída | Descrição | Tipo de Dados | +|-------------|-----------------------------------------------------------------------------|-----------| +| `positive` | Condicionamento positivo com os keyframes fixados como guias de imagem. | CONDITIONING | +| `negative` | Condicionamento negativo com os keyframes fixados como guias de imagem. | CONDITIONING | +| `latent` | Vídeo latente alvo com os keyframes adicionados como guias congelados. | LATENT | + +## Notas + +- O parâmetro `strength` controla a força com que os keyframes são fixados como guias. Um valor de 1.0 cria um pin rígido, enquanto valores mais baixos relaxam o pinning. +- O parâmetro `override_frame_indices` permite que você especifique os quadros de pixel exatos onde os keyframes devem ser fixados. Se deixado em branco, o nó usará as posições registradas ou as escalonará se necessário. +- O nó assume que o latente `keyframes` contém o índice de quadro de pixel para cada keyframe. Se isso não for o caso, o nó levantará um `ValueError`. +- O nó suporta apenas um tamanho de lote de 1. Cada guia é codificada a partir de uma imagem, então não pode diferir entre elementos do lote. +- O nó levantará um `ValueError` se o tensor `samples` na entrada `latent` não for um tensor 5D ou se o tamanho do lote não for 1. +- O nó levantará um `ValueError` se o tensor `samples` na entrada `keyframes` não for um tensor 5D ou se o tamanho do lote não for 1. +- O nó levantará um `ValueError` se a forma do tensor `samples` na entrada `keyframes` não coincidir com a forma do tensor `samples` na entrada `latent` após o redimensionamento. +- O nó levantará um `ValueError` se o parâmetro `strength` estiver fora do intervalo de 0.0 a 10.0. +- O nó levantará um `ValueError` se o parâmetro `override_frame_indices` não for uma lista de inteiros separados por vírgula ou se o número de índices não coincidir com o número de keyframes. +- O nó levantará um `ValueError` se algum dos índices no parâmetro `override_frame_indices` estiver fora do intervalo de 1 a o número de quadros de pixel no canvas alvo. +- O nó levantará um `ValueError` se o índice máximo no parâmetro `override_frame_indices` for maior que o número de quadros de pixel no canvas alvo. + +> 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/LTXVGeneratedKeyframesToGuides/pt-BR.md) + +--- +**Source fingerprint (SHA-256):** `b5dbf302fad5a7ffd3522d468d1a51b993145d90277592058315499f08e17e7b` diff --git a/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/ru.md b/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/ru.md new file mode 100644 index 000000000..fa07cca17 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/ru.md @@ -0,0 +1,44 @@ +# LTXVGeneratedKeyframesToGuides + +## Обзор + +Нод LTXV Generated Keyframes to Guides привязывает генерируемые кейфреймы с более раннего этапа в виде замороженных изображений-руководств на более позднем канвасе. Он декодирует кейфреймы как отдельные кадры, изменяет их размер по мере необходимости и записывает их с шумовой маской 0, чтобы предотвратить дальнейшее降噪. Записанные индексы масштабируются с канваса, на котором они были созданы, до целевого канваса, и вы можете переопределить индексы кадров, чтобы явно установить позиции. + +## Входы + +| Параметр | Описание | Тип данных | Обязателен | Диапазон | +|---------------------------|-----------------------------------------------------------------------------|-----------|----------|-------| +| `positive` | Положительное условие с привязанными кейфреймами в виде изображений-руководств. | CONDITIONING | Да | | +| `negative` | Отрицательное условие с привязанными кейфреймами в виде изображений-руководств. | CONDITIONING | Да | | +| `vae` | Модель VAE, которую нужно использовать для декодирования кейфреймов. | MODEL | Да | | +| `latent` | Целевое видео latent, к которому добавляются руководства, например, временно увеличенное. | LATENT | Да | | +| `keyframes` | Вывод кейфреймов LTXV Separate Generated Keyframes, который содержит индекс кадра пикселя, в котором был создан каждый кейфрейм. | LATENT | Да | | +| `strength` | Сила руководства. 1.0 создает жесткую привязку; значения ниже ослабляют ее. | FLOAT | Да | 0.0 - 10.0 | +| `override_frame_indices` | Опционально — привязать на эти пиксельные кадры вместо записанных (или масштабированных) позиций. Предоставьте один индекс на каждый кейфрейм. Оставьте пустым, чтобы повторно использовать записанные позиции или масштабировать их, если целевой канвас имеет другое количество кадров (например, после временного увеличения в 2 раза). | STRING | Нет | | + +## Выводы + +| Название вывода | Описание | Тип данных | +|-------------|-----------------------------------------------------------------------------|-----------| +| `positive` | Положительное условие с привязанными кейфреймами в виде изображений-руководств. | CONDITIONING | +| `negative` | Отрицательное условие с привязанными кейфреймами в виде изображений-руководств. | CONDITIONING | +| `latent` | Целевое видео latent с добавленными кейфреймами в виде замороженных руководств. | LATENT | + +## Примечания + +- Параметр `strength` контролирует, насколько сильно кейфреймы привязываются в виде руководств. Значение 1.0 создает жесткую привязку, а значения ниже ослабляют ее. +- Параметр `override_frame_indices` позволяет указать точные пиксельные кадры, на которых должны быть привязаны кейфреймы. Если он оставлен пустым, нод будет использовать записанные позиции или масштабировать их, если необходимо. +- Нод предполагает, что latent `keyframes` содержит индекс кадра пикселя для каждого кейфрейма. Если это не так, нод вызовет ошибку `ValueError`. +- Нод поддерживает только размер пачки 1. Каждое руководство кодируется из одного изображения, поэтому оно не может отличаться между элементами пачки. +- Нод вызовет ошибку `ValueError`, если тензор `samples` в входе `latent` не является 5D-тензором или если размер пачки не равен 1. +- Нод вызовет ошибку `ValueError`, если тензор `samples` в входе `keyframes` не является 5D-тензором или если размер пачки не равен 1. +- Нод вызовет ошибку `ValueError`, если форма тензора `samples` в входе `keyframes` не соответствует форме тензора `samples` в входе `latent` после изменения размера. +- Нод вызовет ошибку `ValueError`, если параметр `strength` выходит за пределы диапазона 0.0 до 10.0. +- Нод вызовет ошибку `ValueError`, если параметр `override_frame_indices` не является списком целых чисел, разделенных запятыми, или если количество индексов не соответствует количеству кейфреймов. +- Нод вызовет ошибку `ValueError`, если какие-либо индексы в параметре `override_frame_indices` выходят за пределы диапазона 1 до количества пиксельных кадров в целевом канвасе. +- Нод вызовет ошибку `ValueError`, если максимальный индекс в параметре `override_frame_indices` превышает количество пиксельных кадров в целевом канвасе. + +> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/ru.md) + +--- +**Source fingerprint (SHA-256):** `b5dbf302fad5a7ffd3522d468d1a51b993145d90277592058315499f08e17e7b` diff --git a/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/tr.md b/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/tr.md new file mode 100644 index 000000000..866a64a29 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/tr.md @@ -0,0 +1,44 @@ +# LTXVGeneratedKeyframesToGuides + +## Genel Bakış + +LTXV Oluşturulan Anahtar Kırmaların Rehberlere Dönüşüm düğümü, daha erken bir aşamadan oluşturulan anahtar kırmaları daha sonraki bir kanvasta dondurulmuş görüntü rehberleri olarak sabitler. Anahtar kırmaları bağımsız kareler olarak çözümler, gerekirse onları yeniden boyutlandırır ve 0 ile yazılan gürültü maskesi ile birlikte yazarlar. Kaydedilen indeksler, oluşturuldukları kanvasta hedef kanvasa ölçeklendirilir ve kare indekslerini açıkça belirlemek için geçersiz kılmak isteyebilirsiniz. + +## Girdiler + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +|---------------------------|-----------------------------------------------------------------------------|-----------|----------|-------| +| `pozitif` | Anahtar kırmaları olarak sabitlenen pozitif koşullandırma. | CONDITIONING | Evet | | +| `negatif` | Anahtar kırmaları olarak sabitlenen negatif koşullandırma. | CONDITIONING | Evet | | +| `vae` | Anahtar kırmaları çözümlemek için kullanılacak VAE modeli. | MODEL | Evet | | +| `latent` | Anahtar kırmaların eklenmesi istenen hedef video latenti, örneğin, zamanla yükseltilen bir tane. | LATENT | Evet | | +| `anahtar kareler` | LTXV Ayrı Oluşturulan Anahtar Kırmaların çıkışında, her anahtar kırmaya hangi pixel kare indeksinde oluşturulduğunu taşıyan anahtar kırmalar. | LATENT | Evet | | +| `güç` | Rehber güçlüğü. 1.0, sert bir sabitleme oluşturur; daha düşük değerler sabitlemeyi gevşetir. | FLOAT | Evet | 0.0 - 10.0 | +| `override_frame_indices` | Seçmeli — bu pixel karelerde sabitlenmek yerine kaydedilen (veya otomatik olarak ölçeklendirilen) konumlar. Her anahtar kırmaya bir indeks sağlayın. Boş bırakarak kaydedilen konumları yeniden kullanmak veya hedef kanvanın farklı uzunluğunda (örneğin, zamanla 2 kat arttırdıktan sonra) ölçeklemek için boş bırakın. | STRING | Hayır | | + +## Çıktılar + +| Çıktı Adı | Açıklama | Veri Türü | +|-------------|-----------------------------------------------------------------------------|-----------| +| `pozitif` | Anahtar kırmaları olarak sabitlenen pozitif koşullandırma. | CONDITIONING | +| `negatif` | Anahtar kırmaları olarak sabitlenen negatif koşullandırma. | CONDITIONING | +| `latent` | Anahtar kırmaların eklendiği ve dondurulmuş rehber olarak kullanılan hedef video latenti. | LATENT | + +## Notlar + +- `strength` parametresi, anahtar kırmaların rehber olarak sabitlenme güçlüğünü kontrol eder. 1.0 değeri sert bir sabitleme oluştururken, daha düşük değerler sabitlemeyi gevşetir. +- `override_frame_indices` parametresi, anahtar kırmaların sabitleneceği tam olarak belirtilen pixel karelerini belirlemenize olanak tanır. Boş bırakılırsa, düğüm kaydedilen konumları kullanır veya gerekirse onları ölçeklendirir. +- Düğüm, `keyframes` latentin her anahtar kırmaya hangi pixel kare indeksinde oluşturulduğunu içerdiğini varsayar. Bu durumda değilse, düğüm bir `ValueError` oluşturur. +- Düğüm, birim boyutlu bir grup destekler. Her rehber bir görüntüden kodlanır, bu yüzden grup elemanları arasında farklılık gösteremez. +- Düğüm, `latent` girdisindeki `samples` tensörünün 5D tensör olmadığı veya birim boyutlu olmadığı durumda bir `ValueError` oluşturur. +- Düğüm, `keyframes` girdisindeki `samples` tensörünün 5D tensör olmadığı veya birim boyutlu olmadığı durumda bir `ValueError` oluşturur. +- Düğüm, `keyframes` girdisindeki `samples` tensörünün `latent` girdisindeki `samples` tensörünün ölçeklendirildikten sonra şeklini tutmadığı durumda bir `ValueError` oluşturur. +- Düğüm, `strength` parametresi 0.0 ile 10.0 aralığında olmadığı durumda bir `ValueError` oluşturur. +- Düğüm, `override_frame_indices` parametresi virgülle ayrılmış bir integer listesi değilse veya indeks sayısı anahtar kırmaların sayısına eşit değilse bir `ValueError` oluşturur. +- Düğüm, `override_frame_indices` parametresindeki herhangi bir indeks hedef kanvanın pixel kare sayısının 1 ile 1 arasında olmadığı durumda bir `ValueError` oluşturur. +- Düğüm, `override_frame_indices` parametresindeki maksimum indeks hedef kanvanın pixel kare sayısından büyük olduğunda bir `ValueError` oluşturur. + +> 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/LTXVGeneratedKeyframesToGuides/tr.md) + +--- +**Source fingerprint (SHA-256):** `b5dbf302fad5a7ffd3522d468d1a51b993145d90277592058315499f08e17e7b` diff --git a/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/zh-TW.md b/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/zh-TW.md new file mode 100644 index 000000000..d6878f682 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/zh-TW.md @@ -0,0 +1,44 @@ +# LTXVGeneratedKeyframesToGuides + +## 概述 + +LTXV 生成關鍵幀至導向節點將早期階段的生成關鍵幀作為凍結圖像導向,固定在後續的畫布上。它將關鍵幀解碼為獨立幀,如果需要則調整大小,並使用 0 的噪聲掩罩寫入,以防止進一步去噪。記錄的索引會從生成它的畫布縮放到目標畫布,並可以覆蓋幀索引以明確設置位置。 + +## 輸入 + +| 參數名 | 描述 | 資料類型 | 必需 | 范圍 | +|---------------------------|-----------------------------------------------------------------------------|-----------|----------|-------| +| `positive` | 將關鍵幀固定為圖像導向的正向條件。 | CONDITIONING | 是 | | +| `negative` | 將關鍵幀固定為圖像導向的負向條件。 | CONDITIONING | 是 | | +| `vae` | 用於解碼關鍵幀的 VAE 模型。 | MODEL | 是 | | +| `latent` | 要添加導向的目標視頻潛在值,例如,時空上掃描的版本。 | LATENT | 是 | | +| `keyframes` | LTXV 分離生成關鍵幀的關鍵幀輸出,其中包含每個關鍵幀生成的像素幀索引。 | LATENT | 是 | | +| `strength` | 導向強度。1.0 是一個硬固定;較低的值會放鬆它。 | FLOAT | 是 | 0.0 - 10.0 | +| `override_frame_indices` | 選擇性 —— 在這些像素幀上固定,而不是使用記錄的(或自動縮放的)位置。每個關鍵幀提供一個索引。留空以重用記錄的位置,或在目標畫布長度不同時(例如,時空 x2 之後)縮放它們。 | STRING | 否 | | + +## 輸出 + +| 輸出名 | 描述 | 資料類型 | +|-------------|-----------------------------------------------------------------------------|-----------| +| `positive` | 將關鍵幀固定為圖像導向的正向條件。 | CONDITIONING | +| `negative` | 將關鍵幀固定為圖像導向的負向條件。 | CONDITIONING | +| `latent` | 添加關鍵幀作為凍結導向的目標視頻潛在值。 | LATENT | + +## 註釋 + +- `strength` 參數控制關鍵幀作為導向的固定程度。1.0 創建一個硬固定,而較低的值會放鬆固定。 +- `override_frame_indices` 參數允許您指定關鍵幀應該固定的確切像素幀。如果留空,節點將使用記錄的位置或根據需要縮放它們。 +- 節點假設 `keyframes` 潛在值包含每個關鍵幀的像素幀索引。如果情況不是這樣,節點將引發 `ValueError`。 +- 節點僅支持 1 個批大小。每個導向都從一個圖像編碼,所以它不能在批處理元素之間有所不同。 +- 如果 `latent` 输入中的 `samples` 矩陣不是 5D 矩陣或批大小不是 1,節點將引發 `ValueError`。 +- 如果 `keyframes` 输入中的 `samples` 矩陣不是 5D 矩陣或批大小不是 1,節點將引發 `ValueError`。 +- 如果 `keyframes` 输入中的 `samples` 矩陣的形状在調整大小後與 `latent` 输入中的 `samples` 矩陣的形状不匹配,節點將引發 `ValueError`。 +- 如果 `strength` 參數超出 0.0 到 10.0 的範圍,節點將引發 `ValueError`。 +- 如果 `override_frame_indices` 參數不是逗號分隔的整數列表或索引數量與關鍵幀數量不匹配,節點將引發 `ValueError`。 +- 如果 `override_frame_indices` 參數中的任何索引超出目標畫布中像素幀的範圍,節點將引發 `ValueError`。 +- 如果 `override_frame_indices` 參數中的最大索引大於目標畫布中像素幀的數量,節點將引發 `ValueError`。 + +> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/zh-TW.md) + +--- +**Source fingerprint (SHA-256):** `b5dbf302fad5a7ffd3522d468d1a51b993145d90277592058315499f08e17e7b` diff --git a/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/zh.md b/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/zh.md new file mode 100644 index 000000000..ac203b1b5 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/zh.md @@ -0,0 +1,44 @@ +# LTXVGeneratedKeyframesToGuides + +## 概述 + +LTXV 生成关键帧到引导节点将早期阶段生成的关键帧作为冻结图像引导固定在后续画布上。它将关键帧解码为独立的帧,如果需要则调整大小,并使用噪声掩码为 0 写入,以防止进一步的降噪。记录的索引从生成它们的画布缩放到目标画布,您可以覆盖帧索引以显式设置位置。 + +## 输入 + +| 参数 | 描述 | 数据类型 | 必需 | 范围 | +|---------------------------|-----------------------------------------------------------------------------|-----------|----------|-------| +| `正面条件` | 将关键帧固定为图像引导的正向条件。 | CONDITIONING | 是 | | +| `负面条件` | 将关键帧固定为图像引导的负向条件。 | CONDITIONING | 是 | | +| `vae` | 用于解码关键帧的 VAE 模型。 | MODEL | 是 | | +| `潜空间` | 要添加引导的目标视频潜在视频,例如,时间上提升的。 | LATENT | 是 | | +| `关键帧` | LTXV 分离生成的关键帧的输出,其中包含每个关键帧生成的像素帧索引。 | LATENT | 是 | | +| `强度` | 引导强度。1.0 是硬固定;较低值会放松它。 | FLOAT | 是 | 0.0 - 10.0 | +| `override_frame_indices` | 可选——在这些像素帧上固定,而不是记录的(或自动缩放的)位置。每个关键帧提供一个索引。留空以重用记录的位置,或在目标画布长度不同时(例如,在时间 x2 之后)缩放它们。 | STRING | 否 | | + +## 输出 + +| 输出名称 | 描述 | 数据类型 | +|-------------|-----------------------------------------------------------------------------|-----------| +| `正面条件` | 将关键帧固定为图像引导的正向条件。 | CONDITIONING | +| `负面条件` | 将关键帧固定为图像引导的负向条件。 | CONDITIONING | +| `潜空间` | 添加了关键帧作为冻结引导的目标视频潜在视频。 | LATENT | + +## 注意事项 + +- `strength` 参数控制关键帧作为引导的固定强度。1.0 创建硬固定,而较低值会放松固定。 +- `override_frame_indices` 参数允许您指定关键帧应固定的确切像素帧。如果留空,节点将使用记录的位置或必要时缩放它们。 +- 节点假定 `keyframes` 潜在包含每个关键帧的像素帧索引。如果不是这种情况,节点将引发 `ValueError`。 +- 节点仅支持批量大小为 1。每个引导从一个图像编码,因此它不能在批量元素之间不同。 +- 如果 `latent` 输入中的 `samples` 张量不是 5D 张量或批量大小不是 1,节点将引发 `ValueError`。 +- 如果 `keyframes` 输入中的 `samples` 张量不是 5D 张量或批量大小不是 1,节点将引发 `ValueError`。 +- 如果 `keyframes` 输入中的 `samples` 张量的形状在调整大小后不匹配 `latent` 输入中的 `samples` 张量的形状,节点将引发 `ValueError`。 +- 如果 `strength` 参数超出 0.0 到 10.0 的范围,节点将引发 `ValueError`。 +- 如果 `override_frame_indices` 参数不是逗号分隔的整数列表或索引数量与关键帧数量不匹配,节点将引发 `ValueError`。 +- 如果 `override_frame_indices` 参数中的任何索引超出目标画布中像素帧的范围,节点将引发 `ValueError`。 +- 如果 `override_frame_indices` 参数中的最大索引大于目标画布中像素帧的数量,节点将引发 `ValueError`。 + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVGeneratedKeyframesToGuides/zh.md) + +--- +**Source fingerprint (SHA-256):** `b5dbf302fad5a7ffd3522d468d1a51b993145d90277592058315499f08e17e7b` diff --git a/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/ar.md b/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/ar.md new file mode 100644 index 000000000..dbf3c0772 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/ar.md @@ -0,0 +1,36 @@ +# LTXVSeparateGeneratedKeyframes + +## المقدمة + +يُستخدم عقدة LTXV Separate Generated Keyframes لإزالة الكائنات المولدة الفاصلة من المتغير المتدرج المُسجل والمبرمج، مما يتيح معالجتها بشكل منفرد قبل تعديل الفيديو المتدرج بزيادة الحجم المكاني. وهي مصممة لتكون مستخدمة قبل زيادة الحجم المكاني، ويجب عدم تشغيلها بعد عقدة LTXV Crop Guides، لأنها تعامل الكائنات المولدة الفاصلة كمرشادات قابلة للتخلص منها وتسقطها. + +## المدخلات + +| المعامل | الوصف | نوع البيانات | إلزامي | نطاق | +|-----------|-------------|-----------|----------|-------| +| `إيجابي` | التبرمج الإيجابي مع إزالة بيانات الكائنات المولدة الفاصلة. | CONDITIONING | نعم | غير محدد | +| `سلبي` | التبرمج السلبي مع إزالة بيانات الكائنات المولدة الفاصلة. | CONDITIONING | نعم | غير محدد | +| `كامن` | المتغير المتدرج للفيديو مع إزالة الكائنات المولدة الفاصلة. | LATENT | نعم | غير محدد | +| `keyframes_to_batch` | العودة إلى الكائنات الفاصلة كجمع من المتغيرات المتدرجة لكل إطار. اتركه خارجًا للحصول على متغير متدرج متعدد الإطارات، وهو ما يتوقعه محول المتغير المتدرج المتدرج وأيضًا إضافة الكائنات المولدة الفاصلة لاحقًا. | BOOLEAN | لا | افتراضي: لا | + +## المخرجات + +| اسم المخرج | الوصف | نوع البيانات | +|-------------|-------------|-----------| +| `إيجابي` | التبرمج الإيجابي مع إزالة بيانات الكائنات المولدة الفاصلة. | CONDITIONING | +| `سلبي` | التبرمج السلبي مع إزالة بيانات الكائنات المولدة الفاصلة. | CONDITIONING | +| `كامن` | المتغير المتدرج للفيديو مع إزالة الكائنات المولدة الفاصلة. | LATENT | +| `الإطارات الرئيسية` | الكائنات الفاصلة المزيل، مع تسميتها بـ generated_keyframe_indices و generated_keyframe_num_frames. يمكن تقديم هذه إلى إضافة الكائنات المولدة الفاصلة لاحقًا لتشغيل الأماكن الجديدة، أو إلى تحويل الكائنات الفاصلة إلى مرشادات صورة ثابتة (تُعيد تسمية الأرقام إذا تغير طول اللوحة). | LATENT | + +## ملاحظات + +- يحدد المعامل `keyframes_to_batch` ما إذا كانت الكائنات الفاصلة تعود كجمع من المتغيرات المتدرجة لكل إطار أو كمتغير متدرج متعدد الإطارات. +- يضمن العقدة إزالة الكائنات المولدة الفاصلة من التبرمج والمتغير المتدرج قبل أي معالجة أخرى. +- يمكن استخدام مخرج `keyframes` لتشغيل الأماكن الجديدة للكائنات المولدة الفاصلة أو لتثبيتها كمرشادات صورة ثابتة. +- يرفع العقدة `ValueError` إذا لم يحتوي المتغير المتدرج على الكائنات المولدة الفاصلة أو إذا لم تتناسب الكائنات الفاصلة مع النمط المتوقع. +- يفترض العقدة أن الكائنات المولدة الفاصلة تم إضافتها باستخدام عقدة LTXV Add Generated Keyframes وأنها متوافقة مع المتغير المتدرج الحالي. + +> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/ar.md) + +--- +**Source fingerprint (SHA-256):** `295e49181e87445a1c47b2e9413d95b20585b12e89f26f13129ac5d97f913007` diff --git a/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/en.md b/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/en.md new file mode 100644 index 000000000..1d85a4e25 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/en.md @@ -0,0 +1,36 @@ +# LTXVSeparateGeneratedKeyframes + +## Overview + +The LTXV Separate Generated Keyframes node removes generated keyframes from a sampled latent and conditioning, allowing for separate handling before spatially upscaling the video latent. It is designed to be used before spatial upscaling and should not be run after LTXV Crop Guides, as it treats generated keyframes as disposable guides and drops them. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `positive` | Positive conditioning with generated-keyframe metadata removed. | CONDITIONING | Yes | N/A | +| `negative` | Negative conditioning with generated-keyframe metadata removed. | CONDITIONING | Yes | N/A | +| `latent` | Video latent with the generated keyframes stripped. | LATENT | Yes | N/A | +| `keyframes_to_batch` | Return the keyframes as a batch of single-frame latents. Leave off to get them as one multi-frame latent, which is what the latent upsampler and a later Add Generated Keyframes expect. | BOOLEAN | No | default: False | + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `positive` | Positive conditioning with generated-keyframe metadata removed. | CONDITIONING | +| `negative` | Negative conditioning with generated-keyframe metadata removed. | CONDITIONING | +| `latent` | Video latent with the generated keyframes stripped. | LATENT | +| `keyframes` | The peeled keyframes, labeled with generated_keyframe_indices and generated_keyframe_num_frames. Feed these to a later Add Generated Keyframes to initialize new slots, or to Generated Keyframes To Guides to pin them as frozen image guides (indices are remapped if the canvas length changed). | LATENT | + +## Notes + +- The `keyframes_to_batch` parameter determines whether the keyframes are returned as a batch of single-frame latents or as one multi-frame latent. +- The node ensures that the generated keyframes are removed from the conditioning and the latent before any further processing. +- The `keyframes` output can be used to initialize new slots for generated keyframes or to pin them as frozen image guides. +- The node raises a `ValueError` if the latent does not contain generated keyframes or if the keyframes do not match the expected format. +- The node assumes that the generated keyframes were added using the LTXV Add Generated Keyframes node and that they are compatible with the current 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/LTXVSeparateGeneratedKeyframes/en.md) + +--- +**Source fingerprint (SHA-256):** `295e49181e87445a1c47b2e9413d95b20585b12e89f26f13129ac5d97f913007` diff --git a/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/es.md b/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/es.md new file mode 100644 index 000000000..2d38ac14e --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/es.md @@ -0,0 +1,36 @@ +# LTXVSeparateGeneratedKeyframes + +## Resumen + +El nodo LTXV Separar Claves Generadas elimina las claves generadas de un latente muestreado y la condición, permitiendo su manejo separado antes de escalar espacialmente el latente del video. Está diseñado para usarse antes de la escalada espacial y no debe ejecutarse después de LTXV Recortar Guías, ya que trata las claves generadas como guías desechables y las elimina. + +## Entradas + +| Parámetro | Descripción | Tipo de Datos | Requerido | Rango | +|-----------|-------------|-----------|----------|-------| +| `positive` | Condición positiva con los metadatos de claves generadas eliminados. | CONDITIONING | Sí | N/A | +| `negative` | Condición negativa con los metadatos de claves generadas eliminados. | CONDITIONING | Sí | N/A | +| `latent` | Latente del video con las claves generadas eliminadas. | LATENT | Sí | N/A | +| `keyframes_to_batch` | Devolver las claves como un lote de latentes de un solo cuadro. Dejarlo sin usar para obtener un latente multiframente, que es lo que esperan el escalador de latentes y el más tarde Agregar Claves Generadas. | BOOLEAN | No | predeterminado: Falso | + +## Salidas + +| Nombre de Salida | Descripción | Tipo de Datos | +|-------------|-------------|-----------| +| `positive` | Condición positiva con los metadatos de claves generadas eliminados. | CONDITIONING | +| `negative` | Condición negativa con los metadatos de claves generadas eliminados. | CONDITIONING | +| `latent` | Latente del video con las claves generadas eliminadas. | LATENT | +| `keyframes` | Las claves despojadas, etiquetadas con generated_keyframe_indices y generated_keyframe_num_frames. Alimentar estas a un más tarde Agregar Claves Generadas para inicializar nuevos espacios, o a Claves Generadas a Guías para fijarlas como guías de imagen congelada (los índices se reasignan si cambia la longitud del lienzo). | LATENT | + +## Notas + +- El parámetro `keyframes_to_batch` determina si las claves se devuelven como un lote de latentes de un solo cuadro o como un latente multiframente. +- El nodo asegura que las claves generadas se eliminen de la condición y el latente antes de cualquier procesamiento adicional. +- La salida `keyframes` se puede usar para inicializar nuevos espacios para las claves generadas o para fijarlas como guías de imagen congelada. +- El nodo lanza un `ValueError` si el latente no contiene claves generadas o si las claves no coinciden con el formato esperado. +- El nodo asume que las claves generadas se agregaron usando el nodo LTXV Agregar Claves Generadas y que son compatibles con el latente actual. + +> 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/LTXVSeparateGeneratedKeyframes/es.md) + +--- +**Source fingerprint (SHA-256):** `295e49181e87445a1c47b2e9413d95b20585b12e89f26f13129ac5d97f913007` diff --git a/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/fa.md b/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/fa.md new file mode 100644 index 000000000..1fbbd6c41 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/fa.md @@ -0,0 +1,36 @@ +# LTXVSeparateGeneratedKeyframes + +## مقدمه + +لایه جداگانه کلیدفریم‌های تولید شده LTXV کلیدفریم‌های تولید شده را از یک نمونه latent و conditioning حذف می‌کند، که به مدیریت جداگانه قبل از بزرگ‌سازی فضایی latent ویدیو منجر می‌شود. این لایه طراحی شده است که قبل از بزرگ‌سازی فضایی استفاده شود و نباید پس از اجرای LTXV Crop Guides اجرا شود، زیرا کلیدفریم‌های تولید شده را به عنوان راهنماهای قابل استفاده مجدد در نظر می‌گیرد و آن‌ها را حذف می‌کند. + +## ورودی‌ها + +| پارامتر | توضیح | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `positive` | conditioning مثبت با حذف داده‌های کلیدفریم تولید شده. | CONDITIONING | بله | N/A | +| `negative` | conditioning منفی با حذف داده‌های کلیدفریم تولید شده. | CONDITIONING | بله | N/A | +| `latent` | latent ویدیو با حذف کلیدفریم‌های تولید شده. | LATENT | بله | N/A | +| `keyframes_to_batch` | کلیدفریم‌ها را به عنوان یک مجموعه از latent‌های تک‌تصویری بازگرداند. برای دریافت یک latent چند‌تصویری، که چیزی است که latent upsampler و Add Generated Keyframes انتظار دارند، این گزینه را غیرفعال کنید. | BOOLEAN | خیر | پیش‌فرض: False | + +## خروجی‌ها + +| نام خروجی | توضیح | نوع داده | +|-------------|-------------|-----------| +| `positive` | conditioning مثبت با حذف داده‌های کلیدفریم تولید شده. | CONDITIONING | +| `negative` | conditioning منفی با حذف داده‌های کلیدفریم تولید شده. | CONDITIONING | +| `latent` | latent ویدیو با حذف کلیدفریم‌های تولید شده. | LATENT | +| `keyframes` | کلیدفریم‌های جدا شده، با برچسب‌های generated_keyframe_indices و generated_keyframe_num_frames. این کلیدفریم‌ها را به یک Add Generated Keyframes بعدی برای شروع جدید‌ترین سلات‌ها یا به Generated Keyframes To Guides برای فیکس کردن آن‌ها به عنوان راهنماهای تصویری فیکس شده (اگر طول کانواس تغییر کرده باشد، شماره‌ها دوباره‌سازی می‌شوند) ارسال کنید. | LATENT | + +## یادداشت‌ها + +- پارامتر `keyframes_to_batch` تعیین می‌کند که آیا کلیدفریم‌ها به عنوان یک مجموعه از latent‌های تک‌تصویری بازگردانده می‌شوند یا خیر. +- این لایه اطمینان حاصل می‌کند که کلیدفریم‌های تولید شده از conditioning و latent حذف می‌شوند قبل از هر پردازش دیگری. +- خروجی `keyframes` می‌تواند برای شروع جدید‌ترین سلات‌ها برای کلیدفریم‌های تولید شده یا برای فیکس کردن آن‌ها به عنوان راهنماهای تصویری فیکس شده استفاده شود. +- این لایه یک `ValueError` برمی‌انگیزد اگر latent شامل کلیدفریم‌های تولید شده نباشد یا اگر کلیدفریم‌ها با فرمت انتظاری مطابقت نداشته باشند. +- این لایه فرض می‌کند که کلیدفریم‌های تولید شده با استفاده از لایه LTXV Add Generated Keyframes اضافه شده‌اند و با latent فعلی سازگار هستند. + +> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/fa.md) + +--- +**Source fingerprint (SHA-256):** `295e49181e87445a1c47b2e9413d95b20585b12e89f26f13129ac5d97f913007` diff --git a/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/fr.md b/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/fr.md new file mode 100644 index 000000000..743e454e9 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/fr.md @@ -0,0 +1,36 @@ +# LTXVSeparateGeneratedKeyframes + +## Aperçu + +Le nœud LTXV Séparer les Keyframes Générés supprime les keyframes générés d'un latent échantillonné et de la condition, permettant un traitement séparé avant l'upscale spatiale du latent vidéo. Il est conçu pour être utilisé avant l'upscale spatiale et ne doit pas être exécuté après LTXV Coupe des Guides, car il traite les keyframes générés comme des guides jetables et les supprime. + +## Entrées + +| Paramètre | Description | Type de données | Obligatoire | Gamme | +|-----------|-------------|-----------|----------|-------| +| `positive` | Condition positive avec les métadonnées des keyframes générés supprimées. | CONDITIONING | Oui | N/A | +| `negative` | Condition négative avec les métadonnées des keyframes générés supprimées. | CONDITIONING | Oui | N/A | +| `latent` | Latent vidéo avec les keyframes générés enlevés. | LATENT | Oui | N/A | +| `keyframes_to_batch` | Retourner les keyframes sous forme de lot de latents d'image unique. Laisser vide pour obtenir un latent multi-image, ce que le latent upsampler et un Add Generated Keyframes ultérieur attendent. | BOOLEAN | Non | par défaut : False | + +## Sorties + +| Nom de sortie | Description | Type de données | +|-------------|-------------|-----------| +| `positive` | Condition positive avec les métadonnées des keyframes générés supprimées. | CONDITIONING | +| `negative` | Condition négative avec les métadonnées des keyframes générés supprimées. | CONDITIONING | +| `latent` | Latent vidéo avec les keyframes générés enlevés. | LATENT | +| `keyframes` | Les keyframes pelés, étiquetés avec generated_keyframe_indices et generated_keyframe_num_frames. Alimentez ces données à un Add Generated Keyframes ultérieur pour initialiser de nouveaux emplacements, ou à Generated Keyframes To Guides pour les fixer comme guides d'image figées (les indices sont remapés si la longueur du canevas a changé). | LATENT | + +## Notes + +- Le paramètre `keyframes_to_batch` détermine si les keyframes sont retournés sous forme de lot de latents d'image unique ou sous forme d'un latent multi-image. +- Le nœud assure que les keyframes générés sont supprimés de la condition et du latent avant tout traitement ultérieur. +- La sortie `keyframes` peut être utilisée pour initialiser de nouveaux emplacements pour les keyframes générés ou pour les fixer comme guides d'image figées. +- Le nœud lève une `ValueError` si le latent ne contient pas de keyframes générés ou si les keyframes ne correspondent pas au format attendu. +- Le nœud suppose que les keyframes générés ont été ajoutés à l'aide du nœud LTXV Add Generated Keyframes et qu'ils sont compatibles avec le latent actuel. + +> 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/LTXVSeparateGeneratedKeyframes/fr.md) + +--- +**Source fingerprint (SHA-256):** `295e49181e87445a1c47b2e9413d95b20585b12e89f26f13129ac5d97f913007` diff --git a/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/ja.md b/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/ja.md new file mode 100644 index 000000000..6f5e6d89e --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/ja.md @@ -0,0 +1,36 @@ +# LTXVSeparateGeneratedKeyframes + +## 概要 + +LTXV 分離生成キーフレームノードは、サンプリングされたラテントと条件付けから生成キーフレームを削除し、空間アップスケーリング前に個別に処理を可能にします。空間アップスケーリングの前に使用されることを設計されており、LTXV Crop Guidesの後に実行すべきではありません。なぜなら、生成キーフレームを一時的なガイドとして扱い、削除するからです。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|------------|------|----------|------|-------| +| `ポジティブ` | 生成キーフレームのメタデータを削除したポジティブな条件付け。 | CONDITIONING | はい | なし | +| `ネガティブ` | 生成キーフレームのメタデータを削除したネガティブな条件付け。 | CONDITIONING | はい | なし | +| `潜在` | 生成キーフレームを削除したビデオラテント。 | LATENT | はい | なし | +| `keyframes_to_batch` | キーフレームを単フレームのラテントのバッチとして返します。これをオフにすると、ラテントアップスケーラーや後の Add Generated Keyframesが期待するように、一つのマルチフレームのラテントとして取得されます。 | BOOLEAN | いいえ | デフォルト: False | + +## 出力 + +| 出力名 | 説明 | データ型 | +|--------|------|----------| +| `ポジティブ` | 生成キーフレームのメタデータを削除したポジティブな条件付け。 | CONDITIONING | +| `ネガティブ` | 生成キーフレームのメタデータを削除したネガティブな条件付け。 | CONDITIONING | +| `潜在` | 生成キーフレームを削除したビデオラテント。 | LATENT | +| `キーフレーム` | 削除されたキーフレーム、生成_keyframe_indicesと生成_keyframe_num_framesでラベル付けされています。これらを後の Add Generated Keyframesにフィードして新しいスロットを初期化するか、Frozen Image Guidesとしてフリーズするために Generated Keyframes To Guidesにフィードします(キャンバスの長さが変更された場合、インデックスがリマップされます)。 | LATENT | + +## 注意事項 + +- `keyframes_to_batch`パラメータは、キーフレームが単フレームのラテントのバッチとして返されるかどうかを決定します。 +- ノードは、生成キーフレームが条件付けやラテントから削除される前に、どの処理の前にもこれを行います。 +- `keyframes`出力は、生成キーフレームの新しいスロットを初期化するか、フリーズした画像ガイドとしてピン留めるために使用できます。 +- ラテントに生成キーフレームが含まれていない場合や、キーフレームが期待される形式に一致しない場合、ノードは`ValueError`を発生させます。 +- ノードは、LTXV Add Generated Keyframesノードを使用して追加された生成キーフレームと、現在のラテントが互換性があると仮定します。 + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/ja.md) + +--- +**Source fingerprint (SHA-256):** `295e49181e87445a1c47b2e9413d95b20585b12e89f26f13129ac5d97f913007` diff --git a/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/ko.md b/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/ko.md new file mode 100644 index 000000000..9e1dfb93e --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/ko.md @@ -0,0 +1,36 @@ +# LTXVSeparateGeneratedKeyframes + +## 개요 + +LTXV Separate Generated Keyframes 노드는 샘플된 latent과 조건부에서 생성된 키프레임을 제거하여, 공간적으로 업스케일링 전에 별도로 처리할 수 있도록 합니다. 공간 업스케일링 전에 사용되어야 하며, LTXV Crop Guides 이후에 실행되지 않도록 해야 합니다. 이 노드는 생성된 키프레임을 버리는 가이드로 처리하여 제거합니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `positive` | 생성된 키프레임 메타데이터가 제거된 긍정적인 조건부. | CONDITIONING | 예 | N/A | +| `negative` | 생성된 키프레임 메타데이터가 제거된 부정적인 조건부. | CONDITIONING | 예 | N/A | +| `latent` | 생성된 키프레임이 제거된 비디오 latent. | LATENT | 예 | N/A | +| `keyframes_to_batch` | 키프레임을 단일 프레임 latent의 배치로 반환합니다. 기본적으로 False로 설정되어 있으며, 여러 프레임의 latent으로 반환됩니다. | BOOLEAN | 아니요 | 기본값: False | + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `positive` | 생성된 키프레임 메타데이터가 제거된 긍정적인 조건부. | CONDITIONING | +| `negative` | 생성된 키프레임 메타데이터가 제거된 부정적인 조건부. | CONDITIONING | +| `latent` | 생성된 키프레임이 제거된 비디오 latent. | LATENT | +| `keyframes` | 제거된 키프레임, `generated_keyframe_indices`와 `generated_keyframe_num_frames`로 레이블링됩니다. 이를 나중에 Add Generated Keyframes에 입력하여 새로운 슬롯을 초기화하거나, Generated Keyframes To Guides에 입력하여 고정된 이미지 가이드로 사용할 수 있습니다 (캔버스 길이가 변경되면 인덱스가 다시 매핑됩니다). | LATENT | + +## 주의사항 + +- `keyframes_to_batch` 매개변수는 키프레임이 단일 프레임 latent의 배치로 반환되는지 여부를 결정합니다. +- 이 노드는 조건부와 latent에서 생성된 키프레임을 제거하기 전에 모든 추가적인 처리를 보장합니다. +- `keyframes` 출력은 생성된 키프레임의 새로운 슬롯을 초기화하거나, 고정된 이미지 가이드로 사용할 수 있습니다. +- latent이 생성된 키프레임을 포함하지 않거나, 키프레임이 예상된 형식과 일치하지 않으면 노드는 `ValueError`를 발생시킵니다. +- 노드는 LTXV Add Generated Keyframes 노드를 사용하여 추가된 생성된 키프레임이며, 현재 latent과 호환되는 것을 가정합니다. + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/ko.md) + +--- +**Source fingerprint (SHA-256):** `295e49181e87445a1c47b2e9413d95b20585b12e89f26f13129ac5d97f913007` diff --git a/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/pt-BR.md b/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/pt-BR.md new file mode 100644 index 000000000..4b049d10e --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/pt-BR.md @@ -0,0 +1,36 @@ +# LTXVSeparateGeneratedKeyframes + +## Visão Geral + +O nó LTXV Separar Geral de Chaves Geradas remove chaves geradas de um latente amostrado e conditioning, permitindo que sejam tratadas separadamente antes de escalonar espacialmente o latente do vídeo. Ele é projetado para ser usado antes da escalonagem espacial e não deve ser executado após LTXV Recortar Guias, pois trata as chaves geradas como guias descartáveis e as descarta. + +## Entradas + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | +|-----------|-------------|-----------|----------|-------| +| `positive` | Conditioning positivo com metadados de chaves geradas removidos. | CONDITIONING | Sim | N/A | +| `negative` | Conditioning negativo com metadados de chaves geradas removidos. | CONDITIONING | Sim | N/A | +| `latent` | Latente do vídeo com as chaves geradas removidas. | LATENT | Sim | N/A | +| `keyframes_to_batch` | Retornar as chaves como um lote de latentes de único quadro. Deixe em branco para obter um único latente de múltiplos quadros, que é o que o escalonador de latente e o Add Geral de Chaves Geradas esperam. | BOOLEAN | Não | padrão: Falso | + +## Saídas + +| Nome da Saída | Descrição | Tipo de Dados | +|-------------|-------------|-----------| +| `positive` | Conditioning positivo com metadados de chaves geradas removidos. | CONDITIONING | +| `negative` | Conditioning negativo com metadados de chaves geradas removidos. | CONDITIONING | +| `latent` | Latente do vídeo com as chaves geradas removidas. | LATENT | +| `keyframes` | As chaves descobertas, rotuladas com generated_keyframe_indices e generated_keyframe_num_frames. Forneça essas chaves a um Add Geral de Chaves Geradas posterior para inicializar novos slots ou para Geral de Chaves Geradas para Guias para fixá-las como guias de imagem congelada (os índices são remapeados se o comprimento da tela mudar). | LATENT | + +## Notas + +- O parâmetro `keyframes_to_batch` determina se as chaves são retornadas como um lote de latentes de único quadro ou como um único latente de múltiplos quadros. +- O nó garante que as chaves geradas sejam removidas do conditioning e do latente antes de qualquer processamento adicional. +- A saída `keyframes` pode ser usada para inicializar novos slots para chaves geradas ou para fixá-las como guias de imagem congelada. +- O nó lança um `ValueError` se o latente não conter chaves geradas ou se as chaves não coincidirem com o formato esperado. +- O nó assume que as chaves geradas foram adicionadas usando o nó LTXV Adicionar Chaves Geradas e que são compatíveis com o latente atual. + +> 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/LTXVSeparateGeneratedKeyframes/pt-BR.md) + +--- +**Source fingerprint (SHA-256):** `295e49181e87445a1c47b2e9413d95b20585b12e89f26f13129ac5d97f913007` diff --git a/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/ru.md b/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/ru.md new file mode 100644 index 000000000..a43dc284e --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/ru.md @@ -0,0 +1,36 @@ +# LTXVSeparateGeneratedKeyframes + +## Обзор + +Нод LTXV Separate Generated Keyframes удаляет сгенерированные ключевые кадры из образца латентного и условий, что позволяет обрабатывать их отдельно перед пространственным масштабированием латентного видео. Этот нод предназначен для использования перед пространственным масштабированием и не должен запускаться после LTXV Crop Guides, так как он рассматривает сгенерированные ключевые кадры как disposable guides и удаляет их. + +## Входы + +| Параметр | Описание | Тип данных | Обязателен | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `positive` | Положительные условия с удаленными метаданными сгенерированных ключевых кадров. | CONDITIONING | Да | N/A | +| `negative` | Отрицательные условия с удаленными метаданными сгенерированных ключевых кадров. | CONDITIONING | Да | N/A | +| `latent` | Видео латент с удаленными сгенерированными ключевыми кадрами. | LATENT | Да | N/A | +| `keyframes_to_batch` | Возвратить ключевые кадры в виде пачки единичных латентных кадров. Оставьте без изменений для получения одного многофреймового латентного, что ожидается латентным масштабировщиком и Add Generated Keyframes. | BOOLEAN | Нет | по умолчанию: False | + +## Выходы + +| Название выхода | Описание | Тип данных | +|-------------|-------------|-----------| +| `positive` | Положительные условия с удаленными метаданными сгенерированных ключевых кадров. | CONDITIONING | +| `negative` | Отрицательные условия с удаленными метаданными сгенерированных ключевых кадров. | CONDITIONING | +| `latent` | Видео латент с удаленными сгенерированными ключевыми кадрами. | LATENT | +| `keyframes` | Удаленные ключевые кадры, помеченные сгенерированными_keyframe_indices и сгенерированными_keyframe_num_frames. Введите эти данные в более поздний Add Generated Keyframes для инициализации новых слотов или для Generated Keyframes To Guides для их привязки в качестве замороженных изображений guides (индексы ремаппингуются, если длина канваса изменилась). | LATENT | + +## Замечания + +- Параметр `keyframes_to_batch` определяет, возвращаются ли ключевые кадры в виде пачки единичных латентных кадров или в виде одного многофреймового латентного. +- Нод обеспечивает удаление сгенерированных ключевых кадров из условий и латентного перед дальнейшей обработкой. +- Выход `keyframes` можно использовать для инициализации новых слотов для сгенерированных ключевых кадров или для их привязки в качестве замороженных изображений guides. +- Нод вызывает `ValueError`, если латент не содержит сгенерированных ключевых кадров или если ключевые кадры не соответствуют ожидаемому формату. +- Нод предполагает, что сгенерированные ключевые кадры были добавлены с помощью нода LTXV Add Generated Keyframes и что они совместимы с текущим латентом. + +> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/ru.md) + +--- +**Source fingerprint (SHA-256):** `295e49181e87445a1c47b2e9413d95b20585b12e89f26f13129ac5d97f913007` diff --git a/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/tr.md b/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/tr.md new file mode 100644 index 000000000..6ade61dab --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/tr.md @@ -0,0 +1,37 @@ +# LTXVSeparateGeneratedKeyframes + +## Genel Bakış + +LTXV Ayrı Oluşturulan Anahtar Kırmızılar düğümü, örneklenen latent ve koşullamadan oluşturulan anahtar kırmızıları çıkararak, video latent'in uzayda yükseltmeden önce ayrı olarak işlemesine olanak tanır. Uzayda yükseltmeden önce kullanılmak üzere tasarlanmıştır ve LTXV Kesim Rehberleri'nden sonra çalıştırılmamalıdır, çünkü oluşturulan anahtar kırmızıları atıl rehberler olarak görür ve onları atar. + +## Girdiler + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +|-----------|-------------|-----------|----------|-------| +| `pozitif` | Oluşturulan-anahtar-kırmızı metadata'sız pozitif koşullama. | CONDITIONING | Evet | N/A | +| `negatif` | Oluşturulan-anahtar-kırmızı metadata'sız negatif koşullama. | CONDITIONING | Evet | N/A | +| `latent` | Oluşturulan anahtar kırmızıları çıkarılmış video latent. | LATENT | Evet | N/A | +| `keyframes_to_batch` | Anahtar kırmızıları tek çerçeve latent'ler olarak bir grup olarak döndür. Grup olarak döndürmek için kaldırın, bu da latent yükseltici ve daha sonra Oluşturulan Anahtar Kırmızıları Ekle düğme tarafından beklenen tek çerçeve latent'tir. | BOOLEAN | Hayır | varsayılan: False | + +## Çıktılar + +| Çıktı Adı | Açıklama | Veri Türü | +|-------------|-------------|-----------| +| `pozitif` | Oluşturulan-anahtar-kırmızı metadata'sız pozitif koşullama. | CONDITIONING | +| `negatif` | Oluşturulan-anahtar-kırmızı metadata'sız negatif koşullama. | CONDITIONING | +| `latent` | Oluşturulan anahtar kırmızıları çıkarılmış video latent. | LATENT | +| `anahtar kareler` | Çıkarılan anahtar kırmızılar, generated_keyframe_indices ve generated_keyframe_num_frames ile etiketlenmiş. Bu anahtar kırmızıları daha sonra Oluşturulan Anahtar Kırmızıları Ekle düğmesine beslemek için yeni slotlar oluşturmak veya dondurulmuş resim rehberleri olarak pinlemek için kullanın (çerçeve uzunluğu değiştiğinde indeksler yeniden haritalandırılır). | LATENT | + +## Notlar + +- `keyframes_to_batch` parametresi, anahtar kırmızılarının tek çerçeve latent'ler olarak bir grup olarak döndürülüp döndürülmediğini belirler. +- Düğüm, oluşturulan anahtar kırmızının koşullamadan ve latent'ten çıkarıldığını sağlar. +- `keyframes` çıktısı, yeni oluşturulan anahtar kırmızıları için yeni slotlar oluşturmak veya dondurulmuş resim rehberleri olarak pinlemek için kullanılabilir. +- Düğüm, latent'te oluşturulan anahtar kırmızının olmadığı veya kırmızının beklenen formatta olmadığı durumda bir `ValueError` yükseltir. +- Düğüm, oluşturulan anahtar kırmızının LTXV Oluşturulan Anahtar Kırmızıları düğmesi kullanılarak eklendiğini ve mevcut latent ile uyumlu olduğunu varsayar. +``` + +> 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/LTXVSeparateGeneratedKeyframes/tr.md) + +--- +**Source fingerprint (SHA-256):** `295e49181e87445a1c47b2e9413d95b20585b12e89f26f13129ac5d97f913007` diff --git a/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/zh-TW.md b/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/zh-TW.md new file mode 100644 index 000000000..e6d9fa529 --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/zh-TW.md @@ -0,0 +1,36 @@ +# LTXVSeparateGeneratedKeyframes + +## 概述 + +LTXV 分離生成的關鍵幀節點從採樣的潛在變數和條件中移除生成的關鍵幀,允許在空間上提升視頻潛在變數之前進行分離處理。它設計用於在空間上提升之前使用,並不應在 LTXV 剪裁導向後運行,因為它將生成的關鍵幀視為可棄導向並丟棄它們。 + +## 輸入 + +| 參數 | 描述 | 資料類型 | 必需 | 范圍 | +|-----------|-------------|-----------|----------|-------| +| `positive` | 移除生成的關鍵幀元數據的正向條件。 | CONDITIONING | 是 | N/A | +| `negative` | 移除生成的關鍵幀元數據的負向條件。 | CONDITIONING | 是 | N/A | +| `latent` | 移除生成的關鍵幀的視頻潛在變數。 | LATENT | 是 | N/A | +| `keyframes_to_batch` | 返回關鍵幀作為單一畫面潛在變數的批次。留空以獲得一個多畫面潛在變數,這是潛在提升器和稍後的添加生成的關鍵幀所期望的。 | BOOLEAN | 否 | 默認: False | + +## 輸出 + +| 輸出名稱 | 描述 | 資料類型 | +|-------------|-------------|-----------| +| `positive` | 移除生成的關鍵幀元數據的正向條件。 | CONDITIONING | +| `negative` | 移除生成的關鍵幀元數據的負向條件。 | CONDITIONING | +| `latent` | 移除生成的關鍵幀的視頻潛在變數。 | LATENT | +| `keyframes` | 被去除的關鍵幀,標籤為 generated_keyframe_indices 和 generated_keyframe_num_frames。將這些輸入到稍後的添加生成的關鍵幀以初始化新插槽,或到生成的關鍵幀到導向以將其固定為凍結圖像導向(如果画布長度改變,索引將重新映射)。 | LATENT | + +## 記錄 + +- `keyframes_to_batch` 參數決定關鍵幀是返回為單一畫面潛在變數的批次還是返回為一個多畫面潛在變數。 +- 節點確保在進行任何進一步處理之前,從條件和潛在變數中移除生成的關鍵幀。 +- `keyframes` 輸出可以用於初始化生成關鍵幀的新插槽或將其固定為凍結圖像導向。 +- 如果潛在變數不包含生成的關鍵幀或如果關鍵幀不匹配預期的格式,節點將引發 `ValueError`。 +- 節點假設生成的關鍵幀是使用 LTXV 添加生成的關鍵幀節點添加的,並且與當前的潛在變數相兼容。 + +> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/zh-TW.md) + +--- +**Source fingerprint (SHA-256):** `295e49181e87445a1c47b2e9413d95b20585b12e89f26f13129ac5d97f913007` diff --git a/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/zh.md b/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/zh.md new file mode 100644 index 000000000..c67be856f --- /dev/null +++ b/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/zh.md @@ -0,0 +1,36 @@ +# LTXVSeparateGeneratedKeyframes + +## 概述 + +LTXV 分离生成的关键帧节点从采样的潜在和条件中移除生成的关键帧,允许在空间上采样视频潜在之前进行单独处理。它设计用于在空间上采样之前使用,不应在 LTXV 裁剪引导之后运行,因为它将生成的关键帧视为可丢弃的引导并丢弃它们。 + +## 输入 + +| 参数 | 描述 | 数据类型 | 必需 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `正面条件` | 移除生成关键帧元数据的正条件。 | CONDITIONING | 是 | N/A | +| `负面条件` | 移除生成关键帧元数据的负条件。 | CONDITIONING | 是 | N/A | +| `潜空间` | 移除生成关键帧的视频潜在。 | LATENT | 是 | N/A | +| `keyframes_to_batch` | 将关键帧作为单帧潜在的一批返回。不使用则获取一个多帧潜在,这是潜在上采样器和稍后添加生成关键帧所期望的。 | BOOLEAN | 否 | 默认:False | + +## 输出 + +| 输出名称 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `正面条件` | 移除生成关键帧元数据的正条件。 | CONDITIONING | +| `负面条件` | 移除生成关键帧元数据的负条件。 | CONDITIONING | +| `潜空间` | 移除生成关键帧的视频潜在。 | LATENT | +| `关键帧` | 被剥离的关键帧,带有 generated_keyframe_indices 和 generated_keyframe_num_frames 标签。将这些输入到稍后的添加生成关键帧以初始化新槽位,或到生成关键帧到引导以将其固定为冻结图像引导(如果画布长度改变,则索引会被重新映射)。 | LATENT | + +## 注意事项 + +- `keyframes_to_batch` 参数确定关键帧是作为单帧潜在的一批返回,还是作为多帧潜在返回。 +- 节点确保在进一步处理之前从条件和潜在中移除生成的关键帧。 +- `keyframes` 输出可用于初始化生成关键帧的新槽位或将它们固定为冻结图像引导。 +- 如果潜在不包含生成关键帧或关键帧不符合预期的格式,节点将引发 `ValueError`。 +- 节点假定生成的关键帧是使用 LTXV 添加生成关键帧节点添加的,并且与当前潜在兼容。 + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVSeparateGeneratedKeyframes/zh.md) + +--- +**Source fingerprint (SHA-256):** `295e49181e87445a1c47b2e9413d95b20585b12e89f26f13129ac5d97f913007` diff --git a/comfyui_embedded_docs/docs/Load3DAdvanced/ar.md b/comfyui_embedded_docs/docs/Load3DAdvanced/ar.md index 2d89954d9..6a8a6c319 100644 --- a/comfyui_embedded_docs/docs/Load3DAdvanced/ar.md +++ b/comfyui_embedded_docs/docs/Load3DAdvanced/ar.md @@ -1,33 +1,33 @@ -# Load3DAdvanced +# تحميل ثلاثي الأبعاد (متقدم) -هذه العقدة تقوم بتحميل ملف نموذج ثلاثي الأبعاد من دليل الإدخال الخاص بـ ComfyUI، وتوفير بيانات النموذج بالإضافة إلى معلومات الكاميرا ومنفذ العرض. وهي تدعم صيغ الملفات ثلاثية الأبعاد الشائعة، وتتيح لك تحديد أبعاد الصورة الناتجة للعرض. +تقوم عقدة **Load 3D (Advanced)** بتحميل ملف نموذج ثلاثي الأبعاد من دليل `input/3d` الخاص بـ ComfyUI، وتوفر بيانات النموذج إلى جانب معلومات وضع النموذج والكاميرا الملتقطة من حالة منفذ العرض في العارض ثلاثي الأبعاد. وهي تدعم صيغ الملفات ثلاثية الأبعاد الشائعة وتتيح لك ضبط عرض وارتفاع العرض بالبكسل. هذه العقدة تجريبية. ## المدخلات -| المعامل | الوصف | نوع البيانات | إلزامي | النطاق | +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | |-----------|-------------|-----------|----------|-------| -| `model_file` | ملف النموذج ثلاثي الأبعاد المراد تحميله. اختر "none" لتخطي تحميل النموذج. | STRING | نعم | `"none"`
قائمة الملفات ثلاثية الأبعاد المتاحة في دليل input/3d | +| `model_file` | ملف النموذج ثلاثي الأبعاد المراد تحميله. اختر `"none"` لتخطي تحميل ملف النموذج. | COMBO | نعم | `"none"`
ملفات النماذج ثلاثية الأبعاد المتاحة في دليل `input/3d` | | `viewport_state` | حالة منفذ العرض الحالية التي تحتوي على معلومات الكاميرا والنموذج من العارض ثلاثي الأبعاد. | LOAD3D | نعم | - | -| `العرض` | عرض الصورة الناتجة بالبكسل (الافتراضي: 1024) | INT | نعم | الحد الأدنى: 1
الحد الأقصى: 4096
الخطوة: 1 | -| `الارتفاع` | ارتفاع الصورة الناتجة بالبكسل (الافتراضي: 1024) | INT | نعم | الحد الأدنى: 1
الحد الأقصى: 4096
الخطوة: 1 | +| `العرض` | عرض العرض لمنفذ العرض بالبكسل (الافتراضي: 1024). | INT | نعم | الحد الأدنى: 1
الحد الأقصى: 4096
الافتراضي: 1024
الخطوة: 1 | +| `الارتفاع` | ارتفاع العرض لمنفذ العرض بالبكسل (الافتراضي: 1024). | INT | نعم | الحد الأدنى: 1
الحد الأقصى: 4096
الافتراضي: 1024
الخطوة: 1 | **ملاحظات حول المعاملات:** -- معامل `model_file` يعرض فقط الملفات ذات الامتدادات التالية: .gltf, .glb, .obj, .fbx, .stl -- يجب وضع الملفات في دليل `input/3d` الخاص بتثبيت ComfyUI لديك -- إذا تم تعيين `model_file` على "none"، فلن يتم تحميل أي بيانات نموذج ثلاثي الأبعاد (سيكون الناتج `model_3d` فارغًا) -- إذا تم تعيين `model_file` على ملف غير موجود، تُرجع العقدة خطأ تحقق: "Invalid 3D model file: {model_file}" +- يقوم معامل `model_file` بسرد الملفات ذات الامتدادات التالية فقط: .gltf, .glb, .obj, .fbx, .stl +- يجب وضع الملفات في دليل `input/3d` داخل تثبيت ComfyUI لديك؛ يتم البحث أيضًا في المجلدات الفرعية، وتُعرض مسارات الملفات بالنسبة إلى دليل الإدخال. +- إذا كان `model_file` هو `"none"`، فلن يتم تحميل أي بيانات نموذج وسيكون ناتج `model_3d` فارغًا. +- إذا تم ضبط `model_file` على ملف غير موجود، تقوم العقدة بإرجاع خطأ تحقق: `"Invalid 3D model file: {model_file}"` ## المخرجات | اسم المخرج | الوصف | نوع البيانات | |-------------|-------------|-----------| -| `نموذج ثلاثي الأبعاد` | بيانات النموذج ثلاثي الأبعاد المحملة، أو فارغة إذا لم يتم تحديد ملف نموذج | FILE3DANY | -| `معلومات النموذج ثلاثي الأبعاد` | معلومات حول النموذج ثلاثي الأبعاد المحمل من حالة منفذ العرض | LOAD3DMODELINFO | -| `معلومات الكاميرا` | معلومات الكاميرا من حالة منفذ العرض | LOAD3DCAMERA | -| `العرض` | عرض الصورة الناتجة المحدد | INT | -| `الارتفاع` | ارتفاع الصورة الناتجة المحدد | INT | +| `نموذج ثلاثي الأبعاد` | ملف النموذج ثلاثي الأبعاد المحمَّل (glb/obj/stl/إلخ). يكون فارغًا إذا لم يتم تحديد أي ملف نموذج. | FILE3DANY | +| `معلومات النموذج ثلاثي الأبعاد` | موضع كل نموذج في المشهد: الموضع (position)، والدوران (rotation)، والقياس (scale) (فضاء عالمي بمحور Y لأعلى). | LOAD3DMODELINFO | +| `معلومات الكاميرا` | معلومات كاميرا منفذ العرض: الموضع، ونقطة الاستهداف (look-at)، ومستوى التكبير/التقريب (zoom)، والنوع. | LOAD3DCAMERA | +| `العرض` | عرض العرض لمنفذ العرض بالبكسل. | INT | +| `الارتفاع` | ارتفاع العرض لمنفذ العرض بالبكسل. | INT | > تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Load3DAdvanced/ar.md) --- -**Source fingerprint (SHA-256):** `fdacea8abf627621150e1196743e36f61534333837c33cc9a7416a6d11700c4d` +**Source fingerprint (SHA-256):** `c79c53dde0c8b3afb7df7b972df749f5040c92d48b47e355c4497d9b0cbf1c22` diff --git a/comfyui_embedded_docs/docs/Load3DAdvanced/en.md b/comfyui_embedded_docs/docs/Load3DAdvanced/en.md index c32cb2f84..c145fafdf 100644 --- a/comfyui_embedded_docs/docs/Load3DAdvanced/en.md +++ b/comfyui_embedded_docs/docs/Load3DAdvanced/en.md @@ -1,33 +1,33 @@ # Load 3D (Advanced) -The Load 3D (Advanced) node loads a 3D model file from your ComfyUI input directory and provides the model data along with camera and viewport information. It supports common 3D file formats and allows you to specify the output image dimensions. +The Load 3D (Advanced) node loads a 3D model file from ComfyUI's `input/3d` directory and provides the model data together with model placement and camera information captured in the 3D viewer's viewport state. It supports common 3D file formats and lets you set the render width and height of the viewport in pixels. This node is experimental. ## Inputs | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `model_file` | The 3D model file to load. Select "none" to skip loading a model. | STRING | Yes | `"none"`
List of available 3D files in the `input/3d` directory | +| `model_file` | The 3D model file to load. Select "none" to skip loading a model file. | COMBO | Yes | `"none"`
Available 3D model files in the `input/3d` directory | | `viewport_state` | The current viewport state containing camera and model information from the 3D viewer. | LOAD3D | Yes | - | -| `width` | The width of the output image in pixels (default: 1024). | INT | Yes | Min: 1
Max: 4096
Step: 1 | -| `height` | The height of the output image in pixels (default: 1024). | INT | Yes | Min: 1
Max: 4096
Step: 1 | +| `width` | Render width of the viewport in pixels (default: 1024). | INT | Yes | Min: 1
Max: 4096
Default: 1024
Step: 1 | +| `height` | Render height of the viewport in pixels (default: 1024). | INT | Yes | Min: 1
Max: 4096
Default: 1024
Step: 1 | **Notes on Parameters:** -- The `model_file` parameter only shows files with the following extensions: .gltf, .glb, .obj, .fbx, .stl -- Files must be placed in the `input/3d` directory of your ComfyUI installation -- If `model_file` is set to "none", no 3D model data will be loaded (the output `model_3d` will be empty) +- The `model_file` parameter only lists files with the following extensions: .gltf, .glb, .obj, .fbx, .stl +- Files must be placed in the `input/3d` directory of your ComfyUI installation; subfolders are searched as well, and file paths are shown relative to the input directory +- If `model_file` is "none", no model data is loaded and the `model_3d` output will be empty - If `model_file` is set to a file that does not exist, the node returns a validation error: "Invalid 3D model file: {model_file}" ## Outputs | Output Name | Description | Data Type | |-------------|-------------|-----------| -| `model_3d` | The loaded 3D model data, or empty if no model file was selected. | FILE3DANY | -| `model_3d_info` | Information about the loaded 3D model from the viewport state. | LOAD3DMODELINFO | -| `camera_info` | Camera information from the viewport state. | LOAD3DCAMERA | -| `width` | The specified output image width. | INT | -| `height` | The specified output image height. | INT | +| `model_3d` | Loaded 3D model file (glb/obj/stl/etc.). Empty if no model file was selected. | FILE3DANY | +| `model_3d_info` | Placement of each model in the scene: position, rotation, and scale (Y-up world space). | LOAD3DMODELINFO | +| `camera_info` | Viewport camera information: position, look-at target, zoom, and type. | LOAD3DCAMERA | +| `width` | Render width of the viewport in pixels. | INT | +| `height` | Render height of the viewport in pixels. | 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/Load3DAdvanced/en.md) --- -**Source fingerprint (SHA-256):** `682edf36af114661e42556b3f461d0e2a4b38db34a2d3cdfd9319b7f10698645` +**Source fingerprint (SHA-256):** `c79c53dde0c8b3afb7df7b972df749f5040c92d48b47e355c4497d9b0cbf1c22` diff --git a/comfyui_embedded_docs/docs/Load3DAdvanced/es.md b/comfyui_embedded_docs/docs/Load3DAdvanced/es.md index 323494894..c8d76df3c 100644 --- a/comfyui_embedded_docs/docs/Load3DAdvanced/es.md +++ b/comfyui_embedded_docs/docs/Load3DAdvanced/es.md @@ -1,33 +1,33 @@ -# Load3DAdvanced +# Cargar 3D (Avanzado) -Este nodo carga un archivo de modelo 3D desde tu directorio de entrada de ComfyUI y proporciona los datos del modelo junto con información de la cámara y la vista. Soporta formatos de archivo 3D comunes y permite especificar las dimensiones de la imagen de salida para el renderizado. +El nodo Load 3D (Advanced) carga un archivo de modelo 3D desde el directorio `input/3d` de ComfyUI y proporciona los datos del modelo junto con la ubicación del modelo y la información de la cámara capturada en el estado del viewport del visor 3D. Es compatible con formatos de archivo 3D comunes y permite establecer el ancho y el alto de renderizado del viewport en píxeles. Este nodo es experimental. ## Entradas -| Parámetro | Descripción | Tipo de Dato | Requerido | Rango | -|-----------|-------------|--------------|-----------|-------| -| `model_file` | El archivo de modelo 3D a cargar. Selecciona "none" para omitir la carga de un modelo. | STRING | Sí | `"none"`
Lista de archivos 3D disponibles en el directorio input/3d | -| `viewport_state` | El estado actual de la vista que contiene información de la cámara y el modelo desde el visor 3D. | LOAD3D | Sí | - | -| `width` | El ancho de la imagen de salida en píxeles (predeterminado: 1024) | INT | Sí | Mín: 1
Máx: 4096
Paso: 1 | -| `height` | La altura de la imagen de salida en píxeles (predeterminado: 1024) | INT | Sí | Mín: 1
Máx: 4096
Paso: 1 | - -**Notas sobre los Parámetros:** -- El parámetro `model_file` solo muestra archivos con las siguientes extensiones: .gltf, .glb, .obj, .fbx, .stl -- Los archivos deben colocarse en el directorio `input/3d` de tu instalación de ComfyUI -- Si `model_file` está configurado como "none", no se cargarán datos del modelo 3D (la salida `model_3d` estará vacía) +| Parámetro | Descripción | Tipo de datos | Requerido | Rango | +|-----------|-------------|---------------|-----------|-------| +| `model_file` | El archivo de modelo 3D a cargar. Seleccione "none" para omitir la carga de un archivo de modelo. | COMBO | Sí | `"none"`
Archivos de modelos 3D disponibles en el directorio `input/3d` | +| `viewport_state` | El estado actual del viewport que contiene información de cámara y modelo del visor 3D. | LOAD3D | Sí | - | +| `width` | Ancho de renderizado del viewport en píxeles (por defecto: 1024). | INT | Sí | Mínimo: 1
Máximo: 4096
Por defecto: 1024
Incremento: 1 | +| `height` | Alto de renderizado del viewport en píxeles (por defecto: 1024). | INT | Sí | Mínimo: 1
Máximo: 4096
Por defecto: 1024
Incremento: 1 | + +**Notas sobre los parámetros:** +- El parámetro `model_file` solo lista archivos con las siguientes extensiones: .gltf, .glb, .obj, .fbx, .stl +- Los archivos deben colocarse en el directorio `input/3d` de su instalación de ComfyUI; también se buscan en subcarpetas, y las rutas de archivo se muestran relativas al directorio `input`. +- Si `model_file` es "none", no se carga ningún dato de modelo y la salida `model_3d` estará vacía. - Si `model_file` se establece en un archivo que no existe, el nodo devuelve un error de validación: "Invalid 3D model file: {model_file}" ## Salidas -| Nombre de Salida | Descripción | Tipo de Dato | -|------------------|-------------|--------------| -| `model_3d` | Los datos del modelo 3D cargado, o vacío si no se seleccionó ningún archivo de modelo | FILE3DANY | -| `model_3d_info` | Información sobre el modelo 3D cargado desde el estado de la vista | LOAD3DMODELINFO | -| `camera_info` | Información de la cámara desde el estado de la vista | LOAD3DCAMERA | -| `width` | El ancho de imagen de salida especificado | INT | -| `height` | La altura de imagen de salida especificada | INT | +| Nombre de salida | Descripción | Tipo de datos | +|------------------|-------------|---------------| +| `model_3d` | Archivo de modelo 3D cargado (glb/obj/stl/etc.). Vacío si no se seleccionó ningún archivo de modelo. | FILE3DANY | +| `model_3d_info` | Ubicación de cada modelo en la escena: posición, rotación y escala (espacio mundial con eje Y hacia arriba). | LOAD3DMODELINFO | +| `camera_info` | Información de la cámara del viewport: posición, punto de mira, zoom y tipo. | LOAD3DCAMERA | +| `width` | Ancho de renderizado del viewport en píxeles. | INT | +| `height` | Alto de renderizado del viewport en píxeles. | INT | > 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/Load3DAdvanced/es.md) --- -**Source fingerprint (SHA-256):** `fdacea8abf627621150e1196743e36f61534333837c33cc9a7416a6d11700c4d` +**Source fingerprint (SHA-256):** `c79c53dde0c8b3afb7df7b972df749f5040c92d48b47e355c4497d9b0cbf1c22` diff --git a/comfyui_embedded_docs/docs/Load3DAdvanced/fa.md b/comfyui_embedded_docs/docs/Load3DAdvanced/fa.md index ee364053a..6b2c6a1d8 100644 --- a/comfyui_embedded_docs/docs/Load3DAdvanced/fa.md +++ b/comfyui_embedded_docs/docs/Load3DAdvanced/fa.md @@ -1,33 +1,33 @@ -# Load3DAdvanced +# بارگذاری ۳بعدی (پیشرفته) -این گره یک فایل مدل سه‌بعدی را از دایرکتوری ورودی ComfyUI شما بارگذاری می‌کند و داده‌های مدل را به همراه اطلاعات دوربین و نمای دید در اختیار شما قرار می‌دهد. از فرمت‌های رایج فایل‌های سه‌بعدی پشتیبانی می‌کند و به شما امکان می‌دهد ابعاد تصویر خروجی را برای رندرینگ مشخص کنید. +گره Load 3D (Advanced) یک فایل مدل سه‌بعدی را از پوشه `input/3d` در ComfyUI بارگذاری می‌کند و داده‌های مدل را همراه با اطلاعات قرارگیری مدل و دوربین که در وضعیت ویوپورت نمایشگر سه‌بعدی ثبت شده‌اند، ارائه می‌دهد. این گره از قالب‌های رایج فایل سه‌بعدی پشتیبانی می‌کند و به شما امکان می‌دهد عرض و ارتفاع رندر ویوپورت را برحسب پیکسل تنظیم کنید. این گره آزمایشی است. ## ورودی‌ها -| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +| پارامتر | توضیح | نوع داده | الزامی | بازه | |-----------|-------------|-----------|----------|-------| -| `model_file` | فایل مدل سه‌بعدی که باید بارگذاری شود. برای رد کردن بارگذاری مدل، گزینه "none" را انتخاب کنید. | STRING | بله | `"none"`
فهرست فایل‌های سه‌بعدی موجود در دایرکتوری input/3d | -| `viewport_state` | وضعیت فعلی نمای دید شامل اطلاعات دوربین و مدل از نمایشگر سه‌بعدی. | LOAD3D | بله | - | -| `عرض` | عرض تصویر خروجی بر حسب پیکسل (پیش‌فرض: 1024) | INT | بله | حداقل: 1
حداکثر: 4096
گام: 1 | -| `ارتفاع` | ارتفاع تصویر خروجی بر حسب پیکسل (پیش‌فرض: 1024) | INT | بله | حداقل: 1
حداکثر: 4096
گام: 1 | +| `model_file` | فایل مدل سه‌بعدی برای بارگذاری. برای صرف‌نظر کردن از بارگذاری فایل مدل، "none" را انتخاب کنید. | COMBO | بله | `"none"`
فایل‌های مدل سه‌بعدی موجود در پوشه `input/3d` | +| `viewport_state` | وضعیت کنونی ویوپورت که شامل اطلاعات دوربین و مدل از نمایشگر سه‌بعدی است. | LOAD3D | بله | - | +| `عرض` | عرض رندر ویوپورت برحسب پیکسل (پیش‌فرض: 1024). | INT | بله | حداقل: 1
حداکثر: 4096
پیش‌فرض: 1024
گام: 1 | +| `ارتفاع` | ارتفاع رندر ویوپورت برحسب پیکسل (پیش‌فرض: 1024). | INT | بله | حداقل: 1
حداکثر: 4096
پیش‌فرض: 1024
گام: 1 | **نکاتی درباره پارامترها:** -- پارامتر `model_file` فقط فایل‌هایی با پسوندهای زیر را نمایش می‌دهد: .gltf, .glb, .obj, .fbx, .stl -- فایل‌ها باید در دایرکتوری `input/3d` نصب ComfyUI شما قرار داده شوند -- اگر `model_file` روی "none" تنظیم شود، هیچ داده مدل سه‌بعدی بارگذاری نخواهد شد (خروجی `model_3d` خالی خواهد بود) +- پارامتر `model_file` فقط فایل‌هایی با پسوندهای زیر را فهرست می‌کند: .gltf, .glb, .obj, .fbx, .stl +- فایل‌ها باید در پوشه `input/3d` در نصب ComfyUI شما قرار گیرند؛ زیرپوشه‌ها نیز جست‌وجو می‌شوند و مسیر فایل‌ها نسبت به پوشه input نمایش داده می‌شود +- اگر `model_file` برابر "none" باشد، هیچ داده مدلی بارگذاری نمی‌شود و خروجی `model_3d` خالی خواهد بود - اگر `model_file` روی فایلی تنظیم شود که وجود ندارد، گره یک خطای اعتبارسنجی برمی‌گرداند: "Invalid 3D model file: {model_file}" ## خروجی‌ها -| نام خروجی | توضیحات | نوع داده | +| نام خروجی | توضیح | نوع داده | |-------------|-------------|-----------| -| `مدل ۳بعدی` | داده‌های مدل سه‌بعدی بارگذاری شده، یا در صورت عدم انتخاب فایل مدل، خالی است | FILE3DANY | -| `اطلاعات مدل ۳بعدی` | اطلاعات مربوط به مدل سه‌بعدی بارگذاری شده از وضعیت نمای دید | LOAD3DMODELINFO | -| `اطلاعات دوربین` | اطلاعات دوربین از وضعیت نمای دید | LOAD3DCAMERA | -| `عرض` | عرض تصویر خروجی مشخص شده | INT | -| `ارتفاع` | ارتفاع تصویر خروجی مشخص شده | INT | +| `مدل ۳بعدی` | فایل مدل سه‌بعدی بارگذاری‌شده (glb/obj/stl/etc.). اگر هیچ فایل مدلی انتخاب نشده باشد، خالی است. | FILE3DANY | +| `اطلاعات مدل ۳بعدی` | قرارگیری هر مدل در صحنه: موقعیت، چرخش و مقیاس (فضای جهانی با محور Y رو به بالا). | LOAD3DMODELINFO | +| `اطلاعات دوربین` | اطلاعات دوربین ویوپورت: موقعیت، هدف نگاه، بزرگ‌نمایی و نوع. | LOAD3DCAMERA | +| `عرض` | عرض رندر ویوپورت برحسب پیکسل. | INT | +| `ارتفاع` | ارتفاع رندر ویوپورت برحسب پیکسل. | INT | > این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Load3DAdvanced/fa.md) --- -**Source fingerprint (SHA-256):** `fdacea8abf627621150e1196743e36f61534333837c33cc9a7416a6d11700c4d` +**Source fingerprint (SHA-256):** `c79c53dde0c8b3afb7df7b972df749f5040c92d48b47e355c4497d9b0cbf1c22` diff --git a/comfyui_embedded_docs/docs/Load3DAdvanced/fr.md b/comfyui_embedded_docs/docs/Load3DAdvanced/fr.md index 54d2e0be8..b00449572 100644 --- a/comfyui_embedded_docs/docs/Load3DAdvanced/fr.md +++ b/comfyui_embedded_docs/docs/Load3DAdvanced/fr.md @@ -1,33 +1,33 @@ -# Load3DAdvanced +# Charger 3D (Avancé) -Ce nœud charge un fichier de modèle 3D depuis votre répertoire d'entrée ComfyUI et fournit les données du modèle ainsi que les informations de la caméra et de la fenêtre d'affichage. Il prend en charge les formats de fichiers 3D courants et vous permet de spécifier les dimensions de l'image de sortie pour le rendu. +Le nœud « Load 3D (Advanced) » charge un fichier de modèle 3D depuis le répertoire `input/3d` de ComfyUI et fournit les données du modèle ainsi que les informations de placement du modèle et de caméra capturées dans l’état de la fenêtre d’affichage du visualiseur 3D. Il prend en charge les formats de fichiers 3D courants et vous permet de définir la largeur et la hauteur de rendu de la fenêtre en pixels. Ce nœud est expérimental. ## Entrées | Paramètre | Description | Type de données | Requis | Plage | |-----------|-------------|-----------------|--------|-------| -| `model_file` | Le fichier de modèle 3D à charger. Sélectionnez "none" pour ignorer le chargement d'un modèle. | STRING | Oui | `"none"`
Liste des fichiers 3D disponibles dans le répertoire input/3d | -| `viewport_state` | L'état actuel de la fenêtre d'affichage contenant les informations de la caméra et du modèle provenant du visualiseur 3D. | LOAD3D | Oui | - | -| `width` | La largeur de l'image de sortie en pixels (par défaut : 1024) | INT | Oui | Min : 1
Max : 4096
Pas : 1 | -| `height` | La hauteur de l'image de sortie en pixels (par défaut : 1024) | INT | Oui | Min : 1
Max : 4096
Pas : 1 | +| `model_file` | Le fichier de modèle 3D à charger. Sélectionnez « none » pour ignorer le chargement d’un fichier de modèle. | COMBO | Oui | `"none"`
Fichiers de modèles 3D disponibles dans le répertoire `input/3d` | +| `viewport_state` | L’état actuel de la fenêtre d’affichage contenant les informations de caméra et de modèle du visualiseur 3D. | LOAD3D | Oui | - | +| `width` | Largeur de rendu de la fenêtre en pixels (défaut : 1024). | INT | Oui | Min : 1
Max : 4096
Défaut : 1024
Pas : 1 | +| `height` | Hauteur de rendu de la fenêtre en pixels (défaut : 1024). | INT | Oui | Min : 1
Max : 4096
Défaut : 1024
Pas : 1 | **Remarques sur les paramètres :** -- Le paramètre `model_file` n'affiche que les fichiers avec les extensions suivantes : .gltf, .glb, .obj, .fbx, .stl -- Les fichiers doivent être placés dans le répertoire `input/3d` de votre installation ComfyUI -- Si `model_file` est défini sur "none", aucune donnée de modèle 3D ne sera chargée (la sortie `model_3d` sera vide) -- Si `model_file` est défini sur un fichier inexistant, le nœud renvoie une erreur de validation : « Invalid 3D model file: {model_file} » +- Le paramètre `model_file` ne répertorie que les fichiers portant les extensions suivantes : .gltf, .glb, .obj, .fbx, .stl +- Les fichiers doivent être placés dans le répertoire `input/3d` de votre installation ComfyUI ; les sous-dossiers sont également recherchés et les chemins de fichiers sont affichés de manière relative au répertoire d’entrée. +- Si `model_file` est défini sur « none », aucune donnée de modèle n’est chargée et la sortie `model_3d` sera vide. +- Si `model_file` est défini sur un fichier qui n’existe pas, le nœud renvoie une erreur de validation : « Invalid 3D model file: {model_file} » ## Sorties -| Nom de la sortie | Description | Type de données | -|------------------|-------------|-----------------| -| `model_3d` | Les données du modèle 3D chargé, ou vides si aucun fichier de modèle n'a été sélectionné | FILE3DANY | -| `model_3d_info` | Informations sur le modèle 3D chargé provenant de l'état de la fenêtre d'affichage | LOAD3DMODELINFO | -| `camera_info` | Informations de la caméra provenant de l'état de la fenêtre d'affichage | LOAD3DCAMERA | -| `width` | La largeur spécifiée de l'image de sortie | INT | -| `height` | La hauteur spécifiée de l'image de sortie | INT | +| Nom de sortie | Description | Type de données | +|---------------|-------------|-----------------| +| `model_3d` | Fichier de modèle 3D chargé (glb/obj/stl/etc.). Vide si aucun fichier de modèle n’a été sélectionné. | FILE3DANY | +| `model_3d_info` | Placement de chaque modèle dans la scène : position, rotation et échelle (espace monde Y vers le haut). | LOAD3DMODELINFO | +| `camera_info` | Informations de la caméra de la fenêtre d’affichage : position, point cible (look-at), zoom et type. | LOAD3DCAMERA | +| `width` | Largeur de rendu de la fenêtre en pixels. | INT | +| `height` | Hauteur de rendu de la fenêtre en pixels. | INT | > 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/Load3DAdvanced/fr.md) --- -**Source fingerprint (SHA-256):** `fdacea8abf627621150e1196743e36f61534333837c33cc9a7416a6d11700c4d` +**Source fingerprint (SHA-256):** `c79c53dde0c8b3afb7df7b972df749f5040c92d48b47e355c4497d9b0cbf1c22` diff --git a/comfyui_embedded_docs/docs/Load3DAdvanced/ja.md b/comfyui_embedded_docs/docs/Load3DAdvanced/ja.md index ded039a9d..7bbf18f02 100644 --- a/comfyui_embedded_docs/docs/Load3DAdvanced/ja.md +++ b/comfyui_embedded_docs/docs/Load3DAdvanced/ja.md @@ -1,33 +1,33 @@ -# Load3DAdvanced +# 3D読み込み(詳細) -このノードは、ComfyUIの入力ディレクトリから3Dモデルファイルを読み込み、カメラおよびビューポート情報とともにモデルデータを提供します。一般的な3Dファイル形式をサポートしており、レンダリング用の出力画像サイズを指定できます。 +Load 3D (Advanced) ノードは、ComfyUI の `input/3d` ディレクトリから 3D モデルファイルを読み込み、3D ビューアのビューポート状態で取得されたモデル配置とカメラ情報とともにモデルデータを提供します。一般的な 3D ファイル形式に対応しており、ビューポートのレンダリング幅と高さをピクセル単位で設定できます。このノードは実験的です。 ## 入力 | パラメータ | 説明 | データ型 | 必須 | 範囲 | |-----------|-------------|-----------|----------|-------| -| `model_file` | 読み込む3Dモデルファイル。モデルの読み込みをスキップするには"none"を選択します。 | STRING | はい | `"none"`
input/3dディレクトリ内の利用可能な3Dファイルのリスト | -| `viewport_state` | 3Dビューアからのカメラとモデル情報を含む現在のビューポート状態。 | LOAD3D | はい | - | -| `width` | 出力画像の幅(ピクセル単位、デフォルト:1024) | INT | はい | 最小:1
最大:4096
ステップ:1 | -| `height` | 出力画像の高さ(ピクセル単位、デフォルト:1024) | INT | はい | 最小:1
最大:4096
ステップ:1 | +| `model_file` | 読み込む 3D モデルファイル。モデルファイルの読み込みをスキップするには "none" を選択します。 | COMBO | はい | `"none"`
`input/3d` ディレクトリ内の利用可能な 3D モデルファイル | +| `viewport_state` | 3D ビューアからのカメラ情報とモデル情報を含む現在のビューポート状態。 | LOAD3D | はい | - | +| `width` | ビューポートのレンダリング幅(ピクセル単位、デフォルト: 1024)。 | INT | はい | Min: 1
Max: 4096
Default: 1024
Step: 1 | +| `height` | ビューポートのレンダリング高さ(ピクセル単位、デフォルト: 1024)。 | INT | はい | Min: 1
Max: 4096
Default: 1024
Step: 1 | -**パラメータに関する注意事項:** -- `model_file`パラメータは、次の拡張子を持つファイルのみを表示します:.gltf、.glb、.obj、.fbx、.stl -- ファイルはComfyUIインストール先の`input/3d`ディレクトリに配置する必要があります -- `model_file`が"none"に設定されている場合、3Dモデルデータは読み込まれません(出力`model_3d`は空になります) -- `model_file` が存在しないファイルに設定されている場合、ノードは検証エラーを返します:"Invalid 3D model file: {model_file}" +**パラメータに関する注記:** +- `model_file` パラメータには、次の拡張子を持つファイルのみが一覧表示されます:.gltf、.glb、.obj、.fbx、.stl +- ファイルは ComfyUI インストール先の `input/3d` ディレクトリに配置する必要があります。サブフォルダも検索され、ファイルパスは入力ディレクトリからの相対パスで表示されます。 +- `model_file` が "none" の場合、モデルデータは読み込まれず、`model_3d` 出力は空になります。 +- `model_file` が存在しないファイルに設定されている場合、ノードは検証エラー「Invalid 3D model file: {model_file}」を返します。 ## 出力 | 出力名 | 説明 | データ型 | |-------------|-------------|-----------| -| `model_3d` | 読み込まれた3Dモデルデータ。モデルファイルが選択されていない場合は空。 | FILE3DANY | -| `model_3d_info` | ビューポート状態から取得した、読み込まれた3Dモデルに関する情報。 | LOAD3DMODELINFO | -| `camera_info` | ビューポート状態から取得したカメラ情報。 | LOAD3DCAMERA | -| `width` | 指定された出力画像の幅。 | INT | -| `height` | 指定された出力画像の高さ。 | INT | +| `model_3d` | 読み込まれた 3D モデルファイル(glb/obj/stl など)。モデルファイルが選択されていない場合は空です。 | FILE3DANY | +| `model_3d_info` | シーン内の各モデルの配置:位置、回転、スケール(Y アップのワールド空間)。 | LOAD3DMODELINFO | +| `camera_info` | ビューポートのカメラ情報:位置、注視ターゲット、ズーム、タイプ。 | LOAD3DCAMERA | +| `width` | ビューポートのレンダリング幅(ピクセル単位)。 | INT | +| `height` | ビューポートのレンダリング高さ(ピクセル単位)。 | INT | > このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Load3DAdvanced/ja.md) --- -**Source fingerprint (SHA-256):** `fdacea8abf627621150e1196743e36f61534333837c33cc9a7416a6d11700c4d` +**Source fingerprint (SHA-256):** `c79c53dde0c8b3afb7df7b972df749f5040c92d48b47e355c4497d9b0cbf1c22` diff --git a/comfyui_embedded_docs/docs/Load3DAdvanced/ko.md b/comfyui_embedded_docs/docs/Load3DAdvanced/ko.md index e790be2c2..643a85ecf 100644 --- a/comfyui_embedded_docs/docs/Load3DAdvanced/ko.md +++ b/comfyui_embedded_docs/docs/Load3DAdvanced/ko.md @@ -1,33 +1,33 @@ -# Load3DAdvanced +# 3D 불러오기 (고급) -이 노드는 ComfyUI 입력 디렉토리에서 3D 모델 파일을 불러와 모델 데이터와 함께 카메라 및 뷰포트 정보를 제공합니다. 일반적인 3D 파일 형식을 지원하며, 렌더링을 위한 출력 이미지 크기를 지정할 수 있습니다. +Load 3D (Advanced) 노드는 ComfyUI의 `input/3d` 디렉터리에서 3D 모델 파일을 로드하고, 3D 뷰어의 뷰포트 상태에 포함된 모델 배치 및 카메라 정보와 함께 모델 데이터를 제공합니다. 일반적인 3D 파일 형식을 지원하며 뷰포트의 렌더링 너비와 높이를 픽셀 단위로 설정할 수 있습니다. 이 노드는 실험적입니다. ## 입력 -| 매개변수 | 설명 | 데이터 타입 | 필수 여부 | 범위 | +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | |-----------|-------------|-----------|----------|-------| -| `model_file` | 불러올 3D 모델 파일입니다. 모델을 불러오지 않으려면 "none"을 선택하십시오. | STRING | 예 | `"none"`
input/3d 디렉토리 내 사용 가능한 3D 파일 목록 | -| `viewport_state` | 3D 뷰어에서 가져온 카메라 및 모델 정보가 포함된 현재 뷰포트 상태입니다. | LOAD3D | 예 | - | -| `width` | 출력 이미지의 가로 크기(픽셀 단위, 기본값: 1024) | INT | 예 | 최소: 1
최대: 4096
단계: 1 | -| `height` | 출력 이미지의 세로 크기(픽셀 단위, 기본값: 1024) | INT | 예 | 최소: 1
최대: 4096
단계: 1 | +| `model_file` | 로드할 3D 모델 파일입니다. 모델 파일 로드를 건너뛰려면 "none"을 선택하십시오. | COMBO | 예 | `"none"`
`input/3d` 디렉터리에서 사용 가능한 3D 모델 파일 | +| `viewport_state` | 3D 뷰어의 카메라 및 모델 정보를 포함하는 현재 뷰포트 상태입니다. | LOAD3D | 예 | - | +| `width` | 뷰포트의 렌더링 너비(픽셀)입니다(기본값: 1024). | INT | 예 | 최소: 1
최대: 4096
기본값: 1024
단계: 1 | +| `height` | 뷰포트의 렌더링 높이(픽셀)입니다(기본값: 1024). | INT | 예 | 최소: 1
최대: 4096
기본값: 1024
단계: 1 | **매개변수 참고 사항:** -- `model_file` 매개변수는 다음 확장자를 가진 파일만 표시합니다: .gltf, .glb, .obj, .fbx, .stl -- 파일은 ComfyUI 설치 디렉토리의 `input/3d` 폴더에 위치해야 합니다. -- `model_file`을 "none"으로 설정하면 3D 모델 데이터가 불러와지지 않습니다(출력 `model_3d`는 비어 있게 됩니다). -- `model_file`이 존재하지 않는 파일로 설정된 경우 노드는 검증 오류를 반환합니다: "Invalid 3D model file: {model_file}" +- `model_file` 매개변수는 다음 확장자를 가진 파일만 나열합니다: .gltf, .glb, .obj, .fbx, .stl +- 파일은 ComfyUI 설치의 `input/3d` 디렉터리에 배치해야 합니다. 하위 폴더도 검색되며, 파일 경로는 입력 디렉터리를 기준으로 표시됩니다. +- `model_file`이 "none"이면 모델 데이터가 로드되지 않으며 `model_3d` 출력은 비어 있게 됩니다. +- `model_file`이 존재하지 않는 파일로 설정되면 노드는 "Invalid 3D model file: {model_file}" 검증 오류를 반환합니다. ## 출력 | 출력 이름 | 설명 | 데이터 타입 | |-------------|-------------|-----------| -| `model_3d` | 불러온 3D 모델 데이터입니다. 모델 파일을 선택하지 않으면 비어 있습니다. | FILE3DANY | -| `model_3d_info` | 뷰포트 상태에서 가져온 불러온 3D 모델에 대한 정보입니다. | LOAD3DMODELINFO | -| `camera_info` | 뷰포트 상태에서 가져온 카메라 정보입니다. | LOAD3DCAMERA | -| `width` | 지정된 출력 이미지 가로 크기입니다. | INT | -| `height` | 지정된 출력 이미지 세로 크기입니다. | INT | +| `model_3d` | 로드된 3D 모델 파일(glb/obj/stl 등)입니다. 선택된 모델 파일이 없으면 비어 있습니다. | FILE3DANY | +| `model_3d_info` | 씬에 있는 각 모델의 배치(위치, 회전, 배율)입니다(Y-up 월드 공간). | LOAD3DMODELINFO | +| `camera_info` | 뷰포트 카메라 정보: 위치, 바라보는 대상, 줌 및 유형입니다. | LOAD3DCAMERA | +| `width` | 뷰포트의 렌더링 너비(픽셀)입니다. | INT | +| `height` | 뷰포트의 렌더링 높이(픽셀)입니다. | INT | > 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Load3DAdvanced/ko.md) --- -**Source fingerprint (SHA-256):** `fdacea8abf627621150e1196743e36f61534333837c33cc9a7416a6d11700c4d` +**Source fingerprint (SHA-256):** `c79c53dde0c8b3afb7df7b972df749f5040c92d48b47e355c4497d9b0cbf1c22` diff --git a/comfyui_embedded_docs/docs/Load3DAdvanced/pt-BR.md b/comfyui_embedded_docs/docs/Load3DAdvanced/pt-BR.md index 4bb6c8432..dc8081d2e 100644 --- a/comfyui_embedded_docs/docs/Load3DAdvanced/pt-BR.md +++ b/comfyui_embedded_docs/docs/Load3DAdvanced/pt-BR.md @@ -1,33 +1,33 @@ -# Load3DAdvanced +# Carregar 3D (Avançado) -Este nó carrega um arquivo de modelo 3D do diretório de entrada do seu ComfyUI e fornece os dados do modelo, juntamente com informações de câmera e viewport. Ele suporta formatos de arquivo 3D comuns e permite que você especifique as dimensões da imagem de saída para renderização. +O nó Load 3D (Advanced) carrega um arquivo de modelo 3D do diretório `input/3d` do ComfyUI e fornece os dados do modelo juntamente com o posicionamento do modelo e as informações da câmera capturadas no estado da viewport do visualizador 3D. Ele suporta formatos de arquivo 3D comuns e permite definir a largura e a altura de renderização do viewport em pixels. Este nó é experimental. ## Entradas -| Parâmetro | Descrição | Tipo de Dado | Obrigatório | Faixa | -|-----------|-------------|-----------|----------|-------| -| `model_file` | O arquivo de modelo 3D a ser carregado. Selecione "none" para pular o carregamento de um modelo. | STRING | Sim | `"none"`
Lista de arquivos 3D disponíveis no diretório input/3d | -| `viewport_state` | O estado atual do viewport contendo informações de câmera e modelo do visualizador 3D. | LOAD3D | Sim | - | -| `width` | A largura da imagem de saída em pixels (padrão: 1024) | INT | Sim | Mín: 1
Máx: 4096
Passo: 1 | -| `height` | A altura da imagem de saída em pixels (padrão: 1024) | INT | Sim | Mín: 1
Máx: 4096
Passo: 1 | +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | +|-----------|-------------|---------------|-------------|-----------| +| `model_file` | O arquivo de modelo 3D a ser carregado. Selecione `"none"` para não carregar nenhum arquivo de modelo. | COMBO | Sim | `"none"`
Arquivos de modelo 3D disponíveis no diretório `input/3d` | +| `viewport_state` | O estado atual da viewport contendo informações de câmera e modelo do visualizador 3D. | LOAD3D | Sim | - | +| `width` | Largura de renderização do viewport em pixels (padrão: 1024). | INT | Sim | Mínimo: 1
Máximo: 4096
Padrão: 1024
Passo: 1 | +| `height` | Altura de renderização do viewport em pixels (padrão: 1024). | INT | Sim | Mínimo: 1
Máximo: 4096
Padrão: 1024
Passo: 1 | -**Notas sobre os Parâmetros:** -- O parâmetro `model_file` exibe apenas arquivos com as seguintes extensões: .gltf, .glb, .obj, .fbx, .stl -- Os arquivos devem ser colocados no diretório `input/3d` da sua instalação do ComfyUI -- Se `model_file` estiver definido como "none", nenhum dado de modelo 3D será carregado (a saída `model_3d` ficará vazia) -- Se `model_file` for definido como um arquivo inexistente, o nó retorna um erro de validação: "Invalid 3D model file: {model_file}" +**Notas sobre os parâmetros:** +- O parâmetro `model_file` lista apenas arquivos com as seguintes extensões: .gltf, .glb, .obj, .fbx, .stl +- Os arquivos devem ser colocados no diretório `input/3d` da sua instalação do ComfyUI; subpastas também são pesquisadas, e os caminhos dos arquivos são exibidos relativos ao diretório de entrada +- Se `model_file` for `"none"`, nenhum dado de modelo é carregado e a saída `model_3d` ficará vazia +- Se `model_file` for definido como um arquivo que não existe, o nó retorna um erro de validação: "Invalid 3D model file: {model_file}" ## Saídas -| Nome da Saída | Descrição | Tipo de Dado | -|-------------|-------------|-----------| -| `model_3d` | Os dados do modelo 3D carregado, ou vazio se nenhum arquivo de modelo foi selecionado | FILE3DANY | -| `model_3d_info` | Informações sobre o modelo 3D carregado a partir do estado do viewport | LOAD3DMODELINFO | -| `camera_info` | Informações da câmera a partir do estado do viewport | LOAD3DCAMERA | -| `width` | A largura especificada da imagem de saída | INT | -| `height` | A altura especificada da imagem de saída | INT | +| Nome da Saída | Descrição | Tipo de Dados | +|---------------|-----------|---------------| +| `model_3d` | Arquivo de modelo 3D carregado (glb/obj/stl/etc.). Vazio se nenhum arquivo de modelo foi selecionado. | FILE3DANY | +| `model_3d_info` | Posicionamento de cada modelo na cena: posição, rotação e escala (espaço do mundo com eixo Y para cima). | LOAD3DMODELINFO | +| `camera_info` | Informações da câmera da viewport: posição, alvo da câmera, zoom e tipo. | LOAD3DCAMERA | +| `width` | Largura de renderização do viewport em pixels. | INT | +| `height` | Altura de renderização do viewport em pixels. | INT | > 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/Load3DAdvanced/pt-BR.md) --- -**Source fingerprint (SHA-256):** `fdacea8abf627621150e1196743e36f61534333837c33cc9a7416a6d11700c4d` +**Source fingerprint (SHA-256):** `c79c53dde0c8b3afb7df7b972df749f5040c92d48b47e355c4497d9b0cbf1c22` diff --git a/comfyui_embedded_docs/docs/Load3DAdvanced/ru.md b/comfyui_embedded_docs/docs/Load3DAdvanced/ru.md index aa63be901..e96c607dc 100644 --- a/comfyui_embedded_docs/docs/Load3DAdvanced/ru.md +++ b/comfyui_embedded_docs/docs/Load3DAdvanced/ru.md @@ -1,33 +1,33 @@ # Загрузить 3D (расширено) -Узел Load 3D (Advanced) загружает файл 3D-модели из входного каталога ComfyUI и предоставляет данные модели вместе с информацией о камере и видовом окне. Он поддерживает распространённые форматы 3D-файлов и позволяет указать размеры выходного изображения. +Узел Load 3D (Advanced) загружает файл 3D-модели из каталога `input/3d` ComfyUI и предоставляет данные модели вместе с размещением модели и информацией о камере, сохранёнными в состоянии окна просмотра 3D-просмотрщика. Он поддерживает распространённые форматы 3D-файлов и позволяет задавать ширину и высоту рендеринга окна просмотра в пикселях. Это экспериментальный узел. ## Входы | Параметр | Описание | Тип данных | Обязательный | Диапазон | |-----------|-------------|-----------|----------|-------| -| `model_file` | Файл 3D-модели для загрузки. Выберите «none», чтобы пропустить загрузку модели. | STRING | Да | `"none"`
Список доступных 3D-файлов в каталоге `input/3d` | -| `viewport_state` | Текущее состояние видового окна, содержащее информацию о камере и модели из 3D-просмотрщика. | LOAD3D | Да | - | -| `width` | Ширина выходного изображения в пикселях (по умолчанию: 1024). | INT | Да | Мин.: 1
Макс.: 4096
Шаг: 1 | -| `height` | Высота выходного изображения в пикселях (по умолчанию: 1024). | INT | Да | Мин.: 1
Макс.: 4096
Шаг: 1 | +| `model_file` | Файл 3D-модели для загрузки. Выберите «none», чтобы пропустить загрузку файла модели. | COMBO | Да | `"none"`
Доступные файлы 3D-моделей в каталоге `input/3d` | +| `viewport_state` | Текущее состояние окна просмотра, содержащее информацию о камере и модели из 3D-просмотрщика. | LOAD3D | Да | - | +| `width` | Ширина рендеринга окна просмотра в пикселях (по умолчанию: 1024). | INT | Да | Min: 1
Max: 4096
Default: 1024
Step: 1 | +| `height` | Высота рендеринга окна просмотра в пикселях (по умолчанию: 1024). | INT | Да | Min: 1
Max: 4096
Default: 1024
Step: 1 | -**Примечания к параметрам:** -- Параметр `model_file` показывает только файлы со следующими расширениями: .gltf, .glb, .obj, .fbx, .stl -- Файлы должны быть размещены в каталоге `input/3d` вашей установки ComfyUI -- Если для `model_file` установлено значение «none», данные 3D-модели не загружаются (выходной параметр `model_3d` будет пустым) -- Если для `model_file` установлено имя несуществующего файла, узел возвращает ошибку проверки: «Invalid 3D model file: {model_file}» +**Примечания по параметрам:** +- Параметр `model_file` перечисляет только файлы со следующими расширениями: .gltf, .glb, .obj, .fbx, .stl +- Файлы должны быть размещены в каталоге `input/3d` вашей установки ComfyUI; подпапки также включаются в поиск, а пути к файлам отображаются относительно каталога `input` +- Если `model_file` имеет значение «none», данные модели не загружаются, и выход `model_3d` будет пустым +- Если для `model_file` указан несуществующий файл, узел возвращает ошибку валидации: «Invalid 3D model file: {model_file}» ## Выходы | Имя выхода | Описание | Тип данных | |-------------|-------------|-----------| -| `model_3d` | Загруженные данные 3D-модели или пусто, если файл модели не выбран. | FILE3DANY | -| `model_3d_info` | Информация о загруженной 3D-модели из состояния видового окна. | LOAD3DMODELINFO | -| `camera_info` | Информация о камере из состояния видового окна. | LOAD3DCAMERA | -| `width` | Указанная ширина выходного изображения. | INT | -| `height` | Указанная высота выходного изображения. | INT | +| `model_3d` | Загруженный файл 3D-модели (glb/obj/stl/и т. д.). Пусто, если файл модели не был выбран. | FILE3DANY | +| `model_3d_info` | Размещение каждой модели в сцене: позиция, поворот и масштаб (мировая система координат с осью Y вверх). | LOAD3DMODELINFO | +| `camera_info` | Информация о камере окна просмотра: позиция, целевая точка обзора, зум и тип. | LOAD3DCAMERA | +| `width` | Ширина рендеринга окна просмотра в пикселях. | INT | +| `height` | Высота рендеринга окна просмотра в пикселях. | INT | > Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Load3DAdvanced/ru.md) --- -**Source fingerprint (SHA-256):** `682edf36af114661e42556b3f461d0e2a4b38db34a2d3cdfd9319b7f10698645` +**Source fingerprint (SHA-256):** `c79c53dde0c8b3afb7df7b972df749f5040c92d48b47e355c4497d9b0cbf1c22` diff --git a/comfyui_embedded_docs/docs/Load3DAdvanced/tr.md b/comfyui_embedded_docs/docs/Load3DAdvanced/tr.md index 84434708f..d25b731e0 100644 --- a/comfyui_embedded_docs/docs/Load3DAdvanced/tr.md +++ b/comfyui_embedded_docs/docs/Load3DAdvanced/tr.md @@ -1,33 +1,33 @@ -# Load3DAdvanced +# 3D Yükle (Gelişmiş) -Bu düğüm, ComfyUI giriş dizininizden bir 3B model dosyası yükler ve model verilerini kamera ve görünüm alanı bilgileriyle birlikte sağlar. Yaygın 3B dosya biçimlerini destekler ve işleme için çıktı görüntü boyutlarını belirlemenize olanak tanır. +Load 3D (Advanced) düğümü, ComfyUI'nin `input/3d` dizininden bir 3D model dosyası yükler ve model verilerini, 3D görüntüleyicinin görünüm alanı durumunda yakalanan model yerleşimi ve kamera bilgileriyle birlikte sağlar. Yaygın 3D dosya formatlarını destekler ve görünüm alanının işleme genişliğini ve yüksekliğini piksel cinsinden ayarlamanıza olanak tanır. Bu düğüm deneyseldir. -## Girişler +## Girdiler | Parametre | Açıklama | Veri Türü | Zorunlu | Aralık | |-----------|-------------|-----------|----------|-------| -| `model_file` | Yüklenecek 3B model dosyası. Model yüklemeyi atlamak için "none" seçeneğini belirleyin. | STRING | Evet | `"none"`
input/3d dizinindeki mevcut 3B dosyaların listesi | -| `viewport_state` | 3B görüntüleyiciden kamera ve model bilgilerini içeren mevcut görünüm alanı durumu. | LOAD3D | Evet | - | -| `width` | Çıktı görüntüsünün piksel cinsinden genişliği (varsayılan: 1024) | INT | Evet | Min: 1
Maks: 4096
Adım: 1 | -| `height` | Çıktı görüntüsünün piksel cinsinden yüksekliği (varsayılan: 1024) | INT | Evet | Min: 1
Maks: 4096
Adım: 1 | +| `model_file` | Yüklenecek 3D model dosyası. Model dosyası yüklemeyi atlamak için "none" seçin. | COMBO | Evet | `"none"`
`input/3d` dizininde bulunan mevcut 3D model dosyaları | +| `viewport_state` | 3D görüntüleyiciden kamera ve model bilgilerini içeren geçerli görünüm alanı durumu. | LOAD3D | Evet | - | +| `width` | Görünüm alanının piksel cinsinden işleme genişliği (varsayılan: 1024). | INT | Evet | Min: 1
Max: 4096
Varsayılan: 1024
Adım: 1 | +| `height` | Görünüm alanının piksel cinsinden işleme yüksekliği (varsayılan: 1024). | INT | Evet | Min: 1
Max: 4096
Varsayılan: 1024
Adım: 1 | -**Parametrelerle İlgili Notlar:** -- `model_file` parametresi yalnızca şu uzantılara sahip dosyaları gösterir: .gltf, .glb, .obj, .fbx, .stl -- Dosyalar, ComfyUI kurulumunuzun `input/3d` dizinine yerleştirilmelidir -- `model_file` "none" olarak ayarlanırsa, hiçbir 3B model verisi yüklenmez (`model_3d` çıktısı boş olur) -- `model_file` mevcut olmayan bir dosyaya ayarlanırsa, düğüm bir doğrulama hatası döndürür: "Invalid 3D model file: {model_file}" +**Parametrelere İlişkin Notlar:** +- `model_file` parametresi yalnızca şu uzantılara sahip dosyaları listeler: .gltf, .glb, .obj, .fbx, .stl +- Dosyalar ComfyUI kurulumunuzun `input/3d` dizinine yerleştirilmelidir; alt klasörler de taranır ve dosya yolları girdi dizinine göre gösterilir +- `model_file` "none" ise hiçbir model verisi yüklenmez ve `model_3d` çıktısı boş olur +- `model_file` mevcut olmayan bir dosyaya ayarlanırsa düğüm bir doğrulama hatası döndürür: "Invalid 3D model file: {model_file}" ## Çıktılar | Çıktı Adı | Açıklama | Veri Türü | |-------------|-------------|-----------| -| `model_3d` | Yüklenen 3B model verisi veya hiçbir model dosyası seçilmediyse boş | FILE3DANY | -| `model_3d_info` | Görünüm alanı durumundan yüklenen 3B model hakkında bilgi | LOAD3DMODELINFO | -| `camera_info` | Görünüm alanı durumundan kamera bilgisi | LOAD3DCAMERA | -| `width` | Belirtilen çıktı görüntü genişliği | INT | -| `height` | Belirtilen çıktı görüntü yüksekliği | INT | +| `model_3d` | Yüklenen 3D model dosyası (glb/obj/stl/vb.). Hiçbir model dosyası seçilmediyse boştur. | FILE3DANY | +| `model_3d_info` | Her modelin sahnedeki yerleşimi: konum, dönüş ve ölçek (dünya uzayında Y yukarı). | LOAD3DMODELINFO | +| `camera_info` | Görünüm alanı kamera bilgisi: konum, bakış hedefi, yakınlaştırma ve tür. | LOAD3DCAMERA | +| `width` | Görünüm alanının piksel cinsinden işleme genişliği. | INT | +| `height` | Görünüm alanının piksel cinsinden işleme yüksekliği. | INT | > 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/Load3DAdvanced/tr.md) --- -**Source fingerprint (SHA-256):** `fdacea8abf627621150e1196743e36f61534333837c33cc9a7416a6d11700c4d` +**Source fingerprint (SHA-256):** `c79c53dde0c8b3afb7df7b972df749f5040c92d48b47e355c4497d9b0cbf1c22` diff --git a/comfyui_embedded_docs/docs/Load3DAdvanced/zh-TW.md b/comfyui_embedded_docs/docs/Load3DAdvanced/zh-TW.md index 38d793913..e24422704 100644 --- a/comfyui_embedded_docs/docs/Load3DAdvanced/zh-TW.md +++ b/comfyui_embedded_docs/docs/Load3DAdvanced/zh-TW.md @@ -1,33 +1,33 @@ -# Load3DAdvanced +# 載入 3D(進階) -此節點從您的 ComfyUI 輸入目錄載入 3D 模型檔案,並提供模型資料以及相機和視口資訊。它支援常見的 3D 檔案格式,並允許您指定用於渲染的輸出影像尺寸。 +Load 3D (Advanced) 節點可從 ComfyUI 的 `input/3d` 目錄載入 3D 模型檔案,並提供模型資料,以及在 3D 檢視器視埠狀態中所捕捉到的模型放置與相機資訊。此節點支援常見的 3D 檔案格式,並可讓您設定視埠的渲染寬度與高度(以像素為單位)。此節點為實驗性功能。 -## ## 輸入 +## 輸入 -| 參數 | 說明 | 資料類型 | 必要 | 範圍 | +| 參數 | 說明 | 資料型態 | 必填 | 範圍 | |-----------|-------------|-----------|----------|-------| -| `model_file` | 要載入的 3D 模型檔案。選擇 "none" 可跳過載入模型。 | STRING | 是 | `"none"`
input/3d 目錄中可用的 3D 檔案列表 | -| `viewport_state` | 來自 3D 檢視器的當前視口狀態,包含相機和模型資訊。 | LOAD3D | 是 | - | -| `width` | 輸出影像的寬度(像素),預設值:1024 | INT | 是 | 最小值:1
最大值:4096
步進值:1 | -| `height` | 輸出影像的高度(像素),預設值:1024 | INT | 是 | 最小值:1
最大值:4096
步進值:1 | +| `model_file` | 要載入的 3D 模型檔案。選取「none」以略過載入模型檔案。 | COMBO | 是 | `"none"`
在 `input/3d` 目錄中可用的 3D 模型檔案 | +| `viewport_state` | 目前的視埠狀態,包含來自 3D 檢視器的相機與模型資訊。 | LOAD3D | 是 | - | +| `width` | 以像素為單位的視埠渲染寬度(預設:1024)。 | INT | 是 | 最小值:1
最大值:4096
預設值:1024
步長:1 | +| `height` | 以像素為單位的視埠渲染高度(預設:1024)。 | INT | 是 | 最小值:1
最大值:4096
預設值:1024
步長:1 | -**參數說明:** -- `model_file` 參數僅顯示具有以下副檔名的檔案:.gltf、.glb、.obj、.fbx、.stl -- 檔案必須放置在您 ComfyUI 安裝目錄的 `input/3d` 資料夾中 -- 如果 `model_file` 設定為 "none",則不會載入任何 3D 模型資料(輸出 `model_3d` 將為空) -- 如果 `model_file` 設定為不存在的檔案,節點將回傳驗證錯誤:"Invalid 3D model file: {model_file}" +**參數附註:** +- `model_file` 參數只會列出具有下列副檔名的檔案:.gltf、.glb、.obj、.fbx、.stl +- 檔案必須放在 ComfyUI 安裝的 `input/3d` 目錄中;也會搜尋子資料夾,並會顯示相對於輸入目錄的檔案路徑 +- 如果 `model_file` 為「none」,則不會載入任何模型資料,且 `model_3d` 輸出將為空 +- 如果 `model_file` 設定為不存在的檔案,節點會傳回驗證錯誤:"Invalid 3D model file: {model_file}" -## ## 輸出 +## 輸出 -| 輸出名稱 | 說明 | 資料類型 | +| 輸出名 | 說明 | 資料型態 | |-------------|-------------|-----------| -| `model_3d` | 已載入的 3D 模型資料,若未選擇模型檔案則為空 | FILE3DANY | -| `model_3d_info` | 來自視口狀態的已載入 3D 模型資訊 | LOAD3DMODELINFO | -| `camera_info` | 來自視口狀態的相機資訊 | LOAD3DCAMERA | -| `width` | 指定的輸出影像寬度 | INT | -| `height` | 指定的輸出影像高度 | INT | +| `model_3d` | 已載入的 3D 模型檔案(glb/obj/stl 等)。如果未選取任何模型檔案,則為空。 | FILE3DANY | +| `model_3d_info` | 場景中每個模型的放置資訊:位置、旋轉與縮放(Y 軸向上的世界空間)。 | LOAD3DMODELINFO | +| `camera_info` | 視埠相機資訊:位置、注視目標、縮放與類型。 | LOAD3DCAMERA | +| `width` | 以像素為單位的視埠渲染寬度。 | INT | +| `height` | 以像素為單位的視埠渲染高度。 | INT | > 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Load3DAdvanced/zh-TW.md) --- -**Source fingerprint (SHA-256):** `fdacea8abf627621150e1196743e36f61534333837c33cc9a7416a6d11700c4d` +**Source fingerprint (SHA-256):** `c79c53dde0c8b3afb7df7b972df749f5040c92d48b47e355c4497d9b0cbf1c22` diff --git a/comfyui_embedded_docs/docs/Load3DAdvanced/zh.md b/comfyui_embedded_docs/docs/Load3DAdvanced/zh.md index 94f4ebdb6..df9b2518a 100644 --- a/comfyui_embedded_docs/docs/Load3DAdvanced/zh.md +++ b/comfyui_embedded_docs/docs/Load3DAdvanced/zh.md @@ -1,33 +1,33 @@ -# Load3DAdvanced +# 加载3D(高级) -此节点从您的 ComfyUI 输入目录加载 3D 模型文件,并提供模型数据以及相机和视口信息。它支持常见的 3D 文件格式,并允许您指定渲染输出的图像尺寸。 +Load 3D (Advanced) 节点从 ComfyUI 的 `input/3d` 目录中加载 3D 模型文件,并提供模型数据,以及 3D 查看器视口状态中捕获的模型放置和相机信息。它支持常见的 3D 文件格式,并允许您以像素为单位设置视口的渲染宽度和高度。此节点为实验性功能。 ## 输入 -| 参数 | 描述 | 数据类型 | 是否必需 | 范围 | +| 参数 | 描述 | 数据类型 | 是否必填 | 范围 | |-----------|-------------|-----------|----------|-------| -| `model_file` | 要加载的 3D 模型文件。选择 "none" 可跳过加载模型。 | STRING | 是 | `"none"`
input/3d 目录中可用的 3D 文件列表 | +| `model_file` | 要加载的 3D 模型文件。选择“none”可跳过加载模型文件。 | COMBO | 是 | `"none"`
`input/3d` 目录中可用的 3D 模型文件 | | `viewport_state` | 当前视口状态,包含来自 3D 查看器的相机和模型信息。 | LOAD3D | 是 | - | -| `width` | 输出图像的宽度(像素),默认值:1024 | INT | 是 | 最小值:1
最大值:4096
步长:1 | -| `height` | 输出图像的高度(像素),默认值:1024 | INT | 是 | 最小值:1
最大值:4096
步长:1 | +| `width` | 视口的渲染宽度(像素,默认值:1024)。 | INT | 是 | 最小值:1
最大值:4096
默认值:1024
步长:1 | +| `height` | 视口的渲染高度(像素,默认值:1024)。 | INT | 是 | 最小值:1
最大值:4096
默认值:1024
步长:1 | **参数说明:** -- `model_file` 参数仅显示以下扩展名的文件:.gltf、.glb、.obj、.fbx、.stl -- 文件必须放置在 ComfyUI 安装目录的 `input/3d` 文件夹中 -- 如果 `model_file` 设置为 "none",则不会加载任何 3D 模型数据(输出 `model_3d` 将为空) -- 如果 `model_file` 设置为不存在的文件,节点将返回验证错误:"Invalid 3D model file: {model_file}" +- `model_file` 参数仅列出具有以下扩展名的文件:.gltf、.glb、.obj、.fbx、.stl +- 文件必须放置在 ComfyUI 安装目录的 `input/3d` 目录中;也会搜索子文件夹,文件路径相对于输入目录显示 +- 如果 `model_file` 为“none”,则不会加载模型数据,`model_3d` 输出将为空 +- 如果 `model_file` 设置为不存在的文件,节点将返回验证错误:“Invalid 3D model file: {model_file}” ## 输出 | 输出名称 | 描述 | 数据类型 | |-------------|-------------|-----------| -| `model_3d` | 已加载的 3D 模型数据,如果未选择模型文件则为空 | FILE3DANY | -| `model_3d_info` | 来自视口状态的已加载 3D 模型信息 | LOAD3DMODELINFO | -| `camera_info` | 来自视口状态的相机信息 | LOAD3DCAMERA | -| `width` | 指定的输出图像宽度 | INT | -| `height` | 指定的输出图像高度 | INT | +| `model_3d` | 已加载的 3D 模型文件(glb/obj/stl 等)。如果未选择模型文件则为空。 | FILE3DANY | +| `model_3d_info` | 场景中每个模型的放置信息:位置、旋转和缩放(Y 轴向上的世界空间)。 | LOAD3DMODELINFO | +| `camera_info` | 视口相机信息:位置、注视目标、缩放和类型。 | LOAD3DCAMERA | +| `width` | 视口的渲染宽度(像素)。 | INT | +| `height` | 视口的渲染高度(像素)。 | INT | > 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Load3DAdvanced/zh.md) --- -**Source fingerprint (SHA-256):** `fdacea8abf627621150e1196743e36f61534333837c33cc9a7416a6d11700c4d` +**Source fingerprint (SHA-256):** `c79c53dde0c8b3afb7df7b972df749f5040c92d48b47e355c4497d9b0cbf1c22` diff --git a/comfyui_embedded_docs/docs/ModelAttentionBackend/ar.md b/comfyui_embedded_docs/docs/ModelAttentionBackend/ar.md index e598c868a..e7c0f8835 100644 --- a/comfyui_embedded_docs/docs/ModelAttentionBackend/ar.md +++ b/comfyui_embedded_docs/docs/ModelAttentionBackend/ar.md @@ -1,25 +1,23 @@ -# ModelAttentionBackend +# الواجهة الخلفية لانتباه النموذج -This node lets you choose which attention backend a model uses for its attention computations. It creates a copy of the model and swaps in the attention function you select, which can affect performance or behavior. If the chosen backend is not available, it automatically falls back to PyTorch attention and logs a warning. - -تسمح لك هذه العقدة باختيار الخلفية (backend) التي يستخدمها النموذج لعمليات الانتباه الخاصة به. وهي تنشئ نسخة من النموذج وتستبدل دالة الانتباه التي تختارها، مما قد يؤثر على الأداء أو السلوك. إذا لم تكن الخلفية المحددة متاحة، فإنها تتراجع تلقائيًا إلى انتباه PyTorch وتُسجّل تحذيرًا. +تحدد هذه العقدة الخلفية (backend) المستخدمة في الانتباه الكثيف التي يعتمد عليها النموذج في عمليات حساب الانتباه. تستنسخ العقدة النموذج المُمرر إليها، وتطبّق الخلفية المختارة، ثم تُرجع النسخة المعدَّلة. عند استخدامها مع Block Sparse Attention، تُستخدم هذه الخلفية كلما كان الانتباه المتفرق غير نشط أو غير مدعوم. إذا كانت الخلفية المحددة غير متاحة، تعود العقدة تلقائيًا إلى انتباه PyTorch. ## المدخلات -| المعامل | الوصف | نوع البيانات | إلزامي | النطاق | +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | |-----------|-------------|-----------|----------|-------| -| `النموذج` | النموذج الذي سيتم تطبيق خلفية الانتباه المحددة عليه. | MODEL | نعم | | -| `الانتباه` | خلفية الانتباه المستخدمة (الافتراضي: "pytorch attention"). إذا كانت الخلفية المحددة غير متاحة، يتم استخدام انتباه PyTorch كخيار احتياطي. | STRING | نعم | "pytorch attention"
"comfy kitchen attention" | +| `النموذج` | النموذج المطلوب تعديله. | MODEL | نعم | | +| `الانتباه` | الخلفية (backend) المطلوب تطبيقها للانتباه الكثيف (الافتراضي: "pytorch attention"). خيار Comfy Kitchen attention يعتمد على انتباه مكمم بنطاق INT8، وهو متاح فقط على وحدات معالجة الرسوميات من Nvidia وAMD. إذا كانت الخلفية المحددة غير متاحة، يُستخدم انتباه PyTorch كخيار احتياطي. | COMBO | نعم | "pytorch attention"
"comfy kitchen attention" | -ملاحظة: يُدرج خيار "comfy kitchen attention" فقط عندما تكون وحدة انتباه comfy kitchen int8 متاحة في البيئة الحالية. +ملاحظة: يظهر خيار "comfy kitchen attention" فقط عندما تكون وحدة انتباه Comfy Kitchen INT8 متاحة في البيئة الحالية. ## المخرجات | اسم المخرج | الوصف | نوع البيانات | -|-------------|-----------|-----------| -| `MODEL` | نسخة طبق الأصل من نموذج الإدخال مع تطبيق خلفية الانتباه المحددة. | MODEL | +|-------------|-------------|-----------| +| `model` | نسخة مستنسخة من النموذج المُدخل مع تطبيق الخلفية المختارة للانتباه. | MODEL | > تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ModelAttentionBackend/ar.md) --- -**Source fingerprint (SHA-256):** `4ba613cc0bf5b3e7f9effa895b98b3a3bd302e5d20e9d7e18d1633906c783244` +**Source fingerprint (SHA-256):** `4f6e4800c2a3bb09b47b7c8f0481e1b6de3070f57234e610df5d3ce60dfdb309` diff --git a/comfyui_embedded_docs/docs/ModelAttentionBackend/en.md b/comfyui_embedded_docs/docs/ModelAttentionBackend/en.md index 4d2355756..0658a24d8 100644 --- a/comfyui_embedded_docs/docs/ModelAttentionBackend/en.md +++ b/comfyui_embedded_docs/docs/ModelAttentionBackend/en.md @@ -1,15 +1,15 @@ -# ModelAttentionBackend +# Model Attention Backend -This node lets you choose which attention backend a model uses for its attention computations. It creates a copy of the model and swaps in the attention function you select, which can affect performance or behavior. If the chosen backend is not available, it automatically falls back to PyTorch attention and logs a warning. +This node selects the dense attention backend that a model uses for its attention computations. It clones the given model, applies the chosen backend, and returns the patched clone. When used with Block Sparse Attention, this backend is used whenever sparse attention is inactive or unsupported. If the selected backend is unavailable, the node automatically falls back to PyTorch attention. ## Inputs | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `model` | The model to which the selected attention backend will be applied. | MODEL | Yes | | -| `attention` | The attention backend to use (default: "pytorch attention"). If the selected backend is unavailable, PyTorch attention is used as a fallback. | STRING | Yes | "pytorch attention"
"comfy kitchen attention" | +| `model` | The model to patch. | MODEL | Yes | | +| `attention` | The dense attention backend to apply (default: "pytorch attention"). Comfy Kitchen attention uses quantized INT8 attention and is available only on Nvidia and AMD GPUs. If the selected backend is unavailable, PyTorch attention is used as a fallback. | COMBO | Yes | "pytorch attention"
"comfy kitchen attention" | -Note: The "comfy kitchen attention" option is only listed when the comfy kitchen int8 attention module is available in the current environment. +Note: The "comfy kitchen attention" option is only listed when the Comfy Kitchen INT8 attention module is available in the current environment. ## Outputs @@ -20,4 +20,4 @@ Note: The "comfy kitchen attention" option is only listed when the comfy kitchen > 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/ModelAttentionBackend/en.md) --- -**Source fingerprint (SHA-256):** `4ba613cc0bf5b3e7f9effa895b98b3a3bd302e5d20e9d7e18d1633906c783244` +**Source fingerprint (SHA-256):** `4f6e4800c2a3bb09b47b7c8f0481e1b6de3070f57234e610df5d3ce60dfdb309` diff --git a/comfyui_embedded_docs/docs/ModelAttentionBackend/es.md b/comfyui_embedded_docs/docs/ModelAttentionBackend/es.md index 8ce6ef4b5..a3b3256b3 100644 --- a/comfyui_embedded_docs/docs/ModelAttentionBackend/es.md +++ b/comfyui_embedded_docs/docs/ModelAttentionBackend/es.md @@ -1,23 +1,23 @@ -# ModelAttentionBackend +# Backend de atención del modelo -Este nodo te permite elegir qué backend de atención utiliza un modelo para sus cálculos de atención. Crea una copia del modelo e intercambia la función de atención que selecciones, lo que puede afectar el rendimiento o el comportamiento. Si el backend elegido no está disponible, automáticamente vuelve a la atención de PyTorch y registra una advertencia. +Este nodo selecciona el backend de atención densa que un modelo utiliza para sus cálculos de atención. Clona el modelo dado, aplica el backend elegido y devuelve el clon parcheado. Cuando se usa con Block Sparse Attention, este backend se utiliza siempre que la atención dispersa esté inactiva o no sea compatible. Si el backend seleccionado no está disponible, el nodo recurre automáticamente a la atención de PyTorch. ## Entradas -| Parámetro | Descripción | Tipo de Dato | Requerido | Rango | -|-----------|-------------|--------------|-----------|-------| -| `modelo` | El modelo al que se le aplicará el backend de atención seleccionado. | MODEL | Sí | | -| `atención` | El backend de atención a utilizar (predeterminado: "pytorch attention"). Si el backend seleccionado no está disponible, se usa PyTorch attention como respaldo. | STRING | Sí | "pytorch attention"
"comfy kitchen attention" | +| Parámetro | Descripción | Tipo de datos | Requerido | Rango | +|-----------|-------------|---------------|-----------|-------| +| `modelo` | El modelo a parchear. | MODEL | Sí | | +| `atención` | El backend de atención densa a aplicar (predeterminado: "pytorch attention"). La atención de Comfy Kitchen utiliza atención INT8 cuantizada y está disponible solo en GPU de Nvidia y AMD. Si el backend seleccionado no está disponible, se utiliza la atención de PyTorch como respaldo. | COMBO | Sí | "pytorch attention"
"comfy kitchen attention" | -Nota: La opción "comfy kitchen attention" solo se muestra cuando el módulo de atención int8 de comfy kitchen está disponible en el entorno actual. +Nota: La opción "comfy kitchen attention" solo aparece cuando el módulo de atención INT8 de Comfy Kitchen está disponible en el entorno actual. ## Salidas -| Nombre de Salida | Descripción | Tipo de Dato | -|------------------|-------------|--------------| -| `MODEL` | Un clon del modelo de entrada con el backend de atención seleccionado aplicado. | MODEL | +| Nombre de salida | Descripción | Tipo de datos | +|------------------|-------------|---------------| +| `model` | Un clon del modelo de entrada con el backend de atención seleccionado aplicado. | MODEL | > 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/ModelAttentionBackend/es.md) --- -**Source fingerprint (SHA-256):** `4ba613cc0bf5b3e7f9effa895b98b3a3bd302e5d20e9d7e18d1633906c783244` +**Source fingerprint (SHA-256):** `4f6e4800c2a3bb09b47b7c8f0481e1b6de3070f57234e610df5d3ce60dfdb309` diff --git a/comfyui_embedded_docs/docs/ModelAttentionBackend/fa.md b/comfyui_embedded_docs/docs/ModelAttentionBackend/fa.md index cc0002903..d36e54eb9 100644 --- a/comfyui_embedded_docs/docs/ModelAttentionBackend/fa.md +++ b/comfyui_embedded_docs/docs/ModelAttentionBackend/fa.md @@ -1,23 +1,23 @@ -# ModelAttentionBackend +# بک‌اند توجه مدل -این گره به شما امکان می‌دهد انتخاب کنید که یک مدل برای محاسبات توجه خود از کدام پشتیبان توجه استفاده کند. یک کپی از مدل ایجاد کرده و تابع توجه انتخابی شما را جایگزین می‌کند که می‌تواند بر عملکرد یا رفتار تأثیر بگذارد. اگر پشتیبان انتخابی در دسترس نباشد، به‌طور خودکار به «pytorch attention» بازگشت کرده و یک هشدار ثبت می‌کند. +این گره بک‌اند توجه متراکمی را انتخاب می‌کند که یک مدل برای محاسبات توجه خود استفاده می‌کند. مدل داده‌شده را کلون می‌کند، بک‌اند انتخاب‌شده را اعمال می‌کند و کلون وصله‌شده را برمی‌گرداند. هنگام استفاده همراه با Block Sparse Attention، این بک‌اند هر زمان که توجه پراکنده غیرفعال یا پشتیبانی‌نشده باشد استفاده می‌شود. اگر بک‌اند انتخاب‌شده در دسترس نباشد، گره به‌طور خودکار به توجه PyTorch بازمی‌گردد. ## ورودی‌ها | پارامتر | توضیحات | نوع داده | الزامی | محدوده | |-----------|-------------|-----------|----------|-------| -| `مدل` | مدلی که پشتیبان توجه انتخاب‌شده روی آن اعمال می‌شود. | MODEL | بله | | -| `attention` | پشتیبان توجه مورد استفاده (پیش‌فرض: «pytorch attention»). اگر پشتیبان انتخاب‌شده در دسترس نباشد، از «pytorch attention» به‌عنوان جایگزین استفاده می‌شود. | STRING | بله | "pytorch attention"
"comfy kitchen attention" | +| `مدل` | مدلی که باید وصله شود. | MODEL | بله | | +| `attention` | بک‌اند توجه متراکم برای اعمال (پیش‌فرض: "pytorch attention"). توجه Comfy Kitchen از توجه کوانتیزه INT8 استفاده می‌کند و فقط روی GPUهای Nvidia و AMD در دسترس است. اگر بک‌اند انتخاب‌شده در دسترس نباشد، از توجه PyTorch به‌عنوان جایگزین استفاده می‌شود. | COMBO | بله | "pytorch attention"
"comfy kitchen attention" | -نکته: گزینه «comfy kitchen attention» تنها زمانی فهرست می‌شود که ماژول «comfy kitchen int8 attention» در محیط فعلی موجود باشد. +توجه: گزینه "comfy kitchen attention" تنها زمانی فهرست می‌شود که ماژول توجه INT8 مربوط به Comfy Kitchen در محیط فعلی در دسترس باشد. ## خروجی‌ها | نام خروجی | توضیحات | نوع داده | |-------------|-------------|-----------| -| `MODEL` | یک کپی از مدل ورودی با اعمال پشتیبان توجه انتخاب‌شده. | MODEL | +| `model` | کلونی از مدل ورودی با بک‌اند توجه انتخاب‌شده اعمال‌شده. | MODEL | > این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ModelAttentionBackend/fa.md) --- -**Source fingerprint (SHA-256):** `4ba613cc0bf5b3e7f9effa895b98b3a3bd302e5d20e9d7e18d1633906c783244` +**Source fingerprint (SHA-256):** `4f6e4800c2a3bb09b47b7c8f0481e1b6de3070f57234e610df5d3ce60dfdb309` diff --git a/comfyui_embedded_docs/docs/ModelAttentionBackend/fr.md b/comfyui_embedded_docs/docs/ModelAttentionBackend/fr.md index 63e031a65..7f14ed8de 100644 --- a/comfyui_embedded_docs/docs/ModelAttentionBackend/fr.md +++ b/comfyui_embedded_docs/docs/ModelAttentionBackend/fr.md @@ -1,23 +1,23 @@ -# ModelAttentionBackend +# Backend d’attention du modèle -Ce nœud vous permet de choisir le backend d'attention qu'un modèle utilisera pour ses calculs d'attention. Il crée une copie du modèle et remplace la fonction d'attention par celle que vous sélectionnez, ce qui peut affecter les performances ou le comportement. Si le backend choisi n'est pas disponible, il revient automatiquement à l'attention PyTorch et enregistre un avertissement. +Ce nœud sélectionne le backend d’attention dense qu’un modèle utilise pour ses calculs d’attention. Il clone le modèle donné, applique le backend choisi, puis renvoie le clone patché. Lorsqu’il est utilisé avec l’attention sparse par blocs (Block Sparse Attention), ce backend est utilisé dès que l’attention sparse est inactive ou non prise en charge. Si le backend sélectionné n’est pas disponible, le nœud revient automatiquement à l’attention PyTorch. ## Entrées | Paramètre | Description | Type de données | Requis | Plage | |-----------|-------------|-----------------|--------|-------| -| `modèle` | Le modèle auquel le backend d'attention sélectionné sera appliqué. | MODEL | Oui | | -| `attention` | Le backend d'attention à utiliser (par défaut : « pytorch attention »). Si le backend sélectionné n'est pas disponible, l'attention PyTorch est utilisée comme solution de repli. | STRING | Oui | « pytorch attention »
« comfy kitchen attention » | +| `modèle` | Le modèle à patcher. | MODEL | Oui | | +| `attention` | Le backend d’attention dense à appliquer (par défaut : « pytorch attention »). L’attention Comfy Kitchen utilise une attention quantifiée en INT8 et n’est disponible que sur les GPU Nvidia et AMD. Si le backend sélectionné n’est pas disponible, l’attention PyTorch est utilisée comme solution de repli. | COMBO | Oui | « pytorch attention »
« comfy kitchen attention » | -Remarque : L'option « comfy kitchen attention » n'est listée que lorsque le module d'attention int8 de comfy kitchen est disponible dans l'environnement actuel. +Remarque : L’option « comfy kitchen attention » n’est listée que lorsque le module d’attention INT8 Comfy Kitchen est disponible dans l’environnement actuel. ## Sorties | Nom de sortie | Description | Type de données | |---------------|-------------|-----------------| -| `MODEL` | Un clone du modèle d'entrée avec le backend d'attention sélectionné appliqué. | MODEL | +| `model` | Un clone du modèle d’entrée avec le backend d’attention sélectionné appliqué. | MODEL | > 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/ModelAttentionBackend/fr.md) --- -**Source fingerprint (SHA-256):** `4ba613cc0bf5b3e7f9effa895b98b3a3bd302e5d20e9d7e18d1633906c783244` +**Source fingerprint (SHA-256):** `4f6e4800c2a3bb09b47b7c8f0481e1b6de3070f57234e610df5d3ce60dfdb309` diff --git a/comfyui_embedded_docs/docs/ModelAttentionBackend/ja.md b/comfyui_embedded_docs/docs/ModelAttentionBackend/ja.md index 6bd9cad06..de879b4b4 100644 --- a/comfyui_embedded_docs/docs/ModelAttentionBackend/ja.md +++ b/comfyui_embedded_docs/docs/ModelAttentionBackend/ja.md @@ -1,23 +1,23 @@ -# ModelAttentionBackend +# モデルアテンションバックエンド -このノードを使用すると、モデルがアテンション計算に使用するアテンションバックエンドを選択できます。モデルのコピーを作成し、選択したアテンション関数に置き換えます。これにより、パフォーマンスや動作に影響を与える可能性があります。選択したバックエンドが利用できない場合は、自動的にPyTorchアテンションにフォールバックし、警告をログに記録します。 +このノードは、モデルがアテンション計算に使用する dense アテンションバックエンドを選択します。指定されたモデルをクローンし、選択したバックエンドを適用して、パッチ適用済みのクローンを返します。Block Sparse Attention と併用する場合、スパースアテンションが非アクティブまたはサポートされていないときは、このバックエンドが使用されます。選択したバックエンドが利用できない場合、ノードは自動的に PyTorch アテンションにフォールバックします。 ## 入力 | パラメータ | 説明 | データ型 | 必須 | 範囲 | |-----------|-------------|-----------|----------|-------| -| `model` | 選択したアテンションバックエンドが適用されるモデル。 | MODEL | はい | | -| `attention` | 使用するアテンションバックエンド(デフォルト: "pytorch attention")。選択したバックエンドが利用できない場合は、PyTorchアテンションがフォールバックとして使用されます。 | STRING | はい | "pytorch attention"
"comfy kitchen attention" | +| `model` | パッチ適用対象のモデルです。 | MODEL | はい | | +| `attention` | 適用する dense アテンションバックエンドです(デフォルト: "pytorch attention")。Comfy Kitchen attention は INT8 量子化アテンションを使用しており、Nvidia GPU および AMD GPU でのみ利用できます。選択したバックエンドが利用できない場合は、PyTorch アテンションがフォールバックとして使用されます。 | COMBO | はい | "pytorch attention"
"comfy kitchen attention" | -注:「comfy kitchen attention」オプションは、現在の環境でcomfy kitchen int8アテンションモジュールが利用可能な場合にのみ表示されます。 +注:"comfy kitchen attention" オプションは、現在の環境で Comfy Kitchen INT8 アテンションモジュールが利用可能な場合にのみ表示されます。 ## 出力 | 出力名 | 説明 | データ型 | |-------------|-------------|-----------| -| `MODEL` | 選択したアテンションバックエンドが適用された入力モデルのクローン。 | MODEL | +| `model` | 選択したアテンションバックエンドを適用した入力モデルのクローンです。 | MODEL | > このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ModelAttentionBackend/ja.md) --- -**Source fingerprint (SHA-256):** `4ba613cc0bf5b3e7f9effa895b98b3a3bd302e5d20e9d7e18d1633906c783244` +**Source fingerprint (SHA-256):** `4f6e4800c2a3bb09b47b7c8f0481e1b6de3070f57234e610df5d3ce60dfdb309` diff --git a/comfyui_embedded_docs/docs/ModelAttentionBackend/ko.md b/comfyui_embedded_docs/docs/ModelAttentionBackend/ko.md index 2edbdc644..6481d64bd 100644 --- a/comfyui_embedded_docs/docs/ModelAttentionBackend/ko.md +++ b/comfyui_embedded_docs/docs/ModelAttentionBackend/ko.md @@ -1,23 +1,23 @@ -# ModelAttentionBackend +# 모델 어텐션 백엔드 -이 노드는 모델이 어텐션 계산에 사용할 어텐션 백엔드를 선택할 수 있게 해줍니다. 선택한 어텐션 함수로 교체한 모델 사본을 생성하며, 이는 성능이나 동작에 영향을 줄 수 있습니다. 선택한 백엔드를 사용할 수 없는 경우 자동으로 PyTorch 어텐션으로 대체하고 경고를 기록합니다. +이 노드는 모델이 어텐션 계산에 사용할 밀집 어텐션 백엔드를 선택합니다. 주어진 모델을 복제하고, 선택한 백엔드를 적용한 다음, 패치된 복제본을 반환합니다. 블록 희소 어텐션(Block Sparse Attention)과 함께 사용하는 경우, 이 백엔드는 희소 어텐션이 비활성화되거나 지원되지 않을 때 사용됩니다. 선택한 백엔드를 사용할 수 없으면, 이 노드는 자동으로 PyTorch 어텐션으로 대체합니다. ## 입력 -| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +| 파라미터 | 설명 | 데이터 타입 | 필수 | 범위 | |-----------|-------------|-----------|----------|-------| -| `model` | 선택한 어텐션 백엔드가 적용될 모델입니다. | MODEL | 예 | | -| `attention` | 사용할 어텐션 백엔드입니다 (기본값: "pytorch attention"). 선택한 백엔드를 사용할 수 없으면 PyTorch 어텐션이 대체로 사용됩니다. | STRING | 예 | "pytorch attention"
"comfy kitchen attention" | +| `model` | 패치할 모델입니다. | MODEL | 예 | | +| `attention` | 적용할 밀집 어텐션 백엔드입니다(기본값: "pytorch attention"). Comfy Kitchen 어텐션은 양자화된 INT8 어텐션을 사용하며, Nvidia 및 AMD GPU에서만 사용할 수 있습니다. 선택한 백엔드를 사용할 수 없으면 PyTorch 어텐션이 대체 수단으로 사용됩니다. | COMBO | 예 | "pytorch attention"
"comfy kitchen attention" | -참고: "comfy kitchen attention" 옵션은 현재 환경에 comfy kitchen int8 어텐션 모듈이 있는 경우에만 표시됩니다. +참고: "comfy kitchen attention" 옵션은 현재 환경에서 Comfy Kitchen INT8 어텐션 모듈을 사용할 수 있는 경우에만 목록에 표시됩니다. ## 출력 | 출력 이름 | 설명 | 데이터 타입 | |-------------|-------------|-----------| -| `MODEL` | 선택한 어텐션 백엔드가 적용된 입력 모델의 복제본입니다. | MODEL | +| `model` | 선택한 어텐션 백엔드가 적용된 입력 모델의 복제본입니다. | MODEL | > 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ModelAttentionBackend/ko.md) --- -**Source fingerprint (SHA-256):** `4ba613cc0bf5b3e7f9effa895b98b3a3bd302e5d20e9d7e18d1633906c783244` +**Source fingerprint (SHA-256):** `4f6e4800c2a3bb09b47b7c8f0481e1b6de3070f57234e610df5d3ce60dfdb309` diff --git a/comfyui_embedded_docs/docs/ModelAttentionBackend/pt-BR.md b/comfyui_embedded_docs/docs/ModelAttentionBackend/pt-BR.md index 29e322a56..9428af5ca 100644 --- a/comfyui_embedded_docs/docs/ModelAttentionBackend/pt-BR.md +++ b/comfyui_embedded_docs/docs/ModelAttentionBackend/pt-BR.md @@ -1,23 +1,23 @@ -# ModelAttentionBackend +# Backend de Atenção do Modelo -Este nó permite escolher qual backend de atenção um modelo usa para seus cálculos de atenção. Ele cria uma cópia do modelo e substitui a função de atenção selecionada, o que pode afetar o desempenho ou o comportamento. Se o backend escolhido não estiver disponível, ele volta automaticamente para a atenção PyTorch e registra um aviso. +Este nó seleciona o backend de atenção densa que um modelo usa para seus cálculos de atenção. Ele clona o modelo fornecido, aplica o backend escolhido e retorna o clone modificado. Quando usado com Block Sparse Attention, esse backend é utilizado sempre que a atenção esparsa estiver inativa ou não for suportada. Se o backend selecionado não estiver disponível, o nó recorre automaticamente à atenção PyTorch. ## Entradas -| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Faixa | +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | |-----------|-------------|-----------|----------|-------| -| `model` | O modelo ao qual o backend de atenção selecionado será aplicado. | MODEL | Sim | | -| `attention` | O backend de atenção a ser usado (padrão: "pytorch attention"). Se o backend selecionado não estiver disponível, a atenção PyTorch será usada como fallback. | STRING | Sim | "pytorch attention"
"comfy kitchen attention" | +| `model` | O modelo a ser modificado. | MODEL | Sim | | +| `attention` | O backend de atenção densa a ser aplicado (padrão: "pytorch attention"). A atenção do Comfy Kitchen usa atenção INT8 quantizada e está disponível apenas em GPUs Nvidia e AMD. Se o backend selecionado não estiver disponível, a atenção PyTorch é usada como alternativa. | COMBO | Sim | "pytorch attention"
"comfy kitchen attention" | -Nota: A opção "comfy kitchen attention" só é listada quando o módulo de atenção comfy kitchen int8 está disponível no ambiente atual. +Nota: A opção "comfy kitchen attention" só é listada quando o módulo de atenção INT8 do Comfy Kitchen está disponível no ambiente atual. ## Saídas | Nome da Saída | Descrição | Tipo de Dados | |-------------|-------------|-----------| -| `MODEL` | Um clone do modelo de entrada com o backend de atenção selecionado aplicado. | MODEL | +| `model` | Um clone do modelo de entrada com o backend de atenção selecionado aplicado. | MODEL | > 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/ModelAttentionBackend/pt-BR.md) --- -**Source fingerprint (SHA-256):** `4ba613cc0bf5b3e7f9effa895b98b3a3bd302e5d20e9d7e18d1633906c783244` +**Source fingerprint (SHA-256):** `4f6e4800c2a3bb09b47b7c8f0481e1b6de3070f57234e610df5d3ce60dfdb309` diff --git a/comfyui_embedded_docs/docs/ModelAttentionBackend/ru.md b/comfyui_embedded_docs/docs/ModelAttentionBackend/ru.md index 166680160..054f49e0e 100644 --- a/comfyui_embedded_docs/docs/ModelAttentionBackend/ru.md +++ b/comfyui_embedded_docs/docs/ModelAttentionBackend/ru.md @@ -1,23 +1,23 @@ -# ModelAttentionBackend +# Бэкенд внимания модели -Этот узел позволяет выбрать, какой бэкенд внимания модель использует для своих вычислений внимания. Он создает копию модели и подменяет функцию внимания на выбранную, что может повлиять на производительность или поведение. Если выбранный бэкенд недоступен, он автоматически переключается на PyTorch attention и регистрирует предупреждение. +Этот узел выбирает бэкенд плотного внимания, который модель использует для своих вычислений. Он клонирует заданную модель, применяет выбранный бэкенд и возвращает пропатченный клон. При использовании с блочным разреженным вниманием этот бэкенд используется, когда разреженное внимание неактивно или не поддерживается. Если выбранный бэкенд недоступен, узел автоматически переключается на внимание PyTorch. -## Входные параметры +## Входы | Параметр | Описание | Тип данных | Обязательный | Диапазон | -|-----------|-------------|-----------|----------|-------| -| `model` | Модель, к которой будет применен выбранный бэкенд внимания. | MODEL | Да | | -| `attention` | Бэкенд внимания для использования (по умолчанию: "pytorch attention"). Если выбранный бэкенд недоступен, используется PyTorch attention в качестве запасного варианта. | STRING | Да | "pytorch attention"
"comfy kitchen attention" | +|----------|----------|------------|--------------|----------| +| `model` | Модель для патчинга. | MODEL | Да | | +| `attention` | Применяемый бэкенд плотного внимания (по умолчанию: "pytorch attention"). Внимание Comfy Kitchen использует квантованное внимание INT8 и доступно только на GPU Nvidia и AMD. Если выбранный бэкенд недоступен, используется внимание PyTorch. | COMBO | Да | "pytorch attention"
"comfy kitchen attention" | -Примечание: опция "comfy kitchen attention" отображается только тогда, когда в текущем окружении доступен модуль comfy kitchen int8 attention. +Примечание: опция "comfy kitchen attention" отображается только в том случае, если модуль внимания Comfy Kitchen INT8 доступен в текущем окружении. -## Выходные параметры +## Выходы | Имя выхода | Описание | Тип данных | -|-------------|-------------|-----------| -| `MODEL` | Клон входной модели с примененным выбранным бэкендом внимания. | MODEL | +|------------|----------|------------| +| `model` | Клон входной модели с применённым выбранным бэкендом внимания. | MODEL | > Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ModelAttentionBackend/ru.md) --- -**Source fingerprint (SHA-256):** `4ba613cc0bf5b3e7f9effa895b98b3a3bd302e5d20e9d7e18d1633906c783244` +**Source fingerprint (SHA-256):** `4f6e4800c2a3bb09b47b7c8f0481e1b6de3070f57234e610df5d3ce60dfdb309` diff --git a/comfyui_embedded_docs/docs/ModelAttentionBackend/tr.md b/comfyui_embedded_docs/docs/ModelAttentionBackend/tr.md index 40ec62424..68d301995 100644 --- a/comfyui_embedded_docs/docs/ModelAttentionBackend/tr.md +++ b/comfyui_embedded_docs/docs/ModelAttentionBackend/tr.md @@ -1,23 +1,23 @@ -# ModelAttentionBackend +# Model Dikkat Arka Ucu -Bu düğüm, bir modelin dikkat hesaplamaları için hangi dikkat arka ucunu (backend) kullanacağını seçmenizi sağlar. Modelin bir kopyasını oluşturur ve seçtiğiniz dikkat işlevini değiştirir; bu, performansı veya davranışı etkileyebilir. Seçilen arka uç mevcut değilse, otomatik olarak PyTorch dikkatine geri döner ve bir uyarı günlüğü kaydeder. +Bu düğüm, bir modelin dikkat hesaplamaları için kullandığı yoğun dikkat arka ucunu seçer. Verilen modeli kopyalar, seçilen arka ucu uygular ve yamalı kopyayı döndürür. Blok Seyrek Dikkat ile kullanıldığında, bu arka uç, seyrek dikkatin etkin olmadığı veya desteklenmediği durumlarda kullanılır. Seçilen arka uç kullanılamıyorsa, düğüm otomatik olarak PyTorch dikkatine geri döner. ## Girdiler | Parametre | Açıklama | Veri Türü | Gerekli | Aralık | |-----------|-------------|-----------|----------|-------| -| `model` | Seçilen dikkat arka ucunun uygulanacağı model. | MODEL | Evet | | -| `dikkat` | Kullanılacak dikkat arka ucu (varsayılan: "pytorch attention"). Seçilen arka uç kullanılamıyorsa, PyTorch dikkati yedek olarak kullanılır. | STRING | Evet | "pytorch attention"
"comfy kitchen attention" | +| `model` | Yamalanacak model. | MODEL | Evet | | +| `dikkat` | Uygulanacak yoğun dikkat arka ucu (varsayılan: "pytorch attention"). Comfy Kitchen dikkati, nicelenmiş INT8 dikkat kullanır ve yalnızca Nvidia ve AMD GPU'larında kullanılabilir. Seçilen arka uç kullanılamıyorsa, geri dönüş olarak PyTorch dikkati kullanılır. | COMBO | Evet | "pytorch attention"
"comfy kitchen attention" | -Not: "comfy kitchen attention" seçeneği yalnızca comfy kitchen int8 dikkat modülü mevcut ortamda kullanılabilir olduğunda listelenir. +Not: "comfy kitchen attention" seçeneği yalnızca geçerli ortamda Comfy Kitchen INT8 dikkat modülü mevcut olduğunda listelenir. ## Çıktılar | Çıktı Adı | Açıklama | Veri Türü | |-------------|-------------|-----------| -| `MODEL` | Seçilen dikkat arka ucu uygulanmış giriş modelinin bir kopyası. | MODEL | +| `model` | Seçilen dikkat arka ucu uygulanmış girdi modelinin bir kopyası. | MODEL | > 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/ModelAttentionBackend/tr.md) --- -**Source fingerprint (SHA-256):** `4ba613cc0bf5b3e7f9effa895b98b3a3bd302e5d20e9d7e18d1633906c783244` +**Source fingerprint (SHA-256):** `4f6e4800c2a3bb09b47b7c8f0481e1b6de3070f57234e610df5d3ce60dfdb309` diff --git a/comfyui_embedded_docs/docs/ModelAttentionBackend/zh-TW.md b/comfyui_embedded_docs/docs/ModelAttentionBackend/zh-TW.md index 607aaf293..6daa37fcb 100644 --- a/comfyui_embedded_docs/docs/ModelAttentionBackend/zh-TW.md +++ b/comfyui_embedded_docs/docs/ModelAttentionBackend/zh-TW.md @@ -1,21 +1,23 @@ -# ModelAttentionBackend +# 模型注意力後端 -此節點可讓您選擇模型用於其注意力計算的注意力後端。它會建立模型的副本,並換入您選擇的注意力函式,這可能會影響效能或行為。如果所選的後端不可用,它會自動回退到 PyTorch 注意力,並記錄警告。 +此節點會為模型的注意力計算選取所需的密集注意力後端。它會複製指定的模型、套用所選後端,並回傳修補後的複本。與 Block Sparse Attention 搭配使用時,只要稀疏注意力未啟用或不受支援,就會使用此後端。若選取的後端無法使用,節點會自動改用 PyTorch attention。 ## 輸入 -| 參數 | 描述 | 資料類型 | 必填 | 範圍 | + +| 參數 | 描述 | 資料型別 | 必要 | 範圍 | |-----------|-------------|-----------|----------|-------| -| `model` | 套用所選注意力後端的模型。 | MODEL | 是 | | -| `attention` | 要使用的注意力後端(預設值:"pytorch attention")。如果所選後端不可用,則會使用 PyTorch 注意力作為回退。 | STRING | 是 | "pytorch attention"
"comfy kitchen attention" | +| `model` | 要修補的模型。 | MODEL | 是 | | +| `attention` | 要套用的密集注意力後端(預設值:"pytorch attention")。Comfy Kitchen attention 使用量化的 INT8 注意力,僅在 Nvidia 與 AMD GPU 上可用。若選取的後端無法使用,則會改用 PyTorch attention。 | COMBO | 是 | "pytorch attention"
"comfy kitchen attention" | -注意:「comfy kitchen attention」選項只有在目前環境中具備 comfy kitchen int8 注意力模組時才會列出。 +注意:僅在目前環境中可取得 Comfy Kitchen INT8 attention 模組時,才會顯示 "comfy kitchen attention" 選項。 ## 輸出 -| 輸出名稱 | 描述 | 資料類型 | + +| 輸出名 | 描述 | 資料型別 | |-------------|-------------|-----------| -| `MODEL` | 已套用所選注意力後端的輸入模型副本。 | MODEL | +| `模型` | 已套用所選注意力後端的輸入模型複本。 | MODEL | > 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ModelAttentionBackend/zh-TW.md) --- -**Source fingerprint (SHA-256):** `4ba613cc0bf5b3e7f9effa895b98b3a3bd302e5d20e9d7e18d1633906c783244` +**Source fingerprint (SHA-256):** `4f6e4800c2a3bb09b47b7c8f0481e1b6de3070f57234e610df5d3ce60dfdb309` diff --git a/comfyui_embedded_docs/docs/ModelAttentionBackend/zh.md b/comfyui_embedded_docs/docs/ModelAttentionBackend/zh.md index f930778ae..3d125398b 100644 --- a/comfyui_embedded_docs/docs/ModelAttentionBackend/zh.md +++ b/comfyui_embedded_docs/docs/ModelAttentionBackend/zh.md @@ -1,23 +1,23 @@ -# ModelAttentionBackend +# 模型注意力后端 -此节点允许你选择模型用于注意力计算的后端。它会创建模型的一个副本,并替换为你选择的注意力函数,这可能会影响性能或行为。如果所选后端不可用,它会自动回退到 PyTorch 注意力,并记录一条警告。 +此节点用于选择模型在进行注意力计算时所使用的密集注意力后端。它会克隆给定模型,应用所选后端,并返回修补后的克隆。当与 Block Sparse Attention 一起使用时,只要稀疏注意力未激活或不支持,就会使用此后端。如果所选后端不可用,节点会自动回退到 PyTorch attention。 ## 输入 | 参数 | 描述 | 数据类型 | 是否必填 | 取值范围 | |-----------|-------------|-----------|----------|-------| -| `model` | 将要应用所选注意力后端的模型。 | MODEL | 是 | | -| `attention` | 要使用的注意力后端(默认值:"pytorch attention")。如果所选后端不可用,则使用 PyTorch 注意力作为回退。 | STRING | 是 | "pytorch attention"
"comfy kitchen attention" | +| `model` | 要修补的模型。 | MODEL | 是 | | +| `attention` | 要应用的密集注意力后端(默认值:"pytorch attention")。Comfy Kitchen attention 使用量化的 INT8 注意力,并且仅在 Nvidia 和 AMD GPU 上可用。如果所选后端不可用,将使用 PyTorch attention 作为回退。 | COMBO | 是 | "pytorch attention"
"comfy kitchen attention" | -注意:仅当当前环境中存在 comfy kitchen int8 注意力模块时,"comfy kitchen attention" 选项才会列出。 +注意:仅当当前环境中存在 Comfy Kitchen INT8 attention 模块时,才会列出 "comfy kitchen attention" 选项。 ## 输出 | 输出名称 | 描述 | 数据类型 | |-------------|-------------|-----------| -| `MODEL` | 输入模型的副本,并已应用所选注意力后端。 | MODEL | +| `模型` | 输入模型的克隆,并已应用所选的注意力后端。 | MODEL | > 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ModelAttentionBackend/zh.md) --- -**Source fingerprint (SHA-256):** `4ba613cc0bf5b3e7f9effa895b98b3a3bd302e5d20e9d7e18d1633906c783244` +**Source fingerprint (SHA-256):** `4f6e4800c2a3bb09b47b7c8f0481e1b6de3070f57234e610df5d3ce60dfdb309` diff --git a/comfyui_embedded_docs/docs/ModelPatchLoader/ar.md b/comfyui_embedded_docs/docs/ModelPatchLoader/ar.md index 5433283cf..52dfd5ddd 100644 --- a/comfyui_embedded_docs/docs/ModelPatchLoader/ar.md +++ b/comfyui_embedded_docs/docs/ModelPatchLoader/ar.md @@ -1,20 +1,20 @@ # ModelPatchLoader -يحمّل عقدة ModelPatchLoader ملف تصحيح النموذج من مجلد `model_patches` ويجهّزه للاستخدام في سير العمل. يكتشف تلقائيًا نوع التصحيح الموجود داخل الملف، ويبني البنية المطابقة، ويحمّل الأوزان المحفوظة، ثم يغلّف كل شيء في مصحح نماذج (ModelPatcher) بحيث يمكن تطبيقه على نماذج أخرى. يدعم العديد من تنسيقات التصحيح المتخصصة، بما في ذلك فروع ControlNet الإضافية، ونماذج تضمين الميزات (feature embedder)، والمحولات (adapters)، والوحدات المشابهة. +عقدة ModelPatchLoader تحمّل ملف تصحيح النموذج من مجلد `model_patches` وتجهّزه للاستخدام في سير العمل. تكتشف تلقائيًا نوع التصحيح الموجود في الملف، وتبني البنية المطابقة، وتحمّل الأوزان المحفوظة، وتغلّف كل ذلك في مُصحّح النموذج (ModelPatcher) بحيث يمكن تطبيقه على النماذج الأخرى. وهي تدعم العديد من تنسيقات التصحيح المتخصصة، بما في ذلك فروع ControlNet الإضافية، ونماذج تضمين الميزات، والمهايئات، والوحدات المشابهة. ## المدخلات | المعامل | الوصف | نوع البيانات | مطلوب | النطاق | | --- | --- | --- | --- | --- | -| `الاسم` | اسم ملف التصحيح الذي سيتم تحميله من مجلد model_patches. اختر أحد ملفات التصحيح المتاحة من القائمة. | COMBO | نعم | قائمة مولّدة ديناميكيًا بجميع ملفات تصحيح النماذج الموجودة في مجلد model_patches | +| `الاسم` | اسم ملف تصحيح النموذج المراد تحميله من مجلد model_patches. اختر أحد ملفات التصحيح المتاحة من القائمة. | COMBO | نعم | قائمة مولّدة ديناميكيًا بجميع ملفات تصحيح النموذج الموجودة في مجلد `model_patches` | -ملاحظة: هذه العقدة مُعلَّمة بأنها تجريبية. يتم اكتشاف نوع التصحيح تلقائيًا من محتويات الملف، لذلك لا حاجة لتحديد النوع يدويًا. +ملاحظة: هذه العقدة مُعلّمة كتجريبية. يتم اكتشاف نوع التصحيح تلقائيًا من محتويات الملف، لذا لا حاجة لتحديد نوع يدويًا. ## المخرجات | اسم المخرج | الوصف | نوع البيانات | | --- | --- | --- | -| `MODEL_PATCH` | تصحيح النموذج المحمّل ملفوفًا في ModelPatcher، جاهز للتطبيق على نموذج في سير العمل. | MODEL_PATCH | +| `MODEL_PATCH` | تصحيح النموذج المُحمّل الملفوف في مُصحّح النموذج (ModelPatcher)، وجاهز للتطبيق على نموذج في سير العمل. | MODEL_PATCH | > تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ModelPatchLoader/ar.md) diff --git a/comfyui_embedded_docs/docs/ModelPatchLoader/en.md b/comfyui_embedded_docs/docs/ModelPatchLoader/en.md index 215105df7..79f6b73de 100644 --- a/comfyui_embedded_docs/docs/ModelPatchLoader/en.md +++ b/comfyui_embedded_docs/docs/ModelPatchLoader/en.md @@ -6,7 +6,7 @@ The ModelPatchLoader node loads a model patch file from the `model_patches` fold | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `name` | The filename of the model patch to load from the model_patches directory. Select one of the available patch files from the list. | COMBO | Yes | Dynamically generated list of all model patch files found in the model_patches folder | +| `name` | The filename of the model patch to load from the model_patches directory. Select one of the available patch files from the list. | COMBO | Yes | Dynamically generated list of all model patch files found in the `model_patches` folder | Note: This node is marked as experimental. The patch type is detected automatically from the file contents, so no manual type selection is required. diff --git a/comfyui_embedded_docs/docs/ModelPatchLoader/es.md b/comfyui_embedded_docs/docs/ModelPatchLoader/es.md index b580aeef0..1644a5081 100644 --- a/comfyui_embedded_docs/docs/ModelPatchLoader/es.md +++ b/comfyui_embedded_docs/docs/ModelPatchLoader/es.md @@ -1,20 +1,20 @@ # Cargador de Parches de Modelo -El nodo ModelPatchLoader carga un archivo de parche de modelo desde la carpeta `model_patches` y lo prepara para usarlo en un flujo de trabajo. Detecta automáticamente el tipo de parche contenido en el archivo, construye la arquitectura correspondiente, carga los pesos guardados y envuelve todo en un model patcher para que pueda aplicarse a otros modelos. Admite muchos formatos de parche especializados, incluidas ramas adicionales de ControlNet, modelos de incrustación de características (*feature embedder*), adaptadores y módulos similares. +El nodo ModelPatchLoader carga un archivo de parche de modelo desde la carpeta `model_patches` y lo prepara para su uso en un flujo de trabajo. Detecta automáticamente el tipo de parche contenido en el archivo, construye la arquitectura correspondiente, carga los pesos guardados y envuelve todo en un model patcher para que pueda aplicarse a otros modelos. Admite muchos formatos de parche especializados, incluidas ramas extra de ControlNet, modelos de embedders de características, adaptadores y módulos similares. ## Entradas -| Parámetro | Descripción | Tipo de dato | Requerido | Rango | +| Parámetro | Descripción | Tipo de datos | Requerido | Rango | | --- | --- | --- | --- | --- | -| `nombre` | El nombre del archivo del parche de modelo que se cargará desde el directorio `model_patches`. Seleccione uno de los archivos de parche disponibles en la lista. | COMBO | Sí | Lista generada dinámicamente de todos los archivos de parche de modelo encontrados en la carpeta `model_patches` | +| `nombre` | El nombre del archivo de parche de modelo que se cargará desde el directorio model_patches. Seleccione uno de los archivos de parche disponibles en la lista. | COMBO | Sí | Lista generada dinámicamente de todos los archivos de parche de modelo encontrados en la carpeta `model_patches` | -Nota: Este nodo está marcado como experimental. El tipo de parche se detecta automáticamente a partir del contenido del archivo, por lo que no se requiere ninguna selección manual de tipo. +Nota: Este nodo está marcado como experimental. El tipo de parche se detecta automáticamente a partir del contenido del archivo, por lo que no se requiere selección manual del tipo. ## Salidas -| Nombre de salida | Descripción | Tipo de dato | +| Nombre de salida | Descripción | Tipo de datos | | --- | --- | --- | -| `MODEL_PATCH` | El parche de modelo cargado envuelto en un `ModelPatcher`, listo para aplicarse a un modelo en el flujo de trabajo | MODEL_PATCH | +| `MODEL_PATCH` | El parche de modelo cargado, envuelto en un ModelPatcher, listo para aplicarse a un modelo en el flujo de trabajo | MODEL_PATCH | > 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/ModelPatchLoader/es.md) diff --git a/comfyui_embedded_docs/docs/ModelPatchLoader/fa.md b/comfyui_embedded_docs/docs/ModelPatchLoader/fa.md index f21dd248b..dd1e32448 100644 --- a/comfyui_embedded_docs/docs/ModelPatchLoader/fa.md +++ b/comfyui_embedded_docs/docs/ModelPatchLoader/fa.md @@ -1,20 +1,20 @@ # ModelPatchLoader -گره ModelPatchLoader فایل پچ مدل را از پوشه `model_patches` بارگذاری کرده و آن را برای استفاده در یک گردش کار آماده می‌کند. این گره به‌طور خودکار نوع پچ موجود در فایل را تشخیص می‌دهد، معماری соответ را می‌سازد، وزن‌های ذخیره‌شده را بارگذاری می‌کند و همه چیز را در یک model patcher قرار می‌دهد تا بتواند روی مدل‌های دیگر اعمال شود. این گره از بسیاری از فرمت‌های پچ تخصصی، از جمله شاخه‌های اضافی ControlNet، مدل‌های feature embedder، adapterها و ماژول‌های مشابه پشتیبانی می‌کند. +گره ModelPatchLoader یک فایل پچ مدل را از پوشه `model_patches` بارگذاری می‌کند و آن را برای استفاده در یک گردش‌کار آماده می‌سازد. این گره به‌طور خودکار نوع پچ موجود در فایل را تشخیص می‌دهد، معماری منطبق را می‌سازد، وزن‌های ذخیره‌شده را بارگذاری می‌کند و همه چیز را در یک ModelPatcher قرار می‌دهد تا بتوان آن را روی مدل‌های دیگر اعمال کرد. از بسیاری از قالب‌های تخصصی پچ پشتیبانی می‌کند، از جمله شاخه‌های اضافی ControlNet، مدل‌های تعبیه‌گر ویژگی، آداپترها و ماژول‌های مشابه. ## ورودی‌ها | پارامتر | توضیحات | نوع داده | الزامی | محدوده | | --- | --- | --- | --- | --- | -| `نام` | نام فایل پچ مدل برای بارگذاری از دایرکتوری `model_patches`. یکی از فایل‌های پچ موجود را از لیست انتخاب کنید. | COMBO | بله | لیست تولیدشده به‌صورت پویا از تمام فایل‌های پچ مدل یافت‌شده در پوشه `model_patches` | +| `نام` | نام فایل پچ مدل برای بارگذاری از پوشه `model_patches`. یکی از فایل‌های پچ موجود را از فهرست انتخاب کنید. | COMBO | بله | فهرست پویا از تمام فایل‌های پچ مدل موجود در پوشه `model_patches` | -نکته: این گره به‌صورت آزمایشی (experimental) علامت‌گذاری شده است. نوع پچ به‌طور خودکار از محتویات فایل تشخیص داده می‌شود، بنابراین نیازی به انتخاب دستی نوع نیست. +توجه: این گره آزمایشی علامت‌گذاری شده است. نوع پچ به‌صورت خودکار از محتویات فایل تشخیص داده می‌شود، بنابراین نیازی به انتخاب دستی نوع نیست. ## خروجی‌ها | نام خروجی | توضیحات | نوع داده | | --- | --- | --- | -| `MODEL_PATCH` | پچ مدل بارگذاری‌شده که در یک ModelPatcher قرار گرفته و آماده اعمال روی یک مدل در گردش کار است. | MODEL_PATCH | +| `MODEL_PATCH` | پچ مدل بارگذاری‌شده که در یک ModelPatcher قرار گرفته است و آماده اعمال روی یک مدل در گردش‌کار است | MODEL_PATCH | > این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ModelPatchLoader/fa.md) diff --git a/comfyui_embedded_docs/docs/ModelPatchLoader/fr.md b/comfyui_embedded_docs/docs/ModelPatchLoader/fr.md index 5f6a3e283..17fee3fa5 100644 --- a/comfyui_embedded_docs/docs/ModelPatchLoader/fr.md +++ b/comfyui_embedded_docs/docs/ModelPatchLoader/fr.md @@ -1,20 +1,20 @@ # ModelPatchLoader -Le nœud ModelPatchLoader charge un fichier de patch de modèle depuis le dossier `model_patches` et le prépare pour une utilisation dans un flux de travail. Il détecte automatiquement le type de patch contenu dans le fichier, construit l'architecture correspondante, charge les poids sauvegardés et enveloppe le tout dans un model patcher afin de pouvoir l'appliquer à d'autres modèles. Il prend en charge de nombreux formats de patch spécialisés, notamment les branches ControlNet supplémentaires, les modèles de plongement de caractéristiques, les adaptateurs et modules similaires. +Le nœud ModelPatchLoader charge un fichier de patch de modèle depuis le dossier `model_patches` et le prépare pour une utilisation dans un workflow. Il détecte automatiquement le type de patch contenu dans le fichier, construit l'architecture correspondante, charge les poids sauvegardés et encapsule le tout dans un model patcher afin de pouvoir l'appliquer à d'autres modèles. Il prend en charge de nombreux formats de patch spécialisés, notamment les branches ControlNet supplémentaires, les modèles d'extraction de caractéristiques, les adaptateurs et modules similaires. ## Entrées | Paramètre | Description | Type de données | Requis | Plage | | --- | --- | --- | --- | --- | -| `nom` | Le nom du fichier de patch de modèle à charger depuis le dossier model_patches. Sélectionnez l'un des fichiers de patch disponibles dans la liste. | COMBO | Oui | Liste générée dynamiquement de tous les fichiers de patch de modèle trouvés dans le dossier model_patches | +| `nom` | Le nom du fichier de patch de modèle à charger depuis le répertoire model_patches. Sélectionnez l'un des fichiers de patch disponibles dans la liste. | COMBO | Oui | Liste générée dynamiquement de tous les fichiers de patch de modèle trouvés dans le dossier `model_patches` | -Remarque : Ce nœud est marqué comme expérimental. Le type de patch est détecté automatiquement à partir du contenu du fichier, aucune sélection manuelle du type n'est donc nécessaire. +Remarque : Ce nœud est marqué comme expérimental. Le type de patch est détecté automatiquement à partir du contenu du fichier, aucune sélection manuelle du type n'est donc requise. ## Sorties | Nom de sortie | Description | Type de données | | --- | --- | --- | -| `MODEL_PATCH` | Le patch de modèle chargé, enveloppé dans un ModelPatcher, prêt à être appliqué à un modèle dans le flux de travail | MODEL_PATCH | +| `MODEL_PATCH` | Le patch de modèle chargé, encapsulé dans un ModelPatcher et prêt à être appliqué à un modèle dans le workflow | MODEL_PATCH | > 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/ModelPatchLoader/fr.md) diff --git a/comfyui_embedded_docs/docs/ModelPatchLoader/ja.md b/comfyui_embedded_docs/docs/ModelPatchLoader/ja.md index d97ea9448..2c4d1e816 100644 --- a/comfyui_embedded_docs/docs/ModelPatchLoader/ja.md +++ b/comfyui_embedded_docs/docs/ModelPatchLoader/ja.md @@ -1,12 +1,12 @@ # モデルパッチローダー -ModelPatchLoader ノードは、`model_patches` フォルダからモデルパッチファイルを読み込み、ワークフローで使用できるように準備します。このノードは、ファイルに含まれるパッチの種類を自動的に検出し、対応するアーキテクチャを構築して、保存された重みを読み込み、他のモデルに適用できるようにすべてを ModelPatcher でラップします。また、追加の ControlNet ブランチ、特徴エンベッダーモデル、アダプター、類似のモジュールなど、多くの専門的なパッチ形式をサポートしています。 +ModelPatchLoader ノードは、`model_patches` フォルダからモデルパッチファイルを読み込み、ワークフローで使用できるように準備します。ファイルに含まれるパッチの種類を自動的に検出し、対応するアーキテクチャを構築して、保存された重みを読み込み、すべてをモデルパッチャー(ModelPatcher)にラップして、他のモデルに適用できるようにします。このノードは、追加の ControlNet ブランチ、特徴量エンベッダーモデル、アダプター、類似のモジュールなど、多くの特殊なパッチ形式をサポートしています。 ## 入力 | パラメータ | 説明 | データ型 | 必須 | 範囲 | | --- | --- | --- | --- | --- | -| `名前` | `model_patches` ディレクトリから読み込むモデルパッチのファイル名です。利用可能なパッチファイルをリストから選択してください。 | COMBO | はい | `model_patches` フォルダ内で見つかったすべてのモデルパッチファイルの動的生成リスト | +| `名前` | model_patches ディレクトリから読み込むモデルパッチのファイル名です。利用可能なパッチファイルのリストから選択してください。 | COMBO | はい | `model_patches` フォルダ内にあるすべてのモデルパッチファイルの動的生成リストです。 | 注:このノードは実験的としてマークされています。パッチの種類はファイルの内容から自動的に検出されるため、手動での種類選択は不要です。 @@ -14,7 +14,7 @@ ModelPatchLoader ノードは、`model_patches` フォルダからモデルパ | 出力名 | 説明 | データ型 | | --- | --- | --- | -| `MODEL_PATCH` | ワークフロー内のモデルに適用できるよう ModelPatcher にラップされた、読み込み済みのモデルパッチです。 | MODEL_PATCH | +| `MODEL_PATCH` | ワークフロー内のモデルに適用できるように、ModelPatcher にラップされたモデルパッチです。 | MODEL_PATCH | > このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ModelPatchLoader/ja.md) diff --git a/comfyui_embedded_docs/docs/ModelPatchLoader/ko.md b/comfyui_embedded_docs/docs/ModelPatchLoader/ko.md index 605d53e28..7f2652ebf 100644 --- a/comfyui_embedded_docs/docs/ModelPatchLoader/ko.md +++ b/comfyui_embedded_docs/docs/ModelPatchLoader/ko.md @@ -1,20 +1,20 @@ # 모델 패치 로더 -The `ModelPatchLoader` 노드는 `model_patches` 폴더에서 모델 패치 파일을 로드하여 워크플로에서 사용할 수 있도록 준비합니다. 파일에 포함된 패치 유형을 자동으로 감지하고, 이에 맞는 아키텍처를 구성한 다음 저장된 가중치를 로드하고, 모든 것을 모델 패처(ModelPatcher)로 래핑하여 다른 모델에 적용할 수 있게 합니다. 추가 ControlNet 분기, 특성 임베더(feature embedder) 모델, 어댑터 및 유사한 모듈을 포함한 다양한 특수 패치 형식을 지원합니다. +ModelPatchLoader 노드는 `model_patches` 폴더에서 모델 패치 파일을 불러와 워크플로우에서 사용할 수 있도록 준비합니다. 파일에 포함된 패치 유형을 자동으로 감지하고, 해당하는 아키텍처를 구축한 다음 저장된 가중치를 불러와 모든 것을 모델 패처에 감싸서 다른 모델에 적용할 수 있게 합니다. 추가 ControlNet 브랜치, 특징 임베더 모델, 어댑터 및 유사한 모듈을 포함한 다양한 특수 패치 형식을 지원합니다. ## 입력 -| 매개변수 | 설명 | 데이터 유형 | 필수 | 범위 | +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | | --- | --- | --- | --- | --- | -| `이름` | `model_patches` 디렉터리에서 로드할 모델 패치의 파일 이름입니다. 목록에서 사용 가능한 패치 파일 중 하나를 선택합니다. | COMBO | 예 | `model_patches` 폴더에서 발견된 모든 모델 패치 파일의 동적 생성 목록 | +| `이름` | model_patches 디렉터리에서 불러올 모델 패치의 파일 이름입니다. 목록에서 사용 가능한 패치 파일 중 하나를 선택하십시오. | COMBO | 예 | `model_patches` 폴더에서 발견된 모든 모델 패치 파일의 동적 생성 목록 | 참고: 이 노드는 실험적 기능으로 표시되어 있습니다. 패치 유형은 파일 내용에서 자동으로 감지되므로 수동으로 유형을 선택할 필요가 없습니다. ## 출력 -| 출력 이름 | 설명 | 데이터 유형 | +| 출력 이름 | 설명 | 데이터 타입 | | --- | --- | --- | -| `MODEL_PATCH` | 로드된 모델 패치가 ModelPatcher에 래핑되어 워크플로의 모델에 적용할 준비가 된 상태입니다. | MODEL_PATCH | +| `MODEL_PATCH` | 로드된 모델 패치를 ModelPatcher로 감싼 것으로, 워크플로우의 모델에 적용할 준비가 된 상태입니다. | MODEL_PATCH | > 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ModelPatchLoader/ko.md) diff --git a/comfyui_embedded_docs/docs/ModelPatchLoader/pt-BR.md b/comfyui_embedded_docs/docs/ModelPatchLoader/pt-BR.md index 5c6b1f1fe..de0ed0a81 100644 --- a/comfyui_embedded_docs/docs/ModelPatchLoader/pt-BR.md +++ b/comfyui_embedded_docs/docs/ModelPatchLoader/pt-BR.md @@ -1,20 +1,20 @@ # ModelPatchLoader -O nó ModelPatchLoader carrega um arquivo de patch de modelo da pasta `model_patches` e prepara-o para uso em um fluxo de trabalho. Ele detecta automaticamente o tipo de patch contido no arquivo, constrói a arquitetura correspondente, carrega os pesos salvos e envolve tudo em um patcher de modelo, permitindo que seja aplicado a outros modelos. Ele suporta muitos formatos de patch especializados, incluindo ramos adicionais do ControlNet, modelos de embedder de características, adaptadores e módulos semelhantes. +O nó ModelPatchLoader carrega um arquivo de patch de modelo da pasta `model_patches` e o prepara para uso em um fluxo de trabalho. Ele detecta automaticamente o tipo de patch contido no arquivo, constrói a arquitetura correspondente, carrega os pesos salvos e envolve tudo em um model patcher para que possa ser aplicado a outros modelos. Ele suporta muitos formatos de patch especializados, incluindo ramificações extras de ControlNet, modelos de incorporação de recursos, adaptadores e módulos semelhantes. ## Entradas -| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Faixa | | --- | --- | --- | --- | --- | -| `nome` | O nome do arquivo do patch de modelo a ser carregado da pasta model_patches. Selecione um dos arquivos de patch disponíveis na lista. | COMBO | Sim | Lista gerada dinamicamente de todos os arquivos de patch de modelo encontrados na pasta model_patches | +| `nome` | O nome do arquivo do patch de modelo a ser carregado do diretório model_patches. Selecione um dos arquivos de patch disponíveis na lista. | COMBO | Sim | Lista gerada dinamicamente de todos os arquivos de patch de modelo encontrados na pasta `model_patches` | -Nota: Este nó está marcado como experimental. O tipo de patch é detectado automaticamente a partir do conteúdo do arquivo, portanto, não há necessidade de seleção manual do tipo. +Nota: Este nó está marcado como experimental. O tipo de patch é detectado automaticamente a partir do conteúdo do arquivo, portanto, nenhuma seleção manual de tipo é necessária. ## Saídas | Nome da Saída | Descrição | Tipo de Dados | | --- | --- | --- | -| `MODEL_PATCH` | O patch de modelo carregado envolto em um ModelPatcher, pronto para ser aplicado a um modelo no fluxo de trabalho | MODEL_PATCH | +| `MODEL_PATCH` | O patch de modelo carregado encapsulado em um ModelPatcher, pronto para ser aplicado a um modelo no fluxo de trabalho | MODEL_PATCH | > 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/ModelPatchLoader/pt-BR.md) diff --git a/comfyui_embedded_docs/docs/ModelPatchLoader/ru.md b/comfyui_embedded_docs/docs/ModelPatchLoader/ru.md index fc768b7f2..a8bffea1c 100644 --- a/comfyui_embedded_docs/docs/ModelPatchLoader/ru.md +++ b/comfyui_embedded_docs/docs/ModelPatchLoader/ru.md @@ -1,20 +1,20 @@ # ModelPatchLoader -Узел ModelPatchLoader загружает файл патча модели из папки `model_patches` и подготавливает его к использованию в рабочем процессе. Он автоматически определяет тип патча, содержащегося в файле, создаёт соответствующую архитектуру, загружает сохранённые веса и упаковывает всё в патчер модели, чтобы его можно было применить к другим моделям. Поддерживаются многие специализированные форматы патчей, включая дополнительные ветви ControlNet, модели эмбеддеров признаков, адаптеры и аналогичные модули. +Узел **ModelPatchLoader** загружает файл патча модели из папки `model_patches` и подготавливает его к использованию в рабочем процессе. Узел автоматически определяет тип патча, содержащегося в файле, создаёт соответствующую архитектуру, загружает сохранённые веса и заключает всё в обёртку ModelPatcher, чтобы патч можно было применять к другим моделям. Он поддерживает множество специализированных форматов патчей, включая дополнительные ветви ControlNet, модели эмбеддеров признаков, адаптеры и подобные модули. ## Входы | Параметр | Описание | Тип данных | Обязательный | Диапазон | | --- | --- | --- | --- | --- | -| `название` | Имя файла патча модели для загрузки из каталога model_patches. Выберите один из доступных файлов патчей из списка. | COMBO | Да | Динамически генерируемый список всех файлов патчей моделей, найденных в папке model_patches | +| `название` | Имя файла патча модели, загружаемого из каталога model_patches. Выберите один из доступных файлов патчей из списка. | COMBO | Да | Динамически генерируемый список всех файлов патчей модели, найденных в папке `model_patches` | -Примечание: этот узел помечен как экспериментальный. Тип патча определяется автоматически по содержимому файла, поэтому ручной выбор типа не требуется. +Примечание: этот узел помечен как экспериментальный. Тип патча определяется автоматически из содержимого файла, поэтому ручной выбор типа не требуется. ## Выходы | Имя выхода | Описание | Тип данных | | --- | --- | --- | -| `MODEL_PATCH` | Загруженный патч модели, упакованный в ModelPatcher, готовый к применению к модели в рабочем процессе | MODEL_PATCH | +| `MODEL_PATCH` | Загруженный патч модели в обёртке ModelPatcher, готовый к применению к модели в рабочем процессе | MODEL_PATCH | > Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ModelPatchLoader/ru.md) diff --git a/comfyui_embedded_docs/docs/ModelPatchLoader/tr.md b/comfyui_embedded_docs/docs/ModelPatchLoader/tr.md index c602a77c5..784f70a40 100644 --- a/comfyui_embedded_docs/docs/ModelPatchLoader/tr.md +++ b/comfyui_embedded_docs/docs/ModelPatchLoader/tr.md @@ -1,20 +1,20 @@ # ModelPatchLoader -ModelPatchLoader düğümü, `model_patches` klasöründen bir model yaması dosyası yükler ve bunu bir iş akışında kullanılmak üzere hazırlar. Dosyada bulunan yamanın türünü otomatik olarak algılar, eşleşen mimariyi oluşturur, kayıtlı ağırlıkları yükler ve diğer modellere uygulanabilmesi için her şeyi bir ModelPatcher'a sarar. Ek ControlNet dalları, özellik katıştırıcı (feature embedder) modelleri, bağdaştırıcılar ve benzer modüller dahil olmak üzere birçok özel yama biçimini destekler. +ModelPatchLoader düğümü, `model_patches` klasöründen bir model yaması dosyası yükler ve iş akışında kullanılmak üzere hazırlar. Dosyanın içerdiği yamanın türünü otomatik olarak algılar, buna uygun mimariyi oluşturur, kayıtlı ağırlıkları yükler ve diğer modellere uygulanabilmesi için her şeyi bir ModelPatcher ile sarmalar. Ek ControlNet dalları, öznitelik gömücü modeller, adaptörler ve benzeri modüller dahil birçok özel yama biçimini destekler. ## Girdiler | Parametre | Açıklama | Veri Türü | Zorunlu | Aralık | | --- | --- | --- | --- | --- | -| `ad` | `model_patches` dizininden yüklenecek model yaması dosyasının adı. Listede bulunan mevcut yama dosyalarından birini seçin. | COMBO | Evet | `model_patches` klasöründe bulunan tüm model yaması dosyalarının dinamik olarak oluşturulan listesi | +| `ad` | model_patches dizininden yüklenecek model yaması dosyasının adı. Listede bulunan yama dosyalarından birini seçin. | COMBO | Evet | `model_patches` klasöründe bulunan tüm model yaması dosyalarının dinamik olarak oluşturulan listesi | -Not: Bu düğüm deneysel olarak işaretlenmiştir. Yama türü dosya içeriğinden otomatik olarak algılanır, bu nedenle manuel tür seçimi gerekmez. +Not: Bu düğüm deneysel olarak işaretlenmiştir. Yama türü dosya içeriğinden otomatik olarak algılanır; bu nedenle elle bir tür seçimi gerekmez. ## Çıktılar | Çıktı Adı | Açıklama | Veri Türü | | --- | --- | --- | -| `MODEL_PATCH` | ModelPatcher ile sarılmış, iş akışındaki bir modele uygulanmaya hazır yüklenmiş model yaması | MODEL_PATCH | +| `MODEL_PATCH` | İş akışındaki bir modele uygulanmaya hazır, ModelPatcher ile sarmalanmış yüklenmiş model yaması | MODEL_PATCH | > 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/ModelPatchLoader/tr.md) diff --git a/comfyui_embedded_docs/docs/ModelPatchLoader/zh-TW.md b/comfyui_embedded_docs/docs/ModelPatchLoader/zh-TW.md index fb052d071..90e844b3b 100644 --- a/comfyui_embedded_docs/docs/ModelPatchLoader/zh-TW.md +++ b/comfyui_embedded_docs/docs/ModelPatchLoader/zh-TW.md @@ -1,20 +1,20 @@ # 模型修補載入器 -ModelPatchLoader 節點會從 `model_patches` 資料夾載入模型修補檔案,並將其準備好用於工作流程中。它會自動偵測檔案中包含的修補類型、建立相符的架構、載入已儲存的權重,並將所有內容包裝成模型修補器(ModelPatcher),以便套用到其他模型。它支援多種特殊修補格式,包括額外的 ControlNet 分支、特徵嵌入模型、適配器及類似模組。 +ModelPatchLoader 節點會從 `model_patches` 資料夾載入模型修補檔案,並準備好可在工作流程中使用。它會自動偵測檔案中所包含的修補類型、建立對應的架構、載入已儲存的權重,並將所有內容包裝在模型修補器中,以便套用到其他模型。此節點支援多種專門的修補格式,包括額外的 ControlNet 分支、特徵嵌入模型、適配器及類似模組。 ## 輸入 | 參數 | 描述 | 資料類型 | 必填 | 範圍 | | --- | --- | --- | --- | --- | -| `名稱` | 要從 model_patches 目錄載入的模型修補檔檔名。請從清單中選取其中一個可用的修補檔案。 | COMBO | 是 | 動態產生自 model_patches 資料夾中所有模型修補檔案的清單 | +| `名稱` | 要從 model_patches 目錄載入的模型修補檔案名稱。從清單中選擇一個可用的修補檔案。 | COMBO | 是 | 動態產生的清單,列出 `model_patches` 資料夾中找到的所有模型修補檔案 | -注意:此節點標記為實驗性質。修補類型會從檔案內容自動偵測,因此無需手動選擇類型。 +注意:此節點已標記為實驗性。修補類型會根據檔案內容自動偵測,因此無需手動選取類型。 ## 輸出 -| 輸出名 | 描述 | 資料類型 | +| 輸出名稱 | 描述 | 資料類型 | | --- | --- | --- | -| `MODEL_PATCH` | 載入的模型修補已包裝在 ModelPatcher 中,可套用至工作流程中的模型 | MODEL_PATCH | +| `MODEL_PATCH` | 已載入並包裝在 ModelPatcher 中的模型修補,可隨時套用到工作流程中的模型 | MODEL_PATCH | > 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ModelPatchLoader/zh-TW.md) diff --git a/comfyui_embedded_docs/docs/ModelPatchLoader/zh.md b/comfyui_embedded_docs/docs/ModelPatchLoader/zh.md index 948e71fe2..9a0adc136 100644 --- a/comfyui_embedded_docs/docs/ModelPatchLoader/zh.md +++ b/comfyui_embedded_docs/docs/ModelPatchLoader/zh.md @@ -1,20 +1,20 @@ # 加载模型补丁 -ModelPatchLoader 节点从 `model_patches` 文件夹加载模型补丁文件,并准备在工作流中使用。它会自动检测文件中包含的补丁类型,构建匹配的架构,加载已保存的权重,并将所有内容包装在 ModelPatcher 中,以便应用到其他模型上。它支持许多专用补丁格式,包括额外的 ControlNet 分支、特征嵌入模型、适配器和类似模块。 +ModelPatchLoader 节点从 `model_patches` 文件夹加载模型补丁文件,并准备在工作流中使用。它会自动检测文件所含的补丁类型,构建匹配的架构,加载保存的权重,并将所有内容包装到一个模型补丁器(ModelPatcher)中,以便应用到其他模型上。它支持多种专用补丁格式,包括额外的 ControlNet 分支、特征嵌入模型、适配器及类似模块。 ## 输入 -| 参数 | 描述 | 数据类型 | 是否必填 | 范围 | +| 参数 | 描述 | 数据类型 | 必填 | 范围 | | --- | --- | --- | --- | --- | -| `名称` | 要从 model_patches 目录加载的模型补丁文件名。从列表中选择一个可用的补丁文件。 | COMBO | 是 | 动态生成的列表,包含 model_patches 文件夹中找到的所有模型补丁文件 | +| `名称` | 要从 model_patches 目录加载的模型补丁文件名。从列表中选择一个可用的补丁文件。 | COMBO | 是 | 动态生成的列表,包含 `model_patches` 文件夹中找到的所有模型补丁文件 | -注意:此节点标记为实验性。补丁类型会根据文件内容自动检测,因此无需手动选择类型。 +注意:此节点标记为实验性。补丁类型会自动从文件内容中检测,因此无需手动选择类型。 ## 输出 | 输出名称 | 描述 | 数据类型 | | --- | --- | --- | -| `MODEL_PATCH` | 已加载的模型补丁包装在 ModelPatcher 中,可供工作流中的模型使用 | MODEL_PATCH | +| `MODEL_PATCH` | 加载的模型补丁包装在 ModelPatcher 中,可随时应用于工作流中的模型 | MODEL_PATCH | > 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ModelPatchLoader/zh.md) diff --git a/comfyui_embedded_docs/docs/NormalizeImages/ar.md b/comfyui_embedded_docs/docs/NormalizeImages/ar.md index d106aecab..56bb18d10 100644 --- a/comfyui_embedded_docs/docs/NormalizeImages/ar.md +++ b/comfyui_embedded_docs/docs/NormalizeImages/ar.md @@ -1,15 +1,17 @@ # تطبيع الصور -تقوم هذه العقدة بتعديل قيم البكسل لصورة الإدخال باستخدام عملية تطبيع رياضية، حيث تطرح قيمة متوسط محددة من كل بكسل ثم تقسم الناتج على انحراف معياري محدد. تُعد هذه خطوة معالجة مسبقة شائعة لتجهيز بيانات الصور لنماذج تعلم الآلة الأخرى. إذا كانت صورة الإدخال تحتوي على قناة ألفا، فإنها تمر دون تغيير للحفاظ على الشفافية. +يقوم هذا العقد بضبط قيم البكسل لصورة مدخلة باستخدام عملية تطبيع رياضية. إذ يطرح قيمة متوسطة محددة من كل بكسل، ثم يقسم الناتج على انحراف معياري محدد. وهذه خطوة معالجة مسبقة شائعة لتجهيز بيانات الصور لاستخدامها في نماذج تعلّم آلي أخرى. ## المدخلات -| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +| المعامل | الوصف | نوع البيانات | إلزامي | النطاق | | --- | --- | --- | --- | --- | -| `image` | صورة الإدخال التي سيتم تطبيعها. | IMAGE | نعم | - | +| `image` | الصورة المدخلة المراد تطبيعها. | IMAGE | نعم | - | | `المتوسط` | قيمة المتوسط للتطبيع (الافتراضي: 0.5). | FLOAT | لا | 0.0 - 1.0 | | `الانحراف المعياري` | الانحراف المعياري للتطبيع (الافتراضي: 0.5). | FLOAT | لا | 0.001 - 1.0 | +ملاحظة: عندما تحتوي الصورة المدخلة على قناة ألفا (الشفافية)، لا يتم تطبيع قناة ألفا. وتُبقى كما هي دون تغيير في المخرجات لأن ألفا تخزّن الشفافية وليس اللون. + ## المخرجات | اسم المخرج | الوصف | نوع البيانات | @@ -19,4 +21,4 @@ > تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/NormalizeImages/ar.md) --- -**Source fingerprint (SHA-256):** `30c0587265754842d1e56d478b89e87c1d014fcaad01894a7a2f4a21fa17b83f` +**Source fingerprint (SHA-256):** `30c0587265754842ff7d1e5f339fc934b58d59bb3ba18716c2a1f9679f2d561d` diff --git a/comfyui_embedded_docs/docs/NormalizeImages/en.md b/comfyui_embedded_docs/docs/NormalizeImages/en.md index 7a5460a1f..763581cf7 100644 --- a/comfyui_embedded_docs/docs/NormalizeImages/en.md +++ b/comfyui_embedded_docs/docs/NormalizeImages/en.md @@ -1,22 +1,36 @@ # Normalize Image Colors -This node adjusts the pixel values of an input image using a mathematical normalization process. It subtracts a specified mean value from each pixel and then divides the result by a specified standard deviation. This is a common preprocessing step to prepare image data for other machine learning models. If the input image has an alpha channel, the alpha channel is passed through unchanged so transparency is preserved. +This node adjusts the pixel values of an input image using a mathematical normalization process. It subtracts a specified mean value from each pixel and then divides the result by a specified standard deviation. This is a common preprocessing step to prepare image data for other machine learning models. + +## Overview + +The Normalize Images node normalizes the colors of an input image by adjusting its pixel values based on a mean and standard deviation. This process is useful for standardizing image data before applying machine learning algorithms. ## Inputs | Parameter | Description | Data Type | Required | Range | -| --- | --- | --- | --- | --- | -| `image` | The input image to be normalized. | IMAGE | Yes | - | -| `mean` | Mean value for normalization (default: 0.5). | FLOAT | No | 0.0 - 1.0 | -| `std` | Standard deviation for normalization (default: 0.5). | FLOAT | No | 0.001 - 1.0 | +|-----------|-------------|-----------|----------|-------| +| `image` | The input image to be normalized. | IMAGE | Yes | - | +| `mean` | Mean value for normalization. | FLOAT | No | 0.0 - 1.0 (default: 0.5) | +| `std` | Standard deviation for normalization. | FLOAT | No | 0.001 - 1.0 (default: 0.5) | + +The `mean` and `std` parameters are used to normalize the pixel values of the input image. The default values for both parameters are set to 0.5, which is a common choice for normalization. + +Note: When the input image includes an alpha (transparency) channel, the alpha channel is not normalized. It is kept unchanged in the output because alpha stores transparency rather than color. ## Outputs | Output Name | Description | Data Type | -| --- | --- | --- | -| `image` | The resulting image after the normalization process has been applied. | IMAGE | +|-------------|-------------|-----------| +| `image` | The resulting image after the normalization process has been applied. | IMAGE | + +The output from the Normalize Images node is the normalized image. The pixel values are adjusted according to the specified mean and standard deviation, and the alpha channel (if present) is preserved. + +## Note + +The Normalize Images node is designed to handle any batch size of images, making it suitable for batch processing tasks. > 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/NormalizeImages/en.md) --- -**Source fingerprint (SHA-256):** `30c0587265754842d1e56d478b89e87c1d014fcaad01894a7a2f4a21fa17b83f` +**Source fingerprint (SHA-256):** `30c0587265754842ff7d1e5f339fc934b58d59bb3ba18716c2a1f9679f2d561d` diff --git a/comfyui_embedded_docs/docs/NormalizeImages/es.md b/comfyui_embedded_docs/docs/NormalizeImages/es.md index a5c6159ae..35951e670 100644 --- a/comfyui_embedded_docs/docs/NormalizeImages/es.md +++ b/comfyui_embedded_docs/docs/NormalizeImages/es.md @@ -1,14 +1,16 @@ # Normalizar Imágenes -Este nodo ajusta los valores de píxeles de una imagen de entrada mediante un proceso matemático de normalización. Resta un valor medio especificado a cada píxel y luego divide el resultado por una desviación estándar especificada. Este es un paso común de preprocesamiento para preparar datos de imagen para otros modelos de aprendizaje automático. Si la imagen de entrada tiene un canal alfa, este se mantiene sin cambios para preservar la transparencia. +Este nodo ajusta los valores de píxel de una imagen de entrada mediante un proceso de normalización matemática. Resta un valor medio específico a cada píxel y luego divide el resultado por una desviación estándar especificada. Este es un paso de preprocesamiento común para preparar datos de imagen para otros modelos de aprendizaje automático. ## Entradas | Parámetro | Descripción | Tipo de datos | Requerido | Rango | | --- | --- | --- | --- | --- | | `image` | La imagen de entrada que se va a normalizar. | IMAGE | Sí | - | -| `media` | Valor medio para la normalización (por defecto: 0.5). | FLOAT | No | 0.0 - 1.0 | -| `desviación estándar` | Desviación estándar para la normalización (por defecto: 0.5). | FLOAT | No | 0.001 - 1.0 | +| `media` | Valor medio para la normalización (predeterminado: 0.5). | FLOAT | No | 0.0 - 1.0 | +| `desviación estándar` | Desviación estándar para la normalización (predeterminado: 0.5). | FLOAT | No | 0.001 - 1.0 | + +Nota: Cuando la imagen de entrada incluye un canal alfa (transparencia), el canal alfa no se normaliza. Se mantiene sin cambios en la salida porque el alfa almacena transparencia en lugar de color. ## Salidas @@ -19,4 +21,4 @@ Este nodo ajusta los valores de píxeles de una imagen de entrada mediante un pr > 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/NormalizeImages/es.md) --- -**Source fingerprint (SHA-256):** `30c0587265754842d1e56d478b89e87c1d014fcaad01894a7a2f4a21fa17b83f` +**Source fingerprint (SHA-256):** `30c0587265754842ff7d1e5f339fc934b58d59bb3ba18716c2a1f9679f2d561d` diff --git a/comfyui_embedded_docs/docs/NormalizeImages/fa.md b/comfyui_embedded_docs/docs/NormalizeImages/fa.md index 253fc28ab..ed99e4800 100644 --- a/comfyui_embedded_docs/docs/NormalizeImages/fa.md +++ b/comfyui_embedded_docs/docs/NormalizeImages/fa.md @@ -1,22 +1,24 @@ # نرمال‌سازی تصاویر -این گره مقادیر پیکسل‌های یک تصویر ورودی را با استفاده از یک فرآیند نرمال‌سازی ریاضی تنظیم می‌کند. میانگین مشخصی را از هر پیکسل کم کرده و سپس نتیجه را بر انحراف معیار مشخصی تقسیم می‌کند. این یک مرحله پیش‌پردازش رایج برای آماده‌سازی داده‌های تصویری برای سایر مدل‌های یادگیری ماشین است. اگر تصویر ورودی کانال آلفا داشته باشد، کانال آلفا بدون تغییر منتقل می‌شود تا شفافیت حفظ شود. +این گره مقادیر پیکسل‌های یک تصویر ورودی را با استفاده از یک فرایند نرمال‌سازی ریاضی تنظیم می‌کند. یک مقدار میانگین مشخص را از هر پیکسل کم می‌کند و سپس نتیجه را بر یک انحراف معیار مشخص تقسیم می‌کند. این یک گام پیش‌پردازش رایج برای آماده‌سازی داده‌های تصویری جهت استفاده در سایر مدل‌های یادگیری ماشین است. ## ورودی‌ها | پارامتر | توضیحات | نوع داده | الزامی | محدوده | | --- | --- | --- | --- | --- | -| `image` | تصویر ورودی که باید نرمال‌سازی شود. | IMAGE | بله | - | +| `image` | تصویر ورودی برای نرمال‌سازی. | IMAGE | بله | - | | `mean` | مقدار میانگین برای نرمال‌سازی (پیش‌فرض: 0.5). | FLOAT | خیر | 0.0 - 1.0 | | `std` | انحراف معیار برای نرمال‌سازی (پیش‌فرض: 0.5). | FLOAT | خیر | 0.001 - 1.0 | +توجه: هنگامی که تصویر ورودی شامل کانال آلفا (شفافیت) باشد، کانال آلفا نرمال‌سازی نمی‌شود. در خروجی بدون تغییر باقی می‌ماند، زیرا آلفا نشان‌دهنده شفافیت است نه رنگ. + ## خروجی‌ها | نام خروجی | توضیحات | نوع داده | | --- | --- | --- | -| `images` | تصویر حاصل پس از اعمال فرآیند نرمال‌سازی. | IMAGE | +| `images` | تصویر حاصل پس از اعمال فرایند نرمال‌سازی. | IMAGE | > این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/NormalizeImages/fa.md) --- -**Source fingerprint (SHA-256):** `30c0587265754842d1e56d478b89e87c1d014fcaad01894a7a2f4a21fa17b83f` +**Source fingerprint (SHA-256):** `30c0587265754842ff7d1e5f339fc934b58d59bb3ba18716c2a1f9679f2d561d` diff --git a/comfyui_embedded_docs/docs/NormalizeImages/fr.md b/comfyui_embedded_docs/docs/NormalizeImages/fr.md index 27058a76d..ef9a808d1 100644 --- a/comfyui_embedded_docs/docs/NormalizeImages/fr.md +++ b/comfyui_embedded_docs/docs/NormalizeImages/fr.md @@ -1,22 +1,24 @@ # Normaliser les images -Ce nœud ajuste les valeurs de pixels d'une image d'entrée à l'aide d'un processus de normalisation mathématique. Il soustrait une valeur moyenne spécifiée de chaque pixel, puis divise le résultat par un écart type spécifié. Il s'agit d'une étape de prétraitement courante pour préparer les données d'image pour d'autres modèles d'apprentissage automatique. Si l'image d'entrée possède un canal alpha, celui-ci est conservé tel quel afin de préserver la transparence. +Ce nœud ajuste les valeurs de pixels d’une image d’entrée à l’aide d’un processus de normalisation mathématique. Il soustrait une valeur moyenne spécifiée de chaque pixel, puis divise le résultat par un écart type spécifié. Il s’agit d’une étape de prétraitement courante pour préparer les données d’image à d’autres modèles d’apprentissage automatique. ## Entrées | Paramètre | Description | Type de données | Requis | Plage | | --- | --- | --- | --- | --- | -| `image` | L'image d'entrée à normaliser. | IMAGE | Oui | - | +| `image` | L’image d’entrée à normaliser. | IMAGE | Oui | - | | `moyenne` | Valeur moyenne pour la normalisation (par défaut : 0.5). | FLOAT | Non | 0.0 - 1.0 | | `écart_type` | Écart type pour la normalisation (par défaut : 0.5). | FLOAT | Non | 0.001 - 1.0 | +Remarque : lorsque l’image d’entrée comprend un canal alpha (transparence), ce canal n’est pas normalisé. Il est conservé tel quel dans la sortie, car alpha stocke la transparence plutôt que la couleur. + ## Sorties | Nom de sortie | Description | Type de données | | --- | --- | --- | -| `images` | L'image résultante après application du processus de normalisation. | IMAGE | +| `images` | L’image résultante après application du processus de normalisation. | 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/NormalizeImages/fr.md) --- -**Source fingerprint (SHA-256):** `30c0587265754842d1e56d478b89e87c1d014fcaad01894a7a2f4a21fa17b83f` +**Source fingerprint (SHA-256):** `30c0587265754842ff7d1e5f339fc934b58d59bb3ba18716c2a1f9679f2d561d` diff --git a/comfyui_embedded_docs/docs/NormalizeImages/ja.md b/comfyui_embedded_docs/docs/NormalizeImages/ja.md index 39339029a..56875c5f8 100644 --- a/comfyui_embedded_docs/docs/NormalizeImages/ja.md +++ b/comfyui_embedded_docs/docs/NormalizeImages/ja.md @@ -1,22 +1,24 @@ # 画像を正規化 -このノードは、数学的な正規化プロセスを使用して入力画像のピクセル値を調整します。各ピクセルから指定された平均値を減算し、その結果を指定された標準偏差で除算します。これは、他の機械学習モデル用に画像データを準備するための一般的な前処理ステップです。入力画像にアルファチャンネルがある場合、アルファチャンネルは変更されずにそのまま維持され、透明度が保持されます。 +このノードは、数理的な正規化プロセスを使用して、入力画像のピクセル値を調整します。各ピクセルから指定された平均値を差し引き、その結果を指定された標準偏差で割ります。これは、他の機械学習モデル向けに画像データを準備するための一般的な前処理手順です。 ## 入力 | パラメータ | 説明 | データ型 | 必須 | 範囲 | | --- | --- | --- | --- | --- | -| `image` | 正規化する入力画像。 | IMAGE | はい | - | -| `平均値` | 正規化の平均値(デフォルト: 0.5)。 | FLOAT | いいえ | 0.0 - 1.0 | -| `標準偏差` | 正規化の標準偏差(デフォルト: 0.5)。 | FLOAT | いいえ | 0.001 - 1.0 | +| `image` | 正規化する入力画像です。 | IMAGE | はい | - | +| `平均値` | 正規化に使用する平均値です(デフォルト:0.5)。 | FLOAT | いいえ | 0.0 - 1.0 | +| `標準偏差` | 正規化に使用する標準偏差です(デフォルト:0.5)。 | FLOAT | いいえ | 0.001 - 1.0 | + +注:入力画像にアルファ(透明度)チャンネルが含まれる場合、そのアルファチャンネルは正規化されません。アルファは色ではなく透明度を格納するため、出力では変更されずに維持されます。 ## 出力 | 出力名 | 説明 | データ型 | | --- | --- | --- | -| `画像` | 正規化プロセスが適用された後の結果画像。 | IMAGE | +| `画像` | 正規化プロセスが適用された後の結果画像です。 | IMAGE | > このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/NormalizeImages/ja.md) --- -**Source fingerprint (SHA-256):** `30c0587265754842d1e56d478b89e87c1d014fcaad01894a7a2f4a21fa17b83f` +**Source fingerprint (SHA-256):** `30c0587265754842ff7d1e5f339fc934b58d59bb3ba18716c2a1f9679f2d561d` diff --git a/comfyui_embedded_docs/docs/NormalizeImages/ko.md b/comfyui_embedded_docs/docs/NormalizeImages/ko.md index 6318fa841..386dd5bbf 100644 --- a/comfyui_embedded_docs/docs/NormalizeImages/ko.md +++ b/comfyui_embedded_docs/docs/NormalizeImages/ko.md @@ -1,22 +1,24 @@ # 이미지 정규화 -이 노드는 수학적 정규화 과정을 사용하여 입력 이미지의 픽셀 값을 조정합니다. 각 픽셀에서 지정된 평균값을 뺀 다음 결과를 지정된 표준편차로 나눕니다. 이는 다른 머신러닝 모델을 위해 이미지 데이터를 준비하는 일반적인 전처리 단계입니다. 입력 이미지에 알파 채널이 있는 경우 알파 채널은 변경되지 않고 그대로 유지되어 투명도가 보존됩니다. +이 노드는 수학적 정규화 과정을 통해 입력 이미지의 픽셀 값을 조정합니다. 지정된 평균값을 각 픽셀에서 뺀 다음, 그 결과를 지정된 표준 편차로 나눕니다. 이는 다른 기계 학습 모델을 위해 이미지 데이터를 준비하는 일반적인 전처리 단계입니다. ## 입력 -| 매개변수 | 설명 | 데이터 타입 | 필수 여부 | 범위 | +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | | --- | --- | --- | --- | --- | | `image` | 정규화할 입력 이미지입니다. | IMAGE | 예 | - | -| `평균값` | 정규화를 위한 평균값입니다(기본값: 0.5). | FLOAT | 아니요 | 0.0 - 1.0 | -| `표준편차` | 정규화를 위한 표준편차입니다(기본값: 0.5). | FLOAT | 아니요 | 0.001 - 1.0 | +| `평균값` | 정규화에 사용할 평균값입니다(기본값: 0.5). | FLOAT | 아니요 | 0.0 - 1.0 | +| `표준편차` | 정규화에 사용할 표준 편차입니다(기본값: 0.5). | FLOAT | 아니요 | 0.001 - 1.0 | + +참고: 입력 이미지에 알파(투명도) 채널이 포함된 경우, 알파 채널은 정규화되지 않습니다. 알파는 색상이 아닌 투명도를 저장하므로 출력에서 변경되지 않은 상태로 유지됩니다. ## 출력 | 출력 이름 | 설명 | 데이터 타입 | | --- | --- | --- | -| `이미지` | 정규화 과정이 적용된 후의 결과 이미지입니다. | IMAGE | +| `이미지` | 정규화 과정이 적용된 결과 이미지입니다. | IMAGE | > 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/NormalizeImages/ko.md) --- -**Source fingerprint (SHA-256):** `30c0587265754842d1e56d478b89e87c1d014fcaad01894a7a2f4a21fa17b83f` +**Source fingerprint (SHA-256):** `30c0587265754842ff7d1e5f339fc934b58d59bb3ba18716c2a1f9679f2d561d` diff --git a/comfyui_embedded_docs/docs/NormalizeImages/pt-BR.md b/comfyui_embedded_docs/docs/NormalizeImages/pt-BR.md index fb59c7cd9..f1120babd 100644 --- a/comfyui_embedded_docs/docs/NormalizeImages/pt-BR.md +++ b/comfyui_embedded_docs/docs/NormalizeImages/pt-BR.md @@ -1,6 +1,6 @@ # Normalizar Imagens -Este nó ajusta os valores de pixel de uma imagem de entrada usando um processo matemático de normalização. Ele subtrai um valor médio especificado de cada pixel e depois divide o resultado por um desvio padrão especificado. Esta é uma etapa comum de pré-processamento para preparar dados de imagem para outros modelos de aprendizado de máquina. Se a imagem de entrada tiver um canal alfa, ele será mantido inalterado para preservar a transparência. +Este nó ajusta os valores de pixels de uma imagem de entrada usando um processo matemático de normalização. Ele subtrai um valor médio especificado de cada pixel e depois divide o resultado por um desvio padrão especificado. Esta é uma etapa comum de pré-processamento para preparar dados de imagem para outros modelos de aprendizado de máquina. ## Entradas @@ -10,6 +10,8 @@ Este nó ajusta os valores de pixel de uma imagem de entrada usando um processo | `mean` | Valor médio para normalização (padrão: 0.5). | FLOAT | Não | 0.0 - 1.0 | | `std` | Desvio padrão para normalização (padrão: 0.5). | FLOAT | Não | 0.001 - 1.0 | +Nota: Quando a imagem de entrada inclui um canal alfa (transparência), o canal alfa não é normalizado. Ele é mantido inalterado na saída porque o alfa armazena transparência em vez de cor. + ## Saídas | Nome da Saída | Descrição | Tipo de Dados | @@ -19,4 +21,4 @@ Este nó ajusta os valores de pixel de uma imagem de entrada usando um processo > 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/NormalizeImages/pt-BR.md) --- -**Source fingerprint (SHA-256):** `30c0587265754842d1e56d478b89e87c1d014fcaad01894a7a2f4a21fa17b83f` +**Source fingerprint (SHA-256):** `30c0587265754842ff7d1e5f339fc934b58d59bb3ba18716c2a1f9679f2d561d` diff --git a/comfyui_embedded_docs/docs/NormalizeImages/ru.md b/comfyui_embedded_docs/docs/NormalizeImages/ru.md index 81e2a8a75..248500edb 100644 --- a/comfyui_embedded_docs/docs/NormalizeImages/ru.md +++ b/comfyui_embedded_docs/docs/NormalizeImages/ru.md @@ -1,15 +1,17 @@ # Нормализовать изображения -Этот узел корректирует значения пикселей входного изображения с помощью математического процесса нормализации. Он вычитает заданное среднее значение из каждого пикселя, а затем делит результат на заданное стандартное отклонение. Это распространённый этап предварительной обработки для подготовки данных изображения для других моделей машинного обучения. Если входное изображение содержит альфа-канал, он передаётся без изменений, сохраняя прозрачность. +Этот узел корректирует значения пикселей входного изображения с помощью математического процесса нормализации. Он вычитает заданное среднее значение из каждого пикселя, а затем делит результат на заданное стандартное отклонение. Это распространённый этап предварительной обработки для подготовки данных изображения к использованию в других моделях машинного обучения. ## Входы -| Параметр | Описание | Тип данных | Требуется | Диапазон | +| Параметр | Описание | Тип данных | Обязательный | Диапазон | | --- | --- | --- | --- | --- | | `image` | Входное изображение для нормализации. | IMAGE | Да | - | | `среднее` | Среднее значение для нормализации (по умолчанию: 0.5). | FLOAT | Нет | 0.0 - 1.0 | | `стандартное отклонение` | Стандартное отклонение для нормализации (по умолчанию: 0.5). | FLOAT | Нет | 0.001 - 1.0 | +Примечание: Если входное изображение содержит альфа-канал (прозрачность), альфа-канал не нормализуется. Он остаётся неизменным в выходных данных, поскольку альфа хранит прозрачность, а не цвет. + ## Выходы | Имя выхода | Описание | Тип данных | @@ -19,4 +21,4 @@ > Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/NormalizeImages/ru.md) --- -**Source fingerprint (SHA-256):** `30c0587265754842d1e56d478b89e87c1d014fcaad01894a7a2f4a21fa17b83f` +**Source fingerprint (SHA-256):** `30c0587265754842ff7d1e5f339fc934b58d59bb3ba18716c2a1f9679f2d561d` diff --git a/comfyui_embedded_docs/docs/NormalizeImages/tr.md b/comfyui_embedded_docs/docs/NormalizeImages/tr.md index da13daff5..5e6a2073c 100644 --- a/comfyui_embedded_docs/docs/NormalizeImages/tr.md +++ b/comfyui_embedded_docs/docs/NormalizeImages/tr.md @@ -1,22 +1,24 @@ # Görüntüleri Normalleştir -Bu düğüm, girdi görüntüsünün piksel değerlerini matematiksel bir normalizasyon süreci kullanarak ayarlar. Her pikselden belirtilen ortalama (mean) değerini çıkarır ve sonucu belirtilen standart sapmaya (std) böler. Bu, görüntü verilerini diğer makine öğrenimi modelleri için hazırlamak amacıyla yapılan yaygın bir ön işleme adımıdır. Girdi görüntüsü bir alfa kanalı içeriyorsa, şeffaflığı korumak için alfa kanalı değiştirilmeden aktarılır. +Bu düğüm, matematiksel bir normalleştirme süreci kullanarak girdi görüntüsünün piksel değerlerini ayarlar. Her pikselden belirtilen ortalama değeri çıkarır ve ardından sonucu belirtilen standart sapmaya böler. Bu, görüntü verilerini diğer makine öğrenimi modelleri için hazırlamak amacıyla yapılan yaygın bir ön işleme adımıdır. ## Girdiler -| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +| Parametre | Açıklama | Veri Türü | Zorunlu | Aralık | | --- | --- | --- | --- | --- | -| `image` | Normalize edilecek girdi görüntüsü. | IMAGE | Evet | - | -| `ortalama` | Normalizasyon için ortalama değeri (varsayılan: 0.5). | FLOAT | Hayır | 0.0 - 1.0 | -| `std` | Normalizasyon için standart sapma (varsayılan: 0.5). | FLOAT | Hayır | 0.001 - 1.0 | +| `image` | Normalleştirilecek girdi görüntüsü. | IMAGE | Evet | - | +| `ortalama` | Normalleştirme için ortalama değer (varsayılan: 0.5). | FLOAT | Hayır | 0.0 - 1.0 | +| `std` | Normalleştirme için standart sapma (varsayılan: 0.5). | FLOAT | Hayır | 0.001 - 1.0 | + +Not: Girdi görüntüsü bir alfa (şeffaflık) kanalı içerdiğinde, alfa kanalı normalleştirilmez. Alfa, renk yerine şeffaflığı sakladığı için çıktıda değiştirilmeden korunur. ## Çıktılar | Çıktı Adı | Açıklama | Veri Türü | | --- | --- | --- | -| `görüntüler` | Normalizasyon süreci uygulandıktan sonra elde edilen görüntü. | IMAGE | +| `görüntüler` | Normalleştirme süreci uygulandıktan sonra elde edilen görüntü. | 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/NormalizeImages/tr.md) --- -**Source fingerprint (SHA-256):** `30c0587265754842d1e56d478b89e87c1d014fcaad01894a7a2f4a21fa17b83f` +**Source fingerprint (SHA-256):** `30c0587265754842ff7d1e5f339fc934b58d59bb3ba18716c2a1f9679f2d561d` diff --git a/comfyui_embedded_docs/docs/NormalizeImages/zh-TW.md b/comfyui_embedded_docs/docs/NormalizeImages/zh-TW.md index e126b02f9..8d15d70c3 100644 --- a/comfyui_embedded_docs/docs/NormalizeImages/zh-TW.md +++ b/comfyui_embedded_docs/docs/NormalizeImages/zh-TW.md @@ -1,22 +1,24 @@ # 標準化圖片 -此節點透過數學正規化過程調整輸入影像的像素值。它會從每個像素減去指定的平均值,然後將結果除以指定的標準差。這是為其他機器學習模型準備影像資料時常見的預處理步驟。如果輸入影像帶有透明通道,透明通道將原樣保留,以保持透明度。 +此節點透過數學正規化過程調整輸入影像的像素值。它會從每個像素減去指定的平均值,再將結果除以指定的標準差。這是常見的前處理步驟,用於將影像資料準備給其他機器學習模型使用。 ## 輸入 -| 參數 | 說明 | 資料類型 | 必填 | 範圍 | +| 參數 | 說明 | 資料類型 | 必要 | 範圍 | | --- | --- | --- | --- | --- | -| `image` | 要正規化的輸入影像。 | IMAGE | 是 | - | -| `平均值` | 正規化的平均值(預設值:0.5)。 | FLOAT | 否 | 0.0 - 1.0 | -| `標準差` | 正規化的標準差(預設值:0.5)。 | FLOAT | 否 | 0.001 - 1.0 | +| `image` | 要進行正規化的輸入影像。 | IMAGE | 是 | - | +| `平均值` | 正規化所使用的平均值(預設值:0.5)。 | FLOAT | 否 | 0.0 - 1.0 | +| `標準差` | 正規化所使用的標準差(預設值:0.5)。 | FLOAT | 否 | 0.001 - 1.0 | + +注意:當輸入影像包含 alpha(透明度)通道時,alpha 通道不會被正規化。它會保持不變地保留在輸出中,因為 alpha 儲存的是透明度而非色彩。 ## 輸出 -| 輸出名 | 說明 | 資料類型 | +| 輸出名稱 | 說明 | 資料類型 | | --- | --- | --- | -| `圖片` | 套用正規化程序後得到的影像。 | IMAGE | +| `圖片` | 套用正規化過程後所得到的影像。 | IMAGE | > 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/NormalizeImages/zh-TW.md) --- -**Source fingerprint (SHA-256):** `30c0587265754842d1e56d478b89e87c1d014fcaad01894a7a2f4a21fa17b83f` +**Source fingerprint (SHA-256):** `30c0587265754842ff7d1e5f339fc934b58d59bb3ba18716c2a1f9679f2d561d` diff --git a/comfyui_embedded_docs/docs/NormalizeImages/zh.md b/comfyui_embedded_docs/docs/NormalizeImages/zh.md index 6b9eb73b0..1a20f4f45 100644 --- a/comfyui_embedded_docs/docs/NormalizeImages/zh.md +++ b/comfyui_embedded_docs/docs/NormalizeImages/zh.md @@ -1,22 +1,24 @@ # 规格化图像 -此节点通过数学归一化过程调整输入图像的像素值。它从每个像素中减去指定的均值,然后将结果除以指定的标准差。这是为其他机器学习模型准备图像数据的常见预处理步骤。如果输入图像带有透明通道,透明通道将原样保留,以保持透明度。 +此节点通过数学归一化过程调整输入图像的像素值。它从每个像素中减去指定的均值,然后将结果除以指定的标准差。这是为其他机器学习模型准备图像数据时常见的预处理步骤。 ## 输入 -| 参数 | 描述 | 数据类型 | 必需 | 范围 | +| 参数 | 描述 | 数据类型 | 是否必填 | 范围 | | --- | --- | --- | --- | --- | -| `image` | 要归一化的输入图像。 | IMAGE | 是 | - | -| `平均` | 归一化的均值(默认值:0.5)。 | FLOAT | 否 | 0.0 - 1.0 | -| `标准差` | 归一化的标准差(默认值:0.5)。 | FLOAT | 否 | 0.001 - 1.0 | +| `image` | 要进行归一化的输入图像。 | IMAGE | 是 | - | +| `平均` | 归一化使用的均值(默认值:0.5)。 | FLOAT | 否 | 0.0 - 1.0 | +| `标准差` | 归一化使用的标准差(默认值:0.5)。 | FLOAT | 否 | 0.001 - 1.0 | + +注意:当输入图像包含 alpha(透明度)通道时,该通道不会被归一化。由于 alpha 存储的是透明度而非颜色信息,因此输出中保持其不变。 ## 输出 | 输出名称 | 描述 | 数据类型 | | --- | --- | --- | -| `图像` | 应用归一化过程后生成的图像。 | IMAGE | +| `图像` | 应用归一化过程后得到的图像。 | IMAGE | > 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/NormalizeImages/zh.md) --- -**Source fingerprint (SHA-256):** `30c0587265754842d1e56d478b89e87c1d014fcaad01894a7a2f4a21fa17b83f` +**Source fingerprint (SHA-256):** `30c0587265754842ff7d1e5f339fc934b58d59bb3ba18716c2a1f9679f2d561d` diff --git a/comfyui_embedded_docs/docs/OpenAIChatConfig/ar.md b/comfyui_embedded_docs/docs/OpenAIChatConfig/ar.md index c2fdfd7a6..faf69d7b5 100644 --- a/comfyui_embedded_docs/docs/OpenAIChatConfig/ar.md +++ b/comfyui_embedded_docs/docs/OpenAIChatConfig/ar.md @@ -1,34 +1,23 @@ # خيارات OpenAI ChatGPT المتقدمة -# خيارات متقدمة OpenAI ChatGPT - -يُمكّن العقد OpenAI ChatGPT Advanced Options من ضبط إعدادات إضافية للعقدات OpenAI Chat Nodes. يوفر هذا العقد إعدادات متقدمة تتحكم في كيفية توليد النموذج للردود، بما في ذلك سلوك التقطيع، حدود طول النصوص الصادرة، والإرشادات المخصصة. - -## نظرة عامة - -يُصمم عقد OpenAI ChatGPT Advanced Options لتعزيز وظيفة العقدات OpenAI Chat Nodes عن طريق السماح للمستخدمين بتحديد خيارات إعدادات متقدمة. يمكن لهذه الإعدادات تعديل توليد ردود النموذج لتلبية متطلبات محددة. +تتيح لك عقدة OpenAIChatConfig تحديد خيارات متقدمة تتحكم في طريقة توليد عقدة OpenAI Chat للاستجابات. يمكنك ضبط استراتيجية الاقتطاع، وتحديد عدد رموز الإخراج، وتقديم تعليمات مخصصة، واختيار مقدار التفكير الذي يجب أن يقوم به النموذج قبل الإجابة. ## المدخلات -| المعامل | الوصف | نوع البيانات | إلزامي | نطاق | +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | |-----------|-------------|-----------|----------|-------| -| `الاقتصاص` | استراتيجية التقطيع التي سيستخدمها النموذج للردود. auto: إذا تجاوز سياق هذا الرد وسياق الردود السابقة حجم نافذة سياق النموذج، سيقوم النموذج بتقطيع الرد ليتناسب مع نافذة السياق عن طريق إسقاط عناصر الإدخال في منتصف الحوار. disabled: إذا كان رد النموذج سيتجاوز حجم نافذة السياق لنموذج، سيتم رفض الطلب بخطأ 400 (الافتراضي: "auto") | STRING | نعم | "auto"
"disabled" | -| `الرموز المخرجة القصوى` | حد أعلى لعدد التokens الذي يمكن توليده للرد، بما في ذلك التokens المرئية والت tokens التفكيرية (الافتراضي: 4096) | INT | لا | 16 إلى 16384 | -| `التعليمات` | إرشادات للنموذج حول كيفية توليد الرد (يدعم الإدخال المتعدد الأسطر) | STRING | لا | - | -| `reasoning_effort` | مقدار التفكير الذي يقوم به النموذج قبل الرد. 'default' يترك الخيار للنموذج. تختلف المستويات المدعومة لكل نموذج: GPT-6 Astra low-max، GPT-5.6 none-max (بدون أقل قيمة)، GPT-5.5 none-xhigh، GPT-5.5 Pro medium-xhigh، GPT-5 minimal-high، o-series low-high; GPT-4.1 لا يدعم التفكير. يتم رفض المستويات غير المدعومة قبل إرسال الطلب (الافتراضي: "default") | STRING | لا | "default"
"none"
"minimal"
"low"
"medium"
"high"
"xhigh"
"max" | +| `الاقتصاص` | استراتيجية الاقتطاع المستخدمة في استجابة النموذج. auto: إذا تجاوز سياق هذه الاستجابة والاستجابات السابقة حجم نافذة سياق النموذج، فسيقوم النموذج باقتطاع الاستجابة لتناسب نافذة السياق من خلال حذف عناصر الإدخال في منتصف المحادثة. disabled: إذا تجاوزت استجابة النموذج حجم نافذة سياق النموذج، فسيفشل الطلب مع خطأ 400 (الافتراضي: "auto") | COMBO | نعم | "auto"
"disabled" | +| `الرموز المخرجة القصوى` | حد أعلى لعدد الرموز التي يمكن توليدها للاستجابة، بما في ذلك رموز الإخراج المرئية ورموز الاستدلال (الافتراضي: 4096) | INT | لا | 16 إلى 16384 | +| `التعليمات` | تعليمات للنموذج حول كيفية توليد الاستجابة (يدعم الإدخال متعدد الأسطر) | STRING | لا | - | +| `reasoning_effort` | مقدار التفكير الذي ينفذه النموذج قبل الإجابة. تؤدي القيمة "default" إلى ترك الاختيار للنموذج. تختلف المستويات المدعومة باختلاف النموذج: GPT-6 Astra low-max، وGPT-5.6 none-max (بدون حد أدنى)، وGPT-5.5 none-xhigh، وGPT-5.5 Pro medium-xhigh، وGPT-5 minimal-high، وسلسلة o-series low-high؛ أما GPT-4.1 فلا يدعم التفكير. يتم رفض المستويات غير المدعومة قبل إرسال الطلب. (الافتراضي: "default") | COMBO | لا | "default"
"none"
"minimal"
"low"
"medium"
"high"
"xhigh"
"max" | + +ملاحظة: على الرغم من إدراج `top_p` و`temperature` كخاصيتين في مواصفات API، إلا أنهما غير مدعومتين لجميع النماذج، وبالتالي لا يتم إظهارهما كمدخلات. ## المخرجات -| اسم المخرج | الوصف | نوع البيانات | +| اسم المخرجات | الوصف | نوع البيانات | |-------------|-------------|-----------| -| `OPENAI_CHAT_CONFIG` | مكتبة إعدادات تحتوي على الإعدادات المحددة للاستخدام مع العقدات OpenAI Chat Nodes | OPENAI_CHAT_CONFIG | - -## ملاحظات - -- يضبط المعامل `max_output_tokens` الحد الأعلى لعدد الرموز (tokens) الكلي، بما في ذلك رموز المخرجات المرئية ورموز التفكير. -- يسمح المعامل `reasoning_effort` بتخصيص مستوى التفكير الذي يجب أن يقوم به النموذج قبل توليد الرد. تختلف المستويات المدعومة بناءً على النموذج المستخدم. -- يمكن استخدام المعامل `instructions` لتقديم إرشادات مفصلة للنموذج لتهدية عملية توليد الرد. -- يحدد المعامل `truncation` ما إذا كان النموذج يجب أن يقطع الرد تلقائيًا إذا تجاوز حجم نافذة السياق أو يفشل بخطأ 400. +| `OPENAI_CHAT_CONFIG` | كائن تكوين يحتوي على الإعدادات المحددة للاستخدام مع عُقد OpenAI Chat | OPENAI_CHAT_CONFIG | > تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/OpenAIChatConfig/ar.md) diff --git a/comfyui_embedded_docs/docs/OpenAIChatConfig/en.md b/comfyui_embedded_docs/docs/OpenAIChatConfig/en.md index ab8d7d1ab..d4635b52e 100644 --- a/comfyui_embedded_docs/docs/OpenAIChatConfig/en.md +++ b/comfyui_embedded_docs/docs/OpenAIChatConfig/en.md @@ -1,19 +1,17 @@ # OpenAI ChatGPT Advanced Options -The OpenAI ChatGPT Advanced Options node allows you to set additional configuration for the OpenAI Chat Nodes. This node provides advanced settings that control how the model generates responses, including truncation behavior, output length limits, and custom instructions. - -## Overview - -The OpenAI ChatGPT Advanced Options node is designed to enhance the functionality of the OpenAI Chat Nodes by allowing users to specify advanced configuration options. These settings can help tailor the model's response generation to specific requirements. +The OpenAIChatConfig node lets you define advanced options that control how the OpenAI Chat Node generates responses. You can set the truncation strategy, limit the number of output tokens, provide custom instructions, and choose how much the model should reason before answering. ## Inputs | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `truncation` | The truncation strategy to use for the model response. auto: If the context of this response and previous ones exceeds the model's context window size, the model will truncate the response to fit the context window by dropping input items in the middle of the conversation. disabled: If a model response will exceed the context window size for a model, the request will fail with a 400 error (default: "auto") | STRING | Yes | "auto"
"disabled" | +| `truncation` | The truncation strategy to use for the model response. auto: If the context of this response and previous ones exceeds the model's context window size, the model will truncate the response to fit the context window by dropping input items in the middle of the conversation. disabled: If a model response will exceed the context window size for a model, the request will fail with a 400 error (default: "auto") | COMBO | Yes | "auto"
"disabled" | | `max_output_tokens` | An upper bound for the number of tokens that can be generated for a response, including visible output tokens and reasoning tokens (default: 4096) | INT | No | 16 to 16384 | | `instructions` | Instructions for the model on how to generate the response (multiline input supported) | STRING | No | - | -| `reasoning_effort` | How much the model reasons before answering. 'default' leaves the choice to the model. Supported levels differ per model: GPT-6 Astra low-max, GPT-5.6 none-max (no minimal), GPT-5.5 none-xhigh, GPT-5.5 Pro medium-xhigh, GPT-5 minimal-high, o-series low-high; GPT-4.1 has no reasoning. Unsupported levels are rejected before the request is sent (default: "default") | STRING | No | "default"
"none"
"minimal"
"low"
"medium"
"high"
"xhigh"
"max" | +| `reasoning_effort` | How much the model reasons before answering. "default" leaves the choice to the model. Supported levels differ per model: GPT-6 Astra low-max, GPT-5.6 none-max (no minimal), GPT-5.5 none-xhigh, GPT-5.5 Pro medium-xhigh, GPT-5 minimal-high, o-series low-high; GPT-4.1 has no reasoning. Unsupported levels are rejected before the request is sent. (default: "default") | COMBO | No | "default"
"none"
"minimal"
"low"
"medium"
"high"
"xhigh"
"max" | + +Note: While `top_p` and `temperature` are listed as properties in the API specification, they are not supported for all models and are therefore not exposed as inputs. ## Outputs @@ -21,13 +19,6 @@ The OpenAI ChatGPT Advanced Options node is designed to enhance the functionalit |-------------|-------------|-----------| | `OPENAI_CHAT_CONFIG` | Configuration object containing the specified settings for use with OpenAI Chat Nodes | OPENAI_CHAT_CONFIG | -## Notes - -- The `max_output_tokens` parameter sets an upper limit on the total number of tokens, including both visible output and reasoning tokens. -- The `reasoning_effort` parameter allows you to specify the level of reasoning the model should apply before generating a response. The supported levels vary depending on the model being used. -- The `instructions` parameter can be used to provide detailed instructions to the model to guide the response generation process. -- The `truncation` parameter determines whether the model should automatically truncate the response if it exceeds the context window size or fail with a 400 error. - > 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/OpenAIChatConfig/en.md) --- diff --git a/comfyui_embedded_docs/docs/OpenAIChatConfig/es.md b/comfyui_embedded_docs/docs/OpenAIChatConfig/es.md index 4666c0ab9..d7d473dd3 100644 --- a/comfyui_embedded_docs/docs/OpenAIChatConfig/es.md +++ b/comfyui_embedded_docs/docs/OpenAIChatConfig/es.md @@ -1,34 +1,23 @@ # Opciones Avanzadas de OpenAI ChatGPT -# Opciones Avanzadas de ChatGPT de OpenAI - -El nodo Opciones Avanzadas de ChatGPT de OpenAI permite configurar opciones adicionales para los Nodos de Chat de OpenAI. Este nodo proporciona configuraciones avanzadas que controlan cómo el modelo genera respuestas, incluyendo el comportamiento de truncamiento, límites de longitud de salida y instrucciones personalizadas. - -## Resumen - -El nodo Opciones Avanzadas de ChatGPT de OpenAI está diseñado para mejorar la funcionalidad de los Nodos de Chat de OpenAI, permitiendo a los usuarios especificar opciones de configuración avanzadas. Estas configuraciones pueden ayudar a ajustar la generación de respuestas del modelo a requisitos específicos. +El nodo OpenAIChatConfig permite definir opciones avanzadas que controlan cómo el nodo OpenAI Chat genera las respuestas. Puedes establecer la estrategia de truncamiento, limitar el número de tokens de salida, proporcionar instrucciones personalizadas y elegir cuánto debe razonar el modelo antes de responder. ## Entradas -| Parámetro | Descripción | Tipo de Datos | Requerido | Rango | -|-----------|-------------|-----------|----------|-------| -| `truncamiento` | La estrategia de truncamiento a usar para la respuesta del modelo. auto: Si el contexto de esta respuesta y las anteriores excede el tamaño de la ventana de contexto del modelo, el modelo truncará la respuesta para ajustarse a la ventana de contexto eliminando elementos de entrada en el medio de la conversación. disabled: Si una respuesta del modelo excederá el tamaño de la ventana de contexto de un modelo, la solicitud fallará con un error 400 (por defecto: "auto") | STRING | Sí | "auto"
"disabled" | -| `tokens_salida_max` | Un límite superior para el número de tokens que pueden generarse para una respuesta, incluyendo tokens de salida visibles y tokens de razonamiento (por defecto: 4096) | INT | No | 16 a 16384 | -| `instrucciones` | Instrucciones para el modelo sobre cómo generar la respuesta (se admite entrada multilinea) | STRING | No | - | -| `reasoning_effort` | Cuánto razona el modelo antes de responder. 'default' deja la elección al modelo. Los niveles de soporte varían según el modelo: GPT-6 Astra low-max, GPT-5.6 none-max (sin mínimo), GPT-5.5 none-xhigh, GPT-5.5 Pro medium-xhigh, GPT-5 minimal-high, o-series low-high; GPT-4.1 no tiene razonamiento. Los niveles no soportados se rechazan antes de que se envíe la solicitud (por defecto: "default") | STRING | No | "default"
"none"
"minimal"
"low"
"medium"
"high"
"xhigh"
"max" | +| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango | +|-----------|-------------|---------------|-------------|-------| +| `truncamiento` | La estrategia de truncamiento que se usará para la respuesta del modelo. auto: si el contexto de esta respuesta y las anteriores supera el tamaño de la ventana de contexto del modelo, el modelo truncará la respuesta para ajustarse a la ventana de contexto descartando elementos de entrada en medio de la conversación. disabled: si una respuesta del modelo supera el tamaño de la ventana de contexto, la solicitud fallará con un error 400 (por defecto: "auto") | COMBO | Sí | "auto"
"disabled" | +| `tokens_salida_max` | Un límite superior para la cantidad de tokens que se pueden generar en una respuesta, incluidos los tokens de salida visibles y los tokens de razonamiento (por defecto: 4096) | INT | No | 16 a 16384 | +| `instrucciones` | Instrucciones para el modelo sobre cómo generar la respuesta (se admite entrada multilínea) | STRING | No | - | +| `reasoning_effort` | Cuánto debe razonar el modelo antes de responder. "default" deja la elección al modelo. Los niveles admitidos varían según el modelo: GPT-6 Astra low-max; GPT-5.6 none-max (sin mínimo); GPT-5.5 none-xhigh; GPT-5.5 Pro medium-xhigh; GPT-5 minimal-high; o-series low-high; GPT-4.1 no tiene razonamiento. Los niveles no admitidos se rechazan antes de enviar la solicitud. (por defecto: "default") | COMBO | No | "default"
"none"
"minimal"
"low"
"medium"
"high"
"xhigh"
"max" | -## Salidas - -| Nombre de Salida | Descripción | Tipo de Datos | -|-------------|-------------|-----------| -| `OPENAI_CHAT_CONFIG` | Objeto de configuración que contiene las configuraciones especificadas para su uso con los Nodos de Chat de OpenAI | OPENAI_CHAT_CONFIG | +Nota: aunque `top_p` y `temperature` aparecen como propiedades en la especificación de la API, no son compatibles con todos los modelos y, por lo tanto, no se exponen como entradas. -## Notas +## Salidas -- El parámetro `max_output_tokens` establece un límite superior en el número total de tokens, incluyendo tanto tokens de salida visibles como tokens de razonamiento. -- El parámetro `reasoning_effort` permite especificar el nivel de razonamiento que debe aplicar el modelo antes de generar una respuesta. Los niveles de soporte varían dependiendo del modelo utilizado. -- El parámetro `instructions` se puede usar para proporcionar instrucciones detalladas al modelo para guiar el proceso de generación de respuestas. -- El parámetro `truncation` determina si el modelo debe truncar automáticamente la respuesta si excede el tamaño de la ventana de contexto o fallar con un error 400. +| Nombre de salida | Descripción | Tipo de datos | +|------------------|-------------|---------------| +| `OPENAI_CHAT_CONFIG` | Objeto de configuración que contiene los ajustes especificados para usar con los nodos OpenAI Chat | OPENAI_CHAT_CONFIG | > 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/OpenAIChatConfig/es.md) diff --git a/comfyui_embedded_docs/docs/OpenAIChatConfig/fa.md b/comfyui_embedded_docs/docs/OpenAIChatConfig/fa.md index a72f0d42c..5d50936e0 100644 --- a/comfyui_embedded_docs/docs/OpenAIChatConfig/fa.md +++ b/comfyui_embedded_docs/docs/OpenAIChatConfig/fa.md @@ -1,34 +1,23 @@ # تنظیمات پیشرفته OpenAI ChatGPT -# تنظیمات پیشرفته ChatGPT OpenAI - -نود تنظیمات پیشرفته ChatGPT OpenAI به شما امکان می‌دهد تا تنظیمات اضافی برای نودهای Chat OpenAI تعیین کنید. این نود تنظیمات پیشرفته‌ای را فراهم می‌کند که کنترل می‌کند چگونه مدل پاسخ‌ها را تولید می‌کند، از جمله رفتار قطع کردن، محدودیت‌های طول پاسخ و دستورالعمل‌های سفارشی. - -## مقدمه - -نود تنظیمات پیشرفته ChatGPT OpenAI برای بهبود عملکرد نودهای Chat OpenAI طراحی شده است و به کاربران اجازه می‌دهد تا تنظیمات پیشرفته‌ای را برای تنظیم پاسخ‌های مدل به نیازهای خاص خود مشخص کنند. +گره OpenAIChatConfig به شما امکان می‌دهد گزینه‌های پیشرفته‌ای تعریف کنید که نحوه تولید پاسخ توسط گره OpenAI Chat را کنترل می‌کنند. می‌توانید راهبرد برش را تنظیم کنید، تعداد توکن‌های خروجی را محدود کنید، دستورالعمل‌های سفارشی ارائه دهید و انتخاب کنید مدل پیش از پاسخ‌دادن چقدر استدلال کند. ## ورودی‌ها -| پارامتر | توضیح | نوع داده | الزامی | محدوده | +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | |-----------|-------------|-----------|----------|-------| -| `truncation` | استراتژی قطع کردن برای پاسخ مدل. auto: اگر محتوای این پاسخ و پاسخ‌های قبلی از اندازه پنجره محتوای مدل فراتر رود، مدل پاسخ را برای تطابق با پنجره محتوای بهینه قطع خواهد کرد و ورودی‌های وسط مکالمه را حذف می‌کند. disabled: اگر پاسخ مدل از اندازه پنجره محتوای مدل فراتر رود، درخواست با خطای 400 شکست خواهد خورد (پیش‌فرض: "auto") | STRING | بله | "auto"
"disabled" | -| `max_output_tokens` | محدودیت بالایی برای تعداد توکن‌هایی که می‌توان برای یک پاسخ تولید کرد، شامل توکن‌های قابل مشاهده و توکن‌های استدلالی (پیش‌فرض: 4096) | INT | خیر | 16 تا 16384 | -| `instructions` | دستورالعمل‌هایی برای مدل در مورد نحوه تولید پاسخ (ورودی چندخطی پشتیبانی می‌شود) | STRING | خیر | - | -| `reasoning_effort` | میزان استدلالی که مدل قبل از پاسخ دادن انجام می‌دهد. 'default' انتخاب بین مدل را واگذار می‌کند. سطح‌های پشتیبانی شده برای هر مدل متفاوت است: GPT-6 Astra low-max، GPT-5.6 none-max (بدون حداقل)، GPT-5.5 none-xhigh، GPT-5.5 Pro medium-xhigh، GPT-5 minimal-high، o-series low-high; GPT-4.1 استدلال ندارد. سطح‌های پشتیبانی نشده قبل از ارسال درخواست رد می‌شوند (پیش‌فرض: "default") | STRING | خیر | "default"
"none"
"minimal"
"low"
"medium"
"high"
"xhigh"
"max" | +| `truncation` | راهبرد برش برای پاسخ مدل. auto: اگر زمینه این پاسخ و پاسخ‌های قبلی از اندازه پنجره زمینه مدل فراتر رود، مدل پاسخ را برای جا شدن در پنجره زمینه با حذف آیتم‌های ورودی از میانه گفت‌وگو برش می‌دهد. disabled: اگر پاسخ مدل از اندازه پنجره زمینه یک مدل فراتر رود، درخواست با خطای 400 شکست می‌خورد (پیش‌فرض: "auto") | COMBO | بله | "auto"
"disabled" | +| `max_output_tokens` | حد بالایی برای تعداد توکن‌هایی که می‌توان برای یک پاسخ تولید کرد، شامل توکن‌های خروجی قابل مشاهده و توکن‌های استدلال (پیش‌فرض: 4096) | INT | خیر | 16 تا 16384 | +| `instructions` | دستورالعمل‌هایی برای مدل درباره نحوه تولید پاسخ (ورودی چندخطی پشتیبانی می‌شود) | STRING | خیر | - | +| `reasoning_effort` | میزان استدلال مدل پیش از پاسخ‌دادن. «default» انتخاب را به مدل واگذار می‌کند. سطوح پشتیبانی‌شده بسته به مدل متفاوت است: GPT-6 Astra از low تا max، GPT-5.6 از none تا max (بدون minimal)، GPT-5.5 از none تا xhigh، GPT-5.5 Pro از medium تا xhigh، GPT-5 از minimal تا high، سری o از low تا high؛ GPT-4.1 استدلال ندارد. سطوح پشتیبانی‌نشده پیش از ارسال درخواست رد می‌شوند. (پیش‌فرض: "default") | COMBO | خیر | "default"
"none"
"minimal"
"low"
"medium"
"high"
"xhigh"
"max" | + +توجه: اگرچه `top_p` و `temperature` در مشخصات API به‌عنوان ویژگی فهرست شده‌اند، اما برای همه مدل‌ها پشتیبانی نمی‌شوند و بنابراین به‌عنوان ورودی در دسترس قرار نمی‌گیرند. ## خروجی‌ها -| نام خروجی | توضیح | نوع داده | +| نام خروجی | توضیحات | نوع داده | |-------------|-------------|-----------| -| `OPENAI_CHAT_CONFIG` | شیء تنظیمات که شامل تنظیمات مشخص شده برای استفاده با نودهای Chat OpenAI است | OPENAI_CHAT_CONFIG | - -## یادداشت‌ها - -- پارامتر `max_output_tokens` محدودیت بالایی برای تعداد توکن‌های کل، شامل توکن‌های قابل مشاهده و توکن‌های استدلالی تنظیم می‌کند. -- پارامتر `reasoning_effort` به شما امکان می‌دهد تا سطح استدلالی که مدل قبل از تولید پاسخ انجام می‌دهد را مشخص کنید. سطح‌های پشتیبانی شده بسته به مدل مورد استفاده متفاوت است. -- پارامتر `instructions` می‌تواند برای ارائه دستورالعمل‌های دقیق به مدل برای هدایت فرآیند تولید پاسخ استفاده شود. -- پارامتر `truncation` تعیین می‌کند که آیا مدل باید پاسخ را خودکار قطع کند یا در صورت تجاوز از اندازه پنجره محتوای به خطای 400 شکست بخورد. +| `OPENAI_CHAT_CONFIG` | شیء پیکربندی حاوی تنظیمات مشخص‌شده برای استفاده با گره‌های OpenAI Chat | OPENAI_CHAT_CONFIG | > این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/OpenAIChatConfig/fa.md) diff --git a/comfyui_embedded_docs/docs/OpenAIChatConfig/fr.md b/comfyui_embedded_docs/docs/OpenAIChatConfig/fr.md index 318951dc0..e68768af4 100644 --- a/comfyui_embedded_docs/docs/OpenAIChatConfig/fr.md +++ b/comfyui_embedded_docs/docs/OpenAIChatConfig/fr.md @@ -1,34 +1,23 @@ # Options avancées OpenAI ChatGPT -# Options Avancées ChatGPT d'OpenAI - -Le nœud Options Avancées ChatGPT d'OpenAI permet de définir des configurations supplémentaires pour les nœuds ChatGPT d'OpenAI. Ce nœud fournit des paramètres avancés qui contrôlent la manière dont le modèle génère des réponses, y compris le comportement de troncature, les limites de longueur des sorties et les instructions personnalisées. - -## Aperçu - -Le nœud Options Avancées ChatGPT d'OpenAI est conçu pour améliorer les fonctionnalités des nœuds ChatGPT d'OpenAI en permettant aux utilisateurs de spécifier des options de configuration avancées. Ces paramètres peuvent aider à adapter la génération de réponses du modèle aux exigences spécifiques. +Le nœud OpenAIChatConfig vous permet de définir des options avancées qui contrôlent la façon dont le nœud OpenAI Chat génère les réponses. Vous pouvez définir la stratégie de troncature, limiter le nombre de jetons de sortie, fournir des instructions personnalisées et choisir à quel point le modèle doit raisonner avant de répondre. ## Entrées -| Paramètre | Description | Type de données | Obligatoire | Gamme | -|-----------|-------------|-----------|----------|-------| -| `troncature` | Stratégie de troncature à utiliser pour la réponse du modèle. auto : Si le contexte de cette réponse et des précédentes dépasse la taille de la fenêtre de contexte du modèle, le modèle tronquera la réponse pour l'ajuster à la fenêtre de contexte en supprimant des éléments d'entrée au milieu de la conversation. disabled : Si une réponse du modèle dépasse la taille de la fenêtre de contexte pour un modèle, la requête échouera avec un code 400 (par défaut : "auto") | STRING | Oui | "auto"
"disabled" | -| `jetons_sortie_max` | Limite supérieure pour le nombre de tokens pouvant être générés pour une réponse, y compris les tokens de sortie visibles et les tokens de raisonnement (par défaut : 4096) | INT | Non | 16 à 16384 | -| `instructions` | Instructions pour le modèle sur la manière de générer la réponse (prise en charge des entrées en plusieurs lignes) | STRING | Non | - | -| `reasoning_effort` | Degré de raisonnement du modèle avant de répondre. 'default' laisse le choix au modèle. Les niveaux pris en charge varient selon le modèle : GPT-6 Astra low-max, GPT-5.6 none-max (sans minimal), GPT-5.5 none-xhigh, GPT-5.5 Pro medium-xhigh, GPT-5 minimal-high, o-series low-high ; GPT-4.1 n'a pas de raisonnement. Les niveaux non pris en charge sont rejetés avant l'envoi de la requête (par défaut : "default") | STRING | Non | "default"
"none"
"minimal"
"low"
"medium"
"high"
"xhigh"
"max" | +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `troncature` | La stratégie de troncature à utiliser pour la réponse du modèle. auto : si le contexte de cette réponse et des réponses précédentes dépasse la taille de la fenêtre de contexte du modèle, le modèle tronque la réponse pour l’adapter à la fenêtre de contexte en supprimant des éléments d’entrée au milieu de la conversation. disabled : si la réponse d’un modèle dépasse la taille de la fenêtre de contexte de ce modèle, la requête échoue avec une erreur 400 (défaut : « auto ») | COMBO | Oui | « auto »
« disabled » | +| `jetons_sortie_max` | Une limite supérieure du nombre de jetons pouvant être générés pour une réponse, y compris les jetons de sortie visibles et les jetons de raisonnement (défaut : 4096) | INT | Non | 16 à 16384 | +| `instructions` | Instructions données au modèle sur la manière de générer la réponse (saisie multiligne prise en charge) | STRING | Non | - | +| `reasoning_effort` | Le degré de raisonnement que le modèle applique avant de répondre. « default » laisse le choix au modèle. Les niveaux pris en charge varient selon le modèle : GPT-6 Astra low-max, GPT-5.6 none-max (pas de minimum), GPT-5.5 none-xhigh, GPT-5.5 Pro medium-xhigh, GPT-5 minimal-high, o-series low-high ; GPT-4.1 n’effectue aucun raisonnement. Les niveaux non pris en charge sont rejetés avant l’envoi de la requête. (défaut : « default ») | COMBO | Non | « default »
« none »
« minimal »
« low »
« medium »
« high »
« xhigh »
« max » | + +Remarque : bien que `top_p` et `temperature` soient répertoriés comme propriétés dans la spécification API, ils ne sont pas pris en charge pour tous les modèles et ne sont donc pas exposés comme entrées. ## Sorties | Nom de sortie | Description | Type de données | -|-------------|-------------|-----------| -| `OPENAI_CHAT_CONFIG` | Objet de configuration contenant les paramètres spécifiés pour utilisation avec les nœuds ChatGPT d'OpenAI | OPENAI_CHAT_CONFIG | - -## Notes - -- Le paramètre `max_output_tokens` définit une limite supérieure sur le nombre total de tokens, y compris les tokens de sortie visibles et les tokens de raisonnement. -- Le paramètre `reasoning_effort` permet de spécifier le niveau de raisonnement que le modèle doit appliquer avant de générer une réponse. Les niveaux pris en charge varient selon le modèle utilisé. -- Le paramètre `instructions` peut être utilisé pour fournir des instructions détaillées au modèle pour guider le processus de génération de la réponse. -- Le paramètre `truncation` détermine si le modèle doit tronquer automatiquement la réponse si elle dépasse la taille de la fenêtre de contexte ou échouer avec un code 400. +|---------------|-------------|-----------------| +| `OPENAI_CHAT_CONFIG` | Objet de configuration contenant les paramètres spécifiés pour une utilisation avec les nœuds OpenAI Chat | OPENAI_CHAT_CONFIG | > 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/OpenAIChatConfig/fr.md) diff --git a/comfyui_embedded_docs/docs/OpenAIChatConfig/ja.md b/comfyui_embedded_docs/docs/OpenAIChatConfig/ja.md index fb1b8d3f0..ebcdbdfbc 100644 --- a/comfyui_embedded_docs/docs/OpenAIChatConfig/ja.md +++ b/comfyui_embedded_docs/docs/OpenAIChatConfig/ja.md @@ -1,32 +1,23 @@ # OpenAI ChatGPT 詳細オプション -OpenAI ChatGPT 高機能オプションノードは、OpenAI Chat ノードに対して追加の設定を行うことができます。このノードは、モデルが応答を生成する方法を制御する包括的な設定を提供し、応答の切り詰め行為、出力長制限、カスタム指示などが含まれます。 - -## 概要 - -OpenAI ChatGPT 高機能オプションノードは、ユーザーが高度な設定オプションを指定することで、OpenAI Chat ノードの機能を強化するために設計されています。これらの設定は、モデルの応答生成を特定の要件に合わせるのに役立ちます。 +OpenAIChatConfig ノードを使用すると、OpenAI Chat ノードが応答を生成する方法を制御する高度なオプションを定義できます。トランケーション戦略の設定、出力トークン数の制限、カスタム指示の提供、回答前にモデルが推論する量の選択が可能です。 ## 入力 -| パラメータ | 説明 | データ型 | 必須 | 范囲 | +| パラメータ | 説明 | データ型 | 必須 | 範囲 | |-----------|-------------|-----------|----------|-------| -| `切り捨て` | モデル応答に対する切り詰め戦略を指定します。auto: この応答の文脈と前の応答がモデルの文脈ウィンドウサイズを超えた場合、モデルは会話の途中で入力アイテムをドロップして文脈ウィンドウにフィットさせるために応答を切り詰めます。disabled: モデル応答が文脈ウィンドウサイズを超える場合、リクエストは400エラーより失敗します(デフォルト: "auto") | STRING | はい | "auto"
"disabled" | -| `最大出力トークン数` | 响答に対して生成できるトークンの数の上限を設定します。表示可能なトークンと推論トークンを含みます(デフォルト: 4096) | INT | いいえ | 16〜16384 | -| `指示` | モデルに対して応答を生成する方法に関する指示(マルチライン入力がサポートされています) | STRING | いいえ | - | -| `reasoning_effort` | 偉大に答える前にモデルが推論する量を指定します。'default'はモデルに選択を任せます。サポートされるレベルはモデルごとに異なります:GPT-6 Astra low-max、GPT-5.6 none-max(最小限なし)、GPT-5.5 none-xhigh、GPT-5.5 Pro medium-xhigh、GPT-5 minimal-high、o-series low-high;GPT-4.1は推論がありません。サポートされないレベルはリクエスト送信前に拒否されます(デフォルト: "default") | STRING | いいえ | "default"
"none"
"minimal"
"low"
"medium"
"high"
"xhigh"
"max" | +| `切り捨て` | モデルの応答に使用するトランケーション戦略です。auto: この応答と以前の応答のコンテキストがモデルのコンテキストウィンドウサイズを超える場合は、会話の中盤にある入力項目を削除して、コンテキストウィンドウに収まるように応答をトランケーションします。disabled: モデルの応答がモデルのコンテキストウィンドウサイズを超える場合は、リクエストは400エラーで失敗します(デフォルト: "auto") | COMBO | 必須 | "auto"
"disabled" | +| `最大出力トークン数` | 応答に対して生成できるトークン数の上限です。表示される出力トークンと推論トークンが含まれます(デフォルト: 4096) | INT | 任意 | 16〜16384 | +| `指示` | 応答の生成方法に関するモデルへの指示です(複数行の入力に対応) | STRING | 任意 | - | +| `reasoning_effort` | モデルが回答する前にどれだけ推論するかを指定します。"default" はモデルに選択を委ねます。サポートされるレベルはモデルごとに異なります:GPT-6 Astra は low-max、GPT-5.6 は none-max(minimal なし)、GPT-5.5 は none-xhigh、GPT-5.5 Pro は medium-xhigh、GPT-5 は minimal-high、o-series は low-high。GPT-4.1 は推論を行いません。サポートされていないレベルは、リクエストが送信される前に拒否されます(デフォルト: "default") | COMBO | 任意 | "default"
"none"
"minimal"
"low"
"medium"
"high"
"xhigh"
"max" | + +注:`top_p` と `temperature` はAPI仕様ではプロパティとして記載されていますが、すべてのモデルでサポートされているわけではないため、入力としては公開されていません。 ## 出力 | 出力名 | 説明 | データ型 | |-------------|-------------|-----------| -| `OPENAI_CHAT_CONFIG` | 指定された設定を OpenAI Chat ノードで使用するための設定オブジェクト | OPENAI_CHAT_CONFIG | - -## 注意事項 - -- `max_output_tokens` パラメータは、表示可能なトークンと推論トークンを含むトークンの合計数の上限を設定します。 -- `reasoning_effort` パラメータは、モデルが応答を生成する前に適用する推論のレベルを指定できます。サポートされるレベルは使用されるモデルによって異なります。 -- `instructions` パラメータは、モデルに対して応答生成プロセスをガイドする詳細な指示を提供するために使用できます。 -- `truncation` パラメータは、モデルが文脈ウィンドウサイズを超えた場合に自動的に応答を切り詰めるか、400エラーより失敗するかを決定します。 +| `OPENAI_CHAT_CONFIG` | OpenAI Chat ノードで使用する、指定された設定を含む設定オブジェクトです。 | OPENAI_CHAT_CONFIG | > このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/OpenAIChatConfig/ja.md) diff --git a/comfyui_embedded_docs/docs/OpenAIChatConfig/ko.md b/comfyui_embedded_docs/docs/OpenAIChatConfig/ko.md index fe6c2fb6b..4491b998e 100644 --- a/comfyui_embedded_docs/docs/OpenAIChatConfig/ko.md +++ b/comfyui_embedded_docs/docs/OpenAIChatConfig/ko.md @@ -1,32 +1,23 @@ # OpenAI ChatGPT 고급 옵션 -OpenAI ChatGPT 고급 옵션 노드는 OpenAI Chat 노드에 대한 추가 설정을 설정할 수 있게 합니다. 이 노드는 모델이 응답을 생성하는 방식을 제어하는 고급 설정을 제공하며, 트락션 행동, 출력 길이 제한, 및 사용자 정의 지시를 포함합니다. - -## 개요 - -OpenAI ChatGPT 고급 옵션 노드는 사용자가 고급 설정 옵션을 지정할 수 있도록 설계되어 있으며, 이를 통해 모델의 응답 생성을 특정 요구 사항에 맞게 조정할 수 있습니다. +OpenAIChatConfig 노드를 사용하면 OpenAI Chat 노드가 응답을 생성하는 방식을 제어하는 고급 옵션을 정의할 수 있습니다. 절단(truncation) 전략을 설정하고, 출력 토큰 수를 제한하고, 사용자 지정 지침을 제공하며, 모델이 응답하기 전에 추론할 양을 선택할 수 있습니다. ## 입력 -| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +| 매개변수 | 설명 | 데이터 유형 | 필수 여부 | 범위 | |-----------|-------------|-----------|----------|-------| -| `트렁케이션` | 모델 응답에 사용할 트락션 전략. auto: 이 응답과 이전 응답의 컨텍스트가 모델의 컨텍스트 창 크기를 초과하면, 모델은 대화 중에 중간에 입력 항목을 제거하여 컨텍스트 창에 맞게 응답을 트락션합니다. disabled: 모델 응답이 모델의 컨텍스트 창 크기를 초과하면, 요청이 400 오류로 실패합니다 (기본: "auto") | STRING | 예 | "auto"
"disabled" | -| `최대 출력 토큰` | 응답에 생성할 수 있는 토큰 수의 상한 제한, 보이는 출력 토큰과 추론 토큰을 포함합니다 (기본: 4096) | INT | 아니요 | 16 ~ 16384 | -| `지침` | 모델이 응답을 생성하는 방법에 대한 지시(다중 줄 입력 지원) | STRING | 아니요 | - | -| `reasoning_effort` | 응답에 답변하기 전에 모델이 추론할 정도. 'default'는 모델에게 선택을 맡깁니다. 지원 수준은 모델에 따라 다릅니다: GPT-6 Astra low-max, GPT-5.6 none-max (최소 없음), GPT-5.5 none-xhigh, GPT-5.5 Pro medium-xhigh, GPT-5 minimal-high, o-series low-high; GPT-4.1은 추론이 없습니다. 지원되지 않는 수준은 요청 전에 거부됩니다 (기본: "default") | STRING | 아니요 | "default"
"none"
"minimal"
"low"
"medium"
"high"
"xhigh"
"max" | +| `트렁케이션` | 모델 응답에 사용할 절단 전략입니다. auto: 현재 응답과 이전 응답들의 컨텍스트가 모델의 컨텍스트 창 크기를 초과하면, 모델은 대화 중간의 입력 항목을 생략하여 응답을 컨텍스트 창에 맞게 절단합니다. disabled: 모델 응답이 해당 모델의 컨텍스트 창 크기를 초과하면 요청이 400 오류와 함께 실패합니다. (기본값: "auto") | COMBO | 예 | "auto"
"disabled" | +| `최대 출력 토큰` | 응답에 대해 생성할 수 있는 토큰 수의 상한입니다. 여기에는 표시되는 출력 토큰과 추론 토큰이 포함됩니다. (기본값: 4096) | INT | 아니요 | 16~16384 | +| `지침` | 모델이 응답을 생성하는 방법에 대한 지침입니다. (여러 줄 입력 지원) | STRING | 아니요 | - | +| `reasoning_effort` | 모델이 응답하기 전에 추론하는 정도입니다. "default"는 모델이 스스로 결정하도록 둡니다. 지원되는 수준은 모델마다 다릅니다: GPT-6 Astra는 low-max, GPT-5.6은 none-max(minimal 수준 없음), GPT-5.5는 none-xhigh, GPT-5.5 Pro는 medium-xhigh, GPT-5는 minimal-high, o-series는 low-high이며, GPT-4.1은 추론을 지원하지 않습니다. 지원되지 않는 수준은 요청이 전송되기 전에 거부됩니다. (기본값: "default") | COMBO | 아니요 | "default"
"none"
"minimal"
"low"
"medium"
"high"
"xhigh"
"max" | + +참고: `top_p`와 `temperature`는 API 사양에 속성으로 명시되어 있지만 모든 모델에서 지원되는 것은 아니므로 입력으로 노출되지 않습니다. ## 출력 -| 출력 이름 | 설명 | 데이터 타입 | +| 출력 이름 | 설명 | 데이터 유형 | |-------------|-------------|-----------| -| `OPENAI_CHAT_CONFIG` | 지정된 설정을 OpenAI Chat 노드와 사용하기 위한 설정 객체 | OPENAI_CHAT_CONFIG | - -## 주의사항 - -- `max_output_tokens` 매개변수는 보이는 출력 토큰과 추론 토큰을 포함한 총 토큰 수의 상한 제한을 설정합니다. -- `reasoning_effort` 매개변수는 모델이 응답을 생성하기 전에 적용할 추론 수준을 지정할 수 있습니다. 지원 수준은 사용 중인 모델에 따라 다릅니다. -- `instructions` 매개변수는 모델이 응답 생성 과정을 지도하는 상세 지시를 제공할 수 있습니다. -- `truncation` 매개변수는 모델이 컨텍스트 창 크기를 초과하는 응답을 자동으로 트락션하거나 400 오류로 실패할지 결정합니다. +| `OPENAI_CHAT_CONFIG` | OpenAI Chat 노드에서 사용할 지정된 설정이 포함된 구성 객체입니다. | OPENAI_CHAT_CONFIG | > 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/OpenAIChatConfig/ko.md) diff --git a/comfyui_embedded_docs/docs/OpenAIChatConfig/pt-BR.md b/comfyui_embedded_docs/docs/OpenAIChatConfig/pt-BR.md index c6e43086e..1c65da727 100644 --- a/comfyui_embedded_docs/docs/OpenAIChatConfig/pt-BR.md +++ b/comfyui_embedded_docs/docs/OpenAIChatConfig/pt-BR.md @@ -1,34 +1,23 @@ # Opções Avançadas do OpenAI ChatGPT -# Opções Avançadas do ChatGPT da OpenAI - -O nó Opções Avançadas do ChatGPT da OpenAI permite que você configure adicionalmente os nós do ChatGPT da OpenAI. Este nó oferece configurações avançadas que controlam como o modelo gera respostas, incluindo comportamento de truncagem, limites de comprimento de saída e instruções personalizadas. - -## Visão Geral - -O nó Opções Avançadas do ChatGPT da OpenAI foi projetado para aprimorar a funcionalidade dos nós do ChatGPT da OpenAI, permitindo que os usuários especifiquem opções de configuração avançadas. Essas configurações podem ajudar a ajustar a geração de respostas do modelo para requisitos específicos. +O nó OpenAIChatConfig permite que você defina opções avançadas que controlam como o Nó de Chat OpenAI gera respostas. Você pode definir a estratégia de truncamento, limitar o número de tokens de saída, fornecer instruções personalizadas e escolher o quanto o modelo deve raciocinar antes de responder. ## Entradas | Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | |-----------|-------------|-----------|----------|-------| -| `truncation` | Estratégia de truncagem a ser usada para a resposta do modelo. auto: Se o contexto dessa resposta e das anteriores exceder o tamanho da janela de contexto do modelo, o modelo truncará a resposta para se encaixar na janela de contexto, descartando itens de entrada no meio da conversa. disabled: Se uma resposta do modelo exceder o tamanho da janela de contexto de um modelo, a solicitação falhará com um erro 400 (padrão: "auto") | STRING | Sim | "auto"
"disabled" | -| `max_output_tokens` | Limite superior para o número de tokens que podem ser gerados para uma resposta, incluindo tokens visíveis e tokens de raciocínio (padrão: 4096) | INT | Não | 16 a 16384 | -| `instructions` | Instruções para o modelo sobre como gerar a resposta (suporta entrada em múltiplas linhas) | STRING | Não | - | -| `reasoning_effort` | Quanto o modelo raciocina antes de responder. 'default' deixa a escolha para o modelo. Os níveis suportados diferem por modelo: GPT-6 Astra low-max, GPT-5.6 none-max (sem mínimo), GPT-5.5 none-xhigh, GPT-5.5 Pro medium-xhigh, GPT-5 minimal-high, o-series low-high; GPT-4.1 não tem raciocínio. Níveis não suportados são rejeitados antes de a solicitação ser enviada (padrão: "default") | STRING | Não | "default"
"none"
"minimal"
"low"
"medium"
"high"
"xhigh"
"max" | +| `truncation` | A estratégia de truncamento a ser usada para a resposta do modelo. auto: Se o contexto desta resposta e das anteriores exceder o tamanho da janela de contexto do modelo, o modelo truncará a resposta para caber na janela de contexto, descartando itens de entrada no meio da conversa. disabled: Se uma resposta do modelo exceder o tamanho da janela de contexto de um modelo, a solicitação falhará com um erro 400 (padrão: "auto") | COMBO | Sim | "auto"
"disabled" | +| `max_output_tokens` | Um limite superior para o número de tokens que podem ser gerados em uma resposta, incluindo tokens de saída visíveis e tokens de raciocínio (padrão: 4096) | INT | Não | 16 a 16384 | +| `instructions` | Instruções para o modelo sobre como gerar a resposta (entrada multilinha suportada) | STRING | Não | - | +| `reasoning_effort` | O quanto o modelo raciocina antes de responder. "default" deixa a escolha para o modelo. Os níveis suportados variam conforme o modelo: GPT-6 Astra de low a max, GPT-5.6 de none a max (sem minimal), GPT-5.5 de none a xhigh, GPT-5.5 Pro de medium a xhigh, GPT-5 de minimal a high, série o de low a high; GPT-4.1 não tem raciocínio. Níveis não suportados são rejeitados antes do envio da solicitação. (padrão: "default") | COMBO | Não | "default"
"none"
"minimal"
"low"
"medium"
"high"
"xhigh"
"max" | + +Nota: Embora `top_p` e `temperature` sejam listados como propriedades na especificação da API, eles não são suportados para todos os modelos e, portanto, não são expostos como entradas. ## Saídas | Nome da Saída | Descrição | Tipo de Dados | |-------------|-------------|-----------| -| `OPENAI_CHAT_CONFIG` | Objeto de configuração contendo as configurações especificadas para uso com os nós do ChatGPT da OpenAI | OPENAI_CHAT_CONFIG | - -## Notas - -- O parâmetro `max_output_tokens` define um limite superior para o número total de tokens, incluindo tokens visíveis e tokens de raciocínio. -- O parâmetro `reasoning_effort` permite que você especifique o nível de raciocínio que o modelo deve aplicar antes de gerar uma resposta. Os níveis suportados variam dependendo do modelo usado. -- O parâmetro `instructions` pode ser usado para fornecer instruções detalhadas ao modelo para guiar o processo de geração de respostas. -- O parâmetro `truncation` determina se o modelo deve truncar automaticamente a resposta se ela exceder o tamanho da janela de contexto ou falhar com um erro 400. +| `OPENAI_CHAT_CONFIG` | Objeto de configuração contendo as configurações especificadas para uso com os Nós de Chat OpenAI | OPENAI_CHAT_CONFIG | > 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/OpenAIChatConfig/pt-BR.md) diff --git a/comfyui_embedded_docs/docs/OpenAIChatConfig/ru.md b/comfyui_embedded_docs/docs/OpenAIChatConfig/ru.md index fee1ee14a..c444fac52 100644 --- a/comfyui_embedded_docs/docs/OpenAIChatConfig/ru.md +++ b/comfyui_embedded_docs/docs/OpenAIChatConfig/ru.md @@ -1,34 +1,23 @@ # Расширенные настройки OpenAI ChatGPT -# Уровень настроек OpenAI ChatGPT Дополнительные параметры - -Уровень настроек OpenAI ChatGPT Дополнительные параметры позволяет настроить дополнительные параметры для узлов OpenAI Chat Nodes. Этот уровень настроек предоставляет продвинутые параметры, которые контролируют способ генерации ответов моделью, включая поведение обрезки, ограничения длины вывода и пользовательские инструкции. - -## Обзор - -Уровень настроек OpenAI ChatGPT Дополнительные параметры разработан для улучшения функциональности узлов OpenAI Chat Nodes, позволяя пользователям specify продвинутые параметры конфигурации. Эти настройки могут помочь настроить генерацию ответов модели в соответствии с конкретными требованиями. +Узел OpenAIChatConfig позволяет задавать дополнительные параметры, управляющие тем, как узел OpenAI Chat формирует ответы. Вы можете настроить стратегию усечения, ограничить количество выходных токенов, задать пользовательские инструкции и выбрать, насколько глубоко модель должна «рассуждать» перед ответом. ## Входы -| Параметр | Описание | Тип данных | Обязателен | Диапазон | +| Параметр | Описание | Тип данных | Требуется | Диапазон | |-----------|-------------|-----------|----------|-------| -| `усечение` | Стратегия обрезки для ответа модели. auto: Если контекст этого ответа и предыдущих exceeds exceeds размер окна контекста модели, модель обрежет ответ, чтобы вписаться в окно контекста, удалив элементы ввода в середине разговора. disabled: Если ответ модели exceed exceed размер окна контекста для модели, запрос будет fail с ошибкой 400 (по умолчанию: "auto") | STRING | Да | "auto"
"disabled" | -| `макс_выходные_токены` | Верхний предел числа токенов, которые могут быть сгенерированы для ответа, включая видимые токены вывода и токены рассуждения (по умолчанию: 4096) | INT | Нет | 16 до 16384 | -| `инструкции` | Инструкции для модели о том, как генерировать ответ (поддерживается ввод multiline) | STRING | Нет | - | -| `reasoning_effort` | Степень рассуждения модели перед ответом. 'default' оставляет выбор модели. Поддерживаемые уровни различаются в зависимости от модели: GPT-6 Astra low-max, GPT-5.6 none-max (без minimal), GPT-5.5 none-xhigh, GPT-5.5 Pro medium-xhigh, GPT-5 minimal-high, o-series low-high; GPT-4.1 не имеет рассуждения. Неподдерживаемые уровни отклоняются до того, как запрос будет отправлен (по умолчанию: "default") | STRING | Нет | "default"
"none"
"minimal"
"low"
"medium"
"high"
"xhigh"
"max" | +| `усечение` | Стратегия усечения, используемая для ответа модели. auto: если контекст этого ответа и предыдущих ответов превышает размер окна контекста модели, модель усечёт ответ, чтобы он поместился в окно контекста, отбрасывая элементы в середине разговора. disabled: если ответ модели превысит размер окна контекста модели, запрос завершится ошибкой 400 (по умолчанию: "auto") | COMBO | Да | "auto"
"disabled" | +| `макс_выходные_токены` | Верхняя граница количества токенов, которые могут быть сгенерированы для ответа, включая видимые выходные токены и токены рассуждений (по умолчанию: 4096) | INT | Нет | 16 до 16384 | +| `инструкции` | Инструкции модели о том, как формировать ответ (поддерживается многострочный ввод) | STRING | Нет | - | +| `reasoning_effort` | Определяет, насколько глубоко модель рассуждает перед ответом. Значение "default" оставляет выбор за моделью. Поддерживаемые уровни различаются в зависимости от модели: GPT-6 Astra — от low до max, GPT-5.6 — от none до max (без минимального), GPT-5.5 — от none до xhigh, GPT-5.5 Pro — от medium до xhigh, GPT-5 — от minimal до high, o-series — от low до high; GPT-4.1 не поддерживает рассуждения. Неподдерживаемые уровни отклоняются до отправки запроса. (по умолчанию: "default") | COMBO | Нет | "default"
"none"
"minimal"
"low"
"medium"
"high"
"xhigh"
"max" | + +Примечание: хотя свойства `top_p` и `temperature` перечислены в спецификации API, они поддерживаются не всеми моделями и поэтому не выведены во входные параметры. ## Выходы -| Название вывода | Описание | Тип данных | +| Имя выхода | Описание | Тип данных | |-------------|-------------|-----------| -| `OPENAI_CHAT_CONFIG` | Объект конфигурации, содержащий指定的 настройки для использования с узлами OpenAI Chat Nodes | OPENAI_CHAT_CONFIG | - -## Примечания - -- Параметр `max_output_tokens` устанавливает верхний предел общего числа токенов, включая как видимые токены вывода, так и токены рассуждения. -- Параметр `reasoning_effort` позволяет specify specify уровень рассуждения, который модель должна apply apply перед генерацией ответа. Поддерживаемые уровни различаются в зависимости от используемой модели. -- Параметр `instructions` можно использовать для предоставления подробных инструкций модели для guidance guidance процесса генерации ответа. -- Параметр `truncation` определяет, должен ли модель автоматически truncate truncate ответ, если он exceeds exceeds размер окна контекста, или fail fail с ошибкой 400. +| `OPENAI_CHAT_CONFIG` | Объект конфигурации, содержащий указанные настройки для использования с узлами OpenAI Chat | OPENAI_CHAT_CONFIG | > Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/OpenAIChatConfig/ru.md) diff --git a/comfyui_embedded_docs/docs/OpenAIChatConfig/tr.md b/comfyui_embedded_docs/docs/OpenAIChatConfig/tr.md index 6b78246f9..8c50e2f90 100644 --- a/comfyui_embedded_docs/docs/OpenAIChatConfig/tr.md +++ b/comfyui_embedded_docs/docs/OpenAIChatConfig/tr.md @@ -1,32 +1,23 @@ # OpenAI ChatGPT Gelişmiş Seçenekler -OpenAI ChatGPT Gelişmiş Seçenekleri düğümü, OpenAI Chat Düğmeleri için ek ayarlar belirlemenize olanak tanır. Bu düğüm, modelin yanıtlarını oluşturma şeklini kontrol eden kesme davranışı, çıktı uzunluk sınırları ve özel talimatlar gibi ileri düzey ayarlar sağlar. - -## Genel Bakış - -OpenAI ChatGPT Gelişmiş Seçenekleri düğümü, kullanıcıların ileri düzey yapılandırma seçeneklerini belirtmesine olanak tanıyan ve OpenAI Chat Düğmeleri'nin işlevselliğini artıran bir yapıdadır. Bu ayarlar, modelin yanıtlarını belirli gereksinimlere uyacak şekilde özelleştirmek için yardımcı olabilir. +OpenAIChatConfig düğümü, OpenAI Chat Node'un yanıtları nasıl oluşturacağını kontrol eden gelişmiş seçenekler tanımlamanızı sağlar. Kırpma stratejisini belirleyebilir, çıktı token sayısını sınırlayabilir, özel talimatlar sağlayabilir ve modelin yanıt vermeden önce ne kadar akıl yürüteceğini seçebilirsiniz. ## Girdiler -| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +| Parameter | Açıklama | Veri Türü | Zorunlu | Aralık | |-----------|-------------|-----------|----------|-------| -| `kırpma` | Model yanıtının kullanılacak kesme stratejisi. auto: Bu yanıtın ve önceki yanıtların bağlamın modelin bağlam pencere boyutunu aşması durumunda, model konuşmanın ortasında girdi öğelerini atarak bağlam pencereye sığacak şekilde yanıtını keser. disabled: Bir model yanıtı bağlam pencere boyutunu aşarsa, istek 400 hatası ile başarısız olur (varsayılan: "auto") | STRING | Evet | "auto"
"disabled" | -| `maksimum_çıktı_tokenları` | Bir yanıt için oluşturulabilecek toplam token sayısının üst sınırları, görünen çıktı token'ları ve mantıksal token'ları içermektedir (varsayılan: 4096) | INT | Hayır | 16 ila 16384 | -| `talimatlar` | Modelin yanıt oluşturma konusunda vereceği talimatlar (çok satırlı girdi desteklenmektedir) | STRING | Hayır | - | -| `reasoning_effort` | Yanıta yanıt vermeden önce modelin ne kadar mantık yürüteceğini belirler. 'default' seçeneği modelin seçimine bırakır. Desteklenen seviyeler her model için farklıdır: GPT-6 Astra low-max, GPT-5.6 none-max (en az minimal), GPT-5.5 none-xhigh, GPT-5.5 Pro medium-xhigh, GPT-5 minimal-high, o-series low-high; GPT-4.1'de mantık yoktur. Desteklenmeyen seviyeler istek göndermeden önce reddedilir (varsayılan: "default") | STRING | Hayır | "default"
"none"
"minimal"
"low"
"medium"
"high"
"xhigh"
"max" | +| `kırpma` | Model yanıtı için kullanılacak kırpma stratejisi. auto: Bu yanıtın ve önceki yanıtların bağlamı, modelin bağlam penceresi boyutunu aşarsa, model, konuşmanın ortasındaki girdi öğelerini atarak yanıtı bağlam penceresine sığacak şekilde kırpar. disabled: Bir model yanıtı, söz konusu model için bağlam penceresi boyutunu aşarsa istek 400 hatasıyla başarısız olur (varsayılan: "auto") | COMBO | Evet | "auto"
"disabled" | +| `maksimum_çıktı_tokenları` | Bir yanıt için oluşturulabilecek token sayısının üst sınırı; görünür çıktı tokenleri ve akıl yürütme tokenleri dahildir (varsayılan: 4096) | INT | Hayır | 16 ile 16384 | +| `talimatlar` | Modelin yanıtı nasıl oluşturacağına ilişkin talimatlar (çok satırlı girdi desteklenir) | STRING | Hayır | - | +| `reasoning_effort` | Modelin yanıtlamadan önce ne kadar akıl yürüteceği. "default", seçimi modele bırakır. Desteklenen düzeyler modele göre farklılık gösterir: GPT-6 Astra low-max, GPT-5.6 none-max (minimal düzeyi yok), GPT-5.5 none-xhigh, GPT-5.5 Pro medium-xhigh, GPT-5 minimal-high, o-series low-high; GPT-4.1 akıl yürütmeyi desteklemez. Desteklenmeyen düzeyler, istek gönderilmeden önce reddedilir. (varsayılan: "default") | COMBO | Hayır | "default"
"none"
"minimal"
"low"
"medium"
"high"
"xhigh"
"max" | + +Not: `top_p` ve `temperature` API belirtiminde özellikler olarak listelenmiş olsa da tüm modellerde desteklenmez ve bu nedenle girdi olarak sunulmaz. ## Çıktılar | Çıktı Adı | Açıklama | Veri Türü | |-------------|-------------|-----------| -| `OPENAI_CHAT_CONFIG` | Belirtilen ayarları OpenAI Chat Düğmeleri ile kullanmak için içeren yapılandırma nesnesi | OPENAI_CHAT_CONFIG | - -## Notlar - -- `max_output_tokens` parametresi, toplam token sayısının üst sınırlarını belirler, bu da görünen çıktı token'ları ve mantıksal token'ları içermektedir. -- `reasoning_effort` parametresi, modelin yanıt oluşturma öncesinde ne kadar mantık yürüteceğini belirler. Desteklenen seviyeler her model için farklıdır. -- `instructions` parametresi, modelin yanıt oluşturma sürecini yönlendirmek için ayrıntılı talimatlar sağlayabilir. -- `truncation` parametresi, modelin bağlam pencere boyutunu aşarsa yanıtını otomatik olarak kesip kesmeyeceğini veya 400 hatası ile başarısız olacağını belirler. +| `OPENAI_CHAT_CONFIG` | OpenAI Chat Node ile kullanım için belirtilen ayarları içeren yapılandırma nesnesi | OPENAI_CHAT_CONFIG | > 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/OpenAIChatConfig/tr.md) diff --git a/comfyui_embedded_docs/docs/OpenAIChatConfig/zh-TW.md b/comfyui_embedded_docs/docs/OpenAIChatConfig/zh-TW.md index 40af69360..0de2ea64b 100644 --- a/comfyui_embedded_docs/docs/OpenAIChatConfig/zh-TW.md +++ b/comfyui_embedded_docs/docs/OpenAIChatConfig/zh-TW.md @@ -1,34 +1,23 @@ # OpenAI ChatGPT 進階選項 -# OpenAI ChatGPT 高級選項 - -OpenAI ChatGPT 高級選項節點允許您為 OpenAI Chat 節點設定額外的配置。此節點提供高級設定,用於控制模型生成回應的方式,包括截斷行為、輸出長度限制和自定義指令。 - -## 概述 - -OpenAI ChatGPT 高級選項節點設計用於提升 OpenAI Chat 節點的功能,讓使用者可以指定高級配置選項。這些設定可以幫助調整模型的回應生成以符合特定需求。 +**OpenAIChatConfig 節點可讓您定義進階選項,以控制 OpenAI Chat 節點產生回應的方式。您可以設定截斷策略、限制輸出 token 數量、提供自訂指示,以及選擇模型在回答前應進行多少推理。** ## 輸入 -| 參數名 | 描述 | 資料類型 | 是否必填 | 范圍 | +| 參數 | 描述 | 資料類型 | 必要 | 範圍 | |-----------|-------------|-----------|----------|-------| -| `truncation` | 使用於模型回應的截斷策略。auto:如果此回應及其之前的回應的上下文超過模型的上下文視窗大小,模型將通過丟棄對話中間的輸入項目來截斷回應,以適應上下文視窗。disabled:如果模型回應將超過模型的上下文視窗大小,請求將會失敗並返回 400 錯誤(默認:"auto") | STRING | 是 | "auto"
"disabled" | -| `max_output_tokens` | 設定回應可以生成的代碼數量的上限,包括可見輸出代碼和推理代碼(默認:4096) | INT | 否 | 16 到 16384 | -| `instructions` | 指示模型如何生成回應的指令(支援多行輸入) | STRING | 否 | - | -| `reasoning_effort` | 模型在回答之前推理的程度。'default' 將選擇權留給模型。支援的等級因模型而異:GPT-6 Astra low-max、GPT-5.6 none-max(沒有最小值)、GPT-5.5 none-xhigh、GPT-5.5 Pro medium-xhigh、GPT-5 minimal-high、o-series low-high;GPT-4.1 沒有推理。不支援的等級在請求發送之前將被拒絕(默認:"default") | STRING | 否 | "default"
"none"
"minimal"
"low"
"medium"
"high"
"xhigh"
"max" | +| `truncation` | 用於模型回應的截斷策略。auto:如果此回應及先前回應的上下文超過模型的上下文視窗大小,模型將透過捨棄對話中間的輸入項目來截斷回應,以符合上下文視窗。disabled:如果模型回應將超過模型的上下文視窗大小,請求將失敗並返回 400 錯誤(預設值:"auto") | COMBO | 是 | "auto"
"disabled" | +| `max_output_tokens` | 回應可產生的 token 數量上限,包含可見輸出 token 與推理 token(預設值:4096) | INT | 否 | 16至16384 | +| `instructions` | 提供給模型如何產生回應的指示(支援多行輸入) | STRING | 否 | - | +| `reasoning_effort` | 模型在回答前的推理程度。「default」將選擇權留給模型。支援的程度依模型而異:GPT-6 Astra low-max、GPT-5.6 none-max(無 minimal)、GPT-5.5 none-xhigh、GPT-5.5 Pro medium-xhigh、GPT-5 minimal-high、o-series low-high;GPT-4.1 不進行推理。不支援的程度會於請求送出前被拒絕。(預設值:"default") | COMBO | 否 | "default"
"none"
"minimal"
"low"
"medium"
"high"
"xhigh"
"max" | + +注意:雖然 `top_p` 與 `temperature` 在 API 規格中被列為屬性,但它們並非所有模型都支援,因此未公開作為輸入。 ## 輸出 -| 輸出名 | 描述 | 資料類型 | +| 輸出名稱 | 描述 | 資料類型 | |-------------|-------------|-----------| -| `OPENAI_CHAT_CONFIG` | 包含指定設定以供 OpenAI Chat 節點使用的配置物件 | OPENAI_CHAT_CONFIG | - -## 記錄 - -- `max_output_tokens` 參數設定總代碼數量的上限,包括可見輸出代碼和推理代碼。 -- `reasoning_effort` 參數允許您指定模型在生成回應之前應該進行的推理等級。支援的等級根據所使用的模型而有所不同。 -- `instructions` 參數可用於向模型提供詳細指令,以引導回應生成過程。 -- `truncation` 參數決定模型是否應自動截斷超過上下文視窗大小的回應,或返回 400 錯誤。 +| `OPENAI_CHAT_CONFIG` | 包含指定設定的設定物件,供 OpenAI Chat 節點使用 | OPENAI_CHAT_CONFIG | > 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/OpenAIChatConfig/zh-TW.md) diff --git a/comfyui_embedded_docs/docs/OpenAIChatConfig/zh.md b/comfyui_embedded_docs/docs/OpenAIChatConfig/zh.md index 31b21a70b..82c1702e9 100644 --- a/comfyui_embedded_docs/docs/OpenAIChatConfig/zh.md +++ b/comfyui_embedded_docs/docs/OpenAIChatConfig/zh.md @@ -1,32 +1,23 @@ # OpenAI ChatGPT 高级选项 -OpenAI ChatGPT 高级选项节点允许您为 OpenAI Chat 节点设置额外的配置。此节点提供高级设置,用于控制模型生成响应的方式,包括截断行为、输出长度限制和自定义指令。 - -## 概述 - -OpenAI ChatGPT 高级选项节点旨在通过允许用户指定高级配置选项来增强 OpenAI Chat 节点的功能。这些设置可以帮助调整模型响应生成以满足特定需求。 +OpenAIChatConfig 节点可让您定义用于控制 OpenAI Chat 节点如何生成响应的高级选项。您可以设置截断策略、限制输出 token 数量、提供自定义指令,并选择模型在回答前应进行多少推理。 ## 输入 -| 参数 | 描述 | 数据类型 | 必需 | 范围 | +| 参数 | 描述 | 数据类型 | 是否必填 | 范围 | |-----------|-------------|-----------|----------|-------| -| `截断` | 用于模型响应的截断策略。auto:如果此响应及其之前的响应的上下文超过了模型上下文窗口大小,模型将通过丢弃对话中间的输入项来截断响应以适应上下文窗口。disabled:如果模型响应将超过模型的上下文窗口大小,请求将失败并返回 400 错误(默认:"auto") | STRING | 是 | "auto"
"disabled" | -| `Token输出上限` | 响应可以生成的令牌数量的上限,包括可见输出令牌和推理令牌(默认:4096) | INT | 否 | 16 到 16384 | -| `指令` | 模型生成响应的指令(支持多行输入) | STRING | 否 | - | -| `reasoning_effort` | 模型在回答之前推理的程度。'default' 将选择权留给模型。支持的级别因模型而异:GPT-6 Astra low-max,GPT-5.6 none-max(无最小值),GPT-5.5 none-xhigh,GPT-5.5 Pro medium-xhigh,GPT-5 minimal-high,o-series low-high;GPT-4.1 无推理。不支持的水平在请求发送之前被拒绝(默认:"default") | STRING | 否 | "default"
"none"
"minimal"
"low"
"medium"
"high"
"xhigh"
"max" | +| `截断` | 用于模型响应的截断策略。auto:如果当前响应与此前响应的上下文超过模型的上下文窗口大小,模型将截断响应,通过丢弃对话中部的输入项来使其适应上下文窗口。disabled:如果模型响应将超过模型的上下文窗口大小,请求将失败并返回 400 错误(默认值:"auto") | COMBO | 是 | "auto"
"disabled" | +| `Token输出上限` | 响应可生成的 token 数量上限,包括可见输出 token 和推理 token(默认值:4096) | INT | 否 | 16到16384 | +| `指令` | 有关模型如何生成响应的指令(支持多行输入) | STRING | 否 | - | +| `reasoning_effort` | 模型在回答前进行多少推理。"default" 将选择权留给模型。支持的级别因模型而异:GPT-6 Astra 支持 low 到 max,GPT-5.6 支持 none 到 max(无 minimal),GPT-5.5 支持 none 到 xhigh,GPT-5.5 Pro 支持 medium 到 xhigh,GPT-5 支持 minimal 到 high,o-series 支持 low 到 high;GPT-4.1 不支持推理。不支持的级别会在请求发送前被拒绝。(默认值:"default") | COMBO | 否 | "default"
"none"
"minimal"
"low"
"medium"
"high"
"xhigh"
"max" | + +注意:虽然 API 规范中将 `top_p` 和 `temperature` 列为属性,但并非所有模型都支持它们,因此未将它们作为输入公开。 ## 输出 | 输出名称 | 描述 | 数据类型 | |-------------|-------------|-----------| -| `OPENAI_CHAT_CONFIG` | 包含用于与 OpenAI Chat 节点一起使用的指定设置的配置对象 | OPENAI_CHAT_CONFIG | - -## 注意事项 - -- `max_output_tokens` 参数设置了总令牌数量的上限,包括可见输出令牌和推理令牌。 -- `reasoning_effort` 参数允许您指定模型在生成响应之前应应用的推理级别。支持的级别取决于所使用的模型。 -- `instructions` 参数可用于向模型提供详细的指令,以指导响应生成过程。 -- `truncation` 参数确定模型是否应自动截断超出上下文窗口大小的响应,或者失败并返回 400 错误。 +| `OPENAI_CHAT_CONFIG` | 包含指定设置的配置对象,用于 OpenAI Chat 节点 | OPENAI_CHAT_CONFIG | > 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/OpenAIChatConfig/zh.md) diff --git a/comfyui_embedded_docs/docs/OpenAIChatNode/ar.md b/comfyui_embedded_docs/docs/OpenAIChatNode/ar.md index 33c4317ae..0dacbd59e 100644 --- a/comfyui_embedded_docs/docs/OpenAIChatNode/ar.md +++ b/comfyui_embedded_docs/docs/OpenAIChatNode/ar.md @@ -1,33 +1,25 @@ # OpenAI ChatGPT -يُنتج هذا العقد ردود نصية من نموذج OpenAI. يتلقى إدخالات نصية واختياري صور أو ملفات كسياق، ثم يرسل هذه المعلومات إلى نموذج OpenAI لإنشاء رد نصي. +هذه العقدة تولّد استجابات نصية من نموذج OpenAI. تُرسل نص المطالبة الخاص بك، واختياريًا الصور أو الملفات، إلى نموذج OpenAI وتُرجِع الاستجابة النصية المُولَّدة. ## المدخلات -| المعامل | الوصف | نوع البيانات | إلزامي | نطاق | +| المعامل | الوصف | نوع البيانات | إلزامي | النطاق | |-----------|-------------|-----------|----------|-------| -| `prompt` | إدخالات النص إلى النموذج، تستخدم لإنشاء الرد. هذا هو النص الذي تريد أن يرد النموذج عليه. | STRING | نعم | - | -| `persist_context` | هذا المعامل تم إزالته ولم يعد له أي تأثير. تم إضافته للتوافق مع الإصدارات السابقة ولكنه لا يؤثر على سلوك العقد. | BOOLEAN | لا | - | -| `model` | النموذج المستخدم لإنشاء الرد. اختر من بين النماذج المتاحة لـ OpenAI. | COMBO | نعم | gpt-6-astra
gpt-5.6-sol
gpt-5.6-terra
gpt-5.6-luna
gpt-5.5-pro
gpt-5.5
gpt-5
gpt-5-mini
gpt-5-nano
gpt-4.1
gpt-4.1-mini
gpt-4.1-nano
o4-mini
o3
o1-pro
o1 | -| `images` | صور اختيارية تستخدم كسياق للنموذج. لاستخدام صور متعددة، يمكنك استخدام عقد Batch Images. | IMAGE | لا | - | -| `files` | ملفات اختيارية تستخدم كسياق للنموذج. يقبل الإدخالات من عقد OpenAI Chat Input Files. | OPENAI_INPUT_FILES | لا | - | -| `advanced_options` | تكوين اختياري للنموذج. يقبل الإدخالات من عقد OpenAI Chat Advanced Options. | OPENAI_CHAT_CONFIG | لا | - | +| `prompt` | النصوص المُدخلة إلى النموذج، وتُستخدم لتوليد استجابة (الافتراضي: سلسلة فارغة). | STRING | نعم | - | +| `persist_context` | هذه المعلمة مُهملة وليس لها أي تأثير (الافتراضي: False). | BOOLEAN | نعم | - | +| `model` | النموذج المستخدم لتوليد الاستجابة (الافتراضي: `gpt-5`) | COMBO | نعم | `gpt-6-astra`
`gpt-5.6-sol`
`gpt-5.6-terra`
`gpt-5.6-luna`
`gpt-5.5-pro`
`gpt-5.5`
`gpt-5`
`gpt-5-mini`
`gpt-5-nano`
`gpt-4.1`
`gpt-4.1-mini`
`gpt-4.1-nano`
`o4-mini`
`o3`
`o1-pro`
`o1` | +| `images` | صورة أو صور اختيارية لاستخدامها كسياق للنموذج. لتضمين صور متعددة، يمكنك استخدام عقدة Batch Images. | IMAGE | لا | - | +| `files` | ملفات اختيارية لاستخدامها كسياق للنموذج. تقبل مدخلات من عقدة OpenAI Chat Input Files. | OPENAI_INPUT_FILES | لا | - | +| `advanced_options` | إعداد اختياري للنموذج. يقبل مدخلات من عقدة OpenAI Chat Advanced Options. | OPENAI_CHAT_CONFIG | لا | - | + +ملاحظة: عند توصيل إعداد `advanced_options` يحدد مستوى جهد الاستدلال، يجب أن يدعم النموذج المحدد قيمة مستوى الجهد هذا. على سبيل المثال، لا تدعم عائلة نماذج gpt-4.1 أي مستوى من مستويات جهد الاستدلال، بينما يدعم `gpt-5.5` القيم none وlow وmedium وhigh وxhigh، ويدعم `gpt-5.5-pro` القيم medium وhigh وxhigh. إذا كان مستوى جهد الاستدلال غير مدعوم من النموذج المحدد، تُصدر العقدة خطأً. ## المخرجات -| اسم المخرج | الوصف | نوع البيانات | +| اسم المُخرَج | الوصف | نوع البيانات | |-------------|-------------|-----------| -| `output_text` | النص الرد الذي أنشأه نموذج OpenAI. هذا هو النص المُنتج بناءً على الإدخال النصي والسياق. | STRING | - -## ملاحظات - -- المعامل `persist_context` تم إزالته ولم يعد له أي تأثير. تم إضافته للتوافق مع الإصدارات السابقة ولكنه لا يجب استخدامه. -- يمكن استخدام الإدخال `images` لتقديم سياق إضافي للنموذج. إذا تم تقديم صور متعددة، يجب ربطها باستخدام عقد Batch Images. -- يسمح الإدخال `files` بتقديم سياق إضافي على شكل ملفات. يجب ربط هذه الملفات من عقد OpenAI Chat Input Files. -- يسمح الإدخال `advanced_options` بتكوين سلوك النموذج بشكل مفصل. يجب ربط هذا الإدخال من عقد OpenAI Chat Advanced Options. -- تكلفة استخدام هذا العقد تعتمد على النموذج المختار. يتم حساب التكلفة بناءً على عدد التokens المستخدمة من قبل النموذج. سيتم عرض تكلفة الدقة في واجهة العقد. - -هذه الوثيقة تعكس التغييرات في الكود المصدر، بما في ذلك إزالة المعامل المزيل `persist_context` وإضافة المدخلات `images` و`files`. كما تُبقِ الوثيقة الوصفات والملحوظات التي كتبت يدويًا من الوثيقة الموجودة وما تزال صحيحة. +| `output_text` | نص الاستجابة الذي يولده نموذج OpenAI. | STRING | > تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/OpenAIChatNode/ar.md) diff --git a/comfyui_embedded_docs/docs/OpenAIChatNode/en.md b/comfyui_embedded_docs/docs/OpenAIChatNode/en.md index 6b88a7b82..6199b037b 100644 --- a/comfyui_embedded_docs/docs/OpenAIChatNode/en.md +++ b/comfyui_embedded_docs/docs/OpenAIChatNode/en.md @@ -1,33 +1,25 @@ # OpenAI ChatGPT -This node generates text responses from an OpenAI model. It takes a text prompt and optionally images or files as context, and then sends this information to an OpenAI model to generate a text response. +This node generates text responses from an OpenAI model. It sends your text prompt, and optionally images or files, to an OpenAI model and returns the generated text response. ## Inputs | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `prompt` | Text inputs to the model, used to generate a response. This is the text that you want the model to respond to. | STRING | Yes | - | -| `persist_context` | This parameter is deprecated and has no effect. It is included for backward compatibility but does not influence the node's behavior. | BOOLEAN | No | - | -| `model` | The model used to generate the response. Select from the available OpenAI models. | COMBO | Yes | gpt-6-astra
gpt-5.6-sol
gpt-5.6-terra
gpt-5.6-luna
gpt-5.5-pro
gpt-5.5
gpt-5
gpt-5-mini
gpt-5-nano
gpt-4.1
gpt-4.1-mini
gpt-4.1-nano
o4-mini
o3
o1-pro
o1 | +| `prompt` | Text inputs to the model, used to generate a response (default: empty string). | STRING | Yes | - | +| `persist_context` | This parameter is deprecated and has no effect (default: False). | BOOLEAN | Yes | - | +| `model` | The model used to generate the response (default: `gpt-5`) | COMBO | Yes | `gpt-6-astra`
`gpt-5.6-sol`
`gpt-5.6-terra`
`gpt-5.6-luna`
`gpt-5.5-pro`
`gpt-5.5`
`gpt-5`
`gpt-5-mini`
`gpt-5-nano`
`gpt-4.1`
`gpt-4.1-mini`
`gpt-4.1-nano`
`o4-mini`
`o3`
`o1-pro`
`o1` | | `images` | Optional image(s) to use as context for the model. To include multiple images, you can use the Batch Images node. | IMAGE | No | - | | `files` | Optional file(s) to use as context for the model. Accepts inputs from the OpenAI Chat Input Files node. | OPENAI_INPUT_FILES | No | - | | `advanced_options` | Optional configuration for the model. Accepts inputs from the OpenAI Chat Advanced Options node. | OPENAI_CHAT_CONFIG | No | - | +Note: When an `advanced_options` configuration that sets a reasoning effort is connected, the selected `model` must support that effort value. For example, the gpt-4.1 family of models does not support any reasoning effort, `gpt-5.5` supports none, low, medium, high and xhigh, and `gpt-5.5-pro` supports medium, high and xhigh. If the reasoning effort is not supported by the selected model, the node raises an error. + ## Outputs | Output Name | Description | Data Type | |-------------|-------------|-----------| -| `output_text` | The text response generated by the OpenAI model. This is the generated text based on the input prompt and context. | STRING | - -## Notes - -- The `persist_context` parameter is deprecated and has no effect. It is included for backward compatibility but should not be used. -- The `images` input can be used to provide additional context to the model. If multiple images are provided, they should be connected using the Batch Images node. -- The `files` input allows you to provide additional context in the form of files. These files should be connected from the OpenAI Chat Input Files node. -- The `advanced_options` input allows for more detailed configuration of the model's behavior. This should be connected from the OpenAI Chat Advanced Options node. -- The pricing for using this node depends on the model selected. The cost is calculated based on the number of tokens used by the model. The exact cost will be displayed in the node's UI. - -This documentation reflects the changes in the source code, including the removal of the deprecated `persist_context` parameter and the addition of the `images` and `files` inputs. It also retains the human-written descriptions and notes from the existing documentation that are still accurate. +| `output_text` | The text response generated by the OpenAI 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/OpenAIChatNode/en.md) diff --git a/comfyui_embedded_docs/docs/OpenAIChatNode/es.md b/comfyui_embedded_docs/docs/OpenAIChatNode/es.md index ccd72a5b4..999af29bf 100644 --- a/comfyui_embedded_docs/docs/OpenAIChatNode/es.md +++ b/comfyui_embedded_docs/docs/OpenAIChatNode/es.md @@ -1,31 +1,25 @@ # OpenAI ChatGPT -Este nodo genera respuestas de texto a partir de un modelo de OpenAI. Acepta un texto de entrada y, opcionalmente, imágenes o archivos como contexto, y luego envía esta información a un modelo de OpenAI para generar una respuesta de texto. +Este nodo genera respuestas de texto a partir de un modelo OpenAI. Envía el prompt de texto y, opcionalmente, imágenes o archivos a un modelo OpenAI, y devuelve la respuesta de texto generada. ## Entradas -| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango | -|-----------|-------------|-----------|----------|-------| -| `prompt` | Entradas de texto al modelo, utilizadas para generar una respuesta. Este es el texto al que el modelo debe responder. | STRING | Sí | - | -| `persistir_contexto` | Este parámetro está obsoleto y no tiene efecto. Se incluye por compatibilidad con versiones anteriores, pero no influye en el comportamiento del nodo. | BOOLEAN | No | - | -| `modelo` | El modelo utilizado para generar la respuesta. Seleccione entre los modelos de OpenAI disponibles. | COMBO | Sí | gpt-6-astra
gpt-5.6-sol
gpt-5.6-terra
gpt-5.6-luna
gpt-5.5-pro
gpt-5.5
gpt-5
gpt-5-mini
gpt-5-nano
gpt-4.1
gpt-4.1-mini
gpt-4.1-nano
o4-mini
o3
o1-pro
o1 | -| `imágenes` | Imágenes opcionales para utilizar como contexto para el modelo. Para incluir múltiples imágenes, utilice el nodo de Imágenes en lote. | IMAGE | No | - | -| `archivos` | Archivos opcionales para utilizar como contexto para el modelo. Acepta entradas del nodo de Entradas de archivos de Chat de OpenAI. | OPENAI_INPUT_FILES | No | - | -| `opciones_avanzadas` | Configuración opcional para el modelo. Acepta entradas del nodo de Opciones avanzadas de Chat de OpenAI. | OPENAI_CHAT_CONFIG | No | - | +| Parámetro | Descripción | Tipo de dato | Obligatorio | Rango | +|-----------|-------------|--------------|-------------|-------| +| `prompt` | Entradas de texto para el modelo, utilizadas para generar una respuesta (por defecto: cadena vacía). | STRING | Sí | - | +| `persistir_contexto` | Este parámetro está obsoleto y no tiene efecto (por defecto: False). | BOOLEAN | Sí | - | +| `modelo` | El modelo utilizado para generar la respuesta (por defecto: `gpt-5`). | COMBO | Sí | `gpt-6-astra`
`gpt-5.6-sol`
`gpt-5.6-terra`
`gpt-5.6-luna`
`gpt-5.5-pro`
`gpt-5.5`
`gpt-5`
`gpt-5-mini`
`gpt-5-nano`
`gpt-4.1`
`gpt-4.1-mini`
`gpt-4.1-nano`
`o4-mini`
`o3`
`o1-pro`
`o1` | +| `imágenes` | Opcional: imagen(es) para usar como contexto para el modelo. Para incluir varias imágenes, puedes usar el nodo Batch Images. | IMAGE | No | - | +| `archivos` | Opcional: archivo(s) para usar como contexto para el modelo. Acepta entradas del nodo OpenAI Chat Input Files. | OPENAI_INPUT_FILES | No | - | +| `opciones_avanzadas` | Opcional: configuración para el modelo. Acepta entradas del nodo OpenAI Chat Advanced Options. | OPENAI_CHAT_CONFIG | No | - | -## Salidas - -| Nombre de salida | Descripción | Tipo de datos | -|-------------|-------------|-----------| -| `output_text` | La respuesta de texto generada por el modelo de OpenAI. Este es el texto generado basado en el prompt de entrada y el contexto. | STRING | +Nota: Cuando se conecta una configuración `advanced_options` que establece un esfuerzo de razonamiento, el `model` seleccionado debe admitir ese valor de esfuerzo. Por ejemplo, la familia de modelos gpt-4.1 no admite ningún esfuerzo de razonamiento; `gpt-5.5` admite none, low, medium, high y xhigh; y `gpt-5.5-pro` admite medium, high y xhigh. Si el esfuerzo de razonamiento no es compatible con el modelo seleccionado, el nodo genera un error. -## Notas +## Salidas -- El parámetro `persist_context` está obsoleto y no tiene efecto. Se incluye por compatibilidad con versiones anteriores, pero no debe utilizarse. -- La entrada `images` puede utilizarse para proporcionar contexto adicional al modelo. Si se proporcionan múltiples imágenes, deben conectarse utilizando el nodo de Imágenes en lote. -- La entrada `files` permite proporcionar contexto adicional en forma de archivos. Estos archivos deben conectarse desde el nodo de Entradas de archivos de Chat de OpenAI. -- La entrada `advanced_options` permite una configuración más detallada del comportamiento del modelo. Esto debe conectarse desde el nodo de Opciones avanzadas de Chat de OpenAI. -- El costo de usar este nodo depende del modelo seleccionado. El costo se calcula basado en el número de tokens utilizados por el modelo. El costo exacto se mostrará en la IU del nodo. +| Nombre de salida | Descripción | Tipo de dato | +|------------------|-------------|--------------| +| `output_text` | La respuesta de texto generada por el modelo OpenAI. | 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/OpenAIChatNode/es.md) diff --git a/comfyui_embedded_docs/docs/OpenAIChatNode/fa.md b/comfyui_embedded_docs/docs/OpenAIChatNode/fa.md index dd645ea2a..8e29c0a55 100644 --- a/comfyui_embedded_docs/docs/OpenAIChatNode/fa.md +++ b/comfyui_embedded_docs/docs/OpenAIChatNode/fa.md @@ -1,32 +1,23 @@ # OpenAI ChatGPT -این گره پاسخ‌های متنی از مدل OpenAI تولید می‌کند. یک ورودی متنی و گزینه‌ای تصاویر یا فایل‌ها به عنوان زمینه، دریافت می‌کند و سپس این اطلاعات را به مدل OpenAI ارسال می‌کند تا پاسخ متنی تولید شود. - ## ورودی‌ها -| پارامتر | توضیح | نوع داده | الزامی | محدوده | +| پارامتر | توضیحات | نوع داده | الزامی | بازه | |-----------|-------------|-----------|----------|-------| -| `prompt` | ورودی‌های متنی به مدل، که برای تولید پاسخ استفاده می‌شود. این متنی است که می‌خواهید مدل به آن پاسخ دهد. | STRING | بله | - | -| `persist_context` | این پارامتر منسوخ شده و هیچ تأثیری ندارد. برای سازگاری با گذشته شامل شده است اما تأثیری بر رفتار گره ندارد. | BOOLEAN | خیر | - | -| `model` | مدلی که برای تولید پاسخ استفاده می‌شود. از بین مدل‌های موجود OpenAI انتخاب کنید. | COMBO | بله | gpt-6-astra
gpt-5.6-sol
gpt-5.6-terra
gpt-5.6-luna
gpt-5.5-pro
gpt-5.5
gpt-5
gpt-5-mini
gpt-5-nano
gpt-4.1
gpt-4.1-mini
gpt-4.1-nano
o4-mini
o3
o1-pro
o1 | -| `images` | تصویر(ها) گزینه‌ای برای استفاده به عنوان زمینه برای مدل. برای اضافه کردن چندین تصویر، می‌توانید از گره Batch Images استفاده کنید. | IMAGE | خیر | - | -| `files` | فایل(ها) گزینه‌ای برای استفاده به عنوان زمینه برای مدل. ورودی‌ها از گره OpenAI Chat Input Files دریافت می‌شوند. | OPENAI_INPUT_FILES | خیر | - | -| `advanced_options` | تنظیمات گزینه‌ای برای مدل. ورودی‌ها از گره OpenAI Chat Advanced Options دریافت می‌شوند. | OPENAI_CHAT_CONFIG | خیر | - | +| `prompt` | ورودی‌های متنی برای مدل که برای تولید پاسخ استفاده می‌شوند (پیش‌فرض: رشته خالی). | STRING | بله | - | +| `persist_context` | این پارامتر منسوخ شده است و تأثیری ندارد (پیش‌فرض: False). | BOOLEAN | بله | - | +| `model` | مدل مورد استفاده برای تولید پاسخ (پیش‌فرض: `gpt-5`) | COMBO | بله | `gpt-6-astra`
`gpt-5.6-sol`
`gpt-5.6-terra`
`gpt-5.6-luna`
`gpt-5.5-pro`
`gpt-5.5`
`gpt-5`
`gpt-5-mini`
`gpt-5-nano`
`gpt-4.1`
`gpt-4.1-mini`
`gpt-4.1-nano`
`o4-mini`
`o3`
`o1-pro`
`o1` | +| `images` | تصویر(های) اختیاری برای استفاده به‌عنوان زمینه برای مدل. برای گنجاندن چندین تصویر، می‌توانید از گره Batch Images استفاده کنید. | IMAGE | خیر | - | +| `files` | فایل(های) اختیاری برای استفاده به‌عنوان زمینه برای مدل. ورودی‌هایی را از گره OpenAI Chat Input Files می‌پذیرد. | OPENAI_INPUT_FILES | خیر | - | +| `advanced_options` | پیکربندی اختیاری برای مدل. ورودی‌هایی را از گره OpenAI Chat Advanced Options می‌پذیرد. | OPENAI_CHAT_CONFIG | خیر | - | + +توجه: هنگامی که پیکربندی `advanced_options` که یک تلاش استدلال را تنظیم می‌کند متصل باشد، `model` انتخاب‌شده باید از آن مقدار تلاش پشتیبانی کند. برای مثال، خانواده مدل‌های gpt-4.1 از هیچ تلاش استدلالی پشتیبانی نمی‌کند، `gpt-5.5` از none، low، medium، high و xhigh پشتیبانی می‌کند و `gpt-5.5-pro` از medium، high و xhigh پشتیبانی می‌کند. اگر تلاش استدلال توسط مدل انتخاب‌شده پشتیبانی نشود، گره خطا می‌دهد. ## خروجی‌ها -| نام خروجی | توضیح | نوع داده | +| نام خروجی | توضیحات | نوع داده | |-------------|-------------|-----------| -| `output_text` | پاسخ متنی تولید شده توسط مدل OpenAI. این متنی است که بر اساس ورودی‌های پیشنهادی و زمینه تولید شده است. | STRING | - -## یادداشت‌ها - -- پارامتر `persist_context` منسوخ شده و هیچ تأثیری ندارد. برای سازگاری با گذشته شامل شده است اما تأثیری بر رفتار گره ندارد. -- ورودی `images` می‌تواند برای ارائه زمینه اضافی به مدل استفاده شود. اگر چندین تصویر ارائه شد، باید با استفاده از گره Batch Images به هم متصل شوند. -- ورودی `files` به شما امکان می‌دهد تا زمینه اضافی به صورت فایل ارائه دهید. این فایل‌ها باید از گره OpenAI Chat Input Files متصل شوند. -- ورودی `advanced_options` برای تنظیمات دقیق‌تر رفتار مدل استفاده می‌شود. این ورودی باید از گره OpenAI Chat Advanced Options متصل شود. -- هزینه استفاده از این گره بستگی به مدلی دارد که انتخاب می‌کنید. هزینه بر اساس تعداد توکن‌های استفاده شده توسط مدل محاسبه می‌شود. هزینه دقیق در رابط کاربری گره نمایش داده می‌شود. -- این مستند تغییرات منبع کد را منعکس می‌کند، از جمله حذف پارامتر منسوخ شده `persist_context` و اضافه کردن ورودی‌های `images` و `files`. همچنین توضیحات دستی و یادداشت‌های موجود در مستند قبلی که همچنان معتبر هستند، حفظ شده‌اند. +| `output_text` | پاسخ متنی تولیدشده توسط مدل OpenAI. | STRING | > این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/OpenAIChatNode/fa.md) diff --git a/comfyui_embedded_docs/docs/OpenAIChatNode/fr.md b/comfyui_embedded_docs/docs/OpenAIChatNode/fr.md index 561b68e0b..b6dad3321 100644 --- a/comfyui_embedded_docs/docs/OpenAIChatNode/fr.md +++ b/comfyui_embedded_docs/docs/OpenAIChatNode/fr.md @@ -1,31 +1,25 @@ # OpenAI ChatGPT -Ce nœud génère des réponses textuelles à partir d'un modèle OpenAI. Il prend un texte d'invite et, en option, des images ou des fichiers en tant que contexte, puis envoie cette information à un modèle OpenAI pour générer une réponse textuelle. +Ce nœud génère des réponses textuelles à partir d’un modèle OpenAI. Il envoie votre invite textuelle, et éventuellement des images ou des fichiers, à un modèle OpenAI puis renvoie la réponse textuelle générée. ## Entrées -| Paramètre | Description | Type de données | Obligatoire | Gamme | -|-----------|-------------|-----------|----------|-------| -| `invite` | Entrées textuelles pour le modèle, utilisées pour générer une réponse. Ce est le texte auquel le modèle doit répondre. | STRING | Oui | - | -| `conserver_contexte` | Ce paramètre est obsolète et n'a aucun effet. Il est inclus pour la compatibilité ascendante mais n'influence pas le comportement du nœud. | BOOLEAN | Non | - | -| `modèle` | Le modèle utilisé pour générer la réponse. Sélectionnez parmi les modèles OpenAI disponibles. | COMBO | Oui | gpt-6-astra
gpt-5.6-sol
gpt-5.6-terra
gpt-5.6-luna
gpt-5.5-pro
gpt-5.5
gpt-5
gpt-5-mini
gpt-5-nano
gpt-4.1
gpt-4.1-mini
gpt-4.1-nano
o4-mini
o3
o1-pro
o1 | -| `images` | Images optionnelles à utiliser en tant que contexte pour le modèle. Pour inclure plusieurs images, utilisez le nœud Batch Images. | IMAGE | Non | - | -| `fichiers` | Fichiers optionnels à utiliser en tant que contexte pour le modèle. Accepte les entrées du nœud OpenAI Chat Input Files. | OPENAI_INPUT_FILES | Non | - | -| `options_avancées` | Configuration optionnelle pour le modèle. Accepte les entrées du nœud OpenAI Chat Advanced Options. | OPENAI_CHAT_CONFIG | Non | - | +| Paramètre | Description | Type de données | Requis | Plage | +|-----------|-------------|-----------------|--------|-------| +| `invite` | Entrées textuelles du modèle, utilisées pour générer une réponse (par défaut : chaîne vide). | STRING | Oui | - | +| `conserver_contexte` | Ce paramètre est obsolète et n’a aucun effet (par défaut : False). | BOOLEAN | Oui | - | +| `modèle` | Le modèle utilisé pour générer la réponse (par défaut : `gpt-5`) | COMBO | Oui | `gpt-6-astra`
`gpt-5.6-sol`
`gpt-5.6-terra`
`gpt-5.6-luna`
`gpt-5.5-pro`
`gpt-5.5`
`gpt-5`
`gpt-5-mini`
`gpt-5-nano`
`gpt-4.1`
`gpt-4.1-mini`
`gpt-4.1-nano`
`o4-mini`
`o3`
`o1-pro`
`o1` | +| `images` | Image(s) facultative(s) à utiliser comme contexte pour le modèle. Pour inclure plusieurs images, vous pouvez utiliser le nœud Batch Images. | IMAGE | Non | - | +| `fichiers` | Fichier(s) facultatif(s) à utiliser comme contexte pour le modèle. Accepte les entrées du nœud OpenAI Chat Input Files. | OPENAI_INPUT_FILES | Non | - | +| `options_avancées` | Configuration facultative pour le modèle. Accepte les entrées du nœud OpenAI Chat Advanced Options. | OPENAI_CHAT_CONFIG | Non | - | + +Remarque : Lorsqu’une configuration `advanced_options` définissant un effort de raisonnement est connectée, le `model` sélectionné doit prendre en charge cette valeur d’effort. Par exemple, la famille de modèles gpt-4.1 ne prend en charge aucun effort de raisonnement, `gpt-5.5` prend en charge none, low, medium, high et xhigh, et `gpt-5.5-pro` prend en charge medium, high et xhigh. Si l’effort de raisonnement n’est pas pris en charge par le modèle sélectionné, le nœud génère une erreur. ## Sorties | Nom de sortie | Description | Type de données | -|-------------|-------------|-----------| -| `output_text` | La réponse textuelle générée par le modèle OpenAI. Ce est le texte généré en fonction de l'invite d'entrée et du contexte. | STRING | - -## Notes - -- Le paramètre `persist_context` est obsolète et n'a aucun effet. Il est inclus pour la compatibilité ascendante mais ne doit pas être utilisé. -- L'entrée `images` peut être utilisée pour fournir un contexte supplémentaire au modèle. Si plusieurs images sont fournies, elles doivent être connectées à l'aide du nœud Batch Images. -- L'entrée `files` permet de fournir un contexte supplémentaire sous forme de fichiers. Ces fichiers doivent être connectés à partir du nœud OpenAI Chat Input Files. -- L'entrée `advanced_options` permet une configuration plus détaillée du comportement du modèle. Cela doit être connecté à partir du nœud OpenAI Chat Advanced Options. -- Le coût d'utilisation de ce nœud dépend du modèle sélectionné. Le coût est calculé en fonction du nombre de jetons utilisés par le modèle. Le coût exact sera affiché dans l'UI du nœud. +|---------------|-------------|-----------------| +| `output_text` | La réponse textuelle générée par le modèle OpenAI. | 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/OpenAIChatNode/fr.md) diff --git a/comfyui_embedded_docs/docs/OpenAIChatNode/ja.md b/comfyui_embedded_docs/docs/OpenAIChatNode/ja.md index 0c55a3066..7c9d3739c 100644 --- a/comfyui_embedded_docs/docs/OpenAIChatNode/ja.md +++ b/comfyui_embedded_docs/docs/OpenAIChatNode/ja.md @@ -1,34 +1,25 @@ # OpenAI ChatGPT -このノードは、OpenAIモデルからテキスト応答を生成します。モデルにテキストプロンプトを提供し、オプションで画像やファイルをコンテキストとして使用して、その情報をOpenAIモデルに送信します。 +このノードは、OpenAI モデルからテキスト応答を生成します。テキストプロンプトを、必要に応じて画像やファイルと合わせて OpenAI モデルに送信し、生成されたテキスト応答を返します。 ## 入力 -| パラメータ | 説明 | データ型 | 必須 | 范囲 | -|------------|------|----------|------|-------| -| `プロンプト` | モデルに提供するテキスト入力、応答を生成するために使用されます。モデルに応答を求めるテキストです。 | STRING | はい | - | -| `コンテキストの永続化` | このパラメータは廃止され、効果はありません。後方互換性のために含まれていますが、ノードの動作に影響を与えません。 | BOOLEAN | いいえ | - | -| `モデル` |応答を生成するために使用されるモデル。利用可能なOpenAIモデルから選択してください。 | COMBO | はい | gpt-6-astra
gpt-5.6-sol
gpt-5.6-terra
gpt-5.6-luna
gpt-5.5-pro
gpt-5.5
gpt-5
gpt-5-mini
gpt-5-nano
gpt-4.1
gpt-4.1-mini
gpt-4.1-nano
o4-mini
o3
o1-pro
o1 | -| `画像` | モデルにコンテキストとして使用するオプションの画像。複数の画像を含めるには、Batch Imagesノードを使用してください。 | IMAGE | いいえ | - | -| `ファイル` | モデルにコンテキストとして使用するオプションのファイル。OpenAI Chat Input Filesノードからの入力を受け入れます。 | OPENAI_INPUT_FILES | いいえ | - | -| `詳細オプション` | モデルの詳細な設定を行うためのオプション。OpenAI Chat Advanced Optionsノードからの入力を受け入れます。 | OPENAI_CHAT_CONFIG | いいえ | - | +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `プロンプト` | モデルへのテキスト入力で、応答の生成に使用されます(デフォルト: 空文字列)。 | STRING | はい | - | +| `コンテキストの永続化` | このパラメータは非推奨であり、効果はありません(デフォルト: False)。 | BOOLEAN | はい | - | +| `モデル` | 応答の生成に使用されるモデル(デフォルト: `gpt-5`)。 | COMBO | はい | `gpt-6-astra`
`gpt-5.6-sol`
`gpt-5.6-terra`
`gpt-5.6-luna`
`gpt-5.5-pro`
`gpt-5.5`
`gpt-5`
`gpt-5-mini`
`gpt-5-nano`
`gpt-4.1`
`gpt-4.1-mini`
`gpt-4.1-nano`
`o4-mini`
`o3`
`o1-pro`
`o1` | +| `画像` | モデルのコンテキストとして使用する任意の画像です。複数の画像を含める場合は、Batch Images ノードを使用できます。 | IMAGE | いいえ | - | +| `ファイル` | モデルのコンテキストとして使用する任意のファイルです。OpenAI Chat Input Files ノードからの入力を受け付けます。 | OPENAI_INPUT_FILES | いいえ | - | +| `詳細オプション` | モデルの任意の設定です。OpenAI Chat Advanced Options ノードからの入力を受け付けます。 | OPENAI_CHAT_CONFIG | いいえ | - | + +注意:推論努力を設定する `advanced_options` 設定が接続されている場合、選択した `model` がその努力値をサポートしている必要があります。たとえば、gpt-4.1 モデルファミリーはいかなる推論努力もサポートしておらず、`gpt-5.5` は none、low、medium、high、xhigh をサポートし、`gpt-5.5-pro` は medium、high、xhigh をサポートしています。選択したモデルが推論努力をサポートしていない場合、ノードはエラーを発生させます。 ## 出力 | 出力名 | 説明 | データ型 | -|--------|------|----------| -| `output_text` | OpenAIモデルによって生成されたテキスト応答。これは、入力プロンプトとコンテキストに基づいて生成されたテキストです。 | STRING | - -## ノート - -- `persist_context`パラメータは廃止され、効果はありません。後方互換性のために含まれていますが、使用すべきではありません。 -- `images`入力は、モデルに追加のコンテキストを提供するために使用できます。複数の画像が提供された場合、これらはBatch Imagesノードを使用して接続する必要があります。 -- `files`入力は、ファイルの形で追加のコンテキストを提供するために使用できます。これらのファイルはOpenAI Chat Input Filesノードから接続する必要があります。 -- `advanced_options`入力は、モデルの動作を詳細に設定するために使用できます。これはOpenAI Chat Advanced Optionsノードから接続する必要があります。 -- このノードの使用料は選択したモデルに応じて異なります。コストはモデルが使用するトークンの数に基づいて計算されます。正確なコストはノードのUIに表示されます。 -``` - -このドキュメントは、ソースコードの変更を反映しており、廃止された`persist_context`パラメータの削除や`images`および`files`入力の追加が含まれています。また、まだ正確であると考えられる既存のドキュメントの記述やノートも維持されています。 +|-------------|-------------|-----------| +| `output_text` | OpenAI モデルによって生成されたテキスト応答。 | STRING | > このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/OpenAIChatNode/ja.md) diff --git a/comfyui_embedded_docs/docs/OpenAIChatNode/ko.md b/comfyui_embedded_docs/docs/OpenAIChatNode/ko.md index f59d3ed79..3b5543fe4 100644 --- a/comfyui_embedded_docs/docs/OpenAIChatNode/ko.md +++ b/comfyui_embedded_docs/docs/OpenAIChatNode/ko.md @@ -1,32 +1,25 @@ # OpenAI ChatGPT -이 노드는 OpenAI 모델에서 텍스트 응답을 생성합니다. 텍스트 프롬프트와 선택적으로 이미지나 파일을 본문으로 사용하여 이 정보를 OpenAI 모델에 전달하여 텍스트 응답을 생성합니다. +이 노드는 OpenAI 모델을 사용하여 텍스트 응답을 생성합니다. 사용자의 텍스트 프롬프트와 선택적으로 이미지나 파일을 OpenAI 모델에 전송하고, 생성된 텍스트 응답을 반환합니다. ## 입력 -| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +| 매개변수 | 설명 | 데이터 타입 | 필수 여부 | 범위 | |-----------|-------------|-----------|----------|-------| -| `프롬프트` | 모델에 입력되는 텍스트, 응답을 생성하는 데 사용됩니다. 이는 모델이 응답하려는 텍스트입니다. | STRING | 예 | - | -| `컨텍스트 유지` | 이 매개변수는 폐지되었으며 영향을 미치지 않습니다. 후속 호환성을 위해 포함되었지만 노드의 동작에 영향을 미치지 않습니다. | BOOLEAN | 아님 | - | -| `모델` | 응답을 생성하는 데 사용되는 모델. 사용 가능한 OpenAI 모델 중 하나를 선택합니다. | COMBO | 예 | gpt-6-astra
gpt-5.6-sol
gpt-5.6-terra
gpt-5.6-luna
gpt-5.5-pro
gpt-5.5
gpt-5
gpt-5-mini
gpt-5-nano
gpt-4.1
gpt-4.1-mini
gpt-4.1-nano
o4-mini
o3
o1-pro
o1 | -| `이미지` | 모델에 본문으로 사용할 선택적 이미지. 여러 이미지를 포함하려면 Batch Images 노드를 사용할 수 있습니다. | IMAGE | 아님 | - | -| `파일` | 모델에 본문으로 사용할 선택적 파일. OpenAI Chat Input Files 노드에서 입력을 받습니다. | OPENAI_INPUT_FILES | 아님 | - | -| `고급 옵션` | 모델에 대한 선택적 구성. OpenAI Chat Advanced Options 노드에서 입력을 받습니다. | OPENAI_CHAT_CONFIG | 아님 | - | +| `프롬프트` | 모델에 전달되는 텍스트 입력으로, 응답 생성에 사용됩니다(기본값: 빈 문자열). | STRING | 예 | - | +| `컨텍스트 유지` | 이 매개변수는 더 이상 사용되지 않으며 아무런 효과도 없습니다(기본값: False). | BOOLEAN | 예 | - | +| `모델` | 응답 생성에 사용되는 모델입니다(기본값: `gpt-5`). | COMBO | 예 | `gpt-6-astra`
`gpt-5.6-sol`
`gpt-5.6-terra`
`gpt-5.6-luna`
`gpt-5.5-pro`
`gpt-5.5`
`gpt-5`
`gpt-5-mini`
`gpt-5-nano`
`gpt-4.1`
`gpt-4.1-mini`
`gpt-4.1-nano`
`o4-mini`
`o3`
`o1-pro`
`o1` | +| `이미지` | 모델의 컨텍스트로 사용할 선택적 이미지입니다. 여러 이미지를 포함하려면 Batch Images 노드를 사용할 수 있습니다. | IMAGE | 아니요 | - | +| `파일` | 모델의 컨텍스트로 사용할 선택적 파일입니다. OpenAI Chat Input Files 노드의 입력을 허용합니다. | OPENAI_INPUT_FILES | 아니요 | - | +| `고급 옵션` | 모델에 대한 선택적 구성입니다. OpenAI Chat Advanced Options 노드의 입력을 허용합니다. | OPENAI_CHAT_CONFIG | 아니요 | - | + +참고: 추론 노력(reasoning effort) 값을 설정하는 `advanced_options` 구성이 연결된 경우, 선택한 `model`이 해당 추론 노력 값을 지원해야 합니다. 예를 들어, gpt-4.1 모델 제품군은 어떤 추론 노력도 지원하지 않으며, `gpt-5.5`는 none, low, medium, high, xhigh를 지원하고, `gpt-5.5-pro`는 medium, high, xhigh를 지원합니다. 선택한 모델이 해당 추론 노력 값을 지원하지 않으면 노드에서 오류가 발생합니다. ## 출력 | 출력 이름 | 설명 | 데이터 타입 | |-------------|-------------|-----------| -| `output_text` | OpenAI 모델에서 생성된 텍스트 응답. 이는 입력 프롬프트와 본문에 기반한 생성된 텍스트입니다. | STRING | - -## 주의사항 - -- `persist_context` 매개변수는 폐지되었으며 영향을 미치지 않습니다. 후속 호환성을 위해 포함되었지만 사용하지 말아야 합니다. -- `images` 입력은 모델에 추가적인 본문을 제공할 수 있습니다. 여러 이미지를 제공하려면 Batch Images 노드를 사용해야 합니다. -- `files` 입력은 파일 형태로 추가적인 본문을 제공할 수 있습니다. 이 파일들은 OpenAI Chat Input Files 노드에서 연결되어야 합니다. -- `advanced_options` 입력은 모델의 동작을 더 상세히 구성할 수 있습니다. 이는 OpenAI Chat Advanced Options 노드에서 연결되어야 합니다. -- 이 노드를 사용하는 비용은 선택된 모델에 따라 다릅니다. 비용은 모델이 사용하는 토큰 수에 따라 계산됩니다. 정확한 비용은 노드의 UI에서 표시됩니다. -``` +| `output_text` | OpenAI 모델이 생성한 텍스트 응답입니다. | STRING | > 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/OpenAIChatNode/ko.md) diff --git a/comfyui_embedded_docs/docs/OpenAIChatNode/pt-BR.md b/comfyui_embedded_docs/docs/OpenAIChatNode/pt-BR.md index 8d583f950..5005e7d77 100644 --- a/comfyui_embedded_docs/docs/OpenAIChatNode/pt-BR.md +++ b/comfyui_embedded_docs/docs/OpenAIChatNode/pt-BR.md @@ -1,31 +1,25 @@ # OpenAI ChatGPT -Este nó gera respostas de texto a partir de um modelo da OpenAI. Ele recebe um prompt de texto e, opcionalmente, imagens ou arquivos como contexto, e então envia essa informação para um modelo da OpenAI para gerar uma resposta de texto. +Este nó gera respostas de texto a partir de um modelo OpenAI. Ele envia seu prompt de texto e, opcionalmente, imagens ou arquivos, para um modelo OpenAI e retorna a resposta de texto gerada. ## Entradas | Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | |-----------|-------------|-----------|----------|-------| -| `prompt` | Entradas de texto para o modelo, usadas para gerar uma resposta. Este é o texto que você deseja que o modelo responda. | STRING | Sim | - | -| `persist_context` | Este parâmetro está obsoleto e não tem efeito. Ele é incluído para compatibilidade reversa, mas não influencia o comportamento do nó. | BOOLEAN | Não | - | -| `model` | O modelo usado para gerar a resposta. Selecione entre os modelos da OpenAI disponíveis. | COMBO | Sim | gpt-6-astra
gpt-5.6-sol
gpt-5.6-terra
gpt-5.6-luna
gpt-5.5-pro
gpt-5.5
gpt-5
gpt-5-mini
gpt-5-nano
gpt-4.1
gpt-4.1-mini
gpt-4.1-nano
o4-mini
o3
o1-pro
o1 | -| `images` | Imagem(s) opcional(ais) para usar como contexto para o modelo. Para incluir múltiplas imagens, você pode usar o nó Batch Images. | IMAGE | Não | - | -| `files` | Arquivo(s) opcional(ais) para usar como contexto para o modelo. Aceita entradas do nó OpenAI Chat Input Files. | OPENAI_INPUT_FILES | Não | - | +| `prompt` | Entradas de texto para o modelo, usadas para gerar uma resposta (padrão: string vazia). | STRING | Sim | - | +| `persist_context` | Este parâmetro está obsoleto e não tem efeito (padrão: False). | BOOLEAN | Sim | - | +| `model` | O modelo usado para gerar a resposta (padrão: `gpt-5`) | COMBO | Sim | `gpt-6-astra`
`gpt-5.6-sol`
`gpt-5.6-terra`
`gpt-5.6-luna`
`gpt-5.5-pro`
`gpt-5.5`
`gpt-5`
`gpt-5-mini`
`gpt-5-nano`
`gpt-4.1`
`gpt-4.1-mini`
`gpt-4.1-nano`
`o4-mini`
`o3`
`o1-pro`
`o1` | +| `images` | Imagem(ns) opcional(is) para usar como contexto para o modelo. Para incluir várias imagens, você pode usar o nó Batch Images. | IMAGE | Não | - | +| `files` | Arquivo(s) opcional(is) para usar como contexto para o modelo. Aceita entradas do nó OpenAI Chat Input Files. | OPENAI_INPUT_FILES | Não | - | | `advanced_options` | Configuração opcional para o modelo. Aceita entradas do nó OpenAI Chat Advanced Options. | OPENAI_CHAT_CONFIG | Não | - | +Nota: quando uma configuração `advanced_options` que define um esforço de raciocínio é conectada, o `model` selecionado deve suportar esse valor de esforço. Por exemplo, a família de modelos gpt-4.1 não suporta nenhum esforço de raciocínio; `gpt-5.5` suporta os valores none, low, medium, high e xhigh; e `gpt-5.5-pro` suporta medium, high e xhigh. Se o esforço de raciocínio não for suportado pelo modelo selecionado, o nó gera um erro. + ## Saídas | Nome da Saída | Descrição | Tipo de Dados | |-------------|-------------|-----------| -| `output_text` | A resposta de texto gerada pelo modelo da OpenAI. Este é o texto gerado com base no prompt de entrada e contexto. | STRING | - -## Notas - -- O parâmetro `persist_context` está obsoleto e não tem efeito. Ele é incluído para compatibilidade reversa, mas não deve ser usado. -- A entrada `images` pode ser usada para fornecer contexto adicional ao modelo. Se múltiplas imagens forem fornecidas, elas devem ser conectadas usando o nó Batch Images. -- A entrada `files` permite fornecer contexto adicional na forma de arquivos. Esses arquivos devem ser conectados do nó OpenAI Chat Input Files. -- A entrada `advanced_options` permite uma configuração mais detalhada do comportamento do modelo. Isso deve ser conectado do nó OpenAI Chat Advanced Options. -- O preço para usar este nó depende do modelo selecionado. O custo é calculado com base no número de tokens usados pelo modelo. O custo exato será exibido na interface do usuário do nó. +| `output_text` | A resposta de texto gerada pelo modelo OpenAI. | 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/OpenAIChatNode/pt-BR.md) diff --git a/comfyui_embedded_docs/docs/OpenAIChatNode/ru.md b/comfyui_embedded_docs/docs/OpenAIChatNode/ru.md index 037352fd6..bd987fecb 100644 --- a/comfyui_embedded_docs/docs/OpenAIChatNode/ru.md +++ b/comfyui_embedded_docs/docs/OpenAIChatNode/ru.md @@ -1,31 +1,25 @@ # OpenAI ChatGPT -Этот узел генерирует текстовые ответы от модели OpenAI. Он принимает текстовый запрос и optionally изображения или файлы в качестве контекста, а затем отправляет эту информацию в модель OpenAI для генерации текстового ответа. +Этот узел генерирует текстовые ответы с помощью модели OpenAI. Он отправляет ваш текстовый запрос и, при необходимости, изображения или файлы в модель OpenAI и возвращает сгенерированный текстовый ответ. ## Входы -| Параметр | Описание | Тип данных | Обязателен | Диапазон | +| Параметр | Описание | Тип данных | Обязательный | Диапазон | |-----------|-------------|-----------|----------|-------| -| `запрос` | Текстовые входы для модели, используемые для генерации ответа. Это текст, на который модель должна ответить. | STRING | Да | - | -| `сохранять_контекст` | Этот параметр устарел и не оказывает никакого влияния. Он включен для обратной совместимости, но не влияет на поведение узла. | BOOLEAN | Нет | - | -| `модель` | Модель, используемая для генерации ответа. Выберите из доступных моделей OpenAI. | COMBO | Да | gpt-6-astra
gpt-5.6-sol
gpt-5.6-terra
gpt-5.6-luna
gpt-5.5-pro
gpt-5.5
gpt-5
gpt-5-mini
gpt-5-nano
gpt-4.1
gpt-4.1-mini
gpt-4.1-nano
o4-mini
o3
o1-pro
o1 | -| `изображения` | Опциональные изображения для использования в качестве контекста модели. Для включения нескольких изображений можно использовать узел Batch Images. | IMAGE | Нет | - | -| `файлы` | Опциональные файлы для использования в качестве контекста модели. Принимает входы от узла OpenAI Chat Input Files. | OPENAI_INPUT_FILES | Нет | - | -| `расширенные_настройки` | Опциональная конфигурация модели. Принимает входы от узла OpenAI Chat Advanced Options. | OPENAI_CHAT_CONFIG | Нет | - | +| `запрос` | Текстовые входы для модели, используемые для генерации ответа (по умолчанию: пустая строка). | STRING | Да | - | +| `сохранять_контекст` | Этот параметр устарел и не оказывает эффекта (по умолчанию: False). | BOOLEAN | Да | - | +| `модель` | Модель, используемая для генерации ответа (по умолчанию: `gpt-5`) | COMBO | Да | `gpt-6-astra`
`gpt-5.6-sol`
`gpt-5.6-terra`
`gpt-5.6-luna`
`gpt-5.5-pro`
`gpt-5.5`
`gpt-5`
`gpt-5-mini`
`gpt-5-nano`
`gpt-4.1`
`gpt-4.1-mini`
`gpt-4.1-nano`
`o4-mini`
`o3`
`o1-pro`
`o1` | +| `изображения` | Необязательные изображения для использования в качестве контекста для модели. Чтобы включить несколько изображений, можно использовать узел Batch Images. | IMAGE | Нет | - | +| `файлы` | Необязательные файлы для использования в качестве контекста для модели. Принимает входы от узла OpenAI Chat Input Files. | OPENAI_INPUT_FILES | Нет | - | +| `расширенные_настройки` | Необязательная конфигурация для модели. Принимает входы от узла OpenAI Chat Advanced Options. | OPENAI_CHAT_CONFIG | Нет | - | + +Примечание. Когда подключена конфигурация `advanced_options`, которая задаёт уровень рассуждений (reasoning effort), выбранная `model` должна поддерживать этот уровень. Например, семейство моделей gpt-4.1 не поддерживает никакого уровня рассуждений, `gpt-5.5` поддерживает none, low, medium, high и xhigh, а `gpt-5.5-pro` поддерживает medium, high и xhigh. Если уровень рассуждений не поддерживается выбранной моделью, узел выдаёт ошибку. ## Выходы -| Название выхода | Описание | Тип данных | +| Имя выхода | Описание | Тип данных | |-------------|-------------|-----------| -| `output_text` | Текстовый ответ, генерируемый моделью OpenAI. Это генерируемый текст на основе входного запроса и контекста. | STRING | - -## Замечания - -- Параметр `persist_context` устарел и не оказывает никакого влияния. Он включен для обратной совместимости, но не должен использоваться. -- Вход `images` можно использовать для предоставления дополнительного контекста модели. Если предоставляются несколько изображений, они должны быть подключены с помощью узла Batch Images. -- Вход `files` позволяет предоставлять дополнительный контекст в виде файлов. Эти файлы должны быть подключены от узла OpenAI Chat Input Files. -- Вход `advanced_options` позволяет более детально настроить поведение модели. Этот вход должен быть подключен от узла OpenAI Chat Advanced Options. -- Ценообразование для использования этого узла зависит от выбранной модели. Стоимость рассчитывается на основе количества токенов, используемых моделью. Точная стоимость будет отображаться в интерфейсе узла. +| `output_text` | Текстовый ответ, сгенерированный моделью OpenAI. | STRING | > Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/OpenAIChatNode/ru.md) diff --git a/comfyui_embedded_docs/docs/OpenAIChatNode/tr.md b/comfyui_embedded_docs/docs/OpenAIChatNode/tr.md index d035b7e5d..5656e4b17 100644 --- a/comfyui_embedded_docs/docs/OpenAIChatNode/tr.md +++ b/comfyui_embedded_docs/docs/OpenAIChatNode/tr.md @@ -1,34 +1,25 @@ # OpenAI ChatGPT -Bu düğüm, OpenAI modelinden metin yanıtları oluşturur. Bir metin ipucunu ve isteğe bağlı olarak resim veya dosyaları bağlam olarak kullanır ve ardından bu bilgileri OpenAI modeline gönderir. +Bu düğüm, bir OpenAI modelinden metin yanıtları üretir. Metin isteminizi ve isteğe bağlı olarak görselleri veya dosyaları bir OpenAI modeline gönderir ve üretilen metin yanıtını döndürür. ## Girdiler -| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +| Parametre | Açıklama | Veri Türü | Zorunlu | Aralık | |-----------|-------------|-----------|----------|-------| -| `komut` | Modelin yanıtı oluşturmak için kullanılan metin girdileri. Bu, modelin yanıt vermesini istediğiniz metindir. | STRING | Evet | - | -| `bağlamı_sürdür` | Bu parametre eski ve etkisi yoktur. Geriye dönük uyumluluk için içerilmiştir, ancak düğümün davranışını etkilemez. | BOOLEAN | Hayır | - | -| `model` | Yanıtı oluşturmak için kullanılan model. Kullanılabilir OpenAI modellerinden birini seçin. | COMBO | Evet | gpt-6-astra
gpt-5.6-sol
gpt-5.6-terra
gpt-5.6-luna
gpt-5.5-pro
gpt-5.5
gpt-5
gpt-5-mini
gpt-5-nano
gpt-4.1
gpt-4.1-mini
gpt-4.1-nano
o4-mini
o3
o1-pro
o1 | -| `görseller` | Model için bağlam olarak kullanılacak isteğe bağlı resim(ler). Çoklu resim içermek için Batch Images düğümünü kullanabilirsiniz. | IMAGE | Hayır | - | -| `dosyalar` | Model için bağlam olarak kullanılacak isteğe bağlı dosya(ya). OpenAI Chat Input Files düğümünden alınan girdileri kabul eder. | OPENAI_INPUT_FILES | Hayır | - | -| `gelişmiş_seçenekler` | Modelin davranışı için isteğe bağlı yapılandırma. OpenAI Chat Advanced Options düğümünden alınan girdileri kabul eder. | OPENAI_CHAT_CONFIG | Hayır | - | +| `komut` | Yanıt üretmek için modele gönderilen metin girdileri (varsayılan: boş dize). | STRING | Evet | - | +| `bağlamı_sürdür` | Bu parametre kullanımdan kaldırılmıştır ve hiçbir etkisi yoktur (varsayılan: False). | BOOLEAN | Evet | - | +| `model` | Yanıtı üretmek için kullanılan model (varsayılan: `gpt-5`) | COMBO | Evet | `gpt-6-astra`
`gpt-5.6-sol`
`gpt-5.6-terra`
`gpt-5.6-luna`
`gpt-5.5-pro`
`gpt-5.5`
`gpt-5`
`gpt-5-mini`
`gpt-5-nano`
`gpt-4.1`
`gpt-4.1-mini`
`gpt-4.1-nano`
`o4-mini`
`o3`
`o1-pro`
`o1` | +| `görseller` | Model için bağlam olarak kullanılacak isteğe bağlı görsel(ler). Birden fazla görsel eklemek için Batch Images düğümünü kullanabilirsiniz. | IMAGE | Hayır | - | +| `dosyalar` | Model için bağlam olarak kullanılacak isteğe bağlı dosya(lar). OpenAI Chat Input Files düğümünden girdi kabul eder. | OPENAI_INPUT_FILES | Hayır | - | +| `gelişmiş_seçenekler` | Model için isteğe bağlı yapılandırma. OpenAI Chat Advanced Options düğümünden girdi kabul eder. | OPENAI_CHAT_CONFIG | Hayır | - | + +Not: Akıl yürütme çabası (reasoning effort) belirleyen bir `advanced_options` yapılandırması bağlandığında, seçilen `model` bu çaba değerini desteklemelidir. Örneğin, gpt-4.1 model ailesi hiçbir akıl yürütme çabasını desteklemez; `gpt-5.5` none, low, medium, high ve xhigh değerlerini destekler; `gpt-5.5-pro` ise medium, high ve xhigh değerlerini destekler. Akıl yürütme çabası seçilen model tarafından desteklenmiyorsa düğüm bir hata verir. ## Çıktılar | Çıktı Adı | Açıklama | Veri Türü | |-------------|-------------|-----------| -| `output_text` | OpenAI modeli tarafından oluşturulan metin yanıtı. Bu, girdi ipucu ve bağlam temel alınarak oluşturulan oluşturulan metindir. | STRING | - -## Notlar - -- `persist_context` parametresi eski ve etkisi yoktur. Geriye dönük uyumluluk için içerilmiştir, ancak kullanılmamalıdır. -- `images` girdisi model için ek bağlam sağlamak için kullanılabilir. Çoklu resim sağlanırsa, bu resimler Batch Images düğümü kullanılarak bağlanmalıdır. -- `files` girdisi ek bağlam olarak dosya sağlamak için kullanılabilir. Bu dosyalar OpenAI Chat Input Files düğümünden bağlanmalıdır. -- `advanced_options` girdisi modelin davranışı için daha ayrıntılı yapılandırma sağlamak için kullanılabilir. Bu girdi OpenAI Chat Advanced Options düğümünden bağlanmalıdır. -- Bu düğümün fiyatlandırması seçilen modele bağlıdır. Fiyat, model tarafından kullanılan token sayısına göre hesaplanır. Kesin maliyet, düğümün UI'sinde görüntülenir. -``` - -Bu belge, kaynak kodundaki değişiklikleri yansıtır, eski `persist_context` parametresinin kaldırılmasını ve `images` ve `files` girdilerinin eklenmesini içerir. Ayrıca, hala doğru olan mevcut belgeye ait insan yazılmış açıklamaları ve notları korur. +| `output_text` | OpenAI modeli tarafından üretilen metin yanıtı. | 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/OpenAIChatNode/tr.md) diff --git a/comfyui_embedded_docs/docs/OpenAIChatNode/zh-TW.md b/comfyui_embedded_docs/docs/OpenAIChatNode/zh-TW.md index 79fee4026..e130c191d 100644 --- a/comfyui_embedded_docs/docs/OpenAIChatNode/zh-TW.md +++ b/comfyui_embedded_docs/docs/OpenAIChatNode/zh-TW.md @@ -1,31 +1,25 @@ # OpenAI ChatGPT -此節點從 OpenAI 模型生成文字回應。它接受文字提示,並可選地使用圖片或文件作為上下文,然後將此信息發送到 OpenAI 模型以生成文字回應。 +此節點會從 OpenAI 模型產生文字回應。它會將您的文字提示,以及可選的圖片或檔案,傳送給 OpenAI 模型,並傳回產生的文字回應。 -## Inputs +## 輸入 -| 參數 | 描述 | 資料類型 | 必要 | 范圍 | -|------|------|----------|------|-------| -| `prompt` | 將輸入到模型的文字,用於生成回應。這是您希望模型回應的文字。 | STRING | 是 | - | -| `persist_context` | 此參數已棄用並無作用。為了後向相容性而包含,但並不影響節點的行為。 | BOOLEAN | 否 | - | -| `model` | 用於生成回應的模型。從可用的 OpenAI 模型中選擇。 | COMBO | 是 | gpt-6-astra
gpt-5.6-sol
gpt-5.6-terra
gpt-5.6-luna
gpt-5.5-pro
gpt-5.5
gpt-5
gpt-5-mini
gpt-5-nano
gpt-4.1
gpt-4.1-mini
gpt-4.1-nano
o4-mini
o3
o1-pro
o1 | -| `images` | 用作模型上下文的可選圖片。若要包含多個圖片,可以使用批量圖片節點。 | IMAGE | 否 | - | -| `files` | 用作模型上下文的可選文件。接受從 OpenAI Chat Input Files 節點的輸入。 | OPENAI_INPUT_FILES | 否 | - | -| `advanced_options` | 用於模型的可選配置。接受從 OpenAI Chat Advanced Options 節點的輸入。 | OPENAI_CHAT_CONFIG | 否 | - | +| 參數 | 說明 | 資料類型 | 必填 | 範圍 | +|-----------|-------------|-----------|----------|-------| +| `prompt` | 提供給模型的文字輸入,用於產生回應(預設為空字串)。 | STRING | 是 | - | +| `persist_context` | 此參數已棄用,且沒有任何效果(預設為 False)。 | BOOLEAN | 是 | - | +| `model` | 用於產生回應的模型(預設為 `gpt-5`)。 | COMBO | 是 | `gpt-6-astra`
`gpt-5.6-sol`
`gpt-5.6-terra`
`gpt-5.6-luna`
`gpt-5.5-pro`
`gpt-5.5`
`gpt-5`
`gpt-5-mini`
`gpt-5-nano`
`gpt-4.1`
`gpt-4.1-mini`
`gpt-4.1-nano`
`o4-mini`
`o3`
`o1-pro`
`o1` | +| `images` | 可選的圖片,作為提供給模型的上下文。若要包含多張圖片,可使用「Batch Images」節點。 | IMAGE | 否 | - | +| `files` | 可選的檔案,作為提供給模型的上下文。接受來自「OpenAI Chat Input Files」節點的輸入。 | OPENAI_INPUT_FILES | 否 | - | +| `advanced_options` | 可選的模型設定。接受來自「OpenAI Chat Advanced Options」節點的輸入。 | OPENAI_CHAT_CONFIG | 否 | - | -## Outputs +注意:當所連接的 `advanced_options` 設定中指定了推理強度時,所選的 `model` 必須支援該強度值。例如,gpt-4.1 系列模型不支援任何推理強度,`gpt-5.5` 支援 none、low、medium、high 和 xhigh,而 `gpt-5.5-pro` 支援 medium、high 和 xhigh。如果所選模型不支援該推理強度,節點會引發錯誤。 -| 輸出名稱 | 描述 | 資料類型 | -|----------|------|-----------| -| `output_text` | 由 OpenAI 模型生成的文字回應。這是基於輸入提示和上下文生成的文字。 | STRING | +## 輸出 -## 記錄 - -- `persist_context` 參數已棄用並無作用。為了後向相容性而包含,但應該不使用。 -- `images` 輸入可用於向模型提供額外的上下文。若提供多個圖片,應使用批量圖片節點將其連接。 -- `files` 輸入允許您以文件的形式提供額外的上下文。這些文件應從 OpenAI Chat Input Files 節點連接。 -- `advanced_options` 輸入允許對模型的行為進行更詳細的配置。這應從 OpenAI Chat Advanced Options 節點連接。 -- 使用此節點的價格取決於選擇的模型。費用是基於模型使用的代碼數量計算的。具體費用將在節點的 UI 中顯示。 +| 輸出名稱 | 說明 | 資料類型 | +|-------------|-------------|-----------| +| `output_text` | 由 OpenAI 模型產生的文字回應。 | STRING | > 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/OpenAIChatNode/zh-TW.md) diff --git a/comfyui_embedded_docs/docs/OpenAIChatNode/zh.md b/comfyui_embedded_docs/docs/OpenAIChatNode/zh.md index e7dd73908..bb9cd8820 100644 --- a/comfyui_embedded_docs/docs/OpenAIChatNode/zh.md +++ b/comfyui_embedded_docs/docs/OpenAIChatNode/zh.md @@ -1,31 +1,25 @@ # OpenAI ChatGPT -此节点从 OpenAI 模型生成文本响应。它接受文本提示,并可选择图像或文件作为上下文,然后将这些信息发送到 OpenAI 模型以生成文本响应。 +此节点用于从 OpenAI 模型生成文本回复。它会发送你的文本提示词,以及可选的图片或文件,到 OpenAI 模型,并返回生成的文本回复。 ## 输入 -| 参数 | 描述 | 数据类型 | 必需 | 范围 | -|-----------|-------------|-----------|----------|-------| -| `提示词` | 模型的文本输入,用于生成响应。这是您希望模型响应的文本。 | STRING | 是 | - | -| `保持上下文` | 此参数已弃用,无任何效果。它包含以保持向后兼容性,但不影响节点的行为。 | BOOLEAN | 否 | - | -| `模型` | 用于生成响应的模型。从可用的 OpenAI 模型中选择。 | COMBO | 是 | gpt-6-astra
gpt-5.6-sol
gpt-5.6-terra
gpt-5.6-luna
gpt-5.5-pro
gpt-5.5
gpt-5
gpt-5-mini
gpt-5-nano
gpt-4.1
gpt-4.1-mini
gpt-4.1-nano
o4-mini
o3
o1-pro
o1 | -| `图像` | 可选的图像,用作模型的上下文。要包含多个图像,可以使用批量图像节点。 | IMAGE | 否 | - | -| `文件` | 可选的文件,用作模型的上下文。接受来自 OpenAI Chat 输入文件节点的输入。 | OPENAI_INPUT_FILES | 否 | - | -| `高级设置` | 模型的可选配置。接受来自 OpenAI Chat 高级选项节点的输入。 | OPENAI_CHAT_CONFIG | 否 | - | +| 参数 | 描述 | 数据类型 | 必选 | 范围 | +|-----------|-------------|-----------|---------|-------| +| `提示词` | 发送给模型的文本输入,用于生成回复(默认:空字符串)。 | STRING | 是 | - | +| `保持上下文` | 此参数已弃用,不产生任何效果(默认:False)。 | BOOLEAN | 是 | - | +| `模型` | 用于生成回复的模型(默认:`gpt-5`) | COMBO | 是 | `gpt-6-astra`
`gpt-5.6-sol`
`gpt-5.6-terra`
`gpt-5.6-luna`
`gpt-5.5-pro`
`gpt-5.5`
`gpt-5`
`gpt-5-mini`
`gpt-5-nano`
`gpt-4.1`
`gpt-4.1-mini`
`gpt-4.1-nano`
`o4-mini`
`o3`
`o1-pro`
`o1` | +| `图像` | 可选图片,用作模型的上下文。要包含多张图片,可以使用 Batch Images 节点。 | IMAGE | 否 | - | +| `文件` | 可选文件,用作模型的上下文。接受来自 OpenAI Chat Input Files 节点的输入。 | OPENAI_INPUT_FILES | 否 | - | +| `高级设置` | 可选的模型配置。接受来自 OpenAI Chat Advanced Options 节点的输入。 | OPENAI_CHAT_CONFIG | 否 | - | + +注意:当连接了设置了推理努力值的 `advanced_options` 配置时,所选的 `model` 必须支持该努力值。例如,gpt-4.1 系列模型不支持任何推理努力值,`gpt-5.5` 支持 none、low、medium、high 和 xhigh,而 `gpt-5.5-pro` 支持 medium、high 和 xhigh。如果所选模型不支持该推理努力值,节点将抛出错误。 ## 输出 | 输出名称 | 描述 | 数据类型 | |-------------|-------------|-----------| -| `output_text` | OpenAI 模型生成的文本响应。这是基于输入提示和上下文生成的文本。 | STRING | - -## 注意事项 - -- `persist_context` 参数已弃用,无任何效果。它包含以保持向后兼容性,但不应该使用。 -- `images` 输入可用于向模型提供额外的上下文。如果提供了多个图像,应使用批量图像节点将它们连接起来。 -- `files` 输入允许您以文件的形式提供额外的上下文。这些文件应从 OpenAI Chat 输入文件节点连接。 -- `advanced_options` 输入允许更详细地配置模型的行为。这应从 OpenAI Chat 高级选项节点连接。 -- 使用此节点的定价取决于所选的模型。费用是根据模型使用的令牌数量计算的。确切的费用将在节点的 UI 中显示。 +| `output_text` | OpenAI 模型生成的文本回复。 | STRING | > 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/OpenAIChatNode/zh.md) diff --git a/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/ar.md b/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/ar.md index 2364b5e2a..6511b96bc 100644 --- a/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/ar.md +++ b/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/ar.md @@ -1,67 +1,85 @@ # OpenAI GPT Image 2 -تنشئ هذه العقدة الصور باستخدام واجهة برمجة تطبيقات GPT Image من OpenAI. وهي تدعم نماذج متعددة (`gpt-image-2` و`gpt-image-1.5` و`gpt-image-1`)، وتتيح لك توفير صور مرجعية للتحرير، ويمكنها استخدام قناع لتحديد الأجزاء المراد تعديلها من الصورة. +تنشئ هذه العقدة الصور باستخدام واجهة برمجة تطبيقات GPT Image من OpenAI. وتدعم خمسة نماذج — `gpt-image-2.5-flare` و`gpt-image-2.5-sunburst` و`gpt-image-2` و`gpt-image-1.5` و`gpt-image-1` — وتتيح لك إرفاق صور مرجعية لتحرير الصور، ويمكنها استخدام قناع لتحديد أجزاء الصورة التي سيتم استبدالها. ## المدخلات ### المدخلات العامة +هذه المدخلات مرئية دائمًا. + | المعامل | الوصف | نوع البيانات | مطلوب | النطاق | | --- | --- | --- | --- | --- | -| `النموذج` | نموذج GPT Image من OpenAI الذي سيتم استخدامه. يؤدي اختيار نموذج إلى إظهار معاملات إضافية خاصة بذلك النموذج. | DYNAMIC_COMBO | نعم | `"gpt-image-2"`
`"gpt-image-1.5"`
`"gpt-image-1"` | -| `الموجه` | مطالبة نصية لنموذج GPT Image (الافتراضي: `""`). | STRING | نعم | N/A | +| `النموذج` | نموذج OpenAI GPT Image الذي سيتم استخدامه. يؤدي تحديد نموذج إلى إظهار معاملات إضافية خاصة بذلك النموذج. | DYNAMIC_COMBO | نعم | `"gpt-image-2.5-flare"`
`"gpt-image-2.5-sunburst"`
`"gpt-image-2"`
`"gpt-image-1.5"`
`"gpt-image-1"` | +| `الموجه` | الموجه النصي لـ GPT Image (الافتراضي: `""`). | STRING | نعم | N/A | | `عدد الصور` | عدد الصور المطلوب إنشاؤها (الافتراضي: `1`). | INT | نعم | 1 إلى 8 | -| `البذرة` | بذرة (Seed) لتكرار النتائج (الافتراضي: `0`). لم يتم تنفيذها بعد في الخلفية. | INT | نعم | 0 إلى 2147483647 | +| `البذرة` | البذرة (Seed) لضمان تكرار النتائج (الافتراضي: `0`). غير منفذة بعد في الواجهة الخلفية. | INT | نعم | 0 إلى 2147483647 | + +### مدخلات gpt-image-2.5-flare و gpt-image-2.5-sunburst + +تظهر هذه المدخلات عندما يتم تعيين `model` إلى `gpt-image-2.5-flare` أو `gpt-image-2.5-sunburst`. يشترك كلا النموذجين في مجموعة المعاملات نفسها. + +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +| --- | --- | --- | --- | --- | +| `الحجم` | حجم الصورة. اختر "Custom" لاستخدام العرض والارتفاع المخصصين (الافتراضي: `"auto"`). | COMBO | نعم | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | +| `عرض مخصص` | يُستخدم فقط عندما تكون قيمة `model.size` هي "Custom". يجب أن يكون من مضاعفات العدد 16 (الافتراضي: `1024`). | INT | لا | 480 إلى 3840 (خطوة 16) | +| `ارتفاع مخصص` | يُستخدم فقط عندما تكون قيمة `model.size` هي "Custom". يجب أن يكون من مضاعفات العدد 16 (الافتراضي: `1024`). | INT | لا | 480 إلى 3840 (خطوة 16) | +| `الخلفية` | إرجاع الصورة مع خلفية أو بدونها (الافتراضي: `"auto"`). | COMBO | نعم | `"auto"`
`"opaque"`
`"transparent"` | +| `الجودة` | جودة الصورة؛ تؤثر على التكلفة ووقت الإنشاء (الافتراضي: `"low"`). | COMBO | نعم | `"low"`
`"medium"`
`"high"`
`"xhigh"`
`"max"` | +| `model.images` | صورة (صور) مرجعية اختيارية لتحرير الصورة. يصل العدد إلى 16 صورة. راجع «المدخلات المرجعية» للتفاصيل. | IMAGE | لا | 0 إلى 16 | +| `model.mask` | قناع اختياري لعملية inpainting (سيتم استبدال المناطق البيضاء). يتطلب صورة مرجعية واحدة بالضبط. | MASK | لا | N/A | ### مدخلات gpt-image-2 -تظهر هذه المدخلات عند ضبط `model` على `gpt-image-2`. +تظهر هذه المدخلات عندما يتم تعيين `model` إلى `gpt-image-2`. | المعامل | الوصف | نوع البيانات | مطلوب | النطاق | | --- | --- | --- | --- | --- | | `الحجم` | حجم الصورة. اختر "Custom" لاستخدام العرض والارتفاع المخصصين (الافتراضي: `"auto"`). | COMBO | نعم | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | -| `عرض مخصص` | يُستخدم فقط عندما يكون `model.size` هو "Custom". يجب أن يكون مضاعفًا للعدد 16 (الافتراضي: `1024`). | INT | لا | 1024 إلى 3840 | -| `ارتفاع مخصص` | يُستخدم فقط عندما يكون `model.size` هو "Custom". يجب أن يكون مضاعفًا للعدد 16 (الافتراضي: `1024`). | INT | لا | 1024 إلى 3840 | -| `الخلفية` | إرجاع الصورة مع الخلفية أو بدونها (الافتراضي: `"auto"`). | COMBO | نعم | `"auto"`
`"opaque"` | -| `الجودة` | جودة الصورة، تؤثر على التكلفة ووقت الإنشاء (الافتراضي: `"low"`). | COMBO | نعم | `"low"`
`"medium"`
`"high"` | -| `model.images` | صور مرجعية اختيارية لتحرير الصورة. حتى 16 صورة. راجع المدخلات المرجعية للتفاصيل. | IMAGE | لا | 0 إلى 16 | -| `model.mask` | قناع اختياري للرسم داخل الصورة (سيتم استبدال المناطق البيضاء). يتطلب صورة مرجعية واحدة بالضبط. | MASK | لا | N/A | +| `عرض مخصص` | يُستخدم فقط عندما تكون قيمة `model.size` هي "Custom". يجب أن يكون من مضاعفات العدد 16 (الافتراضي: `1024`). | INT | لا | 480 إلى 3840 (خطوة 16) | +| `ارتفاع مخصص` | يُستخدم فقط عندما تكون قيمة `model.size` هي "Custom". يجب أن يكون من مضاعفات العدد 16 (الافتراضي: `1024`). | INT | لا | 480 إلى 3840 (خطوة 16) | +| `الخلفية` | إرجاع الصورة مع خلفية أو بدونها (الافتراضي: `"auto"`). | COMBO | نعم | `"auto"`
`"opaque"` | +| `الجودة` | جودة الصورة؛ تؤثر على التكلفة ووقت الإنشاء (الافتراضي: `"low"`). | COMBO | نعم | `"low"`
`"medium"`
`"high"` | +| `model.images` | صورة (صور) مرجعية اختيارية لتحرير الصورة. يصل العدد إلى 16 صورة. راجع «المدخلات المرجعية» للتفاصيل. | IMAGE | لا | 0 إلى 16 | +| `model.mask` | قناع اختياري لعملية inpainting (سيتم استبدال المناطق البيضاء). يتطلب صورة مرجعية واحدة بالضبط. | MASK | لا | N/A | -### مدخلات gpt-image-1.5 وgpt-image-1 +### مدخلات gpt-image-1.5 و gpt-image-1 -تظهر هذه المدخلات عند ضبط `model` على `gpt-image-1.5` أو `gpt-image-1`. يتشارك كلا النموذجين في نفس مجموعة المعاملات. +تظهر هذه المدخلات عندما يتم تعيين `model` إلى `gpt-image-1.5` أو `gpt-image-1`. يشترك كلا النموذجين في مجموعة المعاملات نفسها. | المعامل | الوصف | نوع البيانات | مطلوب | النطاق | | --- | --- | --- | --- | --- | | `الحجم` | حجم الصورة (الافتراضي: `"auto"`). | COMBO | نعم | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"` | -| `الخلفية` | إرجاع الصورة مع الخلفية أو بدونها (الافتراضي: `"auto"`). | COMBO | نعم | `"auto"`
`"opaque"`
`"transparent"` | -| `الجودة` | جودة الصورة، تؤثر على التكلفة ووقت الإنشاء (الافتراضي: `"low"`). | COMBO | نعم | `"low"`
`"medium"`
`"high"` | -| `model.images` | صور مرجعية اختيارية لتحرير الصورة. حتى 16 صورة. راجع المدخلات المرجعية للتفاصيل. | IMAGE | لا | 0 إلى 16 | -| `model.mask` | قناع اختياري للرسم داخل الصورة (سيتم استبدال المناطق البيضاء). يتطلب صورة مرجعية واحدة بالضبط. | MASK | لا | N/A | +| `الخلفية` | إرجاع الصورة مع خلفية أو بدونها (الافتراضي: `"auto"`). | COMBO | نعم | `"auto"`
`"opaque"`
`"transparent"` | +| `الجودة` | جودة الصورة؛ تؤثر على التكلفة ووقت الإنشاء (الافتراضي: `"low"`). | COMBO | نعم | `"low"`
`"medium"`
`"high"` | +| `model.images` | صورة (صور) مرجعية اختيارية لتحرير الصورة. يصل العدد إلى 16 صورة. راجع «المدخلات المرجعية» للتفاصيل. | IMAGE | لا | 0 إلى 16 | +| `model.mask` | قناع اختياري لعملية inpainting (سيتم استبدال المناطق البيضاء). يتطلب صورة مرجعية واحدة بالضبط. | MASK | لا | N/A | ### المدخلات المرجعية | المعامل | الوصف | نوع البيانات | مطلوب | النطاق | | --- | --- | --- | --- | --- | -| `model.images` | فتحة قابلة للنمو: اربط من 1 إلى N عنصرًا (مثل `image_1`...`image_16`)؛ حتى 16 صورة مرجعية لجميع النماذج. | IMAGE | لا | 1 إلى 16 | -| `model.mask` | قناع اختياري للرسم داخل الصورة (سيتم استبدال المناطق البيضاء). يتطلب صورة مرجعية واحدة بالضبط. | MASK | لا | N/A | +| `model.images` | فتحة قابلة للتوسيع: قم بتوصيل من 1 إلى N من العناصر (مثل `image_1`...`image_16`)؛ حتى 16 صورة مرجعية لجميع النماذج. | IMAGE | لا | 1 إلى 16 | +| `model.mask` | قناع اختياري لعملية inpainting (سيتم استبدال المناطق البيضاء). يتطلب صورة مرجعية واحدة بالضبط. | MASK | لا | N/A | -**قيود المعاملات وحدودها:** +**قيود وحدود المعاملات:** -- عندما يكون `model.size` هو "Custom" (لـ gpt-image-2 فقط)، يجب أن يكون كل من `model.custom_width` و`model.custom_height` مضاعفات للعدد 16، وألا يتجاوز الضلع الأطول 3840، وألا تتجاوز نسبة الأبعاد 3:1، وأن يكون إجمالي عدد البكسلات بين 655,360 و8,294,400. +- عندما تكون قيمة `model.size` هي "Custom" (في `gpt-image-2.5-flare` و`gpt-image-2.5-sunburst` و`gpt-image-2` فقط)، يجب أن يكون كل من `model.custom_width` و`model.custom_height` من مضاعفات العدد 16، ويجب ألا يتجاوز الحرف الأطول 3840، ويجب ألا تتجاوز نسبة العرض إلى الارتفاع 3:1، ويجب أن يكون إجمالي عدد البكسلات بين 655,360 و8,294,400. - يتطلب `model.mask` صورة مرجعية واحدة بالضبط في `model.images`: لا يمكن استخدامه بدون صورة، ولا يمكن استخدامه مع أكثر من صورة واحدة. -- عند استخدام `model.mask`، يجب أن تطابق أبعاده أبعاد الصورة المرجعية. -- عند توفير `model.images`، تعمل العقدة في وضع تحرير الصورة؛ وبدون `model.images`، تنشئ الصور من المطالبة وحدها. -- يتم تصغير حجم الصور المرجعية قبل إرسالها إلى واجهة برمجة التطبيقات. -- `seed` غير مُنفَّذ حاليًا في الخلفية. +- عند استخدام `model.mask`، يجب أن يتطابق ارتفاعه وعرضه مع ارتفاع وعرض الصورة المرجعية. +- عند توفير `model.images`، تعمل العقدة في وضع تحرير الصورة؛ وبدون `model.images`، تقوم بإنشاء الصور من الموجه النصي فقط. +- يتم تقليل حجم الصور المرجعية والقناع قبل إرسالها إلى واجهة برمجة التطبيقات. +- مستويا الجودة `"xhigh"` و`"max"` متاحان فقط لـ `gpt-image-2.5-flare` و`gpt-image-2.5-sunburst`. +- خيار الخلفية `"transparent"` متاح لـ `gpt-image-2.5-flare` و`gpt-image-2.5-sunburst` و`gpt-image-1.5` و`gpt-image-1`، ولكنه غير متاح لـ `gpt-image-2`. +- `seed` غير منفذة حاليًا في الواجهة الخلفية. ## المخرجات -| اسم المخرَج | الوصف | نوع البيانات | +| اسم المخرج | الوصف | نوع البيانات | | --- | --- | --- | -| `image` | الصورة أو الصور المُنشأة. تُجمَّع جميع الصور المرتجعة في دفعة واحدة؛ وإذا اختلفت أبعادها، يُعاد تغيير حجمها لتطابق الصورة الأولى. | IMAGE | +| `image` | الصورة أو الصور المُنشأة. يتم تجميع جميع الصور المُعادة في دفعة واحدة؛ وإذا اختلفت أبعادها، يُعاد تحجيمها لتطابق الصورة الأولى. | IMAGE | > تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/ar.md) --- -**Source fingerprint (SHA-256):** `fb3491f949151fbd3f5825ec9f9ae124019767d083f56966ef34af278aef50c0` +**Source fingerprint (SHA-256):** `4f77b79f9f432a1f2e0fd814012aebe7cc42a8aa983ee9a61f3b32984bf65148` diff --git a/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/en.md b/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/en.md index e4bcf506b..ba259f606 100644 --- a/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/en.md +++ b/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/en.md @@ -1,18 +1,34 @@ # OpenAI GPT Image 2 -This node generates images using OpenAI's GPT Image API. It supports multiple models (`gpt-image-2`, `gpt-image-1.5`, and `gpt-image-1`), allows you to provide reference images for editing, and can use a mask to specify which parts of an image to modify. +This node generates images using OpenAI's GPT Image API. It supports five models — `gpt-image-2.5-flare`, `gpt-image-2.5-sunburst`, `gpt-image-2`, `gpt-image-1.5`, and `gpt-image-1` — lets you attach reference images for image editing, and can use a mask to specify which parts of an image to replace. ## Inputs ### Common Inputs +These inputs are always visible. + | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | -| `model` | The OpenAI GPT Image model to use. Selecting a model reveals additional parameters specific to that model. | DYNAMIC_COMBO | Yes | `"gpt-image-2"`
`"gpt-image-1.5"`
`"gpt-image-1"` | +| `model` | The OpenAI GPT Image model to use. Selecting a model reveals additional parameters specific to that model. | DYNAMIC_COMBO | Yes | `"gpt-image-2.5-flare"`
`"gpt-image-2.5-sunburst"`
`"gpt-image-2"`
`"gpt-image-1.5"`
`"gpt-image-1"` | | `prompt` | Text prompt for GPT Image (default: `""`). | STRING | Yes | N/A | | `n` | How many images to generate (default: `1`). | INT | Yes | 1 to 8 | | `seed` | Seed for reproducibility (default: `0`). Not implemented yet in backend. | INT | Yes | 0 to 2147483647 | +### gpt-image-2.5-flare and gpt-image-2.5-sunburst Inputs + +These inputs appear when `model` is set to `gpt-image-2.5-flare` or `gpt-image-2.5-sunburst`. Both models share the same parameter set. + +| Parameter | Description | Data Type | Required | Range | +| --- | --- | --- | --- | --- | +| `model.size` | Image size. Select "Custom" to use the custom width and height (default: `"auto"`). | COMBO | Yes | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | +| `model.custom_width` | Used only when `model.size` is "Custom". Must be a multiple of 16 (default: `1024`). | INT | No | 480 to 3840 (step 16) | +| `model.custom_height` | Used only when `model.size` is "Custom". Must be a multiple of 16 (default: `1024`). | INT | No | 480 to 3840 (step 16) | +| `model.background` | Return image with or without background (default: `"auto"`). | COMBO | Yes | `"auto"`
`"opaque"`
`"transparent"` | +| `model.quality` | Image quality, affects cost and generation time (default: `"low"`). | COMBO | Yes | `"low"`
`"medium"`
`"high"`
`"xhigh"`
`"max"` | +| `model.images` | Optional reference image(s) for image editing. Up to 16 images. See Reference Inputs for details. | IMAGE | No | 0 to 16 | +| `model.mask` | Optional mask for inpainting (white areas will be replaced). Requires exactly one reference image. | MASK | No | N/A | + ### gpt-image-2 Inputs These inputs appear when `model` is set to `gpt-image-2`. @@ -20,8 +36,8 @@ These inputs appear when `model` is set to `gpt-image-2`. | Parameter | Description | Data Type | Required | Range | | --- | --- | --- | --- | --- | | `model.size` | Image size. Select "Custom" to use the custom width and height (default: `"auto"`). | COMBO | Yes | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | -| `model.custom_width` | Used only when `model.size` is "Custom". Must be a multiple of 16 (default: `1024`). | INT | No | 1024 to 3840 | -| `model.custom_height` | Used only when `model.size` is "Custom". Must be a multiple of 16 (default: `1024`). | INT | No | 1024 to 3840 | +| `model.custom_width` | Used only when `model.size` is "Custom". Must be a multiple of 16 (default: `1024`). | INT | No | 480 to 3840 (step 16) | +| `model.custom_height` | Used only when `model.size` is "Custom". Must be a multiple of 16 (default: `1024`). | INT | No | 480 to 3840 (step 16) | | `model.background` | Return image with or without background (default: `"auto"`). | COMBO | Yes | `"auto"`
`"opaque"` | | `model.quality` | Image quality, affects cost and generation time (default: `"low"`). | COMBO | Yes | `"low"`
`"medium"`
`"high"` | | `model.images` | Optional reference image(s) for image editing. Up to 16 images. See Reference Inputs for details. | IMAGE | No | 0 to 16 | @@ -48,11 +64,13 @@ These inputs appear when `model` is set to `gpt-image-1.5` or `gpt-image-1`. Bot **Parameter Constraints and Limitations:** -- When `model.size` is "Custom" (gpt-image-2 only), `model.custom_width` and `model.custom_height` must both be multiples of 16, the longest edge must not exceed 3840, the aspect ratio must not exceed 3:1, and the total pixel count must be between 655,360 and 8,294,400. +- When `model.size` is "Custom" (`gpt-image-2.5-flare`, `gpt-image-2.5-sunburst`, and `gpt-image-2` only), `model.custom_width` and `model.custom_height` must both be multiples of 16, the longest edge must not exceed 3840, the aspect ratio must not exceed 3:1, and the total pixel count must be between 655,360 and 8,294,400. - `model.mask` requires exactly one reference image in `model.images`: it cannot be used without an image, and it cannot be used with more than one image. -- When `model.mask` is used, its dimensions must match the dimensions of the reference image. +- When `model.mask` is used, its height and width must match the height and width of the reference image. - When `model.images` is provided, the node runs in image editing mode; without `model.images`, it generates images from the prompt alone. -- Reference images are downscaled before being sent to the API. +- Reference images and the mask are downscaled before being sent to the API. +- `"xhigh"` and `"max"` quality levels are only available for `gpt-image-2.5-flare` and `gpt-image-2.5-sunburst`. +- The `"transparent"` background option is available for `gpt-image-2.5-flare`, `gpt-image-2.5-sunburst`, `gpt-image-1.5`, and `gpt-image-1`, but not for `gpt-image-2`. - `seed` is currently not implemented in the backend. ## Outputs @@ -64,4 +82,4 @@ These inputs appear when `model` is set to `gpt-image-1.5` or `gpt-image-1`. Bot > 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/OpenAIGPTImageNodeV2/en.md) --- -**Source fingerprint (SHA-256):** `fb3491f949151fbd3f5825ec9f9ae124019767d083f56966ef34af278aef50c0` +**Source fingerprint (SHA-256):** `4f77b79f9f432a1f2e0fd814012aebe7cc42a8aa983ee9a61f3b32984bf65148` diff --git a/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/es.md b/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/es.md index 0cdba66b9..f67f862cb 100644 --- a/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/es.md +++ b/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/es.md @@ -1,17 +1,33 @@ # OpenAI GPT Image 2 -Este nodo genera imágenes mediante la API GPT Image de OpenAI. Admite varios modelos (`gpt-image-2`, `gpt-image-1.5` y `gpt-image-1`), permite proporcionar imágenes de referencia para edición y puede usar una máscara para especificar qué partes de una imagen modificar. +Este nodo genera imágenes mediante la API GPT Image de OpenAI. Es compatible con cinco modelos — `gpt-image-2.5-flare`, `gpt-image-2.5-sunburst`, `gpt-image-2`, `gpt-image-1.5` y `gpt-image-1` —, permite adjuntar imágenes de referencia para la edición de imágenes y puede usar una máscara para especificar qué partes de una imagen se deben reemplazar. ## Entradas ### Entradas comunes +Estas entradas siempre están visibles. + | Parámetro | Descripción | Tipo de datos | Requerido | Rango | | --- | --- | --- | --- | --- | -| `modelo` | El modelo de imagen GPT de OpenAI que se usará. Al seleccionar un modelo, se muestran parámetros adicionales específicos de ese modelo. | DYNAMIC_COMBO | Sí | `"gpt-image-2"`
`"gpt-image-1.5"`
`"gpt-image-1"` | -| `prompt` | Indicación de texto para GPT Image (por defecto: `""`). | STRING | Sí | No aplica | -| `n` | Cuántas imágenes generar (por defecto: `1`). | INT | Sí | 1 a 8 | -| `semilla` | Semilla para reproducibilidad (por defecto: `0`). Aún no implementado en el backend. | INT | Sí | 0 a 2147483647 | +| `modelo` | El modelo OpenAI GPT Image que se usará. Al seleccionar un modelo, se muestran parámetros adicionales específicos de ese modelo. | DYNAMIC_COMBO | Sí | `"gpt-image-2.5-flare"`
`"gpt-image-2.5-sunburst"`
`"gpt-image-2"`
`"gpt-image-1.5"`
`"gpt-image-1"` | +| `prompt` | Indicación de texto para GPT Image (predeterminado: `""`). | STRING | Sí | N/A | +| `n` | Cuántas imágenes generar (predeterminado: `1`). | INT | Sí | 1 a 8 | +| `semilla` | Semilla para la reproducibilidad (predeterminado: `0`). Aún no implementada en el backend. | INT | Sí | 0 a 2147483647 | + +### Entradas de gpt-image-2.5-flare y gpt-image-2.5-sunburst + +Estas entradas aparecen cuando `model` se establece en `gpt-image-2.5-flare` o `gpt-image-2.5-sunburst`. Ambos modelos comparten el mismo conjunto de parámetros. + +| Parámetro | Descripción | Tipo de datos | Requerido | Rango | +| --- | --- | --- | --- | --- | +| `tamaño` | Tamaño de la imagen. Seleccione "Custom" para usar el ancho y el alto personalizados (predeterminado: `"auto"`). | COMBO | Sí | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | +| `ancho_personalizado` | Se usa solo cuando `model.size` es "Custom". Debe ser un múltiplo de 16 (predeterminado: `1024`). | INT | No | 480 a 3840 (paso 16) | +| `altura_personalizada` | Se usa solo cuando `model.size` es "Custom". Debe ser un múltiplo de 16 (predeterminado: `1024`). | INT | No | 480 a 3840 (paso 16) | +| `fondo` | Devuelve la imagen con o sin fondo (predeterminado: `"auto"`). | COMBO | Sí | `"auto"`
`"opaque"`
`"transparent"` | +| `calidad` | Calidad de la imagen; afecta al costo y al tiempo de generación (predeterminado: `"low"`). | COMBO | Sí | `"low"`
`"medium"`
`"high"`
`"xhigh"`
`"max"` | +| `model.images` | Imágenes de referencia opcionales para la edición de imágenes. Hasta 16 imágenes. Consulte Entradas de referencia para más detalles. | IMAGE | No | 0 a 16 | +| `model.mask` | Máscara opcional para inpainting (las áreas blancas se reemplazarán). Requiere exactamente una imagen de referencia. | MASK | No | N/A | ### Entradas de gpt-image-2 @@ -19,13 +35,13 @@ Estas entradas aparecen cuando `model` se establece en `gpt-image-2`. | Parámetro | Descripción | Tipo de datos | Requerido | Rango | | --- | --- | --- | --- | --- | -| `tamaño` | Tamaño de la imagen. Seleccione «Custom» para usar el ancho y la altura personalizados (por defecto: `"auto"`). | COMBO | Sí | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | -| `ancho_personalizado` | Se usa solo cuando `model.size` es «Custom». Debe ser múltiplo de 16 (por defecto: `1024`). | INT | No | 1024 a 3840 | -| `altura_personalizada` | Se usa solo cuando `model.size` es «Custom». Debe ser múltiplo de 16 (por defecto: `1024`). | INT | No | 1024 a 3840 | -| `fondo` | Devuelve la imagen con o sin fondo (por defecto: `"auto"`). | COMBO | Sí | `"auto"`
`"opaque"` | -| `calidad` | Calidad de la imagen; afecta el costo y el tiempo de generación (por defecto: `"low"`). | COMBO | Sí | `"low"`
`"medium"`
`"high"` | +| `tamaño` | Tamaño de la imagen. Seleccione "Custom" para usar el ancho y el alto personalizados (predeterminado: `"auto"`). | COMBO | Sí | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | +| `ancho_personalizado` | Se usa solo cuando `model.size` es "Custom". Debe ser un múltiplo de 16 (predeterminado: `1024`). | INT | No | 480 a 3840 (paso 16) | +| `altura_personalizada` | Se usa solo cuando `model.size` es "Custom". Debe ser un múltiplo de 16 (predeterminado: `1024`). | INT | No | 480 a 3840 (paso 16) | +| `fondo` | Devuelve la imagen con o sin fondo (predeterminado: `"auto"`). | COMBO | Sí | `"auto"`
`"opaque"` | +| `calidad` | Calidad de la imagen; afecta al costo y al tiempo de generación (predeterminado: `"low"`). | COMBO | Sí | `"low"`
`"medium"`
`"high"` | | `model.images` | Imágenes de referencia opcionales para la edición de imágenes. Hasta 16 imágenes. Consulte Entradas de referencia para más detalles. | IMAGE | No | 0 a 16 | -| `model.mask` | Máscara opcional para inpainting (las áreas blancas se reemplazarán). Requiere exactamente una imagen de referencia. | MASK | No | No aplica | +| `model.mask` | Máscara opcional para inpainting (las áreas blancas se reemplazarán). Requiere exactamente una imagen de referencia. | MASK | No | N/A | ### Entradas de gpt-image-1.5 y gpt-image-1 @@ -33,27 +49,29 @@ Estas entradas aparecen cuando `model` se establece en `gpt-image-1.5` o `gpt-im | Parámetro | Descripción | Tipo de datos | Requerido | Rango | | --- | --- | --- | --- | --- | -| `tamaño` | Tamaño de la imagen (por defecto: `"auto"`). | COMBO | Sí | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"` | -| `fondo` | Devuelve la imagen con o sin fondo (por defecto: `"auto"`). | COMBO | Sí | `"auto"`
`"opaque"`
`"transparent"` | -| `calidad` | Calidad de la imagen; afecta el costo y el tiempo de generación (por defecto: `"low"`). | COMBO | Sí | `"low"`
`"medium"`
`"high"` | +| `tamaño` | Tamaño de la imagen (predeterminado: `"auto"`). | COMBO | Sí | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"` | +| `fondo` | Devuelve la imagen con o sin fondo (predeterminado: `"auto"`). | COMBO | Sí | `"auto"`
`"opaque"`
`"transparent"` | +| `calidad` | Calidad de la imagen; afecta al costo y al tiempo de generación (predeterminado: `"low"`). | COMBO | Sí | `"low"`
`"medium"`
`"high"` | | `model.images` | Imágenes de referencia opcionales para la edición de imágenes. Hasta 16 imágenes. Consulte Entradas de referencia para más detalles. | IMAGE | No | 0 a 16 | -| `model.mask` | Máscara opcional para inpainting (las áreas blancas se reemplazarán). Requiere exactamente una imagen de referencia. | MASK | No | No aplica | +| `model.mask` | Máscara opcional para inpainting (las áreas blancas se reemplazarán). Requiere exactamente una imagen de referencia. | MASK | No | N/A | ### Entradas de referencia | Parámetro | Descripción | Tipo de datos | Requerido | Rango | | --- | --- | --- | --- | --- | -| `model.images` | Entrada ampliable: conecte de 1 a N elementos (p. ej. `image_1`...`image_16`); hasta 16 imágenes de referencia para todos los modelos. | IMAGE | No | 1 a 16 | -| `model.mask` | Máscara opcional para inpainting (las áreas blancas se reemplazarán). Requiere exactamente una imagen de referencia. | MASK | No | No aplica | +| `model.images` | Ranura ampliable: conecte de 1 a N elementos (p. ej., `image_1`...`image_16`); hasta 16 imágenes de referencia para todos los modelos. | IMAGE | No | 1 a 16 | +| `model.mask` | Máscara opcional para inpainting (las áreas blancas se reemplazarán). Requiere exactamente una imagen de referencia. | MASK | No | N/A | **Restricciones y limitaciones de los parámetros:** -- Cuando `model.size` es «Custom» (solo gpt-image-2), tanto `model.custom_width` como `model.custom_height` deben ser múltiplos de 16, el lado más largo no debe superar 3840, la relación de aspecto no debe superar 3:1 y el número total de píxeles debe estar entre 655,360 y 8,294,400. +- Cuando `model.size` es "Custom" (solo para `gpt-image-2.5-flare`, `gpt-image-2.5-sunburst` y `gpt-image-2`), `model.custom_width` y `model.custom_height` deben ser múltiplos de 16, el lado más largo no debe superar 3840, la relación de aspecto no debe exceder 3:1 y el número total de píxeles debe estar entre 655 360 y 8 294 400. - `model.mask` requiere exactamente una imagen de referencia en `model.images`: no puede usarse sin una imagen ni con más de una imagen. -- Cuando se usa `model.mask`, sus dimensiones deben coincidir con las de la imagen de referencia. -- Cuando se proporciona `model.images`, el nodo funciona en modo de edición de imágenes; sin `model.images`, genera imágenes únicamente a partir de la indicación. -- Las imágenes de referencia se reducen de escala antes de enviarse a la API. -- `seed` actualmente no está implementado en el backend. +- Cuando se usa `model.mask`, su altura y anchura deben coincidir con la altura y anchura de la imagen de referencia. +- Cuando se proporciona `model.images`, el nodo funciona en modo de edición de imágenes; sin `model.images`, genera imágenes solo a partir de la indicación. +- Las imágenes de referencia y la máscara se reducen de escala antes de enviarse a la API. +- Los niveles de calidad `"xhigh"` y `"max"` solo están disponibles para `gpt-image-2.5-flare` y `gpt-image-2.5-sunburst`. +- La opción de fondo `"transparent"` está disponible para `gpt-image-2.5-flare`, `gpt-image-2.5-sunburst`, `gpt-image-1.5` y `gpt-image-1`, pero no para `gpt-image-2`. +- El parámetro `seed` no está implementado actualmente en el backend. ## Salidas @@ -64,4 +82,4 @@ Estas entradas aparecen cuando `model` se establece en `gpt-image-1.5` o `gpt-im > 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/OpenAIGPTImageNodeV2/es.md) --- -**Source fingerprint (SHA-256):** `fb3491f949151fbd3f5825ec9f9ae124019767d083f56966ef34af278aef50c0` +**Source fingerprint (SHA-256):** `4f77b79f9f432a1f2e0fd814012aebe7cc42a8aa983ee9a61f3b32984bf65148` diff --git a/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/fa.md b/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/fa.md index d8379da26..821e3c13d 100644 --- a/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/fa.md +++ b/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/fa.md @@ -1,17 +1,33 @@ # OpenAI GPT Image ۲ -این گره با استفاده از OpenAI GPT Image API تصاویر تولید می‌کند. از چندین مدل (`gpt-image-2`، `gpt-image-1.5` و `gpt-image-1`) پشتیبانی می‌کند، امکان ارائه تصاویر مرجع برای ویرایش را فراهم می‌کند و می‌تواند از ماسک برای مشخص کردن بخش‌هایی از تصویر که باید تغییر کنند استفاده کند. +این گره با استفاده از API تصویر GPT شرکت OpenAI تصاویر تولید می‌کند. از پنج مدل پشتیبانی می‌کند — `gpt-image-2.5-flare`، `gpt-image-2.5-sunburst`، `gpt-image-2`، `gpt-image-1.5` و `gpt-image-1` — به شما امکان می‌دهد تصاویر مرجع را برای ویرایش تصویر پیوست کنید، و می‌تواند از ماسک برای تعیین بخش‌هایی از تصویر که باید جایگزین شوند استفاده کند. ## ورودی‌ها ### ورودی‌های مشترک +این ورودی‌ها همیشه قابل مشاهده هستند. + +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +| --- | --- | --- | --- | --- | +| `model` | مدل GPT Image شرکت OpenAI که باید استفاده شود. با انتخاب یک مدل، پارامترهای اضافی مخصوص همان مدل نمایش داده می‌شوند. | DYNAMIC_COMBO | بله | `"gpt-image-2.5-flare"`
`"gpt-image-2.5-sunburst"`
`"gpt-image-2"`
`"gpt-image-1.5"`
`"gpt-image-1"` | +| `prompt` | درخواست متنی برای GPT Image (پیش‌فرض: `""`). | STRING | بله | N/A | +| `n` | تعداد تصاویری که باید تولید شود (پیش‌فرض: `1`). | INT | بله | 1 تا 8 | +| `seed` | مقدار seed برای قابلیت بازتولید (پیش‌فرض: `0`). هنوز در بک‌اند پیاده‌سازی نشده است. | INT | بله | 0 تا 2147483647 | + +### ورودی‌های gpt-image-2.5-flare و gpt-image-2.5-sunburst + +این ورودی‌ها زمانی ظاهر می‌شوند که `model` روی `gpt-image-2.5-flare` یا `gpt-image-2.5-sunburst` تنظیم شده باشد. هر دو مدل مجموعه پارامترهای یکسانی دارند. + | پارامتر | توضیحات | نوع داده | الزامی | محدوده | | --- | --- | --- | --- | --- | -| `model` | مدل OpenAI GPT Image مورد استفاده. انتخاب یک مدل پارامترهای اضافی مخصوص همان مدل را نمایش می‌دهد. | DYNAMIC_COMBO | بله | `"gpt-image-2"`
`"gpt-image-1.5"`
`"gpt-image-1"` | -| `prompt` | متن راهنما (prompt) برای GPT Image (پیش‌فرض: `""`). | STRING | بله | N/A | -| `n` | تعداد تصاویر برای تولید (پیش‌فرض: `1`). | INT | بله | 1 تا 8 | -| `seed` | Seed برای تکرارپذیری (پیش‌فرض: `0`). هنوز در بک‌اند پیاده‌سازی نشده است. | INT | بله | 0 تا 2147483647 | +| `size` | اندازه تصویر. برای استفاده از عرض و ارتفاع سفارشی، «Custom» را انتخاب کنید (پیش‌فرض: `"auto"`). | COMBO | بله | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | +| `custom_width` | فقط زمانی استفاده می‌شود که `model.size` روی «Custom» باشد. باید مضربی از 16 باشد (پیش‌فرض: `1024`). | INT | خیر | 480 تا 3840 (گام 16) | +| `custom_height` | فقط زمانی استفاده می‌شود که `model.size` روی «Custom» باشد. باید مضربی از 16 باشد (پیش‌فرض: `1024`). | INT | خیر | 480 تا 3840 (گام 16) | +| `background` | تصویر خروجی را با پس‌زمینه یا بدون پس‌زمینه برمی‌گرداند (پیش‌فرض: `"auto"`). | COMBO | بله | `"auto"`
`"opaque"`
`"transparent"` | +| `quality` | کیفیت تصویر؛ بر هزینه و زمان تولید اثر می‌گذارد (پیش‌فرض: `"low"`). | COMBO | بله | `"low"`
`"medium"`
`"high"`
`"xhigh"`
`"max"` | +| `model.images` | تصویر(های) مرجع اختیاری برای ویرایش تصویر. حداکثر 16 تصویر. برای جزئیات به ورودی‌های مرجع مراجعه کنید. | IMAGE | خیر | 0 تا 16 | +| `model.mask` | ماسک اختیاری برای inpainting (نواحی سفید جایگزین می‌شوند). دقیقاً به یک تصویر مرجع نیاز دارد. | MASK | خیر | N/A | ### ورودی‌های gpt-image-2 @@ -20,12 +36,12 @@ | پارامتر | توضیحات | نوع داده | الزامی | محدوده | | --- | --- | --- | --- | --- | | `size` | اندازه تصویر. برای استفاده از عرض و ارتفاع سفارشی، «Custom» را انتخاب کنید (پیش‌فرض: `"auto"`). | COMBO | بله | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | -| `custom_width` | فقط زمانی استفاده می‌شود که `model.size` برابر «Custom» باشد. باید مضربی از 16 باشد (پیش‌فرض: `1024`). | INT | خیر | 1024 تا 3840 | -| `custom_height` | فقط زمانی استفاده می‌شود که `model.size` برابر «Custom» باشد. باید مضربی از 16 باشد (پیش‌فرض: `1024`). | INT | خیر | 1024 تا 3840 | -| `background` | بازگرداندن تصویر با یا بدون پس‌زمینه (پیش‌فرض: `"auto"`). | COMBO | بله | `"auto"`
`"opaque"` | -| `quality` | کیفیت تصویر؛ بر هزینه و زمان تولید تأثیر می‌گذارد (پیش‌فرض: `"low"`). | COMBO | بله | `"low"`
`"medium"`
`"high"` | +| `custom_width` | فقط زمانی استفاده می‌شود که `model.size` روی «Custom» باشد. باید مضربی از 16 باشد (پیش‌فرض: `1024`). | INT | خیر | 480 تا 3840 (گام 16) | +| `custom_height` | فقط زمانی استفاده می‌شود که `model.size` روی «Custom» باشد. باید مضربی از 16 باشد (پیش‌فرض: `1024`). | INT | خیر | 480 تا 3840 (گام 16) | +| `background` | تصویر خروجی را با پس‌زمینه یا بدون پس‌زمینه برمی‌گرداند (پیش‌فرض: `"auto"`). | COMBO | بله | `"auto"`
`"opaque"` | +| `quality` | کیفیت تصویر؛ بر هزینه و زمان تولید اثر می‌گذارد (پیش‌فرض: `"low"`). | COMBO | بله | `"low"`
`"medium"`
`"high"` | | `model.images` | تصویر(های) مرجع اختیاری برای ویرایش تصویر. حداکثر 16 تصویر. برای جزئیات به ورودی‌های مرجع مراجعه کنید. | IMAGE | خیر | 0 تا 16 | -| `model.mask` | ماسک اختیاری برای inpainting (نواحی سفید جایگزین خواهند شد). دقیقاً به یک تصویر مرجع نیاز دارد. | MASK | خیر | N/A | +| `model.mask` | ماسک اختیاری برای inpainting (نواحی سفید جایگزین می‌شوند). دقیقاً به یک تصویر مرجع نیاز دارد. | MASK | خیر | N/A | ### ورودی‌های gpt-image-1.5 و gpt-image-1 @@ -34,34 +50,36 @@ | پارامتر | توضیحات | نوع داده | الزامی | محدوده | | --- | --- | --- | --- | --- | | `size` | اندازه تصویر (پیش‌فرض: `"auto"`). | COMBO | بله | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"` | -| `background` | بازگرداندن تصویر با یا بدون پس‌زمینه (پیش‌فرض: `"auto"`). | COMBO | بله | `"auto"`
`"opaque"`
`"transparent"` | -| `quality` | کیفیت تصویر؛ بر هزینه و زمان تولید تأثیر می‌گذارد (پیش‌فرض: `"low"`). | COMBO | بله | `"low"`
`"medium"`
`"high"` | +| `background` | تصویر خروجی را با پس‌زمینه یا بدون پس‌زمینه برمی‌گرداند (پیش‌فرض: `"auto"`). | COMBO | بله | `"auto"`
`"opaque"`
`"transparent"` | +| `quality` | کیفیت تصویر؛ بر هزینه و زمان تولید اثر می‌گذارد (پیش‌فرض: `"low"`). | COMBO | بله | `"low"`
`"medium"`
`"high"` | | `model.images` | تصویر(های) مرجع اختیاری برای ویرایش تصویر. حداکثر 16 تصویر. برای جزئیات به ورودی‌های مرجع مراجعه کنید. | IMAGE | خیر | 0 تا 16 | -| `model.mask` | ماسک اختیاری برای inpainting (نواحی سفید جایگزین خواهند شد). دقیقاً به یک تصویر مرجع نیاز دارد. | MASK | خیر | N/A | +| `model.mask` | ماسک اختیاری برای inpainting (نواحی سفید جایگزین می‌شوند). دقیقاً به یک تصویر مرجع نیاز دارد. | MASK | خیر | N/A | ### ورودی‌های مرجع | پارامتر | توضیحات | نوع داده | الزامی | محدوده | | --- | --- | --- | --- | --- | -| `model.images` | اسلات قابل توسعه (Growable slot): اتصال 1..N آیتم (مثلاً `image_1`...`image_16`)؛ حداکثر 16 تصویر مرجع برای همه مدل‌ها. | IMAGE | خیر | 1 تا 16 | -| `model.mask` | ماسک اختیاری برای inpainting (نواحی سفید جایگزین خواهند شد). دقیقاً به یک تصویر مرجع نیاز دارد. | MASK | خیر | N/A | +| `model.images` | اسلات قابل‌افزایش: 1..N آیتم را متصل کنید (مثلاً `image_1`...`image_16`)؛ حداکثر 16 تصویر مرجع برای همه مدل‌ها. | IMAGE | خیر | 1 تا 16 | +| `model.mask` | ماسک اختیاری برای inpainting (نواحی سفید جایگزین می‌شوند). دقیقاً به یک تصویر مرجع نیاز دارد. | MASK | خیر | N/A | -**محدودیت‌ها و الزامات پارامترها:** +**محدودیت‌ها و قیدهای پارامترها:** -- هنگامی که `model.size` برابر «Custom» است (فقط gpt-image-2)، `model.custom_width` و `model.custom_height` هر دو باید مضربی از 16 باشند، طولانی‌ترین ضلع نباید از 3840 تجاوز کند، نسبت ابعاد نباید از 3:1 بیشتر شود، و تعداد کل پیکسل‌ها باید بین 655,360 و 8,294,400 باشد. +- زمانی که `model.size` روی «Custom» است (فقط `gpt-image-2.5-flare`، `gpt-image-2.5-sunburst` و `gpt-image-2`)، `model.custom_width` و `model.custom_height` باید هر دو مضربی از 16 باشند، بلندترین ضلع نباید از 3840 بیشتر شود، نسبت ابعاد نباید از 3:1 بیشتر شود، و تعداد کل پیکسل‌ها باید بین 655,360 و 8,294,400 باشد. - `model.mask` دقیقاً به یک تصویر مرجع در `model.images` نیاز دارد: بدون تصویر قابل استفاده نیست و با بیش از یک تصویر نیز قابل استفاده نیست. -- هنگامی که `model.mask` استفاده می‌شود، ابعاد آن باید با ابعاد تصویر مرجع مطابقت داشته باشد. -- هنگامی که `model.images` ارائه شود، گره در حالت ویرایش تصویر عمل می‌کند؛ بدون `model.images`، تصاویر را تنها از روی prompt تولید می‌کند. -- تصاویر مرجع قبل از ارسال به API کوچک‌سازی (downscale) می‌شوند. +- زمانی که `model.mask` استفاده می‌شود، ارتفاع و عرض آن باید با ارتفاع و عرض تصویر مرجع مطابقت داشته باشد. +- زمانی که `model.images` ارائه شود، گره در حالت ویرایش تصویر اجرا می‌شود؛ بدون `model.images`، تصاویر را تنها بر اساس درخواست متنی تولید می‌کند. +- تصاویر مرجع و ماسک پیش از ارسال به API مقیاس‌کوچک می‌شوند. +- سطوح کیفیت `"xhigh"` و `"max"` فقط برای `gpt-image-2.5-flare` و `gpt-image-2.5-sunburst` در دسترس هستند. +- گزینه پس‌زمینه `"transparent"` برای `gpt-image-2.5-flare`، `gpt-image-2.5-sunburst`، `gpt-image-1.5` و `gpt-image-1` در دسترس است، اما برای `gpt-image-2` نه. - `seed` در حال حاضر در بک‌اند پیاده‌سازی نشده است. ## خروجی‌ها | نام خروجی | توضیحات | نوع داده | | --- | --- | --- | -| `image` | تصویر یا تصاویر تولیدشده. همه تصاویر برگشتی در یک دسته (batch) انباشته می‌شوند؛ اگر ابعادشان متفاوت باشد، برای مطابقت با اولین تصویر تغییر اندازه می‌دهند. | IMAGE | +| `image` | تصویر یا تصاویر تولیدشده. همه تصاویر بازگردانده‌شده در یک دسته روی هم قرار می‌گیرند؛ اگر ابعادشان متفاوت باشد، برای مطابقت با اولین تصویر تغییر اندازه داده می‌شوند. | IMAGE | > این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/fa.md) --- -**Source fingerprint (SHA-256):** `fb3491f949151fbd3f5825ec9f9ae124019767d083f56966ef34af278aef50c0` +**Source fingerprint (SHA-256):** `4f77b79f9f432a1f2e0fd814012aebe7cc42a8aa983ee9a61f3b32984bf65148` diff --git a/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/fr.md b/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/fr.md index 7dcad677b..7ba4451df 100644 --- a/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/fr.md +++ b/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/fr.md @@ -1,17 +1,33 @@ # OpenAI GPT Image 2 -Ce nœud génère des images à l'aide de l'API GPT Image d'OpenAI. Il prend en charge plusieurs modèles (`gpt-image-2`, `gpt-image-1.5` et `gpt-image-1`), vous permet de fournir des images de référence pour l'édition, et peut utiliser un masque pour spécifier les parties d'une image à modifier. +Ce nœud génère des images à l'aide de l'API GPT Image d'OpenAI. Il prend en charge cinq modèles — `gpt-image-2.5-flare`, `gpt-image-2.5-sunburst`, `gpt-image-2`, `gpt-image-1.5` et `gpt-image-1` — vous permet de joindre des images de référence pour l'édition d'images et peut utiliser un masque pour spécifier les parties d'une image à remplacer. ## Entrées ### Entrées communes +Ces entrées sont toujours visibles. + | Paramètre | Description | Type de données | Requis | Plage | | --- | --- | --- | --- | --- | -| `modèle` | Le modèle GPT Image d'OpenAI à utiliser. La sélection d'un modèle révèle des paramètres supplémentaires spécifiques à ce modèle. | DYNAMIC_COMBO | Oui | `"gpt-image-2"`
`"gpt-image-1.5"`
`"gpt-image-1"` | -| `prompt` | Invite de texte pour GPT Image (défaut : `""`). | STRING | Oui | N/A | -| `n` | Nombre d'images à générer (défaut : `1`). | INT | Oui | 1 à 8 | -| `graine` | Graine pour la reproductibilité (défaut : `0`). Pas encore implémenté dans le backend. | INT | Oui | 0 à 2147483647 | +| `modèle` | Le modèle OpenAI GPT Image à utiliser. La sélection d'un modèle révèle des paramètres supplémentaires spécifiques à ce modèle. | DYNAMIC_COMBO | Oui | `"gpt-image-2.5-flare"`
`"gpt-image-2.5-sunburst"`
`"gpt-image-2"`
`"gpt-image-1.5"`
`"gpt-image-1"` | +| `prompt` | Invite de texte pour GPT Image (par défaut : `""`). | STRING | Oui | N/A | +| `n` | Nombre d'images à générer (par défaut : `1`). | INT | Oui | 1 à 8 | +| `graine` | Graine pour la reproductibilité (par défaut : `0`). Pas encore implémentée dans le backend. | INT | Oui | 0 à 2147483647 | + +### Entrées gpt-image-2.5-flare et gpt-image-2.5-sunburst + +Ces entrées apparaissent lorsque `model` est défini sur `gpt-image-2.5-flare` ou `gpt-image-2.5-sunburst`. Les deux modèles partagent le même ensemble de paramètres. + +| Paramètre | Description | Type de données | Requis | Plage | +| --- | --- | --- | --- | --- | +| `taille` | Taille de l'image. Sélectionnez « Custom » pour utiliser la largeur et la hauteur personnalisées (par défaut : `"auto"`). | COMBO | Oui | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | +| `largeur_personnalisée` | Utilisé uniquement lorsque `model.size` est réglé sur « Custom ». Doit être un multiple de 16 (par défaut : `1024`). | INT | Non | 480 à 3840 (pas de 16) | +| `hauteur_personnalisée` | Utilisé uniquement lorsque `model.size` est réglé sur « Custom ». Doit être un multiple de 16 (par défaut : `1024`). | INT | Non | 480 à 3840 (pas de 16) | +| `arrière-plan` | Renvoie l'image avec ou sans arrière-plan (par défaut : `"auto"`). | COMBO | Oui | `"auto"`
`"opaque"`
`"transparent"` | +| `qualité` | Qualité de l'image ; affecte le coût et le temps de génération (par défaut : `"low"`). | COMBO | Oui | `"low"`
`"medium"`
`"high"`
`"xhigh"`
`"max"` | +| `model.images` | Image(s) de référence facultative(s) pour l'édition d'images. Jusqu'à 16 images. Voir Entrées de référence pour plus de détails. | IMAGE | Non | 0 à 16 | +| `model.mask` | Masque facultatif pour l'inpainting (les zones blanches seront remplacées). Nécessite exactement une image de référence. | MASK | Non | N/A | ### Entrées gpt-image-2 @@ -19,12 +35,12 @@ Ces entrées apparaissent lorsque `model` est défini sur `gpt-image-2`. | Paramètre | Description | Type de données | Requis | Plage | | --- | --- | --- | --- | --- | -| `taille` | Taille de l'image. Sélectionnez « Custom » pour utiliser la largeur et la hauteur personnalisées (défaut : `"auto"`). | COMBO | Oui | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | -| `largeur_personnalisée` | Utilisé uniquement lorsque `model.size` est « Custom ». Doit être un multiple de 16 (défaut : `1024`). | INT | Non | 1024 à 3840 | -| `hauteur_personnalisée` | Utilisé uniquement lorsque `model.size` est « Custom ». Doit être un multiple de 16 (défaut : `1024`). | INT | Non | 1024 à 3840 | -| `arrière-plan` | Renvoie l'image avec ou sans arrière-plan (défaut : `"auto"`). | COMBO | Oui | `"auto"`
`"opaque"` | -| `qualité` | Qualité de l'image, affecte le coût et le temps de génération (défaut : `"low"`). | COMBO | Oui | `"low"`
`"medium"`
`"high"` | -| `model.images` | Image(s) de référence facultative(s) pour l'édition d'image. Jusqu'à 16 images. Voir Entrées de référence pour plus de détails. | IMAGE | Non | 0 à 16 | +| `taille` | Taille de l'image. Sélectionnez « Custom » pour utiliser la largeur et la hauteur personnalisées (par défaut : `"auto"`). | COMBO | Oui | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | +| `largeur_personnalisée` | Utilisé uniquement lorsque `model.size` est réglé sur « Custom ». Doit être un multiple de 16 (par défaut : `1024`). | INT | Non | 480 à 3840 (pas de 16) | +| `hauteur_personnalisée` | Utilisé uniquement lorsque `model.size` est réglé sur « Custom ». Doit être un multiple de 16 (par défaut : `1024`). | INT | Non | 480 à 3840 (pas de 16) | +| `arrière-plan` | Renvoie l'image avec ou sans arrière-plan (par défaut : `"auto"`). | COMBO | Oui | `"auto"`
`"opaque"` | +| `qualité` | Qualité de l'image ; affecte le coût et le temps de génération (par défaut : `"low"`). | COMBO | Oui | `"low"`
`"medium"`
`"high"` | +| `model.images` | Image(s) de référence facultative(s) pour l'édition d'images. Jusqu'à 16 images. Voir Entrées de référence pour plus de détails. | IMAGE | Non | 0 à 16 | | `model.mask` | Masque facultatif pour l'inpainting (les zones blanches seront remplacées). Nécessite exactement une image de référence. | MASK | Non | N/A | ### Entrées gpt-image-1.5 et gpt-image-1 @@ -33,26 +49,28 @@ Ces entrées apparaissent lorsque `model` est défini sur `gpt-image-1.5` ou `gp | Paramètre | Description | Type de données | Requis | Plage | | --- | --- | --- | --- | --- | -| `taille` | Taille de l'image (défaut : `"auto"`). | COMBO | Oui | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"` | -| `arrière-plan` | Renvoie l'image avec ou sans arrière-plan (défaut : `"auto"`). | COMBO | Oui | `"auto"`
`"opaque"`
`"transparent"` | -| `qualité` | Qualité de l'image, affecte le coût et le temps de génération (défaut : `"low"`). | COMBO | Oui | `"low"`
`"medium"`
`"high"` | -| `model.images` | Image(s) de référence facultative(s) pour l'édition d'image. Jusqu'à 16 images. Voir Entrées de référence pour plus de détails. | IMAGE | Non | 0 à 16 | +| `taille` | Taille de l'image (par défaut : `"auto"`). | COMBO | Oui | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"` | +| `arrière-plan` | Renvoie l'image avec ou sans arrière-plan (par défaut : `"auto"`). | COMBO | Oui | `"auto"`
`"opaque"`
`"transparent"` | +| `qualité` | Qualité de l'image ; affecte le coût et le temps de génération (par défaut : `"low"`). | COMBO | Oui | `"low"`
`"medium"`
`"high"` | +| `model.images` | Image(s) de référence facultative(s) pour l'édition d'images. Jusqu'à 16 images. Voir Entrées de référence pour plus de détails. | IMAGE | Non | 0 à 16 | | `model.mask` | Masque facultatif pour l'inpainting (les zones blanches seront remplacées). Nécessite exactement une image de référence. | MASK | Non | N/A | ### Entrées de référence | Paramètre | Description | Type de données | Requis | Plage | | --- | --- | --- | --- | --- | -| `model.images` | Emplacement extensible : connectez 1..N éléments (par ex. `image_1`...`image_16`) ; jusqu'à 16 images de référence pour tous les modèles. | IMAGE | Non | 1 à 16 | +| `model.images` | Connecteur extensible : connectez 1..N éléments (p. ex. `image_1`...`image_16`) ; jusqu'à 16 images de référence pour tous les modèles. | IMAGE | Non | 1 à 16 | | `model.mask` | Masque facultatif pour l'inpainting (les zones blanches seront remplacées). Nécessite exactement une image de référence. | MASK | Non | N/A | -**Contraintes et limitations des paramètres :** +**Contraintes et limites des paramètres :** -- Lorsque `model.size` est « Custom » (gpt-image-2 uniquement), `model.custom_width` et `model.custom_height` doivent tous deux être des multiples de 16, le bord le plus long ne doit pas dépasser 3840, le rapport hauteur/largeur ne doit pas dépasser 3:1, et le nombre total de pixels doit être compris entre 655 360 et 8 294 400. +- Lorsque `model.size` est réglé sur « Custom » (`gpt-image-2.5-flare`, `gpt-image-2.5-sunburst` et `gpt-image-2` uniquement), `model.custom_width` et `model.custom_height` doivent tous deux être des multiples de 16, le côté le plus long ne doit pas dépasser 3840, le rapport hauteur/largeur ne doit pas dépasser 3:1, et le nombre total de pixels doit être compris entre 655 360 et 8 294 400. - `model.mask` nécessite exactement une image de référence dans `model.images` : il ne peut pas être utilisé sans image, ni avec plus d'une image. -- Lorsque `model.mask` est utilisé, ses dimensions doivent correspondre à celles de l'image de référence. +- Lorsque `model.mask` est utilisé, sa hauteur et sa largeur doivent correspondre à la hauteur et à la largeur de l'image de référence. - Lorsque `model.images` est fourni, le nœud fonctionne en mode édition d'image ; sans `model.images`, il génère des images à partir de la seule invite. -- Les images de référence sont réduites avant d'être envoyées à l'API. +- La résolution des images de référence et du masque est réduite avant leur envoi à l'API. +- Les niveaux de qualité `"xhigh"` et `"max"` sont uniquement disponibles pour `gpt-image-2.5-flare` et `gpt-image-2.5-sunburst`. +- L'option d'arrière-plan `"transparent"` est disponible pour `gpt-image-2.5-flare`, `gpt-image-2.5-sunburst`, `gpt-image-1.5` et `gpt-image-1`, mais pas pour `gpt-image-2`. - `seed` n'est actuellement pas implémenté dans le backend. ## Sorties @@ -64,4 +82,4 @@ Ces entrées apparaissent lorsque `model` est défini sur `gpt-image-1.5` ou `gp > 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/OpenAIGPTImageNodeV2/fr.md) --- -**Source fingerprint (SHA-256):** `fb3491f949151fbd3f5825ec9f9ae124019767d083f56966ef34af278aef50c0` +**Source fingerprint (SHA-256):** `4f77b79f9f432a1f2e0fd814012aebe7cc42a8aa983ee9a61f3b32984bf65148` diff --git a/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/ja.md b/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/ja.md index 0a69f0f96..3ddb1dbb5 100644 --- a/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/ja.md +++ b/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/ja.md @@ -1,17 +1,33 @@ # OpenAI GPT Image 2 -このノードは、OpenAI の GPT Image API を使用して画像を生成します。複数のモデル(`gpt-image-2`、`gpt-image-1.5`、`gpt-image-1`)をサポートし、編集用の参照画像を提供したり、マスクを使用して画像のどの部分を変更するかを指定したりできます。 +このノードは、OpenAI の GPT Image API を使用して画像を生成します。`gpt-image-2.5-flare`、`gpt-image-2.5-sunburst`、`gpt-image-2`、`gpt-image-1.5`、`gpt-image-1` の5つのモデルに対応しており、画像編集用の参照画像を添付したり、マスクを使用して画像の置き換える部分を指定したりできます。 ## 入力 ### 共通入力 +これらの入力は常に表示されます。 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +| --- | --- | --- | --- | --- | +| `モデル` | 使用する OpenAI GPT Image モデル。モデルを選択すると、そのモデル固有の追加パラメータが表示されます。 | DYNAMIC_COMBO | はい | `"gpt-image-2.5-flare"`
`"gpt-image-2.5-sunburst"`
`"gpt-image-2"`
`"gpt-image-1.5"`
`"gpt-image-1"` | +| `プロンプト` | GPT Image 用のテキストプロンプト(デフォルト: `""`)。 | STRING | はい | N/A | +| `n` | 生成する画像の枚数(デフォルト: `1`)。 | INT | はい | 1〜8 | +| `シード` | 再現性のためのシード値(デフォルト: `0`)。バックエンドではまだ実装されていません。 | INT | はい | 0〜2147483647 | + +### gpt-image-2.5-flare および gpt-image-2.5-sunburst 入力 + +これらの入力は、`model` が `gpt-image-2.5-flare` または `gpt-image-2.5-sunburst` に設定されている場合に表示されます。両モデルは同じパラメータセットを共有します。 + | パラメータ | 説明 | データ型 | 必須 | 範囲 | | --- | --- | --- | --- | --- | -| `モデル` | 使用する OpenAI GPT Image モデルです。モデルを選択すると、そのモデルに固有の追加パラメータが表示されます。 | DYNAMIC_COMBO | 必須 | `"gpt-image-2"`
`"gpt-image-1.5"`
`"gpt-image-1"` | -| `プロンプト` | GPT Image へのテキストプロンプトです(デフォルト: `""`)。 | STRING | 必須 | N/A | -| `n` | 生成する画像の枚数です(デフォルト: `1`)。 | INT | 必須 | 1〜8 | -| `シード` | 再現性のためのシードです(デフォルト: `0`)。バックエンドではまだ実装されていません。 | INT | 必須 | 0〜2147483647 | +| `サイズ` | 画像サイズ。「Custom」を選択すると、カスタムの幅と高さを使用できます(デフォルト: `"auto"`)。 | COMBO | はい | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | +| `カスタム幅` | `model.size` が "Custom" の場合にのみ使用されます。16の倍数である必要があります(デフォルト: `1024`)。 | INT | いいえ | 480〜3840 (ステップ 16) | +| `カスタム高さ` | `model.size` が "Custom" の場合にのみ使用されます。16の倍数である必要があります(デフォルト: `1024`)。 | INT | いいえ | 480〜3840 (ステップ 16) | +| `背景` | 背景あり・なしの画像を返します(デフォルト: `"auto"`)。 | COMBO | はい | `"auto"`
`"opaque"`
`"transparent"` | +| `品質` | 画像品質。コストと生成時間に影響します(デフォルト: `"low"`)。 | COMBO | はい | `"low"`
`"medium"`
`"high"`
`"xhigh"`
`"max"` | +| `model.images` | 画像編集用のオプションの参照画像(複数可)。最大16枚。詳細は「参照入力」を参照してください。 | IMAGE | いいえ | 0〜16 | +| `model.mask` | インペインティング用のオプションのマスク(白い領域が置き換えられます)。参照画像が正確に1枚必要です。 | MASK | いいえ | N/A | ### gpt-image-2 入力 @@ -19,49 +35,51 @@ | パラメータ | 説明 | データ型 | 必須 | 範囲 | | --- | --- | --- | --- | --- | -| `サイズ` | 画像サイズです。「Custom」を選択すると、カスタムの幅と高さを使用します(デフォルト: `"auto"`)。 | COMBO | 必須 | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | -| `カスタム幅` | `model.size` が "Custom" の場合のみ使用されます。16 の倍数である必要があります(デフォルト: `1024`)。 | INT | 任意 | 1024〜3840 | -| `カスタム高さ` | `model.size` が "Custom" の場合のみ使用されます。16 の倍数である必要があります(デフォルト: `1024`)。 | INT | 任意 | 1024〜3840 | -| `背景` | 背景あり・なしの画像を返します(デフォルト: `"auto"`)。 | COMBO | 必須 | `"auto"`
`"opaque"` | -| `品質` | 画像品質です。コストと生成時間に影響します(デフォルト: `"low"`)。 | COMBO | 必須 | `"low"`
`"medium"`
`"high"` | -| `model.images` | 画像編集用のオプションの参照画像です。最大 16 枚です。詳細は「参照入力」を参照してください。 | IMAGE | 任意 | 0〜16 | -| `model.mask` | インペインティング用のオプションのマスクです(白い部分が置き換えられます)。参照画像が正確に 1 枚必要です。 | MASK | 任意 | N/A | +| `サイズ` | 画像サイズ。「Custom」を選択すると、カスタムの幅と高さを使用できます(デフォルト: `"auto"`)。 | COMBO | はい | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | +| `カスタム幅` | `model.size` が "Custom" の場合にのみ使用されます。16の倍数である必要があります(デフォルト: `1024`)。 | INT | いいえ | 480〜3840 (ステップ 16) | +| `カスタム高さ` | `model.size` が "Custom" の場合にのみ使用されます。16の倍数である必要があります(デフォルト: `1024`)。 | INT | いいえ | 480〜3840 (ステップ 16) | +| `背景` | 背景あり・なしの画像を返します(デフォルト: `"auto"`)。 | COMBO | はい | `"auto"`
`"opaque"` | +| `品質` | 画像品質。コストと生成時間に影響します(デフォルト: `"low"`)。 | COMBO | はい | `"low"`
`"medium"`
`"high"` | +| `model.images` | 画像編集用のオプションの参照画像(複数可)。最大16枚。詳細は「参照入力」を参照してください。 | IMAGE | いいえ | 0〜16 | +| `model.mask` | インペインティング用のオプションのマスク(白い領域が置き換えられます)。参照画像が正確に1枚必要です。 | MASK | いいえ | N/A | ### gpt-image-1.5 および gpt-image-1 入力 -これらの入力は、`model` が `gpt-image-1.5` または `gpt-image-1` に設定されている場合に表示されます。両方のモデルで同じパラメータセットを使用します。 +これらの入力は、`model` が `gpt-image-1.5` または `gpt-image-1` に設定されている場合に表示されます。両モデルは同じパラメータセットを共有します。 | パラメータ | 説明 | データ型 | 必須 | 範囲 | | --- | --- | --- | --- | --- | -| `サイズ` | 画像サイズです(デフォルト: `"auto"`)。 | COMBO | 必須 | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"` | -| `背景` | 背景あり・なしの画像を返します(デフォルト: `"auto"`)。 | COMBO | 必須 | `"auto"`
`"opaque"`
`"transparent"` | -| `品質` | 画像品質です。コストと生成時間に影響します(デフォルト: `"low"`)。 | COMBO | 必須 | `"low"`
`"medium"`
`"high"` | -| `model.images` | 画像編集用のオプションの参照画像です。最大 16 枚です。詳細は「参照入力」を参照してください。 | IMAGE | 任意 | 0〜16 | -| `model.mask` | インペインティング用のオプションのマスクです(白い部分が置き換えられます)。参照画像が正確に 1 枚必要です。 | MASK | 任意 | N/A | +| `サイズ` | 画像サイズ(デフォルト: `"auto"`)。 | COMBO | はい | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"` | +| `背景` | 背景あり・なしの画像を返します(デフォルト: `"auto"`)。 | COMBO | はい | `"auto"`
`"opaque"`
`"transparent"` | +| `品質` | 画像品質。コストと生成時間に影響します(デフォルト: `"low"`)。 | COMBO | はい | `"low"`
`"medium"`
`"high"` | +| `model.images` | 画像編集用のオプションの参照画像(複数可)。最大16枚。詳細は「参照入力」を参照してください。 | IMAGE | いいえ | 0〜16 | +| `model.mask` | インペインティング用のオプションのマスク(白い領域が置き換えられます)。参照画像が正確に1枚必要です。 | MASK | いいえ | N/A | ### 参照入力 | パラメータ | 説明 | データ型 | 必須 | 範囲 | | --- | --- | --- | --- | --- | -| `model.images` | 拡張可能スロットです。1..N 個のアイテム(例: `image_1`...`image_16`)を接続します。すべてのモデルで最大 16 枚の参照画像を使用できます。 | IMAGE | 任意 | 1〜16 | -| `model.mask` | インペインティング用のオプションのマスクです(白い部分が置き換えられます)。参照画像が正確に 1 枚必要です。 | MASK | 任意 | N/A | - -**パラメータの制約と制限事項:** - -- `model.size` が "Custom"(gpt-image-2 のみ)の場合、`model.custom_width` と `model.custom_height` は両方とも 16 の倍数である必要があります。最長辺は 3840 を超えてはならず、アスペクト比は 3:1 を超えてはならず、総ピクセル数は 655,360 から 8,294,400 の間である必要があります。 -- `model.mask` を使用するには、`model.images` 内に参照画像が正確に 1 枚必要です。画像なしでは使用できず、複数の画像があっても使用できません。 -- `model.mask` を使用する場合、その寸法は参照画像の寸法と一致している必要があります。 -- `model.images` が指定されている場合、ノードは画像編集モードで動作します。`model.images` がない場合は、プロンプトのみから画像を生成します。 -- 参照画像は API に送信される前に縮小されます。 +| `model.images` | 拡張可能スロット: 1..N 個の項目を接続できます(例: `image_1`...`image_16`)。すべてのモデルで最大16枚の参照画像を使用できます。 | IMAGE | いいえ | 1〜16 | +| `model.mask` | インペインティング用のオプションのマスク(白い領域が置き換えられます)。参照画像が正確に1枚必要です。 | MASK | いいえ | N/A | + +**パラメータの制約と制限:** + +- `model.size` が "Custom" の場合(`gpt-image-2.5-flare`、`gpt-image-2.5-sunburst`、および `gpt-image-2` のみ)、`model.custom_width` と `model.custom_height` は両方とも16の倍数である必要があります。最長辺は3840を超えてはならず、アスペクト比は3:1を超えてはならず、総ピクセル数は655,360〜8,294,400の範囲内である必要があります。 +- `model.mask` を使用するには、`model.images` に参照画像が正確に1枚含まれている必要があります。画像なしでは使用できず、また複数の画像と一緒にも使用できません。 +- `model.mask` を使用する場合、その高さと幅は参照画像の高さと幅と一致している必要があります。 +- `model.images` が指定された場合、ノードは画像編集モードで動作します。`model.images` がない場合は、プロンプトのみから画像を生成します。 +- 参照画像とマスクは、API に送信される前にダウンスケールされます。 +- `"xhigh"` および `"max"` の品質レベルは、`gpt-image-2.5-flare` と `gpt-image-2.5-sunburst` でのみ利用できます。 +- `"transparent"` 背景オプションは、`gpt-image-2.5-flare`、`gpt-image-2.5-sunburst`、`gpt-image-1.5`、`gpt-image-1` で利用できますが、`gpt-image-2` では利用できません。 - `seed` は現在バックエンドで実装されていません。 ## 出力 | 出力名 | 説明 | データ型 | | --- | --- | --- | -| `image` | 生成された画像です。返されたすべての画像は 1 つのバッチにスタックされます。寸法が異なる場合は、最初の画像に合わせてリサイズされます。 | IMAGE | +| `image` | 生成された画像。返されたすべての画像は1つのバッチにまとめられ、サイズが異なる場合は最初の画像に合わせてリサイズされます。 | IMAGE | > このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/ja.md) --- -**Source fingerprint (SHA-256):** `fb3491f949151fbd3f5825ec9f9ae124019767d083f56966ef34af278aef50c0` +**Source fingerprint (SHA-256):** `4f77b79f9f432a1f2e0fd814012aebe7cc42a8aa983ee9a61f3b32984bf65148` diff --git a/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/ko.md b/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/ko.md index 646a14c43..cb34c2258 100644 --- a/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/ko.md +++ b/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/ko.md @@ -1,67 +1,85 @@ # OpenAI GPT 이미지 2 -이 노드는 OpenAI의 GPT Image API를 사용하여 이미지를 생성합니다. 여러 모델(`gpt-image-2`, `gpt-image-1.5`, `gpt-image-1`)을 지원하며, 편집을 위한 참조 이미지를 제공할 수 있고, 마스크를 사용하여 이미지에서 수정할 부분을 지정할 수 있습니다. +이 노드는 OpenAI의 GPT Image API를 사용하여 이미지를 생성합니다. `gpt-image-2.5-flare`, `gpt-image-2.5-sunburst`, `gpt-image-2`, `gpt-image-1.5`, `gpt-image-1` 등 다섯 가지 모델을 지원하며, 이미지 편집을 위해 참조 이미지를 첨부할 수 있고, 마스크를 사용하여 이미지에서 교체할 부분을 지정할 수 있습니다. ## 입력 ### 공통 입력 +이 입력들은 항상 표시됩니다. + +| 매개변수 | 설명 | 데이터 타입 | 필수 여부 | 범위 | +| --- | --- | --- | --- | --- | +| `모델` | 사용할 OpenAI GPT Image 모델입니다. 모델을 선택하면 해당 모델에 특화된 추가 매개변수가 표시됩니다. | DYNAMIC_COMBO | 예 | `"gpt-image-2.5-flare"`
`"gpt-image-2.5-sunburst"`
`"gpt-image-2"`
`"gpt-image-1.5"`
`"gpt-image-1"` | +| `프롬프트` | GPT Image에 전달할 텍스트 프롬프트입니다(기본값: `""`). | STRING | 예 | 해당 없음 | +| `개수` | 생성할 이미지 수입니다(기본값: `1`). | INT | 예 | 1~8 | +| `시드` | 재현을 위한 시드입니다(기본값: `0`). 아직 백엔드에서 구현되지 않았습니다. | INT | 예 | 0~2147483647 | + +### gpt-image-2.5-flare 및 gpt-image-2.5-sunburst 입력 + +이 입력들은 `model`이 `gpt-image-2.5-flare` 또는 `gpt-image-2.5-sunburst`로 설정된 경우 표시됩니다. 두 모델은 동일한 매개변수 세트를 공유합니다. + | 매개변수 | 설명 | 데이터 타입 | 필수 여부 | 범위 | | --- | --- | --- | --- | --- | -| `모델` | 사용할 OpenAI GPT Image 모델입니다. 모델을 선택하면 해당 모델에 특화된 추가 매개변수가 표시됩니다. | DYNAMIC_COMBO | 예 | `"gpt-image-2"`
`"gpt-image-1.5"`
`"gpt-image-1"` | -| `프롬프트` | GPT Image용 텍스트 프롬프트(기본값: `""`). | STRING | 예 | N/A | -| `개수` | 생성할 이미지 수(기본값: `1`). | INT | 예 | 1 ~ 8 | -| `시드` | 재현성을 위한 시드(기본값: `0`). 아직 백엔드에서 구현되지 않았습니다. | INT | 예 | 0 ~ 2147483647 | +| `사이즈` | 이미지 크기입니다. 사용자 지정 너비와 높이를 사용하려면 "Custom"을 선택하세요(기본값: `"auto"`). | COMBO | 예 | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | +| `사용자 지정 너비` | `model.size`가 "Custom"일 때만 사용됩니다. 16의 배수여야 합니다(기본값: `1024`). | INT | 아니요 | 480~3840 (단계 16) | +| `사용자 지정 높이` | `model.size`가 "Custom"일 때만 사용됩니다. 16의 배수여야 합니다(기본값: `1024`). | INT | 아니요 | 480~3840 (단계 16) | +| `배경` | 배경 포함 여부를 지정하여 이미지를 반환합니다(기본값: `"auto"`). | COMBO | 예 | `"auto"`
`"opaque"`
`"transparent"` | +| `품질` | 이미지 품질입니다. 비용과 생성 시간에 영향을 줍니다(기본값: `"low"`). | COMBO | 예 | `"low"`
`"medium"`
`"high"`
`"xhigh"`
`"max"` | +| `model.images` | 이미지 편집을 위한 선택적 참조 이미지입니다. 최대 16개까지 사용할 수 있습니다. 자세한 내용은 참조 입력 섹션을 참조하세요. | IMAGE | 아니요 | 0~16 | +| `model.mask` | 인페인팅을 위한 선택적 마스크입니다(흰색 영역이 교체됩니다). 참조 이미지가 정확히 한 장 필요합니다. | MASK | 아니요 | 해당 없음 | ### gpt-image-2 입력 -이 입력은 `model`이 `gpt-image-2`로 설정된 경우에 나타납니다. +이 입력들은 `model`이 `gpt-image-2`로 설정된 경우 표시됩니다. | 매개변수 | 설명 | 데이터 타입 | 필수 여부 | 범위 | | --- | --- | --- | --- | --- | -| `사이즈` | 이미지 크기. 사용자 지정 너비와 높이를 사용하려면 "Custom"을 선택합니다(기본값: `"auto"`). | COMBO | 예 | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | -| `사용자 지정 너비` | `model.size`가 "Custom"인 경우에만 사용됩니다. 16의 배수여야 합니다(기본값: `1024`). | INT | 아니요 | 1024 ~ 3840 | -| `사용자 지정 높이` | `model.size`가 "Custom"인 경우에만 사용됩니다. 16의 배수여야 합니다(기본값: `1024`). | INT | 아니요 | 1024 ~ 3840 | -| `배경` | 배경이 있거나 없는 이미지를 반환합니다(기본값: `"auto"`). | COMBO | 예 | `"auto"`
`"opaque"` | -| `품질` | 이미지 품질. 비용과 생성 시간에 영향을 줍니다(기본값: `"low"`). | COMBO | 예 | `"low"`
`"medium"`
`"high"` | -| `model.images` | 이미지 편집을 위한 선택적 참조 이미지. 최대 16개 이미지. 자세한 내용은 참조 입력을 참조하세요. | IMAGE | 아니요 | 0 ~ 16 | -| `model.mask` | 인페인팅을 위한 선택적 마스크(흰색 영역은 대체됩니다). 참조 이미지가 정확히 하나 있어야 합니다. | MASK | 아니요 | N/A | +| `사이즈` | 이미지 크기입니다. 사용자 지정 너비와 높이를 사용하려면 "Custom"을 선택하세요(기본값: `"auto"`). | COMBO | 예 | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | +| `사용자 지정 너비` | `model.size`가 "Custom"일 때만 사용됩니다. 16의 배수여야 합니다(기본값: `1024`). | INT | 아니요 | 480~3840 (단계 16) | +| `사용자 지정 높이` | `model.size`가 "Custom"일 때만 사용됩니다. 16의 배수여야 합니다(기본값: `1024`). | INT | 아니요 | 480~3840 (단계 16) | +| `배경` | 배경 포함 여부를 지정하여 이미지를 반환합니다(기본값: `"auto"`). | COMBO | 예 | `"auto"`
`"opaque"` | +| `품질` | 이미지 품질입니다. 비용과 생성 시간에 영향을 줍니다(기본값: `"low"`). | COMBO | 예 | `"low"`
`"medium"`
`"high"` | +| `model.images` | 이미지 편집을 위한 선택적 참조 이미지입니다. 최대 16개까지 사용할 수 있습니다. 자세한 내용은 참조 입력 섹션을 참조하세요. | IMAGE | 아니요 | 0~16 | +| `model.mask` | 인페인팅을 위한 선택적 마스크입니다(흰색 영역이 교체됩니다). 참조 이미지가 정확히 한 장 필요합니다. | MASK | 아니요 | 해당 없음 | ### gpt-image-1.5 및 gpt-image-1 입력 -이 입력은 `model`이 `gpt-image-1.5` 또는 `gpt-image-1`로 설정된 경우 나타납니다. 두 모델은 동일한 매개변수 집합을 공유합니다. +이 입력들은 `model`이 `gpt-image-1.5` 또는 `gpt-image-1`로 설정된 경우 표시됩니다. 두 모델은 동일한 매개변수 세트를 공유합니다. | 매개변수 | 설명 | 데이터 타입 | 필수 여부 | 범위 | | --- | --- | --- | --- | --- | -| `사이즈` | 이미지 크기(기본값: `"auto"`). | COMBO | 예 | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"` | -| `배경` | 배경이 있거나 없는 이미지를 반환합니다(기본값: `"auto"`). | COMBO | 예 | `"auto"`
`"opaque"`
`"transparent"` | -| `품질` | 이미지 품질. 비용과 생성 시간에 영향을 줍니다(기본값: `"low"`). | COMBO | 예 | `"low"`
`"medium"`
`"high"` | -| `model.images` | 이미지 편집을 위한 선택적 참조 이미지. 최대 16개 이미지. 자세한 내용은 참조 입력을 참조하세요. | IMAGE | 아니요 | 0 ~ 16 | -| `model.mask` | 인페인팅을 위한 선택적 마스크(흰색 영역은 대체됩니다). 참조 이미지가 정확히 하나 있어야 합니다. | MASK | 아니요 | N/A | +| `사이즈` | 이미지 크기입니다(기본값: `"auto"`). | COMBO | 예 | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"` | +| `배경` | 배경 포함 여부를 지정하여 이미지를 반환합니다(기본값: `"auto"`). | COMBO | 예 | `"auto"`
`"opaque"`
`"transparent"` | +| `품질` | 이미지 품질입니다. 비용과 생성 시간에 영향을 줍니다(기본값: `"low"`). | COMBO | 예 | `"low"`
`"medium"`
`"high"` | +| `model.images` | 이미지 편집을 위한 선택적 참조 이미지입니다. 최대 16개까지 사용할 수 있습니다. 자세한 내용은 참조 입력 섹션을 참조하세요. | IMAGE | 아니요 | 0~16 | +| `model.mask` | 인페인팅을 위한 선택적 마스크입니다(흰색 영역이 교체됩니다). 참조 이미지가 정확히 한 장 필요합니다. | MASK | 아니요 | 해당 없음 | ### 참조 입력 | 매개변수 | 설명 | 데이터 타입 | 필수 여부 | 범위 | | --- | --- | --- | --- | --- | -| `model.images` | 확장 가능한 슬롯: 1..N개 항목(예: `image_1`...`image_16`)을 연결합니다. 모든 모델에서 최대 16개의 참조 이미지를 지원합니다. | IMAGE | 아니요 | 1 ~ 16 | -| `model.mask` | 인페인팅을 위한 선택적 마스크(흰색 영역은 대체됩니다). 참조 이미지가 정확히 하나 있어야 합니다. | MASK | 아니요 | N/A | +| `model.images` | 확장 가능 슬롯: 항목 1..N개를 연결합니다(예: `image_1`...`image_16`). 모든 모델에서 최대 16개의 참조 이미지를 지원합니다. | IMAGE | 아니요 | 1~16 | +| `model.mask` | 인페인팅을 위한 선택적 마스크입니다(흰색 영역이 교체됩니다). 참조 이미지가 정확히 한 장 필요합니다. | MASK | 아니요 | 해당 없음 | **매개변수 제약 조건 및 제한 사항:** -- `model.size`가 "Custom"일 때(gpt-image-2 전용), `model.custom_width` 및 `model.custom_height`는 모두 16의 배수여야 하며, 가장 긴 변은 3840을 초과할 수 없고, 종횡비는 3:1을 초과할 수 없으며, 총 픽셀 수는 655,360 이상 8,294,400 이하여야 합니다. -- `model.mask`는 `model.images`에 참조 이미지가 정확히 하나 있어야 합니다. 참조 이미지 없이는 사용할 수 없고, 두 개 이상의 이미지와 함께 사용할 수도 없습니다. -- `model.mask`를 사용하는 경우 해당 크기는 참조 이미지의 크기와 일치해야 합니다. -- `model.images`가 제공되면 노드는 이미지 편집 모드로 실행됩니다. `model.images`가 없으면 프롬프트만으로 이미지를 생성합니다. -- 참조 이미지는 API로 전송되기 전에 축소됩니다. -- `seed`는 현재 백엔드에 구현되어 있지 않습니다. +- `model.size`가 "Custom"인 경우(`gpt-image-2.5-flare`, `gpt-image-2.5-sunburst`, `gpt-image-2` 전용), `model.custom_width` 및 `model.custom_height`는 모두 16의 배수여야 하며, 가장 긴 변은 3840을 초과할 수 없고, 종횡비는 3:1을 초과할 수 없으며, 총 픽셀 수는 655,360 이상 8,294,400 이하여야 합니다. +- `model.mask`는 `model.images`에 참조 이미지가 정확히 한 장 있을 때만 사용할 수 있습니다. 이미지 없이는 사용할 수 없으며, 두 장 이상과 함께 사용할 수도 없습니다. +- `model.mask`를 사용할 때 마스크의 높이와 너비는 참조 이미지의 높이 및 너비와 일치해야 합니다. +- `model.images`가 제공되면 노드는 이미지 편집 모드로 실행되고, `model.images` 없이 프롬프트만으로 이미지를 생성합니다. +- 참조 이미지와 마스크는 API로 전송되기 전에 축소됩니다. +- `"xhigh"` 및 `"max"` 품질 수준은 `gpt-image-2.5-flare` 및 `gpt-image-2.5-sunburst`에서만 사용할 수 있습니다. +- `"transparent"` 배경 옵션은 `gpt-image-2.5-flare`, `gpt-image-2.5-sunburst`, `gpt-image-1.5`, `gpt-image-1`에서 사용할 수 있으며, `gpt-image-2`에서는 사용할 수 없습니다. +- `seed`는 현재 백엔드에서 구현되지 않았습니다. ## 출력 | 출력 이름 | 설명 | 데이터 타입 | | --- | --- | --- | -| `image` | 생성된 이미지(들). 반환된 모든 이미지는 하나의 배치로 쌓이며, 크기가 다를 경우 첫 번째 이미지에 맞춰 크기가 조정됩니다. | IMAGE | +| `image` | 생성된 이미지 또는 이미지들입니다. 반환된 모든 이미지는 하나의 배치로 결합되며, 크기가 다른 경우 첫 번째 이미지에 맞게 크기가 조정됩니다. | IMAGE | > 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/ko.md) --- -**Source fingerprint (SHA-256):** `fb3491f949151fbd3f5825ec9f9ae124019767d083f56966ef34af278aef50c0` +**Source fingerprint (SHA-256):** `4f77b79f9f432a1f2e0fd814012aebe7cc42a8aa983ee9a61f3b32984bf65148` diff --git a/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/pt-BR.md b/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/pt-BR.md index 1159974d1..daabee4fe 100644 --- a/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/pt-BR.md +++ b/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/pt-BR.md @@ -1,59 +1,77 @@ # OpenAI GPT Image 2 -Este nó gera imagens usando a API GPT Image da OpenAI. Ele suporta vários modelos (`gpt-image-2`, `gpt-image-1.5` e `gpt-image-1`), permite fornecer imagens de referência para edição e pode usar uma máscara para especificar quais partes de uma imagem modificar. +Este nó gera imagens usando a API GPT Image da OpenAI. Ele suporta cinco modelos: `gpt-image-2.5-flare`, `gpt-image-2.5-sunburst`, `gpt-image-2`, `gpt-image-1.5` e `gpt-image-1`. Também é possível anexar imagens de referência para edição de imagem e usar uma máscara para especificar quais partes de uma imagem devem ser substituídas. ## Entradas ### Entradas comuns -| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Faixa | +Estas entradas estão sempre visíveis. + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | | --- | --- | --- | --- | --- | -| `modelo` | O modelo GPT Image da OpenAI a ser usado. Selecionar um modelo revela parâmetros adicionais específicos desse modelo. | DYNAMIC_COMBO | Sim | `"gpt-image-2"`
`"gpt-image-1.5"`
`"gpt-image-1"` | -| `prompt` | Prompt de texto para GPT Image (padrão: `""`). | STRING | Sim | N/A | -| `n` | Quantas imagens gerar (padrão: `1`). | INT | Sim | 1 a 8 | -| `semente` | Semente para reprodutibilidade (padrão: `0`). Ainda não implementado no backend. | INT | Sim | 0 a 2147483647 | +| `modelo` | O modelo GPT Image da OpenAI a ser usado. Selecionar um modelo revela parâmetros adicionais específicos desse modelo. | DYNAMIC_COMBO | Sim | `"gpt-image-2.5-flare"`
`"gpt-image-2.5-sunburst"`
`"gpt-image-2"`
`"gpt-image-1.5"`
`"gpt-image-1"` | +| `prompt` | Prompt textual para o GPT Image (padrão: `""`). | STRING | Sim | N/A | +| `n` | Número de imagens a gerar (padrão: `1`). | INT | Sim | 1 a 8 | +| `semente` | Semente para reprodutibilidade (padrão: `0`). Este parâmetro ainda não está implementado no backend. | INT | Sim | 0 a 2147483647 | + +### Entradas do gpt-image-2.5-flare e gpt-image-2.5-sunburst + +Estas entradas aparecem quando `model` é definido como `gpt-image-2.5-flare` ou `gpt-image-2.5-sunburst`. Ambos os modelos compartilham o mesmo conjunto de parâmetros. + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | +| --- | --- | --- | --- | --- | +| `tamanho` | Tamanho da imagem. Selecione "Custom" para usar largura e altura personalizadas (padrão: `"auto"`). | COMBO | Sim | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | +| `largura_personalizada` | Usado apenas quando `model.size` for "Custom". Deve ser múltiplo de 16 (padrão: `1024`). | INT | Não | 480 a 3840 (passo 16) | +| `altura_personalizada` | Usado apenas quando `model.size` for "Custom". Deve ser múltiplo de 16 (padrão: `1024`). | INT | Não | 480 a 3840 (passo 16) | +| `fundo` | Retorna a imagem com ou sem fundo (padrão: `"auto"`). | COMBO | Sim | `"auto"`
`"opaque"`
`"transparent"` | +| `qualidade` | Qualidade da imagem; afeta o custo e o tempo de geração (padrão: `"low"`). | COMBO | Sim | `"low"`
`"medium"`
`"high"`
`"xhigh"`
`"max"` | +| `model.images` | Imagens de referência opcionais para edição de imagem. Até 16 imagens. Consulte Entradas de referência para obter detalhes. | IMAGE | Não | 0 a 16 | +| `model.mask` | Máscara opcional para inpainting (as áreas brancas serão substituídas). Requer exatamente uma imagem de referência. | MASK | Não | N/A | ### Entradas do gpt-image-2 -Estas entradas aparecem quando `model` está definido como `gpt-image-2`. +Estas entradas aparecem quando `model` é definido como `gpt-image-2`. -| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Faixa | +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | | --- | --- | --- | --- | --- | -| `tamanho` | Tamanho da imagem. Selecione "Custom" para usar a largura e a altura personalizadas (padrão: `"auto"`). | COMBO | Sim | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | -| `largura_personalizada` | Utilizado somente quando `model.size` for "Custom". Deve ser um múltiplo de 16 (padrão: `1024`). | INT | Não | 1024 a 3840 | -| `altura_personalizada` | Utilizado somente quando `model.size` for "Custom". Deve ser um múltiplo de 16 (padrão: `1024`). | INT | Não | 1024 a 3840 | +| `tamanho` | Tamanho da imagem. Selecione "Custom" para usar largura e altura personalizadas (padrão: `"auto"`). | COMBO | Sim | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | +| `largura_personalizada` | Usado apenas quando `model.size` for "Custom". Deve ser múltiplo de 16 (padrão: `1024`). | INT | Não | 480 a 3840 (passo 16) | +| `altura_personalizada` | Usado apenas quando `model.size` for "Custom". Deve ser múltiplo de 16 (padrão: `1024`). | INT | Não | 480 a 3840 (passo 16) | | `fundo` | Retorna a imagem com ou sem fundo (padrão: `"auto"`). | COMBO | Sim | `"auto"`
`"opaque"` | | `qualidade` | Qualidade da imagem; afeta o custo e o tempo de geração (padrão: `"low"`). | COMBO | Sim | `"low"`
`"medium"`
`"high"` | -| `model.images` | Imagens de referência opcionais para edição de imagem. Até 16 imagens. Consulte as Entradas de referência para obter detalhes. | IMAGE | Não | 0 a 16 | +| `model.images` | Imagens de referência opcionais para edição de imagem. Até 16 imagens. Consulte Entradas de referência para obter detalhes. | IMAGE | Não | 0 a 16 | | `model.mask` | Máscara opcional para inpainting (as áreas brancas serão substituídas). Requer exatamente uma imagem de referência. | MASK | Não | N/A | ### Entradas do gpt-image-1.5 e gpt-image-1 -Estas entradas aparecem quando `model` está definido como `gpt-image-1.5` ou `gpt-image-1`. Ambos os modelos compartilham o mesmo conjunto de parâmetros. +Estas entradas aparecem quando `model` é definido como `gpt-image-1.5` ou `gpt-image-1`. Ambos os modelos compartilham o mesmo conjunto de parâmetros. -| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Faixa | +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | | --- | --- | --- | --- | --- | | `tamanho` | Tamanho da imagem (padrão: `"auto"`). | COMBO | Sim | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"` | | `fundo` | Retorna a imagem com ou sem fundo (padrão: `"auto"`). | COMBO | Sim | `"auto"`
`"opaque"`
`"transparent"` | | `qualidade` | Qualidade da imagem; afeta o custo e o tempo de geração (padrão: `"low"`). | COMBO | Sim | `"low"`
`"medium"`
`"high"` | -| `model.images` | Imagens de referência opcionais para edição de imagem. Até 16 imagens. Consulte as Entradas de referência para obter detalhes. | IMAGE | Não | 0 a 16 | +| `model.images` | Imagens de referência opcionais para edição de imagem. Até 16 imagens. Consulte Entradas de referência para obter detalhes. | IMAGE | Não | 0 a 16 | | `model.mask` | Máscara opcional para inpainting (as áreas brancas serão substituídas). Requer exatamente uma imagem de referência. | MASK | Não | N/A | ### Entradas de referência -| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Faixa | +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | | --- | --- | --- | --- | --- | -| `model.images` | Slot expansível: conecte de 1 a N itens (ex.: `image_1`...`image_16`); até 16 imagens de referência para todos os modelos. | IMAGE | Não | 1 a 16 | +| `model.images` | Slot expansível: conecte de 1 a N itens (por exemplo, `image_1`...`image_16`); até 16 imagens de referência para todos os modelos. | IMAGE | Não | 1 a 16 | | `model.mask` | Máscara opcional para inpainting (as áreas brancas serão substituídas). Requer exatamente uma imagem de referência. | MASK | Não | N/A | **Restrições e limitações dos parâmetros:** -- Quando `model.size` for "Custom" (somente no gpt-image-2), `model.custom_width` e `model.custom_height` devem ser ambos múltiplos de 16, o maior lado não deve exceder 3840, a razão de aspecto não deve exceder 3:1 e o número total de pixels deve estar entre 655.360 e 8.294.400. -- O parâmetro `model.mask` requer exatamente uma imagem de referência em `model.images`: não pode ser usado sem uma imagem nem com mais de uma imagem. -- Ao usar `model.mask`, suas dimensões devem corresponder às dimensões da imagem de referência. -- Quando o parâmetro `model.images` é fornecido, o nó opera no modo de edição de imagem; sem `model.images`, ele gera imagens apenas a partir do prompt. -- As imagens de referência são reduzidas em escala antes de serem enviadas à API. -- O parâmetro `seed` atualmente não está implementado no backend. +- Quando `model.size` for "Custom" (apenas `gpt-image-2.5-flare`, `gpt-image-2.5-sunburst` e `gpt-image-2`), tanto `model.custom_width` quanto `model.custom_height` devem ser múltiplos de 16, o maior lado não pode exceder 3840, a proporção entre as dimensões não pode exceder 3:1 e o número total de pixels deve estar entre 655.360 e 8.294.400. +- `model.mask` exige exatamente uma imagem de referência em `model.images`: ela não pode ser usada sem uma imagem nem com mais de uma imagem. +- Quando `model.mask` for usada, a altura e a largura da máscara devem corresponder às da imagem de referência. +- Quando `model.images` for fornecido, o nó opera no modo de edição de imagem; sem `model.images`, ele gera imagens apenas com base no prompt. +- As imagens de referência e a máscara são reduzidas em escala antes de serem enviadas para a API. +- Os níveis de qualidade `"xhigh"` e `"max"` estão disponíveis apenas para `gpt-image-2.5-flare` e `gpt-image-2.5-sunburst`. +- A opção de fundo `"transparent"` está disponível para `gpt-image-2.5-flare`, `gpt-image-2.5-sunburst`, `gpt-image-1.5` e `gpt-image-1`, mas não para `gpt-image-2`. +- Atualmente, `seed` não está implementado no backend. ## Saídas @@ -64,4 +82,4 @@ Estas entradas aparecem quando `model` está definido como `gpt-image-1.5` ou `g > 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/OpenAIGPTImageNodeV2/pt-BR.md) --- -**Source fingerprint (SHA-256):** `fb3491f949151fbd3f5825ec9f9ae124019767d083f56966ef34af278aef50c0` +**Source fingerprint (SHA-256):** `4f77b79f9f432a1f2e0fd814012aebe7cc42a8aa983ee9a61f3b32984bf65148` diff --git a/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/ru.md b/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/ru.md index 4a5cecd1f..3ad6752f2 100644 --- a/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/ru.md +++ b/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/ru.md @@ -1,67 +1,85 @@ # OpenAI GPT Image 2 -Этот узел генерирует изображения с помощью OpenAI GPT Image API. Он поддерживает несколько моделей (`gpt-image-2`, `gpt-image-1.5` и `gpt-image-1`), позволяет предоставлять эталонные изображения для редактирования и использовать маску для указания частей изображения, которые нужно изменить. +Этот узел генерирует изображения с помощью OpenAI GPT Image API. Он поддерживает пять моделей — `gpt-image-2.5-flare`, `gpt-image-2.5-sunburst`, `gpt-image-2`, `gpt-image-1.5` и `gpt-image-1` — позволяет прикреплять эталонные изображения для редактирования изображений и может использовать маску, чтобы указать, какие части изображения следует заменить. ## Входы ### Общие входы +Эти входы отображаются всегда. + | Параметр | Описание | Тип данных | Обязательный | Диапазон | | --- | --- | --- | --- | --- | -| `model` | Модель OpenAI GPT Image для использования. Выбор модели открывает дополнительные параметры, специфичные для этой модели. | DYNAMIC_COMBO | Да | `"gpt-image-2"`
`"gpt-image-1.5"`
`"gpt-image-1"` | -| `prompt` | Текстовый промпт для GPT Image (по умолчанию: `""`). | STRING | Да | N/A | -| `n` | Сколько изображений сгенерировать (по умолчанию: `1`). | INT | Да | 1 до 8 | -| `seed` | Сид для воспроизводимости результатов (по умолчанию: `0`). В бэкенде пока не реализовано. | INT | Да | 0 до 2147483647 | +| `model` | Модель OpenAI GPT Image для использования. Выбор модели открывает дополнительные параметры, специфичные для этой модели. | DYNAMIC_COMBO | Да | `"gpt-image-2.5-flare"`
`"gpt-image-2.5-sunburst"`
`"gpt-image-2"`
`"gpt-image-1.5"`
`"gpt-image-1"` | +| `prompt` | Текстовый запрос для GPT Image (по умолчанию: `""`). | STRING | Да | N/A | +| `n` | Сколько изображений генерировать (по умолчанию: `1`). | INT | Да | 1 до 8 | +| `seed` | Сид для воспроизводимости результатов (по умолчанию: `0`). Пока не реализован в бэкенде. | INT | Да | 0 до 2147483647 | + +### Входы gpt-image-2.5-flare и gpt-image-2.5-sunburst + +Эти входы появляются, когда `model` установлен в `gpt-image-2.5-flare` или `gpt-image-2.5-sunburst`. Обе модели используют одинаковый набор параметров. + +| Параметр | Описание | Тип данных | Обязательный | Диапазон | +| --- | --- | --- | --- | --- | +| `size` | Размер изображения. Выберите "Custom", чтобы использовать произвольные ширину и высоту (по умолчанию: `"auto"`). | COMBO | Да | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | +| `custom_width` | Используется только когда `model.size` установлен в "Custom". Должно быть кратно 16 (по умолчанию: `1024`). | INT | Нет | 480 до 3840 (шаг 16) | +| `custom_height` | Используется только когда `model.size` установлен в "Custom". Должно быть кратно 16 (по умолчанию: `1024`). | INT | Нет | 480 до 3840 (шаг 16) | +| `background` | Возвращать изображение с фоном или без него (по умолчанию: `"auto"`). | COMBO | Да | `"auto"`
`"opaque"`
`"transparent"` | +| `quality` | Качество изображения, влияет на стоимость и время генерации (по умолчанию: `"low"`). | COMBO | Да | `"low"`
`"medium"`
`"high"`
`"xhigh"`
`"max"` | +| `model.images` | Необязательные эталонные изображения для редактирования изображений. До 16 изображений. Подробнее см. «Эталонные входы». | IMAGE | Нет | 0 до 16 | +| `model.mask` | Необязательная маска для инпейнтинга (белые области будут заменены). Требуется ровно одно эталонное изображение. | MASK | Нет | N/A | ### Входы gpt-image-2 -Эти входы появляются, когда для `model` задано значение `gpt-image-2`. +Эти входы появляются, когда `model` установлен в `gpt-image-2`. | Параметр | Описание | Тип данных | Обязательный | Диапазон | | --- | --- | --- | --- | --- | -| `size` | Размер изображения. Выберите «Custom», чтобы использовать собственные ширину и высоту (по умолчанию: `"auto"`). | COMBO | Да | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | -| `custom_width` | Используется только когда `model.size` имеет значение «Custom». Значение должно быть кратно 16 (по умолчанию: `1024`). | INT | Нет | 1024 до 3840 | -| `custom_height` | Используется только когда `model.size` имеет значение «Custom». Значение должно быть кратно 16 (по умолчанию: `1024`). | INT | Нет | 1024 до 3840 | -| `background` | Возвращать изображение с фоном или без фона (по умолчанию: `"auto"`). | COMBO | Да | `"auto"`
`"opaque"` | +| `size` | Размер изображения. Выберите "Custom", чтобы использовать произвольные ширину и высоту (по умолчанию: `"auto"`). | COMBO | Да | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | +| `custom_width` | Используется только когда `model.size` установлен в "Custom". Должно быть кратно 16 (по умолчанию: `1024`). | INT | Нет | 480 до 3840 (шаг 16) | +| `custom_height` | Используется только когда `model.size` установлен в "Custom". Должно быть кратно 16 (по умолчанию: `1024`). | INT | Нет | 480 до 3840 (шаг 16) | +| `background` | Возвращать изображение с фоном или без него (по умолчанию: `"auto"`). | COMBO | Да | `"auto"`
`"opaque"` | | `quality` | Качество изображения, влияет на стоимость и время генерации (по умолчанию: `"low"`). | COMBO | Да | `"low"`
`"medium"`
`"high"` | -| `model.images` | Необязательное эталонное изображение (изображения) для редактирования. До 16 изображений. Подробнее см. «Эталонные входы». | IMAGE | Нет | 0 до 16 | +| `model.images` | Необязательные эталонные изображения для редактирования изображений. До 16 изображений. Подробнее см. «Эталонные входы». | IMAGE | Нет | 0 до 16 | | `model.mask` | Необязательная маска для инпейнтинга (белые области будут заменены). Требуется ровно одно эталонное изображение. | MASK | Нет | N/A | ### Входы gpt-image-1.5 и gpt-image-1 -Эти входы появляются, когда для `model` задано значение `gpt-image-1.5` или `gpt-image-1`. Обе модели используют одинаковый набор параметров. +Эти входы появляются, когда `model` установлен в `gpt-image-1.5` или `gpt-image-1`. Обе модели используют одинаковый набор параметров. | Параметр | Описание | Тип данных | Обязательный | Диапазон | | --- | --- | --- | --- | --- | | `size` | Размер изображения (по умолчанию: `"auto"`). | COMBO | Да | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"` | -| `background` | Возвращать изображение с фоном или без фона (по умолчанию: `"auto"`). | COMBO | Да | `"auto"`
`"opaque"`
`"transparent"` | +| `background` | Возвращать изображение с фоном или без него (по умолчанию: `"auto"`). | COMBO | Да | `"auto"`
`"opaque"`
`"transparent"` | | `quality` | Качество изображения, влияет на стоимость и время генерации (по умолчанию: `"low"`). | COMBO | Да | `"low"`
`"medium"`
`"high"` | -| `model.images` | Необязательное эталонное изображение (изображения) для редактирования. До 16 изображений. Подробнее см. «Эталонные входы». | IMAGE | Нет | 0 до 16 | +| `model.images` | Необязательные эталонные изображения для редактирования изображений. До 16 изображений. Подробнее см. «Эталонные входы». | IMAGE | Нет | 0 до 16 | | `model.mask` | Необязательная маска для инпейнтинга (белые области будут заменены). Требуется ровно одно эталонное изображение. | MASK | Нет | N/A | ### Эталонные входы | Параметр | Описание | Тип данных | Обязательный | Диапазон | | --- | --- | --- | --- | --- | -| `model.images` | Расширяемый слот: можно подключить от 1 до N элементов (например, `image_1`...`image_16`); до 16 эталонных изображений для всех моделей. | IMAGE | Нет | 1 до 16 | +| `model.images` | Расширяемый слот: подключайте элементы от 1 до N (например, `image_1`...`image_16`); до 16 эталонных изображений для всех моделей. | IMAGE | Нет | 1 до 16 | | `model.mask` | Необязательная маска для инпейнтинга (белые области будут заменены). Требуется ровно одно эталонное изображение. | MASK | Нет | N/A | -**Ограничения параметров:** +**Ограничения и лимиты параметров:** -- Когда `model.size` имеет значение «Custom» (только для gpt-image-2), `model.custom_width` и `model.custom_height` должны быть кратны 16, самая длинная сторона не должна превышать 3840, соотношение сторон не должно превышать 3:1, а общее количество пикселей должно составлять от 655 360 до 8 294 400. -- `model.mask` требует ровно одного эталонного изображения в `model.images`: его нельзя использовать без изображения или с более чем одним изображением. -- При использовании `model.mask` её размеры должны совпадать с размерами эталонного изображения. -- Если указано `model.images`, узел работает в режиме редактирования изображения; без `model.images` он генерирует изображения только на основе промпта. -- Эталонные изображения уменьшаются перед отправкой в API. +- Когда `model.size` установлен в "Custom" (только для `gpt-image-2.5-flare`, `gpt-image-2.5-sunburst` и `gpt-image-2`), `model.custom_width` и `model.custom_height` должны быть кратны 16, длина наибольшей стороны не должна превышать 3840, соотношение сторон не должно превышать 3:1, а общее количество пикселей должно быть от 655 360 до 8 294 400. +- Параметр `model.mask` требует ровно одного эталонного изображения в `model.images`: он не может использоваться без изображения и не может использоваться более чем с одним изображением. +- При использовании `model.mask` его высота и ширина должны совпадать с высотой и шириной эталонного изображения. +- Когда `model.images` предоставлено, узел работает в режиме редактирования изображения; без `model.images` он генерирует изображения только на основе запроса. +- Эталонные изображения и маска уменьшаются перед отправкой в API. +- Уровни качества `"xhigh"` и `"max"` доступны только для `gpt-image-2.5-flare` и `gpt-image-2.5-sunburst`. +- Вариант фона `"transparent"` доступен для `gpt-image-2.5-flare`, `gpt-image-2.5-sunburst`, `gpt-image-1.5` и `gpt-image-1`, но не для `gpt-image-2`. - `seed` в настоящее время не реализован в бэкенде. ## Выходы | Имя выхода | Описание | Тип данных | | --- | --- | --- | -| `image` | Сгенерированное изображение или изображения. Все возвращённые изображения объединяются в один пакет; если их размеры различаются, они масштабируются до размеров первого изображения. | IMAGE | +| `image` | Сгенерированное изображение или изображения. Все возвращенные изображения объединяются в один пакет; если их размеры различаются, они масштабируются до размеров первого изображения. | IMAGE | > Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/ru.md) --- -**Source fingerprint (SHA-256):** `fb3491f949151fbd3f5825ec9f9ae124019767d083f56966ef34af278aef50c0` +**Source fingerprint (SHA-256):** `4f77b79f9f432a1f2e0fd814012aebe7cc42a8aa983ee9a61f3b32984bf65148` diff --git a/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/tr.md b/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/tr.md index 8abd678eb..d79bf1108 100644 --- a/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/tr.md +++ b/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/tr.md @@ -1,17 +1,33 @@ # OpenAI GPT Görüntü 2 -Bu düğüm, OpenAI'nin GPT Image API'sini kullanarak görseller üretir. Birden fazla modeli (`gpt-image-2`, `gpt-image-1.5` ve `gpt-image-1`) destekler, düzenleme için referans görseller sağlamanıza olanak tanır ve bir görselin hangi bölümlerinin değiştirileceğini belirtmek için bir maske kullanabilir. +Bu düğüm, OpenAI'nin GPT Image API'sini kullanarak görüntüler üretir. Beş modeli destekler — `gpt-image-2.5-flare`, `gpt-image-2.5-sunburst`, `gpt-image-2`, `gpt-image-1.5` ve `gpt-image-1` — görüntü düzenleme için referans görüntüler eklemenize olanak tanır ve bir görüntünün hangi bölümlerinin değiştirileceğini belirtmek için maske kullanabilir. ## Girdiler ### Ortak Girdiler +Bu girdiler her zaman görünür. + | Parametre | Açıklama | Veri Türü | Gerekli | Aralık | | --- | --- | --- | --- | --- | -| `model` | Kullanılacak OpenAI GPT Image modeli. Bir model seçmek, o modele özgü ek parametreleri ortaya çıkarır. | DYNAMIC_COMBO | Evet | `"gpt-image-2"`
`"gpt-image-1.5"`
`"gpt-image-1"` | +| `model` | Kullanılacak OpenAI GPT Image modeli. Bir model seçmek, o modele özgü ek parametreleri ortaya çıkarır. | DYNAMIC_COMBO | Evet | `"gpt-image-2.5-flare"`
`"gpt-image-2.5-sunburst"`
`"gpt-image-2"`
`"gpt-image-1.5"`
`"gpt-image-1"` | | `istem` | GPT Image için metin istemi (varsayılan: `""`). | STRING | Evet | N/A | -| `n` | Kaç adet görsel üretileceği (varsayılan: `1`). | INT | Evet | 1 ile 8 | -| `tohum` | Tekrar üretilebilirlik için tohum (seed) değeri (varsayılan: `0`). Henüz arka uçta uygulanmadı. | INT | Evet | 0 ile 2147483647 | +| `n` | Üretilecek görüntü sayısı (varsayılan: `1`). | INT | Evet | 1 ile 8 | +| `tohum` | Tekrarlanabilirlik için tohum (seed) değeri (varsayılan: `0`). Henüz arka uçta uygulanmadı. | INT | Evet | 0 ile 2147483647 | + +### gpt-image-2.5-flare ve gpt-image-2.5-sunburst Girdileri + +Bu girdiler, `model` `gpt-image-2.5-flare` veya `gpt-image-2.5-sunburst` olarak ayarlandığında görünür. Her iki model de aynı parametre kümesini paylaşır. + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +| --- | --- | --- | --- | --- | +| `boyut` | Görüntü boyutu. Özel genişlik ve yüksekliği kullanmak için "Custom" seçin (varsayılan: `"auto"`). | COMBO | Evet | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | +| `özel_genişlik` | Yalnızca `model.size` "Custom" olduğunda kullanılır. 16'nın katı olmalıdır (varsayılan: `1024`). | INT | Hayır | 480 ile 3840 (adım 16) | +| `özel_yükseklik` | Yalnızca `model.size` "Custom" olduğunda kullanılır. 16'nın katı olmalıdır (varsayılan: `1024`). | INT | Hayır | 480 ile 3840 (adım 16) | +| `arka_plan` | Görüntüyü arka planlı veya arka plansız döndürür (varsayılan: `"auto"`). | COMBO | Evet | `"auto"`
`"opaque"`
`"transparent"` | +| `kalite` | Görüntü kalitesi; maliyeti ve üretim süresini etkiler (varsayılan: `"low"`). | COMBO | Evet | `"low"`
`"medium"`
`"high"`
`"xhigh"`
`"max"` | +| `model.images` | Görüntü düzenleme için isteğe bağlı referans görüntü(ler). En fazla 16 görüntü. Ayrıntılar için Referans Girdileri bölümüne bakın. | IMAGE | Hayır | 0 ile 16 | +| `model.mask` | Inpainting için isteğe bağlı maske (beyaz alanlar değiştirilir). Tam olarak bir referans görüntü gerektirir. | MASK | Hayır | N/A | ### gpt-image-2 Girdileri @@ -19,13 +35,13 @@ Bu girdiler, `model` `gpt-image-2` olarak ayarlandığında görünür. | Parametre | Açıklama | Veri Türü | Gerekli | Aralık | | --- | --- | --- | --- | --- | -| `boyut` | Görsel boyutu. Özel genişlik ve yüksekliği kullanmak için "Custom" seçin (varsayılan: `"auto"`). | COMBO | Evet | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | -| `özel_genişlik` | Yalnızca `model.size` "Custom" olduğunda kullanılır. 16'nın katı olmalıdır (varsayılan: `1024`). | INT | Hayır | 1024 ile 3840 | -| `özel_yükseklik` | Yalnızca `model.size` "Custom" olduğunda kullanılır. 16'nın katı olmalıdır (varsayılan: `1024`). | INT | Hayır | 1024 ile 3840 | -| `arka_plan` | Görseli arka planlı veya arka plansız döndürür (varsayılan: `"auto"`). | COMBO | Evet | `"auto"`
`"opaque"` | -| `kalite` | Görsel kalitesi, maliyeti ve üretim süresini etkiler (varsayılan: `"low"`). | COMBO | Evet | `"low"`
`"medium"`
`"high"` | -| `model.images` | Görsel düzenleme için isteğe bağlı referans görsel(ler)i. En fazla 16 görsel. Ayrıntılar için Referans Girdileri'ne bakın. | IMAGE | Hayır | 0 ile 16 | -| `model.mask` | Inpainting için isteğe bağlı maske (beyaz alanlar değiştirilecektir). Tam olarak bir referans görsel gerektirir. | MASK | Hayır | N/A | +| `boyut` | Görüntü boyutu. Özel genişlik ve yüksekliği kullanmak için "Custom" seçin (varsayılan: `"auto"`). | COMBO | Evet | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | +| `özel_genişlik` | Yalnızca `model.size` "Custom" olduğunda kullanılır. 16'nın katı olmalıdır (varsayılan: `1024`). | INT | Hayır | 480 ile 3840 (adım 16) | +| `özel_yükseklik` | Yalnızca `model.size` "Custom" olduğunda kullanılır. 16'nın katı olmalıdır (varsayılan: `1024`). | INT | Hayır | 480 ile 3840 (adım 16) | +| `arka_plan` | Görüntüyü arka planlı veya arka plansız döndürür (varsayılan: `"auto"`). | COMBO | Evet | `"auto"`
`"opaque"` | +| `kalite` | Görüntü kalitesi; maliyeti ve üretim süresini etkiler (varsayılan: `"low"`). | COMBO | Evet | `"low"`
`"medium"`
`"high"` | +| `model.images` | Görüntü düzenleme için isteğe bağlı referans görüntü(ler). En fazla 16 görüntü. Ayrıntılar için Referans Girdileri bölümüne bakın. | IMAGE | Hayır | 0 ile 16 | +| `model.mask` | Inpainting için isteğe bağlı maske (beyaz alanlar değiştirilir). Tam olarak bir referans görüntü gerektirir. | MASK | Hayır | N/A | ### gpt-image-1.5 ve gpt-image-1 Girdileri @@ -33,35 +49,37 @@ Bu girdiler, `model` `gpt-image-1.5` veya `gpt-image-1` olarak ayarlandığında | Parametre | Açıklama | Veri Türü | Gerekli | Aralık | | --- | --- | --- | --- | --- | -| `boyut` | Görsel boyutu (varsayılan: `"auto"`). | COMBO | Evet | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"` | -| `arka_plan` | Görseli arka planlı veya arka plansız döndürür (varsayılan: `"auto"`). | COMBO | Evet | `"auto"`
`"opaque"`
`"transparent"` | -| `kalite` | Görsel kalitesi, maliyeti ve üretim süresini etkiler (varsayılan: `"low"`). | COMBO | Evet | `"low"`
`"medium"`
`"high"` | -| `model.images` | Görsel düzenleme için isteğe bağlı referans görsel(ler)i. En fazla 16 görsel. Ayrıntılar için Referans Girdileri'ne bakın. | IMAGE | Hayır | 0 ile 16 | -| `model.mask` | Inpainting için isteğe bağlı maske (beyaz alanlar değiştirilecektir). Tam olarak bir referans görsel gerektirir. | MASK | Hayır | N/A | +| `boyut` | Görüntü boyutu (varsayılan: `"auto"`). | COMBO | Evet | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"` | +| `arka_plan` | Görüntüyü arka planlı veya arka plansız döndürür (varsayılan: `"auto"`). | COMBO | Evet | `"auto"`
`"opaque"`
`"transparent"` | +| `kalite` | Görüntü kalitesi; maliyeti ve üretim süresini etkiler (varsayılan: `"low"`). | COMBO | Evet | `"low"`
`"medium"`
`"high"` | +| `model.images` | Görüntü düzenleme için isteğe bağlı referans görüntü(ler). En fazla 16 görüntü. Ayrıntılar için Referans Girdileri bölümüne bakın. | IMAGE | Hayır | 0 ile 16 | +| `model.mask` | Inpainting için isteğe bağlı maske (beyaz alanlar değiştirilir). Tam olarak bir referans görüntü gerektirir. | MASK | Hayır | N/A | ### Referans Girdileri | Parametre | Açıklama | Veri Türü | Gerekli | Aralık | | --- | --- | --- | --- | --- | -| `model.images` | Genişletilebilir yuva: 1..N öğe bağlayın (örn. `image_1`...`image_16`); tüm modeller için en fazla 16 referans görsel. | IMAGE | Hayır | 1 ile 16 | -| `model.mask` | Inpainting için isteğe bağlı maske (beyaz alanlar değiştirilecektir). Tam olarak bir referans görsel gerektirir. | MASK | Hayır | N/A | +| `model.images` | Genişletilebilir yuva: 1..N öğe bağlayın (örn. `image_1`...`image_16`); tüm modeller için en fazla 16 referans görüntü. | IMAGE | Hayır | 1 ile 16 | +| `model.mask` | Inpainting için isteğe bağlı maske (beyaz alanlar değiştirilir). Tam olarak bir referans görüntü gerektirir. | MASK | Hayır | N/A | **Parametre Kısıtlamaları ve Sınırlamalar:** -- `model.size` "Custom" olduğunda (yalnızca gpt-image-2), `model.custom_width` ve `model.custom_height` değerlerinin her ikisi de 16'nın katı olmalı, en uzun kenar 3840'ı aşmamalı, en-boy oranı 3:1'i aşmamalı ve toplam piksel sayısı 655.360 ile 8.294.400 arasında olmalıdır. -- `model.mask`, `model.images` içinde tam olarak bir referans görsel gerektirir: görsel olmadan kullanılamaz ve birden fazla görselle kullanılamaz. -- `model.mask` kullanıldığında, boyutları referans görselin boyutlarıyla eşleşmelidir. -- `model.images` sağlandığında, düğüm görsel düzenleme modunda çalışır; `model.images` olmadan, görselleri yalnızca prompt'tan üretir. -- Referans görseller API'ye gönderilmeden önce küçültülür. +- `model.size` "Custom" olduğunda (yalnızca `gpt-image-2.5-flare`, `gpt-image-2.5-sunburst` ve `gpt-image-2`), `model.custom_width` ve `model.custom_height` değerlerinin her ikisi de 16'nın katı olmalı, en uzun kenar 3840'ı aşmamalı, en-boy oranı 3:1'i geçmemeli ve toplam piksel sayısı 655.360 ile 8.294.400 arasında olmalıdır. +- `model.mask`, `model.images` içinde tam olarak bir referans görüntü gerektirir: bir görüntü olmadan kullanılamaz ve birden fazla görüntüyle de kullanılamaz. +- `model.mask` kullanıldığında, maskenin yüksekliği ve genişliği referans görüntünün yüksekliği ve genişliğiyle eşleşmelidir. +- `model.images` sağlandığında düğüm, görüntü düzenleme modunda çalışır; `model.images` olmadan görüntüleri yalnızca istemden üretir. +- Referans görüntüler ve maske, API'ye gönderilmeden önce küçültülür. +- `"xhigh"` ve `"max"` kalite seviyeleri yalnızca `gpt-image-2.5-flare` ve `gpt-image-2.5-sunburst` için kullanılabilir. +- `"transparent"` arka plan seçeneği `gpt-image-2.5-flare`, `gpt-image-2.5-sunburst`, `gpt-image-1.5` ve `gpt-image-1` için kullanılabilir, ancak `gpt-image-2` için kullanılamaz. - `seed` şu anda arka uçta uygulanmamıştır. ## Çıktılar | Çıktı Adı | Açıklama | Veri Türü | | --- | --- | --- | -| `image` | Üretilen görsel veya görseller. Döndürülen tüm görseller tek bir batch halinde istiflenir; boyutları farklıysa, ilk görsele uyacak şekilde yeniden boyutlandırılır. | IMAGE | +| `image` | Üretilen görüntü veya görüntüler. Döndürülen tüm görüntüler tek bir grup (batch) halinde istiflenir; boyutları farklıysa, ilk görüntüyle eşleşecek şekilde yeniden boyutlandırılı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/OpenAIGPTImageNodeV2/tr.md) --- -**Source fingerprint (SHA-256):** `fb3491f949151fbd3f5825ec9f9ae124019767d083f56966ef34af278aef50c0` +**Source fingerprint (SHA-256):** `4f77b79f9f432a1f2e0fd814012aebe7cc42a8aa983ee9a61f3b32984bf65148` diff --git a/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/zh-TW.md b/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/zh-TW.md index 0207f85a2..8f672163b 100644 --- a/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/zh-TW.md +++ b/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/zh-TW.md @@ -1,67 +1,83 @@ # OpenAI GPT 圖像 2 -此節點使用 OpenAI 的 GPT Image API 生成影像。它支援多個模型(`gpt-image-2`、`gpt-image-1.5` 和 `gpt-image-1`),可讓您提供參考影像進行編輯,並可使用遮罩指定要修改影像的哪些部分。 +此節點使用 OpenAI 的 GPT Image API 生成影像。它支援五種模型:`gpt-image-2.5-flare`、`gpt-image-2.5-sunburst`、`gpt-image-2`、`gpt-image-1.5` 與 `gpt-image-1`;可讓您附加參考影像以進行影像編輯,也能使用遮罩指定要替換影像中的哪些部分。 ## 輸入 - ### 通用輸入 -| 參數 | 說明 | 資料類型 | 必要 | 範圍 | +這些輸入參數一律顯示。 + +| 參數 | 描述 | 資料類型 | 必填 | 範圍 | | --- | --- | --- | --- | --- | -| `模型` | 要使用的 OpenAI GPT Image 模型。選擇模型後,會顯示該模型專屬的其他參數。 | DYNAMIC_COMBO | 是 | `"gpt-image-2"`
`"gpt-image-1.5"`
`"gpt-image-1"` | -| `提示詞` | GPT Image 的文字提示(預設值:`""`)。 | STRING | 是 | N/A | -| `數量` | 要生成的影像數量(預設值:`1`)。 | INT | 是 | 1 至 8 | -| `種子` | 用於重現結果的種子(預設值:`0`)。後端尚未實作。 | INT | 是 | 0 至 2147483647 | +| `模型` | 要使用的 OpenAI GPT Image 模型。選取模型後,會顯示該模型專屬的額外參數。 | DYNAMIC_COMBO | 是 | `"gpt-image-2.5-flare"`
`"gpt-image-2.5-sunburst"`
`"gpt-image-2"`
`"gpt-image-1.5"`
`"gpt-image-1"` | +| `提示詞` | GPT Image 的文字提示詞(預設為 `""`)。 | STRING | 是 | N/A | +| `數量` | 要生成的影像數量(預設為 `1`)。 | INT | 是 | 1至8 | +| `種子` | 用於重現結果的種子(預設為 `0`)。目前後端尚未實作此參數。 | INT | 是 | 0至2147483647 | + +### gpt-image-2.5-flare 與 gpt-image-2.5-sunburst 輸入 + +這些輸入參數會在 `model` 設為 `gpt-image-2.5-flare` 或 `gpt-image-2.5-sunburst` 時顯示。這兩個模型共用同一組參數。 + +| 參數 | 描述 | 資料類型 | 必填 | 範圍 | +| --- | --- | --- | --- | --- | +| `尺寸` | 影像尺寸。選取 "Custom" 即可使用自訂寬度與高度(預設為 `"auto"`)。 | COMBO | 是 | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | +| `自訂寬度` | 僅在 `model.size` 為 "Custom" 時使用。必須是 16 的倍數(預設為 `1024`)。 | INT | 否 | 480至3840 (步進值 16) | +| `自訂高度` | 僅在 `model.size` 為 "Custom" 時使用。必須是 16 的倍數(預設為 `1024`)。 | INT | 否 | 480至3840 (步進值 16) | +| `背景` | 傳回含背景或不含背景的影像(預設為 `"auto"`)。 | COMBO | 是 | `"auto"`
`"opaque"`
`"transparent"` | +| `品質` | 影像品質,會影響成本與生成時間(預設為 `"low"`)。 | COMBO | 是 | `"low"`
`"medium"`
`"high"`
`"xhigh"`
`"max"` | +| `model.images` | 用於影像編輯的選用參考影像。最多可達 16 張影像。詳細說明請參閱「參考輸入」。 | IMAGE | 否 | 0至16 | +| `model.mask` | 用於局部重繪(inpainting)的選用遮罩(白色區域會被替換)。必須恰好有一張參考影像。 | MASK | 否 | N/A | ### gpt-image-2 輸入 -當 `model` 設定為 `gpt-image-2` 時,會顯示這些輸入。 +這些輸入參數會在 `model` 設為 `gpt-image-2` 時顯示。 -| 參數 | 說明 | 資料類型 | 必要 | 範圍 | +| 參數 | 描述 | 資料類型 | 必填 | 範圍 | | --- | --- | --- | --- | --- | -| `尺寸` | 影像尺寸。選擇「Custom」以使用自訂寬度與高度(預設值:`"auto"`)。 | COMBO | 是 | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | -| `自訂寬度` | 僅在 `model.size` 為「Custom」時使用。必須是 16 的倍數(預設值:`1024`)。 | INT | 否 | 1024 至 3840 | -| `自訂高度` | 僅在 `model.size` 為「Custom」時使用。必須是 16 的倍數(預設值:`1024`)。 | INT | 否 | 1024 至 3840 | -| `背景` | 傳回帶有或不帶背景的影像(預設值:`"auto"`)。 | COMBO | 是 | `"auto"`
`"opaque"` | -| `品質` | 影像品質,會影響成本與生成時間(預設值:`"low"`)。 | COMBO | 是 | `"low"`
`"medium"`
`"high"` | -| `model.images` | 可選的參考影像,用於影像編輯。最多 16 張影像。詳細資訊請參閱「參考輸入」。 | IMAGE | 否 | 0 至 16 | -| `model.mask` | 用於修補的可選遮罩(白色區域將被替換)。需要正好一張參考影像。 | MASK | 否 | N/A | +| `尺寸` | 影像尺寸。選取 "Custom" 即可使用自訂寬度與高度(預設為 `"auto"`)。 | COMBO | 是 | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | +| `自訂寬度` | 僅在 `model.size` 為 "Custom" 時使用。必須是 16 的倍數(預設為 `1024`)。 | INT | 否 | 480至3840 (步進值 16) | +| `自訂高度` | 僅在 `model.size` 為 "Custom" 時使用。必須是 16 的倍數(預設為 `1024`)。 | INT | 否 | 480至3840 (步進值 16) | +| `背景` | 傳回含背景或不含背景的影像(預設為 `"auto"`)。 | COMBO | 是 | `"auto"`
`"opaque"` | +| `品質` | 影像品質,會影響成本與生成時間(預設為 `"low"`)。 | COMBO | 是 | `"low"`
`"medium"`
`"high"` | +| `model.images` | 用於影像編輯的選用參考影像。最多可達 16 張影像。詳細說明請參閱「參考輸入」。 | IMAGE | 否 | 0至16 | +| `model.mask` | 用於局部重繪(inpainting)的選用遮罩(白色區域會被替換)。必須恰好有一張參考影像。 | MASK | 否 | N/A | ### gpt-image-1.5 與 gpt-image-1 輸入 -當 `model` 設定為 `gpt-image-1.5` 或 `gpt-image-1` 時,會顯示這些輸入。兩個模型共用相同的參數集。 +這些輸入參數會在 `model` 設為 `gpt-image-1.5` 或 `gpt-image-1` 時顯示。這兩個模型共用同一組參數。 -| 參數 | 說明 | 資料類型 | 必要 | 範圍 | +| 參數 | 描述 | 資料類型 | 必填 | 範圍 | | --- | --- | --- | --- | --- | -| `尺寸` | 影像尺寸(預設值:`"auto"`)。 | COMBO | 是 | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"` | -| `背景` | 傳回帶有或不帶背景的影像(預設值:`"auto"`)。 | COMBO | 是 | `"auto"`
`"opaque"`
`"transparent"` | -| `品質` | 影像品質,會影響成本與生成時間(預設值:`"low"`)。 | COMBO | 是 | `"low"`
`"medium"`
`"high"` | -| `model.images` | 可選的參考影像,用於影像編輯。最多 16 張影像。詳細資訊請參閱「參考輸入」。 | IMAGE | 否 | 0 至 16 | -| `model.mask` | 用於修補的可選遮罩(白色區域將被替換)。需要正好一張參考影像。 | MASK | 否 | N/A | +| `尺寸` | 影像尺寸(預設為 `"auto"`)。 | COMBO | 是 | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"` | +| `背景` | 傳回含背景或不含背景的影像(預設為 `"auto"`)。 | COMBO | 是 | `"auto"`
`"opaque"`
`"transparent"` | +| `品質` | 影像品質,會影響成本與生成時間(預設為 `"low"`)。 | COMBO | 是 | `"low"`
`"medium"`
`"high"` | +| `model.images` | 用於影像編輯的選用參考影像。最多可達 16 張影像。詳細說明請參閱「參考輸入」。 | IMAGE | 否 | 0至16 | +| `model.mask` | 用於局部重繪(inpainting)的選用遮罩(白色區域會被替換)。必須恰好有一張參考影像。 | MASK | 否 | N/A | ### 參考輸入 -| 參數 | 說明 | 資料類型 | 必要 | 範圍 | +| 參數 | 描述 | 資料類型 | 必填 | 範圍 | | --- | --- | --- | --- | --- | -| `model.images` | 可擴充插槽:可連接 1..N 個項目(例如 `image_1`...`image_16`);所有模型最多可有 16 張參考影像。 | IMAGE | 否 | 1 至 16 | -| `model.mask` | 用於修補的可選遮罩(白色區域將被替換)。需要正好一張參考影像。 | MASK | 否 | N/A | +| `model.images` | 可擴充插槽:可連接 1..N 個項目(例如 `image_1`...`image_16`);所有模型最多可接受 16 張參考影像。 | IMAGE | 否 | 1至16 | +| `model.mask` | 用於局部重繪(inpainting)的選用遮罩(白色區域會被替換)。必須恰好有一張參考影像。 | MASK | 否 | N/A | **參數限制與注意事項:** -- 當 `model.size` 為「Custom」時(僅限 gpt-image-2),`model.custom_width` 和 `model.custom_height` 都必須是 16 的倍數,最長邊不得超過 3840,長寬比不得超過 3:1,且總像素數必須介於 655,360 到 8,294,400 之間。 -- `model.mask` 需要在 `model.images` 中有正好一張參考影像:沒有影像時無法使用,多於一張影像時也無法使用。 -- 使用 `model.mask` 時,其尺寸必須與參考影像的尺寸相符。 -- 當提供 `model.images` 時,節點會以影像編輯模式執行;若未提供 `model.images`,則僅根據提示生成影像。 -- 參考影像在傳送至 API 前會先縮小。 -- `seed` 目前尚未在後端實作。 +- 當 `model.size` 為 "Custom" 時(僅限 `gpt-image-2.5-flare`、`gpt-image-2.5-sunburst` 與 `gpt-image-2`),`model.custom_width` 與 `model.custom_height` 都必須是 16 的倍數,最長邊不得超過 3840,長寬比不得超過 3:1,且總像素數必須介於 655,360 與 8,294,400 之間。 +- 使用 `model.mask` 時,`model.images` 中必須恰好有一張參考影像:沒有參考影像時無法使用,超過一張時也無法使用。 +- 使用 `model.mask` 時,其高度與寬度必須符合參考影像的高度與寬度。 +- 提供 `model.images` 時,此節點會以影像編輯模式運作;未提供 `model.images` 時,節點僅根據提示詞生成影像。 +- 參考影像與遮罩在傳送至 API 前會先縮小。 +- `"xhigh"` 與 `"max"` 品質等級僅適用於 `gpt-image-2.5-flare` 與 `gpt-image-2.5-sunburst`。 +- `"transparent"` 背景選項可用於 `gpt-image-2.5-flare`、`gpt-image-2.5-sunburst`、`gpt-image-1.5` 與 `gpt-image-1`,但不適用於 `gpt-image-2`。 +- `seed` 目前尚未於後端實作。 ## 輸出 - -| 輸出名稱 | 說明 | 資料類型 | +| 輸出名 | 描述 | 資料類型 | | --- | --- | --- | -| `image` | 生成的影像。所有傳回的影像會堆疊成一個批次;如果尺寸不同,會調整大小以符合第一張影像。 | IMAGE | +| `image` | 生成的單張或多張影像。所有回傳的影像會堆疊成單一批次;若尺寸不同,則會調整大小以符合第一張影像。 | IMAGE | > 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/zh-TW.md) --- -**Source fingerprint (SHA-256):** `fb3491f949151fbd3f5825ec9f9ae124019767d083f56966ef34af278aef50c0` +**Source fingerprint (SHA-256):** `4f77b79f9f432a1f2e0fd814012aebe7cc42a8aa983ee9a61f3b32984bf65148` diff --git a/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/zh.md b/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/zh.md index 535d8c40d..94d37fd1b 100644 --- a/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/zh.md +++ b/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/zh.md @@ -1,65 +1,85 @@ # OpenAI GPT 图像 2 -此节点使用 OpenAI 的 GPT Image API 生成图像。它支持多个模型(`gpt-image-2`、`gpt-image-1.5` 和 `gpt-image-1`),允许您提供参考图像进行编辑,并可利用遮罩指定要修改的图像区域。 +此节点使用 OpenAI 的 GPT Image API 生成图像。它支持五种模型 — `gpt-image-2.5-flare`、`gpt-image-2.5-sunburst`、`gpt-image-2`、`gpt-image-1.5` 和 `gpt-image-1` — 允许附加参考图像进行图像编辑,并可使用蒙版指定图像中需要替换的部分。 ## 输入 + ### 通用输入 +这些输入始终可见。 + +| 参数 | 描述 | 数据类型 | 必填 | 范围 | +| --- | --- | --- | --- | --- | +| `模型` | 要使用的 OpenAI GPT Image 模型。选择模型后会显示该模型特有的其他参数。 | DYNAMIC_COMBO | 是 | `"gpt-image-2.5-flare"`
`"gpt-image-2.5-sunburst"`
`"gpt-image-2"`
`"gpt-image-1.5"`
`"gpt-image-1"` | +| `提示词` | GPT Image 的文本提示词(默认值:`""`)。 | STRING | 是 | N/A | +| `数量` | 要生成的图像数量(默认值:`1`)。 | INT | 是 | 1到8 | +| `种子` | 用于结果可复现的随机种子(默认值:`0`)。后端尚未实现此参数。 | INT | 是 | 0到2147483647 | + +### gpt-image-2.5-flare 和 gpt-image-2.5-sunburst 输入 + +当 `model` 设置为 `gpt-image-2.5-flare` 或 `gpt-image-2.5-sunburst` 时显示这些输入。两个模型共享同一组参数。 + | 参数 | 描述 | 数据类型 | 必填 | 范围 | | --- | --- | --- | --- | --- | -| `模型` | 要使用的 OpenAI GPT Image 模型。选择模型后会显示该模型特有的附加参数。 | DYNAMIC_COMBO | 是 | `"gpt-image-2"`
`"gpt-image-1.5"`
`"gpt-image-1"` | -| `提示词` | GPT Image 的文本提示(默认:`""`)。 | STRING | 是 | N/A | -| `数量` | 生成图像的数量(默认:`1`)。 | INT | 是 | 1 到 8 | -| `种子` | 用于结果可复现的种子(默认:`0`)。后端暂未实现。 | INT | 是 | 0 到 2147483647 | +| `尺寸` | 图像尺寸。选择“Custom”可使用自定义宽度和高度(默认值:`"auto"`)。 | COMBO | 是 | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | +| `自定义宽度` | 仅当 `model.size` 为“Custom”时使用。必须是 16 的倍数(默认值:`1024`)。 | INT | 否 | 480到3840(步长 16) | +| `自定义高度` | 仅当 `model.size` 为“Custom”时使用。必须是 16 的倍数(默认值:`1024`)。 | INT | 否 | 480到3840(步长 16) | +| `背景` | 返回带或不带背景的图像(默认值:`"auto"`)。 | COMBO | 是 | `"auto"`
`"opaque"`
`"transparent"` | +| `质量` | 图像质量,影响成本和生成时间(默认值:`"low"`)。 | COMBO | 是 | `"low"`
`"medium"`
`"high"`
`"xhigh"`
`"max"` | +| `model.images` | 用于图像编辑的可选参考图像。最多 16 张。详见“参考输入”。 | IMAGE | 否 | 0到16 | +| `model.mask` | 用于局部重绘的可选蒙版(白色区域将被替换)。必须恰好有一张参考图像。 | MASK | 否 | N/A | ### gpt-image-2 输入 -当 `model` 设置为 `gpt-image-2` 时,将显示这些输入。 +当 `model` 设置为 `gpt-image-2` 时显示这些输入。 | 参数 | 描述 | 数据类型 | 必填 | 范围 | | --- | --- | --- | --- | --- | -| `尺寸` | 图像尺寸。选择 "Custom" 以使用自定义宽度和高度(默认:`"auto"`)。 | COMBO | 是 | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | -| `自定义宽度` | 仅在 `model.size` 为 "Custom" 时使用。必须是 16 的倍数(默认:`1024`)。 | INT | 否 | 1024 到 3840 | -| `自定义高度` | 仅在 `model.size` 为 "Custom" 时使用。必须是 16 的倍数(默认:`1024`)。 | INT | 否 | 1024 到 3840 | -| `背景` | 返回带有或不带背景的图像(默认:`"auto"`)。 | COMBO | 是 | `"auto"`
`"opaque"` | -| `质量` | 图像质量,影响成本和生成时间(默认:`"low"`)。 | COMBO | 是 | `"low"`
`"medium"`
`"high"` | -| `model.images` | 用于图像编辑的可选参考图像。最多 16 张。有关详细信息,请参阅参考输入。 | IMAGE | 否 | 0 到 16 | -| `model.mask` | 用于局部重绘的可选遮罩(白色区域将被替换)。需要恰好一张参考图像。 | MASK | 否 | N/A | +| `尺寸` | 图像尺寸。选择“Custom”可使用自定义宽度和高度(默认值:`"auto"`)。 | COMBO | 是 | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"`
`"2048x2048"`
`"2048x1152"`
`"1152x2048"`
`"3840x2160"`
`"2160x3840"`
`"Custom"` | +| `自定义宽度` | 仅当 `model.size` 为“Custom”时使用。必须是 16 的倍数(默认值:`1024`)。 | INT | 否 | 480到3840(步长 16) | +| `自定义高度` | 仅当 `model.size` 为“Custom”时使用。必须是 16 的倍数(默认值:`1024`)。 | INT | 否 | 480到3840(步长 16) | +| `背景` | 返回带或不带背景的图像(默认值:`"auto"`)。 | COMBO | 是 | `"auto"`
`"opaque"` | +| `质量` | 图像质量,影响成本和生成时间(默认值:`"low"`)。 | COMBO | 是 | `"low"`
`"medium"`
`"high"` | +| `model.images` | 用于图像编辑的可选参考图像。最多 16 张。详见“参考输入”。 | IMAGE | 否 | 0到16 | +| `model.mask` | 用于局部重绘的可选蒙版(白色区域将被替换)。必须恰好有一张参考图像。 | MASK | 否 | N/A | ### gpt-image-1.5 和 gpt-image-1 输入 -当 `model` 设置为 `gpt-image-1.5` 或 `gpt-image-1` 时,将显示这些输入。两个模型共用同一组参数。 +当 `model` 设置为 `gpt-image-1.5` 或 `gpt-image-1` 时显示这些输入。两个模型共享同一组参数。 | 参数 | 描述 | 数据类型 | 必填 | 范围 | | --- | --- | --- | --- | --- | -| `尺寸` | 图像尺寸(默认:`"auto"`)。 | COMBO | 是 | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"` | -| `背景` | 返回带有或不带背景的图像(默认:`"auto"`)。 | COMBO | 是 | `"auto"`
`"opaque"`
`"transparent"` | -| `质量` | 图像质量,影响成本和生成时间(默认:`"low"`)。 | COMBO | 是 | `"low"`
`"medium"`
`"high"` | -| `model.images` | 用于图像编辑的可选参考图像。最多 16 张。有关详细信息,请参阅参考输入。 | IMAGE | 否 | 0 到 16 | -| `model.mask` | 用于局部重绘的可选遮罩(白色区域将被替换)。需要恰好一张参考图像。 | MASK | 否 | N/A | +| `尺寸` | 图像尺寸(默认值:`"auto"`)。 | COMBO | 是 | `"auto"`
`"1024x1024"`
`"1024x1536"`
`"1536x1024"` | +| `背景` | 返回带或不带背景的图像(默认值:`"auto"`)。 | COMBO | 是 | `"auto"`
`"opaque"`
`"transparent"` | +| `质量` | 图像质量,影响成本和生成时间(默认值:`"low"`)。 | COMBO | 是 | `"low"`
`"medium"`
`"high"` | +| `model.images` | 用于图像编辑的可选参考图像。最多 16 张。详见“参考输入”。 | IMAGE | 否 | 0到16 | +| `model.mask` | 用于局部重绘的可选蒙版(白色区域将被替换)。必须恰好有一张参考图像。 | MASK | 否 | N/A | ### 参考输入 | 参数 | 描述 | 数据类型 | 必填 | 范围 | | --- | --- | --- | --- | --- | -| `model.images` | 可扩展插槽:可连接 1..N 个项目(例如 `image_1`...`image_16`);所有模型最多支持 16 张参考图像。 | IMAGE | 否 | 1 到 16 | -| `model.mask` | 用于局部重绘的可选遮罩(白色区域将被替换)。需要恰好一张参考图像。 | MASK | 否 | N/A | +| `model.images` | 可扩展插槽:连接 1..N 个项目(例如 `image_1`...`image_16`);所有模型最多支持 16 张参考图像。 | IMAGE | 否 | 1到16 | +| `model.mask` | 用于局部重绘的可选蒙版(白色区域将被替换)。必须恰好有一张参考图像。 | MASK | 否 | N/A | **参数约束与限制:** -- 当 `model.size` 为 "Custom"(仅限 gpt-image-2)时,`model.custom_width` 和 `model.custom_height` 必须都是 16 的倍数,最长边不得超过 3840,宽高比不得超过 3:1,总像素数必须介于 655,360 和 8,294,400 之间。 -- `model.mask` 需要恰好在 `model.images` 中提供一张参考图像:不能没有图像,也不能用于多张图像。 -- 使用 `model.mask` 时,其尺寸必须与参考图像的尺寸一致。 -- 当提供 `model.images` 时,节点运行在图像编辑模式;未提供 `model.images` 时,仅根据提示词生成图像。 -- 参考图像在发送到 API 之前会被缩小。 -- `seed` 目前尚未在后端实现。 +- 当 `model.size` 为“Custom”时(仅限 `gpt-image-2.5-flare`、`gpt-image-2.5-sunburst` 和 `gpt-image-2`),`model.custom_width` 和 `model.custom_height` 都必须为 16 的倍数,最长边不得超过 3840,宽高比不得超过 3:1,总像素数必须在 655,360到8,294,400 之间。 +- `model.mask` 要求在 `model.images` 中恰好有一张参考图像:没有图像时不能使用,有多个图像时也不能使用。 +- 使用 `model.mask` 时,其高度和宽度必须与参考图像的高度和宽度一致。 +- 提供 `model.images` 时,节点会以图像编辑模式运行;未提供 `model.images` 时,仅根据提示词生成图像。 +- 参考图像和蒙版在发送到 API 之前会被缩小。 +- `"xhigh"` 和 `"max"` 质量等级仅适用于 `gpt-image-2.5-flare` 和 `gpt-image-2.5-sunburst`。 +- `"transparent"` 背景选项可用于 `gpt-image-2.5-flare`、`gpt-image-2.5-sunburst`、`gpt-image-1.5` 和 `gpt-image-1`,但不适用于 `gpt-image-2`。 +- `seed` 当前尚未在后端实现。 ## 输出 + | 输出名称 | 描述 | 数据类型 | | --- | --- | --- | -| `image` | 生成的图像。所有返回图像会被堆叠为一个批次;如果尺寸不同,则会调整为与第一张图像一致。 | IMAGE | +| `image` | 生成的图像。所有返回的图像会被堆叠为一个批次;如果尺寸不同,则会调整大小以匹配第一张图像。 | IMAGE | > 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/zh.md) --- -**Source fingerprint (SHA-256):** `fb3491f949151fbd3f5825ec9f9ae124019767d083f56966ef34af278aef50c0` +**Source fingerprint (SHA-256):** `4f77b79f9f432a1f2e0fd814012aebe7cc42a8aa983ee9a61f3b32984bf65148` diff --git a/comfyui_embedded_docs/docs/Pixal3DConditioning/ar.md b/comfyui_embedded_docs/docs/Pixal3DConditioning/ar.md index df2cd1e7c..4cf0e97d7 100644 --- a/comfyui_embedded_docs/docs/Pixal3DConditioning/ar.md +++ b/comfyui_embedded_docs/docs/Pixal3DConditioning/ar.md @@ -1,25 +1,25 @@ # Pixal3DConditioning -تقوم هذه العقدة بإعداد تكييف الصورة لخط أنابيب توليد Trellis2 ثلاثي الأبعاد. تستخرج الميزات البصرية من صورة الإدخال باستخدام نموذج الرؤية DINOv3 عند دقتين، وتنظمها في خرائط ميزات لكل مرحلة (معززة اختياريًا بنموذج NAF)، وتدمجها مع بيانات الكاميرا المستمدة من مجال الرؤية الأفقي. وتُخرج زوجًا من التكييف الإيجابي والسلبي، حيث يستخدم السلبي ميزات مصفّرة للتوجيه الخالي من المصنف. +تُعدّ هذه العقدة تهيئة الصورة لخط أنابيب التوليد ثلاثي الأبعاد Trellis2. تستخرج الميزات البصرية من صورة الإدخال باستخدام نموذج الرؤية DINOv3 عند درجتي دقة، وتنظّمها في خرائط ميزات لكل مرحلة (معززة اختياريًا بنموذج NAF)، وتدمجها مع بيانات الكاميرا المستمدة من مجال الرؤية الأفقي. تُخرج زوج تهيئة موجبًا وسالبًا، حيث يستخدم السالب ميزات مُصفّرة للتوجيه الخالي من المصنّف. ## المدخلات | المعامل | الوصف | نوع البيانات | مطلوب | النطاق | -|-----------|-------------|-----------|----------|-------| -| `clip_vision_model` | نموذج رؤية DINOv3 ViT-L/16 من نوع ClipVision. | CLIP_VISION | نعم | — | -| `الصورة` | صورة معالجة مسبقًا من عقدة ImageCropToMask (pad_factor=1.1 لـ Pixal3D). | IMAGE | نعم | — | -| `camera_angle_x` | مجال الرؤية الأفقي بالدرجات (الاسم المعروض: fov). وصّل عقدة MoGeGeometryToFOV (axis='horizontal', unit='degrees') للحصول على مجال رؤية لكل صورة (يطابق القيمة الافتراضية للمشروع الأصلي). القيمة الافتراضية: 49.13. | FLOAT | نعم | 1.0 – 170.0 | +|-----------|-------------|-----------|----------|---------| +| `clip_vision_model` | DINOv3 ViT-L/16 ClipVision. | CLIP_VISION | نعم | — | +| `الصورة` | صورة معالجة مسبقًا من ImageCropToMask (pad_factor=1.1 لـ Pixal3D). | IMAGE | نعم | — | +| `camera_angle_x` | مجال الرؤية الأفقي بالدرجات (اسم العرض: fov). صِل عقدة MoGeGeometryToFOV (axis='horizontal', unit='degrees') للحصول على مجال رؤية لكل صورة (يطابق الإعداد الافتراضي في المنبع). القيمة الافتراضية: 49.13. | FLOAT | نعم | 1.0 – 170.0 | -ملاحظة: يتم تحويل قيمة `camera_angle_x` إلى راديان داخليًا وتُستخدم لحساب مسافة الكاميرا لمصفوفة تحويل الإسقاط. عندما يتضمن نموذج الرؤية المزوَّد مكوّن NAF، تنتج العقدة أيضًا خرائط ميزات عالية الدقة لمرحلتي الشكل والملمس. +ملاحظة: تُحوَّل قيمة `camera_angle_x` داخليًا إلى راديان وتُستخدم لحساب مسافة الكاميرا لمصفوفة تحويل الإسقاط. عندما يحتوي نموذج الرؤية المُقدَّم على مكوّن NAF، تُنتج العقدة أيضًا خرائط ميزات عالية الدقة لمرحلتَي الشكل والملمس. ## المخرجات -| اسم المخرج | الوصف | نوع البيانات | +| اسم المخرَج | الوصف | نوع البيانات | |-------------|-------------|-----------| -| `إيجابي` | تكييف إيجابي يحتوي على خرائط الميزات المستمدة من الصورة وبيانات الإسقاط لتوليد Trellis2. | CONDITIONING | -| `سلبي` | تكييف سلبي بمصفوفات ميزات مصفّرة، يُستخدم للتوجيه الخالي من المصنف. | CONDITIONING | +| `إيجابي` | تهيئة موجبة تحتوي على خرائط الميزات المستمدة من الصورة وبيانات الإسقاط لتوليد Trellis2. | CONDITIONING | +| `سلبي` | تهيئة سالبة بموترات ميزات مُصفّرة، تُستخدم للتوجيه الخالي من المصنّف. | CONDITIONING | > تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Pixal3DConditioning/ar.md) --- -**Source fingerprint (SHA-256):** `3eba711620f6c56a21bbf7df89f8d406ce6f90908298b1a295a1dbbddd042472` +**Source fingerprint (SHA-256):** `88e82b48fbe297c8e32ddd1b6659f196bda6f77fd53480bc021e85170d1923c7` diff --git a/comfyui_embedded_docs/docs/Pixal3DConditioning/en.md b/comfyui_embedded_docs/docs/Pixal3DConditioning/en.md index 3ee6d1243..cef4449f6 100644 --- a/comfyui_embedded_docs/docs/Pixal3DConditioning/en.md +++ b/comfyui_embedded_docs/docs/Pixal3DConditioning/en.md @@ -1,25 +1,27 @@ # Pixal3DConditioning -This node prepares image conditioning for the Trellis2 3D generation pipeline. It extracts visual features from the input image with a DINOv3 vision model at two resolutions, organizes them into per-stage feature maps (optionally enhanced with a NAF model), and combines them with camera data derived from the horizontal field of view. It outputs a positive and a negative conditioning pair, where the negative uses zeroed features for classifier-free guidance. +## Overview + +The Pixal3DConditioning node is designed to prepare image conditioning for the Trellis2 3D generation pipeline. It utilizes a DINOv3 vision model to extract visual features from the input image at two resolutions. These features are then organized into per-stage feature maps, which can be optionally enhanced with a NAF model. The node also incorporates camera data derived from the horizontal field of view to compute the projection transform matrix. It outputs a positive conditioning pair that includes the image-derived feature maps and projection data, as well as a negative conditioning pair with zeroed feature tensors for classifier-free guidance. ## Inputs | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| -| `clip_vision_model` | DINOv3 ViT-L/16 ClipVision. | CLIP_VISION | Yes | — | -| `image` | Preprocessed image from ImageCropToMask (pad_factor=1.1 for Pixal3D). | IMAGE | Yes | — | -| `camera_angle_x` | Horizontal FOV in degrees (display name: fov). Wire a MoGeGeometryToFOV (axis='horizontal', unit='degrees') for a per-image FoV (matches upstream default). Default: 49.13. | FLOAT | Yes | 1.0 – 170.0 | - -Note: The `camera_angle_x` value is converted to radians internally and used to compute the camera distance for the projection transform matrix. When the supplied vision model includes a NAF component, the node additionally produces high-resolution feature maps for the shape and texture stages. +| `clip_vision_model` | The DINOv3 ViT-L/16 ClipVision model used for feature extraction. | CLIP_VISION | Yes | — | +| `image` | The preprocessed image from the ImageCropToMask node, intended for Pixal3D with a pad_factor of 1.1. | IMAGE | Yes | — | +| `camera_angle_x` | The horizontal field of view in degrees. This parameter can be wired to a MoGeGeometryToFOV node for a per-image field of view. Default: 49.13. | FLOAT | Yes | 1.0 – 170.0 | ## Outputs | Output Name | Description | Data Type | |-------------|-------------|-----------| -| `positive` | Positive conditioning containing the image-derived feature maps and projection data for Trellis2 generation. | CONDITIONING | -| `negative` | Negative conditioning with zeroed feature tensors, used for classifier-free guidance. | CONDITIONING | +| `positive` | The positive conditioning output containing the image-derived feature maps and projection data for Trellis2 generation. | CONDITIONING | +| `negative` | The negative conditioning output with zeroed feature tensors, used for classifier-free guidance. | CONDITIONING | + +Note: The `camera_angle_x` value is converted to radians internally and used to compute the camera distance for the projection transform matrix. When the supplied vision model includes a NAF component, the node also produces high-resolution feature maps for the shape and texture stages. > 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/Pixal3DConditioning/en.md) --- -**Source fingerprint (SHA-256):** `3eba711620f6c56a21bbf7df89f8d406ce6f90908298b1a295a1dbbddd042472` +**Source fingerprint (SHA-256):** `88e82b48fbe297c8e32ddd1b6659f196bda6f77fd53480bc021e85170d1923c7` diff --git a/comfyui_embedded_docs/docs/Pixal3DConditioning/es.md b/comfyui_embedded_docs/docs/Pixal3DConditioning/es.md index d5dd831bb..0428e1aca 100644 --- a/comfyui_embedded_docs/docs/Pixal3DConditioning/es.md +++ b/comfyui_embedded_docs/docs/Pixal3DConditioning/es.md @@ -1,6 +1,6 @@ # Pixal3DConditioning -Este nodo prepara el condicionamiento de imagen para el pipeline de generación 3D Trellis2. Extrae características visuales de la imagen de entrada con un modelo de visión DINOv3 a dos resoluciones, las organiza en mapas de características por etapa (opcionalmente mejorados con un modelo NAF) y las combina con datos de cámara derivados del campo de visión horizontal. Produce un par de condicionamiento positivo y negativo, donde el negativo utiliza características a cero para la guía sin clasificador. +Este nodo prepara el acondicionamiento de imagen para el proceso de generación 3D de Trellis2. Extrae características visuales de la imagen de entrada con un modelo de visión DINOv3 en dos resoluciones, las organiza en mapas de características por etapa (opcionalmente mejorados con un modelo NAF) y las combina con los datos de cámara derivados del campo de visión horizontal. Genera un par de acondicionamientos positivo y negativo, donde el negativo utiliza características puestas a cero para la guía sin clasificador. ## Entradas @@ -8,18 +8,18 @@ Este nodo prepara el condicionamiento de imagen para el pipeline de generación |-----------|-------------|---------------|-------------|-------| | `clip_vision_model` | DINOv3 ViT-L/16 ClipVision. | CLIP_VISION | Sí | — | | `imagen` | Imagen preprocesada de ImageCropToMask (pad_factor=1.1 para Pixal3D). | IMAGE | Sí | — | -| `camera_angle_x` | FOV horizontal en grados (nombre para mostrar: fov). Conecta un MoGeGeometryToFOV (axis='horizontal', unit='degrees') para un FoV por imagen (coincide con el valor predeterminado de upstream). Predeterminado: 49.13. | FLOAT | Sí | 1.0 – 170.0 | +| `camera_angle_x` | Campo de visión horizontal en grados (nombre visible: fov). Conecta un MoGeGeometryToFOV (axis='horizontal', unit='degrees') para obtener un FoV por imagen (coincide con el valor predeterminado del nodo anterior). Valor predeterminado: 49.13. | FLOAT | Sí | 1.0 – 170.0 | -Nota: El valor de `camera_angle_x` se convierte a radianes internamente y se utiliza para calcular la distancia de cámara para la matriz de transformación de proyección. Cuando el modelo de visión proporcionado incluye un componente NAF, el nodo produce además mapas de características de alta resolución para las etapas de forma y textura. +Nota: El valor de `camera_angle_x` se convierte internamente a radianes y se utiliza para calcular la distancia de la cámara para la matriz de transformación de proyección. Cuando el modelo de visión suministrado incluye un componente NAF, el nodo produce además mapas de características de alta resolución para las etapas de forma y textura. ## Salidas | Nombre de salida | Descripción | Tipo de datos | |------------------|-------------|---------------| -| `positivo` | Condicionamiento positivo que contiene los mapas de características derivados de la imagen y los datos de proyección para la generación Trellis2. | CONDITIONING | -| `negativo` | Condicionamiento negativo con tensores de características a cero, utilizado para la guía sin clasificador. | CONDITIONING | +| `positivo` | Acondicionamiento positivo que contiene los mapas de características derivados de la imagen y los datos de proyección para la generación de Trellis2. | CONDITIONING | +| `negativo` | Acondicionamiento negativo con tensores de características puestos a cero, utilizado para la guía sin clasificador. | CONDITIONING | > 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/Pixal3DConditioning/es.md) --- -**Source fingerprint (SHA-256):** `3eba711620f6c56a21bbf7df89f8d406ce6f90908298b1a295a1dbbddd042472` +**Source fingerprint (SHA-256):** `88e82b48fbe297c8e32ddd1b6659f196bda6f77fd53480bc021e85170d1923c7` diff --git a/comfyui_embedded_docs/docs/Pixal3DConditioning/fa.md b/comfyui_embedded_docs/docs/Pixal3DConditioning/fa.md index 99dbdc38a..de959aec4 100644 --- a/comfyui_embedded_docs/docs/Pixal3DConditioning/fa.md +++ b/comfyui_embedded_docs/docs/Pixal3DConditioning/fa.md @@ -1,25 +1,25 @@ # Pixal3DConditioning -این گره شرط‌گذاری تصویر را برای خط لوله تولید سه‌بعدی Trellis2 آماده می‌کند. ویژگی‌های بصری را از تصویر ورودی با یک مدل بینایی DINOv3 در دو وضوح استخراج می‌کند، آن‌ها را در قالب نقشه‌های ویژگی مرحله‌ای سازماندهی می‌کند (در صورت اختیار با یک مدل NAF تقویت شده) و آن‌ها را با داده‌های دوربین حاصل از میدان دید افقی ترکیب می‌کند. خروجی این گره یک جفت شرط مثبت و منفی است که در شرط منفی از ویژگی‌های صفرشده برای راهنمایی بدون طبقه‌بند استفاده می‌شود. +این گره شرطی‌سازی تصویر را برای خط لوله تولید سه‌بعدی Trellis2 آماده می‌کند. با یک مدل بینایی DINOv3 در دو وضوح، ویژگی‌های بصری را از تصویر ورودی استخراج می‌کند، آن‌ها را در نقشه‌های ویژگی هر مرحله سازمان‌دهی می‌کند (به‌صورت اختیاری با مدل NAF تقویت می‌شوند)، و آن‌ها را با داده‌های دوربین که از میدان دید افقی به دست آمده ترکیب می‌کند. خروجی آن یک جفت شرطی‌سازی مثبت و منفی است، که در نسخه منفی از ویژگی‌های صفرشده برای هدایت بدون طبقه‌بند (classifier-free guidance) استفاده می‌شود. ## ورودی‌ها -| پارامتر | توضیحات | نوع داده | الزامی | بازه | +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | |-----------|-------------|-----------|----------|-------| | `clip_vision_model` | DINOv3 ViT-L/16 ClipVision. | CLIP_VISION | بله | — | -| `تصویر` | تصویر پیش‌پردازش‌شده از ImageCropToMask (با pad_factor=1.1 برای Pixal3D). | IMAGE | بله | — | -| `camera_angle_x` | میدان دید افقی بر حسب درجه (نام نمایشی: fov). برای میدان دید هر تصویر، یک گره MoGeGeometryToFOV (با axis='horizontal', unit='degrees') را وصل کنید (مطابق با پیش‌فرض بالادست). پیش‌فرض: 49.13. | FLOAT | بله | 1.0 – 170.0 | +| `تصویر` | تصویر پیش‌پردازش‌شده از ImageCropToMask (pad_factor=1.1 برای Pixal3D). | IMAGE | بله | — | +| `camera_angle_x` | میدان دید افقی بر حسب درجه (نام نمایشی: fov). برای FoV هر تصویر، یک MoGeGeometryToFOV (axis='horizontal', unit='degrees') وصل کنید (با پیش‌فرض بالادست مطابقت دارد). پیش‌فرض: 49.13. | FLOAT | بله | 1.0 – 170.0 | -توجه: مقدار `camera_angle_x` در داخل گره به رادیان تبدیل می‌شود و برای محاسبه فاصله دوربین در ماتریس تبدیل فرافکنی استفاده می‌گردد. وقتی مدل بینایی ارائه‌شده شامل یک مؤلفه NAF باشد، این گره علاوه بر این، نقشه‌های ویژگی با وضوح بالا را برای مراحل شکل و بافت تولید می‌کند. +نکته: مقدار `camera_angle_x` به‌صورت داخلی به رادیان تبدیل می‌شود و برای محاسبه فاصله دوربین جهت ماتریس تبدیل پروجکشن استفاده می‌شود. هنگامی که مدل بینایی ارائه‌شده شامل مؤلفه NAF باشد، گره علاوه بر آن نقشه‌های ویژگی با وضوح بالا را برای مراحل شکل و بافت تولید می‌کند. ## خروجی‌ها | نام خروجی | توضیحات | نوع داده | |-------------|-------------|-----------| -| `مثبت` | شرط مثبت شامل نقشه‌های ویژگی حاصل از تصویر و داده‌های فرافکنی برای تولید Trellis2. | CONDITIONING | -| `منفی` | شرط منفی با تنسورهای ویژگی صفرشده، که برای راهنمایی بدون طبقه‌بند استفاده می‌شود. | CONDITIONING | +| `مثبت` | شرطی‌سازی مثبت شامل نقشه‌های ویژگی مشتق‌شده از تصویر و داده‌های پروجکشن برای تولید Trellis2. | CONDITIONING | +| `منفی` | شرطی‌سازی منفی با تنسورهای ویژگی صفرشده، که برای هدایت بدون طبقه‌بند استفاده می‌شود. | CONDITIONING | > این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Pixal3DConditioning/fa.md) --- -**Source fingerprint (SHA-256):** `3eba711620f6c56a21bbf7df89f8d406ce6f90908298b1a295a1dbbddd042472` +**Source fingerprint (SHA-256):** `88e82b48fbe297c8e32ddd1b6659f196bda6f77fd53480bc021e85170d1923c7` diff --git a/comfyui_embedded_docs/docs/Pixal3DConditioning/fr.md b/comfyui_embedded_docs/docs/Pixal3DConditioning/fr.md index 3e6b045f9..b0bc9ed57 100644 --- a/comfyui_embedded_docs/docs/Pixal3DConditioning/fr.md +++ b/comfyui_embedded_docs/docs/Pixal3DConditioning/fr.md @@ -1,25 +1,25 @@ # Pixal3DConditioning -Ce nœud prépare le conditionnement d'image pour le pipeline de génération 3D Trellis2. Il extrait les caractéristiques visuelles de l'image d'entrée avec un modèle de vision DINOv3 à deux résolutions, les organise en cartes de caractéristiques par étape (éventuellement améliorées avec un modèle NAF), et les combine avec les données de caméra dérivées du champ de vision horizontal. Il produit une paire de conditionnement positive et négative, où la négative utilise des caractéristiques mises à zéro pour le guidage sans classifieur. +Ce nœud prépare le conditionnement d’image pour le pipeline de génération 3D Trellis2. Il extrait les caractéristiques visuelles de l’image d’entrée à l’aide d’un modèle de vision DINOv3 à deux résolutions, les organise en cartes de caractéristiques par étape (éventuellement enrichies avec un modèle NAF), puis les combine avec les données de caméra dérivées du champ de vision horizontal. Il produit une paire de conditionnements positif et négatif, où le négatif utilise des caractéristiques mises à zéro pour le guidage sans classificateur. ## Entrées | Paramètre | Description | Type de données | Requis | Plage | |-----------|-------------|-----------------|--------|-------| -| `clip_vision_model` | DINOv3 ViT-L/16 ClipVision. | CLIP_VISION | Oui | — | -| `image` | Image prétraitée issue de ImageCropToMask (pad_factor=1.1 pour Pixal3D). | IMAGE | Oui | — | -| `camera_angle_x` | Champ de vision horizontal en degrés (nom affiché : fov). Connectez un nœud MoGeGeometryToFOV (axis='horizontal', unit='degrees') pour une FOV par image (correspond à la valeur par défaut en amont). Défaut : 49.13. | FLOAT | Oui | 1.0 – 170.0 | +| `clip_vision_model` | Modèle de vision DINOv3 ViT-L/16 ClipVision. | CLIP_VISION | Oui | — | +| `image` | Image prétraitée provenant d’ImageCropToMask (pad_factor=1.1 pour Pixal3D). | IMAGE | Oui | — | +| `camera_angle_x` | Champ de vision horizontal en degrés (nom d’affichage : fov). Connectez un MoGeGeometryToFOV (axis='horizontal', unit='degrees') pour obtenir un FoV par image (correspond à la valeur par défaut en amont). Défaut : 49.13. | FLOAT | Oui | 1.0 – 170.0 | -Remarque : La valeur `camera_angle_x` est convertie en radians en interne et utilisée pour calculer la distance de la caméra pour la matrice de transformation de projection. Lorsque le modèle de vision fourni inclut un composant NAF, le nœud produit en plus des cartes de caractéristiques haute résolution pour les étapes de forme et de texture. +Remarque : La valeur de `camera_angle_x` est convertie en radians en interne et sert à calculer la distance de caméra pour la matrice de transformation de projection. Lorsque le modèle de vision fourni comprend un composant NAF, le nœud produit également des cartes de caractéristiques haute résolution pour les étapes de forme et de texture. ## Sorties | Nom de sortie | Description | Type de données | |---------------|-------------|-----------------| -| `positif` | Conditionnement positif contenant les cartes de caractéristiques dérivées de l'image et les données de projection pour la génération Trellis2. | CONDITIONING | -| `négatif` | Conditionnement négatif avec des tenseurs de caractéristiques mis à zéro, utilisé pour le guidage sans classifieur. | CONDITIONING | +| `positif` | Conditionnement positif contenant les cartes de caractéristiques dérivées de l’image et les données de projection pour la génération Trellis2. | CONDITIONING | +| `négatif` | Conditionnement négatif avec des tenseurs de caractéristiques mis à zéro, utilisé pour le guidage sans classificateur. | CONDITIONING | > 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/Pixal3DConditioning/fr.md) --- -**Source fingerprint (SHA-256):** `3eba711620f6c56a21bbf7df89f8d406ce6f90908298b1a295a1dbbddd042472` +**Source fingerprint (SHA-256):** `88e82b48fbe297c8e32ddd1b6659f196bda6f77fd53480bc021e85170d1923c7` diff --git a/comfyui_embedded_docs/docs/Pixal3DConditioning/ja.md b/comfyui_embedded_docs/docs/Pixal3DConditioning/ja.md index c6cad2535..b5fe0179d 100644 --- a/comfyui_embedded_docs/docs/Pixal3DConditioning/ja.md +++ b/comfyui_embedded_docs/docs/Pixal3DConditioning/ja.md @@ -1,25 +1,25 @@ # Pixal3DConditioning -このノードは、Trellis2 3D生成パイプラインのための画像条件付けを準備します。入力画像からDINOv3ビジョンモデルを用いて2つの解像度で視覚的特徴を抽出し、ステージごとのフィーチャマップに整理し(任意でNAFモデルにより強化)、水平視野角から導出されたカメラデータと組み合わせます。ポジティブとネガティブの条件付けペアを出力し、ネガティブにはクラシファイアフリーガイダンス用にゼロ化された特徴を使用します。 +このノードは、Trellis2 3D生成パイプライン用の画像コンディショニングを準備します。入力画像からDINOv3ビジョンモデルを使用して2つの解像度で視覚特徴を抽出し、それらをステージごとの特徴マップに整理し(オプションでNAFモデルで拡張)、水平視野から導出されたカメラデータと組み合わせます。ポジティブとネガティブのコンディショニングペアを出力し、ネガティブは分類器フリーガイダンスのためにゼロ化された特徴を使用します。 ## 入力 | パラメータ | 説明 | データ型 | 必須 | 範囲 | |-----------|-------------|-----------|----------|-------| -| `clip_vision_model` | DINOv3 ViT-L/16 ClipVisionです。 | CLIP_VISION | はい | — | -| `image` | ImageCropToMask(Pixal3Dではpad_factor=1.1)から出力された前処理済み画像です。 | IMAGE | はい | — | -| `camera_angle_x` | 水平FOV(度単位)です(表示名: fov)。画像ごとのFoVを得るには、MoGeGeometryToFOV(axis='horizontal', unit='degrees')を接続してください(アップストリームのデフォルトと一致します)。デフォルト: 49.13。 | FLOAT | はい | 1.0 – 170.0 | +| `clip_vision_model` | DINOv3 ViT-L/16 ClipVision。 | CLIP_VISION | はい | — | +| `image` | ImageCropToMaskから前処理された画像(Pixal3Dの場合はpad_factor=1.1)。 | IMAGE | はい | — | +| `camera_angle_x` | 水平画角(度単位)(表示名: fov)。画像ごとのFoVを取得するには、MoGeGeometryToFOV(axis='horizontal', unit='degrees')を接続してください(アップストリームのデフォルトと一致)。デフォルト: 49.13。 | FLOAT | はい | 1.0 – 170.0 | -注: `camera_angle_x` の値は内部でラジアンに変換され、射影変換行列のカメラ距離を計算するために使用されます。指定されたビジョンモデルにNAFコンポーネントが含まれる場合、ノードはさらにシェイプステージとテクスチャステージ用の高解像度フィーチャマップを生成します。 +注:`camera_angle_x`の値は内部でラジアンに変換され、投影変換行列のカメラ距離を計算するために使用されます。指定されたビジョンモデルにNAFコンポーネントが含まれる場合、ノードはシェイプおよびテクスチャステージ用の高解像度特徴マップを追加で生成します。 ## 出力 | 出力名 | 説明 | データ型 | |-------------|-------------|-----------| -| `ポジティブ` | Trellis2生成用の画像由来フィーチャマップと射影データを含むポジティブ条件付けです。 | CONDITIONING | -| `ネガティブ` | クラシファイアフリーガイダンスに使用される、ゼロ化された特徴テンソルを持つネガティブ条件付けです。 | CONDITIONING | +| `ポジティブ` | Trellis2生成用の画像由来の特徴マップと投影データを含むポジティブコンディショニング。 | CONDITIONING | +| `ネガティブ` | ゼロ化された特徴テンソルを持つネガティブコンディショニング。分類器フリーガイダンスに使用されます。 | CONDITIONING | > このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Pixal3DConditioning/ja.md) --- -**Source fingerprint (SHA-256):** `3eba711620f6c56a21bbf7df89f8d406ce6f90908298b1a295a1dbbddd042472` +**Source fingerprint (SHA-256):** `88e82b48fbe297c8e32ddd1b6659f196bda6f77fd53480bc021e85170d1923c7` diff --git a/comfyui_embedded_docs/docs/Pixal3DConditioning/ko.md b/comfyui_embedded_docs/docs/Pixal3DConditioning/ko.md index 3b99e3677..29fcd483d 100644 --- a/comfyui_embedded_docs/docs/Pixal3DConditioning/ko.md +++ b/comfyui_embedded_docs/docs/Pixal3DConditioning/ko.md @@ -1,25 +1,25 @@ # Pixal3DConditioning -이 노드는 Trellis2 3D 생성 파이프라인을 위한 이미지 컨디셔닝을 준비합니다. DINOv3 비전 모델을 사용하여 입력 이미지에서 두 가지 해상도로 시각적 특징을 추출하고, 이를 단계별 특징 맵으로 구성한 다음(선택적으로 NAF 모델로 향상), 수평 시야각에서 파생된 카메라 데이터와 결합합니다. 긍정(positive) 및 부정(negative) 컨디셔닝 쌍을 출력하며, 부정 컨디셔닝은 classifier-free guidance를 위해 0으로 설정된 특징을 사용합니다. +이 노드는 Trellis2 3D 생성 파이프라인을 위한 이미지 컨디셔닝을 생성합니다. DINOv3 비전 모델을 사용하여 입력 이미지에서 두 해상도로 시각적 특징을 추출하고, 이를 단계별 특징 맵으로 구성하며(선택적으로 NAF 모델로 향상), 수평 화각에서 파생된 카메라 데이터와 결합합니다. 그런 다음 포지티브 및 네거티브 컨디셔닝 쌍을 출력하며, 네거티브는 classifier-free guidance를 위해 0으로 채워진 특징을 사용합니다. ## 입력 | 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | |-----------|-------------|-----------|----------|-------| -| `clip_vision_model` | DINOv3 ViT-L/16 ClipVision. | CLIP_VISION | 예 | — | +| `clip_vision_model` | DINOv3 ViT-L/16 ClipVision 모델입니다. | CLIP_VISION | 예 | — | | `이미지` | ImageCropToMask에서 전처리된 이미지입니다(Pixal3D의 경우 pad_factor=1.1). | IMAGE | 예 | — | -| `camera_angle_x` | 수평 시야각(FOV)을 도 단위로 나타냅니다(표시 이름: fov). 이미지별 FoV를 얻으려면 MoGeGeometryToFOV(axis='horizontal', unit='degrees')를 연결하세요(업스트림 기본값과 일치). 기본값: 49.13. | FLOAT | 예 | 1.0 – 170.0 | +| `camera_angle_x` | 도 단위의 수평 FOV입니다(표시 이름: fov). 이미지별 FoV를 얻으려면 MoGeGeometryToFOV(axis='horizontal', unit='degrees')를 연결하십시오(업스트림 기본값과 일치). 기본값: 49.13. | FLOAT | 예 | 1.0 – 170.0 | -참고: `camera_angle_x` 값은 내부적으로 라디안으로 변환되며 투영 변환 행렬의 카메라 거리를 계산하는 데 사용됩니다. 제공된 비전 모델에 NAF 구성 요소가 포함된 경우, 이 노드는 형상 및 텍스처 단계를 위한 고해상도 특징 맵을 추가로 생성합니다. +참고: `camera_angle_x` 값은 내부적으로 라디안으로 변환되며 투영 변환 행렬에 필요한 카메라 거리를 계산하는 데 사용됩니다. 제공된 비전 모델에 NAF 구성 요소가 포함된 경우, 이 노드는 셰이프 및 텍스처 단계를 위해 고해상도 특징 맵을 추가로 생성합니다. ## 출력 | 출력 이름 | 설명 | 데이터 타입 | -|-------------|-------------|-----------| -| `긍정` | Trellis2 생성을 위한 이미지 기반 특징 맵과 투영 데이터를 포함하는 긍정 컨디셔닝입니다. | CONDITIONING | -| `부정` | classifier-free guidance를 위해 0으로 설정된 특징 텐서를 포함하는 부정 컨디셔닝입니다. | CONDITIONING | +|-----------|-------------|-----------| +| `긍정` | Trellis2 생성을 위해 이미지에서 도출된 특징 맵과 투영 데이터를 포함하는 포지티브 컨디셔닝입니다. | CONDITIONING | +| `부정` | 0으로 채워진 특징 텐서를 포함하며, classifier-free guidance에 사용되는 네거티브 컨디셔닝입니다. | CONDITIONING | > 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Pixal3DConditioning/ko.md) --- -**Source fingerprint (SHA-256):** `3eba711620f6c56a21bbf7df89f8d406ce6f90908298b1a295a1dbbddd042472` +**Source fingerprint (SHA-256):** `88e82b48fbe297c8e32ddd1b6659f196bda6f77fd53480bc021e85170d1923c7` diff --git a/comfyui_embedded_docs/docs/Pixal3DConditioning/pt-BR.md b/comfyui_embedded_docs/docs/Pixal3DConditioning/pt-BR.md index d1c16c6c8..ceba329eb 100644 --- a/comfyui_embedded_docs/docs/Pixal3DConditioning/pt-BR.md +++ b/comfyui_embedded_docs/docs/Pixal3DConditioning/pt-BR.md @@ -1,25 +1,25 @@ # Pixal3DConditioning -Este nó prepara o condicionamento de imagem para o pipeline de geração 3D Trellis2. Ele extrai características visuais da imagem de entrada com um modelo de visão DINOv3 em duas resoluções, organiza-as em mapas de características por estágio (opcionalmente aprimorados com um modelo NAF) e combina-os com dados de câmera derivados do campo de visão horizontal. Ele gera um par de condicionamentos positivo e negativo, onde o negativo usa características zeradas para orientação livre de classificador. +Este nó prepara o condicionamento de imagem para o pipeline de geração 3D do Trellis2. Ele extrai características visuais da imagem de entrada com um modelo de visão DINOv3 em duas resoluções, organiza-as em mapas de características por estágio (opcionalmente aprimorados com um modelo NAF) e os combina com dados de câmera derivados do campo de visão horizontal. Ele produz um par de condicionamentos positivo e negativo, em que o negativo usa características zeradas para orientação livre de classificador. ## Entradas -| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | +| Parâmetro | Descrição | Tipo de dados | Obrigatório | Intervalo | |-----------|-------------|-----------|----------|-------| | `clip_vision_model` | DINOv3 ViT-L/16 ClipVision. | CLIP_VISION | Sim | — | -| `imagem` | Imagem pré-processada de ImageCropToMask (pad_factor=1.1 para Pixal3D). | IMAGE | Sim | — | -| `camera_angle_x` | FOV horizontal em graus (nome de exibição: fov). Conecte um MoGeGeometryToFOV (axis='horizontal', unit='degrees') para um FoV por imagem (corresponde ao padrão original). Padrão: 49.13. | FLOAT | Sim | 1.0 – 170.0 | +| `imagem` | Imagem pré-processada do ImageCropToMask (pad_factor=1.1 para Pixal3D). | IMAGE | Sim | — | +| `camera_angle_x` | FOV horizontal em graus (nome de exibição: fov). Conecte um MoGeGeometryToFOV (axis='horizontal', unit='degrees') para um FoV por imagem (corresponde ao padrão upstream). Padrão: 49.13. | FLOAT | Sim | 1.0 – 170.0 | -Nota: O valor de `camera_angle_x` é convertido para radianos internamente e usado para calcular a distância da câmera para a matriz de transformação de projeção. Quando o modelo de visão fornecido inclui um componente NAF, o nó também produz mapas de características de alta resolução para as etapas de forma e textura. +Observação: O valor de `camera_angle_x` é convertido internamente para radianos e usado para calcular a distância da câmera para a matriz de transformação de projeção. Quando o modelo de visão fornecido inclui um componente NAF, o nó também produz mapas de características de alta resolução para os estágios de forma e textura. ## Saídas -| Nome da Saída | Descrição | Tipo de Dados | +| Nome da saída | Descrição | Tipo de dados | |-------------|-------------|-----------| -| `positivo` | Condicionamento positivo contendo os mapas de características derivados da imagem e os dados de projeção para a geração Trellis2. | CONDITIONING | +| `positivo` | Condicionamento positivo contendo os mapas de características derivados da imagem e os dados de projeção para a geração do Trellis2. | CONDITIONING | | `negativo` | Condicionamento negativo com tensores de características zerados, usado para orientação livre de classificador. | CONDITIONING | > 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/Pixal3DConditioning/pt-BR.md) --- -**Source fingerprint (SHA-256):** `3eba711620f6c56a21bbf7df89f8d406ce6f90908298b1a295a1dbbddd042472` +**Source fingerprint (SHA-256):** `88e82b48fbe297c8e32ddd1b6659f196bda6f77fd53480bc021e85170d1923c7` diff --git a/comfyui_embedded_docs/docs/Pixal3DConditioning/ru.md b/comfyui_embedded_docs/docs/Pixal3DConditioning/ru.md index f291a82df..cab49750c 100644 --- a/comfyui_embedded_docs/docs/Pixal3DConditioning/ru.md +++ b/comfyui_embedded_docs/docs/Pixal3DConditioning/ru.md @@ -1,25 +1,25 @@ # Pixal3DConditioning -Этот узел подготавливает кондиционирование изображения для конвейера 3D-генерации Trellis2. Он извлекает визуальные признаки из входного изображения с помощью модели зрения DINOv3 в двух разрешениях, организует их в поэтапные карты признаков (при необходимости дополненные моделью NAF) и объединяет их с данными камеры, полученными из горизонтального поля зрения. На выходе он формирует пару положительного и отрицательного кондиционирования, где отрицательное использует обнуленные признаки для управления без классификатора. +Этот узел подготавливает кондиционирование изображения для конвейера генерации 3D Trellis2. Он извлекает визуальные признаки из входного изображения с помощью модели компьютерного зрения DINOv3 в двух разрешениях, организует их в карты признаков для каждого этапа (опционально улучшенные моделью NAF) и объединяет их с данными камеры, полученными на основе горизонтального угла обзора. Выходом является пара положительного и отрицательного кондиционирования; в отрицательном для управления без классификатора используются обнулённые признаки. ## Входы -| Параметр | Описание | Тип данных | Требуется | Диапазон | +| Параметр | Описание | Тип данных | Обязательный | Диапазон | |-----------|-------------|-----------|----------|-------| | `clip_vision_model` | DINOv3 ViT-L/16 ClipVision. | CLIP_VISION | Да | — | -| `изображение` | Предобработанное изображение из ImageCropToMask (pad_factor=1.1 для Pixal3D). | IMAGE | Да | — | -| `camera_angle_x` | Горизонтальное поле зрения в градусах (отображаемое имя: fov). Подключите MoGeGeometryToFOV (axis='horizontal', unit='degrees') для получения поля зрения для каждого изображения (соответствует значению по умолчанию вышестоящего узла). По умолчанию: 49.13. | FLOAT | Да | 1.0 – 170.0 | +| `изображение` | Предварительно обработанное изображение из ImageCropToMask (pad_factor=1.1 для Pixal3D). | IMAGE | Да | — | +| `camera_angle_x` | Горизонтальный угол обзора в градусах (отображаемое имя: fov). Подключите узел MoGeGeometryToFOV (axis='horizontal', unit='degrees'), чтобы задавать FoV для каждого изображения (соответствует значению по умолчанию в базовой реализации). По умолчанию: 49.13. | FLOAT | Да | 1.0 – 170.0 | -Примечание: значение `camera_angle_x` преобразуется в радианы внутри узла и используется для вычисления расстояния до камеры для матрицы проекционного преобразования. Если используемая модель зрения включает компонент NAF, узел дополнительно создает карты признаков высокого разрешения для этапов формы и текстуры. +Примечание: значение `camera_angle_x` внутри узла преобразуется в радианы и используется для вычисления расстояния до камеры для матрицы проекционного преобразования. Если переданная модель компьютерного зрения содержит компонент NAF, узел дополнительно создаёт карты признаков высокого разрешения для этапов формы и текстуры. ## Выходы | Имя выхода | Описание | Тип данных | |-------------|-------------|-----------| -| `положительное` | Положительное кондиционирование, содержащее карты признаков, полученные из изображения, и данные проекции для генерации Trellis2. | CONDITIONING | -| `отрицательное` | Отрицательное кондиционирование с обнуленными тензорами признаков, используемое для управления без классификатора. | CONDITIONING | +| `положительное` | Положительное кондиционирование, содержащее карты признаков, извлечённые из изображения, и данные проекции для генерации Trellis2. | CONDITIONING | +| `отрицательное` | Отрицательное кондиционирование с обнулёнными тензорами признаков; используется для управления без классификатора. | CONDITIONING | > Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Pixal3DConditioning/ru.md) --- -**Source fingerprint (SHA-256):** `3eba711620f6c56a21bbf7df89f8d406ce6f90908298b1a295a1dbbddd042472` +**Source fingerprint (SHA-256):** `88e82b48fbe297c8e32ddd1b6659f196bda6f77fd53480bc021e85170d1923c7` diff --git a/comfyui_embedded_docs/docs/Pixal3DConditioning/tr.md b/comfyui_embedded_docs/docs/Pixal3DConditioning/tr.md index 3375616a0..47017a4b1 100644 --- a/comfyui_embedded_docs/docs/Pixal3DConditioning/tr.md +++ b/comfyui_embedded_docs/docs/Pixal3DConditioning/tr.md @@ -1,25 +1,25 @@ # Pixal3DConditioning -Bu düğüm, Trellis2 3B üretim hattı için görüntü koşullandırması hazırlar. Girdi görüntüsünden DINOv3 görüş modeli ile iki çözünürlükte görsel özellikler çıkarır, bunları aşama başına özellik haritaları halinde düzenler (isteğe bağlı olarak bir NAF modeliyle geliştirilmiş) ve yatay görüş alanından türetilen kamera verileriyle birleştirir. Pozitif ve negatif olmak üzere bir çift koşullandırma çıktısı üretir; negatif koşullandırma, sınıflandırıcısız rehberlik için sıfırlanmış özellikler kullanır. +Bu düğüm, Trellis2 3D üretim hattı için görüntü koşullandırmasını hazırlar. Girdi görüntüsünden, DINOv3 görü modeliyle iki çözünürlükte görsel öznitelikler çıkarır; bunları aşama başına öznitelik haritaları halinde düzenler (isteğe bağlı olarak bir NAF modeliyle geliştirilir) ve yatay görüş alanından türetilen kamera verileriyle birleştirir. Sınıflandırıcısız yönlendirme için negatif tarafın sıfırlanmış öznitelikler kullandığı bir pozitif ve bir negatif koşullandırma çifti çıkarır. ## Girdiler -| Parametre | Açıklama | Veri Tipi | Zorunlu | Aralık | +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | |-----------|-------------|-----------|----------|-------| -| `clip_vision_model` | DINOv3 ViT-L/16 ClipVision modeli. | CLIP_VISION | Evet | — | -| `görüntü` | ImageCropToMask'ten ön işlenmiş görüntü (Pixal3D için pad_factor=1.1). | IMAGE | Evet | — | -| `camera_angle_x` | Derece cinsinden yatay görüş alanı (görünen ad: fov). Görüntü başına bir FoV için bir MoGeGeometryToFOV (axis='horizontal', unit='degrees') bağlayın (üst akış varsayılanıyla eşleşir). Varsayılan: 49.13. | FLOAT | Evet | 1.0 – 170.0 | +| `clip_vision_model` | DINOv3 ViT-L/16 ClipVision. | CLIP_VISION | Evet | — | +| `görüntü` | ImageCropToMask çıktısı olan ön işlenmiş görüntü (Pixal3D için pad_factor=1.1). | IMAGE | Evet | — | +| `camera_angle_x` | Derece cinsinden yatay görüş alanı (görünen ad: fov). Görüntü başına FoV için bir MoGeGeometryToFOV (axis='horizontal', unit='degrees') bağlayın (üst akış varsayılanıyla uyumludur). Varsayılan: 49.13. | FLOAT | Evet | 1.0 – 170.0 | -Not: `camera_angle_x` değeri dahili olarak radyana dönüştürülür ve projeksiyon dönüşüm matrisi için kamera mesafesini hesaplamak üzere kullanılır. Sağlanan görüş modeli bir NAF bileşeni içerdiğinde, düğüm ayrıca şekil ve doku aşamaları için yüksek çözünürlüklü özellik haritaları üretir. +Not: `camera_angle_x` değeri dahili olarak radyana dönüştürülür ve projeksiyon dönüşüm matrisi için kamera mesafesini hesaplamakta kullanılır. Sağlanan görü modeli bir NAF bileşeni içerdiğinde, düğüm ayrıca şekil ve doku aşamaları için yüksek çözünürlüklü öznitelik haritaları üretir. ## Çıktılar -| Çıktı Adı | Açıklama | Veri Tipi | +| Çıktı Adı | Açıklama | Veri Türü | |-------------|-------------|-----------| -| `pozitif` | Trellis2 üretimi için görüntüden türetilmiş özellik haritalarını ve projeksiyon verilerini içeren pozitif koşullandırma. | CONDITIONING | -| `negatif` | Sınıflandırıcısız rehberlik için kullanılan, sıfırlanmış özellik tensörlerine sahip negatif koşullandırma. | CONDITIONING | +| `pozitif` | Trellis2 üretimi için görüntüden türetilmiş öznitelik haritalarını ve projeksiyon verilerini içeren pozitif koşullandırma. | CONDITIONING | +| `negatif` | Sınıflandırıcısız yönlendirme için kullanılan, sıfırlanmış öznitelik tensörlerine sahip negatif koşullandırma. | CONDITIONING | > 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/Pixal3DConditioning/tr.md) --- -**Source fingerprint (SHA-256):** `3eba711620f6c56a21bbf7df89f8d406ce6f90908298b1a295a1dbbddd042472` +**Source fingerprint (SHA-256):** `88e82b48fbe297c8e32ddd1b6659f196bda6f77fd53480bc021e85170d1923c7` diff --git a/comfyui_embedded_docs/docs/Pixal3DConditioning/zh-TW.md b/comfyui_embedded_docs/docs/Pixal3DConditioning/zh-TW.md index 19f694ddc..d3b4401e5 100644 --- a/comfyui_embedded_docs/docs/Pixal3DConditioning/zh-TW.md +++ b/comfyui_embedded_docs/docs/Pixal3DConditioning/zh-TW.md @@ -1,25 +1,25 @@ # Pixal3DConditioning -此節點為 Trellis2 3D 生成管線準備影像條件輸入。它使用 DINOv3 視覺模型以兩種解析度從輸入影像中提取視覺特徵,將它們組織為各階段的特徵圖(可選擇透過 NAF 模型增強),並與由水平視野導出的相機資料結合。它輸出一對正向和負向條件輸入,其中負向條件使用歸零特徵來進行無分類器引導。 +此節點為 Trellis2 3D 生成管線準備影像條件。它使用 DINOv3 視覺模型以兩種解析度從輸入影像中提取視覺特徵,將它們組織成每個階段的特徵圖(可選地使用 NAF 模型增強),並將它們與從水平視野推導出的攝影機資料結合。它輸出一對正向和負向條件,其中負向條件使用零化特徵進行無分類器引導。 ## 輸入 -| 參數 | 描述 | 資料類型 | 必填 | 範圍 | +| 參數 | 描述 | 資料類型 | 必要 | 範圍 | |-----------|-------------|-----------|----------|-------| -| `clip_vision_model` | DINOv3 ViT-L/16 ClipVision 模型。 | CLIP_VISION | 是 | — | -| `圖像` | 來自 ImageCropToMask 的預處理影像(適用於 Pixal3D 的 pad_factor=1.1)。 | IMAGE | 是 | — | -| `camera_angle_x` | 水平視野(以度為單位)(顯示名稱:fov)。連接 MoGeGeometryToFOV(axis='horizontal', unit='degrees')以獲得每個影像的視野(與上游預設值一致)。預設值:49.13。 | FLOAT | 是 | 1.0 – 170.0 | +| `clip_vision_model` | DINOv3 ViT-L/16 ClipVision。 | CLIP_VISION | 是 | — | +| `圖像` | 來自 ImageCropToMask 的預處理影像(對於 Pixal3D,pad_factor=1.1)。 | IMAGE | 是 | — | +| `camera_angle_x` | 水平 FOV,以度為單位(顯示名稱:fov)。連接 MoGeGeometryToFOV(axis='horizontal', unit='degrees')以獲得每張影像的 FoV(與上游預設值一致)。預設值:49.13。 | FLOAT | 是 | 1.0 – 170.0 | -注意:`camera_angle_x` 值在內部會轉換為弧度,並用於計算投影變換矩陣所需的相機距離。當提供的視覺模型包含 NAF 元件時,此節點會另外為形狀和紋理階段產生高解析度特徵圖。 +注意:`camera_angle_x` 值在內部轉換為弧度,並用於計算投影變換矩陣的攝影機距離。當提供的視覺模型包含 NAF 元件時,節點還會為形狀和紋理階段產生高解析度特徵圖。 ## 輸出 | 輸出名 | 描述 | 資料類型 | |-------------|-------------|-----------| -| `正向` | 正向條件,包含從影像衍生的特徵圖和用於 Trellis2 生成的投影資料。 | CONDITIONING | -| `負向` | 負向條件,具有歸零的特徵張量,用於無分類器引導。 | CONDITIONING | +| `正向` | 正向條件,包含從影像推導出的特徵圖和 Trellis2 生成的投影資料。 | CONDITIONING | +| `負向` | 負向條件,使用零化特徵張量,用於無分類器引導。 | CONDITIONING | > 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Pixal3DConditioning/zh-TW.md) --- -**Source fingerprint (SHA-256):** `3eba711620f6c56a21bbf7df89f8d406ce6f90908298b1a295a1dbbddd042472` +**Source fingerprint (SHA-256):** `88e82b48fbe297c8e32ddd1b6659f196bda6f77fd53480bc021e85170d1923c7` diff --git a/comfyui_embedded_docs/docs/Pixal3DConditioning/zh.md b/comfyui_embedded_docs/docs/Pixal3DConditioning/zh.md index c6c7f17d1..41b145ac3 100644 --- a/comfyui_embedded_docs/docs/Pixal3DConditioning/zh.md +++ b/comfyui_embedded_docs/docs/Pixal3DConditioning/zh.md @@ -1,23 +1,23 @@ # Pixal3DConditioning -此节点为 Trellis2 3D 生成流程准备图像条件。它使用 DINOv3 视觉模型在两种分辨率下从输入图像提取视觉特征,将其组织为各阶段的特征图(可选择通过 NAF 模型增强),并结合从水平视场导出的相机数据。它输出正向和负向条件对,其中负向条件使用零化特征以进行无分类器引导。 +此节点为 Trellis2 3D 生成流程准备图像条件。它通过 DINOv3 视觉模型以两种分辨率从输入图像中提取视觉特征,将其整理为各阶段的特征图(可选地通过 NAF 模型增强),并与根据水平视场角得出的相机数据相结合。该节点输出一对正负条件,其中负向条件使用清零特征,用于无分类器引导。 ## 输入 -| 参数 | 描述 | 数据类型 | 必需 | 范围 | +| 参数 | 描述 | 数据类型 | 必填 | 范围 | |-----------|-------------|-----------|----------|-------| | `clip 视觉模型` | DINOv3 ViT-L/16 ClipVision。 | CLIP_VISION | 是 | — | -| `图像` | 来自 ImageCropToMask 的预处理图像(针对 Pixal3D 的 pad_factor=1.1)。 | IMAGE | 是 | — | -| `相机水平视场角` | 水平 FOV(度)(显示名称:fov)。连接一个 MoGeGeometryToFOV(axis='horizontal', unit='degrees')以获得逐图像 FoV(与上游默认值一致)。默认值:49.13。 | FLOAT | 是 | 1.0 – 170.0 | +| `图像` | 来自 ImageCropToMask 的预处理图像(用于 Pixal3D 时设置 pad_factor=1.1)。 | IMAGE | 是 | — | +| `相机水平视场角` | 水平视场角(以度为单位,显示名称:fov)。连接 MoGeGeometryToFOV(axis='horizontal', unit='degrees')可获取逐图像 FoV(与上游默认一致)。默认值:49.13。 | FLOAT | 是 | 1.0 – 170.0 | -注意:`camera_angle_x` 值会在内部转换为弧度,并用于计算投影变换矩阵的相机距离。当提供的视觉模型包含 NAF 组件时,该节点还会为形状和纹理阶段生成高分辨率特征图。 +注意:`camera_angle_x` 值会在内部转换为弧度,并用于计算投影变换矩阵所需的相机距离。当提供的视觉模型包含 NAF 组件时,该节点还会为形状阶段和纹理阶段额外生成高分辨率特征图。 ## 输出 | 输出名称 | 描述 | 数据类型 | |-------------|-------------|-----------| | `正面` | 包含从图像导出的特征图和投影数据的正向条件,用于 Trellis2 生成。 | CONDITIONING | -| `负面` | 特征张量被零化的负向条件,用于无分类器引导。 | CONDITIONING | +| `负面` | 包含清零特征张量的负向条件,用于无分类器引导。 | CONDITIONING | > 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Pixal3DConditioning/zh.md) --- -**Source fingerprint (SHA-256):** `3eba711620f6c56a21bbf7df89f8d406ce6f90908298b1a295a1dbbddd042472` +**Source fingerprint (SHA-256):** `88e82b48fbe297c8e32ddd1b6659f196bda6f77fd53480bc021e85170d1923c7` diff --git a/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/ar.md b/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/ar.md new file mode 100644 index 000000000..b4440f615 --- /dev/null +++ b/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/ar.md @@ -0,0 +1,36 @@ +# Pixal3DMultiViewConditioning + +## مقدمة + +يُعد مكون Pixal3D Multi-View Conditioning هو نظام محور ثابت يُنتج مناظر أمامية، يسار، خلفية، وأيمن لجسم عند فترات زاوية 90 درجة. يتم استخدامه لإنشاء مناظر محاطة لبرامج Pixal3D، حيث يغطي الجسم حوالي 1/1.1 من الإطار عند أوسع جزء منه، مما يحافظ على نفس المقياس في كل منظر. + +## المدخلات + +| المعامل | الوصف | نوع البيانات | إلزامي | نطاق | +|-----------|-------------|-----------|----------|-------| +| `clip_vision_model` | DINOv3 ViT-L/16 ClipVision مع أوزان NAF المدمجة. | MODEL | نعم | غير محدد | +| `fov` | مجال الرؤية الأفقي في درجات المناظر عند الإطار. | FLOAT | نعم | 1.0 - 170.0 | +| `أمامي` | منظر مربع لجهة الأمام للجسم، يحتوي على شفافية أو على خلفية سوداء. | IMAGE | نعم | غير محدد | +| `أيسر` | منظر مربع لجهة اليسار للجسم، يحتوي على شفافية أو على خلفية سوداء. | IMAGE | اختياري | غير محدد | +| `خلفي` | منظر مربع لجهة الخلف للجسم، يحتوي على شفافية أو على خلفية سوداء. | IMAGE | اختياري | غير محدد | +| `أيمن` | منظر مربع لجهة اليمين للجسم، يحتوي على شفافية أو على خلفية سوداء. | IMAGE | اختياري | غير محدد | + +## المخرجات + +| اسم المخرج | الوصف | نوع البيانات | +|-------------|-------------|-----------| +| `إيجابي` | مخرج التشغيل الإيجابي لمكون Pixal3D Multi-View Conditioning. | CONDITIONING | +| `سلبي` | مخرج التشغيل السلبي لمكون Pixal3D Multi-View Conditioning. | CONDITIONING | + +## ملاحظات + +- يتحكم المعامل `fov` في مجال الرؤية الأفقي للمناظر عند الإطار. القيمة 20 درجة هي نموذجية للتصوير بالقضبان والجينيراتورات المتعددة المناظر. +- يُعتبر المنظر الموصلة الأول (أمام، يسار، خلفية، يمين) هو المنظر الأمامي، ويُوضع الشبكة لهذا المنظر. +- إذا لم يتم تقديم منظر أمامي، يتم تسجيل تحذير، ويُوضع الشبكة مع المنظر الموصلة الأول كمنظر أمامي. +- يفترض المكون أن المناظر مربعة ومحاطة مثل القضبان. يجب أن يغطي الجسم حوالي 1/1.1 من الإطار عند أوسع جزء منه، ويجب أن يتم الحفاظ على نفس المقياس في كل منظر. +- يُنتج المكون اثنين من كائنات التشغيل، واحد للتشغيل الإيجابي والأخر للتشغيل السلبي. يمكن استخدام هذه التشغيلات لتشغيل نماذج Pixal3D أو مكونات أخرى تقبل مدخلات التشغيل. + +> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/ar.md) + +--- +**Source fingerprint (SHA-256):** `e6319ebd1a557dbb48269bab8a667e78e48f446d87fffbd9df4c4ebfb62b0fac` diff --git a/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/en.md b/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/en.md new file mode 100644 index 000000000..01429bc44 --- /dev/null +++ b/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/en.md @@ -0,0 +1,36 @@ +# Pixal3DMultiViewConditioning + +## Overview + +The Pixal3D Multi-View Conditioning node is a fixed orbit rig that generates front, left, back, and right views of an object at 90-degree intervals. It is used to create framed views for Pixal3D applications, where the object spans approximately 1/1.1 of the frame at its widest, maintaining the same scale in every view. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `clip_vision_model` | DINOv3 ViT-L/16 ClipVision with bundled NAF weights. | MODEL | Yes | N/A | +| `fov` | Horizontal FOV in degrees of the views as framed. | FLOAT | Yes | 1.0 - 170.0 | +| `front` | Square view of the object's front side, with alpha or on a black background. | IMAGE | Yes | N/A | +| `left` | Square view of the object's left side, with alpha or on a black background. | IMAGE | Optional | N/A | +| `back` | Square view of the object's back side, with alpha or on a black background. | IMAGE | Optional | N/A | +| `right` | Square view of the object's right side, with alpha or on a black background. | IMAGE | Optional | N/A | + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `positive` | The positive conditioning output for the Pixal3D Multi-View Conditioning node. | CONDITIONING | +| `negative` | The negative conditioning output for the Pixal3D Multi-View Conditioning node. | CONDITIONING | + +## Notes + +- The `fov` parameter controls the horizontal field of view of the views as framed. A value of 20 degrees is typical for rig renders and most multi-view generators. +- The first connected view (front, left, back, right order) is considered the front, and the mesh is posed to this view. +- If no front view is provided, a warning is logged, and the mesh will be posed with the first connected view as its front. +- The node assumes that the views are square and framed like the rig. The object should span about 1/1.1 of the frame at its widest, and the same scale should be maintained in every view. +- The node outputs two Conditioning objects, one for the positive and one for the negative conditioning. These can be used to condition Pixal3D models or other nodes that accept Conditioning inputs. + +> 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/Pixal3DMultiViewConditioning/en.md) + +--- +**Source fingerprint (SHA-256):** `e6319ebd1a557dbb48269bab8a667e78e48f446d87fffbd9df4c4ebfb62b0fac` diff --git a/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/es.md b/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/es.md new file mode 100644 index 000000000..82f253327 --- /dev/null +++ b/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/es.md @@ -0,0 +1,36 @@ +# Pixal3DMultiViewConditioning + +## Resumen + +El nodo Pixal3D Multi-View Conditioning es una estructura de órbita fija que genera vistas frontales, laterales, traseras y laterales de un objeto a intervalos de 90 grados. Se utiliza para crear vistas enmarcadas para aplicaciones Pixal3D, donde el objeto abarca aproximadamente 1/1.1 de la imagen en su anchura máxima, manteniendo la misma escala en cada vista. + +## Entradas + +| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango | +|-----------|-------------|-----------|----------|-------| +| `clip_vision_model` | DINOv3 ViT-L/16 ClipVision con pesos NAF incluidos. | MODEL | Sí | N/A | +| `fov` | FOV horizontal en grados de las vistas enmarcadas. | FLOAT | Sí | 1.0 - 170.0 | +| `frontal` | Vista cuadrada del lado frontal del objeto, con alpha o en un fondo negro. | IMAGE | Sí | N/A | +| `izquierda` | Vista cuadrada del lado izquierdo del objeto, con alpha o en un fondo negro. | IMAGE | Opcional | N/A | +| `trasera` | Vista cuadrada del lado trasero del objeto, con alpha o en un fondo negro. | IMAGE | Opcional | N/A | +| `derecha` | Vista cuadrada del lado derecho del objeto, con alpha o en un fondo negro. | IMAGE | Opcional | N/A | + +## Salidas + +| Nombre de salida | Descripción | Tipo de datos | +|-------------|-------------|-----------| +| `positivo` | La salida de condicionamiento positivo para el nodo Pixal3D Multi-View Conditioning. | CONDITIONING | +| `negativo` | La salida de condicionamiento negativo para el nodo Pixal3D Multi-View Conditioning. | CONDITIONING | + +## Notas + +- El parámetro `fov` controla el campo de visión horizontal de las vistas enmarcadas. Un valor de 20 grados es típico para renders de estructuras y la mayoría de los generadores de vistas múltiples. +- La primera vista conectada (orden frontal, izquierdo, trasero, derecho) se considera frontal, y la malla se coloca en esta vista. +- Si no se proporciona una vista frontal, se genera un aviso y la malla se coloca con la primera vista conectada como su frontal. +- El nodo asume que las vistas son cuadradas y enmarcadas como la estructura. El objeto debe abarcar aproximadamente 1/1.1 de la imagen en su anchura máxima, y la misma escala debe mantenerse en cada vista. +- El nodo genera dos objetos de condicionamiento, uno para el condicionamiento positivo y otro para el negativo. Estos pueden utilizarse para condicionar modelos Pixal3D u otros nodos que acepten entradas de condicionamiento. + +> 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/Pixal3DMultiViewConditioning/es.md) + +--- +**Source fingerprint (SHA-256):** `e6319ebd1a557dbb48269bab8a667e78e48f446d87fffbd9df4c4ebfb62b0fac` diff --git a/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/fa.md b/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/fa.md new file mode 100644 index 000000000..eca5475e8 --- /dev/null +++ b/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/fa.md @@ -0,0 +1,36 @@ +# Pixal3DMultiViewConditioning + +## مقدمه + +گره تنظیمات چند视角 Pixal3D یک قابلیت چرخش ثابت است که در فاصله‌های 90 درجه، نمای جلو، چپ، عقب و راست یک شیء را تولید می‌کند. این گره برای ایجاد نماها با قاب برای برنامه‌های Pixal3D استفاده می‌شود، جایی که شیء در پهنا بیش از 1/1.1 از قاب را اشغال می‌کند و مقیاس مشابهی در هر نمای تولید می‌شود. + +## ورودی‌ها + +| پارامتر | توضیح | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `clip_vision_model` | DINOv3 ViT-L/16 ClipVision با وزنه‌های NAF بسته شده. | MODEL | بله | N/A | +| `fov` | میدان دید افقی نماها به درجه به عنوان قاب. | FLOAT | بله | 1.0 - 170.0 | +| `جلو` | نمای مربعی جلو شیء، با آلفا یا بر زمینه سیاه. | IMAGE | بله | N/A | +| `چپ` | نمای مربعی چپ شیء، با آلفا یا بر زمینه سیاه. | IMAGE | اختیاری | N/A | +| `پشت` | نمای مربعی عقب شیء، با آلفا یا بر زمینه سیاه. | IMAGE | اختیاری | N/A | +| `راست` | نمای مربعی راست شیء، با آلفا یا بر زمینه سیاه. | IMAGE | اختیاری | N/A | + +## خروجی‌ها + +| نام خروجی | توضیح | نوع داده | +|-------------|-------------|-----------| +| `مثبت` | خروجی تنظیمات مثبت برای گره تنظیمات چند视角 Pixal3D. | CONDITIONING | +| `منفی` | خروجی تنظیمات منفی برای گره تنظیمات چند视角 Pixal3D. | CONDITIONING | + +## یادداشت‌ها + +- پارامتر `fov` میدان دید افقی نماها به عنوان قاب را کنترل می‌کند. مقادیر 20 درجه برای رندرهای قابلیت چرخش و بیشتر تولیدکنندگان چند نمای متداول است. +- اولین نمای متصل شده (جلو، چپ، عقب، راست) به عنوان جلو در نظر گرفته می‌شود و شبکه به این نمای قرار داده می‌شود. +- اگر هیچ نمای جلو ارائه نشده باشد، یک هشدار ثبت می‌شود و شبکه با اولین نمای متصل شده به عنوان جلو قرار داده می‌شود. +- گره فرض می‌کند که نماها مربعی و مانند قاب هستند. شیء باید در پهنا بیش از 1/1.1 از قاب را اشغال کند و مقیاس مشابهی در هر نمای حفظ شود. +- گره دو شیء Conditioning تولید می‌کند، یکی برای تنظیمات مثبت و یکی برای تنظیمات منفی. این شیءها می‌توانند برای تنظیم مدل‌های Pixal3D یا گره‌هایی که ورودی Conditioning را می‌پذیرند، استفاده شوند. + +> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/fa.md) + +--- +**Source fingerprint (SHA-256):** `e6319ebd1a557dbb48269bab8a667e78e48f446d87fffbd9df4c4ebfb62b0fac` diff --git a/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/fr.md b/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/fr.md new file mode 100644 index 000000000..7436c7cc2 --- /dev/null +++ b/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/fr.md @@ -0,0 +1,36 @@ +# Pixal3DMultiViewConditioning + +## Aperçu + +Le nœud Pixal3D Multi-View Conditioning est un cadre d'orbitation fixe qui génère des vues avant, gauche, arrière et droite d'un objet à des intervalles de 90 degrés. Il est utilisé pour créer des vues encadrées pour les applications Pixal3D, où l'objet occupe environ 1/1.1 de la frame à son plus large, en maintenant la même échelle dans chaque vue. + +## Entrées + +| Paramètre | Description | Type de données | Obligatoire | Gamme | +|-----------|-------------|-----------|----------|-------| +| `clip_vision_model` | DINOv3 ViT-L/16 ClipVision avec des poids NAF inclus. | MODEL | Oui | N/A | +| `fov` | Champ de vision horizontal en degrés des vues encadrées. | FLOAT | Oui | 1.0 - 170.0 | +| `front` | Vue carrée du côté avant de l'objet, avec alpha ou sur un fond noir. | IMAGE | Oui | N/A | +| `left` | Vue carrée du côté gauche de l'objet, avec alpha ou sur un fond noir. | IMAGE | Facultatif | N/A | +| `back` | Vue carrée du côté arrière de l'objet, avec alpha ou sur un fond noir. | IMAGE | Facultatif | N/A | +| `right` | Vue carrée du côté droit de l'objet, avec alpha ou sur un fond noir. | IMAGE | Facultatif | N/A | + +## Sorties + +| Nom de sortie | Description | Type de données | +|-------------|-------------|-----------| +| `positive` | La sortie de conditionnement positive pour le nœud Pixal3D Multi-View Conditioning. | CONDITIONING | +| `negative` | La sortie de conditionnement négative pour le nœud Pixal3D Multi-View Conditioning. | CONDITIONING | + +## Notes + +- Le paramètre `fov` contrôle le champ de vision horizontal des vues encadrées. Une valeur de 20 degrés est typique pour les rendus de cadre et la plupart des générateurs de vue multi-vues. +- La première vue connectée (avant, gauche, arrière, droite dans cet ordre) est considérée comme la vue avant, et le maillage est posé pour cette vue. +- Si aucune vue avant n'est fournie, un avertissement est enregistré, et le maillage sera posé avec la première vue connectée comme sa vue avant. +- Le nœud suppose que les vues sont carrées et encadrées comme le cadre. L'objet devrait occuper environ 1/1.1 de la frame à son plus large, et la même échelle devrait être maintenue dans chaque vue. +- Le nœud produit deux objets de conditionnement, l'un pour le conditionnement positif et l'autre pour le conditionnement négatif. Ces derniers peuvent être utilisés pour conditionner des modèles Pixal3D ou d'autres nœuds qui acceptent des entrées de conditionnement. + +> 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/Pixal3DMultiViewConditioning/fr.md) + +--- +**Source fingerprint (SHA-256):** `e6319ebd1a557dbb48269bab8a667e78e48f446d87fffbd9df4c4ebfb62b0fac` diff --git a/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/ja.md b/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/ja.md new file mode 100644 index 000000000..7559d48e5 --- /dev/null +++ b/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/ja.md @@ -0,0 +1,36 @@ +# Pixal3DMultiViewConditioning + +## 概要 + +Pixal3D マルチビュー条件設定ノードは、物体の前、左、後、右のビューを90度間隔で生成する固定オーロラリグです。Pixal3Dアプリケーション用のフレームビューを作成するために使用され、物体がフレームの約1/1.1の幅で表示され、すべてのビューで同じスケールが維持されます。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|------------|------|----------|------|-------| +| `clip_vision_model` | DINOv3 ViT-L/16 ClipVision にバンドルされた NAF 重みを持つモデル。 | MODEL | はい | N/A | +| `fov` | フレーム内のビューの水平視野角(度)。 | FLOAT | はい | 1.0 - 170.0 | +| `front` | 物体の前側の正方形のビュー、アルファチャンネル付きまたは黒い背景上。 | IMAGE | はい | N/A | +| `left` | 物体の左側の正方形のビュー、アルファチャンネル付きまたは黒い背景上。 | IMAGE | オプション | N/A | +| `back` | 物体の後側の正方形のビュー、アルファチャンネル付きまたは黒い背景上。 | IMAGE | オプション | N/A | +| `right` | 物体の右側の正方形のビュー、アルファチャンネル付きまたは黒い背景上。 | IMAGE | オプション | N/A | + +## 出力 + +| 出力名 | 説明 | データ型 | +|--------|------|----------| +| `positive` | Pixal3D マルチビュー条件設定ノードのポジティブ条件設定出力。 | CONDITIONING | +| `negative` | Pixal3D マルチビュー条件設定ノードのネガティブ条件設定出力。 | CONDITIONING | + +## 注意事項 + +- `fov` パラメータは、フレーム内のビューの水平視野角を制御します。リグレンダリングやほとんどのマルチビューガジェネレータには20度が一般的です。 +- 初めて接続されたビュー(前、左、後、右の順序)が前と見なされ、メッシュはこのビューに合わせてポーズされます。 +- フロントビューが提供されていない場合、警告がログに記録され、メッシュは最初に接続されたビューを前としてポーズされます。 +- ノードはビューが正方形でリグのようにフレーム内に収まっていると仮定します。物体は最も幅広い場所でフレームの約1/1.1を占めるべきであり、すべてのビューで同じスケールが維持されるべきです。 +- ノードはポジティブおよびネガティブの条件設定オブジェクトの両方を出力します。これらはPixal3DモデルやConditioning入力を受け入れる他のノードに条件設定として使用できます。 + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/ja.md) + +--- +**Source fingerprint (SHA-256):** `e6319ebd1a557dbb48269bab8a667e78e48f446d87fffbd9df4c4ebfb62b0fac` diff --git a/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/ko.md b/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/ko.md new file mode 100644 index 000000000..d54f0e06d --- /dev/null +++ b/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/ko.md @@ -0,0 +1,36 @@ +# Pixal3DMultiViewConditioning + +## 개요 + +Pixal3D 다중 시점 조건 설정 노드는 90도 간격으로 대면, 좌면, 후면, 우면의 시점을 생성하는 고정된 공전 라이그입니다. 이 노드는 대상이 프레임의 약 1/1.1 정도로 걸쳐 있으며, 모든 시점에서 같은 크기를 유지하는 프레임 뷰를 생성하는 데 사용됩니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `clip_vision_model` | DINOv3 ViT-L/16 ClipVision과 함께 제공된 NAF 가중치를 포함한 모델. | MODEL | 예 | N/A | +| `fov` | 시점의 프레임에 맞춘 수평 FOV(각도). | FLOAT | 예 | 1.0 - 170.0 | +| `전면` | 대상의 전면을 보여주는 사각형 뷰, 알파나 검은 배경으로. | IMAGE | 예 | N/A | +| `왼쪽` | 대상의 좌면을 보여주는 사각형 뷰, 알파나 검은 배경으로. | IMAGE | 선택 | N/A | +| `후면` | 대상의 후면을 보여주는 사각형 뷰, 알파나 검은 배경으로. | IMAGE | 선택 | N/A | +| `오른쪽` | 대상의 우면을 보여주는 사각형 뷰, 알파나 검은 배경으로. | IMAGE | 선택 | N/A | + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `긍정` | Pixal3D 다중 시점 조건 설정 노드의 긍정 조건 설정 출력. | CONDITIONING | +| `부정` | Pixal3D 다중 시점 조건 설정 노드의 부정 조건 설정 출력. | CONDITIONING | + +## 주의사항 + +- `fov` 매개변수는 시점의 프레임에 맞춘 수평 시야각을 제어합니다. 20도의 값은 라이그 렌더링과 대부분의 다중 시점 생성기에 일반적입니다. +- 첫 번째 연결된 시점(대면, 좌면, 후면, 우면 순서)이 전면으로 간주되며, 메시는 이 시점에 맞춰됩니다. +- 대면 시점이 제공되지 않으면 경고가 로그에 기록되고, 메시는 첫 번째 연결된 시점을 전면으로 사용하여 맞춰집니다. +- 노드는 시점이 사각형이고 라이그와 같이 프레임에 맞춰져 있다고 가정합니다. 대상은 가장 넓은 부분에서 프레임의 약 1/1.1 정도로 걸쳐 있어야 하며, 모든 시점에서 같은 크기를 유지해야 합니다. +- 노드는 긍정 조건 설정과 부정 조건 설정을 각각 두 개의 조건 설정 객체로 출력합니다. 이들은 Pixal3D 모델이나 조건 설정 입력을 받는 다른 노드에 조건 설정으로 사용될 수 있습니다. + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/ko.md) + +--- +**Source fingerprint (SHA-256):** `e6319ebd1a557dbb48269bab8a667e78e48f446d87fffbd9df4c4ebfb62b0fac` diff --git a/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/pt-BR.md b/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/pt-BR.md new file mode 100644 index 000000000..7c1c0a653 --- /dev/null +++ b/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/pt-BR.md @@ -0,0 +1,36 @@ +# Pixal3DMultiViewConditioning + +## Visão Geral + +O nó Pixal3D Multi-View Conditioning é uma estrutura de órbita fixa que gera vistas frontal, esquerda, traseira e direita de um objeto em intervalos de 90 graus. Ele é usado para criar vistas em molduras para aplicações Pixal3D, onde o objeto ocupa aproximadamente 1/1.1 da moldura no seu ponto mais largo, mantendo a mesma escala em cada vista. + +## Entradas + +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | +|-----------|-------------|-----------|----------|-------| +| `clip_vision_model` | DINOv3 ViT-L/16 ClipVision com pesos NAF embutidos. | MODEL | Sim | N/A | +| `fov` | FOV horizontal em graus das vistas conforme molduradas. | FLOAT | Sim | 1.0 - 170.0 | +| `frente` | Vista quadrada do lado frontal do objeto, com alpha ou em fundo preto. | IMAGE | Sim | N/A | +| `esquerda` | Vista quadrada do lado esquerdo do objeto, com alpha ou em fundo preto. | IMAGE | Opcional | N/A | +| `trás` | Vista quadrada do lado traseiro do objeto, com alpha ou em fundo preto. | IMAGE | Opcional | N/A | +| `direita` | Vista quadrada do lado direito do objeto, com alpha ou em fundo preto. | IMAGE | Opcional | N/A | + +## Saídas + +| Nome da Saída | Descrição | Tipo de Dados | +|-------------|-------------|-----------| +| `positivo` | Saída de condicionamento positivo para o nó Pixal3D Multi-View Conditioning. | CONDITIONING | +| `negativo` | Saída de condicionamento negativo para o nó Pixal3D Multi-View Conditioning. | CONDITIONING | + +## Notas + +- O parâmetro `fov` controla o campo de visão horizontal das vistas conforme molduradas. Um valor de 20 graus é típico para renders de estruturas e a maioria dos geradores de multi-vistas. +- A primeira vista conectada (frontal, esquerda, traseira, direita na ordem) é considerada frontal, e a malha é posedada para essa vista. +- Se nenhuma vista frontal for fornecida, um aviso é registrado e a malha será posedada com a primeira vista conectada como sua frontal. +- O nó assume que as vistas são quadradas e molduradas como a estrutura. O objeto deve ocupar aproximadamente 1/1.1 da moldura no seu ponto mais largo, e a mesma escala deve ser mantida em cada vista. +- O nó gera dois objetos de Conditioning, um para o condicionamento positivo e outro para o negativo. Esses podem ser usados para condicionar modelos Pixal3D ou outros nós que aceitam entradas de Conditioning. + +> 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/Pixal3DMultiViewConditioning/pt-BR.md) + +--- +**Source fingerprint (SHA-256):** `e6319ebd1a557dbb48269bab8a667e78e48f446d87fffbd9df4c4ebfb62b0fac` diff --git a/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/ru.md b/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/ru.md new file mode 100644 index 000000000..7a02b3cbd --- /dev/null +++ b/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/ru.md @@ -0,0 +1,36 @@ +# Pixal3DMultiViewConditioning + +## Обзор + +Узел Pixal3D Multi-View Conditioning представляет собой стационарный риг, который генерирует передние, левые, задние и правые виды объекта с интервалом в 90 градусов. Он используется для создания рамочных видов для приложений Pixal3D, где объект занимает около 1/1.1 части кадра в самом широком месте, поддерживая одинаковый масштаб во всех видах. + +## Входы + +| Параметр | Описание | Тип данных | Обязателен | Диапазон | +|-----------|-------------|-----------|----------|-------| +| `clip_vision_model` | DINOv3 ViT-L/16 ClipVision с включенными весами NAF. | MODEL | Да | Н/Д | +| `fov` | Горизонтальный FOV в градусах для видов в рамке. | FLOAT | Да | 1.0 - 170.0 | +| `front` | Квадратный вид передней стороны объекта, с альфа-каналом или на черном фоне. | IMAGE | Да | Н/Д | +| `left` | Квадратный вид левой стороны объекта, с альфа-каналом или на черном фоне. | IMAGE | Опционально | Н/Д | +| `back` | Квадратный вид задней стороны объекта, с альфа-каналом или на черном фоне. | IMAGE | Опционально | Н/Д | +| `right` | Квадратный вид правой стороны объекта, с альфа-каналом или на черном фоне. | IMAGE | Опционально | Н/Д | + +## Выходы + +| Название выхода | Описание | Тип данных | +|-------------|-------------|-----------| +| `positive` | Положительное условие для узла Pixal3D Multi-View Conditioning. | CONDITIONING | +| `negative` | Отрицательное условие для узла Pixal3D Multi-View Conditioning. | CONDITIONING | + +## Примечания + +- Параметр `fov` контролирует горизонтальный угол поля зрения для видов в рамке. Значение 20 градусов типично для рендеров рига и большинства многоугольных генераторов. +- Первый подключенный вид (в порядке front, left, back, right) считается передним, и модель настроена для этого вида. +- Если передний вид не предоставлен, выводится предупреждение, и модель будет настроена с первым подключенным видом как его передним. +- Узел предполагает, что виды квадратные и рамочные, как риг. Объект должен занимать около 1/1.1 части кадра в самом широком месте, и одинаковый масштаб должен поддерживаться во всех видах. +- Узел выводит два объекта Условие, один для положительного и один для отрицательного условия. Эти объекты можно использовать для условия моделей Pixal3D или других узлов, принимающих входы Условие. + +> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/ru.md) + +--- +**Source fingerprint (SHA-256):** `e6319ebd1a557dbb48269bab8a667e78e48f446d87fffbd9df4c4ebfb62b0fac` diff --git a/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/tr.md b/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/tr.md new file mode 100644 index 000000000..e27f12376 --- /dev/null +++ b/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/tr.md @@ -0,0 +1,37 @@ +# Pixal3DMultiViewConditioning + +## Genel Bakış + +Pixal3D Çoklu Görüntüleme Koşullandırma düğümü, nesnenin ön, sol, arka ve sağ yanlarını 90 derecelik aralıklarla oluşturan sabit döngü aygıtıdır. Bu düğüm, nesnenin genişliğinin yaklaşık 1/1.1'ini kapsayan çerçeve içindeki çerçeve görünümleri oluşturmak için kullanılır ve her görüntüde aynı ölçekte kalır. + +## Girdiler + +| Parametre | Açıklama | Veri Türü | Gerekli | Aralık | +|-----------|-------------|-----------|----------|-------| +| `clip_vision_model` | DINOv3 ViT-L/16 ClipVision ile birlikte sunulan NAF ağırlıklarla birlikte gelen. | MODEL | Evet | N/A | +| `fov` | Görüntülerin çerçevede yer aldığı yatay FOV derecesi. | FLOAT | Evet | 1.0 - 170.0 | +| `front` | Nesnenin ön yüzünün kare görüntüsü, alfa ile veya siyah zemin üzerinde. | IMAGE | Evet | N/A | +| `left` | Nesnenin sol yüzünün kare görüntüsü, alfa ile veya siyah zemin üzerinde. | IMAGE | Seçimli | N/A | +| `back` | Nesnenin arka yüzünün kare görüntüsü, alfa ile veya siyah zemin üzerinde. | IMAGE | Seçimli | N/A | +| `right` | Nesnenin sağ yüzünün kare görüntüsü, alfa ile veya siyah zemin üzerinde. | IMAGE | Seçimli | N/A | + +## Çıktılar + +| Çıktı Adı | Açıklama | Veri Türü | +|-------------|-------------|-----------| +| `pozitif` | Pixal3D Çoklu Görüntüleme Koşullandırma düğümü için pozitif koşullandırma çıktısı. | CONDITIONING | +| `negatif` | Pixal3D Çoklu Görüntüleme Koşullandırma düğümü için negatif koşullandırma çıktısı. | CONDITIONING | + +## Notlar + +- `fov` parametresi, görüntülerin çerçevede yer aldığı yatay FOV derecesini kontrol eder. 20 derecelik bir değer, aygıt renderları ve çoğu çoklu görüntüleme oluşturucu için tipik bir değerdir. +- İlk bağlanan görüntü (ön, sol, arka, sağ sırası) ön olarak kabul edilir ve mesh bu görüntüye pozlandırılır. +- Ön görüntü sağlanmadığında, bir uyarı kaydedilir ve mesh ilk bağlanan görüntü olarak pozlandırılır. +- Bu düğüm, görüntülerin kare ve aygıt gibi çerçevelenmiş olduğunu varsayar. Nesnenin genişliğinin yaklaşık 1/1.1'ini kapsaması ve her görüntüde aynı ölçekte kalması gerekmektedir. +- Bu düğüm, pozitif ve negatif koşullandırma için iki Koşullandırma nesnesi çıktırır. Bu nesneler, Pixal3D modelleri veya Koşullandırma girdilerini kabul eden diğer düğümler için kullanılabilir. +``` + +> 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/Pixal3DMultiViewConditioning/tr.md) + +--- +**Source fingerprint (SHA-256):** `e6319ebd1a557dbb48269bab8a667e78e48f446d87fffbd9df4c4ebfb62b0fac` diff --git a/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/zh-TW.md b/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/zh-TW.md new file mode 100644 index 000000000..262254643 --- /dev/null +++ b/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/zh-TW.md @@ -0,0 +1,36 @@ +# Pixal3DMultiViewConditioning + +## 概述 + +Pixal3D 多視角條件設定節點是一個固定軌道裝置,以90度間隔生成物體的前視、左視、後視和右視。它用於為 Pixal3D 應用程序創建框選視角,其中物體在其最寬處佔據約 1/1.1 的畫面,並在每個視角中保持相同的比例。 + +## 輸入 + +| 參數 | 描述 | 資料類型 | 必需 | 范圍 | +|-----------|-------------|-----------|----------|-------| +| `clip_vision_model` | DINOv3 ViT-L/16 ClipVision 配備內置的 NAF 重量。 | MODEL | 是 | N/A | +| `視野角` | 视角框選中的水平視野角(度)。 | FLOAT | 是 | 1.0 - 170.0 | +| `前方` | 物體前側的方形視圖,帶有 alpha 通道或黑色背景。 | IMAGE | 是 | N/A | +| `左側` | 物體左側的方形視圖,帶有 alpha 通道或黑色背景。 | IMAGE | 選擇性 | N/A | +| `後方` | 物體後側的方形視圖,帶有 alpha 通道或黑色背景。 | IMAGE | 選擇性 | N/A | +| `右側` | 物體右側的方形視圖,帶有 alpha 通道或黑色背景。 | IMAGE | 選擇性 | N/A | + +## 輸出 + +| 輸出名 | 描述 | 資料類型 | +|-------------|-------------|-----------| +| `正向` | Pixal3D 多視角條件設定節點的正向條件輸出。 | CONDITIONING | +| `負向` | Pixal3D 多視角條件設定節點的負向條件輸出。 | CONDITIONING | + +## 記錄 + +- `fov` 參數控制視角框選中的視野角。對於裝置渲染和大多數多視角生成器,20 度的值是典型的。 +- 第一個連接的視角(前、左、後、右的順序)被視為前視,並將網格設定為此視角。 +- 如果沒有提供前視,將記錄警告,並將網格設定為第一個連接的視角作為其前視。 +- 節點假設視角是方形的,並像裝置一樣框選。物體在其最寬處應該佔據約 1/1.1 的畫面,並在每個視角中保持相同的比例。 +- 節點輸出兩個 CONDITIONING 對象,一個用於正向條件,一個用於負向條件。這些可以用於條件化 Pixal3D 模型或其他接受 CONDITIONING 輸入的節點。 + +> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/zh-TW.md) + +--- +**Source fingerprint (SHA-256):** `e6319ebd1a557dbb48269bab8a667e78e48f446d87fffbd9df4c4ebfb62b0fac` diff --git a/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/zh.md b/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/zh.md new file mode 100644 index 000000000..bfd7e75c5 --- /dev/null +++ b/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/zh.md @@ -0,0 +1,36 @@ +# Pixal3DMultiViewConditioning + +## 概述 + +Pixal3D 多视图条件节点是一个固定轨道装置,以90度间隔生成物体的前视图、左视图、后视图和右视图。它用于创建适用于Pixal3D应用的框架视图,其中物体在其最宽处占据大约1/1.1的框架宽度,并在每个视图中保持相同的比例。 + +## 输入 + +| 参数 | 描述 | 数据类型 | 必需 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `clip_vision_model` | 带有捆绑NAF权重的DINOv3 ViT-L/16 ClipVision模型。 | MODEL | 是 | N/A | +| `fov` | 视图的水平视野,单位为度。 | FLOAT | 是 | 1.0 - 170.0 | +| `前` | 物体前侧的方形视图,带有透明度或黑色背景。 | IMAGE | 是 | N/A | +| `左` | 物体左侧的方形视图,带有透明度或黑色背景。 | IMAGE | 可选 | N/A | +| `后` | 物体后侧的方形视图,带有透明度或黑色背景。 | IMAGE | 可选 | N/A | +| `右` | 物体右侧的方形视图,带有透明度或黑色背景。 | IMAGE | 可选 | N/A | + +## 输出 + +| 输出名称 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `正向` | Pixal3D 多视图条件节点的正条件输出。 | CONDITIONING | +| `负向` | Pixal3D 多视图条件节点的负条件输出。 | CONDITIONING | + +## 注意事项 + +- `fov` 参数控制视图的框架水平视野。对于装置渲染和大多数多视图生成器,20度的值是典型的。 +- 首个连接的视图(前、左、后、右顺序)被认为是前视图,网格姿态设置为该视图。 +- 如果没有提供前视图,将记录警告,网格姿态将使用第一个连接的视图作为其前视图。 +- 节点假定视图是方形且与装置一样框架化。物体在其最宽处应占据大约1/1.1的框架宽度,并且每个视图中应保持相同的比例。 +- 节点输出两个条件对象,一个用于正条件,一个用于负条件。这些可以用于条件Pixal3D模型或其他接受条件输入的节点。 + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Pixal3DMultiViewConditioning/zh.md) + +--- +**Source fingerprint (SHA-256):** `e6319ebd1a557dbb48269bab8a667e78e48f446d87fffbd9df4c4ebfb62b0fac` diff --git a/comfyui_embedded_docs/docs/Preview3DAdvanced/ar.md b/comfyui_embedded_docs/docs/Preview3DAdvanced/ar.md index 25fd34f81..4129c731a 100644 --- a/comfyui_embedded_docs/docs/Preview3DAdvanced/ar.md +++ b/comfyui_embedded_docs/docs/Preview3DAdvanced/ar.md @@ -1,31 +1,31 @@ # معاينة ثلاثية الأبعاد (متقدم) -يعرض هذا العقد معاينة نموذج ثلاثي الأبعاد في واجهة المستخدم دون حفظ الملف في دليل مخرجات ComfyUI. يحفظ النموذج في ملف مؤقت ويمرر بيانات النموذج، ومعلومات النموذج، ومعلومات الكاميرا، وأبعاد المعاينة لمواصلة المعالجة في المراحل اللاحقة. +يعرض هذا العقدة معاينة النموذج ثلاثي الأبعاد في واجهة المستخدم دون حفظ الملف في دليل مخرجات ComfyUI. ويكون النموذج محفوظًا في ملف مؤقت، مع تمرير بيانات النموذج ومعلومات النموذج ومعلومات الكاميرا وأبعاد المعاينة لمزيد من المعالجة في المراحل اللاحقة. ## المدخلات | المعامل | الوصف | نوع البيانات | مطلوب | النطاق | -|-----------|-------------|-----------|----------|-------| -| `نموذج ثلاثي الأبعاد` | ملف نموذج ثلاثي الأبعاد من عقدة ثلاثية الأبعاد سابقة في سلسلة المعالجة. | FILE3D | نعم | GLB، GLTF، FBX، OBJ، STL، USDZ، أو أي صيغة ثلاثية الأبعاد مدعومة | -| `model_3d_info` | بيانات وصفية اختيارية لمعلومات النموذج. خيار متقدم. | LOAD3DMODELINFO | لا | - | +|---------|--------|---------------|-------|--------| +| `نموذج ثلاثي الأبعاد` | ملف النموذج ثلاثي الأبعاد من عقدة ثلاثية الأبعاد سابقة في سلسلة المعالجة. | FILE3D | نعم | GLB, GLTF, FBX, OBJ, STL, USDZ, or any supported 3D format | +| `model_3d_info` | موضع كل نموذج في المشهد: الموضع والدوران والقياس (باستخدام نظام إحداثيات عالمي بمحور Y للأعلى). اختياري. خيار متقدم. | LOAD3DMODELINFO | لا | - | | `حالة نافذة العرض` | حالة منفذ العرض الحالية التي تحتوي على معلومات الكاميرا والنموذج. | LOAD3D | نعم | - | -| `camera_info` | إعدادات كاميرا اختيارية للعرض ثلاثي الأبعاد. خيار متقدم. | LOAD3DCAMERA | لا | - | -| `width` | عرض المعاينة بالبكسل. الافتراضي: 1024. | INT | نعم | 1 إلى 4096 | -| `height` | ارتفاع المعاينة بالبكسل. الافتراضي: 1024. | INT | نعم | 1 إلى 4096 | +| `camera_info` | معلومات كاميرا منفذ العرض: الموضع ونقطة التصويب والتكبير والنوع. اختياري. خيار متقدم. | LOAD3DCAMERA | لا | - | +| `width` | عرض الصورة المقدَّمة في منفذ العرض بالبكسل. الافتراضي: 1024. | INT | نعم | 1 إلى 4096 | +| `height` | ارتفاع الصورة المقدَّمة في منفذ العرض بالبكسل. الافتراضي: 1024. | INT | نعم | 1 إلى 4096 | -ملاحظة: عندما لا تكون `camera_info` أو `model_3d_info` متصلتين، تُؤخذ قيمهما من `viewport_state` إذا كان متاحًا. إذا كان `viewport_state` لا يحتوي على معلومات كاميرا، فإن `camera_info` تكون None. إذا لم يتضمن `viewport_state` معلومات نموذج، فإن `model_3d_info` تلقائيًا تكون قائمة فارغة. إذا لم يكن `viewport_state` قاموسًا، يُتعامل معه باعتباره فارغًا. +ملاحظة: عندما لا تكون `camera_info` أو `model_3d_info` متصلتين، تُؤخذ قيمهما من `viewport_state` عندما يكون متاحًا. إذا كان `viewport_state` لا يحتوي على معلومات كاميرا، تكون `camera_info` فارغة (None). إذا لم تكن لديه معلومات نموذج، تكون `model_3d_info` قائمة فارغة. إذا لم يكن `viewport_state` قاموسًا، فيُتعامل معه كقيمة فارغة. ## المخرجات -| اسم المخرجات | الوصف | نوع البيانات | -|-------------|-------------|-----------| -| `model_file` | ملف النموذج ثلاثي الأبعاد الذي تم تمريره من المدخلات. | FILE3D | -| `camera_info` | بيانات وصفية لمعلومات النموذج، إما من المدخلات أو من حالة منفذ العرض. | LOAD3DMODELINFO | -| `model_3d_info` | إعدادات الكاميرا، إما من المدخلات أو من حالة منفذ العرض. | LOAD3DCAMERA | -| `width` | عرض المعاينة بالبكسل. | INT | -| `height` | ارتفاع المعاينة بالبكسل. | INT | +| اسم المخرج | الوصف | نوع البيانات | +|-------------|--------|--------------| +| `model_file` | ملف النموذج ثلاثي الأبعاد (glb/obj/stl/...) من عقدة ثلاثية الأبعاد سابقة، يتم تمريره دون تغيير. | FILE3D | +| `camera_info` | موضع كل نموذج في المشهد: الموضع والدوران والقياس (باستخدام نظام إحداثيات عالمي بمحور Y للأعلى). يستخدم قيمة الإدخال، أو يعتمد بديلاً على القيمة المخزنة في `viewport_state`. | LOAD3DMODELINFO | +| `model_3d_info` | معلومات كاميرا منفذ العرض: الموضع ونقطة التصويب والتكبير والنوع. يستخدم قيمة الإدخال، أو يعتمد بديلاً على القيمة المخزنة في `viewport_state`. | LOAD3DCAMERA | +| `width` | عرض الصورة المقدَّمة في منفذ العرض بالبكسل. | INT | +| `height` | ارتفاع الصورة المقدَّمة في منفذ العرض بالبكسل. | INT | > تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Preview3DAdvanced/ar.md) --- -**Source fingerprint (SHA-256):** `46c14d6242cbcabd457e13ae193427bb4c1fed55e81e568d50719fff0f1a95a0` +**Source fingerprint (SHA-256):** `f2d3d35ed35fe68edebcde8fd8421d26850b04e3ae5b7147f1020c8ed904c480` diff --git a/comfyui_embedded_docs/docs/Preview3DAdvanced/en.md b/comfyui_embedded_docs/docs/Preview3DAdvanced/en.md index ee2208f44..33c1e4741 100644 --- a/comfyui_embedded_docs/docs/Preview3DAdvanced/en.md +++ b/comfyui_embedded_docs/docs/Preview3DAdvanced/en.md @@ -7,11 +7,11 @@ This node displays a 3D model preview in the UI without saving the file to the C | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| | `model_3d` | 3D model file from an upstream 3D node. | FILE3D | Yes | GLB, GLTF, FBX, OBJ, STL, USDZ, or any supported 3D format | -| `model_3d_info` | Optional model information metadata. Advanced option. | LOAD3DMODELINFO | No | - | +| `model_3d_info` | Placement of each model in the scene: position, rotation, and scale (Y-up world space). Optional. Advanced option. | LOAD3DMODELINFO | No | - | | `viewport_state` | The current viewport state containing camera and model information. | LOAD3D | Yes | - | -| `camera_info` | Optional camera configuration for the 3D view. Advanced option. | LOAD3DCAMERA | No | - | -| `width` | The width of the preview in pixels. Default: 1024. | INT | Yes | 1 to 4096 | -| `height` | The height of the preview in pixels. Default: 1024. | INT | Yes | 1 to 4096 | +| `camera_info` | Viewport camera information: position, look-at target, zoom, and type. Optional. Advanced option. | LOAD3DCAMERA | No | - | +| `width` | Render width of the viewport in pixels. Default: 1024. | INT | Yes | 1 to 4096 | +| `height` | Render height of the viewport in pixels. Default: 1024. | INT | Yes | 1 to 4096 | Note: When `camera_info` or `model_3d_info` are not connected, their values are taken from `viewport_state` when available. If `viewport_state` contains no camera information, `camera_info` is None. If `viewport_state` has no model information, `model_3d_info` defaults to an empty list. If `viewport_state` is not a dictionary, it is treated as empty. @@ -19,13 +19,13 @@ Note: When `camera_info` or `model_3d_info` are not connected, their values are | Output Name | Description | Data Type | |-------------|-------------|-----------| -| `model_3d` | The 3D model file passed through from the input. | FILE3D | -| `model_3d_info` | Model information metadata, either from the input or from the viewport state. | LOAD3DMODELINFO | -| `camera_info` | Camera configuration, either from the input or from the viewport state. | LOAD3DCAMERA | -| `width` | The width of the preview in pixels. | INT | -| `height` | The height of the preview in pixels. | INT | +| `model_3d` | 3D model file (glb/obj/stl/etc.) from an upstream 3D node, passed through unchanged. | FILE3D | +| `model_3d_info` | Placement of each model in the scene: position, rotation, and scale (Y-up world space). Uses the input value, or falls back to the value stored in `viewport_state`. | LOAD3DMODELINFO | +| `camera_info` | Viewport camera information: position, look-at target, zoom, and type. Uses the input value, or falls back to the value stored in `viewport_state`. | LOAD3DCAMERA | +| `width` | Render width of the viewport in pixels. | INT | +| `height` | Render height of the viewport in pixels. | 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/Preview3DAdvanced/en.md) --- -**Source fingerprint (SHA-256):** `46c14d6242cbcabd457e13ae193427bb4c1fed55e81e568d50719fff0f1a95a0` +**Source fingerprint (SHA-256):** `f2d3d35ed35fe68edebcde8fd8421d26850b04e3ae5b7147f1020c8ed904c480` diff --git a/comfyui_embedded_docs/docs/Preview3DAdvanced/es.md b/comfyui_embedded_docs/docs/Preview3DAdvanced/es.md index 53eedcd72..3c2564645 100644 --- a/comfyui_embedded_docs/docs/Preview3DAdvanced/es.md +++ b/comfyui_embedded_docs/docs/Preview3DAdvanced/es.md @@ -1,31 +1,31 @@ # Vista previa 3D (Avanzado) -Este nodo muestra una vista previa 3D del modelo en la interfaz sin guardar el archivo en el directorio de salida de ComfyUI. Guarda el modelo en un archivo temporal y transmite los datos del modelo, la información del modelo, la información de la cámara y las dimensiones de la vista previa para su posterior procesamiento en el flujo de trabajo. +Este nodo muestra una vista previa del modelo 3D en la interfaz de usuario sin guardar el archivo en el directorio de salida de ComfyUI. Guarda el modelo en un archivo temporal y transmite los datos del modelo, la información del modelo, la información de la cámara y las dimensiones de la vista previa para su posterior procesamiento en el flujo. ## Entradas -| Parámetro | Descripción | Tipo de datos | Requerido | Rango | -|-----------|-------------|---------------|-----------|-------| -| `model_3d` | Archivo de modelo 3D proveniente de un nodo 3D anterior. | FILE3D | Sí | GLB, GLTF, FBX, OBJ, STL, USDZ o cualquier formato 3D compatible | -| `info_modelo_3d` | Metadatos opcionales de información del modelo. Opción avanzada. | LOAD3DMODELINFO | No | - | -| `viewport_state` | El estado actual de la vista que contiene información de la cámara y del modelo. | LOAD3D | Sí | - | -| `info_cámara` | Configuración opcional de cámara para la vista 3D. Opción avanzada. | LOAD3DCAMERA | No | - | -| `ancho` | El ancho de la vista previa en píxeles. Valor predeterminado: 1024. | INT | Sí | 1 a 4096 | -| `alto` | La altura de la vista previa en píxeles. Valor predeterminado: 1024. | INT | Sí | 1 a 4096 | +| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango | +|-----------|-------------|-----------|----------|-------| +| `model_3d` | Archivo de modelo 3D procedente de un nodo 3D anterior. | FILE3D | Sí | GLB, GLTF, FBX, OBJ, STL, USDZ o cualquier formato 3D compatible | +| `info_modelo_3d` | Ubicación de cada modelo en la escena: posición, rotación y escala (espacio mundial con eje Y hacia arriba). Opcional. Opción avanzada. | LOAD3DMODELINFO | No | - | +| `viewport_state` | Estado actual del viewport que contiene la información de la cámara y del modelo. | LOAD3D | Sí | - | +| `info_cámara` | Información de la cámara del viewport: posición, punto de mira, zoom y tipo. Opcional. Opción avanzada. | LOAD3DCAMERA | No | - | +| `ancho` | Ancho de renderizado del viewport en píxeles. Valor predeterminado: 1024. | INT | Sí | 1 a 4096 | +| `alto` | Altura de renderizado del viewport en píxeles. Valor predeterminado: 1024. | INT | Sí | 1 a 4096 | -Nota: cuando `camera_info` o `model_3d_info` no están conectados, sus valores se toman de `viewport_state` cuando estén disponibles. Si `viewport_state` no contiene información de cámara, `camera_info` es None. Si `viewport_state` no tiene información del modelo, `model_3d_info` se establece por defecto en una lista vacía. Si `viewport_state` no es un diccionario, se trata como vacío. +Nota: cuando `camera_info` o `model_3d_info` no están conectados, sus valores se toman de `viewport_state` cuando estén disponibles. Si `viewport_state` no contiene información de cámara, `camera_info` es None. Si `viewport_state` no tiene información de modelo, `model_3d_info` se define como una lista vacía por defecto. Si `viewport_state` no es un diccionario, se trata como vacío. ## Salidas | Nombre de salida | Descripción | Tipo de datos | -|------------------|-------------|---------------| -| `archivo_modelo` | El archivo de modelo 3D transmitido desde la entrada. | FILE3D | -| `info_cámara` | Metadatos de información del modelo, ya sea desde la entrada o desde el estado de la vista. | LOAD3DMODELINFO | -| `info_modelo_3d` | Configuración de cámara, ya sea desde la entrada o desde el estado de la vista. | LOAD3DCAMERA | -| `ancho` | El ancho de la vista previa en píxeles. | INT | -| `alto` | La altura de la vista previa en píxeles. | INT | +|-------------|-------------|-----------| +| `archivo_modelo` | Archivo de modelo 3D (glb/obj/stl/etc.) procedente de un nodo 3D anterior, transmitido sin cambios. | FILE3D | +| `info_cámara` | Ubicación de cada modelo en la escena: posición, rotación y escala (espacio mundial con eje Y hacia arriba). Utiliza el valor de entrada o recurre al valor almacenado en `viewport_state`. | LOAD3DMODELINFO | +| `info_modelo_3d` | Información de la cámara del viewport: posición, punto de mira, zoom y tipo. Utiliza el valor de entrada o recurre al valor almacenado en `viewport_state`. | LOAD3DCAMERA | +| `ancho` | Ancho de renderizado del viewport en píxeles. | INT | +| `alto` | Altura de renderizado del viewport en píxeles. | INT | > 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/Preview3DAdvanced/es.md) --- -**Source fingerprint (SHA-256):** `46c14d6242cbcabd457e13ae193427bb4c1fed55e81e568d50719fff0f1a95a0` +**Source fingerprint (SHA-256):** `f2d3d35ed35fe68edebcde8fd8421d26850b04e3ae5b7147f1020c8ed904c480` diff --git a/comfyui_embedded_docs/docs/Preview3DAdvanced/fa.md b/comfyui_embedded_docs/docs/Preview3DAdvanced/fa.md index 952b7a855..506a3f776 100644 --- a/comfyui_embedded_docs/docs/Preview3DAdvanced/fa.md +++ b/comfyui_embedded_docs/docs/Preview3DAdvanced/fa.md @@ -1,31 +1,31 @@ # پیش‌نمایش سه‌بعدی (پیشرفته) -این گره یک پیش‌نمایش مدل سه‌بعدی را در رابط کاربری نمایش می‌دهد بدون اینکه فایل را در پوشه خروجی ComfyUI ذخیره کند. مدل را در یک فایل موقت ذخیره می‌کند و داده‌های مدل، اطلاعات مدل، اطلاعات دوربین و ابعاد پیش‌نمایش را برای پردازش‌های بعدی عبور می‌دهد. +این گره پیش‌نمایش یک مدل سه‌بعدی را در رابط کاربری نمایش می‌دهد، بدون اینکه فایل را در پوشه خروجی ComfyUI ذخیره کند. مدل را در یک فایل موقت ذخیره می‌کند و داده‌های مدل، اطلاعات مدل، اطلاعات دوربین و ابعاد پیش‌نمایش را برای پردازش بیشتر در ادامه مسیر عبور می‌دهد. ## ورودی‌ها -| Parameter | Description | Data Type | Required | Range | +| پارامتر | توضیحات | نوع داده | الزامی | بازه | |-----------|-------------|-----------|----------|-------| -| `مدل ۳بعدی` | فایل مدل سه‌بعدی از یک گره سه‌بعدی بالادستی. | FILE3D | بله | GLB, GLTF, FBX, OBJ, STL, USDZ، یا هر فرمت سه‌بعدی پشتیبانی‌شده دیگر | -| `اطلاعات مدل سه‌بعدی` | فراداده‌های اطلاعات مدل اختیاری. گزینه پیشرفته. | LOAD3DMODELINFO | خیر | - | -| `وضعیت نمای دید` | وضعیت فعلی viewport که شامل اطلاعات دوربین و مدل است. | LOAD3D | بله | - | -| `اطلاعات دوربین` | پیکربندی اختیاری دوربین برای نمای سه‌بعدی. گزینه پیشرفته. | LOAD3DCAMERA | خیر | - | -| `عرض` | عرض پیش‌نمایش بر حسب پیکسل. پیش‌فرض: 1024. | INT | بله | 1 تا 4096 | -| `ارتفاع` | ارتفاع پیش‌نمایش بر حسب پیکسل. پیش‌فرض: 1024. | INT | بله | 1 تا 4096 | +| `مدل ۳بعدی` | فایل مدل سه‌بعدی از یک گره سه‌بعدی بالادستی. | FILE3D | بله | GLB، GLTF، FBX، OBJ، STL، USDZ یا هر قالب سه‌بعدی پشتیبانی‌شده | +| `اطلاعات مدل سه‌بعدی` | جای‌گیری هر مدل در صحنه: موقعیت، چرخش و مقیاس (فضای جهانی با محور Y رو به بالا). اختیاری. گزینه پیشرفته. | LOAD3DMODELINFO | خیر | - | +| `وضعیت نمای دید` | وضعیت فعلی viewport شامل اطلاعات دوربین و مدل. | LOAD3D | بله | - | +| `اطلاعات دوربین` | اطلاعات دوربین viewport: موقعیت، هدف نگاه، بزرگ‌نمایی و نوع. اختیاری. گزینه پیشرفته. | LOAD3DCAMERA | خیر | - | +| `عرض` | عرض رندر viewport بر حسب پیکسل. پیش‌فرض: 1024. | INT | بله | 1 تا 4096 | +| `ارتفاع` | ارتفاع رندر viewport بر حسب پیکسل. پیش‌فرض: 1024. | INT | بله | 1 تا 4096 | -نکته: زمانی که `camera_info` یا `model_3d_info` متصل نیستند، مقادیر آن‌ها در صورت موجود بودن از `viewport_state` گرفته می‌شود. اگر `viewport_state` حاوی اطلاعات دوربین نباشد، `camera_info` برابر None است. اگر `viewport_state` اطلاعات مدل نداشته باشد، `model_3d_info` به صورت پیش‌فرض یک لیست خالی در نظر گرفته می‌شود. اگر `viewport_state` یک دیکشنری نباشد، به عنوان خالی در نظر گرفته می‌شود. +توجه: هنگامی که `camera_info` یا `model_3d_info` متصل نیستند، مقادیر آن‌ها در صورت موجود بودن از `viewport_state` گرفته می‌شود. اگر `viewport_state` هیچ اطلاعات دوربینی نداشته باشد، `camera_info` برابر None است. اگر `viewport_state` اطلاعات مدل نداشته باشد، `model_3d_info` به‌صورت پیش‌فرض یک لیست خالی می‌شود. اگر `viewport_state` یک دیکشنری نباشد، به‌عنوان خالی در نظر گرفته می‌شود. ## خروجی‌ها -| Output Name | Description | Data Type | +| نام خروجی | توضیحات | نوع داده | |-------------|-------------|-----------| -| `فایل مدل` | فایل مدل سه‌بعدی عبور داده‌شده از ورودی. | FILE3D | -| `اطلاعات دوربین` | فراداده‌های اطلاعات مدل، είτε از ورودی یا از وضعیت viewport. | LOAD3DMODELINFO | -| `اطلاعات مدل سه‌بعدی` | پیکربندی دوربین، είτε از ورودی یا از وضعیت viewport. | LOAD3DCAMERA | -| `عرض` | عرض پیش‌نمایش بر حسب پیکسل. | INT | -| `ارتفاع` | ارتفاع پیش‌نمایش بر حسب پیکسل. | INT | +| `فایل مدل` | فایل مدل سه‌بعدی (glb/obj/stl/etc.) از یک گره سه‌بعدی بالادستی، بدون تغییر عبور داده می‌شود. | FILE3D | +| `اطلاعات دوربین` | جای‌گیری هر مدل در صحنه: موقعیت، چرخش و مقیاس (فضای جهانی با محور Y رو به بالا). از مقدار ورودی استفاده می‌کند، یا در غیر این صورت از مقدار ذخیره‌شده در `viewport_state` استفاده می‌کند. | LOAD3DMODELINFO | +| `اطلاعات مدل سه‌بعدی` | اطلاعات دوربین viewport: موقعیت، هدف نگاه، بزرگ‌نمایی و نوع. از مقدار ورودی استفاده می‌کند، یا در غیر این صورت از مقدار ذخیره‌شده در `viewport_state` استفاده می‌کند. | LOAD3DCAMERA | +| `عرض` | عرض رندر viewport بر حسب پیکسل. | INT | +| `ارتفاع` | ارتفاع رندر viewport بر حسب پیکسل. | INT | > این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Preview3DAdvanced/fa.md) --- -**Source fingerprint (SHA-256):** `46c14d6242cbcabd457e13ae193427bb4c1fed55e81e568d50719fff0f1a95a0` +**Source fingerprint (SHA-256):** `f2d3d35ed35fe68edebcde8fd8421d26850b04e3ae5b7147f1020c8ed904c480` diff --git a/comfyui_embedded_docs/docs/Preview3DAdvanced/fr.md b/comfyui_embedded_docs/docs/Preview3DAdvanced/fr.md index 9cabd7ff1..b98bcc04e 100644 --- a/comfyui_embedded_docs/docs/Preview3DAdvanced/fr.md +++ b/comfyui_embedded_docs/docs/Preview3DAdvanced/fr.md @@ -1,31 +1,31 @@ # Aperçu 3D (Avancé) -Ce nœud affiche un aperçu d’un modèle 3D dans l’interface sans enregistrer le fichier dans le répertoire de sortie de ComfyUI. Il enregistre le modèle dans un fichier temporaire et transmet les données du modèle, les informations du modèle, les informations de caméra et les dimensions de l’aperçu pour un traitement ultérieur en aval. +Ce nœud affiche un aperçu du modèle 3D dans l’interface sans enregistrer le fichier dans le répertoire de sortie de ComfyUI. Il enregistre le modèle dans un fichier temporaire et transmet les données du modèle, les informations du modèle, les informations de caméra et les dimensions d’aperçu pour un traitement ultérieur en aval. ## Entrées | Paramètre | Description | Type de données | Requis | Plage | -|-----------|-------------|-----------------|--------|-------| +|-----------|-------------|-----------|----------|-------| | `modèle 3D` | Fichier de modèle 3D provenant d’un nœud 3D en amont. | FILE3D | Oui | GLB, GLTF, FBX, OBJ, STL, USDZ, ou tout format 3D pris en charge | -| `infos_modèle_3d` | Métadonnées optionnelles d’informations sur le modèle. Option avancée. | LOAD3DMODELINFO | Non | - | +| `infos_modèle_3d` | Placement de chaque modèle dans la scène : position, rotation et échelle (espace monde avec Y vers le haut). Facultatif. Option avancée. | LOAD3DMODELINFO | Non | - | | `état de la vue` | État actuel de la fenêtre d’affichage contenant les informations de caméra et de modèle. | LOAD3D | Oui | - | -| `infos_caméra` | Configuration optionnelle de la caméra pour la vue 3D. Option avancée. | LOAD3DCAMERA | Non | - | -| `largeur` | Largeur de l’aperçu en pixels. Par défaut : 1024. | INT | Oui | 1 à 4096 | -| `hauteur` | Hauteur de l’aperçu en pixels. Par défaut : 1024. | INT | Oui | 1 à 4096 | +| `infos_caméra` | Informations de caméra de la fenêtre d’affichage : position, cible du regard, zoom et type. Facultatif. Option avancée. | LOAD3DCAMERA | Non | - | +| `largeur` | Largeur de rendu de la fenêtre d’affichage en pixels. Par défaut : 1024. | INT | Oui | 1 à 4096 | +| `hauteur` | Hauteur de rendu de la fenêtre d’affichage en pixels. Par défaut : 1024. | INT | Oui | 1 à 4096 | -Remarque : Lorsque `camera_info` ou `model_3d_info` ne sont pas connectés, leurs valeurs sont extraites de `viewport_state` lorsqu’elles sont disponibles. Si `viewport_state` ne contient aucune information de caméra, `camera_info` est None. Si `viewport_state` ne contient aucune information de modèle, `model_3d_info` est défini par défaut sur une liste vide. Si `viewport_state` n’est pas un dictionnaire, il est traité comme vide. +Remarque : lorsque `camera_info` ou `model_3d_info` ne sont pas connectés, leurs valeurs sont reprises depuis `viewport_state` lorsqu’elles sont disponibles. Si `viewport_state` ne contient aucune information de caméra, `camera_info` est None. Si `viewport_state` ne contient aucune information de modèle, `model_3d_info` prend par défaut une liste vide. Si `viewport_state` n’est pas un dictionnaire, il est traité comme vide. ## Sorties | Nom de sortie | Description | Type de données | -|---------------|-------------|-----------------| -| `fichier_modèle` | Le fichier de modèle 3D transmis depuis l’entrée. | FILE3D | -| `infos_caméra` | Métadonnées d’informations sur le modèle, provenant de l’entrée ou de l’état de la fenêtre d’affichage. | LOAD3DMODELINFO | -| `infos_modèle_3d` | Configuration de la caméra, provenant de l’entrée ou de l’état de la fenêtre d’affichage. | LOAD3DCAMERA | -| `largeur` | Largeur de l’aperçu en pixels. | INT | -| `hauteur` | Hauteur de l’aperçu en pixels. | INT | +|-------------|-------------|-----------| +| `fichier_modèle` | Fichier de modèle 3D (glb/obj/stl/etc.) provenant d’un nœud 3D en amont, transmis tel quel. | FILE3D | +| `infos_caméra` | Placement de chaque modèle dans la scène : position, rotation et échelle (espace monde avec Y vers le haut). Utilise la valeur d’entrée ou, à défaut, la valeur stockée dans `viewport_state`. | LOAD3DMODELINFO | +| `infos_modèle_3d` | Informations de caméra de la fenêtre d’affichage : position, cible du regard, zoom et type. Utilise la valeur d’entrée ou, à défaut, la valeur stockée dans `viewport_state`. | LOAD3DCAMERA | +| `largeur` | Largeur de rendu de la fenêtre d’affichage en pixels. | INT | +| `hauteur` | Hauteur de rendu de la fenêtre d’affichage en pixels. | INT | > 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/Preview3DAdvanced/fr.md) --- -**Source fingerprint (SHA-256):** `46c14d6242cbcabd457e13ae193427bb4c1fed55e81e568d50719fff0f1a95a0` +**Source fingerprint (SHA-256):** `f2d3d35ed35fe68edebcde8fd8421d26850b04e3ae5b7147f1020c8ed904c480` diff --git a/comfyui_embedded_docs/docs/Preview3DAdvanced/ja.md b/comfyui_embedded_docs/docs/Preview3DAdvanced/ja.md index 40fccd262..79f454305 100644 --- a/comfyui_embedded_docs/docs/Preview3DAdvanced/ja.md +++ b/comfyui_embedded_docs/docs/Preview3DAdvanced/ja.md @@ -1,31 +1,31 @@ # 3Dプレビュー(詳細) -このノードは、ComfyUI の出力ディレクトリにファイルを保存せずに、UI 上で3Dモデルのプレビューを表示します。モデルを一時ファイルに保存し、モデルデータ、モデル情報、カメラ情報、プレビューの寸法を後続の処理にパススルーします。 +このノードは、ComfyUI の出力ディレクトリにファイルを保存せずに、UI 上で 3D モデルのプレビューを表示します。モデルを一時ファイルに保存し、モデルデータ、モデル情報、カメラ情報、プレビュー寸法を下流の処理のためにそのままパススルーします。 ## 入力 | パラメータ | 説明 | データ型 | 必須 | 範囲 | |-----------|-------------|-----------|----------|-------| -| `model_3d` | 上流の3Dノードからの3Dモデルファイルです。 | FILE3D | はい | GLB, GLTF, FBX, OBJ, STL, USDZ, or any supported 3D format | -| `3Dモデル情報` | 任意のモデル情報メタデータです。上級者向けオプションです。 | LOAD3DMODELINFO | いいえ | - | -| `viewport_state` | カメラ情報とモデル情報を含む現在のビューポート状態です。 | LOAD3D | はい | - | -| `カメラ情報` | 3Dビュー用の任意のカメラ設定です。上級者向けオプションです。 | LOAD3DCAMERA | いいえ | - | -| `幅` | プレビューの幅(ピクセル単位)です。デフォルト: 1024。 | INT | はい | 1 〜 4096 | -| `高さ` | プレビューの高さ(ピクセル単位)です。デフォルト: 1024。 | INT | はい | 1 〜 4096 | +| `model_3d` | 上流の3Dノードからの3Dモデルファイルです。 | FILE3D | 必須 | GLB, GLTF, FBX, OBJ, STL, USDZ, or any supported 3D format | +| `3Dモデル情報` | シーン内の各モデルの配置(位置、回転、スケール。Y軸上方向のワールド空間)です。任意指定です。高度なオプションです。 | LOAD3DMODELINFO | 任意 | - | +| `viewport_state` | カメラとモデルの情報を含む現在のビューポートの状態です。 | LOAD3D | 必須 | - | +| `カメラ情報` | ビューポートのカメラ情報(位置、注視点、ズーム、タイプ)です。任意指定です。高度なオプションです。 | LOAD3DCAMERA | 任意 | - | +| `幅` | ビューポートのレンダリング幅(ピクセル単位)です。デフォルト: 1024。 | INT | 必須 | 1〜4096 | +| `高さ` | ビューポートのレンダリング高さ(ピクセル単位)です。デフォルト: 1024。 | INT | 必須 | 1〜4096 | -注意: `camera_info` または `model_3d_info` が接続されていない場合、利用可能であればそれらの値は `viewport_state` から取得されます。`viewport_state` にカメラ情報が含まれていない場合は、`camera_info` は None になります。`viewport_state` にモデル情報がない場合は、`model_3d_info` はデフォルトで空のリストになります。`viewport_state` が辞書でない場合は、空として扱われます。 +注:`camera_info` または `model_3d_info` が接続されていない場合、利用可能であれば、それらの値は `viewport_state` から取得されます。`viewport_state` にカメラ情報が含まれていない場合、`camera_info` は None になります。`viewport_state` にモデル情報がない場合、`model_3d_info` はデフォルトで空のリストになります。`viewport_state` が辞書でない場合は空として扱われます。 ## 出力 | 出力名 | 説明 | データ型 | |-------------|-------------|-----------| -| `model_file` | 入力からパススルーされた3Dモデルファイルです。 | FILE3D | -| `カメラ情報` | 入力またはビューポート状態からのモデル情報メタデータです。 | LOAD3DMODELINFO | -| `3Dモデル情報` | 入力またはビューポート状態からのカメラ設定です。 | LOAD3DCAMERA | -| `幅` | プレビューの幅(ピクセル単位)です。 | INT | -| `高さ` | プレビューの高さ(ピクセル単位)です。 | INT | +| `model_file` | 上流の3Dノードからの3Dモデルファイル(glb/obj/stl など)です。変更されずにそのまま渡されます。 | FILE3D | +| `カメラ情報` | シーン内の各モデルの配置(位置、回転、スケール。Y軸上方向のワールド空間)です。入力値を使用するか、`viewport_state` に保存された値にフォールバックします。 | LOAD3DMODELINFO | +| `3Dモデル情報` | ビューポートのカメラ情報(位置、注視点、ズーム、タイプ)です。入力値を使用するか、`viewport_state` に保存された値にフォールバックします。 | LOAD3DCAMERA | +| `幅` | ビューポートのレンダリング幅(ピクセル単位)です。 | INT | +| `高さ` | ビューポートのレンダリング高さ(ピクセル単位)です。 | INT | > このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Preview3DAdvanced/ja.md) --- -**Source fingerprint (SHA-256):** `46c14d6242cbcabd457e13ae193427bb4c1fed55e81e568d50719fff0f1a95a0` +**Source fingerprint (SHA-256):** `f2d3d35ed35fe68edebcde8fd8421d26850b04e3ae5b7147f1020c8ed904c480` diff --git a/comfyui_embedded_docs/docs/Preview3DAdvanced/ko.md b/comfyui_embedded_docs/docs/Preview3DAdvanced/ko.md index 4118c8596..bc5a49637 100644 --- a/comfyui_embedded_docs/docs/Preview3DAdvanced/ko.md +++ b/comfyui_embedded_docs/docs/Preview3DAdvanced/ko.md @@ -1,31 +1,31 @@ # 3D 미리보기 (고급) -이 노드는 ComfyUI 출력 디렉터리에 파일을 저장하지 않고 UI에 3D 모델 미리보기를 표시합니다. 모델을 임시 파일로 저장하고, 이후 후속 처리를 위해 모델 데이터, 모델 정보, 카메라 정보 및 미리보기 크기를 전달합니다. +이 노드는 모델 파일을 ComfyUI 출력 디렉터리에 저장하지 않고 UI에 3D 모델 미리보기를 표시합니다. 모델을 임시 파일로 저장하며, 이후 다운스트림 처리를 위해 모델 데이터, 모델 정보, 카메라 정보, 미리보기 크기를 그대로 전달합니다. ## 입력 -| 매개변수 | 설명 | 데이터 유형 | 필수 여부 | 범위 | +| 매개변수 | 설명 | 데이터 유형 | 필수 | 범위 | |-----------|-------------|-----------|----------|-------| -| `model_3d` | 이전 3D 노드에서 전달된 3D 모델 파일입니다. | FILE3D | 예 | GLB, GLTF, FBX, OBJ, STL, USDZ 또는 지원되는 기타 3D 형식 | -| `model_3d_info` | 선택적 모델 정보 메타데이터입니다. 고급 옵션입니다. | LOAD3DMODELINFO | 아니요 | - | +| `model_3d` | 업스트림 3D 노드에서 가져온 3D 모델 파일입니다. | FILE3D | 예 | GLB, GLTF, FBX, OBJ, STL, USDZ, or any supported 3D format | +| `model_3d_info` | 씬에서 각 모델의 배치(위치, 회전, 크기, Y-up 월드 공간)입니다. 선택 사항이며 고급 옵션입니다. | LOAD3DMODELINFO | 아니요 | - | | `viewport_state` | 카메라 및 모델 정보를 포함하는 현재 뷰포트 상태입니다. | LOAD3D | 예 | - | -| `camera_info` | 3D 뷰를 위한 선택적 카메라 구성입니다. 고급 옵션입니다. | LOAD3DCAMERA | 아니요 | - | -| `width` | 미리보기의 픽셀 너비입니다. 기본값: 1024. | INT | 예 | 1 ~ 4096 | -| `height` | 미리보기의 픽셀 높이입니다. 기본값: 1024. | INT | 예 | 1 ~ 4096 | +| `camera_info` | 뷰포트 카메라 정보(위치, 시선 대상, 줌, 유형)입니다. 선택 사항이며 고급 옵션입니다. | LOAD3DCAMERA | 아니요 | - | +| `width` | 뷰포트의 렌더링 너비(픽셀)입니다. 기본값: 1024. | INT | 예 | 1~4096 | +| `height` | 뷰포트의 렌더링 높이(픽셀)입니다. 기본값: 1024. | INT | 예 | 1~4096 | -참고: `camera_info` 또는 `model_3d_info`가 연결되지 않은 경우, 사용 가능하면 해당 값은 `viewport_state`에서 가져옵니다. `viewport_state`에 카메라 정보가 없으면 `camera_info`는 None입니다. `viewport_state`에 모델 정보가 없으면 `model_3d_info`는 빈 목록으로 기본 설정됩니다. `viewport_state`가 딕셔너리 유형이 아니면 빈 값으로 처리됩니다. +참고: `camera_info` 또는 `model_3d_info`가 연결되지 않은 경우, 사용 가능한 `viewport_state`에서 값을 가져옵니다. `viewport_state`에 카메라 정보가 없으면 `camera_info`는 None입니다. `viewport_state`에 모델 정보가 없으면 `model_3d_info`는 빈 목록으로 기본 설정됩니다. `viewport_state`가 딕셔너리가 아니면 빈 값으로 처리됩니다. ## 출력 | 출력 이름 | 설명 | 데이터 유형 | |-------------|-------------|-----------| -| `model_file` | 입력에서 그대로 전달된 3D 모델 파일입니다. | FILE3D | -| `camera_info` | 입력 또는 뷰포트 상태에서 가져온 모델 정보 메타데이터입니다. | LOAD3DMODELINFO | -| `model_3d_info` | 입력 또는 뷰포트 상태에서 가져온 카메라 구성입니다. | LOAD3DCAMERA | -| `width` | 미리보기의 픽셀 너비입니다. | INT | -| `height` | 미리보기의 픽셀 높이입니다. | INT | +| `model_file` | 업스트림 3D 노드에서 가져온 3D 모델 파일(glb/obj/stl 등)이며, 변경 없이 통과됩니다. | FILE3D | +| `camera_info` | 씬에서 각 모델의 배치(위치, 회전, 크기, Y-up 월드 공간)입니다. 입력 값을 사용하며, 입력 값이 없으면 `viewport_state`에 저장된 값으로 폴백합니다. | LOAD3DMODELINFO | +| `model_3d_info` | 뷰포트 카메라 정보(위치, 시선 대상, 줌, 유형)입니다. 입력 값을 사용하며, 입력 값이 없으면 `viewport_state`에 저장된 값으로 폴백합니다. | LOAD3DCAMERA | +| `width` | 뷰포트의 렌더링 너비(픽셀)입니다. | INT | +| `height` | 뷰포트의 렌더링 높이(픽셀)입니다. | INT | > 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Preview3DAdvanced/ko.md) --- -**Source fingerprint (SHA-256):** `46c14d6242cbcabd457e13ae193427bb4c1fed55e81e568d50719fff0f1a95a0` +**Source fingerprint (SHA-256):** `f2d3d35ed35fe68edebcde8fd8421d26850b04e3ae5b7147f1020c8ed904c480` diff --git a/comfyui_embedded_docs/docs/Preview3DAdvanced/pt-BR.md b/comfyui_embedded_docs/docs/Preview3DAdvanced/pt-BR.md index 925e4e654..a5f33f63e 100644 --- a/comfyui_embedded_docs/docs/Preview3DAdvanced/pt-BR.md +++ b/comfyui_embedded_docs/docs/Preview3DAdvanced/pt-BR.md @@ -1,31 +1,31 @@ # Visualizar 3D (Avançado) -Este nó exibe uma prévia do modelo 3D na interface sem salvar o arquivo no diretório de saída do ComfyUI. Ele salva o modelo em um arquivo temporário e passa os dados do modelo, informações do modelo, informações da câmera e dimensões da prévia para processamento adicional a seguir. +Este nó exibe uma pré-visualização de modelo 3D na interface do usuário sem salvar o arquivo no diretório de saída do ComfyUI. Ele salva o modelo em um arquivo temporário e repassa os dados do modelo, as informações do modelo, as informações da câmera e as dimensões da pré-visualização para processamento posterior. ## Entradas | Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | |-----------|-------------|-----------|----------|-------| -| `modelo_3d` | Arquivo do modelo 3D proveniente de um nó 3D upstream. | FILE3D | Sim | GLB, GLTF, FBX, OBJ, STL, USDZ ou qualquer formato 3D suportado | -| `info_modelo_3d` | Metadados de informações do modelo opcional. Opção avançada. | LOAD3DMODELINFO | Não | - | -| `estado_da_janela_de_visualização` | O estado atual da vista, contendo informações da câmera e do modelo. | LOAD3D | Sim | - | -| `info_câmera` | Configuração da câmera opcional para a vista 3D. Opção avançada. | LOAD3DCAMERA | Não | - | -| `largura` | Largura da prévia em pixels. Padrão: 1024. | INT | Sim | 1 a 4096 | -| `altura` | Altura da prévia em pixels. Padrão: 1024. | INT | Sim | 1 a 4096 | +| `modelo_3d` | Arquivo de modelo 3D de um nó 3D de origem. | FILE3D | Sim | GLB, GLTF, FBX, OBJ, STL, USDZ ou qualquer formato 3D compatível | +| `info_modelo_3d` | Posicionamento de cada modelo na cena: posição, rotação e escala (espaço de mundo com Y para cima). Opcional. Opção avançada. | LOAD3DMODELINFO | Não | - | +| `estado_da_janela_de_visualização` | O estado atual da viewport contendo informações de câmera e modelo. | LOAD3D | Sim | - | +| `info_câmera` | Informações da câmera da viewport: posição, alvo de visualização, zoom e tipo. Opcional. Opção avançada. | LOAD3DCAMERA | Não | - | +| `largura` | Largura de renderização da viewport em pixels. Padrão: 1024. | INT | Sim | 1 a 4096 | +| `altura` | Altura de renderização da viewport em pixels. Padrão: 1024. | INT | Sim | 1 a 4096 | -Nota: Quando `camera_info` ou `model_3d_info` não estão conectados, seus valores são tomados do `viewport_state` quando disponíveis. Se `viewport_state` não contiver informações de câmera, `camera_info` é None. Se `viewport_state` não tiver informações de modelo, `model_3d_info` padrão é uma lista vazia. Se `viewport_state` não for um dicionário, é tratado como vazio. +Observação: Quando `camera_info` ou `model_3d_info` não estão conectados, seus valores são obtidos de `viewport_state` quando disponíveis. Se `viewport_state` não contiver informações de câmera, `camera_info` será None. Se `viewport_state` não tiver informações de modelo, `model_3d_info` será uma lista vazia por padrão. Se `viewport_state` não for um dicionário, ele será tratado como vazio. ## Saídas | Nome da Saída | Descrição | Tipo de Dados | |-------------|-------------|-----------| -| `arquivo_modelo` | Arquivo do modelo 3D passado pelo entrada. | FILE3D | -| `info_câmera` | Metadados de informações do modelo, seja do entrada ou do estado da vista. | LOAD3DMODELINFO | -| `info_modelo_3d` | Configuração da câmera, seja do entrada ou do estado da vista. | LOAD3DCAMERA | -| `largura` | Largura da prévia em pixels. | INT | -| `altura` | Altura da prévia em pixels. | INT | +| `arquivo_modelo` | Arquivo de modelo 3D (glb/obj/stl/etc.) de um nó 3D de origem, repassado sem alterações. | FILE3D | +| `info_câmera` | Posicionamento de cada modelo na cena: posição, rotação e escala (espaço de mundo com Y para cima). Usa o valor de entrada ou recorre ao valor armazenado em `viewport_state`. | LOAD3DMODELINFO | +| `info_modelo_3d` | Informações da câmera da viewport: posição, alvo de visualização, zoom e tipo. Usa o valor de entrada ou recorre ao valor armazenado em `viewport_state`. | LOAD3DCAMERA | +| `largura` | Largura de renderização da viewport em pixels. | INT | +| `altura` | Altura de renderização da viewport em pixels. | INT | > 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/Preview3DAdvanced/pt-BR.md) --- -**Source fingerprint (SHA-256):** `46c14d6242cbcabd457e13ae193427bb4c1fed55e81e568d50719fff0f1a95a0` +**Source fingerprint (SHA-256):** `f2d3d35ed35fe68edebcde8fd8421d26850b04e3ae5b7147f1020c8ed904c480` diff --git a/comfyui_embedded_docs/docs/Preview3DAdvanced/ru.md b/comfyui_embedded_docs/docs/Preview3DAdvanced/ru.md index 1d57e96d7..d440bcd40 100644 --- a/comfyui_embedded_docs/docs/Preview3DAdvanced/ru.md +++ b/comfyui_embedded_docs/docs/Preview3DAdvanced/ru.md @@ -1,31 +1,31 @@ # Просмотр 3D (расширенный) -Этот узел отображает предварительный просмотр 3D-модели в интерфейсе без сохранения файла в выходной каталог ComfyUI. Он сохраняет модель во временный файл и передаёт данные модели, информацию о модели, информацию о камере и размеры предварительного просмотра для дальнейшей обработки в конвейере. +Этот узел отображает предварительный просмотр 3D-модели в интерфейсе, не сохраняя файл в выходной каталог ComfyUI. Модель сохраняется во временный файл, а данные модели, информация о модели, информация о камере и размеры предварительного просмотра передаются дальше для последующей обработки в цепочке узлов. ## Входы -| Параметр | Описание | Тип данных | Обязательный | Диапазон | +| Параметр | Описание | Тип данных | Обязательно | Диапазон | |-----------|-------------|-----------|----------|-------| -| `3D-модель` | Файл 3D-модели от предыдущего 3D-узла. | FILE3D | Да | GLB, GLTF, FBX, OBJ, STL, USDZ или любой поддерживаемый 3D-формат | -| `model_3d_info` | Необязательные метаданные информации о модели. Расширенная опция. | LOAD3DMODELINFO | Нет | - | +| `3D-модель` | Файл 3D-модели из вышестоящего 3D-узла. | FILE3D | Да | GLB, GLTF, FBX, OBJ, STL, USDZ или любой поддерживаемый 3D-формат | +| `model_3d_info` | Размещение каждой модели в сцене: положение, поворот и масштаб (мировое пространство с осью Y вверх). Необязательно. Расширенная опция. | LOAD3DMODELINFO | Нет | - | | `состояние области просмотра` | Текущее состояние области просмотра, содержащее информацию о камере и модели. | LOAD3D | Да | - | -| `camera_info` | Необязательная конфигурация камеры для 3D-вида. Расширенная опция. | LOAD3DCAMERA | Нет | - | -| `width` | Ширина предварительного просмотра в пикселях. По умолчанию: 1024. | INT | Да | 1 до 4096 | -| `height` | Высота предварительного просмотра в пикселях. По умолчанию: 1024. | INT | Да | 1 до 4096 | +| `camera_info` | Информация о камере области просмотра: положение, целевая точка взгляда, масштаб и тип. Необязательно. Расширенная опция. | LOAD3DCAMERA | Нет | - | +| `width` | Ширина рендеринга области просмотра в пикселях. По умолчанию: 1024. | INT | Да | 1 до 4096 | +| `height` | Высота рендеринга области просмотра в пикселях. По умолчанию: 1024. | INT | Да | 1 до 4096 | -Примечание: Если `camera_info` или `model_3d_info` не подключены, их значения берутся из `viewport_state`, когда они доступны. Если `viewport_state` не содержит информации о камере, `camera_info` принимает значение None. Если `viewport_state` не содержит информации о модели, `model_3d_info` по умолчанию принимает пустой список. Если `viewport_state` не является словарём, он обрабатывается как пустой. +Примечание: Если `camera_info` или `model_3d_info` не подключены, их значения берутся из `viewport_state`, когда они доступны. Если `viewport_state` не содержит информации о камере, `camera_info` принимает значение None. Если в `viewport_state` нет информации о модели, `model_3d_info` по умолчанию принимает пустой список. Если `viewport_state` не является словарём, он считается пустым. ## Выходы | Имя выхода | Описание | Тип данных | |-------------|-------------|-----------| -| `model_file` | Файл 3D-модели, переданный со входа. | FILE3D | -| `camera_info` | Метаданные информации о модели: либо из входа, либо из состояния области просмотра. | LOAD3DMODELINFO | -| `model_3d_info` | Конфигурация камеры: либо из входа, либо из состояния области просмотра. | LOAD3DCAMERA | -| `width` | Ширина предварительного просмотра в пикселях. | INT | -| `height` | Высота предварительного просмотра в пикселях. | INT | +| `model_file` | Файл 3D-модели (glb/obj/stl и т. д.) из вышестоящего 3D-узла, переданный без изменений. | FILE3D | +| `camera_info` | Размещение каждой модели в сцене: положение, поворот и масштаб (мировое пространство с осью Y вверх). Использует входное значение или, при его отсутствии, значение, сохранённое в `viewport_state`. | LOAD3DMODELINFO | +| `model_3d_info` | Информация о камере области просмотра: положение, целевая точка взгляда, масштаб и тип. Использует входное значение или, при его отсутствии, значение, сохранённое в `viewport_state`. | LOAD3DCAMERA | +| `width` | Ширина рендеринга области просмотра в пикселях. | INT | +| `height` | Высота рендеринга области просмотра в пикселях. | INT | > Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Preview3DAdvanced/ru.md) --- -**Source fingerprint (SHA-256):** `46c14d6242cbcabd457e13ae193427bb4c1fed55e81e568d50719fff0f1a95a0` +**Source fingerprint (SHA-256):** `f2d3d35ed35fe68edebcde8fd8421d26850b04e3ae5b7147f1020c8ed904c480` diff --git a/comfyui_embedded_docs/docs/Preview3DAdvanced/tr.md b/comfyui_embedded_docs/docs/Preview3DAdvanced/tr.md index 21d072d35..dd20291a0 100644 --- a/comfyui_embedded_docs/docs/Preview3DAdvanced/tr.md +++ b/comfyui_embedded_docs/docs/Preview3DAdvanced/tr.md @@ -1,31 +1,31 @@ # 3D Önizleme (Gelişmiş) -Bu düğüm, dosyayı ComfyUI çıktı dizinine kaydetmeden kullanıcı arayüzünde bir 3D model önizlemesi görüntüler. Modeli geçici bir dosyaya kaydeder ve model verilerini, model bilgilerini, kamera bilgilerini ve önizleme boyutlarını daha sonraki işlem adımlarına iletir. +Bu düğüm, dosyayı ComfyUI çıktı dizinine kaydetmeden kullanıcı arayüzünde bir 3B model önizlemesi görüntüler. Modeli geçici bir dosyaya kaydeder ve model verilerini, model bilgilerini, kamera bilgilerini ve önizleme boyutlarını daha sonraki işlemler için iletir. ## Girdiler | Parametre | Açıklama | Veri Türü | Gerekli | Aralık | |-----------|-------------|-----------|----------|-------| -| `model_3d` | Bir önceki 3D düğümünden alınan 3D model dosyası. | FILE3D | Evet | GLB, GLTF, FBX, OBJ, STL, USDZ veya desteklenen herhangi bir 3D formatı | -| `model_3d_bilgisi` | İsteğe bağlı model bilgisi meta verisi. Gelişmiş seçenek. | LOAD3DMODELINFO | Hayır | - | +| `model_3d` | Önceki 3B düğümünden gelen 3B model dosyası. | FILE3D | Evet | GLB, GLTF, FBX, OBJ, STL, USDZ veya desteklenen herhangi bir 3B format | +| `model_3d_bilgisi` | Sahnedeki her modelin yerleşimi: konum, dönüş ve ölçek (Y-up dünya uzayı). İsteğe bağlı. Gelişmiş seçenek. | LOAD3DMODELINFO | Hayır | - | | `viewport_state` | Kamera ve model bilgilerini içeren mevcut görünüm alanı durumu. | LOAD3D | Evet | - | -| `kamera_bilgisi` | 3D görünümü için isteğe bağlı kamera yapılandırması. Gelişmiş seçenek. | LOAD3DCAMERA | Hayır | - | -| `genişlik` | Önizleme genişliği piksel cinsinden. Varsayılan: 1024. | INT | Evet | 1 ile 4096 | -| `yükseklik` | Önizleme yüksekliği piksel cinsinden. Varsayılan: 1024. | INT | Evet | 1 ile 4096 | +| `kamera_bilgisi` | Görünüm alanı kamera bilgileri: konum, bakış hedefi, yakınlaştırma ve tür. İsteğe bağlı. Gelişmiş seçenek. | LOAD3DCAMERA | Hayır | - | +| `genişlik` | Görünüm alanının piksel cinsinden işleme genişliği. Varsayılan: 1024. | INT | Evet | 1 ile 4096 | +| `yükseklik` | Görünüm alanının piksel cinsinden işleme yüksekliği. Varsayılan: 1024. | INT | Evet | 1 ile 4096 | -Not: `camera_info` veya `model_3d_info` bağlanmadığında, değerleri mevcutsa `viewport_state` içinden alınır. `viewport_state` içinde kamera bilgisi yoksa `camera_info` değeri `None` olur. `viewport_state` içinde model bilgisi yoksa `model_3d_info` varsayılan olarak boş bir liste olur. `viewport_state` bir sözlük değilse boş kabul edilir. +Not: `camera_info` veya `model_3d_info` bağlı değilse, değerleri `viewport_state` içinde mevcut olduğunda oradan alınır. Eğer `viewport_state` kamera bilgisi içermiyorsa, `camera_info` None olur. Eğer `viewport_state` model bilgisi içermiyorsa, `model_3d_info` varsayılan olarak boş bir liste olur. Eğer `viewport_state` bir sözlük değilse, boş olarak kabul edilir. ## Çıktılar | Çıktı Adı | Açıklama | Veri Türü | |-------------|-------------|-----------| -| `model_dosyası` | Girdiden iletilen 3D model dosyası. | FILE3D | -| `kamera_bilgisi` | Girdiden veya görünüm alanı durumundan alınan model bilgisi meta verisi. | LOAD3DMODELINFO | -| `model_3d_bilgisi` | Girdiden veya görünüm alanı durumundan alınan kamera yapılandırması. | LOAD3DCAMERA | -| `genişlik` | Önizleme genişliği piksel cinsinden. | INT | -| `yükseklik` | Önizleme yüksekliği piksel cinsinden. | INT | +| `model_dosyası` | Önceki 3B düğümünden gelen, değiştirilmeden iletilen 3B model dosyası (glb/obj/stl/vb.). | FILE3D | +| `kamera_bilgisi` | Sahnedeki her modelin yerleşimi: konum, dönüş ve ölçek (Y-up dünya uzayı). Girdi değerini kullanır; aksi durumda `viewport_state` içinde saklanan değere başvurur. | LOAD3DMODELINFO | +| `model_3d_bilgisi` | Görünüm alanı kamera bilgileri: konum, bakış hedefi, yakınlaştırma ve tür. Girdi değerini kullanır; aksi durumda `viewport_state` içinde saklanan değere başvurur. | LOAD3DCAMERA | +| `genişlik` | Görünüm alanının piksel cinsinden işleme genişliği. | INT | +| `yükseklik` | Görünüm alanının piksel cinsinden işleme yüksekliği. | INT | > 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/Preview3DAdvanced/tr.md) --- -**Source fingerprint (SHA-256):** `46c14d6242cbcabd457e13ae193427bb4c1fed55e81e568d50719fff0f1a95a0` +**Source fingerprint (SHA-256):** `f2d3d35ed35fe68edebcde8fd8421d26850b04e3ae5b7147f1020c8ed904c480` diff --git a/comfyui_embedded_docs/docs/Preview3DAdvanced/zh-TW.md b/comfyui_embedded_docs/docs/Preview3DAdvanced/zh-TW.md index 11098ecf2..8c6c46353 100644 --- a/comfyui_embedded_docs/docs/Preview3DAdvanced/zh-TW.md +++ b/comfyui_embedded_docs/docs/Preview3DAdvanced/zh-TW.md @@ -1,31 +1,31 @@ # 3D 預覽(進階) -此節點在 UI 中顯示 3D 模型預覽,而不會將檔案儲存到 ComfyUI 輸出目錄。它會將模型儲存到暫時檔案,並向下游傳遞模型資料、模型資訊、相機資訊和預覽尺寸,以供進一步處理。 +此節點會在 UI 中顯示 3D 模型預覽,而不會將檔案儲存到 ComfyUI 的輸出目錄。它會將模型儲存到暫存檔,並將模型資料、模型資訊、相機資訊及預覽尺寸傳遞給下游節點,以利後續處理。 ## 輸入 -| 參數 | 描述 | 資料類型 | 必填 | 範圍 | +| 參數 | 說明 | 資料類型 | 必填 | 範圍 | |-----------|-------------|-----------|----------|-------| | `model_3d` | 來自上游 3D 節點的 3D 模型檔案。 | FILE3D | 是 | GLB、GLTF、FBX、OBJ、STL、USDZ 或任何支援的 3D 格式 | -| `model_3d_info` | 選用的模型資訊中繼資料。進階選項。 | LOAD3DMODELINFO | 否 | - | -| `viewport_state` | 目前的視埠狀態,包含相機與模型資訊。 | LOAD3D | 是 | - | -| `camera_info` | 3D 視圖的選用相機設定。進階選項。 | LOAD3DCAMERA | 否 | - | -| `寬度` | 預覽的寬度(像素)。預設值:1024。 | INT | 是 | 1 至 4096 | -| `高度` | 預覽的高度(像素)。預設值:1024。 | INT | 是 | 1 至 4096 | +| `model_3d_info` | 每個模型在場景中的放置:位置、旋轉與縮放(Y 軸朝上的世界空間)。可選。進階選項。 | LOAD3DMODELINFO | 否 | - | +| `viewport_state` | 目前的視口狀態,包含相機與模型資訊。 | LOAD3D | 是 | - | +| `camera_info` | 視口相機資訊:位置、注視目標、縮放與類型。可選。進階選項。 | LOAD3DCAMERA | 否 | - | +| `寬度` | 視口的渲染寬度(像素)。預設值:1024。 | INT | 是 | 1 到 4096 | +| `高度` | 視口的渲染高度(像素)。預設值:1024。 | INT | 是 | 1 到 4096 | -注意:當 `camera_info` 或 `model_3d_info` 未連接時,其值將在可行時從 `viewport_state` 取得。若 `viewport_state` 不含相機資訊,則 `camera_info` 為 None。若 `viewport_state` 沒有模型資訊,則 `model_3d_info` 預設為空清單。若 `viewport_state` 不是字典,則將其視為空。 +注意:當未連接 `camera_info` 或 `model_3d_info` 時,若有可用的 `viewport_state`,其值會從 `viewport_state` 取得。若 `viewport_state` 中不含相機資訊,則 `camera_info` 為 None。若 `viewport_state` 中不含模型資訊,則 `model_3d_info` 預設為空列表。若 `viewport_state` 不是字典,則將其視為空值。 ## 輸出 -| 輸出名 | 描述 | 資料類型 | +| 輸出名 | 說明 | 資料類型 | |-------------|-------------|-----------| -| `model_file` | 從輸入傳遞的 3D 模型檔案。 | FILE3D | -| `camera_info` | 來自輸入或視埠狀態的模型資訊中繼資料。 | LOAD3DMODELINFO | -| `model_3d_info` | 來自輸入或視埠狀態的相機設定。 | LOAD3DCAMERA | -| `寬度` | 預覽的寬度(像素)。 | INT | -| `高度` | 預覽的高度(像素)。 | INT | +| `model_file` | 來自上游 3D 節點的 3D 模型檔案(glb/obj/stl 等),原樣傳遞。 | FILE3D | +| `camera_info` | 每個模型在場景中的放置:位置、旋轉與縮放(Y 軸朝上的世界空間)。使用輸入值;若無輸入值,則回退至 `viewport_state` 中儲存的值。 | LOAD3DMODELINFO | +| `model_3d_info` | 視口相機資訊:位置、注視目標、縮放與類型。使用輸入值;若無輸入值,則回退至 `viewport_state` 中儲存的值。 | LOAD3DCAMERA | +| `寬度` | 視口的渲染寬度(像素)。 | INT | +| `高度` | 視口的渲染高度(像素)。 | INT | > 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Preview3DAdvanced/zh-TW.md) --- -**Source fingerprint (SHA-256):** `46c14d6242cbcabd457e13ae193427bb4c1fed55e81e568d50719fff0f1a95a0` +**Source fingerprint (SHA-256):** `f2d3d35ed35fe68edebcde8fd8421d26850b04e3ae5b7147f1020c8ed904c480` diff --git a/comfyui_embedded_docs/docs/Preview3DAdvanced/zh.md b/comfyui_embedded_docs/docs/Preview3DAdvanced/zh.md index 665c20bca..1d4414818 100644 --- a/comfyui_embedded_docs/docs/Preview3DAdvanced/zh.md +++ b/comfyui_embedded_docs/docs/Preview3DAdvanced/zh.md @@ -1,31 +1,31 @@ # 3D 预览(高级) -此节点在 UI 中显示 3D 模型预览,而无需将文件保存到 ComfyUI 输出目录。它会将模型保存到临时文件,并将模型数据、模型信息、相机信息和预览尺寸传递给下游节点,以供后续处理。 +此节点在 UI 中显示 3D 模型预览,而无需将文件保存到 ComfyUI 输出目录。它将模型保存到临时文件,并传递模型数据、模型信息、相机信息和预览尺寸,以供下游进一步处理。 ## 输入 -| 参数 | 描述 | 数据类型 | 是否必需 | 范围 | +| 参数 | 说明 | 数据类型 | 是否必需 | 范围 | |-----------|-------------|-----------|----------|-------| -| `model_3d` | 来自上游 3D 节点的 3D 模型文件。 | FILE3D | 是 | GLB、GLTF、FBX、OBJ、STL、USDZ 或任何受支持的 3D 格式 | -| `3D 模型信息` | 可选的模型信息元数据。高级选项。 | LOAD3DMODELINFO | 否 | - | +| `model_3d` | 来自上游 3D 节点的 3D 模型文件。 | FILE3D | 是 | GLB、GLTF、FBX、OBJ、STL、USDZ 或任何支持的 3D 格式 | +| `3D 模型信息` | 每个模型在场景中的放置:位置、旋转和缩放(Y 轴向上世界空间)。可选。高级选项。 | LOAD3DMODELINFO | 否 | - | | `viewport_state` | 包含相机和模型信息的当前视口状态。 | LOAD3D | 是 | - | -| `相机信息` | 可选的 3D 视图相机配置。高级选项。 | LOAD3DCAMERA | 否 | - | -| `宽度` | 预览的宽度(像素)。默认值:1024。 | INT | 是 | 1 到 4096 | -| `高度` | 预览的高度(像素)。默认值:1024。 | INT | 是 | 1 到 4096 | +| `相机信息` | 视口相机信息:位置、注视目标、缩放和类型。可选。高级选项。 | LOAD3DCAMERA | 否 | - | +| `宽度` | 视口的渲染宽度(像素)。默认值:1024。 | INT | 是 | 1到4096 | +| `高度` | 视口的渲染高度(像素)。默认值:1024。 | INT | 是 | 1到4096 | -注意:当 `camera_info` 或 `model_3d_info` 未连接时,若 `viewport_state` 中可用,则其值取自 `viewport_state`。如果 `viewport_state` 不包含相机信息,则 `camera_info` 为 None。如果 `viewport_state` 没有模型信息,则 `model_3d_info` 默认为空列表。如果 `viewport_state` 不是字典,则将其视为空。 +注意:当 `camera_info` 或 `model_3d_info` 未连接时,其值会尽可能从 `viewport_state` 中获取。如果 `viewport_state` 不包含相机信息,则 `camera_info` 为 None。如果 `viewport_state` 没有模型信息,则 `model_3d_info` 默认为空列表。如果 `viewport_state` 不是字典,则将其视为空。 ## 输出 -| 输出名称 | 描述 | 数据类型 | +| 输出名称 | 说明 | 数据类型 | |-------------|-------------|-----------| -| `模型文件` | 从输入透传而来的 3D 模型文件。 | FILE3D | -| `相机信息` | 模型信息元数据,来自输入或来自视口状态。 | LOAD3DMODELINFO | -| `3D 模型信息` | 相机配置,来自输入或来自视口状态。 | LOAD3DCAMERA | -| `宽度` | 预览的宽度(像素)。 | INT | -| `高度` | 预览的高度(像素)。 | INT | +| `模型文件` | 来自上游 3D 节点的 3D 模型文件(glb/obj/stl 等),保持不变地传递。 | FILE3D | +| `相机信息` | 每个模型在场景中的放置:位置、旋转和缩放(Y 轴向上世界空间)。使用输入值,或回退到 `viewport_state` 中存储的值。 | LOAD3DMODELINFO | +| `3D 模型信息` | 视口相机信息:位置、注视目标、缩放和类型。使用输入值,或回退到 `viewport_state` 中存储的值。 | LOAD3DCAMERA | +| `宽度` | 视口的渲染宽度(像素)。 | INT | +| `高度` | 视口的渲染高度(像素)。 | INT | > 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Preview3DAdvanced/zh.md) --- -**Source fingerprint (SHA-256):** `46c14d6242cbcabd457e13ae193427bb4c1fed55e81e568d50719fff0f1a95a0` +**Source fingerprint (SHA-256):** `f2d3d35ed35fe68edebcde8fd8421d26850b04e3ae5b7147f1020c8ed904c480` diff --git a/comfyui_embedded_docs/docs/Save3DAdvanced/ar.md b/comfyui_embedded_docs/docs/Save3DAdvanced/ar.md index 94269596c..5630fbbf9 100644 --- a/comfyui_embedded_docs/docs/Save3DAdvanced/ar.md +++ b/comfyui_embedded_docs/docs/Save3DAdvanced/ar.md @@ -1,31 +1,32 @@ # حفظ ثلاثي الأبعاد (متقدم) -هذه العقدة تحفظ نموذجًا ثلاثي الأبعاد في ملف داخل دليل الإخراج الخاص بـ ComfyUI، مع تحكم متقدم في أبعاد الإخراج وإعدادات الكاميرا/منفذ العرض. كما تقوم بتمرير النموذج ثلاثي الأبعاد، ومعلومات النموذج، ومعلومات الكاميرا، والأبعاد إلى العقد اللاحقة. +يقوم Save3DAdvanced بحفظ نموذج ثلاثي الأبعاد في ملف داخل دليل مخرجات ComfyUI وينشئ معاينة للمشهد المحفوظ. كما يقوم بتمرير النموذج ثلاثي الأبعاد وموضعه في المشهد ومعلومات الكاميرا وأبعاد منفذ العرض إلى العقد اللاحقة. عندما لا تكون معلومات موضع النموذج أو معلومات الكاميرا متصلة، تستخدم العقدة القيم المخزنة في حالة منفذ العرض. ## المدخلات -| المعامل | الوصف | نوع البيانات | إلزامي | النطاق | +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | |-----------|-------------|-----------|----------|-------| -| `نموذج ثلاثي الأبعاد` | ملف النموذج ثلاثي الأبعاد من عقدة ثلاثية الأبعاد سابقة. | FILE3D | نعم | GLB
GLTF
FBX
OBJ
STL
USDZ
أي | -| `بادئة اسم الملف` | بادئة لاسم الملف المحفوظ (الافتراضي: "3d/ComfyUI"). | STRING | نعم | نص حر | -| `حالة منفذ العرض` | حالة منفذ العرض من عقدة تحميل ثلاثي الأبعاد، تحتوي على معلومات الكاميرا والنموذج. | LOAD3D | نعم | - | -| `معلومات النموذج ثلاثي الأبعاد` | معلومات نموذج ثلاثي الأبعاد اختيارية لتجاوز حالة منفذ العرض. | LOAD3DMODELINFO | لا | - | -| `معلومات الكاميرا` | معلومات كاميرا اختيارية لتجاوز حالة منفذ العرض. | LOAD3DCAMERA | لا | - | -| `العرض` | عرض المعاينة الناتجة بالبكسل (الافتراضي: 1024). | INT | نعم | 1 إلى 4096 | -| `الارتفاع` | ارتفاع المعاينة الناتجة بالبكسل (الافتراضي: 1024). | INT | نعم | 1 إلى 4096 | -ملاحظة: عندما لا تكون `model_3d_info` أو `camera_info` متصلة، تعود العقدة إلى القيم المخزنة في `viewport_state`. +| `نموذج ثلاثي الأبعاد` | ملف نموذج ثلاثي الأبعاد من عقدة ثلاثية الأبعاد سابقة. | FILE3D | نعم | GLB
GLTF
FBX
OBJ
STL
USDZ
Any | +| `بادئة اسم الملف` | بادئة تُستخدم لاسم الملف المحفوظ (الافتراضي: `3d/ComfyUI`). | STRING | نعم | نص حر | +| `حالة منفذ العرض` | حالة منفذ العرض التي تحتوي على معلومات الكاميرا وموضع النموذج، وعادةً ما تكون من عقدة Load 3D. | LOAD3D | نعم | - | +| `معلومات النموذج ثلاثي الأبعاد` | موضع كل نموذج في المشهد: الموضع، والدوران، والقياس (فضاء عالمي بمحور Y للأعلى). يتجاوز موضع النموذج المخزن في `viewport_state` عند توصيله. | LOAD3DMODELINFO | لا | - | +| `معلومات الكاميرا` | معلومات كاميرا منفذ العرض: الموضع، نقطة الهدف، التقريب، والنوع. تتجاوز معلومات الكاميرا المخزنة في `viewport_state` عند توصيلها. | LOAD3DCAMERA | لا | - | +| `العرض` | عرض التصيير لمنفذ العرض بالبكسل (الافتراضي: 1024). | INT | نعم | 1 إلى 4096 | +| `الارتفاع` | ارتفاع التصيير لمنفذ العرض بالبكسل (الافتراضي: 1024). | INT | نعم | 1 إلى 4096 | + +ملاحظة: `model_3d_info` و`camera_info` اختياريان. عندما لا يكون أي منهما متصلًا، ترجع العقدة إلى القيم المقابلة المخزنة في `viewport_state`. ## المخرجات | اسم المخرج | الوصف | نوع البيانات | |-------------|-------------|-----------| -| `نموذج ثلاثي الأبعاد` | ملف النموذج ثلاثي الأبعاد الذي تم تمريره من المدخلات. | FILE3D | -| `معلومات النموذج ثلاثي الأبعاد` | معلومات النموذج، إما من حالة منفذ العرض أو من المدخلات الاختيارية. | LOAD3DMODELINFO | -| `معلومات الكاميرا` | معلومات الكاميرا، إما من حالة منفذ العرض أو من المدخلات الاختيارية. | LOAD3DCAMERA | -| `العرض` | قيمة العرض التي تم تمريرها من المدخلات. | INT | -| `الارتفاع` | قيمة الارتفاع التي تم تمريرها من المدخلات. | INT | +| `نموذج ثلاثي الأبعاد` | ملف النموذج ثلاثي الأبعاد الممرَّر من الإدخال. | FILE3D | +| `معلومات النموذج ثلاثي الأبعاد` | موضع كل نموذج في المشهد: الموضع، والدوران، والقياس (فضاء عالمي بمحور Y للأعلى). | LOAD3DMODELINFO | +| `معلومات الكاميرا` | معلومات كاميرا منفذ العرض: الموضع، نقطة الهدف، التقريب، والنوع. | LOAD3DCAMERA | +| `العرض` | قيمة عرض التصيير الممرَّرة من الإدخال. | INT | +| `الارتفاع` | قيمة ارتفاع التصيير الممرَّرة من الإدخال. | INT | > تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Save3DAdvanced/ar.md) --- -**Source fingerprint (SHA-256):** `2c7d42b1875bb292e675526a2b38fcc8856c8ac45de25ac7b69d92323f0b7ae0` +**Source fingerprint (SHA-256):** `27cb15c5cf382e6e5b8164cfd456993404222c61d59edff2d51f9f1c8e47b25f` diff --git a/comfyui_embedded_docs/docs/Save3DAdvanced/en.md b/comfyui_embedded_docs/docs/Save3DAdvanced/en.md index c04fa4382..105043adb 100644 --- a/comfyui_embedded_docs/docs/Save3DAdvanced/en.md +++ b/comfyui_embedded_docs/docs/Save3DAdvanced/en.md @@ -1,32 +1,32 @@ # Save 3D (Advanced) -This node saves a 3D model to a file in the ComfyUI output directory, with advanced control over the output dimensions and camera/viewport settings. It also passes through the 3D model, model information, camera information, and dimensions for downstream nodes. +Save3DAdvanced saves a 3D model to a file in the ComfyUI output directory and creates a preview of the saved scene. It also passes the 3D model, its placement in the scene, camera information, and viewport dimensions through to downstream nodes. When model placement or camera information are not connected, the node uses the values stored in the viewport state. ## Inputs | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| | `model_3d` | 3D model file from an upstream 3D node. | FILE3D | Yes | GLB
GLTF
FBX
OBJ
STL
USDZ
Any | -| `filename_prefix` | Prefix for the saved file name (default: "3d/ComfyUI"). | STRING | Yes | Free text | -| `viewport_state` | Viewport state from a Load 3D node, containing camera and model information. | LOAD3D | Yes | - | -| `model_3d_info` | Optional 3D model information to override the viewport state. | LOAD3DMODELINFO | No | - | -| `camera_info` | Optional camera information to override the viewport state. | LOAD3DCAMERA | No | - | -| `width` | Width of the output preview in pixels (default: 1024). | INT | Yes | 1 to 4096 | -| `height` | Height of the output preview in pixels (default: 1024). | INT | Yes | 1 to 4096 | +| `filename_prefix` | Prefix used for the saved file name (default: "3d/ComfyUI"). | STRING | Yes | Free text | +| `viewport_state` | Viewport state containing camera and model placement information, typically from a Load 3D node. | LOAD3D | Yes | - | +| `model_3d_info` | Placement of each model in the scene: position, rotation, and scale (Y-up world space). Overrides the model placement stored in `viewport_state` when connected. | LOAD3DMODELINFO | No | - | +| `camera_info` | Viewport camera information: position, look-at target, zoom, and type. Overrides the camera information stored in `viewport_state` when connected. | LOAD3DCAMERA | No | - | +| `width` | Render width of the viewport in pixels (default: 1024). | INT | Yes | 1 to 4096 | +| `height` | Render height of the viewport in pixels (default: 1024). | INT | Yes | 1 to 4096 | -Note: When `model_3d_info` or `camera_info` are not connected, the node falls back to the values stored in `viewport_state`. +Note: `model_3d_info` and `camera_info` are optional. When either input is not connected, the node falls back to the corresponding values stored in `viewport_state`. ## Outputs | Output Name | Description | Data Type | |-------------|-------------|-----------| | `model_3d` | The 3D model file passed through from the input. | FILE3D | -| `model_3d_info` | Model information, either from the viewport state or the optional input. | LOAD3DMODELINFO | -| `camera_info` | Camera information, either from the viewport state or the optional input. | LOAD3DCAMERA | -| `width` | The width value passed through from the input. | INT | -| `height` | The height value passed through from the input. | INT | +| `model_3d_info` | Placement of each model in the scene: position, rotation, and scale (Y-up world space). | LOAD3DMODELINFO | +| `camera_info` | Viewport camera information: position, look-at target, zoom, and type. | LOAD3DCAMERA | +| `width` | The render width value passed through from the input. | INT | +| `height` | The render height value passed through from the input. | 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/Save3DAdvanced/en.md) --- -**Source fingerprint (SHA-256):** `2c7d42b1875bb292e675526a2b38fcc8856c8ac45de25ac7b69d92323f0b7ae0` +**Source fingerprint (SHA-256):** `27cb15c5cf382e6e5b8164cfd456993404222c61d59edff2d51f9f1c8e47b25f` diff --git a/comfyui_embedded_docs/docs/Save3DAdvanced/es.md b/comfyui_embedded_docs/docs/Save3DAdvanced/es.md index ca0bd546e..b73a1d022 100644 --- a/comfyui_embedded_docs/docs/Save3DAdvanced/es.md +++ b/comfyui_embedded_docs/docs/Save3DAdvanced/es.md @@ -1,31 +1,32 @@ # Guardar 3D (Avanzado) -Este nodo guarda un modelo 3D en un archivo dentro del directorio de salida de ComfyUI, con control avanzado sobre las dimensiones de salida y la configuración de cámara/visor. También transmite el modelo 3D, la información del modelo, la información de la cámara y las dimensiones para nodos posteriores. +Save3DAdvanced guarda un modelo 3D en un archivo en el directorio de salida de ComfyUI y crea una vista previa de la escena guardada. También transmite el modelo 3D, su ubicación en la escena, la información de la cámara y las dimensiones del viewport a los nodos posteriores. Cuando la ubicación del modelo o la información de la cámara no están conectadas, el nodo utiliza los valores almacenados en el estado del viewport. ## Entradas -| Parámetro | Descripción | Tipo de Dato | Requerido | Rango | -|-----------|-------------|--------------|-----------|-------| -| `model_3d` | Archivo de modelo 3D proveniente de un nodo 3D anterior. | FILE3D | Sí | GLB
GLTF
FBX
OBJ
STL
USDZ
Cualquiera | -| `filename_prefix` | Prefijo para el nombre del archivo guardado (predeterminado: "3d/ComfyUI"). | STRING | Sí | Texto libre | -| `viewport_state` | Estado del visor proveniente de un nodo Cargar 3D, que contiene información de la cámara y del modelo. | LOAD3D | Sí | - | -| `model_3d_info` | Información opcional del modelo 3D para sobrescribir el estado del visor. | LOAD3DMODELINFO | No | - | -| `camera_info` | Información opcional de la cámara para sobrescribir el estado del visor. | LOAD3DCAMERA | No | - | -| `width` | Ancho de la vista previa de salida en píxeles (predeterminado: 1024). | INT | Sí | 1 a 4096 | -| `height` | Alto de la vista previa de salida en píxeles (predeterminado: 1024). | INT | Sí | 1 a 4096 | -Nota: cuando `model_3d_info` o `camera_info` no están conectados, el nodo recurre a los valores almacenados en `viewport_state`. +| Parámetro | Descripción | Tipo de datos | Requerido | Rango | +|-----------|-------------|---------------|-----------|-------| +| `model_3d` | Archivo de modelo 3D de un nodo 3D anterior. | FILE3D | Sí | GLB
GLTF
FBX
OBJ
STL
USDZ
Any | +| `filename_prefix` | Prefijo utilizado para el nombre del archivo guardado (por defecto: "3d/ComfyUI"). | STRING | Sí | Texto libre | +| `viewport_state` | Estado del viewport que contiene información de la cámara y la ubicación del modelo, normalmente de un nodo Load 3D. | LOAD3D | Sí | - | +| `model_3d_info` | Ubicación de cada modelo en la escena: posición, rotación y escala (espacio mundial con eje Y hacia arriba). Anula la ubicación del modelo almacenada en `viewport_state` cuando está conectado. | LOAD3DMODELINFO | No | - | +| `camera_info` | Información de la cámara del viewport: posición, punto de mira, zoom y tipo. Anula la información de la cámara almacenada en `viewport_state` cuando está conectado. | LOAD3DCAMERA | No | - | +| `width` | Ancho de renderizado del viewport en píxeles (por defecto: 1024). | INT | Sí | 1 a 4096 | +| `height` | Alto de renderizado del viewport en píxeles (por defecto: 1024). | INT | Sí | 1 a 4096 | + +Nota: `model_3d_info` y `camera_info` son opcionales. Cuando cualquiera de estas entradas no está conectada, el nodo recurre a los valores correspondientes almacenados en `viewport_state`. ## Salidas -| Nombre de Salida | Descripción | Tipo de Dato | -|------------------|-------------|--------------| +| Nombre de salida | Descripción | Tipo de datos | +|------------------|-------------|---------------| | `model_3d` | El archivo de modelo 3D transmitido desde la entrada. | FILE3D | -| `model_3d_info` | Información del modelo, ya sea desde el estado del visor o desde la entrada opcional. | LOAD3DMODELINFO | -| `camera_info` | Información de la cámara, ya sea desde el estado del visor o desde la entrada opcional. | LOAD3DCAMERA | -| `width` | El valor de ancho transmitido desde la entrada. | INT | -| `height` | El valor de alto transmitido desde la entrada. | INT | +| `model_3d_info` | Ubicación de cada modelo en la escena: posición, rotación y escala (espacio mundial con eje Y hacia arriba). | LOAD3DMODELINFO | +| `camera_info` | Información de la cámara del viewport: posición, punto de mira, zoom y tipo. | LOAD3DCAMERA | +| `width` | El valor de ancho de renderizado transmitido desde la entrada. | INT | +| `height` | El valor de alto de renderizado transmitido desde la entrada. | INT | > 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/Save3DAdvanced/es.md) --- -**Source fingerprint (SHA-256):** `2c7d42b1875bb292e675526a2b38fcc8856c8ac45de25ac7b69d92323f0b7ae0` +**Source fingerprint (SHA-256):** `27cb15c5cf382e6e5b8164cfd456993404222c61d59edff2d51f9f1c8e47b25f` diff --git a/comfyui_embedded_docs/docs/Save3DAdvanced/fa.md b/comfyui_embedded_docs/docs/Save3DAdvanced/fa.md index 92664f5d0..fab91f7d4 100644 --- a/comfyui_embedded_docs/docs/Save3DAdvanced/fa.md +++ b/comfyui_embedded_docs/docs/Save3DAdvanced/fa.md @@ -1,31 +1,32 @@ # ذخیره سه‌بعدی (پیشرفته) -این گره یک مدل سه‌بعدی را در دایرکتوری خروجی ComfyUI ذخیره می‌کند و کنترل پیشرفته‌ای بر ابعاد خروجی و تنظیمات دوربین/نمایشگر ارائه می‌دهد. همچنین مدل سه‌بعدی، اطلاعات مدل، اطلاعات دوربین و ابعاد را برای گره‌های پایین‌دستی عبور می‌دهد. +Save3DAdvanced یک مدل سه‌بعدی را در فایلی در پوشه خروجی ComfyUI ذخیره می‌کند و پیش‌نمایشی از صحنه ذخیره‌شده ایجاد می‌کند. همچنین مدل سه‌بعدی، جای‌گیری آن در صحنه، اطلاعات دوربین و ابعاد ویوپورت را به گره‌های پایین‌دستی منتقل می‌کند. وقتی ورودی جای‌گیری مدل یا اطلاعات دوربین متصل نباشد، گره از مقادیر ذخیره‌شده در وضعیت ویوپورت استفاده می‌کند. ## ورودی‌ها | پارامتر | توضیحات | نوع داده | الزامی | محدوده | -|---------|---------|----------|--------|--------| -| `model_3d` | فایل مدل سه‌بعدی از یک گره سه‌بعدی بالادستی. | FILE3D | بله | GLB
GLTF
FBX
OBJ
STL
USDZ
هر نوع | -| `filename_prefix` | پیشوند نام فایل ذخیره‌شده (پیش‌فرض: "3d/ComfyUI"). | STRING | بله | متن آزاد | -| `viewport_state` | وضعیت نمایشگر از یک گره Load 3D، شامل اطلاعات دوربین و مدل. | LOAD3D | بله | - | -| `model_3d_info` | اطلاعات اختیاری مدل سه‌بعدی برای بازنویسی وضعیت نمایشگر. | LOAD3DMODELINFO | خیر | - | -| `camera_info` | اطلاعات اختیاری دوربین برای بازنویسی وضعیت نمایشگر. | LOAD3DCAMERA | خیر | - | -| `width` | عرض پیش‌نمایش خروجی بر حسب پیکسل (پیش‌فرض: 1024). | INT | بله | 1 تا 4096 | -| `height` | ارتفاع پیش‌نمایش خروجی بر حسب پیکسل (پیش‌فرض: 1024). | INT | بله | 1 تا 4096 | -توجه: وقتی `model_3d_info` یا `camera_info` متصل نباشند، گره از مقادیر ذخیره‌شده در `viewport_state` استفاده می‌کند. +|-----------|-------------|-----------|----------|-------| +| `model_3d` | فایل مدل سه‌بعدی از یک گره سه‌بعدی بالادستی. | FILE3D | بله | GLB
GLTF
FBX
OBJ
STL
USDZ
Any | +| `filename_prefix` | پیشوندی که برای نام فایل ذخیره‌شده استفاده می‌شود (پیش‌فرض: "3d/ComfyUI"). | STRING | بله | متن آزاد | +| `viewport_state` | وضعیت ویوپورت شامل اطلاعات دوربین و جای‌گیری مدل، که معمولاً از یک گره Load 3D می‌آید. | LOAD3D | بله | - | +| `model_3d_info` | جای‌گیری هر مدل در صحنه: موقعیت، چرخش و مقیاس (فضای جهانی Y-up). در صورت اتصال، جای‌گیری مدل ذخیره‌شده در `viewport_state` را بازنویسی می‌کند. | LOAD3DMODELINFO | خیر | - | +| `camera_info` | اطلاعات دوربین ویوپورت: موقعیت، هدف نگاه (look-at)، بزرگ‌نمایی و نوع. در صورت اتصال، اطلاعات دوربین ذخیره‌شده در `viewport_state` را بازنویسی می‌کند. | LOAD3DCAMERA | خیر | - | +| `width` | عرض رندر ویوپورت بر حسب پیکسل (پیش‌فرض: 1024). | INT | بله | 1 تا 4096 | +| `height` | ارتفاع رندر ویوپورت بر حسب پیکسل (پیش‌فرض: 1024). | INT | بله | 1 تا 4096 | + +نکته: `model_3d_info` و `camera_info` اختیاری هستند. وقتی هر یک از این ورودی‌ها متصل نباشد، گره به مقادیر متناظر ذخیره‌شده در `viewport_state` بازمی‌گردد. ## خروجی‌ها | نام خروجی | توضیحات | نوع داده | -|-----------|---------|----------| -| `model_3d` | فایل مدل سه‌بعدی عبور داده‌شده از ورودی. | FILE3D | -| `model_3d_info` | اطلاعات مدل، یا از وضعیت نمایشگر یا از ورودی اختیاری. | LOAD3DMODELINFO | -| `camera_info` | اطلاعات دوربین، یا از وضعیت نمایشگر یا از ورودی اختیاری. | LOAD3DCAMERA | -| `width` | مقدار عرض عبور داده‌شده از ورودی. | INT | -| `height` | مقدار ارتفاع عبور داده‌شده از ورودی. | INT | +|-------------|-------------|-----------| +| `model_3d` | فایل مدل سه‌بعدی که از ورودی عبور داده شده است. | FILE3D | +| `model_3d_info` | جای‌گیری هر مدل در صحنه: موقعیت، چرخش و مقیاس (فضای جهانی Y-up). | LOAD3DMODELINFO | +| `camera_info` | اطلاعات دوربین ویوپورت: موقعیت، هدف نگاه (look-at)، بزرگ‌نمایی و نوع. | LOAD3DCAMERA | +| `width` | مقدار عرض رندر که از ورودی عبور داده شده است. | INT | +| `height` | مقدار ارتفاع رندر که از ورودی عبور داده شده است. | INT | > این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Save3DAdvanced/fa.md) --- -**Source fingerprint (SHA-256):** `2c7d42b1875bb292e675526a2b38fcc8856c8ac45de25ac7b69d92323f0b7ae0` +**Source fingerprint (SHA-256):** `27cb15c5cf382e6e5b8164cfd456993404222c61d59edff2d51f9f1c8e47b25f` diff --git a/comfyui_embedded_docs/docs/Save3DAdvanced/fr.md b/comfyui_embedded_docs/docs/Save3DAdvanced/fr.md index 0a8376396..16ea81ac2 100644 --- a/comfyui_embedded_docs/docs/Save3DAdvanced/fr.md +++ b/comfyui_embedded_docs/docs/Save3DAdvanced/fr.md @@ -1,31 +1,32 @@ # Enregistrer 3D (Avancé) -Ce nœud enregistre un modèle 3D dans un fichier situé dans le répertoire de sortie de ComfyUI, avec un contrôle avancé sur les dimensions de sortie et les paramètres de la caméra/du viewport. Il transmet également le modèle 3D, les informations du modèle, les informations de la caméra et les dimensions aux nœuds en aval. +Save3DAdvanced enregistre un modèle 3D dans un fichier du répertoire de sortie de ComfyUI et crée un aperçu de la scène enregistrée. Il transmet également le modèle 3D, son placement dans la scène, les informations de caméra et les dimensions de la fenêtre d’affichage aux nœuds en aval. Lorsque le placement du modèle ou les informations de caméra ne sont pas connectés, le nœud utilise les valeurs stockées dans l’état de la fenêtre d’affichage. ## Entrées | Paramètre | Description | Type de données | Requis | Plage | |-----------|-------------|-----------------|--------|-------| -| `model_3d` | Fichier de modèle 3D provenant d'un nœud 3D en amont. | FILE3D | Oui | GLB
GLTF
FBX
OBJ
STL
USDZ
N'importe | -| `filename_prefix` | Préfixe pour le nom du fichier enregistré (par défaut : "3d/ComfyUI"). | STRING | Oui | Texte libre | -| `viewport_state` | État du viewport provenant d'un nœud Load 3D, contenant les informations de la caméra et du modèle. | LOAD3D | Oui | - | -| `model_3d_info` | Informations facultatives sur le modèle 3D pour remplacer l'état du viewport. | LOAD3DMODELINFO | Non | - | -| `camera_info` | Informations facultatives sur la caméra pour remplacer l'état du viewport. | LOAD3DCAMERA | Non | - | -| `width` | Largeur de l'aperçu de sortie en pixels (par défaut : 1024). | INT | Oui | 1 à 4096 | -| `height` | Hauteur de l'aperçu de sortie en pixels (par défaut : 1024). | INT | Oui | 1 à 4096 | -Remarque : lorsque `model_3d_info` ou `camera_info` ne sont pas connectés, le nœud utilise les valeurs stockées dans `viewport_state`. +| `model_3d` | Fichier de modèle 3D provenant d’un nœud 3D en amont. | FILE3D | Oui | GLB
GLTF
FBX
OBJ
STL
USDZ
Any | +| `filename_prefix` | Préfixe utilisé pour le nom du fichier enregistré (par défaut : « 3d/ComfyUI »). | STRING | Oui | Free text | +| `viewport_state` | État de la fenêtre d’affichage contenant les informations de caméra et de placement du modèle, généralement issu d’un nœud Load 3D. | LOAD3D | Oui | - | +| `model_3d_info` | Placement de chaque modèle dans la scène : position, rotation et échelle (espace monde, Y vers le haut). Remplace le placement du modèle stocké dans `viewport_state` lorsqu’il est connecté. | LOAD3DMODELINFO | Non | - | +| `camera_info` | Informations de caméra de la fenêtre d’affichage : position, point visé, zoom et type. Remplace les informations de caméra stockées dans `viewport_state` lorsqu’il est connecté. | LOAD3DCAMERA | Non | - | +| `width` | Largeur de rendu de la fenêtre d’affichage en pixels (par défaut : 1024). | INT | Oui | 1 à 4096 | +| `height` | Hauteur de rendu de la fenêtre d’affichage en pixels (par défaut : 1024). | INT | Oui | 1 à 4096 | + +Remarque : `model_3d_info` et `camera_info` sont facultatifs. Lorsque l’une de ces entrées n’est pas connectée, le nœud utilise par défaut les valeurs correspondantes stockées dans `viewport_state`. ## Sorties | Nom de sortie | Description | Type de données | |---------------|-------------|-----------------| -| `model_3d` | Le fichier de modèle 3D transmis depuis l'entrée. | FILE3D | -| `model_3d_info` | Informations sur le modèle, provenant soit de l'état du viewport, soit de l'entrée facultative. | LOAD3DMODELINFO | -| `camera_info` | Informations sur la caméra, provenant soit de l'état du viewport, soit de l'entrée facultative. | LOAD3DCAMERA | -| `width` | La valeur de largeur transmise depuis l'entrée. | INT | -| `height` | La valeur de hauteur transmise depuis l'entrée. | INT | +| `model_3d` | Le fichier de modèle 3D transmis depuis l’entrée. | FILE3D | +| `model_3d_info` | Placement de chaque modèle dans la scène : position, rotation et échelle (espace monde, Y vers le haut). | LOAD3DMODELINFO | +| `camera_info` | Informations de caméra de la fenêtre d’affichage : position, point visé, zoom et type. | LOAD3DCAMERA | +| `width` | La valeur de largeur de rendu transmise depuis l’entrée. | INT | +| `height` | La valeur de hauteur de rendu transmise depuis l’entrée. | INT | > 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/Save3DAdvanced/fr.md) --- -**Source fingerprint (SHA-256):** `2c7d42b1875bb292e675526a2b38fcc8856c8ac45de25ac7b69d92323f0b7ae0` +**Source fingerprint (SHA-256):** `27cb15c5cf382e6e5b8164cfd456993404222c61d59edff2d51f9f1c8e47b25f` diff --git a/comfyui_embedded_docs/docs/Save3DAdvanced/ja.md b/comfyui_embedded_docs/docs/Save3DAdvanced/ja.md index 89e74fa34..0ad8f543c 100644 --- a/comfyui_embedded_docs/docs/Save3DAdvanced/ja.md +++ b/comfyui_embedded_docs/docs/Save3DAdvanced/ja.md @@ -1,31 +1,32 @@ # 3Dを保存(詳細) -このノードは、ComfyUIの出力ディレクトリに3Dモデルをファイルとして保存します。出力の寸法やカメラ/ビューポート設定を高度に制御できます。また、下流のノードで使用するために、3Dモデル、モデル情報、カメラ情報、寸法をそのまま通過させます。 +Save3DAdvanced は、ComfyUI の出力ディレクトリに 3D モデルをファイルとして保存し、保存したシーンのプレビューを作成します。また、3D モデル、シーン内での配置、カメラ情報、ビューポートの寸法を後続ノードに渡します。モデルの配置またはカメラ情報が接続されていない場合、ノードはビューポート状態に保存されている値を使用します。 ## 入力 | パラメータ | 説明 | データ型 | 必須 | 範囲 | |-----------|-------------|-----------|----------|-------| -| `model_3d` | 上流の3Dノードからの3Dモデルファイルです。 | FILE3D | はい | GLB
GLTF
FBX
OBJ
STL
USDZ
任意 | -| `filename_prefix` | 保存するファイル名のプレフィックスです(デフォルト:"3d/ComfyUI")。 | STRING | はい | 自由テキスト | -| `viewport_state` | Load 3Dノードからのビューポート状態で、カメラとモデルの情報を含みます。 | LOAD3D | はい | - | -| `model_3d_info` | ビューポート状態を上書きするためのオプションの3Dモデル情報です。 | LOAD3DMODELINFO | いいえ | - | -| `camera_info` | ビューポート状態を上書きするためのオプションのカメラ情報です。 | LOAD3DCAMERA | いいえ | - | -| `width` | 出力プレビューの幅(ピクセル単位)です(デフォルト:1024)。 | INT | はい | 1 ~ 4096 | -| `height` | 出力プレビューの高さ(ピクセル単位)です(デフォルト:1024)。 | INT | はい | 1 ~ 4096 | -注意:`model_3d_info` または `camera_info` が接続されていない場合、ノードは `viewport_state` に保存されている値を使用します。 +| `model_3d` | 上流の3Dノードからの3Dモデルファイルです。 | FILE3D | はい | GLB
GLTF
FBX
OBJ
STL
USDZ
Any | +| `filename_prefix` | 保存ファイル名に使用されるプレフィックスです(デフォルト: "3d/ComfyUI")。 | STRING | はい | Free text | +| `viewport_state` | カメラとモデルの配置情報を含むビューポート状態です。通常は Load 3D ノードから取得されます。 | LOAD3D | はい | - | +| `model_3d_info` | シーン内の各モデルの配置(位置、回転、スケール)です。Y-up ワールド空間で表されます。接続すると、`viewport_state` に保存されているモデル配置を上書きします。 | LOAD3DMODELINFO | いいえ | - | +| `camera_info` | ビューポートのカメラ情報(位置、注視ターゲット、ズーム、タイプ)です。接続すると、`viewport_state` に保存されているカメラ情報を上書きします。 | LOAD3DCAMERA | いいえ | - | +| `width` | ビューポートのレンダリング幅(ピクセル単位)です(デフォルト: 1024)。 | INT | はい | 1〜4096 | +| `height` | ビューポートのレンダリング高さ(ピクセル単位)です(デフォルト: 1024)。 | INT | はい | 1〜4096 | + +注: `model_3d_info` と `camera_info` はオプションです。どちらかの入力が接続されていない場合、ノードは `viewport_state` に保存されている対応する値にフォールバックします。 ## 出力 | 出力名 | 説明 | データ型 | |-------------|-------------|-----------| -| `model_3d` | 入力からそのまま通過した3Dモデルファイルです。 | FILE3D | -| `model_3d_info` | ビューポート状態またはオプションの入力からのモデル情報です。 | LOAD3DMODELINFO | -| `camera_info` | ビューポート状態またはオプションの入力からのカメラ情報です。 | LOAD3DCAMERA | -| `width` | 入力からそのまま通過した幅の値です。 | INT | -| `height` | 入力からそのまま通過した高さの値です。 | INT | +| `model_3d` | 入力から渡された3Dモデルファイルです。 | FILE3D | +| `model_3d_info` | シーン内の各モデルの配置(位置、回転、スケール)です。Y-up ワールド空間で表されます。 | LOAD3DMODELINFO | +| `camera_info` | ビューポートのカメラ情報(位置、注視ターゲット、ズーム、タイプ)です。 | LOAD3DCAMERA | +| `width` | 入力から渡されたレンダリング幅の値です。 | INT | +| `height` | 入力から渡されたレンダリング高さの値です。 | INT | > このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Save3DAdvanced/ja.md) --- -**Source fingerprint (SHA-256):** `2c7d42b1875bb292e675526a2b38fcc8856c8ac45de25ac7b69d92323f0b7ae0` +**Source fingerprint (SHA-256):** `27cb15c5cf382e6e5b8164cfd456993404222c61d59edff2d51f9f1c8e47b25f` diff --git a/comfyui_embedded_docs/docs/Save3DAdvanced/ko.md b/comfyui_embedded_docs/docs/Save3DAdvanced/ko.md index e428d7eb1..35d482f14 100644 --- a/comfyui_embedded_docs/docs/Save3DAdvanced/ko.md +++ b/comfyui_embedded_docs/docs/Save3DAdvanced/ko.md @@ -1,31 +1,32 @@ # 3D 저장 (고급) -이 노드는 ComfyUI 출력 디렉토리에 3D 모델을 파일로 저장하며, 출력 크기와 카메라/뷰포트 설정을 고급 제어할 수 있습니다. 또한 다운스트림 노드를 위해 3D 모델, 모델 정보, 카메라 정보 및 크기를 전달합니다. +Save3DAdvanced 노드는 3D 모델을 ComfyUI 출력 디렉터리에 파일로 저장하고 저장된 장면의 미리 보기를 생성합니다. 또한 3D 모델, 장면 내 배치, 카메라 정보 및 뷰포트 크기를 다운스트림 노드로 전달합니다. 모델 배치 또는 카메라 정보가 연결되지 않은 경우, 이 노드는 뷰포트 상태에 저장된 값을 사용합니다. ## 입력 -| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +| 매개변수 | 설명 | 데이터 유형 | 필수 여부 | 범위 | |-----------|-------------|-----------|----------|-------| -| `model_3d` | 상위 3D 노드의 3D 모델 파일입니다. | FILE3D | 예 | GLB
GLTF
FBX
OBJ
STL
USDZ
임의 | -| `filename_prefix` | 저장된 파일 이름의 접두사입니다(기본값: "3d/ComfyUI"). | STRING | 예 | 자유 텍스트 | -| `viewport_state` | 3D 로드 노드의 뷰포트 상태로, 카메라 및 모델 정보를 포함합니다. | LOAD3D | 예 | - | -| `model_3d_info` | 뷰포트 상태를 재정의하는 선택적 3D 모델 정보입니다. | LOAD3DMODELINFO | 아니요 | - | -| `camera_info` | 뷰포트 상태를 재정의하는 선택적 카메라 정보입니다. | LOAD3DCAMERA | 아니요 | - | -| `width` | 출력 미리보기의 픽셀 너비입니다(기본값: 1024). | INT | 예 | 1 ~ 4096 | -| `height` | 출력 미리보기의 픽셀 높이입니다(기본값: 1024). | INT | 예 | 1 ~ 4096 | -참고: `model_3d_info` 또는 `camera_info`가 연결되지 않은 경우, 노드는 `viewport_state`에 저장된 값을 사용합니다. +| `model_3d` | 업스트림 3D 노드에서 받은 3D 모델 파일입니다. | FILE3D | 예 | GLB
GLTF
FBX
OBJ
STL
USDZ
Any | +| `filename_prefix` | 저장되는 파일 이름에 사용할 접두사입니다(기본값: "3d/ComfyUI"). | STRING | 예 | Free text | +| `viewport_state` | 카메라와 모델 배치 정보가 포함된 뷰포트 상태이며, 일반적으로 Load 3D 노드에서 가져옵니다. | LOAD3D | 예 | - | +| `model_3d_info` | 장면 내 각 모델의 배치(Y-up 월드 공간 기준 위치, 회전, 크기)입니다. 연결되면 `viewport_state`에 저장된 모델 배치를 재정의합니다. | LOAD3DMODELINFO | 아니요 | - | +| `camera_info` | 뷰포트 카메라 정보(위치, 주시 대상, 줌, 유형)입니다. 연결되면 `viewport_state`에 저장된 카메라 정보를 재정의합니다. | LOAD3DCAMERA | 아니요 | - | +| `width` | 뷰포트의 렌더 너비(픽셀)입니다(기본값: 1024). | INT | 예 | 1~4096 | +| `height` | 뷰포트의 렌더 높이(픽셀)입니다(기본값: 1024). | INT | 예 | 1~4096 | + +참고: `model_3d_info`와 `camera_info`는 선택 입력입니다. 두 입력 중 연결되지 않은 입력이 있으면, 이 노드는 `viewport_state`에 저장된 해당 값을 대신 사용합니다. ## 출력 -| 출력 이름 | 설명 | 데이터 타입 | +| 출력 이름 | 설명 | 데이터 유형 | |-------------|-------------|-----------| | `model_3d` | 입력에서 전달된 3D 모델 파일입니다. | FILE3D | -| `model_3d_info` | 뷰포트 상태 또는 선택적 입력에서 가져온 모델 정보입니다. | LOAD3DMODELINFO | -| `camera_info` | 뷰포트 상태 또는 선택적 입력에서 가져온 카메라 정보입니다. | LOAD3DCAMERA | -| `width` | 입력에서 전달된 너비 값입니다. | INT | -| `height` | 입력에서 전달된 높이 값입니다. | INT | +| `model_3d_info` | 장면 내 각 모델의 배치(Y-up 월드 공간 기준 위치, 회전, 크기)입니다. | LOAD3DMODELINFO | +| `camera_info` | 뷰포트 카메라 정보(위치, 주시 대상, 줌, 유형)입니다. | LOAD3DCAMERA | +| `width` | 입력에서 전달된 렌더 너비 값입니다. | INT | +| `height` | 입력에서 전달된 렌더 높이 값입니다. | INT | > 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Save3DAdvanced/ko.md) --- -**Source fingerprint (SHA-256):** `2c7d42b1875bb292e675526a2b38fcc8856c8ac45de25ac7b69d92323f0b7ae0` +**Source fingerprint (SHA-256):** `27cb15c5cf382e6e5b8164cfd456993404222c61d59edff2d51f9f1c8e47b25f` diff --git a/comfyui_embedded_docs/docs/Save3DAdvanced/pt-BR.md b/comfyui_embedded_docs/docs/Save3DAdvanced/pt-BR.md index 8d596665f..61381541b 100644 --- a/comfyui_embedded_docs/docs/Save3DAdvanced/pt-BR.md +++ b/comfyui_embedded_docs/docs/Save3DAdvanced/pt-BR.md @@ -1,31 +1,32 @@ # Salvar 3D (Avançado) -Este nó salva um modelo 3D em um arquivo no diretório de saída do ComfyUI, com controle avançado sobre as dimensões de saída e as configurações de câmera/viewport. Ele também encaminha o modelo 3D, as informações do modelo, as informações da câmera e as dimensões para nós subsequentes. +Save3DAdvanced salva um modelo 3D em um arquivo no diretório de saída do ComfyUI e cria uma prévia da cena salva. Ele também repassa o modelo 3D, seu posicionamento na cena, informações da câmera e dimensões da viewport para os nós a jusante. Quando não há conexão para o posicionamento do modelo ou para as informações da câmera, o nó usa os valores armazenados no estado da viewport. ## Entradas -| Parâmetro | Descrição | Tipo de Dado | Obrigatório | Faixa | +| Parâmetro | Descrição | Tipo de dados | Obrigatório | Intervalo | |-----------|-------------|-----------|----------|-------| -| `model_3d` | Arquivo de modelo 3D proveniente de um nó 3D anterior. | FILE3D | Sim | GLB
GLTF
FBX
OBJ
STL
USDZ
Qualquer | -| `filename_prefix` | Prefixo para o nome do arquivo salvo (padrão: "3d/ComfyUI"). | STRING | Sim | Texto livre | -| `viewport_state` | Estado do viewport proveniente de um nó Carregar 3D, contendo informações da câmera e do modelo. | LOAD3D | Sim | - | -| `model_3d_info` | Informações opcionais do modelo 3D para substituir o estado do viewport. | LOAD3DMODELINFO | Não | - | -| `camera_info` | Informações opcionais da câmera para substituir o estado do viewport. | LOAD3DCAMERA | Não | - | -| `width` | Largura da pré-visualização de saída em pixels (padrão: 1024). | INT | Sim | 1 a 4096 | -| `height` | Altura da pré-visualização de saída em pixels (padrão: 1024). | INT | Sim | 1 a 4096 | -Observação: quando `model_3d_info` ou `camera_info` não estão conectados, o nó usa os valores armazenados em `viewport_state`. +| `model_3d` | Arquivo de modelo 3D de um nó 3D a montante. | FILE3D | Sim | GLB
GLTF
FBX
OBJ
STL
USDZ
Any | +| `filename_prefix` | Prefixo usado para o nome do arquivo salvo (padrão: "3d/ComfyUI"). | STRING | Sim | Texto livre | +| `viewport_state` | Estado da viewport contendo informações de câmera e posicionamento do modelo, normalmente de um nó Load 3D. | LOAD3D | Sim | - | +| `model_3d_info` | Posicionamento de cada modelo na cena: posição, rotação e escala (espaço de mundo com Y para cima). Substitui o posicionamento do modelo armazenado em `viewport_state` quando conectado. | LOAD3DMODELINFO | Não | - | +| `camera_info` | Informações da câmera da viewport: posição, alvo de mira, zoom e tipo. Substitui as informações da câmera armazenadas em `viewport_state` quando conectado. | LOAD3DCAMERA | Não | - | +| `width` | Largura de renderização da viewport em pixels (padrão: 1024). | INT | Sim | 1 a 4096 | +| `height` | Altura de renderização da viewport em pixels (padrão: 1024). | INT | Sim | 1 a 4096 | + +Nota: `model_3d_info` e `camera_info` são opcionais. Quando qualquer uma das entradas não estiver conectada, o nó recorre aos valores correspondentes armazenados em `viewport_state`. ## Saídas -| Nome da Saída | Descrição | Tipo de Dado | +| Nome da saída | Descrição | Tipo de dados | |-------------|-------------|-----------| -| `model_3d` | O arquivo de modelo 3D encaminhado da entrada. | FILE3D | -| `model_3d_info` | Informações do modelo, seja do estado do viewport ou da entrada opcional. | LOAD3DMODELINFO | -| `camera_info` | Informações da câmera, seja do estado do viewport ou da entrada opcional. | LOAD3DCAMERA | -| `width` | O valor da largura encaminhado da entrada. | INT | -| `height` | O valor da altura encaminhado da entrada. | INT | +| `model_3d` | O arquivo de modelo 3D repassado a partir da entrada. | FILE3D | +| `model_3d_info` | Posicionamento de cada modelo na cena: posição, rotação e escala (espaço de mundo com Y para cima). | LOAD3DMODELINFO | +| `camera_info` | Informações da câmera da viewport: posição, alvo de mira, zoom e tipo. | LOAD3DCAMERA | +| `width` | O valor de largura de renderização repassado a partir da entrada. | INT | +| `height` | O valor de altura de renderização repassado a partir da entrada. | INT | > 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/Save3DAdvanced/pt-BR.md) --- -**Source fingerprint (SHA-256):** `2c7d42b1875bb292e675526a2b38fcc8856c8ac45de25ac7b69d92323f0b7ae0` +**Source fingerprint (SHA-256):** `27cb15c5cf382e6e5b8164cfd456993404222c61d59edff2d51f9f1c8e47b25f` diff --git a/comfyui_embedded_docs/docs/Save3DAdvanced/ru.md b/comfyui_embedded_docs/docs/Save3DAdvanced/ru.md index f40d479a6..8d586bb2d 100644 --- a/comfyui_embedded_docs/docs/Save3DAdvanced/ru.md +++ b/comfyui_embedded_docs/docs/Save3DAdvanced/ru.md @@ -1,31 +1,32 @@ # Сохранить 3D (расширенно) -Этот узел сохраняет 3D-модель в файл в выходной директории ComfyUI с расширенным контролем над размерами вывода и настройками камеры/области просмотра. Он также передаёт 3D-модель, информацию о модели, информацию о камере и размеры для последующих узлов. +Save3DAdvanced сохраняет 3D-модель в файл в выходном каталоге ComfyUI и создает предварительный просмотр сохраненной сцены. Он также передает 3D-модель, ее размещение в сцене, информацию о камере и размеры окна просмотра последующим узлам. Если размещение модели или информация о камере не подключены, узел использует значения, хранящиеся в состоянии окна просмотра. ## Входы | Параметр | Описание | Тип данных | Обязательный | Диапазон | |-----------|-------------|-----------|----------|-------| -| `model_3d` | Файл 3D-модели из вышестоящего 3D-узла. | FILE3D | Да | GLB
GLTF
FBX
OBJ
STL
USDZ
Любой | -| `filename_prefix` | Префикс для имени сохраняемого файла (по умолчанию: "3d/ComfyUI"). | STRING | Да | Произвольный текст | -| `viewport_state` | Состояние области просмотра из узла "Загрузить 3D", содержащее информацию о камере и модели. | LOAD3D | Да | - | -| `model_3d_info` | Необязательная информация о 3D-модели для переопределения состояния области просмотра. | LOAD3DMODELINFO | Нет | - | -| `camera_info` | Необязательная информация о камере для переопределения состояния области просмотра. | LOAD3DCAMERA | Нет | - | -| `width` | Ширина предварительного просмотра вывода в пикселях (по умолчанию: 1024). | INT | Да | от 1 до 4096 | -| `height` | Высота предварительного просмотра вывода в пикселях (по умолчанию: 1024). | INT | Да | от 1 до 4096 | -Примечание: если `model_3d_info` или `camera_info` не подключены, узел использует значения, сохраненные в `viewport_state`. +| `model_3d` | Файл 3D-модели из вышестоящего 3D-узла. | FILE3D | Да | GLB
GLTF
FBX
OBJ
STL
USDZ
Any | +| `filename_prefix` | Префикс для имени сохраняемого файла (по умолчанию: "3d/ComfyUI"). | STRING | Да | Free text | +| `viewport_state` | Состояние окна просмотра, содержащее информацию о камере и размещении модели, обычно от узла Load 3D. | LOAD3D | Да | - | +| `model_3d_info` | Размещение каждой модели в сцене: позиция, поворот и масштаб (мировое пространство с осью Y вверх). При подключении переопределяет размещение модели, сохраненное в `viewport_state`. | LOAD3DMODELINFO | Нет | - | +| `camera_info` | Информация о камере окна просмотра: позиция, цель (точка взгляда), масштаб и тип. При подключении переопределяет информацию о камере, сохраненную в `viewport_state`. | LOAD3DCAMERA | Нет | - | +| `width` | Ширина рендеринга окна просмотра в пикселях (по умолчанию: 1024). | INT | Да | 1 до 4096 | +| `height` | Высота рендеринга окна просмотра в пикселях (по умолчанию: 1024). | INT | Да | 1 до 4096 | + +Примечание: `model_3d_info` и `camera_info` являются необязательными. Если какой-либо из этих входов не подключен, узел использует соответствующие значения, сохраненные в `viewport_state`. ## Выходы | Имя выхода | Описание | Тип данных | |-------------|-------------|-----------| -| `model_3d` | Файл 3D-модели, переданный из входных данных. | FILE3D | -| `model_3d_info` | Информация о модели, либо из состояния области просмотра, либо из необязательного входного параметра. | LOAD3DMODELINFO | -| `camera_info` | Информация о камере, либо из состояния области просмотра, либо из необязательного входного параметра. | LOAD3DCAMERA | -| `width` | Значение ширины, переданное из входных данных. | INT | -| `height` | Значение высоты, переданное из входных данных. | INT | +| `model_3d` | Файл 3D-модели, переданный со входа. | FILE3D | +| `model_3d_info` | Размещение каждой модели в сцене: позиция, поворот и масштаб (мировое пространство с осью Y вверх). | LOAD3DMODELINFO | +| `camera_info` | Информация о камере окна просмотра: позиция, цель (точка взгляда), масштаб и тип. | LOAD3DCAMERA | +| `width` | Значение ширины рендеринга, переданное со входа. | INT | +| `height` | Значение высоты рендеринга, переданное со входа. | INT | > Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Save3DAdvanced/ru.md) --- -**Source fingerprint (SHA-256):** `2c7d42b1875bb292e675526a2b38fcc8856c8ac45de25ac7b69d92323f0b7ae0` +**Source fingerprint (SHA-256):** `27cb15c5cf382e6e5b8164cfd456993404222c61d59edff2d51f9f1c8e47b25f` diff --git a/comfyui_embedded_docs/docs/Save3DAdvanced/tr.md b/comfyui_embedded_docs/docs/Save3DAdvanced/tr.md index 7cefe4c58..3b7796744 100644 --- a/comfyui_embedded_docs/docs/Save3DAdvanced/tr.md +++ b/comfyui_embedded_docs/docs/Save3DAdvanced/tr.md @@ -1,31 +1,32 @@ # 3D Kaydet (Gelişmiş) -Bu düğüm, ComfyUI çıktı dizininde bir 3B modeli dosyaya kaydeder ve çıktı boyutları ile kamera/görüntü alanı ayarları üzerinde gelişmiş kontrol sağlar. Ayrıca 3B modeli, model bilgilerini, kamera bilgilerini ve boyutları alt akış düğümlerine iletir. +Save3DAdvanced, bir 3D modeli ComfyUI çıktı dizinindeki bir dosyaya kaydeder ve kaydedilen sahnenin bir önizlemesini oluşturur. Ayrıca 3D modeli, modelin sahnedeki yerleşimini, kamera bilgilerini ve görünüm alanı boyutlarını sonraki düğümlere iletir. Model yerleşimi veya kamera bilgileri bağlanmadığında, düğüm görünüm alanı durumunda saklanan değerleri kullanır. -## Girişler +## Girdiler | Parametre | Açıklama | Veri Türü | Zorunlu | Aralık | -|-----------|----------|-----------|----------|--------| -| `3D model` | Bir üst akış 3B düğümünden gelen 3B model dosyası. | FILE3D | Evet | GLB
GLTF
FBX
OBJ
STL
USDZ
Herhangi | -| `dosya adı ön eki` | Kaydedilen dosya adı için ön ek (varsayılan: "3d/ComfyUI"). | STRING | Evet | Serbest metin | -| `görünüm durumu` | Bir 3B Yükle düğümünden gelen, kamera ve model bilgilerini içeren görüntü alanı durumu. | LOAD3D | Evet | - | -| `3D model bilgisi` | Görüntü alanı durumunu geçersiz kılmak için isteğe bağlı 3B model bilgisi. | LOAD3DMODELINFO | Hayır | - | -| `kamera bilgisi` | Görüntü alanı durumunu geçersiz kılmak için isteğe bağlı kamera bilgisi. | LOAD3DCAMERA | Hayır | - | -| `genişlik` | Çıktı ön izlemesinin piksel cinsinden genişliği (varsayılan: 1024). | INT | Evet | 1 ila 4096 | -| `yükseklik` | Çıktı ön izlemesinin piksel cinsinden yüksekliği (varsayılan: 1024). | INT | Evet | 1 ila 4096 | -Not: `model_3d_info` veya `camera_info` bağlı değilse, düğüm `viewport_state` içinde saklanan değerleri kullanır. +|-----------|-------------|-----------|----------|-------| +| `3D model` | Önceki bir 3D düğümünden gelen 3D model dosyası. | FILE3D | Evet | GLB
GLTF
FBX
OBJ
STL
USDZ
Any | +| `dosya adı ön eki` | Kaydedilen dosya adı için kullanılan önek (varsayılan: "3d/ComfyUI"). | STRING | Evet | Free text | +| `görünüm durumu` | Kamera ve model yerleşim bilgilerini içeren görünüm alanı durumu; genellikle bir Load 3D düğümünden gelir. | LOAD3D | Evet | - | +| `3D model bilgisi` | Sahnedeki her modelin yerleşimi: konum, dönüş ve ölçek (Y-up dünya uzayı). Bağlandığında `viewport_state` içinde saklanan model yerleşimini geçersiz kılar. | LOAD3DMODELINFO | Hayır | - | +| `kamera bilgisi` | Görünüm alanı kamera bilgileri: konum, bakış hedefi, yakınlaştırma ve tür. Bağlandığında `viewport_state` içinde saklanan kamera bilgilerini geçersiz kılar. | LOAD3DCAMERA | Hayır | - | +| `genişlik` | Görünüm alanının piksel cinsinden render genişliği (varsayılan: 1024). | INT | Evet | 1 ile 4096 | +| `yükseklik` | Görünüm alanının piksel cinsinden render yüksekliği (varsayılan: 1024). | INT | Evet | 1 ile 4096 | + +Not: `model_3d_info` ve `camera_info` isteğe bağlıdır. Bu girdilerden herhangi biri bağlanmadığında, düğüm `viewport_state` içinde saklanan karşılık gelen değerleri kullanır. ## Çıktılar | Çıktı Adı | Açıklama | Veri Türü | -|-----------|----------|-----------| -| `3D model` | Girişten iletilen 3B model dosyası. | FILE3D | -| `3D model bilgisi` | Görüntü alanı durumundan veya isteğe bağlı girişten alınan model bilgisi. | LOAD3DMODELINFO | -| `kamera bilgisi` | Görüntü alanı durumundan veya isteğe bağlı girişten alınan kamera bilgisi. | LOAD3DCAMERA | -| `genişlik` | Girişten iletilen genişlik değeri. | INT | -| `yükseklik` | Girişten iletilen yükseklik değeri. | INT | +|-------------|-------------|-----------| +| `3D model` | Girdiden olduğu gibi iletilen 3D model dosyası. | FILE3D | +| `3D model bilgisi` | Sahnedeki her modelin yerleşimi: konum, dönüş ve ölçek (Y-up dünya uzayı). | LOAD3DMODELINFO | +| `kamera bilgisi` | Görünüm alanı kamera bilgileri: konum, bakış hedefi, yakınlaştırma ve tür. | LOAD3DCAMERA | +| `genişlik` | Girdiden olduğu gibi iletilen render genişliği değeri. | INT | +| `yükseklik` | Girdiden olduğu gibi iletilen render yüksekliği değeri. | INT | > 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/Save3DAdvanced/tr.md) --- -**Source fingerprint (SHA-256):** `2c7d42b1875bb292e675526a2b38fcc8856c8ac45de25ac7b69d92323f0b7ae0` +**Source fingerprint (SHA-256):** `27cb15c5cf382e6e5b8164cfd456993404222c61d59edff2d51f9f1c8e47b25f` diff --git a/comfyui_embedded_docs/docs/Save3DAdvanced/zh-TW.md b/comfyui_embedded_docs/docs/Save3DAdvanced/zh-TW.md index 3a4739e7d..3813569d1 100644 --- a/comfyui_embedded_docs/docs/Save3DAdvanced/zh-TW.md +++ b/comfyui_embedded_docs/docs/Save3DAdvanced/zh-TW.md @@ -1,31 +1,32 @@ # 儲存 3D(進階) -此節點將 3D 模型儲存到 ComfyUI 輸出目錄中的檔案,並提供對輸出尺寸及攝影機/視埠設定的進階控制。它也會將 3D 模型、模型資訊、攝影機資訊和尺寸傳遞給下游節點。 +Save3DAdvanced 會將 3D 模型儲存至 ComfyUI 輸出目錄中的檔案,並建立已儲存場景的預覽。同時,它會將 3D 模型、模型在場景中的擺放位置、相機資訊與視埠尺寸傳遞至下游節點。當未連接模型擺放位置或相機資訊時,此節點會使用視埠狀態中儲存的值。 -## ## 輸入 +## 輸入 | 參數 | 描述 | 資料類型 | 必要 | 範圍 | |-----------|-------------|-----------|----------|-------| -| `model_3d` | 來自上游 3D 節點的 3D 模型檔案。 | FILE3D | 是 | GLB
GLTF
FBX
OBJ
STL
USDZ
任意 | -| `filename_prefix` | 儲存檔案名稱的前綴(預設:"3d/ComfyUI")。 | STRING | 是 | 自由文字 | -| `viewport_state` | 來自「載入 3D」節點的視埠狀態,包含攝影機和模型資訊。 | LOAD3D | 是 | - | -| `model_3d_info` | 可選的 3D 模型資訊,用於覆蓋視埠狀態。 | LOAD3DMODELINFO | 否 | - | -| `camera_info` | 可選的攝影機資訊,用於覆蓋視埠狀態。 | LOAD3DCAMERA | 否 | - | -| `width` | 輸出預覽的寬度(像素,預設:1024)。 | INT | 是 | 1 至 4096 | -| `height` | 輸出預覽的高度(像素,預設:1024)。 | INT | 是 | 1 至 4096 | -注意:當 `model_3d_info` 或 `camera_info` 未連接時,節點將回退使用 `viewport_state` 中儲存的值。 - -## ## 輸出 - -| 輸出名稱 | 描述 | 資料類型 | +| `model_3d` | 來自上游 3D 節點的 3D 模型檔案。 | FILE3D | 是 | GLB
GLTF
FBX
OBJ
STL
USDZ
Any | +| `filename_prefix` | 用於已儲存檔案名稱的前置詞(預設:"3d/ComfyUI")。 | STRING | 是 | Free text | +| `viewport_state` | 包含相機與模型擺放資訊的視埠狀態,通常來自 Load 3D 節點。 | LOAD3D | 是 | - | +| `model_3d_info` | 場景中每個模型的擺放資訊:位置、旋轉與縮放(Y 軸向上的世界空間)。連接時會覆寫儲存在 `viewport_state` 中的模型擺放資訊。 | LOAD3DMODELINFO | 否 | - | +| `camera_info` | 視埠相機資訊:位置、凝視目標、縮放與類型。連接時會覆寫儲存在 `viewport_state` 中的相機資訊。 | LOAD3DCAMERA | 否 | - | +| `width` | 視埠的渲染寬度(像素)(預設:1024)。 | INT | 是 | 1至4096 | +| `height` | 視埠的渲染高度(像素)(預設:1024)。 | INT | 是 | 1至4096 | + +注意:`model_3d_info` 與 `camera_info` 為選用。當任一輸入未連接時,此節點會改用儲存在 `viewport_state` 中的對應值。 + +## 輸出 + +| 輸出名 | 描述 | 資料類型 | |-------------|-------------|-----------| -| `model_3d` | 從輸入傳遞而來的 3D 模型檔案。 | FILE3D | -| `model_3d_info` | 模型資訊,來自視埠狀態或可選輸入。 | LOAD3DMODELINFO | -| `camera_info` | 攝影機資訊,來自視埠狀態或可選輸入。 | LOAD3DCAMERA | -| `width` | 從輸入傳遞而來的寬度值。 | INT | -| `height` | 從輸入傳遞而來的高度值。 | INT | +| `model_3d` | 從輸入端傳遞而出的 3D 模型檔案。 | FILE3D | +| `model_3d_info` | 場景中每個模型的擺放資訊:位置、旋轉與縮放(Y 軸向上的世界空間)。 | LOAD3DMODELINFO | +| `camera_info` | 視埠相機資訊:位置、凝視目標、縮放與類型。 | LOAD3DCAMERA | +| `width` | 從輸入端傳遞而出的渲染寬度值。 | INT | +| `height` | 從輸入端傳遞而出的渲染高度值。 | INT | > 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Save3DAdvanced/zh-TW.md) --- -**Source fingerprint (SHA-256):** `2c7d42b1875bb292e675526a2b38fcc8856c8ac45de25ac7b69d92323f0b7ae0` +**Source fingerprint (SHA-256):** `27cb15c5cf382e6e5b8164cfd456993404222c61d59edff2d51f9f1c8e47b25f` diff --git a/comfyui_embedded_docs/docs/Save3DAdvanced/zh.md b/comfyui_embedded_docs/docs/Save3DAdvanced/zh.md index a9c6bd31e..45d999aa3 100644 --- a/comfyui_embedded_docs/docs/Save3DAdvanced/zh.md +++ b/comfyui_embedded_docs/docs/Save3DAdvanced/zh.md @@ -1,31 +1,32 @@ # 保存 3D(高级) -此节点将 3D 模型保存到 ComfyUI 输出目录中的文件,并可对输出尺寸和相机/视口设置进行高级控制。它还会将 3D 模型、模型信息、相机信息和尺寸传递到下游节点。 +Save3DAdvanced 将 3D 模型保存到 ComfyUI 输出目录中的文件中,并创建所保存场景的预览。它还会将 3D 模型、其在场景中的位置、相机信息和视口尺寸传递到下游节点。当模型位置或相机信息未连接时,该节点使用视口状态中存储的值。 -## ## 输入 +## 输入 | 参数 | 描述 | 数据类型 | 是否必需 | 范围 | |-----------|-------------|-----------|----------|-------| -| `model_3d` | 来自上游 3D 节点的 3D 模型文件。 | FILE3D | 是 | GLB
GLTF
FBX
OBJ
STL
USDZ
任意 | -| `filename_prefix` | 保存文件名的前缀(默认值:"3d/ComfyUI")。 | STRING | 是 | 自由文本 | -| `viewport_state` | 来自加载 3D 节点的视口状态,包含相机和模型信息。 | LOAD3D | 是 | - | -| `model_3d_info` | 可选的 3D 模型信息,用于覆盖视口状态。 | LOAD3DMODELINFO | 否 | - | -| `camera_info` | 可选的相机信息,用于覆盖视口状态。 | LOAD3DCAMERA | 否 | - | -| `width` | 输出预览的宽度(像素,默认值:1024)。 | INT | 是 | 1 到 4096 | -| `height` | 输出预览的高度(像素,默认值:1024)。 | INT | 是 | 1 到 4096 | -注意:当 `model_3d_info` 或 `camera_info` 未连接时,节点将回退使用 `viewport_state` 中存储的值。 - -## ## 输出 - -| 输出名 | 描述 | 数据类型 | +| `model_3d` | 来自上游 3D 节点的 3D 模型文件。 | FILE3D | 是 | GLB
GLTF
FBX
OBJ
STL
USDZ
Any | +| `filename_prefix` | 用于保存文件名的前缀(默认:"3d/ComfyUI")。 | STRING | 是 | 自由文本 | +| `viewport_state` | 包含相机和模型位置信息的视口状态,通常来自 Load 3D 节点。 | LOAD3D | 是 | - | +| `model_3d_info` | 场景中每个模型的位置:位置、旋转和缩放(采用 Y 轴向上的世界空间)。连接时覆盖 `viewport_state` 中存储的模型位置。 | LOAD3DMODELINFO | 否 | - | +| `camera_info` | 视口相机信息:位置、注视目标、缩放和类型。连接时覆盖 `viewport_state` 中存储的相机信息。 | LOAD3DCAMERA | 否 | - | +| `width` | 视口的渲染宽度(以像素为单位,默认:1024)。 | INT | 是 | 1 至 4096 | +| `height` | 视口的渲染高度(以像素为单位,默认:1024)。 | INT | 是 | 1 至 4096 | + +注意:`model_3d_info` 和 `camera_info` 是可选的。当任一输入未连接时,节点将回退到 `viewport_state` 中存储的相应值。 + +## 输出 + +| 输出名称 | 描述 | 数据类型 | |-------------|-------------|-----------| -| `model_3d` | 从输入传递过来的 3D 模型文件。 | FILE3D | -| `model_3d_info` | 模型信息,来自视口状态或可选输入。 | LOAD3DMODELINFO | -| `camera_info` | 相机信息,来自视口状态或可选输入。 | LOAD3DCAMERA | -| `width` | 从输入传递过来的宽度值。 | INT | -| `height` | 从输入传递过来的高度值。 | INT | +| `model_3d` | 从输入透传的 3D 模型文件。 | FILE3D | +| `model_3d_info` | 场景中每个模型的位置:位置、旋转和缩放(采用 Y 轴向上的世界空间)。 | LOAD3DMODELINFO | +| `camera_info` | 视口相机信息:位置、注视目标、缩放和类型。 | LOAD3DCAMERA | +| `width` | 从输入透传的渲染宽度值。 | INT | +| `height` | 从输入透传的渲染高度值。 | INT | > 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Save3DAdvanced/zh.md) --- -**Source fingerprint (SHA-256):** `2c7d42b1875bb292e675526a2b38fcc8856c8ac45de25ac7b69d92323f0b7ae0` +**Source fingerprint (SHA-256):** `27cb15c5cf382e6e5b8164cfd456993404222c61d59edff2d51f9f1c8e47b25f` diff --git a/comfyui_embedded_docs/docs/TextOverlay/ar.md b/comfyui_embedded_docs/docs/TextOverlay/ar.md index 791cb08dd..0fa501887 100644 --- a/comfyui_embedded_docs/docs/TextOverlay/ar.md +++ b/comfyui_embedded_docs/docs/TextOverlay/ar.md @@ -1,25 +1,26 @@ # إضافة نص على الصورة -هذه العقدة ترسم نصًا فوق صورة أو مجموعة من الصور. تقوم بإنشاء طبقة نصية مع خيارات تخصيص لحجم الخط واللون والموضع والمحاذاة، مع إمكانية إضافة إطار خارجي اختياري، ثم تدمج النص مع الصور الأصلية. +هذا العقد يرسم نصًا فوق صورة أو دفعة من الصور. ينشئ تراكبًا نصيًا بحجم خط قابل للضبط، ولون، وموضع رأسي، ومحاذاة أفقية، ومخطط أسود اختياري، ثم يُركّب التراكب على الصور الأصلية. ## المدخلات -| المعامل | الوصف | نوع البيانات | إجباري | النطاق | -|---------|-------|---------------|---------|--------| -| `الصور` | الصورة المدخلة أو مجموعة الصور لرسم النص عليها | IMAGE | نعم | | -| `النص` | النص المراد تركيبه على الصورة (الافتراضي: ""). يدعم أسطرًا متعددة؛ يتم تحويل تسلسلات الهروب `\n` و `\t` إلى أسطر جديدة وتبويبات، ويتم التفاف النص تلقائيًا ليتناسب مع عرض الصورة. | STRING | نعم | | -| `حجم الخط` | حجم الخط كنسبة مئوية من ارتفاع الصورة (الافتراضي: 5.0) | FLOAT | نعم | 0.5 إلى 50.0 (خطوة 0.5) | +| المعامل | الوصف | نوع البيانات | مطلوب | النطاق | +|-----------|-------------|-----------|----------|-------| +| `الصور` | صورة الإدخال أو دفعة الصور التي سيُرسَم النص عليها | IMAGE | نعم | | +| `النص` | النص الذي سيُركَّب على الصورة (الافتراضي: ""). يدعم عدة أسطر: يتم تحويل تسلسلي الهروب `\n` و `\t` إلى أسطر جديدة وتبويبات، كما تُلتفّ الأسطر الطويلة تلقائيًا لتناسب عرض الصورة. | STRING | نعم | | +| `حجم الخط` | حجم الخط كنسبة مئوية من ارتفاع الصورة (الافتراضي: 5.0) | FLOAT | نعم | 0.5 إلى 50.0 (الخطوة 0.5) | | `اللون` | لون النص (الافتراضي: "#ffffff") | STRING | نعم | | -| `الموضع` | الموضع الرأسي للنص على الصورة (الافتراضي: "أعلى") | COMBO | نعم | `"أعلى"`
`"أسفل"` | -| `محاذاة` | المحاذاة الأفقية للنص (الافتراضي: "يسار") | COMBO | نعم | `"يسار"`
`"وسط"`
`"يمين"` | -| `حد خارجي` | رسم إطار خارجي أسود حول النص (الافتراضي: صحيح) | BOOLEAN | نعم | | -ملاحظة: إذا كان `text` فارغًا أو يحتوي على مسافات بيضاء فقط، تعيد العقدة الصور المدخلة دون تغيير. يتم تطبيق نفس تركيب النص على كل صورة في الدفعة. بالنسبة للصور ذات قناة ألفا (RGBA)، يتم تركيب النص باستخدام مزج ألفا source-over، وبالتالي يتم الحفاظ على الشفافية الموجودة. +| `الموضع` | الموضع الرأسي للنص على الصورة (الافتراضي: "top") | COMBO | نعم | "top"
"bottom" | +| `محاذاة` | المحاذاة الأفقية للنص (الافتراضي: "left") | COMBO | نعم | "left"
"center"
"right" | +| `حد خارجي` | رسم مخطط أسود حول النص (الافتراضي: True) | BOOLEAN | نعم | | + +ملاحظة: إذا كان `text` فارغًا أو يحتوي على مسافات بيضاء فقط، تُرجع العقدة صور الإدخال دون تغيير. يُولَّد التراكب النصي مرة واحدة ويُطبَّق على كل صورة في الدفعة. ## المخرجات -| اسم المخرج | الوصف | نوع البيانات | -|------------|-------|--------------| -| `الصور` | الصور المدخلة مع طبقة النص المدمجة في الأعلى | IMAGE | +| اسم المخرَج | الوصف | نوع البيانات | +|-------------|-------------|-----------| +| `الصور` | صور الإدخال مع التراكب النصي المُركَّب فوقها | IMAGE | > تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TextOverlay/ar.md) diff --git a/comfyui_embedded_docs/docs/TextOverlay/en.md b/comfyui_embedded_docs/docs/TextOverlay/en.md index cd30eb9e5..1843d1c4d 100644 --- a/comfyui_embedded_docs/docs/TextOverlay/en.md +++ b/comfyui_embedded_docs/docs/TextOverlay/en.md @@ -1,20 +1,20 @@ # Draw Text Overlay -This node draws text on top of an image or a batch of images. It creates a text overlay with customizable font size, color, position, alignment, and an optional outline, then composites the text onto the original images. +This node draws text on top of an image or a batch of images. It builds a text overlay with a configurable font size, color, vertical position, horizontal alignment, and optional black outline, then composites the overlay onto the original images. ## Inputs | Parameter | Description | Data Type | Required | Range | |-----------|-------------|-----------|----------|-------| | `images` | The input image or batch of images to draw text on | IMAGE | Yes | | -| `text` | The text to overlay on the image (default: ""). Supports multiple lines; the `\n` and `\t` escape sequences are converted to newlines and tabs, and the text is automatically wrapped to fit within the image width. | STRING | Yes | | +| `text` | The text to overlay on the image (default: ""). Supports multiple lines: the `\n` and `\t` escape sequences are converted to newlines and tabs, and long lines are automatically wrapped to fit within the image width. | STRING | Yes | | | `font_size` | Font size as a percentage of the image height (default: 5.0) | FLOAT | Yes | 0.5 to 50.0 (step 0.5) | | `color` | Color of the text (default: "#ffffff") | STRING | Yes | | | `position` | Vertical position of the text on the image (default: "top") | COMBO | Yes | "top"
"bottom" | | `align` | Horizontal alignment of the text (default: "left") | COMBO | Yes | "left"
"center"
"right" | | `outline` | Draw a black outline around the text (default: True) | BOOLEAN | Yes | | -Note: If `text` is empty or contains only whitespace, the node returns the input images unchanged. The same text overlay is applied to every image in the batch. For images with an alpha channel (RGBA), the text is composited using source-over alpha blending so the existing transparency is respected. +Note: If `text` is empty or contains only whitespace, the node returns the input images unchanged. The text overlay is rendered once and applied to every image in the batch. ## Outputs diff --git a/comfyui_embedded_docs/docs/TextOverlay/es.md b/comfyui_embedded_docs/docs/TextOverlay/es.md index f01472b80..3e56ea49e 100644 --- a/comfyui_embedded_docs/docs/TextOverlay/es.md +++ b/comfyui_embedded_docs/docs/TextOverlay/es.md @@ -1,24 +1,25 @@ # Superponer texto -Este nodo dibuja texto sobre una imagen o un lote de imágenes. Crea una superposición de texto con tamaño de fuente, color, posición, alineación y un contorno opcional personalizables, y luego compone el texto sobre las imágenes originales. +Este nodo dibuja texto sobre una imagen o un lote de imágenes. Crea una superposición de texto con un tamaño de fuente configurable, color, posición vertical, alineación horizontal y un contorno negro opcional, y luego compone la superposición sobre las imágenes originales. ## Entradas -| Parámetro | Descripción | Tipo de Dato | Obligatorio | Rango | -|-----------|-------------|--------------|-------------|-------| -| `imágenes` | La imagen o lote de imágenes de entrada sobre las que dibujar el texto | IMAGE | Sí | | -| `texto` | El texto a superponer en la imagen (predeterminado: ""). Admite varias líneas; las secuencias de escape `\n` y `\t` se convierten en saltos de línea y tabulaciones, y el texto se ajusta automáticamente para caber dentro del ancho de la imagen. | STRING | Sí | | -| `tamaño de fuente` | Tamaño de fuente como porcentaje de la altura de la imagen (predeterminado: 5.0) | FLOAT | Sí | 0.5 a 50.0 (paso 0.5) | -| `color` | Color del texto (predeterminado: "#ffffff") | STRING | Sí | | -| `posición` | Posición vertical del texto en la imagen (predeterminado: "top") | COMBO | Sí | `"top"`
`"bottom"` | -| `alineación` | Alineación horizontal del texto (predeterminado: "left") | COMBO | Sí | `"left"`
`"center"`
`"right"` | -| `contorno` | Dibujar un contorno negro alrededor del texto (predeterminado: True) | BOOLEAN | Sí | | -Nota: si `text` está vacío o contiene solo espacios en blanco, el nodo devuelve las imágenes de entrada sin cambios. La misma superposición de texto se aplica a todas las imágenes del lote. Para imágenes con canal alfa (RGBA), el texto se compone mediante una mezcla alfa source-over, por lo que la transparencia existente se respeta. +| Parámetro | Descripción | Tipo de datos | Requerido | Rango | +|-----------|-------------|---------------|-----------|-------| +| `imágenes` | La imagen o lote de imágenes de entrada sobre las que se dibujará el texto | IMAGE | Sí | | +| `texto` | El texto a superponer en la imagen (por defecto: ""). Admite múltiples líneas: las secuencias de escape `\n` y `\t` se convierten en saltos de línea y tabulaciones, y las líneas largas se ajustan automáticamente para caber dentro del ancho de la imagen. | STRING | Sí | | +| `tamaño de fuente` | Tamaño de fuente como porcentaje de la altura de la imagen (por defecto: 5.0) | FLOAT | Sí | 0.5 a 50.0 (paso 0.5) | +| `color` | Color del texto (por defecto: "#ffffff") | STRING | Sí | | +| `posición` | Posición vertical del texto en la imagen (por defecto: "top") | COMBO | Sí | "top"
"bottom" | +| `alineación` | Alineación horizontal del texto (por defecto: "left") | COMBO | Sí | "left"
"center"
"right" | +| `contorno` | Dibujar un contorno negro alrededor del texto (por defecto: True) | BOOLEAN | Sí | | + +Nota: Si `text` está vacío o contiene solo espacios en blanco, el nodo devuelve las imágenes de entrada sin cambios. La superposición de texto se renderiza una vez y se aplica a cada imagen del lote. ## Salidas -| Nombre de Salida | Descripción | Tipo de Dato | -|------------------|-------------|--------------| +| Nombre de salida | Descripción | Tipo de datos | +|------------------|-------------|---------------| | `imágenes` | Las imágenes de entrada con la superposición de texto compuesta encima | 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/TextOverlay/es.md) diff --git a/comfyui_embedded_docs/docs/TextOverlay/fa.md b/comfyui_embedded_docs/docs/TextOverlay/fa.md index bf27b1072..0711db561 100644 --- a/comfyui_embedded_docs/docs/TextOverlay/fa.md +++ b/comfyui_embedded_docs/docs/TextOverlay/fa.md @@ -1,25 +1,26 @@ # افزودن متن به تصویر -این گره متن را روی یک تصویر یا یک دسته از تصاویر رسم می‌کند. یک لایه متنی با اندازه قلم، رنگ، موقعیت، تراز و خط‌نمای اختیاری قابل تنظیم ایجاد کرده و سپس متن را روی تصاویر اصلی ترکیب می‌کند. +این گره متن را روی یک تصویر یا دسته‌ای از تصاویر رسم می‌کند. یک لایه‌ی متنی با اندازه قلم، رنگ، موقعیت عمودی، ترازبندی افقی و حاشیه سیاه اختیاری قابل تنظیم می‌سازد، سپس لایه را روی تصاویر اصلی ترکیب می‌کند. ## ورودی‌ها -| پارامتر | توضیحات | نوع داده | اجباری | محدوده | -|---------|---------|----------|--------|--------| -| `تصاویر` | تصویر ورودی یا دسته تصاویری که قرار است متن روی آن‌ها رسم شود | IMAGE | بله | | -| `متن` | متنی که روی تصویر قرار می‌گیرد (پیش‌فرض: ""). از چند خط پشتیبانی می‌کند؛ دنباله‌های فرار `\n` و `\t` به خطوط جدید و تب تبدیل می‌شوند و متن به‌طور خودکار برای جا شدن در عرض تصویر شکسته می‌شود. | STRING | بله | | +| پارامتر | توضیحات | نوع داده | الزامی | محدوده | +|-----------|-------------|-----------|----------|-------| +| `تصاویر` | تصویر ورودی یا دسته‌ای از تصاویر برای رسم متن روی آن‌ها | IMAGE | بله | | +| `متن` | متنی که روی تصویر قرار می‌گیرد (پیش‌فرض: ""). از چند خط پشتیبانی می‌کند: توالی‌های فرار `\n` و `\t` به خط جدید و تب تبدیل می‌شوند، و خطوط بلند به‌طور خودکار برای جا شدن در عرض تصویر شکسته می‌شوند. | STRING | بله | | | `اندازه فونت` | اندازه قلم به‌صورت درصدی از ارتفاع تصویر (پیش‌فرض: 5.0) | FLOAT | بله | 0.5 تا 50.0 (گام 0.5) | | `رنگ` | رنگ متن (پیش‌فرض: "#ffffff") | STRING | بله | | -| `موقعیت` | موقعیت عمودی متن روی تصویر (پیش‌فرض: "top") | COMBO | بله | `"top"`
`"bottom"` | -| `تراز` | تراز افقی متن (پیش‌فرض: "left") | COMBO | بله | `"left"`
`"center"`
`"right"` | -| `حاشیه` | رسم خط‌نمای مشکی دور متن (پیش‌فرض: True) | BOOLEAN | بله | | -توجه: اگر `text` خالی باشد یا فقط شامل فضای خالی باشد، گره تصاویر ورودی را بدون تغییر برمی‌گرداند. همان متن روی هم قرار گرفته روی هر تصویر در دسته اعمال می‌شود. برای تصاویری که کانال آلفا (RGBA) دارند، متن با ترکیب آلفای source-over ترکیب می‌شود، بنابراین شفافیت موجود حفظ می‌شود. +| `موقعیت` | موقعیت عمودی متن روی تصویر (پیش‌فرض: "top") | COMBO | بله | "top"
"bottom" | +| `تراز` | ترازبندی افقی متن (پیش‌فرض: "left") | COMBO | بله | "left"
"center"
"right" | +| `حاشیه` | رسم یک حاشیه سیاه دور متن (پیش‌فرض: True) | BOOLEAN | بله | | + +توجه: اگر `text` خالی باشد یا فقط فاصله سفید داشته باشد، گره تصاویر ورودی را بدون تغییر برمی‌گرداند. لایه‌ی متنی یک‌بار رندر می‌شود و روی هر تصویر در دسته اعمال می‌گردد. ## خروجی‌ها | نام خروجی | توضیحات | نوع داده | -|-----------|---------|----------| -| `تصاویر` | تصاویر ورودی با لایه متنی ترکیب‌شده روی آن‌ها | IMAGE | +|-------------|-------------|-----------| +| `تصاویر` | تصاویر ورودی با لایه‌ی متنی ترکیب‌شده روی آن‌ها | IMAGE | > این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TextOverlay/fa.md) diff --git a/comfyui_embedded_docs/docs/TextOverlay/fr.md b/comfyui_embedded_docs/docs/TextOverlay/fr.md index 1a9e96225..c46de8866 100644 --- a/comfyui_embedded_docs/docs/TextOverlay/fr.md +++ b/comfyui_embedded_docs/docs/TextOverlay/fr.md @@ -1,25 +1,26 @@ # Superposer du texte -Ce nœud dessine du texte sur une image ou un lot d'images. Il crée une superposition de texte avec une taille de police, une couleur, une position, un alignement et un contour optionnel personnalisables, puis composite le texte sur les images originales. +Ce nœud dessine du texte par-dessus une image ou un lot d'images. Il crée une superposition de texte avec une taille de police configurable, une couleur, une position verticale, un alignement horizontal et un contour noir facultatif, puis applique la superposition sur les images d'origine. ## Entrées | Paramètre | Description | Type de données | Requis | Plage | -|-----------|-------------|-----------------|--------|-------| -| `images` | L'image ou le lot d'images d'entrée sur lequel dessiner le texte | IMAGE | Oui | | -| `texte` | Le texte à superposer sur l'image (par défaut : ""). Prend en charge plusieurs lignes ; les séquences d'échappement `\n` et `\t` sont converties en sauts de ligne et tabulations, et le texte est automatiquement renvoyé à la ligne pour tenir dans la largeur de l'image. | STRING | Oui | | -| `taille_de_police` | Taille de la police en pourcentage de la hauteur de l'image (par défaut : 5.0) | FLOAT | Oui | 0.5 à 50.0 (pas de 0.5) | -| `couleur` | Couleur du texte (par défaut : "#ffffff") | STRING | Oui | | -| `position` | Position verticale du texte sur l'image (par défaut : "top") | COMBO | Oui | `"top"`
`"bottom"` | -| `alignement` | Alignement horizontal du texte (par défaut : "left") | COMBO | Oui | `"left"`
`"center"`
`"right"` | -| `contour` | Dessiner un contour noir autour du texte (par défaut : True) | BOOLEAN | Oui | | -Remarque : si `text` est vide ou ne contient que des espaces, le nœud renvoie les images d'entrée inchangées. La même superposition de texte est appliquée à chaque image du lot. Pour les images avec un canal alpha (RGBA), le texte est composé avec un mélange alpha source-over, de sorte que la transparence existante est respectée. +|-----------|-------------|----------------|--------|-------| +| `images` | L'image ou le lot d'images d'entrée sur lequel dessiner du texte | IMAGE | Oui | | +| `texte` | Texte à superposer sur l'image (défaut : ""). Prend en charge plusieurs lignes : les séquences d'échappement `\n` et `\t` sont converties en sauts de ligne et en tabulations, et les lignes longues sont automatiquement renvoyées à la ligne pour tenir dans la largeur de l'image. | STRING | Oui | | +| `taille_de_police` | Taille de police en pourcentage de la hauteur de l'image (défaut : 5.0) | FLOAT | Oui | 0.5 à 50.0 (pas 0.5) | +| `couleur` | Couleur du texte (défaut : "#ffffff") | STRING | Oui | | +| `position` | Position verticale du texte sur l'image (défaut : "top") | COMBO | Oui | "top"
"bottom" | +| `alignement` | Alignement horizontal du texte (défaut : "left") | COMBO | Oui | "left"
"center"
"right" | +| `contour` | Dessine un contour noir autour du texte (défaut : True) | BOOLEAN | Oui | | + +Remarque : si `text` est vide ou ne contient que des espaces, le nœud renvoie les images d'entrée inchangées. La superposition de texte est créée une seule fois, puis appliquée à chaque image du lot. ## Sorties | Nom de sortie | Description | Type de données | |---------------|-------------|-----------------| -| `images` | Les images d'entrée avec la superposition de texte composite dessus | IMAGE | +| `images` | Les images d'entrée avec la superposition de texte appliquée par-dessus | 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/TextOverlay/fr.md) diff --git a/comfyui_embedded_docs/docs/TextOverlay/ja.md b/comfyui_embedded_docs/docs/TextOverlay/ja.md index f5b920de3..51f1f65b4 100644 --- a/comfyui_embedded_docs/docs/TextOverlay/ja.md +++ b/comfyui_embedded_docs/docs/TextOverlay/ja.md @@ -1,25 +1,26 @@ # テキストオーバーレイを描画 -このノードは、画像または画像バッチの上にテキストを描画します。フォントサイズ、色、位置、配置、およびオプションの輪郭をカスタマイズ可能なテキストオーバーレイを作成し、元の画像にテキストを合成します。 +このノードは、画像または画像のバッチの上にテキストを描画します。フォントサイズ、色、垂直位置、水平揃え、および任意の黒い輪郭を設定できるテキストオーバーレイを構築し、そのオーバーレイを元の画像に合成します。 ## 入力 | パラメータ | 説明 | データ型 | 必須 | 範囲 | -|-----------|-------------|-----------|----------|-------| -| `画像` | テキストを描画する入力画像または画像バッチ | IMAGE | はい | | -| `テキスト` | 画像に重ねるテキスト(デフォルト:"")。複数行に対応しています。`\n` と `\t` のエスケープシーケンスは改行とタブに変換され、テキストは画像の幅に収まるように自動的に折り返されます。 | STRING | はい | | -| `フォントサイズ` | 画像の高さに対するパーセンテージで指定するフォントサイズ(デフォルト:5.0) | FLOAT | はい | 0.5 ~ 50.0(ステップ 0.5) | -| `色` | テキストの色(デフォルト:"#ffffff") | STRING | はい | | -| `位置` | 画像上のテキストの垂直位置(デフォルト:"top") | COMBO | はい | `"top"`
`"bottom"` | -| `整列` | テキストの水平配置(デフォルト:"left") | COMBO | はい | `"left"`
`"center"`
`"right"` | -| `アウトライン` | テキストの周りに黒い輪郭を描画するかどうか(デフォルト:True) | BOOLEAN | はい | | -注意:`text` が空または空白のみの場合、ノードは入力画像を変更せずに返します。同じテキストオーバーレイがバッチ内のすべての画像に適用されます。アルファチャンネル(RGBA)を持つ画像の場合、テキストは source-over アルファブレンディングで合成されるため、既存の透明度が保持されます。 +|-----------|------|----------|------|------| +| `画像` | テキストを描画する対象となる入力画像、または画像のバッチです。 | IMAGE | はい | | +| `テキスト` | 画像にオーバーレイするテキストです(デフォルト: "")。複数行に対応しており、`\n` エスケープシーケンスは改行に、`\t` はタブに変換されます。長い行は画像の幅に収まるように自動的に折り返されます。 | STRING | はい | | +| `フォントサイズ` | 画像の高さに対するパーセントで指定するフォントサイズです(デフォルト: 5.0)。 | FLOAT | はい | 0.5〜50.0 (ステップ 0.5) | +| `色` | テキストの色です(デフォルト: "#ffffff")。 | STRING | はい | | +| `位置` | 画像上でのテキストの垂直位置です(デフォルト: "top")。 | COMBO | はい | "top"
"bottom" | +| `整列` | テキストの水平揃えです(デフォルト: "left")。 | COMBO | はい | "left"
"center"
"right" | +| `アウトライン` | テキストの周囲に黒い輪郭を描画するかどうかを指定します(デフォルト: True)。 | BOOLEAN | はい | | + +注:`text` が空、または空白のみの場合は、このノードは入力画像を変更せずにそのまま返します。テキストオーバーレイは1回だけ描画され、バッチ内のすべての画像に適用されます。 ## 出力 | 出力名 | 説明 | データ型 | -|-------------|-------------|-----------| -| `画像` | テキストオーバーレイが合成された入力画像 | IMAGE | +|---------|------|----------| +| `画像` | テキストオーバーレイが合成された入力画像です。 | IMAGE | > このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TextOverlay/ja.md) diff --git a/comfyui_embedded_docs/docs/TextOverlay/ko.md b/comfyui_embedded_docs/docs/TextOverlay/ko.md index e37b0e61a..5fa01d1d6 100644 --- a/comfyui_embedded_docs/docs/TextOverlay/ko.md +++ b/comfyui_embedded_docs/docs/TextOverlay/ko.md @@ -1,25 +1,26 @@ # 텍스트 오버레이 그리기 -이 노드는 이미지 또는 이미지 배치 위에 텍스트를 그립니다. 사용자 정의 가능한 글꼴 크기, 색상, 위치, 정렬 및 선택적 윤곽선을 사용하여 텍스트 오버레이를 생성한 후, 텍스트를 원본 이미지 위에 합성합니다. +이 노드는 이미지 또는 이미지 배치 위에 텍스트를 그립니다. 구성 가능한 글꼴 크기, 색상, 세로 위치, 가로 정렬 및 선택적 검은색 윤곽선을 사용하여 텍스트 오버레이를 만든 다음, 원본 이미지 위에 해당 오버레이를 합성합니다. ## 입력 -| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +| 매개변수 | 설명 | 데이터 타입 | 필수 여부 | 범위 | |-----------|-------------|-----------|----------|-------| -| `images` | 텍스트를 그릴 입력 이미지 또는 이미지 배치 | IMAGE | 예 | | -| `text` | 이미지 위에 오버레이할 텍스트 (기본값: ""). 여러 줄을 지원합니다. `\n` 및 `\t` 이스케이프 시퀀스는 줄바꿈과 탭으로 변환되며, 텍스트는 이미지 너비에 맞게 자동으로 줄바꿈됩니다. | STRING | 예 | | -| `font_size` | 이미지 높이 대비 글꼴 크기 백분율 (기본값: 5.0) | FLOAT | 예 | 0.5 ~ 50.0 (0.5 간격) | -| `color` | 텍스트 색상 (기본값: "#ffffff") | STRING | 예 | | -| `position` | 이미지에서 텍스트의 세로 위치 (기본값: "top") | COMBO | 예 | `"top"`
`"bottom"` | -| `align` | 텍스트의 가로 정렬 (기본값: "left") | COMBO | 예 | `"left"`
`"center"`
`"right"` | -| `outline` | 텍스트 주위에 검은색 윤곽선 그리기 (기본값: True) | BOOLEAN | 예 | | -참고: `text`가 비어 있거나 공백만 포함된 경우, 노드는 입력 이미지를 변경 없이 반환합니다. 동일한 텍스트 오버레이가 배치의 모든 이미지에 적용됩니다. 알파 채널(RGBA)이 있는 이미지의 경우 텍스트가 source-over 알파 블렌딩으로 합성되므로 기존 투명도가 유지됩니다. +| `images` | 텍스트를 그릴 입력 이미지 또는 이미지 배치입니다. | IMAGE | 예 | | +| `text` | 이미지에 표시할 텍스트입니다(기본값: ""). 여러 줄을 지원하며, `\n` 및 `\t` 이스케이프 시퀀스는 줄바꿈과 탭으로 변환되고, 긴 줄은 이미지 너비에 맞게 자동으로 줄바꿈됩니다. | STRING | 예 | | +| `font_size` | 이미지 높이의 백분율로 표시되는 글꼴 크기입니다(기본값: 5.0). | FLOAT | 예 | 0.5~50.0 (단계 0.5) | +| `color` | 텍스트의 색상입니다(기본값: "#ffffff"). | STRING | 예 | | +| `position` | 이미지에서 텍스트의 세로 위치입니다(기본값: "top"). | COMBO | 예 | "top"
"bottom" | +| `align` | 텍스트의 가로 정렬입니다(기본값: "left"). | COMBO | 예 | "left"
"center"
"right" | +| `outline` | 텍스트 주위에 검은색 윤곽선을 그립니다(기본값: True). | BOOLEAN | 예 | | + +참고: `text`가 비어 있거나 공백만 포함된 경우, 노드는 입력 이미지를 변경하지 않고 반환합니다. 텍스트 오버레이는 한 번 렌더링되어 배치의 모든 이미지에 적용됩니다. ## 출력 | 출력 이름 | 설명 | 데이터 타입 | |-------------|-------------|-----------| -| `images` | 텍스트 오버레이가 합성된 입력 이미지 | IMAGE | +| `images` | 텍스트 오버레이가 합성된 입력 이미지입니다. | IMAGE | > 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TextOverlay/ko.md) diff --git a/comfyui_embedded_docs/docs/TextOverlay/pt-BR.md b/comfyui_embedded_docs/docs/TextOverlay/pt-BR.md index f2937e51a..1f1e8a0dc 100644 --- a/comfyui_embedded_docs/docs/TextOverlay/pt-BR.md +++ b/comfyui_embedded_docs/docs/TextOverlay/pt-BR.md @@ -1,25 +1,26 @@ # Desenhar Sobreposição de Texto -Este nó desenha texto sobre uma imagem ou um lote de imagens. Ele cria uma sobreposição de texto com tamanho de fonte, cor, posição, alinhamento e contorno opcional personalizáveis, e então compõe o texto sobre as imagens originais. +Este nó desenha texto sobre uma imagem ou um lote de imagens. Ele constrói uma sobreposição de texto com tamanho de fonte, cor, posição vertical, alinhamento horizontal e contorno preto opcional configuráveis, e então compõe a sobreposição sobre as imagens originais. ## Entradas -| Parâmetro | Descrição | Tipo de Dado | Obrigatório | Faixa | -|-----------|-----------|--------------|-------------|-------| -| `imagens` | A imagem de entrada ou lote de imagens para desenhar o texto | IMAGE | Sim | | -| `texto` | O texto a ser sobreposto na imagem (padrão: ""). Suporta várias linhas; as sequências de escape `\n` e `\t` são convertidas em quebras de linha e tabulações, e o texto é automaticamente quebrado para caber na largura da imagem. | STRING | Sim | | +| Parâmetro | Descrição | Tipo de Dados | Obrigatório | Intervalo | +|-----------|-------------|-----------|----------|-------| +| `imagens` | A imagem de entrada ou lote de imagens sobre o qual desenhar o texto | IMAGE | Sim | | +| `texto` | O texto a ser sobreposto na imagem (padrão: ""). Suporta múltiplas linhas: as sequências de escape `\n` e `\t` são convertidas em quebras de linha e tabulações, e linhas longas são quebradas automaticamente para caber dentro da largura da imagem. | STRING | Sim | | | `tamanho_da_fonte` | Tamanho da fonte como porcentagem da altura da imagem (padrão: 5.0) | FLOAT | Sim | 0.5 a 50.0 (passo 0.5) | | `cor` | Cor do texto (padrão: "#ffffff") | STRING | Sim | | -| `posição` | Posição vertical do texto na imagem (padrão: "top") | COMBO | Sim | `"top"`
`"bottom"` | -| `alinhamento` | Alinhamento horizontal do texto (padrão: "left") | COMBO | Sim | `"left"`
`"center"`
`"right"` | -| `contorno` | Desenhar um contorno preto ao redor do texto (padrão: True) | BOOLEAN | Sim | | -Observação: se `text` estiver vazio ou contiver apenas espaços em branco, o nó retorna as imagens de entrada inalteradas. A mesma sobreposição de texto é aplicada a cada imagem do lote. Para imagens com canal alfa (RGBA), o texto é composto usando mesclagem alfa source-over, de modo que a transparência existente seja preservada. +| `posição` | Posição vertical do texto na imagem (padrão: "top") | COMBO | Sim | "top"
"bottom" | +| `alinhamento` | Alinhamento horizontal do texto (padrão: "left") | COMBO | Sim | "left"
"center"
"right" | +| `contorno` | Desenha um contorno preto ao redor do texto (padrão: True) | BOOLEAN | Sim | | + +Observação: Se `text` estiver vazio ou contiver apenas espaços em branco, o nó retorna as imagens de entrada inalteradas. A sobreposição de texto é renderizada uma vez e aplicada a cada imagem do lote. ## Saídas -| Nome da Saída | Descrição | Tipo de Dado | -|---------------|-----------|--------------| -| `imagens` | As imagens de entrada com a sobreposição de texto composta sobre elas | IMAGE | +| Nome da Saída | Descrição | Tipo de Dados | +|-------------|-------------|-----------| +| `imagens` | As imagens de entrada com a sobreposição de texto composta por cima | 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/TextOverlay/pt-BR.md) diff --git a/comfyui_embedded_docs/docs/TextOverlay/ru.md b/comfyui_embedded_docs/docs/TextOverlay/ru.md index d2b452052..d0c2df73b 100644 --- a/comfyui_embedded_docs/docs/TextOverlay/ru.md +++ b/comfyui_embedded_docs/docs/TextOverlay/ru.md @@ -1,25 +1,26 @@ # Наложение текста -Этот узел наносит текст поверх одного изображения или пакета изображений. Он создает текстовую накладку с настраиваемым размером шрифта, цветом, положением, выравниванием и необязательным контуром, а затем компонует текст поверх исходных изображений. +Этот узел рисует текст поверх изображения или пакета изображений. Он создает текстовое наложение с настраиваемым размером шрифта, цветом, вертикальным положением, горизонтальным выравниванием и опциональной черной обводкой, а затем объединяет наложение с исходными изображениями. ## Входы -| Параметр | Описание | Тип данных | Обязательный | Диапазон | -|-----------|-------------|-----------|----------|-------| -| `изображения` | Входное изображение или пакет изображений для нанесения текста | IMAGE | Да | | -| `текст` | Текст для наложения на изображение (по умолчанию: ""). Поддерживает несколько строк; escape-последовательности `\n` и `\t` преобразуются в переводы строк и табуляции, а текст автоматически переносится, чтобы поместиться в ширину изображения. | STRING | Да | | +| Параметр | Описание | Тип данных | Обязательно | Диапазон | +|----------|----------|------------|-------------|----------| +| `изображения` | Входное изображение или пакет изображений, на которых нужно нарисовать текст | IMAGE | Да | | +| `текст` | Текст для наложения на изображение (по умолчанию: ""). Поддерживает несколько строк: escape-последовательности `\n` и `\t` преобразуются в переводы строк и табуляцию, а длинные строки автоматически переносятся, чтобы поместиться в ширину изображения. | STRING | Да | | | `размер_шрифта` | Размер шрифта в процентах от высоты изображения (по умолчанию: 5.0) | FLOAT | Да | от 0.5 до 50.0 (шаг 0.5) | | `цвет` | Цвет текста (по умолчанию: "#ffffff") | STRING | Да | | -| `позиция` | Вертикальное положение текста на изображении (по умолчанию: "top") | COMBO | Да | `"top"`
`"bottom"` | -| `выравнивание` | Горизонтальное выравнивание текста (по умолчанию: "left") | COMBO | Да | `"left"`
`"center"`
`"right"` | -| `контур` | Рисовать черный контур вокруг текста (по умолчанию: True) | BOOLEAN | Да | | -Примечание: если `text` пуст или содержит только пробелы, узел возвращает входные изображения без изменений. Одно и то же наложение текста применяется к каждому изображению в пакете. Для изображений с альфа-каналом (RGBA) текст компоновится с помощью альфа-смешивания source-over, поэтому существующая прозрачность сохраняется. +| `позиция` | Вертикальное положение текста на изображении (по умолчанию: "top") | COMBO | Да | "top"
"bottom" | +| `выравнивание` | Горизонтальное выравнивание текста (по умолчанию: "left") | COMBO | Да | "left"
"center"
"right" | +| `контур` | Рисовать чёрную обводку вокруг текста (по умолчанию: True) | BOOLEAN | Да | | + +Примечание: Если параметр `text` пуст или содержит только пробельные символы, узел возвращает входные изображения без изменений. Текстовое наложение отрисовывается один раз и применяется к каждому изображению в пакете. ## Выходы | Имя выхода | Описание | Тип данных | -|-------------|-----------|------------| -| `изображения` | Входные изображения с наложенным поверх текстом | IMAGE | +|-------------|----------|------------| +| `изображения` | Входные изображения с текстовым наложением поверх | IMAGE | > Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TextOverlay/ru.md) diff --git a/comfyui_embedded_docs/docs/TextOverlay/tr.md b/comfyui_embedded_docs/docs/TextOverlay/tr.md index 558e60e96..435d18ba0 100644 --- a/comfyui_embedded_docs/docs/TextOverlay/tr.md +++ b/comfyui_embedded_docs/docs/TextOverlay/tr.md @@ -1,25 +1,26 @@ # Metin Yer Paylaşımı Çiz -Bu düğüm, bir görüntü veya görüntü grubu üzerine metin çizer. Özelleştirilebilir yazı tipi boyutu, renk, konum, hizalama ve isteğe bağlı bir anahat ile bir metin katmanı oluşturur ve ardından metni orijinal görüntülerin üzerine yerleştirir. +Bu düğüm, bir görüntünün veya görüntü grubunun üzerine metin çizer. Yapılandırılabilir yazı tipi boyutu, renk, dikey konum, yatay hizalama ve isteğe bağlı siyah anahat içeren bir metin katmanı oluşturur ve ardından bu katmanı orijinal görüntülerin üzerine bindirir. ## Girdiler -| Parametre | Açıklama | Veri Türü | Zorunlu | Aralık | +| Parametre | Açıklama | Veri Tipi | Gerekli | Aralık | |-----------|-------------|-----------|----------|-------| -| `görüntüler` | Metin çizilecek giriş görüntüsü veya görüntü grubu | IMAGE | Evet | | -| `metin` | Görüntü üzerine yerleştirilecek metin (varsayılan: ""). Birden çok satırı destekler; `\n` ve `\t` kaçış dizileri yeni satırlara ve sekmelere dönüştürülür ve metin, görüntü genişliğine sığacak şekilde otomatik olarak sarılır. | STRING | Evet | | +| `görüntüler` | Metin çizilecek girdi görüntüsü veya görüntü grubu | IMAGE | Evet | | +| `metin` | Görüntüye yerleştirilecek metin (varsayılan: ""). Birden çok satırı destekler: `\n` ve `\t` kaçış dizileri satır sonu ve sekme karakterlerine dönüştürülür; uzun satırlar görüntü genişliğine sığacak şekilde otomatik olarak sarılır. | STRING | Evet | | | `yazı tipi boyutu` | Görüntü yüksekliğinin yüzdesi olarak yazı tipi boyutu (varsayılan: 5.0) | FLOAT | Evet | 0.5 ila 50.0 (adım 0.5) | | `renk` | Metnin rengi (varsayılan: "#ffffff") | STRING | Evet | | -| `konum` | Metnin görüntü üzerindeki dikey konumu (varsayılan: "top") | COMBO | Evet | `"top"`
`"bottom"` | -| `hizalama` | Metnin yatay hizalaması (varsayılan: "left") | COMBO | Evet | `"left"`
`"center"`
`"right"` | -| `dış çizgi` | Metnin etrafına siyah bir anahat çizer (varsayılan: True) | BOOLEAN | Evet | | -Not: `text` boşsa veya yalnızca boşluk içeriyorsa, düğüm giriş görüntülerini değiştirmeden döndürür. Aynı metin yerleşimi yığındaki her görüntüye uygulanır. Alfa kanalına (RGBA) sahip görüntülerde metin, source-over alfa harmanlaması ile birleştirilir, böylece mevcut şeffaflık korunur. +| `konum` | Metnin görüntü üzerindeki dikey konumu (varsayılan: "top") | COMBO | Evet | "top"
"bottom" | +| `hizalama` | Metnin görüntü üzerindeki yatay hizalaması (varsayılan: "left") | COMBO | Evet | "left"
"center"
"right" | +| `dış çizgi` | Metnin çevresine siyah bir anahat çizilip çizilmeyeceği (varsayılan: True) | BOOLEAN | Evet | | + +Not: `text` boşsa veya yalnızca boşluk karakterlerinden oluşuyorsa düğüm, girdi görüntülerini değiştirmeden döndürür. Metin katmanı bir kez oluşturulur ve gruptaki her görüntüye uygulanır. ## Çıktılar -| Çıktı Adı | Açıklama | Veri Türü | +| Çıktı Adı | Açıklama | Veri Tipi | |-------------|-------------|-----------| -| `görüntüler` | Üzerine metin katmanı yerleştirilmiş giriş görüntüleri | IMAGE | +| `görüntüler` | Üzerine metin katmanı eklenmiş girdi görüntüleri | 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/TextOverlay/tr.md) diff --git a/comfyui_embedded_docs/docs/TextOverlay/zh-TW.md b/comfyui_embedded_docs/docs/TextOverlay/zh-TW.md index 09cd08dc6..ba0e24afd 100644 --- a/comfyui_embedded_docs/docs/TextOverlay/zh-TW.md +++ b/comfyui_embedded_docs/docs/TextOverlay/zh-TW.md @@ -1,25 +1,26 @@ # 繪製文字覆蓋 -此節點可在單張影像或一批影像上繪製文字。它會建立一個可自訂字型大小、顏色、位置、對齊方式及可選外框的文字疊加層,然後將文字合成到原始影像上。 +此節點會在圖片或圖片批次上繪製文字。它會建立一個可設定的文字疊加層,包含字型大小、顏色、垂直位置、水平對齊,以及可選的黑色外框,然後將疊加層合成到原始圖片上。 ## 輸入 | 參數 | 說明 | 資料類型 | 必要 | 範圍 | |-----------|-------------|-----------|----------|-------| -| `圖片` | 要繪製文字的輸入影像或一批影像 | IMAGE | 是 | | -| `文字` | 要疊加在影像上的文字(預設:"")。支援多行;`\n` 和 `\t` 跳脫序列會轉換為換行符和定位字元,文字會自動換行以符合影像寬度。 | STRING | 是 | | -| `字型大小` | 字型大小,以影像高度的百分比表示(預設:5.0) | FLOAT | 是 | 0.5 至 50.0(步長 0.5) | -| `顏色` | 文字的顏色(預設:"#ffffff") | STRING | 是 | | -| `位置` | 文字在影像上的垂直位置(預設:"top") | COMBO | 是 | `"top"`
`"bottom"` | -| `對齊` | 文字的水平對齊方式(預設:"left") | COMBO | 是 | `"left"`
`"center"`
`"right"` | +| `圖片` | 要繪製文字的輸入圖片或圖片批次 | IMAGE | 是 | | +| `文字` | 要疊加在圖片上的文字(預設:"")。支援多行:`\n` 和 `\t` 跳脫序列會轉換為換行和跳位字元,長行會自動換行以符合圖片寬度。 | STRING | 是 | | +| `字型大小` | 字型大小,以圖片高度的百分比表示(預設:5.0) | FLOAT | 是 | 0.5至50.0(間距 0.5) | +| `顏色` | 文字顏色(預設:"#ffffff") | STRING | 是 | | +| `位置` | 文字在圖片上的垂直位置(預設:"top") | COMBO | 是 | "top"
"bottom" | +| `對齊` | 文字的水平對齊方式(預設:"left") | COMBO | 是 | "left"
"center"
"right" | | `外框` | 在文字周圍繪製黑色外框(預設:True) | BOOLEAN | 是 | | -注意:如果 `text` 為空或僅包含空白字元,節點將原樣回傳輸入影像。相同的文字疊加會套用至批次中的每張影像。對於帶有透明通道(RGBA)的影像,文字使用 source-over alpha 混合進行合成,因此現有的透明度會被保留。 + +注意:如果 `text` 為空或僅包含空白字元,此節點會直接回傳輸入圖片而不做任何變更。文字疊加層只會渲染一次,並套用到批次中的每一張圖片。 ## 輸出 -| 輸出名稱 | 說明 | 資料類型 | +| 輸出名 | 說明 | 資料類型 | |-------------|-------------|-----------| -| `圖片` | 已合成文字疊加層的輸入影像 | IMAGE | +| `圖片` | 已將文字疊加層合成在上方的輸入圖片 | IMAGE | > 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議,歡迎貢獻! [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TextOverlay/zh-TW.md) diff --git a/comfyui_embedded_docs/docs/TextOverlay/zh.md b/comfyui_embedded_docs/docs/TextOverlay/zh.md index c55edb1d1..1d07a27b8 100644 --- a/comfyui_embedded_docs/docs/TextOverlay/zh.md +++ b/comfyui_embedded_docs/docs/TextOverlay/zh.md @@ -1,25 +1,24 @@ # 绘制文字覆盖 -此节点在单张图像或一批图像上绘制文本。它会创建一个可自定义字体大小、颜色、位置、对齐方式以及可选描边的文本叠加层,然后将文本合成到原始图像上。 +此节点在图像或图像批次上绘制文本。它会根据可配置的字体大小、颜色、垂直位置、水平对齐方式以及可选的黑边来构建文本叠加层,然后将该叠加层合成到原始图像上。 ## 输入 +| 参数 | 描述 | 数据类型 | 必需 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `图像` | 要在其上绘制文本的输入图像或图像批次 | IMAGE | 是 | | +| `文字` | 要叠加在图像上的文本(默认值:"")。支持多行:`\n` 和 `\t` 转义序列会转换为换行符和制表符,长行会自动换行以适配图像宽度。 | STRING | 是 | | +| `字体大小` | 字体大小,以图像高度的百分比表示(默认值:5.0) | FLOAT | 是 | 0.5到50.0 (步长 0.5) | +| `颜色` | 文本颜色(默认值:"#ffffff") | STRING | 是 | | +| `位置` | 文本在图像上的垂直位置(默认值:"top") | COMBO | 是 | "top"
"bottom" | +| `对齐` | 文本的水平对齐方式(默认值:"left") | COMBO | 是 | "left"
"center"
"right" | +| `描边` | 在文本周围绘制黑色轮廓(默认值:True) | BOOLEAN | 是 | | -| 参数 | 描述 | 数据类型 | 是否必填 | 范围 | -|------|------|----------|----------|------| -| `图像` | 要绘制文本的输入图像或图像批次 | IMAGE | 是 | | -| `文字` | 要叠加在图像上的文本(默认:"")。支持多行;`\n` 和 `\t` 转义序列会转换为换行符和制表符,文本会自动换行以适配图像宽度。 | STRING | 是 | | -| `字体大小` | 字体大小,以图像高度的百分比表示(默认:5.0) | FLOAT | 是 | 0.5 至 50.0(步长 0.5) | -| `颜色` | 文本颜色(默认:"#ffffff") | STRING | 是 | | -| `位置` | 文本在图像上的垂直位置(默认:"top") | COMBO | 是 | `"top"`
`"bottom"` | -| `对齐` | 文本的水平对齐方式(默认:"left") | COMBO | 是 | `"left"`
`"center"`
`"right"` | -| `描边` | 在文本周围绘制黑色描边(默认:True) | BOOLEAN | 是 | | -注意:如果 `text` 为空或仅包含空白字符,节点将原样返回输入图像。相同的文本叠加会应用于批次中的每张图像。对于带有透明通道(RGBA)的图像,文本使用 source-over alpha 混合进行合成,因此现有的透明度会被保留。 +注意:如果 `text` 为空或仅包含空白字符,节点将直接返回输入图像不变。文本叠加仅渲染一次,并应用于批次中的每张图像。 ## 输出 - | 输出名称 | 描述 | 数据类型 | -|----------|------|----------| -| `图像` | 叠加了文本的输入图像 | IMAGE | +|-------------|-------------|-----------| +| `图像` | 顶部合成文本叠加后的输入图像 | IMAGE | > 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TextOverlay/zh.md) diff --git a/docs-generation/scripts/batch_generate_docs.py b/docs-generation/scripts/batch_generate_docs.py index 5d0311419..7f89ea9b0 100644 --- a/docs-generation/scripts/batch_generate_docs.py +++ b/docs-generation/scripts/batch_generate_docs.py @@ -39,6 +39,35 @@ MAX_RETRIES = int(os.getenv('MAX_RETRIES', '3')) DELAY_BETWEEN_REQUESTS = int(os.getenv('DELAY_BETWEEN_REQUESTS', '2')) + +def _strip_markdown_output_fence(text: str) -> str: + """Remove an outer ```markdown ... ``` fence that some LLMs wrap around + the entire generated document (sometimes right after the H1). Only strips + when the closing fence is the last standalone fence with balanced content + inside; leaves genuine inner code fences untouched.""" + lines = text.split('\n') + open_idx = None + for i, line in enumerate(lines): + if line.strip() == '```markdown': + open_idx = i + break + if open_idx is None: + return text + # find the matching closing fence: the LAST standalone ``` in the file + close_idx = None + for i in range(len(lines) - 1, open_idx, -1): + if lines[i].strip() == '```': + close_idx = i + break + if close_idx is None or close_idx - open_idx < 2: + return text + inner = lines[open_idx + 1:close_idx] + # sanity: inner must not contain unbalanced ``` (would mean a real inner fence) + if sum(1 for l in inner if l.strip().startswith('```')) % 2 != 0: + return text + return '\n'.join(lines[:open_idx] + inner + lines[close_idx + 1:]) +DELAY_BETWEEN_REQUESTS = int(os.getenv('DELAY_BETWEEN_REQUESTS', '2')) + # Path configuration AI_INPUT_PATH = AI_INPUT_DIR DOCS_OUTPUT_PATH = default_embedded_docs_path() / "comfyui_embedded_docs" / "docs" @@ -135,7 +164,14 @@ def generate_doc(self, node_name: str, prompt: str, retry_count: int = 0) -> Opt ) content = response.choices[0].message.content - + + # Strip LLM output fence: some models (glm-4-flash etc.) wrap the whole + # document in ```markdown ... ``` which renders the doc as a code block. + fence_stripped = _strip_markdown_output_fence(content) + if fence_stripped != content: + self.logger.log("Stripped markdown output fence from generated doc") + content = fence_stripped + # Validate generated content if not content or len(content) < 100: raise ValueError("Generated documentation too short") diff --git a/docs-generation/scripts/batch_translate_docs.py b/docs-generation/scripts/batch_translate_docs.py index aa05ab70d..bee9e9a69 100644 --- a/docs-generation/scripts/batch_translate_docs.py +++ b/docs-generation/scripts/batch_translate_docs.py @@ -104,6 +104,30 @@ def replace_heading_placeholders(content, lang_config): } +def strip_markdown_output_fence(text: str) -> str: + """Remove an outer ```markdown ... ``` fence that some LLMs wrap around the + entire translated document. Keeps genuine inner code fences untouched.""" + lines = text.split('\n') + open_idx = None + for i, line in enumerate(lines): + if line.strip() == '```markdown': + open_idx = i + break + if open_idx is None: + return text + close_idx = None + for i in range(len(lines) - 1, open_idx, -1): + if lines[i].strip() == '```': + close_idx = i + break + if close_idx is None or close_idx - open_idx < 2: + return text + inner = lines[open_idx + 1:close_idx] + if sum(1 for l in inner if l.strip().startswith('```')) % 2 != 0: + return text + return '\n'.join(lines[:open_idx] + inner + lines[close_idx + 1:]) + + def strip_ai_preamble(content: str, lang: str) -> str: """Remove translation preamble that the AI sometimes prepends. @@ -265,6 +289,10 @@ def translate_document(node_name, target_lang, lang_config, client, model): content = strip_ai_disclaimer(content) + # Strip LLM output fence: some models (glm-4-flash etc.) wrap the + # whole document in ```markdown ... ``` which renders as a code block. + content = strip_markdown_output_fence(content) + # Strip AI preamble ("Here is the translation...") in the target language content = strip_ai_preamble(content, target_lang)