diff --git a/built-in-nodes/AnimaLLLiteApply.mdx b/built-in-nodes/AnimaLLLiteApply.mdx new file mode 100644 index 000000000..9826e7402 --- /dev/null +++ b/built-in-nodes/AnimaLLLiteApply.mdx @@ -0,0 +1,34 @@ +--- +title: "AnimaLLLiteApply - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the AnimaLLLiteApply node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "AnimaLLLiteApply" +icon: "circle" +mode: wide +--- + +This node applies a lightweight animation patch to a diffusion model, enabling controlled image-to-image generation with adjustable strength and timing. It integrates a pre-configured model patch with an input image and optional mask, modifying the model's attention and MLP layers to influence the generation process. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `model` | The base diffusion model to apply the patch to | MODEL | Yes | | +| `model_patch` | The pre-configured animation patch to apply | MODEL_PATCH | Yes | | +| `image` | The reference image to guide the generation | IMAGE | Yes | | +| `strength` | The strength of the patch effect (default: 1.0) | FLOAT | Yes | -10.0 to 10.0 | +| `start_percent` | The percentage of the denoising process at which the patch starts taking effect (default: 0.0) | FLOAT | Yes | 0.0 to 1.0 | +| `end_percent` | The percentage of the denoising process at which the patch stops taking effect (default: 1.0) | FLOAT | Yes | 0.0 to 1.0 | +| `mask` | An optional mask to limit the patch effect to specific areas of the image | MASK | No | | + +**Note on parameter constraints:** If the `model_patch` has 4 input channels and no `mask` is provided, a zero mask is automatically created to match the image dimensions. If the `model_patch` does not have 4 input channels, the `mask` parameter is ignored and set to `None`. + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `MODEL` | The patched diffusion model with the animation patch applied | MODEL | + +> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/AnimaLLLiteApply/en.md) + +--- +**Source fingerprint (SHA-256):** `291dc6a6619faab1c1100110c71c47381addcd80dbaf933dd8025a376bc2bee7` diff --git a/built-in-nodes/HeyGenAvatarVideoNode.mdx b/built-in-nodes/HeyGenAvatarVideoNode.mdx new file mode 100644 index 000000000..efe3ab7e3 --- /dev/null +++ b/built-in-nodes/HeyGenAvatarVideoNode.mdx @@ -0,0 +1,47 @@ +--- +title: "HeyGenAvatarVideoNode - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the HeyGenAvatarVideoNode node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "HeyGenAvatarVideoNode" +icon: "circle" +mode: wide +--- + +Generate a talking-presenter video from a HeyGen avatar. This node creates a video of an AI avatar speaking your provided text or lip-syncing to your own audio, using HeyGen's rendering engines. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `engine` | Rendering engine; each choice lists only the avatars that support it. 'auto' offers every avatar and picks its best engine (Avatar IV preferred). Avatar V is highest fidelity, Avatar III is the most affordable. | COMBO | Yes | `"auto"`
`"avatar_iv"`
`"avatar_iii"`
`"avatar_v"` | +| `custom_avatar_id` | Optional HeyGen avatar look ID. When set, overrides the avatar selected above. Any of HeyGen's 3000+ public looks (or your private avatars) can be used. | STRING | No | | +| `speech` | Drive the avatar with a text script (HeyGen text-to-speech) or your own audio. | COMBO | Yes | `"script"`
`"audio"` | +| `resolution` | Output video resolution (default: "1080p"). | COMBO | No | `"720p"`
`"1080p"` | +| `aspect_ratio` | Output aspect ratio. 'auto' follows the avatar's source footage (default: "auto"). | COMBO | No | `"auto"`
`"16:9"`
`"9:16"`
`"1:1"`
`"4:5"`
`"5:4"` | +| `background_color` | Optional solid background color as a hex code (e.g. '#00ff00'). Leave empty for the avatar's own background. | STRING | No | | +| `seed` | Not sent to HeyGen; change it to force a re-run (default: 42). | INT | No | Min: 0
Max: 2147483647 | + +When `speech` is set to `"script"`, the following sub-parameters are available: + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `text` | Text for the avatar to speak (up to 5000 characters). The generated speech must be at least 1 second long. | STRING | Yes | | +| `voice` | Voice for the script. The default option uses the voice HeyGen assigned to the avatar. | COMBO | Yes | Multiple options available | +| `custom_voice_id` | Optional HeyGen voice ID. When set, overrides the voice selected above. Any voice from HeyGen's library (2000+) can be used. | STRING | No | | +| `voice_speed` | Speech speed multiplier (default: 1.0). | FLOAT | No | Min: 0.5
Max: 1.5
Step: 0.05 | + +When `speech` is set to `"audio"`, the following sub-parameter is available: + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `audio` | Audio for the avatar to lip-sync, up to 10 minutes. | AUDIO | Yes | | + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `VIDEO` | The generated avatar presenter video. | 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/HeyGenAvatarVideoNode/en.md) + +--- +**Source fingerprint (SHA-256):** `009bc72b841ca273af83fe6f80fb24d4b11c2efd96c011795b1ff1cf8e66ee61` diff --git a/built-in-nodes/HeyGenCreateAvatarNode.mdx b/built-in-nodes/HeyGenCreateAvatarNode.mdx new file mode 100644 index 000000000..d341202cc --- /dev/null +++ b/built-in-nodes/HeyGenCreateAvatarNode.mdx @@ -0,0 +1,42 @@ +--- +title: "HeyGenCreateAvatarNode - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the HeyGenCreateAvatarNode node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "HeyGenCreateAvatarNode" +icon: "circle" +mode: wide +--- + +Create a reusable HeyGen avatar from a photo of a person or from a text prompt that describes a character to generate. The resulting avatar ID can be used with the HeyGen Avatar Video node to create videos featuring this avatar. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `source` | Generate a new character from a text prompt, or create the avatar from a connected photo of a person. | COMBO | Yes | `"prompt"`
`"photo"` | + +When `source` is set to `"prompt"`, the following additional parameters become available: + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `prompt` | Description of the avatar to generate (up to 1000 characters). | STRING | Yes | 1 to 1000 characters | +| `reference_images` | Up to 3 reference images guiding the generated look. | IMAGE | No | 0 to 3 images | + +When `source` is set to `"photo"`, the following additional parameter becomes available: + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `identity_photo` | Photo of the person to turn into an avatar. Downscaled automatically if larger than 2K. | IMAGE | Yes | Single image | + +**Note:** The `source` parameter switches between two modes. In `"prompt"` mode, you provide a text description and optionally up to 3 reference images. In `"photo"` mode, you provide a single photo of a person. These modes are mutually exclusive. + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `avatar_id` | Avatar look ID. Pass it to HeyGen Avatar Video's `custom_avatar_id`; save it to reuse the avatar later. | STRING | +| `preview` | Preview image of the generated avatar. | 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/HeyGenCreateAvatarNode/en.md) + +--- +**Source fingerprint (SHA-256):** `c60e9cdb0d91fb5ec6ea83b503b9aa10c978ce065a16c751a52e90c12e70a5e2` diff --git a/built-in-nodes/HeyGenTalkingPhotoNode.mdx b/built-in-nodes/HeyGenTalkingPhotoNode.mdx new file mode 100644 index 000000000..f791aaf82 --- /dev/null +++ b/built-in-nodes/HeyGenTalkingPhotoNode.mdx @@ -0,0 +1,36 @@ +--- +title: "HeyGenTalkingPhotoNode - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the HeyGenTalkingPhotoNode node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "HeyGenTalkingPhotoNode" +icon: "circle" +mode: wide +--- + +Animate a still image of a person into a lip-synced talking video using HeyGen's Avatar IV technology. You can drive the animation with a text script that HeyGen converts to speech, or provide your own audio for the avatar to lip-sync. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `image` | Image of a person to animate. Downscaled automatically if larger than 2K. | IMAGE | Yes | - | +| `speech` | Drive the avatar with a text script (HeyGen text-to-speech) or your own audio. | COMBO | Yes | `"script"`
`"audio"` | +| `text` | Text for the avatar to speak (up to 5000 characters). The generated speech must be at least 1 second long. | STRING | Yes (when speech is "script") | - | +| `voice` | Voice for the script (HeyGen's most popular voices). | COMBO | Yes (when speech is "script") | Multiple options available | +| `custom_voice_id` | Optional HeyGen voice ID. When set, overrides the voice selected above. Any voice from HeyGen's library (2000+) can be used. | STRING | No | - | +| `voice_speed` | Speech speed multiplier (default: 1.0). | FLOAT | No | 0.5 to 1.5 | +| `audio` | Audio for the avatar to lip-sync, up to 10 minutes. | AUDIO | Yes (when speech is "audio") | - | +| `resolution` | Output video resolution (default: "1080p"). | COMBO | No | `"720p"`
`"1080p"` | +| `aspect_ratio` | Output aspect ratio. 'auto' follows the input image (default: "auto"). | COMBO | No | `"auto"`
`"16:9"`
`"9:16"`
`"1:1"`
`"4:5"`
`"5:4"` | +| `expressiveness` | How expressive the animated face and gestures are (default: "low"). | COMBO | No | `"low"`
`"medium"`
`"high"` | +| `seed` | Not sent to HeyGen; change it to force a re-run (default: 42). | INT | No | 0 to 2147483647 | + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `video` | Generated video of the animated talking photo with lip-synced speech. | 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/HeyGenTalkingPhotoNode/en.md) + +--- +**Source fingerprint (SHA-256):** `2181066a8c6191cfcaa15ece4f89a16c37e76aa22763d6df4007baa20336f05a` diff --git a/built-in-nodes/HeyGenTextToSpeechNode.mdx b/built-in-nodes/HeyGenTextToSpeechNode.mdx new file mode 100644 index 000000000..f3eafe6d2 --- /dev/null +++ b/built-in-nodes/HeyGenTextToSpeechNode.mdx @@ -0,0 +1,31 @@ +--- +title: "HeyGenTextToSpeechNode - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the HeyGenTextToSpeechNode node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "HeyGenTextToSpeechNode" +icon: "circle" +mode: wide +--- + +Generate speech audio from text using HeyGen's Starfish TTS engine. This node includes HeyGen's most popular voices across 17 languages. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `text` | Text to synthesize (up to 5000 characters). The generated speech must be at least 1 second long. | STRING | Yes | 1 to 5000 characters | +| `voice` | Voice to use (curated from HeyGen's most popular Starfish-compatible voices). | STRING | Yes | Multiple options available | +| `custom_voice_id` | Optional HeyGen voice ID. When set, overrides the voice selected above. The voice must support the Starfish engine. | STRING | No | Any valid HeyGen voice ID | +| `speed` | Speech speed multiplier (default: 1.0). | FLOAT | No | 0.5 to 2.0 (step: 0.05) | +| `ssml` | Treat the text as SSML markup (for pauses, emphasis, and pronunciation control) (default: False). | BOOLEAN | No | True / False | +| `seed` | Not sent to HeyGen; change it to force a re-run (default: 42). | INT | No | 0 to 2147483647 | + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `AUDIO` | The synthesized speech audio generated from the input text. | AUDIO | + +> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HeyGenTextToSpeechNode/en.md) + +--- +**Source fingerprint (SHA-256):** `82300626657db8ab16e96ae96b7dfe3291b77bf75efec35971dc772e5123cce7` diff --git a/built-in-nodes/HeyGenVideoTranslateNode.mdx b/built-in-nodes/HeyGenVideoTranslateNode.mdx new file mode 100644 index 000000000..2fc791ab1 --- /dev/null +++ b/built-in-nodes/HeyGenVideoTranslateNode.mdx @@ -0,0 +1,31 @@ +--- +title: "HeyGenVideoTranslateNode - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the HeyGenVideoTranslateNode node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "HeyGenVideoTranslateNode" +icon: "circle" +mode: wide +--- + +Translate a spoken video into another language with voice cloning and lip sync. This node clones the original speaker's voice and re-animates the mouth to match the translated speech, producing a natural-looking result. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `video` | Video with speech to translate. | VIDEO | Yes | - | +| `output_language` | Target language for the translated video. | STRING | Yes | "Arabic"
"Bengali"
"Chinese"
"Danish"
"Dutch"
"English"
"French"
"German"
"Greek"
"Hindi"
"Indonesian"
"Italian"
"Japanese"
"Korean"
"Malay"
"Polish"
"Portuguese"
"Russian"
"Spanish"
"Swedish"
"Tamil"
"Telugu"
"Thai"
"Turkish"
"Ukrainian"
"Vietnamese" | +| `mode` | 'speed' is faster; 'precision' produces higher-quality lip sync at twice the price. | STRING | Yes | "speed"
"precision" | +| `translate_audio_only` | Only swap the audio track, keeping the original mouth movements (no lip sync). (default: False) | BOOLEAN | No | True
False | +| `speaker_count` | Number of speakers in the video. 0 = detect automatically. (default: 0) | INT | No | 0 to 10 | +| `seed` | Not sent to HeyGen; change it to force a re-run. (default: 42) | INT | No | 0 to 2147483647 | + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `video` | The translated video with voice cloning and lip sync applied. | 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/HeyGenVideoTranslateNode/en.md) + +--- +**Source fingerprint (SHA-256):** `31056060b6309b8ec28b37b353322403e173fd2862b56021392dba24e7a15f69` diff --git a/built-in-nodes/Save3DAdvanced.mdx b/built-in-nodes/Save3DAdvanced.mdx new file mode 100644 index 000000000..603b80ba0 --- /dev/null +++ b/built-in-nodes/Save3DAdvanced.mdx @@ -0,0 +1,36 @@ +--- +title: "Save3DAdvanced - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the Save3DAdvanced node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "Save3DAdvanced" +icon: "circle" +mode: wide +--- + +This node saves a 3D model to your ComfyUI output directory and provides advanced preview capabilities. It allows you to specify the output filename, preview dimensions, and optionally pass camera and model information for an enhanced 3D viewer experience. + +## 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, or any 3D format | +| `filename_prefix` | Prefix for the saved filename. A counter and file extension will be appended automatically. (default: "3d/ComfyUI") | STRING | Yes | Any valid filename string | +| `viewport_state` | The current viewport state, typically from a 3D viewer node. | LOAD3D | Yes | - | +| `model_3d_info` | Optional 3D model information for the preview. | LOAD3DMODELINFO | No | - | +| `camera_info` | Optional camera information for the preview. | LOAD3DCAMERA | No | - | +| `width` | Width of the preview in pixels. (default: 1024) | INT | Yes | 1 to 4096 | +| `height` | Height of the preview in pixels. (default: 1024) | INT | Yes | 1 to 4096 | + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `model_3d` | The saved 3D model file. | FILE3D | +| `model_3d_info` | 3D model information passed through for downstream nodes. | LOAD3DMODELINFO | +| `camera_info` | Camera information passed through for downstream nodes. | LOAD3DCAMERA | +| `width` | The width value passed through for downstream nodes. | INT | +| `height` | The height value passed through for downstream nodes. | 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` diff --git a/built-in-nodes/SaveGaussianSplat.mdx b/built-in-nodes/SaveGaussianSplat.mdx new file mode 100644 index 000000000..73117042f --- /dev/null +++ b/built-in-nodes/SaveGaussianSplat.mdx @@ -0,0 +1,36 @@ +--- +title: "SaveGaussianSplat - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the SaveGaussianSplat node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "SaveGaussianSplat" +icon: "circle" +mode: wide +--- + +This node saves a Gaussian splat 3D file to the ComfyUI output directory and provides preview data for the 3D viewer. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `model_3d` | A gaussian splat 3D file. | FILE3D | Yes | - | +| `filename_prefix` | Prefix for the saved filename (default: "3d/ComfyUI") | STRING | Yes | - | +| `viewport_state` | The current viewport state from a 3D loader node. | LOAD3D | Yes | - | +| `model_3d_info` | Additional 3D model information for the preview. | LOAD3DMODELINFO | No | - | +| `camera_info` | Camera information for the preview. | LOAD3DCAMERA | No | - | +| `width` | Width of the preview in pixels (default: 1024) | INT | Yes | min: 1, max: 4096, step: 1 | +| `height` | Height of the preview in pixels (default: 1024) | INT | Yes | min: 1, max: 4096, step: 1 | + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `model_3d` | The saved Gaussian splat 3D file. | FILE3D | +| `model_3d_info` | 3D model information for the preview. | LOAD3DMODELINFO | +| `camera_info` | Camera information for the preview. | LOAD3DCAMERA | +| `width` | Width of the preview. | INT | +| `height` | Height of the preview. | 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/SaveGaussianSplat/en.md) + +--- +**Source fingerprint (SHA-256):** `f2d6b98d2ce1fe11df8ba440b7f46a21e2308966c15daa5ca0bdca7dab1726cc` diff --git a/built-in-nodes/SavePointCloud.mdx b/built-in-nodes/SavePointCloud.mdx new file mode 100644 index 000000000..494ebf36c --- /dev/null +++ b/built-in-nodes/SavePointCloud.mdx @@ -0,0 +1,36 @@ +--- +title: "SavePointCloud - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the SavePointCloud node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "SavePointCloud" +icon: "circle" +mode: wide +--- + +The Save Point Cloud node saves a 3D point cloud file to your ComfyUI output directory. It also passes through the point cloud data and optional camera and model information for use by other nodes in your workflow. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `model_3d` | Point cloud file (.ply) | FILE3D | Yes | - | +| `filename_prefix` | Prefix for the saved file name (default: "3d/ComfyUI") | STRING | Yes | - | +| `viewport_state` | State from a 3D viewport node | LOAD3D | Yes | - | +| `model_3d_info` | Optional 3D model information for advanced use | LOAD3DMODELINFO | No | - | +| `camera_info` | Optional camera information for advanced use | LOAD3DCAMERA | No | - | +| `width` | Width of the preview image in pixels (default: 1024) | INT | Yes | min: 1, max: 4096, step: 1 | +| `height` | Height of the preview image in pixels (default: 1024) | INT | Yes | min: 1, max: 4096, step: 1 | + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `model_3d` | The saved point cloud file | FILE3D | +| `model_3d_info` | Information about the 3D model | LOAD3DMODELINFO | +| `camera_info` | Camera information for the viewport | LOAD3DCAMERA | +| `width` | Width of the preview image | INT | +| `height` | Height of the preview image | 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/SavePointCloud/en.md) + +--- +**Source fingerprint (SHA-256):** `ce8f005c431843a57d87a4aff2eed7a1604ebdf360f83b3aaaadc3ed364d218a` diff --git a/built-in-nodes/SaveText.mdx b/built-in-nodes/SaveText.mdx new file mode 100644 index 000000000..2617b99dd --- /dev/null +++ b/built-in-nodes/SaveText.mdx @@ -0,0 +1,28 @@ +--- +title: "SaveText - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the SaveText node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "SaveText" +icon: "circle" +mode: wide +--- + +The Save Text node writes text content to a file in the output directory. It supports saving in three different file formats: plain text (.txt), Markdown (.md), and JSON (.json). When saving as JSON, the node attempts to parse the input text as valid JSON and format it with proper indentation. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `text` | The text content to save to a file | STRING | Yes | | +| `filename_prefix` | Prefix for the output filename (default: "ComfyUI") | STRING | No | | +| `format` | File format to save the text as (default: "txt") | STRING | No | `"txt"`
`"md"`
`"json"` | + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `text` | The original text content that was saved to the file | 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/SaveText/en.md) + +--- +**Source fingerprint (SHA-256):** `5644d143f415773115b38d7af6d9afea20c9eadef2cea836b0384c15e0dcba6a` diff --git a/built-in-nodes/SeedVR2TemporalChunk.mdx b/built-in-nodes/SeedVR2TemporalChunk.mdx new file mode 100644 index 000000000..76623a4ba --- /dev/null +++ b/built-in-nodes/SeedVR2TemporalChunk.mdx @@ -0,0 +1,41 @@ +--- +title: "SeedVR2TemporalChunk - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the SeedVR2TemporalChunk node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "SeedVR2TemporalChunk" +icon: "circle" +mode: wide +--- + +This node splits a SeedVR2 video latent into smaller overlapping temporal chunks that can be processed one at a time within available VRAM. The chunks are designed to be passed to both the Apply SeedVR2 Conditioning node and the sampler latent input, then later recombined using the Merge SeedVR2 Latents node. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `latent` | The VAE-encoded SeedVR2 latent to split | LATENT | Yes | - | +| `temporal_overlap` | Latent frames shared between adjacent chunks and crossfaded at merge; 0 means no overlap (default: 0) | INT | No | 0 to 16384 | +| `chunking_mode` | manual = use frames_per_chunk exactly; auto = predict the largest chunk that fits free VRAM | COMBO | Yes | "auto"
"manual" | + +When `chunking_mode` is set to "manual", the following parameter becomes available: + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `frames_per_chunk` | Pixel frames per temporal chunk (must be 4n+1: 1, 5, 9, 13, ...) (default: 21) | INT | Yes | 1 to 16384, step 4 | + +**Notes on parameter constraints:** +- The input `latent` must be a 5-dimensional video latent with shape (B, C, T, H, W) and exactly 4 latent channels +- When using "manual" mode, `frames_per_chunk` must be a 4n+1 value (1, 5, 9, 13, 17, 21, ...) +- `temporal_overlap` is automatically capped to be less than the chunk size +- In "auto" mode, the node calculates the optimal chunk size based on available free VRAM + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `latents` | The temporal chunks in sequence order | LATENT | +| `temporal_overlap` | The effective latent-frame overlap between adjacent chunks, for Merge SeedVR2 Latents | 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/SeedVR2TemporalChunk/en.md) + +--- +**Source fingerprint (SHA-256):** `40af2b690f74555efbe38f4cf76825417f52735ce90296a9ad662f78cfe4c6bf` diff --git a/built-in-nodes/SeedVR2TemporalMerge.mdx b/built-in-nodes/SeedVR2TemporalMerge.mdx new file mode 100644 index 000000000..11e27000b --- /dev/null +++ b/built-in-nodes/SeedVR2TemporalMerge.mdx @@ -0,0 +1,29 @@ +--- +title: "SeedVR2TemporalMerge - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the SeedVR2TemporalMerge node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "SeedVR2TemporalMerge" +icon: "circle" +mode: wide +--- + +This node recombines temporal chunks of latent video data that were previously split by the Split SeedVR2 Latent node. It uses a Hann window crossfade over the overlapping regions to create a smooth transition between chunks, or performs a simple concatenation when no overlap is specified. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `latents` | The sampled temporal chunks in sequence order. | LATENT | Yes | List of latents | +| `temporal_overlap` | The temporal_overlap output of Split SeedVR2 Latent. 0 = plain concatenation. | INT | Yes | 0 to 16384 (default: 0) | + +**Note:** The `temporal_overlap` parameter must be wired from the `temporal_overlap` output of the Split SeedVR2 Latent node. All input latents must have the same batch size, number of channels, height, and width. Only the final chunk may have a shorter temporal dimension than the others. + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `latent` | The recombined full-length latent. | 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/SeedVR2TemporalMerge/en.md) + +--- +**Source fingerprint (SHA-256):** `647653fc651462f62bcc9dca2919cfcaa4b476b4c679b0a1111698facab83f28` diff --git a/built-in-nodes/SyncLipSyncNode.mdx b/built-in-nodes/SyncLipSyncNode.mdx new file mode 100644 index 000000000..52f60a49e --- /dev/null +++ b/built-in-nodes/SyncLipSyncNode.mdx @@ -0,0 +1,56 @@ +--- +title: "SyncLipSyncNode - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the SyncLipSyncNode node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "SyncLipSyncNode" +icon: "circle" +mode: wide +--- + +This node re-syncs mouth movement in a video to new speech audio using the sync.so API. It handles close-ups, profiles and obstructions automatically while preserving the speaker's expression. Cost scales with output duration. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `video` | Footage of the speaker to re-sync. Up to 4K (4096x2160); a constant frame rate of 24/25/30 fps works best. | VIDEO | Yes | - | +| `audio` | Speech audio to sync the mouth to. | AUDIO | Yes | - | +| `seed` | Seed controls whether the node should re-run; results are non-deterministic regardless of seed (default: 42). | INT | Yes | 0 to 2147483647 | +| `model` | sync.so generation model. | COMBO | Yes | See below | + +The `model` parameter is a dynamic combo that includes the following sub-parameters: + +| Sub-parameter | Description | Data Type | Required | Range | +|---------------|-------------|-----------|----------|-------| +| `sync_mode` | How to handle a duration mismatch between video and audio; this also sets the output length (default: "bounce"). | COMBO | Yes | `"bounce"`
`"cut_off"`
`"loop"`
`"silence"`
`"remap"` | +| `speaker_selection` | Which face to lipsync when several people are visible (default: "default"). | COMBO | Yes | `"default"`
`"auto-detect"`
`"coordinates"` | +| `speaker_frame` | Video frame used to locate the speaker. Only used when `speaker_selection` is "coordinates" (default: 0). | INT | No | 0 to 1000000 | +| `speaker_x` | X pixel coordinate of the speaker's face. Only used when `speaker_selection` is "coordinates" (default: 0). | INT | No | 0 to 4096 | +| `speaker_y` | Y pixel coordinate of the speaker's face. Only used when `speaker_selection` is "coordinates" (default: 0). | INT | No | 0 to 4096 | + +**Sync mode options:** +- `bounce`: Video plays forward then backward until the audio ends (output = audio length) +- `loop`: Video restarts until the audio ends (output = audio length) +- `remap`: Video is time-stretched to match the audio (output = audio length) +- `cut_off`: The longer track is trimmed (output = shorter length) +- `silence`: Nothing is trimmed; the shorter track is padded (output = longer length) + +**Speaker selection options:** +- `default`: Let the model decide which face to lipsync +- `auto-detect`: Detect and follow the active speaker +- `coordinates`: Target the face at pixel (`speaker_x`, `speaker_y`) in the frame chosen by `speaker_frame` + +**Constraints:** +- Video resolution must not exceed 4K (4096x2160). Videos above this limit will raise an error. +- Audio duration must not exceed 600 seconds (10 minutes). +- The `speaker_frame`, `speaker_x`, and `speaker_y` parameters are only used when `speaker_selection` is set to "coordinates". + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `video` | The re-synced video with mouth movement matched to the provided audio. | 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/SyncLipSyncNode/en.md) + +--- +**Source fingerprint (SHA-256):** `b41f8c9bf0d55059f081a66af20636ec96462c3fd9caeb685cab10278f84678a` diff --git a/built-in-nodes/SyncTalkingImageNode.mdx b/built-in-nodes/SyncTalkingImageNode.mdx new file mode 100644 index 000000000..b69293cdf --- /dev/null +++ b/built-in-nodes/SyncTalkingImageNode.mdx @@ -0,0 +1,36 @@ +--- +title: "SyncTalkingImageNode - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the SyncTalkingImageNode node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "SyncTalkingImageNode" +icon: "circle" +mode: wide +--- + +Animate a still portrait into a talking video driven by speech audio, using sync.so's sync-3 model. The output duration matches the audio duration, and cost scales with output duration. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `image` | A single image with a clearly visible face, up to 4K (4096x2160). | IMAGE | Yes | Exactly one image required | +| `audio` | Speech audio driving the talking video; the output duration matches it. Chain any TTS node here to drive the animation from text. | AUDIO | Yes | Maximum duration: 600 seconds | +| `prompt` | Optional guidance for how the portrait comes to life, e.g. 'make the subject smile and look at the camera'. Leave empty for natural talking motion. (default: "") | STRING | No | Multiline text | +| `seed` | Seed controls whether the node should re-run; results are non-deterministic regardless of seed. (default: 0) | INT | No | 0 to 2147483647 | +| `model` | sync.so generation model. Image input is exclusive to sync-3. | COMBO | Yes | `"sync-3"` | +| `speaker_selection` | Which face to animate when several people are visible. `default`: let the model decide. `coordinates`: target the face at pixel (speaker_x, speaker_y) in the image. Auto-detection is not supported for images. (default: "default") | COMBO | No | `"default"`
`"coordinates"` | +| `speaker_x` | X pixel coordinate of the speaker's face. Only used when speaker_selection is 'coordinates'. (default: 0) | INT | No | 0 to 4096 | +| `speaker_y` | Y pixel coordinate of the speaker's face. Only used when speaker_selection is 'coordinates'. (default: 0) | INT | No | 0 to 4096 | +| `auto_downscale` | Automatically downscale the image if it exceeds the 4K (4096x2160) input limit; speaker coordinates are scaled to match. When disabled, an oversized image raises an error instead. (default: True) | BOOLEAN | No | True
False | + +**Note:** The `speaker_x` and `speaker_y` parameters are only used when `speaker_selection` is set to `"coordinates"`. When `auto_downscale` is enabled, speaker coordinates are automatically scaled to match the downscaled image dimensions. + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `video` | The generated talking video with the animated portrait synchronized to the input audio. | 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/SyncTalkingImageNode/en.md) + +--- +**Source fingerprint (SHA-256):** `21f722cdcc5ff017949887ed2252854feebb9b913034dc6a6c3ce196ad089468` diff --git a/built-in-nodes/TextEncodeJoyImageEdit.mdx b/built-in-nodes/TextEncodeJoyImageEdit.mdx new file mode 100644 index 000000000..2a8a35e3c --- /dev/null +++ b/built-in-nodes/TextEncodeJoyImageEdit.mdx @@ -0,0 +1,29 @@ +--- +title: "TextEncodeJoyImageEdit - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the TextEncodeJoyImageEdit node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "TextEncodeJoyImageEdit" +icon: "circle" +mode: wide +--- + +This node encodes a text prompt and optional images into conditioning data for use with JoyImage models. It combines a CLIP text encoder with optional image inputs to create rich conditioning that can guide image generation or editing tasks. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `clip` | The CLIP model used for encoding the text prompt | CLIP | Yes | - | +| `prompt` | The text prompt to encode, supporting multiline input and dynamic prompts | STRING | Yes | - | +| `vae` | A VAE model for encoding images into latent space (optional) | VAE | No | - | +| `images` | One or more images to include in the conditioning, up to a maximum of 6 images | IMAGE | No | 0 to 6 images | + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `CONDITIONING` | The encoded conditioning data combining the text prompt and any provided images | CONDITIONING | + +> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TextEncodeJoyImageEdit/en.md) + +--- +**Source fingerprint (SHA-256):** `ef48523aa9fc990b2839d755cef272bcdfbacef5af8d961736fde5200c6f082d` diff --git a/built-in-nodes/TextOverlay.mdx b/built-in-nodes/TextOverlay.mdx new file mode 100644 index 000000000..75e931e56 --- /dev/null +++ b/built-in-nodes/TextOverlay.mdx @@ -0,0 +1,32 @@ +--- +title: "TextOverlay - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the TextOverlay node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "TextOverlay" +icon: "circle" +mode: wide +--- + +This node draws text on top of an image or a batch of images. It supports custom text, font size, color, position, alignment, and an optional outline, compositing the text over the original image. + +## Inputs + +| Parameter | Description | Data Type | Required | Range | +|-----------|-------------|-----------|----------|-------| +| `images` | The input image or batch of images to draw text on. | IMAGE | Yes | | +| `text` | The text string to overlay. Supports newline (`\n`) and tab (`\t`) characters. Default: "" | STRING | Yes | | +| `font_size` | Font size as a percentage of the image height. Default: 5.0 | FLOAT | Yes | 0.5 to 50.0 | +| `color` | Color of the text. Default: "#ffffff" (white) | 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 | | + +## Outputs + +| Output Name | Description | Data Type | +|-------------|-------------|-----------| +| `images` | The image or batch of images with the text overlay composited on top. | 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/TextOverlay/en.md) + +--- +**Source fingerprint (SHA-256):** `baffaa4ec9d3565e3533673658399271234def8c49e2e4a5f16767ec3f98cb22` diff --git a/docs.json b/docs.json index ea4390f4e..3457c18be 100644 --- a/docs.json +++ b/docs.json @@ -619,7 +619,10 @@ "built-in-nodes/PreviewPointCloud", "built-in-nodes/SaveGLB", "built-in-nodes/VoxelToMesh", - "built-in-nodes/VoxelToMeshBasic" + "built-in-nodes/VoxelToMeshBasic", + "built-in-nodes/Save3DAdvanced", + "built-in-nodes/SaveGaussianSplat", + "built-in-nodes/SavePointCloud" ] }, { @@ -1470,7 +1473,13 @@ "built-in-nodes/ReferenceTimbreAudio", "built-in-nodes/StyleModelApply", "built-in-nodes/T5TokenizerOptions", - "built-in-nodes/unCLIPConditioning" + "built-in-nodes/unCLIPConditioning", + { + "group": "Joyimage", + "pages": [ + "built-in-nodes/TextEncodeJoyImageEdit" + ] + } ] }, { @@ -1519,7 +1528,9 @@ "built-in-nodes/LatentFromBatch", "built-in-nodes/RebatchLatents", "built-in-nodes/RepeatLatentBatch", - "built-in-nodes/ReplaceVideoLatentFrames" + "built-in-nodes/ReplaceVideoLatentFrames", + "built-in-nodes/SeedVR2TemporalChunk", + "built-in-nodes/SeedVR2TemporalMerge" ] }, { @@ -1812,7 +1823,13 @@ "built-in-nodes/ModelSamplingDiscrete", "built-in-nodes/RenormCFG", "built-in-nodes/RescaleCFG", - "built-in-nodes/ScaleROPE" + "built-in-nodes/ScaleROPE", + { + "group": "Anima", + "pages": [ + "built-in-nodes/AnimaLLLiteApply" + ] + } ] }, { @@ -2003,6 +2020,12 @@ "built-in-nodes/SoniloTextToMusic", "built-in-nodes/SoniloVideoToMusic" ] + }, + { + "group": "Heygen", + "pages": [ + "built-in-nodes/HeyGenTextToSpeechNode" + ] } ] }, @@ -2412,6 +2435,22 @@ "pages": [ "built-in-nodes/WavespeedFlashVSRNode" ] + }, + { + "group": "Heygen", + "pages": [ + "built-in-nodes/HeyGenAvatarVideoNode", + "built-in-nodes/HeyGenCreateAvatarNode", + "built-in-nodes/HeyGenTalkingPhotoNode", + "built-in-nodes/HeyGenVideoTranslateNode" + ] + }, + { + "group": "Sync.So", + "pages": [ + "built-in-nodes/SyncLipSyncNode", + "built-in-nodes/SyncTalkingImageNode" + ] } ] } @@ -2462,7 +2501,9 @@ "built-in-nodes/TextGenerateLTX2Prompt", "built-in-nodes/TextToLowercase", "built-in-nodes/TextToUppercase", - "built-in-nodes/TruncateText" + "built-in-nodes/TruncateText", + "built-in-nodes/SaveText", + "built-in-nodes/TextOverlay" ] }, { diff --git a/ja/built-in-nodes/AnimaLLLiteApply.mdx b/ja/built-in-nodes/AnimaLLLiteApply.mdx new file mode 100644 index 000000000..e9e6b315e --- /dev/null +++ b/ja/built-in-nodes/AnimaLLLiteApply.mdx @@ -0,0 +1,34 @@ +--- +title: "AnimaLLLiteApply - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the AnimaLLLiteApply node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "AnimaLLLiteApply" +icon: "circle" +mode: wide +--- + +このノードは、拡散モデルに軽量なアニメーションパッチを適用し、調整可能な強度とタイミングで制御された画像間生成を可能にします。事前設定されたモデルパッチを入力画像とオプションのマスクと統合し、モデルのアテンション層とMLP層を変更して生成プロセスに影響を与えます。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `model` | パッチを適用するベースの拡散モデル | MODEL | はい | | +| `model_patch` | 適用する事前設定済みのアニメーションパッチ | MODEL_PATCH | はい | | +| `image` | 生成をガイドする参照画像 | IMAGE | はい | | +| `strength` | パッチ効果の強度(デフォルト:1.0) | FLOAT | はい | -10.0 ~ 10.0 | +| `start_percent` | パッチが効果を発揮し始めるノイズ除去プロセスの割合(デフォルト:0.0) | FLOAT | はい | 0.0 ~ 1.0 | +| `end_percent` | パッチが効果を停止するノイズ除去プロセスの割合(デフォルト:1.0) | FLOAT | はい | 0.0 ~ 1.0 | +| `mask` | パッチ効果を画像の特定領域に制限するオプションのマスク | MASK | いいえ | | + +**パラメータ制約に関する注意:** `model_patch` が4つの入力チャンネルを持ち、`mask` が提供されていない場合、画像の寸法に合わせてゼロマスクが自動的に作成されます。`model_patch` が4つの入力チャンネルを持たない場合、`mask` パラメータは無視され、`None` に設定されます。 + +## 出力 + +| 出力名 | 説明 | データ型 | +|-------------|-------------|-----------| +| `MODEL` | アニメーションパッチが適用されたパッチ済み拡散モデル | MODEL | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/AnimaLLLiteApply/ja.md) + +--- +**Source fingerprint (SHA-256):** `291dc6a6619faab1c1100110c71c47381addcd80dbaf933dd8025a376bc2bee7` diff --git a/ja/built-in-nodes/HeyGenAvatarVideoNode.mdx b/ja/built-in-nodes/HeyGenAvatarVideoNode.mdx new file mode 100644 index 000000000..0a2ac04fc --- /dev/null +++ b/ja/built-in-nodes/HeyGenAvatarVideoNode.mdx @@ -0,0 +1,77 @@ +--- +title: "HeyGenAvatarVideoNode - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the HeyGenAvatarVideoNode node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "HeyGenAvatarVideoNode" +icon: "circle" +mode: wide +--- + +あなたは ComfyUI ノードドキュメントを英語から日本語に翻訳する技術翻訳の専門家です。 + +## 翻訳ルール + +1. **翻訳してはいけない内容:** + - バッククォートで囲まれたパラメータ名:`image`、`seed`、`model` + - 大文字のデータ型:IMAGE、STRING、INT、FLOAT、MODEL、CONDITIONING など + - Range列の値:数値、"auto"、オプション名 + - コード、ファイルパス + +2. **翻訳する内容:** + - セクション見出し:## 概要、## 入力、## 出力 + - すべての説明文 + - パラメータの説明 + +3. **翻訳品質:** + - 丁寧語(です・ます体)を使用 + - 専門的でありながらわかりやすい表現 + - 技術的な正確性を保つ + - 標準的な日本語技術用語を使用 + +4. **フォーマット:** + - すべての Markdown フォーマットを保持 + - 表の構造を維持 + - 免責事項は追加しないでください(システムが文書末尾に自動追加します) + +以下の英語ドキュメントを日本語に翻訳してください(免責事項は含めないでください): + +5. **重要ルール - 出力名:** 出力テーブルの最初の列には出力名(例:`positive`、`negative`、`latent`、`image`、`model`、`conditioning`)が含まれています。これらは**英語のままにしてください**。出力名を翻訳すると重複エントリが発生し、文書構造が壊れます。 + +HeyGenのアバターを使用して、トーキングプレゼンタービデオを生成します。このノードは、HeyGenのレンダリングエンジンを使用して、提供されたテキストを話すAIアバターのビデオ、またはご自身のオーディオにリップシンクするビデオを作成します。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `engine` | レンダリングエンジン。各選択肢は、それをサポートするアバターのみをリスト表示します。'auto' はすべてのアバターを提供し、最適なエンジンを選択します(Avatar IV 優先)。Avatar V は最高忠実度、Avatar III は最も低コストです。 | COMBO | はい | `"auto"`
`"avatar_iv"`
`"avatar_iii"`
`"avatar_v"` | +| `custom_avatar_id` | オプションのHeyGenアバタールックID。設定すると、上記で選択したアバターを上書きします。HeyGenの3000以上の公開ルック(またはプライベートアバター)を使用できます。 | STRING | いいえ | | +| `speech` | テキストスクリプト(HeyGenテキスト読み上げ)またはご自身のオーディオでアバターを駆動します。 | COMBO | はい | `"script"`
`"audio"` | +| `resolution` | 出力ビデオの解像度(デフォルト:"1080p")。 | COMBO | いいえ | `"720p"`
`"1080p"` | +| `aspect_ratio` | 出力のアスペクト比。'auto' はアバターのソース映像に従います(デフォルト:"auto")。 | COMBO | いいえ | `"auto"`
`"16:9"`
`"9:16"`
`"1:1"`
`"4:5"`
`"5:4"` | +| `background_color` | オプションの単色背景色(16進数コード例:'#00ff00')。アバターの元の背景を使用する場合は空欄にします。 | STRING | いいえ | | +| `seed` | HeyGenには送信されません。値を変更して再実行を強制します(デフォルト:42)。 | INT | いいえ | 最小: 0
最大: 2147483647 | + +`s speech` が `"script"` に設定されている場合、以下のサブパラメータが利用可能です: + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `text` | アバターに話させるテキスト(最大5000文字)。生成される音声は少なくとも1秒以上である必要があります。 | STRING | はい | | +| `voice` | スクリプト用の音声。デフォルトオプションは、HeyGenがアバターに割り当てた音声を使用します。 | COMBO | はい | 複数のオプションが利用可能 | +| `custom_voice_id` | オプションのHeyGen音声ID。設定すると、上記で選択した音声を上書きします。HeyGenのライブラリ(2000以上)の任意の音声を使用できます。 | STRING | いいえ | | +| `voice_speed` | 音声速度の倍率(デフォルト:1.0)。 | FLOAT | いいえ | 最小: 0.5
最大: 1.5
ステップ: 0.05 | + +`s speech` が `"audio"` に設定されている場合、以下のサブパラメータが利用可能です: + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `audio` | アバターがリップシンクするためのオーディオ(最大10分)。 | AUDIO | はい | | + +## 出力 + +| 出力名 | 説明 | データ型 | +|-------------|-------------|-----------| +| `VIDEO` | 生成されたアバタープレゼンタービデオ。 | VIDEO | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HeyGenAvatarVideoNode/ja.md) + +--- +**Source fingerprint (SHA-256):** `009bc72b841ca273af83fe6f80fb24d4b11c2efd96c011795b1ff1cf8e66ee61` diff --git a/ja/built-in-nodes/HeyGenCreateAvatarNode.mdx b/ja/built-in-nodes/HeyGenCreateAvatarNode.mdx new file mode 100644 index 000000000..a041fb377 --- /dev/null +++ b/ja/built-in-nodes/HeyGenCreateAvatarNode.mdx @@ -0,0 +1,42 @@ +--- +title: "HeyGenCreateAvatarNode - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the HeyGenCreateAvatarNode node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "HeyGenCreateAvatarNode" +icon: "circle" +mode: wide +--- + +人物の写真、または生成するキャラクターを説明するテキストプロンプトから、再利用可能なHeyGenアバターを作成します。生成されたアバターIDは、HeyGenアバタービデオノードで使用して、このアバターを特徴とする動画を作成できます。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `source` | テキストプロンプトから新しいキャラクターを生成するか、接続された人物の写真からアバターを作成します。 | COMBO | はい | `"prompt"`
`"photo"` | + +`source`が`"prompt"`に設定されている場合、以下の追加パラメータが使用可能になります: + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `prompt` | 生成するアバターの説明(最大1000文字)。 | STRING | はい | 1~1000文字 | +| `reference_images` | 生成される外観をガイドする最大3枚の参照画像。 | IMAGE | いいえ | 0~3枚の画像 | + +`source`が`"photo"`に設定されている場合、以下の追加パラメータが使用可能になります: + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `identity_photo` | アバターに変換する人物の写真。2Kより大きい場合は自動的にダウンスケールされます。 | IMAGE | はい | 単一画像 | + +**注記:** `source`パラメータは2つのモードを切り替えます。`"prompt"`モードでは、テキストによる説明と、オプションで最大3枚の参照画像を提供します。`"photo"`モードでは、人物の写真1枚を提供します。これらのモードは相互に排他的です。 + +## 出力 + +| 出力名 | 説明 | データ型 | +|-------------|-------------|-----------| +| `avatar_id` | アバターのルックID。HeyGenアバタービデオの`custom_avatar_id`に渡します。後でアバターを再利用するために保存します。 | STRING | +| `preview` | 生成されたアバターのプレビュー画像。 | IMAGE | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HeyGenCreateAvatarNode/ja.md) + +--- +**Source fingerprint (SHA-256):** `c60e9cdb0d91fb5ec6ea83b503b9aa10c978ce065a16c751a52e90c12e70a5e2` diff --git a/ja/built-in-nodes/HeyGenTalkingPhotoNode.mdx b/ja/built-in-nodes/HeyGenTalkingPhotoNode.mdx new file mode 100644 index 000000000..0b492ddf4 --- /dev/null +++ b/ja/built-in-nodes/HeyGenTalkingPhotoNode.mdx @@ -0,0 +1,66 @@ +--- +title: "HeyGenTalkingPhotoNode - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the HeyGenTalkingPhotoNode node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "HeyGenTalkingPhotoNode" +icon: "circle" +mode: wide +--- + +あなたは ComfyUI ノードドキュメントを英語から日本語に翻訳する技術翻訳の専門家です。 + +## 翻訳ルール + +1. **翻訳してはいけない内容:** + - バッククォートで囲まれたパラメータ名:`image`、`seed`、`model` + - 大文字のデータ型:IMAGE、STRING、INT、FLOAT、MODEL、CONDITIONING など + - Range列の値:数値、"auto"、オプション名 + - コード、ファイルパス + +2. **翻訳する内容:** + - セクション見出し:## 概要、## 入力、## 出力 + - すべての説明文 + - パラメータの説明 + +3. **翻訳品質:** + - 丁寧語(です・ます体)を使用 + - 専門的でありながらわかりやすい表現 + - 技術的な正確性を保つ + - 標準的な日本語技術用語を使用 + +4. **フォーマット:** + - すべての Markdown フォーマットを保持 + - 表の構造を維持 + - 免責事項は追加しないでください(システムが文書末尾に自動追加します) + +以下の英語ドキュメントを日本語に翻訳してください(免責事項は含めないでください): + +5. **重要ルール - 出力名:** 出力テーブルの最初の列には出力名(例:`positive`、`negative`、`latent`、`image`、`model`、`conditioning`)が含まれています。これらは**英語のままにしてください**。出力名を翻訳すると重複エントリが発生し、文書構造が壊れます。 + +HeyGenのアバターIV技術を使用して、人物の静止画像をリップシンク対応のトーキングビデオにアニメーション化します。HeyGenが音声に変換するテキストスクリプトでアニメーションを駆動することも、アバターにリップシンクさせる独自の音声を提供することもできます。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `image` | アニメーション化する人物の画像。2Kより大きい場合は自動的にダウンスケールされます。 | IMAGE | はい | - | +| `speech` | テキストスクリプト(HeyGenテキスト読み上げ)または独自の音声でアバターを駆動します。 | COMBO | はい | `"script"`
`"audio"` | +| `text` | アバターに話させるテキスト(最大5000文字)。生成される音声は少なくとも1秒の長さが必要です。 | STRING | はい(speechが"script"の場合) | - | +| `voice` | スクリプト用の音声(HeyGenで最も人気のある音声)。 | COMBO | はい(speechが"script"の場合) | 複数のオプションが利用可能 | +| `custom_voice_id` | オプションのHeyGen音声ID。設定すると、上記で選択した音声が上書きされます。HeyGenのライブラリ(2000以上)の任意の音声を使用できます。 | STRING | いいえ | - | +| `voice_speed` | 音声速度の倍率(デフォルト:1.0)。 | FLOAT | いいえ | 0.5 から 1.5 | +| `audio` | アバターがリップシンクする音声(最大10分)。 | AUDIO | はい(speechが"audio"の場合) | - | +| `resolution` | 出力ビデオの解像度(デフォルト:"1080p")。 | COMBO | いいえ | `"720p"`
`"1080p"` | +| `aspect_ratio` | 出力のアスペクト比。「auto」は入力画像に従います(デフォルト:"auto")。 | COMBO | いいえ | `"auto"`
`"16:9"`
`"9:16"`
`"1:1"`
`"4:5"`
`"5:4"` | +| `expressiveness` | アニメーション化された顔とジェスチャーの表現力(デフォルト:"low")。 | COMBO | いいえ | `"low"`
`"medium"`
`"high"` | +| `seed` | HeyGenには送信されません。変更して再実行を強制します(デフォルト:42)。 | INT | いいえ | 0 から 2147483647 | + +## 出力 + +| 出力名 | 説明 | データ型 | +|-------------|-------------|-----------| +| `video` | リップシンクされた音声付きのアニメーション化されたトーキングフォトの生成ビデオ。 | VIDEO | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HeyGenTalkingPhotoNode/ja.md) + +--- +**Source fingerprint (SHA-256):** `2181066a8c6191cfcaa15ece4f89a16c37e76aa22763d6df4007baa20336f05a` diff --git a/ja/built-in-nodes/HeyGenTextToSpeechNode.mdx b/ja/built-in-nodes/HeyGenTextToSpeechNode.mdx new file mode 100644 index 000000000..180e112c7 --- /dev/null +++ b/ja/built-in-nodes/HeyGenTextToSpeechNode.mdx @@ -0,0 +1,31 @@ +--- +title: "HeyGenTextToSpeechNode - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the HeyGenTextToSpeechNode node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "HeyGenTextToSpeechNode" +icon: "circle" +mode: wide +--- + +HeyGen の Starfish TTS エンジンを使用して、テキストから音声を生成します。このノードには、17言語に対応したHeyGenで最も人気のある音声が含まれています。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `text` | 合成するテキスト(最大5000文字)。生成される音声は少なくとも1秒以上の長さが必要です。 | STRING | はい | 1~5000文字 | +| `voice` | 使用する音声(HeyGenで最も人気のあるStarfish対応音声から厳選)。 | STRING | はい | 複数のオプションから選択可能 | +| `custom_voice_id` | オプションのHeyGen音声ID。設定すると、上記で選択した音声が上書きされます。この音声はStarfishエンジンをサポートしている必要があります。 | STRING | いいえ | 任意の有効なHeyGen音声ID | +| `speed` | 音声再生速度の倍率(デフォルト:1.0)。 | FLOAT | いいえ | 0.5~2.0(ステップ:0.05) | +| `ssml` | テキストをSSMLマークアップとして扱います(ポーズ、強調、発音の制御用)(デフォルト:False)。 | BOOLEAN | いいえ | True / False | +| `seed` | HeyGenには送信されません。変更すると再実行が強制されます(デフォルト:42)。 | INT | いいえ | 0~2147483647 | + +## 出力 + +| 出力名 | 説明 | データ型 | +|-------------|-------------|-----------| +| `AUDIO` | 入力テキストから生成された合成音声。 | AUDIO | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HeyGenTextToSpeechNode/ja.md) + +--- +**Source fingerprint (SHA-256):** `82300626657db8ab16e96ae96b7dfe3291b77bf75efec35971dc772e5123cce7` diff --git a/ja/built-in-nodes/HeyGenVideoTranslateNode.mdx b/ja/built-in-nodes/HeyGenVideoTranslateNode.mdx new file mode 100644 index 000000000..b3288a40c --- /dev/null +++ b/ja/built-in-nodes/HeyGenVideoTranslateNode.mdx @@ -0,0 +1,61 @@ +--- +title: "HeyGenVideoTranslateNode - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the HeyGenVideoTranslateNode node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "HeyGenVideoTranslateNode" +icon: "circle" +mode: wide +--- + +あなたは ComfyUI ノードドキュメントを英語から日本語に翻訳する技術翻訳の専門家です。 + +## 翻訳ルール + +1. **翻訳してはいけない内容:** + - バッククォートで囲まれたパラメータ名:`image`、`seed`、`model` + - 大文字のデータ型:IMAGE、STRING、INT、FLOAT、MODEL、CONDITIONING など + - Range列の値:数値、"auto"、オプション名 + - コード、ファイルパス + +2. **翻訳する内容:** + - セクション見出し:## 概要、## 入力、## 出力 + - すべての説明文 + - パラメータの説明 + +3. **翻訳品質:** + - 丁寧語(です・ます体)を使用 + - 専門的でありながらわかりやすい表現 + - 技術的な正確性を保つ + - 標準的な日本語技術用語を使用 + +4. **フォーマット:** + - すべての Markdown フォーマットを保持 + - 表の構造を維持 + - 免責事項は追加しないでください(システムが文書末尾に自動追加します) + +以下の英語ドキュメントを日本語に翻訳してください(免責事項は含めないでください): + +5. **重要ルール - 出力名:** 出力テーブルの最初の列には出力名(例:`positive`、`negative`、`latent`、`image`、`model`、`conditioning`)が含まれています。これらは**英語のままにしてください**。出力名を翻訳すると重複エントリが発生し、文書構造が壊れます。 + +音声付き動画を、音声クローンとリップシンクを用いて別の言語に翻訳します。このノードは、元の話者の声をクローンし、翻訳された音声に合わせて口の動きを再アニメーションすることで、自然な見た目の結果を生成します。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `video` | 翻訳対象の音声付き動画です。 | VIDEO | はい | - | +| `output_language` | 翻訳後の動画のターゲット言語です。 | STRING | はい | "Arabic"
"Bengali"
"Chinese"
"Danish"
"Dutch"
"English"
"French"
"German"
"Greek"
"Hindi"
"Indonesian"
"Italian"
"Japanese"
"Korean"
"Malay"
"Polish"
"Portuguese"
"Russian"
"Spanish"
"Swedish"
"Tamil"
"Telugu"
"Thai"
"Turkish"
"Ukrainian"
"Vietnamese" | +| `mode` | 'speed'は高速処理、'precision'は2倍のコストで高品質なリップシンクを生成します。 | STRING | はい | "speed"
"precision" | +| `translate_audio_only` | 音声トラックのみを差し替え、元の口の動きを維持します(リップシンクなし)。(デフォルト: False) | BOOLEAN | いいえ | True
False | +| `speaker_count` | 動画内の話者の人数です。0を指定すると自動検出されます。(デフォルト: 0) | INT | いいえ | 0 ~ 10 | +| `seed` | HeyGenには送信されません。値を変更すると強制的に再実行されます。(デフォルト: 42) | INT | いいえ | 0 ~ 2147483647 | + +## 出力 + +| 出力名 | 説明 | データ型 | +|-------------|-------------|-----------| +| `video` | 音声クローンとリップシンクが適用された翻訳済み動画です。 | VIDEO | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HeyGenVideoTranslateNode/ja.md) + +--- +**Source fingerprint (SHA-256):** `31056060b6309b8ec28b37b353322403e173fd2862b56021392dba24e7a15f69` diff --git a/ja/built-in-nodes/Save3DAdvanced.mdx b/ja/built-in-nodes/Save3DAdvanced.mdx new file mode 100644 index 000000000..7fb089424 --- /dev/null +++ b/ja/built-in-nodes/Save3DAdvanced.mdx @@ -0,0 +1,36 @@ +--- +title: "Save3DAdvanced - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the Save3DAdvanced node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "Save3DAdvanced" +icon: "circle" +mode: wide +--- + +このノードは、3DモデルをComfyUIの出力ディレクトリに保存し、高度なプレビュー機能を提供します。出力ファイル名、プレビューサイズを指定でき、オプションでカメラ情報やモデル情報を渡すことで、拡張された3Dビューア体験が可能です。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `model_3d` | 上流の3Dノードからの3Dモデルファイルです。 | FILE3D | はい | GLB、GLTF、FBX、OBJ、STL、USDZ、または任意の3D形式 | +| `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` | 保存された3Dモデルファイルです。 | FILE3D | +| `model_3d_info` | 下流ノードに渡される3Dモデル情報です。 | 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` diff --git a/ja/built-in-nodes/SaveGaussianSplat.mdx b/ja/built-in-nodes/SaveGaussianSplat.mdx new file mode 100644 index 000000000..d8adf6af5 --- /dev/null +++ b/ja/built-in-nodes/SaveGaussianSplat.mdx @@ -0,0 +1,36 @@ +--- +title: "SaveGaussianSplat - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the SaveGaussianSplat node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "SaveGaussianSplat" +icon: "circle" +mode: wide +--- + +このノードは、Gaussian splat 3DファイルをComfyUIの出力ディレクトリに保存し、3Dビューア用のプレビューデータを提供します。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `model_3d` | Gaussian splat 3Dファイルです。 | FILE3D | はい | - | +| `filename_prefix` | 保存されるファイル名のプレフィックス(デフォルト:"3d/ComfyUI") | STRING | はい | - | +| `viewport_state` | 3Dローダーノードからの現在のビューポート状態です。 | LOAD3D | はい | - | +| `model_3d_info` | プレビュー用の追加の3Dモデル情報です。 | LOAD3DMODELINFO | いいえ | - | +| `camera_info` | プレビュー用のカメラ情報です。 | LOAD3DCAMERA | いいえ | - | +| `width` | プレビューの幅(ピクセル単位、デフォルト:1024) | INT | はい | 最小:1、最大:4096、ステップ:1 | +| `height` | プレビューの高さ(ピクセル単位、デフォルト:1024) | INT | はい | 最小:1、最大:4096、ステップ:1 | + +## 出力 + +| 出力名 | 説明 | データ型 | +|-------------|-------------|-----------| +| `model_3d` | 保存されたGaussian splat 3Dファイルです。 | FILE3D | +| `model_3d_info` | プレビュー用の3Dモデル情報です。 | LOAD3DMODELINFO | +| `camera_info` | プレビュー用のカメラ情報です。 | LOAD3DCAMERA | +| `width` | プレビューの幅です。 | INT | +| `height` | プレビューの高さです。 | INT | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SaveGaussianSplat/ja.md) + +--- +**Source fingerprint (SHA-256):** `f2d6b98d2ce1fe11df8ba440b7f46a21e2308966c15daa5ca0bdca7dab1726cc` diff --git a/ja/built-in-nodes/SavePointCloud.mdx b/ja/built-in-nodes/SavePointCloud.mdx new file mode 100644 index 000000000..f84b179d6 --- /dev/null +++ b/ja/built-in-nodes/SavePointCloud.mdx @@ -0,0 +1,36 @@ +--- +title: "SavePointCloud - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the SavePointCloud node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "SavePointCloud" +icon: "circle" +mode: wide +--- + +Save Point Cloudノードは、3D点群ファイルをComfyUIの出力ディレクトリに保存します。また、点群データとオプションのカメラ情報およびモデル情報をワークフロー内の他のノードで使用できるように通過させます。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `model_3d` | 点群ファイル (.ply) | FILE3D | はい | - | +| `filename_prefix` | 保存ファイル名のプレフィックス(デフォルト:"3d/ComfyUI") | STRING | はい | - | +| `viewport_state` | 3Dビューポートノードからの状態 | LOAD3D | はい | - | +| `model_3d_info` | 高度な使用のためのオプションの3Dモデル情報 | LOAD3DMODELINFO | いいえ | - | +| `camera_info` | 高度な使用のためのオプションのカメラ情報 | LOAD3DCAMERA | いいえ | - | +| `width` | プレビュー画像の幅(ピクセル単位、デフォルト:1024) | INT | はい | 最小:1、最大:4096、ステップ:1 | +| `height` | プレビュー画像の高さ(ピクセル単位、デフォルト:1024) | INT | はい | 最小:1、最大:4096、ステップ:1 | + +## 出力 + +| 出力名 | 説明 | データ型 | +|-------------|-------------|-----------| +| `model_3d` | 保存された点群ファイル | FILE3D | +| `model_3d_info` | 3Dモデルに関する情報 | LOAD3DMODELINFO | +| `camera_info` | ビューポートのカメラ情報 | LOAD3DCAMERA | +| `width` | プレビュー画像の幅 | INT | +| `height` | プレビュー画像の高さ | INT | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SavePointCloud/ja.md) + +--- +**Source fingerprint (SHA-256):** `ce8f005c431843a57d87a4aff2eed7a1604ebdf360f83b3aaaadc3ed364d218a` diff --git a/ja/built-in-nodes/SaveText.mdx b/ja/built-in-nodes/SaveText.mdx new file mode 100644 index 000000000..b7eb11ddb --- /dev/null +++ b/ja/built-in-nodes/SaveText.mdx @@ -0,0 +1,28 @@ +--- +title: "SaveText - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the SaveText node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "SaveText" +icon: "circle" +mode: wide +--- + +Save Textノードは、テキストコンテンツを出力ディレクトリ内のファイルに書き込みます。このノードは、プレーンテキスト(.txt)、Markdown(.md)、JSON(.json)の3種類のファイル形式での保存をサポートしています。JSONとして保存する場合、ノードは入力テキストを有効なJSONとして解析し、適切なインデントでフォーマットを整えようと試みます。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `text` | ファイルに保存するテキストコンテンツ | STRING | はい | | +| `filename_prefix` | 出力ファイル名のプレフィックス(デフォルト:"ComfyUI") | STRING | いいえ | | +| `format` | テキストを保存するファイル形式(デフォルト:"txt") | STRING | いいえ | `"txt"`
`"md"`
`"json"` | + +## 出力 + +| 出力名 | 説明 | データ型 | +|-------------|-------------|-----------| +| `text` | ファイルに保存された元のテキストコンテンツ | STRING | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SaveText/ja.md) + +--- +**Source fingerprint (SHA-256):** `5644d143f415773115b38d7af6d9afea20c9eadef2cea836b0384c15e0dcba6a` diff --git a/ja/built-in-nodes/SeedVR2TemporalChunk.mdx b/ja/built-in-nodes/SeedVR2TemporalChunk.mdx new file mode 100644 index 000000000..222fe1572 --- /dev/null +++ b/ja/built-in-nodes/SeedVR2TemporalChunk.mdx @@ -0,0 +1,41 @@ +--- +title: "SeedVR2TemporalChunk - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the SeedVR2TemporalChunk node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "SeedVR2TemporalChunk" +icon: "circle" +mode: wide +--- + +このノードは、SeedVR2ビデオ潜在表現を、利用可能なVRAM内で一度に一つずつ処理できる小さな重なり合う時間的チャンクに分割します。チャンクは、Apply SeedVR2 Conditioningノードとサンプラーの潜在入力の両方に渡され、後でMerge SeedVR2 Latentsノードを使用して再結合されるように設計されています。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `latent` | 分割するVAEエンコード済みのSeedVR2潜在表現 | LATENT | はい | - | +| `temporal_overlap` | 隣接するチャンク間で共有され、マージ時にクロスフェードされる潜在フレーム数。0は重なりなしを意味します(デフォルト:0) | INT | いいえ | 0 ~ 16384 | +| `chunking_mode` | manual = frames_per_chunkを正確に使用。auto = 空きVRAMに収まる最大のチャンクを自動予測 | COMBO | はい | "auto"
"manual" | + +`chunking_mode`が"manual"に設定されている場合、以下のパラメータが使用可能になります: + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `frames_per_chunk` | 時間的チャンクあたりのピクセルフレーム数(4n+1の値:1, 5, 9, 13, ... である必要があります)(デフォルト:21) | INT | はい | 1 ~ 16384、ステップ4 | + +**パラメータ制約に関する注意事項:** +- 入力`latent`は、形状が(B, C, T, H, W)で、正確に4つの潜在チャンネルを持つ5次元のビデオ潜在表現である必要があります +- "manual"モードを使用する場合、`frames_per_chunk`は4n+1の値(1, 5, 9, 13, 17, 21, ...)である必要があります +- `temporal_overlap`は自動的にチャンクサイズ未満に制限されます +- "auto"モードでは、ノードは利用可能な空きVRAMに基づいて最適なチャンクサイズを計算します + +## 出力 + +| 出力名 | 説明 | データ型 | +|-------------|-------------|-----------| +| `latents` | 順序通りの時間的チャンク | LATENT | +| `temporal_overlap` | Merge SeedVR2 Latents用の、隣接チャンク間の実効的な潜在フレーム重なり数 | INT | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SeedVR2TemporalChunk/ja.md) + +--- +**Source fingerprint (SHA-256):** `40af2b690f74555efbe38f4cf76825417f52735ce90296a9ad662f78cfe4c6bf` diff --git a/ja/built-in-nodes/SeedVR2TemporalMerge.mdx b/ja/built-in-nodes/SeedVR2TemporalMerge.mdx new file mode 100644 index 000000000..99f41174e --- /dev/null +++ b/ja/built-in-nodes/SeedVR2TemporalMerge.mdx @@ -0,0 +1,29 @@ +--- +title: "SeedVR2TemporalMerge - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the SeedVR2TemporalMerge node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "SeedVR2TemporalMerge" +icon: "circle" +mode: wide +--- + +このノードは、Split SeedVR2 Latentノードによって以前に分割された潜在ビデオデータの時間的チャンクを再結合します。重複領域にはハン窓クロスフェードを適用してチャンク間のスムーズな遷移を実現し、重複が指定されていない場合は単純な連結を実行します。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `latents` | シーケンス順に並べられたサンプリング済み時間的チャンク。 | LATENT | はい | 潜在変数のリスト | +| `temporal_overlap` | Split SeedVR2 Latentのtemporal_overlap出力。0の場合は単純な連結。 | INT | はい | 0~16384(デフォルト:0) | + +**注記:** `temporal_overlap`パラメータは、Split SeedVR2 Latentノードの`temporal_overlap`出力から配線する必要があります。すべての入力潜在変数は、同じバッチサイズ、チャンネル数、高さ、幅を持つ必要があります。最終チャンクのみ、他のチャンクよりも時間的次元が短くなる場合があります。 + +## 出力 + +| 出力名 | 説明 | データ型 | +|-----------|-------------|-----------| +| `latent` | 再結合されたフル長の潜在変数。 | LATENT | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SeedVR2TemporalMerge/ja.md) + +--- +**Source fingerprint (SHA-256):** `647653fc651462f62bcc9dca2919cfcaa4b476b4c679b0a1111698facab83f28` diff --git a/ja/built-in-nodes/SyncLipSyncNode.mdx b/ja/built-in-nodes/SyncLipSyncNode.mdx new file mode 100644 index 000000000..df121ccf2 --- /dev/null +++ b/ja/built-in-nodes/SyncLipSyncNode.mdx @@ -0,0 +1,56 @@ +--- +title: "SyncLipSyncNode - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the SyncLipSyncNode node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "SyncLipSyncNode" +icon: "circle" +mode: wide +--- + +このノードは、sync.so APIを使用して、動画内の口の動きを新しい音声に再同期します。クローズアップ、横向き、遮蔽を自動的に処理しながら、話者の表情を保持します。コストは出力時間に応じて変動します。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `video` | 再同期する話者の映像です。最大4K(4096x2160)まで対応し、24/25/30fpsの固定フレームレートが最適です。 | VIDEO | はい | - | +| `audio` | 口の動きを同期させる音声です。 | AUDIO | はい | - | +| `seed` | シードはノードを再実行するかどうかを制御します。シードに関わらず結果は非決定的です(デフォルト:42)。 | INT | はい | 0 ~ 2147483647 | +| `model` | sync.soの生成モデルです。 | COMBO | はい | 下記参照 | + +`model`パラメータは動的なコンボであり、以下のサブパラメータを含みます: + +| サブパラメータ | 説明 | データ型 | 必須 | 範囲 | +|---------------|-------------|-----------|----------|-------| +| `sync_mode` | 動画と音声の長さが一致しない場合の処理方法です。出力の長さも設定します(デフォルト:"bounce")。 | COMBO | はい | `"bounce"`
`"cut_off"`
`"loop"`
`"silence"`
`"remap"` | +| `speaker_selection` | 複数の人物が映っている場合に、どの顔にリップシンクを行うかを指定します(デフォルト:"default")。 | COMBO | はい | `"default"`
`"auto-detect"`
`"coordinates"` | +| `speaker_frame` | 話者を特定するために使用する動画フレームです。`speaker_selection`が"coordinates"の場合のみ使用されます(デフォルト:0)。 | INT | いいえ | 0 ~ 1000000 | +| `speaker_x` | 話者の顔のXピクセル座標です。`speaker_selection`が"coordinates"の場合のみ使用されます(デフォルト:0)。 | INT | いいえ | 0 ~ 4096 | +| `speaker_y` | 話者の顔のYピクセル座標です。`speaker_selection`が"coordinates"の場合のみ使用されます(デフォルト:0)。 | INT | いいえ | 0 ~ 4096 | + +**同期モードのオプション:** +- `bounce`:動画が最後まで再生された後、逆再生され、音声が終了するまで繰り返します(出力 = 音声の長さ) +- `loop`:動画が音声の終了まで再スタートします(出力 = 音声の長さ) +- `remap`:動画が音声に合わせて時間伸縮されます(出力 = 音声の長さ) +- `cut_off`:長い方のトラックがトリミングされます(出力 = 短い方の長さ) +- `silence`:何もトリミングされず、短い方のトラックがパディングされます(出力 = 長い方の長さ) + +**話者選択のオプション:** +- `default`:モデルにリップシンクする顔を決定させます +- `auto-detect`:アクティブな話者を検出して追跡します +- `coordinates`:`speaker_frame`で選択されたフレーム内のピクセル座標(`speaker_x`、`speaker_y`)の顔をターゲットにします + +**制約事項:** +- 動画の解像度は4K(4096x2160)を超えてはなりません。この制限を超える動画はエラーになります。 +- 音声の長さは600秒(10分)を超えてはなりません。 +- `speaker_frame`、`speaker_x`、`speaker_y`パラメータは、`speaker_selection`が"coordinates"に設定されている場合のみ使用されます。 + +## 出力 + +| 出力名 | 説明 | データ型 | +|-------------|-------------|-----------| +| `video` | 口の動きが提供された音声に合わせて再同期された動画です。 | VIDEO | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SyncLipSyncNode/ja.md) + +--- +**Source fingerprint (SHA-256):** `b41f8c9bf0d55059f081a66af20636ec96462c3fd9caeb685cab10278f84678a` diff --git a/ja/built-in-nodes/SyncTalkingImageNode.mdx b/ja/built-in-nodes/SyncTalkingImageNode.mdx new file mode 100644 index 000000000..36425a2bc --- /dev/null +++ b/ja/built-in-nodes/SyncTalkingImageNode.mdx @@ -0,0 +1,66 @@ +--- +title: "SyncTalkingImageNode - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the SyncTalkingImageNode node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "SyncTalkingImageNode" +icon: "circle" +mode: wide +--- + +あなたは ComfyUI ノードドキュメントを英語から日本語に翻訳する技術翻訳の専門家です。 + +## 翻訳ルール + +1. **翻訳してはいけない内容:** + - バッククォートで囲まれたパラメータ名:`image`、`seed`、`model` + - 大文字のデータ型:IMAGE、STRING、INT、FLOAT、MODEL、CONDITIONING など + - Range列の値:数値、"auto"、オプション名 + - コード、ファイルパス + +2. **翻訳する内容:** + - セクション見出し:## 概要、## 入力、## 出力 + - すべての説明文 + - パラメータの説明 + +3. **翻訳品質:** + - 丁寧語(です・ます体)を使用 + - 専門的でありながらわかりやすい表現 + - 技術的な正確性を保つ + - 標準的な日本語技術用語を使用 + +4. **フォーマット:** + - すべての Markdown フォーマットを保持 + - 表の構造を維持 + - 免責事項は追加しないでください(システムが文書末尾に自動追加します) + +以下の英語ドキュメントを日本語に翻訳してください(免責事項は含めないでください): + +5. **重要ルール - 出力名:** 出力テーブルの最初の列には出力名(例:`positive`、`negative`、`latent`、`image`、`model`、`conditioning`)が含まれています。これらは**英語のままにしてください**。出力名を翻訳すると重複エントリが発生し、文書構造が壊れます。 + +sync.soのsync-3モデルを使用して、静止したポートレートを音声駆動のトーキングビデオにアニメーション化します。出力の長さは音声の長さに一致し、コストは出力の長さに応じて変動します。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `image` | 顔がはっきりと見える単一の画像。最大4K(4096x2160)まで対応します。 | IMAGE | はい | 画像は1枚のみ必須 | +| `audio` | トーキングビデオを駆動する音声。出力の長さはこれに一致します。任意のTTSノードをここにチェーンして、テキストからアニメーションを駆動できます。 | AUDIO | はい | 最大長さ:600秒 | +| `prompt` | ポートレートがどのように動き出すかに関するオプションのガイダンス。例:「被写体を笑顔にしてカメラを見るようにする」。自然な会話の動きの場合は空欄のままにします。(デフォルト:"") | STRING | いいえ | 複数行テキスト | +| `seed` | シードはノードを再実行するかどうかを制御します。シードに関係なく、結果は非決定的です。(デフォルト:0) | INT | いいえ | 0 ~ 2147483647 | +| `model` | sync.soの生成モデル。画像入力はsync-3専用です。 | COMBO | はい | `"sync-3"` | +| `speaker_selection` | 複数の人物が写っている場合に、どの顔をアニメーション化するかを指定します。`default`:モデルに決定させます。`coordinates`:画像内のピクセル座標(speaker_x, speaker_y)の顔を対象とします。画像に対する自動検出はサポートされていません。(デフォルト:"default") | COMBO | いいえ | `"default"`
`"coordinates"` | +| `speaker_x` | 話者の顔のXピクセル座標。speaker_selectionが'coordinates'の場合にのみ使用されます。(デフォルト:0) | INT | いいえ | 0 ~ 4096 | +| `speaker_y` | 話者の顔のYピクセル座標。speaker_selectionが'coordinates'の場合にのみ使用されます。(デフォルト:0) | INT | いいえ | 0 ~ 4096 | +| `auto_downscale` | 画像が4K(4096x2160)の入力制限を超える場合、自動的にダウンスケールします。話者の座標もそれに合わせて拡大縮小されます。無効にすると、サイズ超過の画像はエラーになります。(デフォルト:True) | BOOLEAN | いいえ | True
False | + +**注記:** `speaker_x` および `speaker_y` パラメータは、`speaker_selection` が `"coordinates"` に設定されている場合にのみ使用されます。`auto_downscale` が有効な場合、話者の座標はダウンスケール後の画像サイズに合わせて自動的に拡大縮小されます。 + +## 出力 + +| 出力名 | 説明 | データ型 | +|-------------|-------------|-----------| +| `video` | 入力音声に同期してアニメーション化されたポートレートを含む、生成されたトーキングビデオ。 | VIDEO | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SyncTalkingImageNode/ja.md) + +--- +**Source fingerprint (SHA-256):** `21f722cdcc5ff017949887ed2252854feebb9b913034dc6a6c3ce196ad089468` diff --git a/ja/built-in-nodes/TextEncodeJoyImageEdit.mdx b/ja/built-in-nodes/TextEncodeJoyImageEdit.mdx new file mode 100644 index 000000000..a30bf638e --- /dev/null +++ b/ja/built-in-nodes/TextEncodeJoyImageEdit.mdx @@ -0,0 +1,29 @@ +--- +title: "TextEncodeJoyImageEdit - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the TextEncodeJoyImageEdit node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "TextEncodeJoyImageEdit" +icon: "circle" +mode: wide +--- + +このノードは、テキストプロンプトとオプションの画像を、JoyImageモデルで使用するための条件付けデータにエンコードします。CLIPテキストエンコーダーとオプションの画像入力を組み合わせることで、画像生成や編集タスクをガイドできる豊富な条件付けを作成します。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `clip` | テキストプロンプトのエンコードに使用するCLIPモデル | CLIP | はい | - | +| `prompt` | エンコードするテキストプロンプト。複数行入力と動的プロンプトに対応 | STRING | はい | - | +| `vae` | 画像を潜在空間にエンコードするためのVAEモデル(オプション) | VAE | いいえ | - | +| `images` | 条件付けに含める1つ以上の画像。最大6枚まで | IMAGE | いいえ | 0~6枚 | + +## 出力 + +| 出力名 | 説明 | データ型 | +|-------------|-------------|-----------| +| `CONDITIONING` | テキストプロンプトと提供された画像を組み合わせたエンコード済み条件付けデータ | CONDITIONING | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TextEncodeJoyImageEdit/ja.md) + +--- +**Source fingerprint (SHA-256):** `ef48523aa9fc990b2839d755cef272bcdfbacef5af8d961736fde5200c6f082d` diff --git a/ja/built-in-nodes/TextOverlay.mdx b/ja/built-in-nodes/TextOverlay.mdx new file mode 100644 index 000000000..fd306a91d --- /dev/null +++ b/ja/built-in-nodes/TextOverlay.mdx @@ -0,0 +1,32 @@ +--- +title: "TextOverlay - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the TextOverlay node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "TextOverlay" +icon: "circle" +mode: wide +--- + +このノードは、画像または画像バッチの上にテキストを描画します。カスタムテキスト、フォントサイズ、色、位置、配置、およびオプションの輪郭線をサポートし、元の画像の上にテキストを合成します。 + +## 入力 + +| パラメータ | 説明 | データ型 | 必須 | 範囲 | +|-----------|-------------|-----------|----------|-------| +| `画像` | テキストを描画する入力画像または画像バッチ。 | IMAGE | はい | | +| `テキスト` | 重ねて表示するテキスト文字列。改行(`\n`)とタブ(`\t`)文字をサポートします。デフォルト:"" | STRING | はい | | +| `フォントサイズ` | 画像の高さに対するパーセンテージで指定するフォントサイズ。デフォルト:5.0 | FLOAT | はい | 0.5~50.0 | +| `色` | テキストの色。デフォルト:"#ffffff"(白) | STRING | はい | | +| `位置` | 画像上でのテキストの垂直位置。デフォルト:"top" | COMBO | はい | "top"
"bottom" | +| `整列` | テキストの水平配置。デフォルト:"left" | COMBO | はい | "left"
"center"
"right" | +| `アウトライン` | テキストの周りに黒い輪郭線を描画します。デフォルト:True | BOOLEAN | はい | | + +## 出力 + +| 出力名 | 説明 | データ型 | +|-------------|-------------|-----------| +| `画像` | テキストオーバーレイが上部に合成された画像または画像バッチ。 | IMAGE | + +> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TextOverlay/ja.md) + +--- +**Source fingerprint (SHA-256):** `baffaa4ec9d3565e3533673658399271234def8c49e2e4a5f16767ec3f98cb22` diff --git a/ko/built-in-nodes/AnimaLLLiteApply.mdx b/ko/built-in-nodes/AnimaLLLiteApply.mdx new file mode 100644 index 000000000..043179039 --- /dev/null +++ b/ko/built-in-nodes/AnimaLLLiteApply.mdx @@ -0,0 +1,34 @@ +--- +title: "AnimaLLLiteApply - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the AnimaLLLiteApply node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "AnimaLLLiteApply" +icon: "circle" +mode: wide +--- + +이 노드는 확산 모델에 경량 애니메이션 패치를 적용하여, 조정 가능한 강도와 타이밍으로 제어된 이미지 간 생성을 가능하게 합니다. 사전 구성된 모델 패치를 입력 이미지 및 선택적 마스크와 통합하여, 모델의 어텐션 및 MLP 레이어를 수정함으로써 생성 과정에 영향을 줍니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `model` | 패치를 적용할 기본 확산 모델 | MODEL | 예 | | +| `model_patch` | 적용할 사전 구성된 애니메이션 패치 | MODEL_PATCH | 예 | | +| `image` | 생성을 안내할 참조 이미지 | IMAGE | 예 | | +| `strength` | 패치 효과의 강도 (기본값: 1.0) | FLOAT | 예 | -10.0 ~ 10.0 | +| `start_percent` | 패치가 적용되기 시작하는 노이즈 제거 과정의 백분율 (기본값: 0.0) | FLOAT | 예 | 0.0 ~ 1.0 | +| `end_percent` | 패치 적용이 중단되는 노이즈 제거 과정의 백분율 (기본값: 1.0) | FLOAT | 예 | 0.0 ~ 1.0 | +| `mask` | 패치 효과를 이미지의 특정 영역으로 제한하는 선택적 마스크 | MASK | 아니요 | | + +**매개변수 제약 조건 참고:** `model_patch`에 4개의 입력 채널이 있고 `mask`가 제공되지 않은 경우, 이미지 크기에 맞춰 0 마스크가 자동으로 생성됩니다. `model_patch`에 4개의 입력 채널이 없는 경우, `mask` 매개변수는 무시되고 `None`으로 설정됩니다. + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `MODEL` | 애니메이션 패치가 적용된 패치된 확산 모델 | MODEL | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/AnimaLLLiteApply/ko.md) + +--- +**Source fingerprint (SHA-256):** `291dc6a6619faab1c1100110c71c47381addcd80dbaf933dd8025a376bc2bee7` diff --git a/ko/built-in-nodes/HeyGenAvatarVideoNode.mdx b/ko/built-in-nodes/HeyGenAvatarVideoNode.mdx new file mode 100644 index 000000000..bda439086 --- /dev/null +++ b/ko/built-in-nodes/HeyGenAvatarVideoNode.mdx @@ -0,0 +1,47 @@ +--- +title: "HeyGenAvatarVideoNode - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the HeyGenAvatarVideoNode node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "HeyGenAvatarVideoNode" +icon: "circle" +mode: wide +--- + +HeyGen 아바타로 말하는 프레젠터 동영상을 생성합니다. 이 노드는 HeyGen의 렌더링 엔진을 사용하여 제공된 텍스트를 말하는 AI 아바타 동영상이나 사용자 오디오에 립싱크하는 동영상을 만듭니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|---------|------|-----------|------|------| +| `engine` | 렌더링 엔진입니다. 각 선택지는 이를 지원하는 아바타만 표시합니다. 'auto'는 모든 아바타를 제공하고 가장 적합한 엔진을 선택합니다(Avatar IV 선호). Avatar V는 가장 높은 충실도를 제공하며, Avatar III는 가장 경제적입니다. | COMBO | 예 | `"auto"`
`"avatar_iv"`
`"avatar_iii"`
`"avatar_v"` | +| `custom_avatar_id` | 선택적 HeyGen 아바타 룩 ID입니다. 설정 시 위에서 선택한 아바타를 재정의합니다. HeyGen의 3000개 이상 공개 룩(또는 개인 아바타)을 사용할 수 있습니다. | STRING | 아니요 | | +| `speech` | 텍스트 스크립트(HeyGen 텍스트 음성 변환) 또는 사용자 오디오로 아바타를 구동합니다. | COMBO | 예 | `"script"`
`"audio"` | +| `resolution` | 출력 동영상 해상도입니다(기본값: "1080p"). | COMBO | 아니요 | `"720p"`
`"1080p"` | +| `aspect_ratio` | 출력 화면 비율입니다. 'auto'는 아바타의 원본 영상을 따릅니다(기본값: "auto"). | COMBO | 아니요 | `"auto"`
`"16:9"`
`"9:16"`
`"1:1"`
`"4:5"`
`"5:4"` | +| `background_color` | 선택적 단색 배경색으로 16진수 코드입니다(예: '#00ff00'). 아바타 자체 배경을 사용하려면 비워 둡니다. | STRING | 아니요 | | +| `seed` | HeyGen으로 전송되지 않습니다. 변경하여 재실행을 강제합니다(기본값: 42). | INT | 아니요 | 최소: 0
최대: 2147483647 | + +`speech`가 `"script"`로 설정된 경우 다음 하위 매개변수를 사용할 수 있습니다: + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|---------|------|-----------|------|------| +| `text` | 아바타가 말할 텍스트입니다(최대 5000자). 생성된 음성은 최소 1초 이상이어야 합니다. | STRING | 예 | | +| `voice` | 스크립트의 음성입니다. 기본 옵션은 HeyGen이 아바타에 할당한 음성을 사용합니다. | COMBO | 예 | 여러 옵션 사용 가능 | +| `custom_voice_id` | 선택적 HeyGen 음성 ID입니다. 설정 시 위에서 선택한 음성을 재정의합니다. HeyGen 라이브러리(2000개 이상)의 모든 음성을 사용할 수 있습니다. | STRING | 아니요 | | +| `voice_speed` | 음성 속도 배수입니다(기본값: 1.0). | FLOAT | 아니요 | 최소: 0.5
최대: 1.5
단계: 0.05 | + +`speech`가 `"audio"`로 설정된 경우 다음 하위 매개변수를 사용할 수 있습니다: + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|---------|------|-----------|------|------| +| `audio` | 아바타가 립싱크할 오디오입니다(최대 10분). | AUDIO | 예 | | + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|----------|------|-----------| +| `VIDEO` | 생성된 아바타 프레젠터 동영상입니다. | VIDEO | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HeyGenAvatarVideoNode/ko.md) + +--- +**Source fingerprint (SHA-256):** `009bc72b841ca273af83fe6f80fb24d4b11c2efd96c011795b1ff1cf8e66ee61` diff --git a/ko/built-in-nodes/HeyGenCreateAvatarNode.mdx b/ko/built-in-nodes/HeyGenCreateAvatarNode.mdx new file mode 100644 index 000000000..8eaccb82c --- /dev/null +++ b/ko/built-in-nodes/HeyGenCreateAvatarNode.mdx @@ -0,0 +1,42 @@ +--- +title: "HeyGenCreateAvatarNode - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the HeyGenCreateAvatarNode node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "HeyGenCreateAvatarNode" +icon: "circle" +mode: wide +--- + +사람의 사진이나 캐릭터를 설명하는 텍스트 프롬프트로부터 재사용 가능한 HeyGen 아바타를 생성합니다. 생성된 아바타 ID는 HeyGen 아바타 비디오 노드와 함께 사용하여 이 아바타가 등장하는 비디오를 제작할 수 있습니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 여부 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `source` | 텍스트 프롬프트로 새 캐릭터를 생성하거나, 연결된 사람 사진으로 아바타를 만듭니다. | COMBO | 예 | `"prompt"`
`"photo"` | + +`source`가 `"prompt"`로 설정된 경우, 다음 추가 매개변수를 사용할 수 있습니다: + +| 매개변수 | 설명 | 데이터 타입 | 필수 여부 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `prompt` | 생성할 아바타에 대한 설명입니다 (최대 1000자). | STRING | 예 | 1~1000자 | +| `reference_images` | 생성될 외형을 안내하는 최대 3개의 참조 이미지입니다. | IMAGE | 아니요 | 0~3개 이미지 | + +`source`가 `"photo"`로 설정된 경우, 다음 추가 매개변수를 사용할 수 있습니다: + +| 매개변수 | 설명 | 데이터 타입 | 필수 여부 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `identity_photo` | 아바타로 변환할 사람의 사진입니다. 2K보다 클 경우 자동으로 축소됩니다. | IMAGE | 예 | 단일 이미지 | + +**참고:** `source` 매개변수는 두 가지 모드 사이를 전환합니다. `"prompt"` 모드에서는 텍스트 설명과 선택적으로 최대 3개의 참조 이미지를 제공합니다. `"photo"` 모드에서는 사람의 단일 사진을 제공합니다. 이 두 모드는 상호 배타적입니다. + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `avatar_id` | 아바타 외형 ID입니다. HeyGen 아바타 비디오의 `custom_avatar_id`에 전달하거나 저장하여 나중에 아바타를 재사용하세요. | STRING | +| `preview` | 생성된 아바타의 미리보기 이미지입니다. | IMAGE | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HeyGenCreateAvatarNode/ko.md) + +--- +**Source fingerprint (SHA-256):** `c60e9cdb0d91fb5ec6ea83b503b9aa10c978ce065a16c751a52e90c12e70a5e2` diff --git a/ko/built-in-nodes/HeyGenTalkingPhotoNode.mdx b/ko/built-in-nodes/HeyGenTalkingPhotoNode.mdx new file mode 100644 index 000000000..fc14052fc --- /dev/null +++ b/ko/built-in-nodes/HeyGenTalkingPhotoNode.mdx @@ -0,0 +1,36 @@ +--- +title: "HeyGenTalkingPhotoNode - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the HeyGenTalkingPhotoNode node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "HeyGenTalkingPhotoNode" +icon: "circle" +mode: wide +--- + +정지된 인물 사진을 HeyGen의 Avatar IV 기술을 사용하여 립싱크가 적용된 말하는 동영상으로 애니메이션화합니다. HeyGen이 음성으로 변환하는 텍스트 스크립트로 애니메이션을 구동하거나, 아바타가 립싱크할 자체 오디오를 제공할 수 있습니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 여부 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `image` | 애니메이션화할 인물의 이미지입니다. 2K보다 큰 경우 자동으로 축소됩니다. | IMAGE | 예 | - | +| `speech` | 텍스트 스크립트(HeyGen 텍스트 음성 변환) 또는 자체 오디오로 아바타를 구동합니다. | COMBO | 예 | `"script"`
`"audio"` | +| `text` | 아바타가 말할 텍스트입니다(최대 5000자). 생성된 음성은 최소 1초 이상이어야 합니다. | STRING | 예(speech가 "script"인 경우) | - | +| `voice` | 스크립트에 사용할 음성입니다(HeyGen의 가장 인기 있는 음성). | COMBO | 예(speech가 "script"인 경우) | 여러 옵션 사용 가능 | +| `custom_voice_id` | 선택적 HeyGen 음성 ID입니다. 설정 시 위에서 선택한 음성을 재정의합니다. HeyGen 라이브러리(2000개 이상)의 모든 음성을 사용할 수 있습니다. | STRING | 아니요 | - | +| `voice_speed` | 음성 속도 배율입니다(기본값: 1.0). | FLOAT | 아니요 | 0.5 ~ 1.5 | +| `audio` | 아바타가 립싱크할 오디오로, 최대 10분까지 가능합니다. | AUDIO | 예(speech가 "audio"인 경우) | - | +| `resolution` | 출력 동영상 해상도입니다(기본값: "1080p"). | COMBO | 아니요 | `"720p"`
`"1080p"` | +| `aspect_ratio` | 출력 화면 비율입니다. 'auto'는 입력 이미지를 따릅니다(기본값: "auto"). | COMBO | 아니요 | `"auto"`
`"16:9"`
`"9:16"`
`"1:1"`
`"4:5"`
`"5:4"` | +| `expressiveness` | 애니메이션 얼굴과 제스처의 표현력 정도입니다(기본값: "low"). | COMBO | 아니요 | `"low"`
`"medium"`
`"high"` | +| `seed` | HeyGen으로 전송되지 않습니다. 값을 변경하여 재실행을 강제합니다(기본값: 42). | INT | 아니요 | 0 ~ 2147483647 | + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `video` | 립싱크된 음성이 포함된 애니메이션 말하는 사진의 생성된 동영상입니다. | VIDEO | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HeyGenTalkingPhotoNode/ko.md) + +--- +**Source fingerprint (SHA-256):** `2181066a8c6191cfcaa15ece4f89a16c37e76aa22763d6df4007baa20336f05a` diff --git a/ko/built-in-nodes/HeyGenTextToSpeechNode.mdx b/ko/built-in-nodes/HeyGenTextToSpeechNode.mdx new file mode 100644 index 000000000..80998136f --- /dev/null +++ b/ko/built-in-nodes/HeyGenTextToSpeechNode.mdx @@ -0,0 +1,31 @@ +--- +title: "HeyGenTextToSpeechNode - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the HeyGenTextToSpeechNode node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "HeyGenTextToSpeechNode" +icon: "circle" +mode: wide +--- + +HeyGen의 Starfish TTS 엔진을 사용하여 텍스트에서 음성 오디오를 생성합니다. 이 노드는 17개 언어에 걸쳐 HeyGen의 가장 인기 있는 음성을 포함합니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 여부 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `text` | 합성할 텍스트(최대 5000자). 생성된 음성은 최소 1초 길이여야 합니다. | STRING | 예 | 1 ~ 5000자 | +| `voice` | 사용할 음성(HeyGen의 가장 인기 있는 Starfish 호환 음성에서 선별). | STRING | 예 | 여러 옵션 사용 가능 | +| `custom_voice_id` | 선택적 HeyGen 음성 ID. 설정 시 위에서 선택한 음성을 재정의합니다. 해당 음성은 Starfish 엔진을 지원해야 합니다. | STRING | 아니요 | 유효한 모든 HeyGen 음성 ID | +| `speed` | 음성 속도 배율(기본값: 1.0). | FLOAT | 아니요 | 0.5 ~ 2.0 (단계: 0.05) | +| `ssml` | 텍스트를 SSML 마크업으로 처리합니다(일시 정지, 강조 및 발음 제어용)(기본값: False). | BOOLEAN | 아니요 | True / False | +| `seed` | HeyGen으로 전송되지 않습니다. 변경하여 재실행을 강제합니다(기본값: 42). | INT | 아니요 | 0 ~ 2147483647 | + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `AUDIO` | 입력 텍스트에서 생성된 합성 음성 오디오입니다. | AUDIO | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HeyGenTextToSpeechNode/ko.md) + +--- +**Source fingerprint (SHA-256):** `82300626657db8ab16e96ae96b7dfe3291b77bf75efec35971dc772e5123cce7` diff --git a/ko/built-in-nodes/HeyGenVideoTranslateNode.mdx b/ko/built-in-nodes/HeyGenVideoTranslateNode.mdx new file mode 100644 index 000000000..1620c65cd --- /dev/null +++ b/ko/built-in-nodes/HeyGenVideoTranslateNode.mdx @@ -0,0 +1,33 @@ +--- +title: "HeyGenVideoTranslateNode - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the HeyGenVideoTranslateNode node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "HeyGenVideoTranslateNode" +icon: "circle" +mode: wide +--- + +## 개요 + +음성이 포함된 동영상을 음성 복제 및 립싱크와 함께 다른 언어로 번역합니다. 이 노드는 원래 화자의 음성을 복제하고 번역된 음성에 맞게 입 모양을 다시 애니메이션하여 자연스러운 결과를 생성합니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 여부 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `video` | 번역할 음성이 포함된 동영상입니다. | VIDEO | 예 | - | +| `output_language` | 번역된 동영상의 대상 언어입니다. | STRING | 예 | "Arabic"
"Bengali"
"Chinese"
"Danish"
"Dutch"
"English"
"French"
"German"
"Greek"
"Hindi"
"Indonesian"
"Italian"
"Japanese"
"Korean"
"Malay"
"Polish"
"Portuguese"
"Russian"
"Spanish"
"Swedish"
"Tamil"
"Telugu"
"Thai"
"Turkish"
"Ukrainian"
"Vietnamese" | +| `mode` | 'speed'는 더 빠르며, 'precision'은 두 배의 비용으로 더 높은 품질의 립싱크를 생성합니다. | STRING | 예 | "speed"
"precision" | +| `translate_audio_only` | 오디오 트랙만 교체하고 원래 입 모양을 유지합니다(립싱크 없음). (기본값: False) | BOOLEAN | 아니요 | True
False | +| `speaker_count` | 동영상에 있는 화자 수입니다. 0 = 자동 감지. (기본값: 0) | INT | 아니요 | 0 ~ 10 | +| `seed` | HeyGen으로 전송되지 않습니다. 변경하면 재실행됩니다. (기본값: 42) | INT | 아니요 | 0 ~ 2147483647 | + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `video` | 음성 복제 및 립싱크가 적용된 번역된 동영상입니다. | VIDEO | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HeyGenVideoTranslateNode/ko.md) + +--- +**Source fingerprint (SHA-256):** `31056060b6309b8ec28b37b353322403e173fd2862b56021392dba24e7a15f69` diff --git a/ko/built-in-nodes/Save3DAdvanced.mdx b/ko/built-in-nodes/Save3DAdvanced.mdx new file mode 100644 index 000000000..78bdeb1ac --- /dev/null +++ b/ko/built-in-nodes/Save3DAdvanced.mdx @@ -0,0 +1,36 @@ +--- +title: "Save3DAdvanced - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the Save3DAdvanced node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "Save3DAdvanced" +icon: "circle" +mode: wide +--- + +이 노드는 3D 모델을 ComfyUI 출력 디렉토리에 저장하고 고급 미리보기 기능을 제공합니다. 출력 파일 이름, 미리보기 크기를 지정하고, 선택적으로 카메라 및 모델 정보를 전달하여 향상된 3D 뷰어 환경을 구성할 수 있습니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `model_3d` | 상위 3D 노드에서 전달된 3D 모델 파일입니다. | FILE3D | 예 | GLB, GLTF, FBX, OBJ, STL, USDZ 또는 모든 3D 형식 | +| `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` | 저장된 3D 모델 파일입니다. | FILE3D | +| `model_3d_info` | 하위 노드로 전달되는 3D 모델 정보입니다. | 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` diff --git a/ko/built-in-nodes/SaveGaussianSplat.mdx b/ko/built-in-nodes/SaveGaussianSplat.mdx new file mode 100644 index 000000000..448728d0d --- /dev/null +++ b/ko/built-in-nodes/SaveGaussianSplat.mdx @@ -0,0 +1,36 @@ +--- +title: "SaveGaussianSplat - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the SaveGaussianSplat node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "SaveGaussianSplat" +icon: "circle" +mode: wide +--- + +이 노드는 가우시안 스플랫 3D 파일을 ComfyUI 출력 디렉토리에 저장하고 3D 뷰어용 미리보기 데이터를 제공합니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `model_3d` | 가우시안 스플랫 3D 파일입니다. | FILE3D | 예 | - | +| `filename_prefix` | 저장된 파일 이름의 접두사입니다 (기본값: "3d/ComfyUI") | STRING | 예 | - | +| `viewport_state` | 3D 로더 노드의 현재 뷰포트 상태입니다. | LOAD3D | 예 | - | +| `model_3d_info` | 미리보기를 위한 추가 3D 모델 정보입니다. | LOAD3DMODELINFO | 아니요 | - | +| `camera_info` | 미리보기를 위한 카메라 정보입니다. | LOAD3DCAMERA | 아니요 | - | +| `width` | 미리보기의 픽셀 너비입니다 (기본값: 1024) | INT | 예 | 최소: 1, 최대: 4096, 단계: 1 | +| `height` | 미리보기의 픽셀 높이입니다 (기본값: 1024) | INT | 예 | 최소: 1, 최대: 4096, 단계: 1 | + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `model_3d` | 저장된 가우시안 스플랫 3D 파일입니다. | FILE3D | +| `model_3d_info` | 미리보기를 위한 3D 모델 정보입니다. | LOAD3DMODELINFO | +| `camera_info` | 미리보기를 위한 카메라 정보입니다. | LOAD3DCAMERA | +| `width` | 미리보기의 너비입니다. | INT | +| `height` | 미리보기의 높이입니다. | INT | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SaveGaussianSplat/ko.md) + +--- +**Source fingerprint (SHA-256):** `f2d6b98d2ce1fe11df8ba440b7f46a21e2308966c15daa5ca0bdca7dab1726cc` diff --git a/ko/built-in-nodes/SavePointCloud.mdx b/ko/built-in-nodes/SavePointCloud.mdx new file mode 100644 index 000000000..c8d97e84c --- /dev/null +++ b/ko/built-in-nodes/SavePointCloud.mdx @@ -0,0 +1,36 @@ +--- +title: "SavePointCloud - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the SavePointCloud node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "SavePointCloud" +icon: "circle" +mode: wide +--- + +Save Point Cloud 노드는 3D 포인트 클라우드 파일을 ComfyUI 출력 디렉토리에 저장합니다. 또한 포인트 클라우드 데이터와 선택적 카메라 및 모델 정보를 워크플로우의 다른 노드에서 사용할 수 있도록 전달합니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 여부 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `model_3d` | 포인트 클라우드 파일(.ply) | FILE3D | 예 | - | +| `filename_prefix` | 저장될 파일 이름의 접두사(기본값: "3d/ComfyUI") | STRING | 예 | - | +| `viewport_state` | 3D 뷰포트 노드의 상태 | LOAD3D | 예 | - | +| `model_3d_info` | 고급 사용을 위한 선택적 3D 모델 정보 | LOAD3DMODELINFO | 아니요 | - | +| `camera_info` | 고급 사용을 위한 선택적 카메라 정보 | LOAD3DCAMERA | 아니요 | - | +| `width` | 미리보기 이미지의 너비(픽셀 단위, 기본값: 1024) | INT | 예 | 최소: 1, 최대: 4096, 단계: 1 | +| `height` | 미리보기 이미지의 높이(픽셀 단위, 기본값: 1024) | INT | 예 | 최소: 1, 최대: 4096, 단계: 1 | + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `model_3d` | 저장된 포인트 클라우드 파일 | FILE3D | +| `model_3d_info` | 3D 모델에 대한 정보 | LOAD3DMODELINFO | +| `camera_info` | 뷰포트용 카메라 정보 | LOAD3DCAMERA | +| `width` | 미리보기 이미지의 너비 | INT | +| `height` | 미리보기 이미지의 높이 | INT | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SavePointCloud/ko.md) + +--- +**Source fingerprint (SHA-256):** `ce8f005c431843a57d87a4aff2eed7a1604ebdf360f83b3aaaadc3ed364d218a` diff --git a/ko/built-in-nodes/SaveText.mdx b/ko/built-in-nodes/SaveText.mdx new file mode 100644 index 000000000..7d3554967 --- /dev/null +++ b/ko/built-in-nodes/SaveText.mdx @@ -0,0 +1,28 @@ +--- +title: "SaveText - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the SaveText node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "SaveText" +icon: "circle" +mode: wide +--- + +텍스트 저장 노드는 텍스트 콘텐츠를 출력 디렉터리의 파일에 기록합니다. 일반 텍스트(.txt), 마크다운(.md), JSON(.json)의 세 가지 파일 형식으로 저장을 지원합니다. JSON으로 저장할 경우, 노드는 입력 텍스트를 유효한 JSON으로 구문 분석하고 적절한 들여쓰기로 서식을 지정합니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 여부 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `text` | 파일에 저장할 텍스트 콘텐츠 | STRING | 예 | | +| `filename_prefix` | 출력 파일 이름의 접두사(기본값: "ComfyUI") | STRING | 아니요 | | +| `format` | 텍스트를 저장할 파일 형식(기본값: "txt") | STRING | 아니요 | `"txt"`
`"md"`
`"json"` | + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `text` | 파일에 저장된 원본 텍스트 콘텐츠 | STRING | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SaveText/ko.md) + +--- +**Source fingerprint (SHA-256):** `5644d143f415773115b38d7af6d9afea20c9eadef2cea836b0384c15e0dcba6a` diff --git a/ko/built-in-nodes/SeedVR2TemporalChunk.mdx b/ko/built-in-nodes/SeedVR2TemporalChunk.mdx new file mode 100644 index 000000000..4f1cf9842 --- /dev/null +++ b/ko/built-in-nodes/SeedVR2TemporalChunk.mdx @@ -0,0 +1,41 @@ +--- +title: "SeedVR2TemporalChunk - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the SeedVR2TemporalChunk node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "SeedVR2TemporalChunk" +icon: "circle" +mode: wide +--- + +이 노드는 SeedVR2 비디오 잠재 변수를 더 작은 시간적 청크로 분할하여, 사용 가능한 VRAM 내에서 한 번에 하나씩 처리할 수 있도록 합니다. 청크는 Apply SeedVR2 Conditioning 노드와 샘플러 잠재 입력에 모두 전달된 후, Merge SeedVR2 Latents 노드를 사용하여 다시 결합되도록 설계되었습니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `latent` | 분할할 VAE 인코딩된 SeedVR2 잠재 변수 | LATENT | 예 | - | +| `temporal_overlap` | 인접 청크 간에 공유되고 병합 시 크로스페이드되는 잠재 프레임 수입니다. 0은 중첩이 없음을 의미합니다(기본값: 0) | INT | 아니요 | 0 ~ 16384 | +| `chunking_mode` | manual = 정확히 frames_per_chunk를 사용합니다. auto = 사용 가능한 여유 VRAM에 맞는 가장 큰 청크를 예측합니다 | COMBO | 예 | "auto"
"manual" | + +`chunking_mode`가 "manual"로 설정된 경우 다음 매개변수를 사용할 수 있습니다: + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `frames_per_chunk` | 시간적 청크당 픽셀 프레임 수입니다(4n+1이어야 함: 1, 5, 9, 13, ...)(기본값: 21) | INT | 예 | 1 ~ 16384, 4단계 | + +**매개변수 제약 조건 참고 사항:** +- 입력 `latent`는 (B, C, T, H, W) 형태의 5차원 비디오 잠재 변수여야 하며 정확히 4개의 잠재 채널을 가져야 합니다. +- "manual" 모드를 사용하는 경우 `frames_per_chunk`는 4n+1 값(1, 5, 9, 13, 17, 21, ...)이어야 합니다. +- `temporal_overlap`은 자동으로 청크 크기보다 작게 제한됩니다. +- "auto" 모드에서 노드는 사용 가능한 여유 VRAM을 기반으로 최적의 청크 크기를 계산합니다. + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `latents` | 순서대로 정렬된 시간적 청크 | LATENT | +| `temporal_overlap` | Merge SeedVR2 Latents를 위한 인접 청크 간의 유효한 잠재 프레임 중첩 | INT | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SeedVR2TemporalChunk/ko.md) + +--- +**Source fingerprint (SHA-256):** `40af2b690f74555efbe38f4cf76825417f52735ce90296a9ad662f78cfe4c6bf` diff --git a/ko/built-in-nodes/SeedVR2TemporalMerge.mdx b/ko/built-in-nodes/SeedVR2TemporalMerge.mdx new file mode 100644 index 000000000..347ef48c7 --- /dev/null +++ b/ko/built-in-nodes/SeedVR2TemporalMerge.mdx @@ -0,0 +1,29 @@ +--- +title: "SeedVR2TemporalMerge - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the SeedVR2TemporalMerge node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "SeedVR2TemporalMerge" +icon: "circle" +mode: wide +--- + +이 노드는 Split SeedVR2 Latent 노드에서 이전에 분할된 잠재 비디오 데이터의 시간적 청크를 재결합합니다. 중첩 영역에 대해 Hann 윈도우 크로스페이드를 적용하여 청크 간 부드러운 전환을 생성하거나, 중첩이 지정되지 않은 경우 단순 연결을 수행합니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `latents` | 순서대로 정렬된 샘플링된 시간적 청크입니다. | LATENT | 예 | 잠재 목록 | +| `temporal_overlap` | Split SeedVR2 Latent의 temporal_overlap 출력입니다. 0 = 단순 연결입니다. | INT | 예 | 0 ~ 16384 (기본값: 0) | + +**참고:** `temporal_overlap` 매개변수는 Split SeedVR2 Latent 노드의 `temporal_overlap` 출력에서 연결되어야 합니다. 모든 입력 잠재는 동일한 배치 크기, 채널 수, 높이 및 너비를 가져야 합니다. 마지막 청크만 다른 청크보다 시간적 차원이 짧을 수 있습니다. + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `latent` | 재결합된 전체 길이의 잠재입니다. | LATENT | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SeedVR2TemporalMerge/ko.md) + +--- +**Source fingerprint (SHA-256):** `647653fc651462f62bcc9dca2919cfcaa4b476b4c679b0a1111698facab83f28` diff --git a/ko/built-in-nodes/SyncLipSyncNode.mdx b/ko/built-in-nodes/SyncLipSyncNode.mdx new file mode 100644 index 000000000..83f8f99ea --- /dev/null +++ b/ko/built-in-nodes/SyncLipSyncNode.mdx @@ -0,0 +1,56 @@ +--- +title: "SyncLipSyncNode - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the SyncLipSyncNode node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "SyncLipSyncNode" +icon: "circle" +mode: wide +--- + +이 노드는 sync.so API를 사용하여 비디오의 입 움직임을 새로운 음성 오디오에 다시 동기화합니다. 클로즈업, 측면 및 장애물을 자동으로 처리하면서 화자의 표정을 유지합니다. 비용은 출력 길이에 따라 달라집니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 유형 | 필수 여부 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `video` | 다시 동기화할 화자의 영상입니다. 최대 4K(4096x2160)까지 지원되며, 24/25/30fps의 일정한 프레임 속도가 가장 잘 작동합니다. | VIDEO | 예 | - | +| `audio` | 입에 동기화할 음성 오디오입니다. | AUDIO | 예 | - | +| `seed` | 시드는 노드를 다시 실행할지 여부를 제어합니다. 시드와 관계없이 결과는 비결정적입니다(기본값: 42). | INT | 예 | 0 ~ 2147483647 | +| `model` | sync.so 생성 모델입니다. | COMBO | 예 | 아래 참조 | + +`model` 매개변수는 다음과 같은 하위 매개변수를 포함하는 동적 콤보입니다: + +| 하위 매개변수 | 설명 | 데이터 유형 | 필수 여부 | 범위 | +|---------------|-------------|-----------|----------|-------| +| `sync_mode` | 비디오와 오디오 간 길이 불일치를 처리하는 방법입니다. 또한 출력 길이를 설정합니다(기본값: "bounce"). | COMBO | 예 | `"bounce"`
`"cut_off"`
`"loop"`
`"silence"`
`"remap"` | +| `speaker_selection` | 여러 사람이 보일 때 립싱크할 얼굴을 선택합니다(기본값: "default"). | COMBO | 예 | `"default"`
`"auto-detect"`
`"coordinates"` | +| `speaker_frame` | 화자를 찾는 데 사용되는 비디오 프레임입니다. `speaker_selection`이 "coordinates"인 경우에만 사용됩니다(기본값: 0). | INT | 아니요 | 0 ~ 1000000 | +| `speaker_x` | 화자 얼굴의 X 픽셀 좌표입니다. `speaker_selection`이 "coordinates"인 경우에만 사용됩니다(기본값: 0). | INT | 아니요 | 0 ~ 4096 | +| `speaker_y` | 화자 얼굴의 Y 픽셀 좌표입니다. `speaker_selection`이 "coordinates"인 경우에만 사용됩니다(기본값: 0). | INT | 아니요 | 0 ~ 4096 | + +**동기화 모드 옵션:** +- `bounce`: 비디오가 오디오가 끝날 때까지 앞뒤로 재생됩니다(출력 = 오디오 길이) +- `loop`: 비디오가 오디오가 끝날 때까지 다시 시작됩니다(출력 = 오디오 길이) +- `remap`: 비디오가 오디오와 일치하도록 시간이 늘어납니다(출력 = 오디오 길이) +- `cut_off`: 더 긴 트랙이 잘립니다(출력 = 더 짧은 길이) +- `silence`: 아무것도 잘리지 않으며, 더 짧은 트랙이 채워집니다(출력 = 더 긴 길이) + +**화자 선택 옵션:** +- `default`: 모델이 립싱크할 얼굴을 결정하도록 합니다 +- `auto-detect`: 활성 화자를 감지하고 추적합니다 +- `coordinates`: `speaker_frame`에서 선택한 프레임의 픽셀(`speaker_x`, `speaker_y`)에 있는 얼굴을 대상으로 합니다 + +**제약 사항:** +- 비디오 해상도는 4K(4096x2160)를 초과할 수 없습니다. 이 제한을 초과하는 비디오는 오류가 발생합니다. +- 오디오 길이는 600초(10분)를 초과할 수 없습니다. +- `speaker_frame`, `speaker_x`, `speaker_y` 매개변수는 `speaker_selection`이 "coordinates"로 설정된 경우에만 사용됩니다. + +## 출력 + +| 출력 이름 | 설명 | 데이터 유형 | +|-------------|-------------|-----------| +| `video` | 제공된 오디오와 일치하도록 입 움직임이 다시 동기화된 비디오입니다. | VIDEO | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SyncLipSyncNode/ko.md) + +--- +**Source fingerprint (SHA-256):** `b41f8c9bf0d55059f081a66af20636ec96462c3fd9caeb685cab10278f84678a` diff --git a/ko/built-in-nodes/SyncTalkingImageNode.mdx b/ko/built-in-nodes/SyncTalkingImageNode.mdx new file mode 100644 index 000000000..9a6353b52 --- /dev/null +++ b/ko/built-in-nodes/SyncTalkingImageNode.mdx @@ -0,0 +1,36 @@ +--- +title: "SyncTalkingImageNode - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the SyncTalkingImageNode node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "SyncTalkingImageNode" +icon: "circle" +mode: wide +--- + +정지된 초상화를 음성 오디오로 구동되는 말하는 비디오로 애니메이션화합니다. sync.so의 sync-3 모델을 사용합니다. 출력 길이는 오디오 길이와 일치하며, 비용은 출력 길이에 비례합니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 여부 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `image` | 얼굴이 선명하게 보이는 단일 이미지로, 최대 4K(4096x2160)까지 지원합니다. | IMAGE | 예 | 정확히 하나의 이미지 필요 | +| `audio` | 말하는 비디오를 구동하는 음성 오디오입니다. 출력 길이는 이 오디오와 일치합니다. 여기에 TTS 노드를 연결하여 텍스트로 애니메이션을 구동할 수 있습니다. | AUDIO | 예 | 최대 길이: 600초 | +| `prompt` | 초상화가 살아나는 방식에 대한 선택적 안내입니다. 예: '대상이 미소를 짓고 카메라를 바라보게 하세요'. 자연스러운 말하는 동작을 원하면 비워 둡니다. (기본값: "") | STRING | 아니요 | 여러 줄 텍스트 | +| `seed` | 시드는 노드 재실행 여부를 제어합니다. 시드와 관계없이 결과는 비결정적입니다. (기본값: 0) | INT | 아니요 | 0 ~ 2147483647 | +| `model` | sync.so 생성 모델입니다. 이미지 입력은 sync-3에만 해당됩니다. | COMBO | 예 | `"sync-3"` | +| `speaker_selection` | 여러 사람이 보일 때 애니메이션화할 얼굴을 선택합니다. `default`: 모델이 결정하도록 합니다. `coordinates`: 이미지 내 픽셀 좌표(speaker_x, speaker_y)에 있는 얼굴을 대상으로 합니다. 이미지의 경우 자동 감지는 지원되지 않습니다. (기본값: "default") | COMBO | 아니요 | `"default"`
`"coordinates"` | +| `speaker_x` | 화자의 얼굴 X 픽셀 좌표입니다. speaker_selection이 'coordinates'인 경우에만 사용됩니다. (기본값: 0) | INT | 아니요 | 0 ~ 4096 | +| `speaker_y` | 화자의 얼굴 Y 픽셀 좌표입니다. speaker_selection이 'coordinates'인 경우에만 사용됩니다. (기본값: 0) | INT | 아니요 | 0 ~ 4096 | +| `auto_downscale` | 이미지가 4K(4096x2160) 입력 제한을 초과하는 경우 자동으로 축소합니다. 화자 좌표도 이에 맞게 조정됩니다. 비활성화하면 크기가 초과된 이미지에서 오류가 발생합니다. (기본값: True) | BOOLEAN | 아니요 | True
False | + +**참고:** `speaker_x` 및 `speaker_y` 매개변수는 `speaker_selection`이 `"coordinates"`로 설정된 경우에만 사용됩니다. `auto_downscale`이 활성화되면 화자 좌표가 축소된 이미지 크기에 맞게 자동으로 조정됩니다. + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `video` | 입력 오디오에 동기화된 애니메이션 초상화가 포함된 생성된 말하는 비디오입니다. | VIDEO | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SyncTalkingImageNode/ko.md) + +--- +**Source fingerprint (SHA-256):** `21f722cdcc5ff017949887ed2252854feebb9b913034dc6a6c3ce196ad089468` diff --git a/ko/built-in-nodes/TextEncodeJoyImageEdit.mdx b/ko/built-in-nodes/TextEncodeJoyImageEdit.mdx new file mode 100644 index 000000000..e6f7ae8ca --- /dev/null +++ b/ko/built-in-nodes/TextEncodeJoyImageEdit.mdx @@ -0,0 +1,29 @@ +--- +title: "TextEncodeJoyImageEdit - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the TextEncodeJoyImageEdit node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "TextEncodeJoyImageEdit" +icon: "circle" +mode: wide +--- + +이 노드는 텍스트 프롬프트와 선택적 이미지를 JoyImage 모델과 함께 사용하기 위한 컨디셔닝 데이터로 인코딩합니다. CLIP 텍스트 인코더와 선택적 이미지 입력을 결합하여 이미지 생성 또는 편집 작업을 안내할 수 있는 풍부한 컨디셔닝을 생성합니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 여부 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `clip` | 텍스트 프롬프트 인코딩에 사용되는 CLIP 모델 | CLIP | 예 | - | +| `prompt` | 인코딩할 텍스트 프롬프트로, 여러 줄 입력 및 동적 프롬프트를 지원합니다 | STRING | 예 | - | +| `vae` | 이미지를 잠재 공간으로 인코딩하기 위한 VAE 모델(선택 사항) | VAE | 아니요 | - | +| `images` | 컨디셔닝에 포함할 하나 이상의 이미지로, 최대 6개까지 지원합니다 | IMAGE | 아니요 | 0~6개 이미지 | + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `CONDITIONING` | 텍스트 프롬프트와 제공된 모든 이미지를 결합한 인코딩된 컨디셔닝 데이터 | CONDITIONING | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TextEncodeJoyImageEdit/ko.md) + +--- +**Source fingerprint (SHA-256):** `ef48523aa9fc990b2839d755cef272bcdfbacef5af8d961736fde5200c6f082d` diff --git a/ko/built-in-nodes/TextOverlay.mdx b/ko/built-in-nodes/TextOverlay.mdx new file mode 100644 index 000000000..dfa771d28 --- /dev/null +++ b/ko/built-in-nodes/TextOverlay.mdx @@ -0,0 +1,32 @@ +--- +title: "TextOverlay - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the TextOverlay node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "TextOverlay" +icon: "circle" +mode: wide +--- + +이 노드는 이미지 또는 이미지 배치 위에 텍스트를 그립니다. 사용자 지정 텍스트, 글꼴 크기, 색상, 위치, 정렬 및 선택적 윤곽선을 지원하며, 원본 이미지 위에 텍스트를 합성합니다. + +## 입력 + +| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | +|-----------|-------------|-----------|----------|-------| +| `images` | 텍스트를 그릴 입력 이미지 또는 이미지 배치입니다. | IMAGE | 예 | | +| `text` | 오버레이할 텍스트 문자열입니다. 줄바꿈(`\n`) 및 탭(`\t`) 문자를 지원합니다. 기본값: "" | STRING | 예 | | +| `font_size` | 이미지 높이 대비 백분율로 표시된 글꼴 크기입니다. 기본값: 5.0 | FLOAT | 예 | 0.5 ~ 50.0 | +| `color` | 텍스트의 색상입니다. 기본값: "#ffffff"(흰색) | STRING | 예 | | +| `position` | 이미지에서 텍스트의 세로 위치입니다. 기본값: "top" | COMBO | 예 | "top"
"bottom" | +| `align` | 텍스트의 가로 정렬입니다. 기본값: "left" | COMBO | 예 | "left"
"center"
"right" | +| `outline` | 텍스트 주위에 검은색 윤곽선을 그립니다. 기본값: True | BOOLEAN | 예 | | + +## 출력 + +| 출력 이름 | 설명 | 데이터 타입 | +|-------------|-------------|-----------| +| `images` | 텍스트 오버레이가 합성된 이미지 또는 이미지 배치입니다. | IMAGE | + +> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TextOverlay/ko.md) + +--- +**Source fingerprint (SHA-256):** `baffaa4ec9d3565e3533673658399271234def8c49e2e4a5f16767ec3f98cb22` diff --git a/zh/built-in-nodes/AnimaLLLiteApply.mdx b/zh/built-in-nodes/AnimaLLLiteApply.mdx new file mode 100644 index 000000000..1c1d337b9 --- /dev/null +++ b/zh/built-in-nodes/AnimaLLLiteApply.mdx @@ -0,0 +1,32 @@ +--- +title: "AnimaLLLiteApply - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the AnimaLLLiteApply node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "AnimaLLLiteApply" +icon: "circle" +mode: wide +--- + +此节点对扩散模型应用轻量级动画补丁,通过可调节的强度和时序实现受控的图像到图像生成。它将预配置的模型补丁与输入图像及可选遮罩集成,修改模型的注意力层和 MLP 层以影响生成过程。 + +## 输入 +| 参数 | 描述 | 数据类型 | 是否必填 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `model` | 要应用补丁的基础扩散模型 | MODEL | 是 | | +| `model_patch` | 要应用的预配置动画补丁 | MODEL_PATCH | 是 | | +| `image` | 用于引导生成的参考图像 | IMAGE | 是 | | +| `strength` | 补丁效果的强度(默认值:1.0) | FLOAT | 是 | -10.0 至 10.0 | +| `start_percent` | 补丁开始生效的降噪过程百分比(默认值:0.0) | FLOAT | 是 | 0.0 至 1.0 | +| `end_percent` | 补丁停止生效的降噪过程百分比(默认值:1.0) | FLOAT | 是 | 0.0 至 1.0 | +| `mask` | 可选遮罩,用于将补丁效果限制在图像的特定区域 | MASK | 否 | | + +**参数约束说明:** 如果 `model_patch` 具有 4 个输入通道且未提供 `mask`,则会自动创建一个与图像尺寸匹配的零遮罩。如果 `model_patch` 不具有 4 个输入通道,则 `mask` 参数将被忽略并设置为 `None`。 + +## 输出 +| 输出名称 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `MODEL` | 已应用动画补丁的扩散模型 | MODEL | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/AnimaLLLiteApply/zh.md) + +--- +**Source fingerprint (SHA-256):** `291dc6a6619faab1c1100110c71c47381addcd80dbaf933dd8025a376bc2bee7` diff --git a/zh/built-in-nodes/HeyGenAvatarVideoNode.mdx b/zh/built-in-nodes/HeyGenAvatarVideoNode.mdx new file mode 100644 index 000000000..3e5297ef6 --- /dev/null +++ b/zh/built-in-nodes/HeyGenAvatarVideoNode.mdx @@ -0,0 +1,45 @@ +--- +title: "HeyGenAvatarVideoNode - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the HeyGenAvatarVideoNode node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "HeyGenAvatarVideoNode" +icon: "circle" +mode: wide +--- + +根据 HeyGen 虚拟形象生成一段主播式讲话视频。此节点利用 HeyGen 的渲染引擎,创建 AI 虚拟形象朗读您提供的文本或根据您自己的音频进行口型同步的视频。 + +## 输入 +| 参数 | 描述 | 数据类型 | 是否必填 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `engine` | 渲染引擎;每个选项仅列出支持该引擎的虚拟形象。'auto' 会提供所有虚拟形象并为其选择最佳引擎(优先选择 Avatar IV)。Avatar V 保真度最高,Avatar III 性价比最高。 | COMBO | 是 | `"auto"`
`"avatar_iv"`
`"avatar_iii"`
`"avatar_v"` | +| `custom_avatar_id` | 可选的 HeyGen 虚拟形象外观 ID。设置后,将覆盖上方选择的虚拟形象。可以使用 HeyGen 的 3000 多个公共外观(或您的私人虚拟形象)中的任意一个。 | STRING | 否 | | +| `speech` | 通过文本脚本(HeyGen 文本转语音)或您自己的音频来驱动虚拟形象。 | COMBO | 是 | `"script"`
`"audio"` | +| `resolution` | 输出视频分辨率(默认值:"1080p")。 | COMBO | 否 | `"720p"`
`"1080p"` | +| `aspect_ratio` | 输出宽高比。'auto' 跟随虚拟形象的源素材(默认值:"auto")。 | COMBO | 否 | `"auto"`
`"16:9"`
`"9:16"`
`"1:1"`
`"4:5"`
`"5:4"` | +| `background_color` | 可选的纯色背景色,使用十六进制代码(例如 '#00ff00')。留空则使用虚拟形象自身的背景。 | STRING | 否 | | +| `seed` | 不会发送给 HeyGen;更改此值可强制重新运行(默认值:42)。 | INT | 否 | 最小值:0
最大值:2147483647 | + +当 `speech` 设置为 `"script"` 时,可使用以下子参数: + +| 参数 | 描述 | 数据类型 | 是否必填 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `text` | 虚拟形象要朗读的文本(最多 5000 个字符)。生成的语音时长至少为 1 秒。 | STRING | 是 | | +| `voice` | 脚本使用的语音。默认选项使用 HeyGen 分配给该虚拟形象的语音。 | COMBO | 是 | 提供多个选项 | +| `custom_voice_id` | 可选的 HeyGen 语音 ID。设置后,将覆盖上方选择的语音。可以使用 HeyGen 语音库(2000+)中的任意语音。 | STRING | 否 | | +| `voice_speed` | 语速倍数(默认值:1.0)。 | FLOAT | 否 | 最小值:0.5
最大值:1.5
步长:0.05 | + +当 `speech` 设置为 `"audio"` 时,可使用以下子参数: + +| 参数 | 描述 | 数据类型 | 是否必填 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `audio` | 用于虚拟形象进行口型同步的音频,最长 10 分钟。 | AUDIO | 是 | | + +## 输出 +| 输出名称 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `VIDEO` | 生成的虚拟形象主播视频。 | VIDEO | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HeyGenAvatarVideoNode/zh.md) + +--- +**Source fingerprint (SHA-256):** `009bc72b841ca273af83fe6f80fb24d4b11c2efd96c011795b1ff1cf8e66ee61` diff --git a/zh/built-in-nodes/HeyGenCreateAvatarNode.mdx b/zh/built-in-nodes/HeyGenCreateAvatarNode.mdx new file mode 100644 index 000000000..4da905530 --- /dev/null +++ b/zh/built-in-nodes/HeyGenCreateAvatarNode.mdx @@ -0,0 +1,40 @@ +--- +title: "HeyGenCreateAvatarNode - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the HeyGenCreateAvatarNode node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "HeyGenCreateAvatarNode" +icon: "circle" +mode: wide +--- + +根据人物照片或文本提示描述的角色,创建一个可复用的 HeyGen 虚拟形象。生成的虚拟形象 ID 可与 HeyGen 虚拟形象视频节点配合使用,制作包含该虚拟形象的视频。 + +## 输入 +| 参数 | 描述 | 数据类型 | 是否必填 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `source` | 通过文本提示生成新角色,或根据连接的人物照片创建虚拟形象。 | COMBO | 是 | `"prompt"`
`"photo"` | + +当 `source` 设置为 `"prompt"` 时,将显示以下额外参数: + +| 参数 | 描述 | 数据类型 | 是否必填 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `prompt` | 要生成的虚拟形象描述(最多 1000 个字符)。 | STRING | 是 | 1 至 1000 个字符 | +| `reference_images` | 最多 3 张参考图像,用于指导生成的外观。 | IMAGE | 否 | 0 至 3 张图像 | + +当 `source` 设置为 `"photo"` 时,将显示以下额外参数: + +| 参数 | 描述 | 数据类型 | 是否必填 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `identity_photo` | 要转化为虚拟形象的人物照片。若分辨率大于 2K,将自动缩小。 | IMAGE | 是 | 单张图像 | + +**注意:** `source` 参数可在两种模式间切换。在 `"prompt"` 模式下,您需提供文本描述,并可选择提供最多 3 张参考图像。在 `"photo"` 模式下,您需提供一张人物照片。这两种模式互斥。 + +## 输出 +| 输出名 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `avatar_id` | 虚拟形象外观 ID。将其传递给 HeyGen 虚拟形象视频的 `custom_avatar_id`;保存后可后续复用该虚拟形象。 | STRING | +| `preview` | 生成的虚拟形象预览图像。 | IMAGE | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HeyGenCreateAvatarNode/zh.md) + +--- +**Source fingerprint (SHA-256):** `c60e9cdb0d91fb5ec6ea83b503b9aa10c978ce065a16c751a52e90c12e70a5e2` diff --git a/zh/built-in-nodes/HeyGenTalkingPhotoNode.mdx b/zh/built-in-nodes/HeyGenTalkingPhotoNode.mdx new file mode 100644 index 000000000..55d195b0b --- /dev/null +++ b/zh/built-in-nodes/HeyGenTalkingPhotoNode.mdx @@ -0,0 +1,35 @@ +--- +title: "HeyGenTalkingPhotoNode - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the HeyGenTalkingPhotoNode node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "HeyGenTalkingPhotoNode" +icon: "circle" +mode: wide +--- + +## 概述 +使用 HeyGen 的 Avatar IV 技术,将人物静态图像动画化为唇形同步的说话视频。您可以通过 HeyGen 转换为语音的文本来驱动动画,也可以提供自己的音频让虚拟形象进行唇形同步。 + +## 输入 +| 参数 | 描述 | 数据类型 | 是否必填 | 取值范围 | +|-----------|-------------|-----------|----------|-------| +| `image` | 要动画化的人物图像。如果大于 2K 将自动缩小。 | IMAGE | 是 | - | +| `speech` | 通过文本脚本(HeyGen 文本转语音)或您自己的音频驱动虚拟形象。 | COMBO | 是 | `"script"`
`"audio"` | +| `text` | 虚拟形象要说的文本(最多 5000 个字符)。生成的语音必须至少 1 秒长。 | STRING | 是(当 speech 为 "script" 时) | - | +| `voice` | 脚本使用的语音(HeyGen 最受欢迎的语音)。 | COMBO | 是(当 speech 为 "script" 时) | 提供多个选项 | +| `custom_voice_id` | 可选的 HeyGen 语音 ID。设置后将覆盖上面选择的语音。可以使用 HeyGen 库中的任何语音(2000+)。 | STRING | 否 | - | +| `voice_speed` | 语速倍率(默认值:1.0)。 | FLOAT | 否 | 0.5 至 1.5 | +| `audio` | 虚拟形象唇形同步的音频,最长 10 分钟。 | AUDIO | 是(当 speech 为 "audio" 时) | - | +| `resolution` | 输出视频分辨率(默认值:"1080p")。 | COMBO | 否 | `"720p"`
`"1080p"` | +| `aspect_ratio` | 输出宽高比。'auto' 跟随输入图像(默认值:"auto")。 | COMBO | 否 | `"auto"`
`"16:9"`
`"9:16"`
`"1:1"`
`"4:5"`
`"5:4"` | +| `expressiveness` | 动画面部和手势的表现力程度(默认值:"low")。 | COMBO | 否 | `"low"`
`"medium"`
`"high"` | +| `seed` | 不会发送到 HeyGen;更改它以强制重新运行(默认值:42)。 | INT | 否 | 0 至 2147483647 | + +## 输出 +| 输出名称 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `video` | 生成的动画说话照片视频,包含唇形同步的语音。 | VIDEO | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HeyGenTalkingPhotoNode/zh.md) + +--- +**Source fingerprint (SHA-256):** `2181066a8c6191cfcaa15ece4f89a16c37e76aa22763d6df4007baa20336f05a` diff --git a/zh/built-in-nodes/HeyGenTextToSpeechNode.mdx b/zh/built-in-nodes/HeyGenTextToSpeechNode.mdx new file mode 100644 index 000000000..13f496a19 --- /dev/null +++ b/zh/built-in-nodes/HeyGenTextToSpeechNode.mdx @@ -0,0 +1,29 @@ +--- +title: "HeyGenTextToSpeechNode - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the HeyGenTextToSpeechNode node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "HeyGenTextToSpeechNode" +icon: "circle" +mode: wide +--- + +使用 HeyGen 的 Starfish TTS 引擎从文本生成语音音频。此节点包含 HeyGen 最受欢迎的 17 种语言语音。 + +## 输入 +| 参数 | 描述 | 数据类型 | 是否必填 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `text` | 要合成的文本(最多 5000 个字符)。生成的语音时长必须至少为 1 秒。 | STRING | 是 | 1 到 5000 个字符 | +| `voice` | 要使用的语音(从 HeyGen 最受欢迎的 Starfish 兼容语音中精选)。 | STRING | 是 | 提供多个选项 | +| `custom_voice_id` | 可选的 HeyGen 语音 ID。设置后将覆盖上方选择的语音。该语音必须支持 Starfish 引擎。 | STRING | 否 | 任意有效的 HeyGen 语音 ID | +| `speed` | 语速倍率(默认值:1.0)。 | FLOAT | 否 | 0.5 到 2.0(步长:0.05) | +| `ssml` | 将文本视为 SSML 标记(用于控制停顿、强调和发音)(默认值:False)。 | BOOLEAN | 否 | True / False | +| `seed` | 不会发送至 HeyGen;更改此值可强制重新运行(默认值:42)。 | INT | 否 | 0 到 2147483647 | + +## 输出 +| 输出名 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `AUDIO` | 根据输入文本生成的合成语音音频。 | AUDIO | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HeyGenTextToSpeechNode/zh.md) + +--- +**Source fingerprint (SHA-256):** `82300626657db8ab16e96ae96b7dfe3291b77bf75efec35971dc772e5123cce7` diff --git a/zh/built-in-nodes/HeyGenVideoTranslateNode.mdx b/zh/built-in-nodes/HeyGenVideoTranslateNode.mdx new file mode 100644 index 000000000..6ad614a14 --- /dev/null +++ b/zh/built-in-nodes/HeyGenVideoTranslateNode.mdx @@ -0,0 +1,67 @@ +--- +title: "HeyGenVideoTranslateNode - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the HeyGenVideoTranslateNode node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "HeyGenVideoTranslateNode" +icon: "circle" +mode: wide +--- + +你是一位专业的技术文档翻译专家,专门负责将 ComfyUI 节点文档从英文翻译成简体中文。 + +## 翻译规则 + +1. **必须保持不变的内容:** + - 参数名必须保持英文,用反引号包裹:`image`、`seed`、`model` + - 数据类型必须保持英文大写:IMAGE、STRING、INT、FLOAT、MODEL、CONDITIONING 等 + - Range 列中的值保持不变:数字、"auto"、选项名称 + - 不要翻译任何代码、文件路径 + +2. **需要翻译的内容:** + - 章节标题翻译为:## 概述、## 输入、## 输出 + - 所有描述性文字和说明 + - 参数描述 + +3. **翻译质量要求:** + - 使用自然流畅的简体中文 + - 保持专业但易懂的语气 + - 确保技术准确性 + - 使用中文技术文档的标准术语 + +4. **格式要求:** + - 保持所有 Markdown 格式不变 + - 保持表格结构完整 + - 不要添加免责声明(系统将自动添加到文档底部) + +## 翻译示例 + +**英文:** +This node combines two CLIP models by adding the second model to the first. + +**中文:** +此节点通过将第二个 CLIP 模型添加到第一个模型来组合两个 CLIP 模型。 + +请将以下英文文档翻译成简体中文,不要包含免责声明: + +5. **关键规则 - 输出名称:** 输出表(Outputs)的第一列是输出名(如 `positive`、`negative`、`latent`、`image`、`model`、`conditioning`),**必须保持英文不变**。翻译输出名会导致输出表中出现重复名称,破坏文档结构。 + +将带语音的视频翻译成另一种语言,并应用语音克隆和唇形同步。此节点会克隆原始说话者的语音,并重新驱动口型以匹配翻译后的语音,从而产生自然逼真的效果。 + +## 输入 +| 参数 | 描述 | 数据类型 | 是否必需 | 取值范围 | +|-----------|-------------|-----------|----------|-------| +| `video` | 包含待翻译语音的视频。 | VIDEO | 是 | - | +| `output_language` | 翻译后视频的目标语言。 | STRING | 是 | "Arabic"
"Bengali"
"Chinese"
"Danish"
"Dutch"
"English"
"French"
"German"
"Greek"
"Hindi"
"Indonesian"
"Italian"
"Japanese"
"Korean"
"Malay"
"Polish"
"Portuguese"
"Russian"
"Spanish"
"Swedish"
"Tamil"
"Telugu"
"Thai"
"Turkish"
"Ukrainian"
"Vietnamese" | +| `mode` | 'speed' 模式速度更快;'precision' 模式可生成更高质量的唇形同步,但成本翻倍。 | STRING | 是 | "speed"
"precision" | +| `translate_audio_only` | 仅替换音轨,保留原始口型动作(不进行唇形同步)。(默认值:False) | BOOLEAN | 否 | True
False | +| `speaker_count` | 视频中的说话者数量。0 表示自动检测。(默认值:0) | INT | 否 | 0 到 10 | +| `seed` | 不会发送至 HeyGen;更改此值可强制重新运行。(默认值:42) | INT | 否 | 0 到 2147483647 | + +## 输出 +| 输出名称 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `video` | 经过语音克隆和唇形同步处理后的翻译视频。 | VIDEO | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HeyGenVideoTranslateNode/zh.md) + +--- +**Source fingerprint (SHA-256):** `31056060b6309b8ec28b37b353322403e173fd2862b56021392dba24e7a15f69` diff --git a/zh/built-in-nodes/Save3DAdvanced.mdx b/zh/built-in-nodes/Save3DAdvanced.mdx new file mode 100644 index 000000000..2145bcaa7 --- /dev/null +++ b/zh/built-in-nodes/Save3DAdvanced.mdx @@ -0,0 +1,34 @@ +--- +title: "Save3DAdvanced - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the Save3DAdvanced node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "Save3DAdvanced" +icon: "circle" +mode: wide +--- + +此节点将 3D 模型保存到您的 ComfyUI 输出目录,并提供高级预览功能。您可以指定输出文件名、预览尺寸,并可选择传递相机和模型信息,以获得增强的 3D 查看器体验。 + +## 输入 +| 参数 | 描述 | 数据类型 | 是否必需 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `model_3d` | 来自上游 3D 节点的 3D 模型文件。 | FILE3D | 是 | GLB、GLTF、FBX、OBJ、STL、USDZ 或任何 3D 格式 | +| `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` | 已保存的 3D 模型文件。 | FILE3D | +| `model_3d_info` | 传递至下游节点的 3D 模型信息。 | 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` diff --git a/zh/built-in-nodes/SaveGaussianSplat.mdx b/zh/built-in-nodes/SaveGaussianSplat.mdx new file mode 100644 index 000000000..c29015b58 --- /dev/null +++ b/zh/built-in-nodes/SaveGaussianSplat.mdx @@ -0,0 +1,34 @@ +--- +title: "SaveGaussianSplat - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the SaveGaussianSplat node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "SaveGaussianSplat" +icon: "circle" +mode: wide +--- + +此节点将高斯泼溅 3D 文件保存到 ComfyUI 输出目录,并为 3D 查看器提供预览数据。 + +## 输入 +| 参数 | 描述 | 数据类型 | 是否必需 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `model_3d` | 一个高斯泼溅 3D 文件。 | FILE3D | 是 | - | +| `filename_prefix` | 保存文件名的前缀(默认值:"3d/ComfyUI") | STRING | 是 | - | +| `viewport_state` | 来自 3D 加载器节点的当前视口状态。 | LOAD3D | 是 | - | +| `model_3d_info` | 用于预览的附加 3D 模型信息。 | LOAD3DMODELINFO | 否 | - | +| `camera_info` | 用于预览的相机信息。 | LOAD3DCAMERA | 否 | - | +| `width` | 预览的宽度(像素,默认值:1024) | INT | 是 | 最小值:1,最大值:4096,步长:1 | +| `height` | 预览的高度(像素,默认值:1024) | INT | 是 | 最小值:1,最大值:4096,步长:1 | + +## 输出 +| 输出名 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `model_3d` | 已保存的高斯泼溅 3D 文件。 | FILE3D | +| `model_3d_info` | 用于预览的 3D 模型信息。 | LOAD3DMODELINFO | +| `camera_info` | 用于预览的相机信息。 | LOAD3DCAMERA | +| `width` | 预览的宽度。 | INT | +| `height` | 预览的高度。 | INT | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SaveGaussianSplat/zh.md) + +--- +**Source fingerprint (SHA-256):** `f2d6b98d2ce1fe11df8ba440b7f46a21e2308966c15daa5ca0bdca7dab1726cc` diff --git a/zh/built-in-nodes/SavePointCloud.mdx b/zh/built-in-nodes/SavePointCloud.mdx new file mode 100644 index 000000000..50372df55 --- /dev/null +++ b/zh/built-in-nodes/SavePointCloud.mdx @@ -0,0 +1,36 @@ +--- +title: "SavePointCloud - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the SavePointCloud node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "SavePointCloud" +icon: "circle" +mode: wide +--- + +保存点云节点将 3D 点云文件保存到您的 ComfyUI 输出目录。它还会将点云数据以及可选的相机和模型信息传递给工作流中的其他节点。 + +## 输入 + +| 参数 | 描述 | 数据类型 | 是否必填 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `model_3d` | 点云文件 (.ply) | FILE3D | 是 | - | +| `filename_prefix` | 保存文件名的前缀(默认:"3d/ComfyUI") | STRING | 是 | - | +| `viewport_state` | 来自 3D 视口节点的状态 | LOAD3D | 是 | - | +| `model_3d_info` | 可选的高级用途 3D 模型信息 | LOAD3DMODELINFO | 否 | - | +| `camera_info` | 可选的高级用途相机信息 | LOAD3DCAMERA | 否 | - | +| `width` | 预览图像的宽度(像素,默认:1024) | INT | 是 | 最小值:1,最大值:4096,步长:1 | +| `height` | 预览图像的高度(像素,默认:1024) | INT | 是 | 最小值:1,最大值:4096,步长:1 | + +## 输出 + +| 输出名 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `model_3d` | 已保存的点云文件 | FILE3D | +| `model_3d_info` | 3D 模型的信息 | LOAD3DMODELINFO | +| `camera_info` | 视口的相机信息 | LOAD3DCAMERA | +| `width` | 预览图像的宽度 | INT | +| `height` | 预览图像的高度 | INT | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SavePointCloud/zh.md) + +--- +**Source fingerprint (SHA-256):** `ce8f005c431843a57d87a4aff2eed7a1604ebdf360f83b3aaaadc3ed364d218a` diff --git a/zh/built-in-nodes/SaveText.mdx b/zh/built-in-nodes/SaveText.mdx new file mode 100644 index 000000000..d5727212a --- /dev/null +++ b/zh/built-in-nodes/SaveText.mdx @@ -0,0 +1,28 @@ +--- +title: "SaveText - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the SaveText node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "SaveText" +icon: "circle" +mode: wide +--- + +保存文本节点将文本内容写入输出目录中的文件。它支持三种不同的文件格式:纯文本(.txt)、Markdown(.md)和 JSON(.json)。当保存为 JSON 格式时,该节点会尝试将输入文本解析为有效的 JSON,并使用适当的缩进进行格式化。 + +## 输入 + +| 参数 | 描述 | 数据类型 | 是否必填 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `text` | 要保存到文件的文本内容 | STRING | 是 | | +| `filename_prefix` | 输出文件名的前缀(默认值:"ComfyUI") | STRING | 否 | | +| `format` | 保存文本的文件格式(默认值:"txt") | STRING | 否 | `"txt"`
`"md"`
`"json"` | + +## 输出 + +| 输出名 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `text` | 已保存到文件的原始文本内容 | STRING | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SaveText/zh.md) + +--- +**Source fingerprint (SHA-256):** `5644d143f415773115b38d7af6d9afea20c9eadef2cea836b0384c15e0dcba6a` diff --git a/zh/built-in-nodes/SeedVR2TemporalChunk.mdx b/zh/built-in-nodes/SeedVR2TemporalChunk.mdx new file mode 100644 index 000000000..cc7f1a18d --- /dev/null +++ b/zh/built-in-nodes/SeedVR2TemporalChunk.mdx @@ -0,0 +1,39 @@ +--- +title: "SeedVR2TemporalChunk - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the SeedVR2TemporalChunk node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "SeedVR2TemporalChunk" +icon: "circle" +mode: wide +--- + +此节点将 SeedVR2 视频潜变量分割成较小的重叠时间块,这些块可在可用 VRAM 内逐一处理。这些块设计为同时传递给 Apply SeedVR2 Conditioning 节点和采样器潜变量输入,随后使用 Merge SeedVR2 Latents 节点重新组合。 + +## 输入 +| 参数 | 描述 | 数据类型 | 是否必需 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `latent` | 要分割的 VAE 编码 SeedVR2 潜变量 | LATENT | 是 | - | +| `temporal_overlap` | 相邻块之间共享并在合并时交叉淡化的潜变量帧数;0 表示无重叠(默认值:0) | INT | 否 | 0 至 16384 | +| `chunking_mode` | manual = 精确使用 frames_per_chunk;auto = 预测适合空闲 VRAM 的最大块 | COMBO | 是 | "auto"
"manual" | + +当 `chunking_mode` 设置为 "manual" 时,以下参数可用: + +| 参数 | 描述 | 数据类型 | 是否必需 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `frames_per_chunk` | 每个时间块的像素帧数(必须为 4n+1:1, 5, 9, 13, ...)(默认值:21) | INT | 是 | 1 至 16384,步长 4 | + +**参数约束说明:** +- 输入 `latent` 必须是形状为 (B, C, T, H, W) 且恰好有 4 个潜变量通道的五维视频潜变量 +- 使用 "manual" 模式时,`frames_per_chunk` 必须为 4n+1 值(1, 5, 9, 13, 17, 21, ...) +- `temporal_overlap` 自动限制为小于块大小 +- 在 "auto" 模式下,节点根据可用空闲 VRAM 计算最佳块大小 + +## 输出 +| 输出名 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `latents` | 按顺序排列的时间块 | LATENT | +| `temporal_overlap` | 相邻块之间的有效潜变量帧重叠数,用于 Merge SeedVR2 Latents | INT | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SeedVR2TemporalChunk/zh.md) + +--- +**Source fingerprint (SHA-256):** `40af2b690f74555efbe38f4cf76825417f52735ce90296a9ad662f78cfe4c6bf` diff --git a/zh/built-in-nodes/SeedVR2TemporalMerge.mdx b/zh/built-in-nodes/SeedVR2TemporalMerge.mdx new file mode 100644 index 000000000..885e24a03 --- /dev/null +++ b/zh/built-in-nodes/SeedVR2TemporalMerge.mdx @@ -0,0 +1,27 @@ +--- +title: "SeedVR2TemporalMerge - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the SeedVR2TemporalMerge node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "SeedVR2TemporalMerge" +icon: "circle" +mode: wide +--- + +此节点将之前由 Split SeedVR2 Latent 节点分割的潜在视频数据的时间块重新组合。它使用汉宁窗交叉淡入淡出处理重叠区域,在块之间创建平滑过渡,当未指定重叠时则执行简单拼接。 + +## 输入 +| 参数 | 描述 | 数据类型 | 是否必需 | 范围 | +|------|------|----------|----------|------| +| `latents` | 按顺序排列的采样时间块。 | LATENT | 是 | 潜在变量列表 | +| `temporal_overlap` | Split SeedVR2 Latent 节点的 `temporal_overlap` 输出。0 表示简单拼接。 | INT | 是 | 0 至 16384(默认值:0) | + +**注意:** `temporal_overlap` 参数必须从 Split SeedVR2 Latent 节点的 `temporal_overlap` 输出连接。所有输入的潜在变量必须具有相同的批次大小、通道数、高度和宽度。只有最后一个时间块的时序维度可能比其他块短。 + +## 输出 +| 输出名称 | 描述 | 数据类型 | +|-----------|------|----------| +| `latent` | 重新组合后的完整长度潜在变量。 | LATENT | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SeedVR2TemporalMerge/zh.md) + +--- +**Source fingerprint (SHA-256):** `647653fc651462f62bcc9dca2919cfcaa4b476b4c679b0a1111698facab83f28` diff --git a/zh/built-in-nodes/SyncLipSyncNode.mdx b/zh/built-in-nodes/SyncLipSyncNode.mdx new file mode 100644 index 000000000..08508ed31 --- /dev/null +++ b/zh/built-in-nodes/SyncLipSyncNode.mdx @@ -0,0 +1,54 @@ +--- +title: "SyncLipSyncNode - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the SyncLipSyncNode node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "SyncLipSyncNode" +icon: "circle" +mode: wide +--- + +此节点使用 sync.so API 将视频中的口型动作与新的语音音频重新同步。它能自动处理特写、侧脸和遮挡情况,同时保留说话者的表情。费用按输出时长计算。 + +## 输入 +| 参数 | 描述 | 数据类型 | 是否必填 | 取值范围 | +|-----------|-------------|-----------|----------|-------| +| `video` | 需要重新同步的说话者视频素材。最高支持 4K(4096x2160);恒定帧率 24/25/30 fps 效果最佳。 | VIDEO | 是 | - | +| `audio` | 用于同步口型的语音音频。 | AUDIO | 是 | - | +| `seed` | 种子控制节点是否重新运行;无论种子如何,结果均非确定性(默认值:42)。 | INT | 是 | 0 至 2147483647 | +| `model` | sync.so 生成模型。 | COMBO | 是 | 见下文 | + +`model` 参数是一个动态组合,包含以下子参数: + +| 子参数 | 描述 | 数据类型 | 是否必填 | 取值范围 | +|---------------|-------------|-----------|----------|-------| +| `sync_mode` | 处理视频与音频时长不匹配的方式;同时决定输出长度(默认值:"bounce")。 | COMBO | 是 | `"bounce"`
`"cut_off"`
`"loop"`
`"silence"`
`"remap"` | +| `speaker_selection` | 当画面中出现多人时,选择要唇形同步的面部(默认值:"default")。 | COMBO | 是 | `"default"`
`"auto-detect"`
`"coordinates"` | +| `speaker_frame` | 用于定位说话者的视频帧。仅在 `speaker_selection` 为 "coordinates" 时使用(默认值:0)。 | INT | 否 | 0 至 1000000 | +| `speaker_x` | 说话者面部的 X 像素坐标。仅在 `speaker_selection` 为 "coordinates" 时使用(默认值:0)。 | INT | 否 | 0 至 4096 | +| `speaker_y` | 说话者面部的 Y 像素坐标。仅在 `speaker_selection` 为 "coordinates" 时使用(默认值:0)。 | INT | 否 | 0 至 4096 | + +**同步模式选项:** +- `bounce`:视频先正向播放再反向播放,直至音频结束(输出 = 音频长度) +- `loop`:视频循环播放直至音频结束(输出 = 音频长度) +- `remap`:视频进行时间拉伸以匹配音频(输出 = 音频长度) +- `cut_off`:较长的轨道被裁剪(输出 = 较短长度) +- `silence`:不裁剪任何内容;较短的轨道用静音填充(输出 = 较长长度) + +**说话者选择选项:** +- `default`:让模型自行决定唇形同步的面部 +- `auto-detect`:检测并跟随当前说话者 +- `coordinates`:定位 `speaker_frame` 所选帧中像素坐标(`speaker_x`,`speaker_y`)处的面部 + +**限制条件:** +- 视频分辨率不得超过 4K(4096x2160)。超出此限制的视频将报错。 +- 音频时长不得超过 600 秒(10 分钟)。 +- `speaker_frame`、`speaker_x` 和 `speaker_y` 参数仅在 `speaker_selection` 设置为 "coordinates" 时使用。 + +## 输出 +| 输出名称 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `video` | 口型动作与提供的音频匹配后的重新同步视频。 | VIDEO | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SyncLipSyncNode/zh.md) + +--- +**Source fingerprint (SHA-256):** `b41f8c9bf0d55059f081a66af20636ec96462c3fd9caeb685cab10278f84678a` diff --git a/zh/built-in-nodes/SyncTalkingImageNode.mdx b/zh/built-in-nodes/SyncTalkingImageNode.mdx new file mode 100644 index 000000000..85396573b --- /dev/null +++ b/zh/built-in-nodes/SyncTalkingImageNode.mdx @@ -0,0 +1,34 @@ +--- +title: "SyncTalkingImageNode - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the SyncTalkingImageNode node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "SyncTalkingImageNode" +icon: "circle" +mode: wide +--- + +使用 sync.so 的 sync-3 模型,将静态人像动画化为由语音音频驱动的说话视频。输出时长与音频时长一致,费用随输出时长增加而增加。 + +## 输入 +| 参数 | 描述 | 数据类型 | 是否必需 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `image` | 一张面部清晰可见的图片,最高支持 4K(4096x2160)分辨率。 | IMAGE | 是 | 仅需一张图片 | +| `audio` | 驱动说话视频的语音音频;输出时长与之匹配。可在此处链接任意 TTS 节点,以通过文本驱动动画。 | AUDIO | 是 | 最大时长:600 秒 | +| `prompt` | 可选提示词,用于指导人像如何生动呈现,例如"让主体微笑并看向镜头"。留空则生成自然的说话动作。(默认值:"") | STRING | 否 | 多行文本 | +| `seed` | 种子控制节点是否应重新运行;无论种子如何,结果均具有非确定性。(默认值:0) | INT | 否 | 0 到 2147483647 | +| `model` | sync.so 生成模型。图片输入仅支持 sync-3。 | COMBO | 是 | `"sync-3"` | +| `speaker_selection` | 当画面中出现多人时,选择对哪张面部进行动画化。`default`:让模型自行决定。`coordinates`:定位图片中像素坐标 (speaker_x, speaker_y) 处的面部。图片不支持自动检测。(默认值:"default") | COMBO | 否 | `"default"`
`"coordinates"` | +| `speaker_x` | 说话者面部的 X 轴像素坐标。仅在 `speaker_selection` 设置为 'coordinates' 时使用。(默认值:0) | INT | 否 | 0 到 4096 | +| `speaker_y` | 说话者面部的 Y 轴像素坐标。仅在 `speaker_selection` 设置为 'coordinates' 时使用。(默认值:0) | INT | 否 | 0 到 4096 | +| `auto_downscale` | 若图片超过 4K(4096x2160)输入限制,自动降低分辨率;说话者坐标会相应缩放。禁用时,超尺寸图片将引发错误。(默认值:True) | BOOLEAN | 否 | True
False | + +**注意:** `speaker_x` 和 `speaker_y` 参数仅在 `speaker_selection` 设置为 `"coordinates"` 时使用。启用 `auto_downscale` 时,说话者坐标会自动缩放以匹配降低后的图片尺寸。 + +## 输出 +| 输出名称 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `video` | 生成的说话视频,其中动画化的人像与输入音频同步。 | VIDEO | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SyncTalkingImageNode/zh.md) + +--- +**Source fingerprint (SHA-256):** `21f722cdcc5ff017949887ed2252854feebb9b913034dc6a6c3ce196ad089468` diff --git a/zh/built-in-nodes/TextEncodeJoyImageEdit.mdx b/zh/built-in-nodes/TextEncodeJoyImageEdit.mdx new file mode 100644 index 000000000..debf6b7a6 --- /dev/null +++ b/zh/built-in-nodes/TextEncodeJoyImageEdit.mdx @@ -0,0 +1,27 @@ +--- +title: "TextEncodeJoyImageEdit - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the TextEncodeJoyImageEdit node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "TextEncodeJoyImageEdit" +icon: "circle" +mode: wide +--- + +此节点将文本提示和可选图像编码为条件数据,用于 JoyImage 模型。它结合了 CLIP 文本编码器与可选的图像输入,以创建丰富的条件数据,从而引导图像生成或编辑任务。 + +## 输入 +| 参数 | 描述 | 数据类型 | 是否必需 | 范围 | +|-----------|-------------|-----------|----------|-------| +| `clip` | 用于编码文本提示的 CLIP 模型 | CLIP | 是 | - | +| `prompt` | 要编码的文本提示,支持多行输入和动态提示 | STRING | 是 | - | +| `vae` | 用于将图像编码到潜在空间的 VAE 模型(可选) | VAE | 否 | - | +| `images` | 要包含在条件数据中的一张或多张图像,最多 6 张 | IMAGE | 否 | 0 到 6 张图像 | + +## 输出 +| 输出名 | 描述 | 数据类型 | +|-------------|-------------|-----------| +| `CONDITIONING` | 编码后的条件数据,结合了文本提示和任何提供的图像 | CONDITIONING | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TextEncodeJoyImageEdit/zh.md) + +--- +**Source fingerprint (SHA-256):** `ef48523aa9fc990b2839d755cef272bcdfbacef5af8d961736fde5200c6f082d` diff --git a/zh/built-in-nodes/TextOverlay.mdx b/zh/built-in-nodes/TextOverlay.mdx new file mode 100644 index 000000000..f2eee9917 --- /dev/null +++ b/zh/built-in-nodes/TextOverlay.mdx @@ -0,0 +1,30 @@ +--- +title: "TextOverlay - ComfyUI Built-in Node Documentation" +description: "Complete documentation for the TextOverlay node in ComfyUI. Learn its inputs, outputs, parameters and usage." +sidebarTitle: "TextOverlay" +icon: "circle" +mode: wide +--- + +此节点在单张图像或一批图像上绘制文本。支持自定义文本、字号、颜色、位置、对齐方式以及可选描边,将文本合成到原始图像之上。 + +## 输入 +| 参数 | 描述 | 数据类型 | 是否必填 | 范围 | +|------|------|----------|----------|------| +| `图像` | 要绘制文本的输入图像或图像批次。 | IMAGE | 是 | | +| `文字` | 要叠加的文本字符串。支持换行符(`\n`)和制表符(`\t`)。默认值:"" | STRING | 是 | | +| `字体大小` | 字号,以图像高度的百分比表示。默认值:5.0 | FLOAT | 是 | 0.5 至 50.0 | +| `颜色` | 文本颜色。默认值:"#ffffff"(白色) | STRING | 是 | | +| `位置` | 文本在图像上的垂直位置。默认值:"top" | COMBO | 是 | "top"
"bottom" | +| `对齐` | 文本的水平对齐方式。默认值:"left" | COMBO | 是 | "left"
"center"
"right" | +| `描边` | 在文本周围绘制黑色描边。默认值:True | BOOLEAN | 是 | | + +## 输出 +| 输出名 | 描述 | 数据类型 | +|--------|------|----------| +| `图像` | 叠加了文本合成效果的图像或图像批次。 | IMAGE | + +> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TextOverlay/zh.md) + +--- +**Source fingerprint (SHA-256):** `baffaa4ec9d3565e3533673658399271234def8c49e2e4a5f16767ec3f98cb22`