Comfy-Org · comfyui-wiki · Jul 19, 2026 · Jun 29, 2026 · Jun 29, 2026 · Jun 29, 2026
diff --git a/built-in-nodes/AnimaLLLiteApply.mdx 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
@@ -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"`<br />`"avatar_iv"`<br />`"avatar_iii"`<br />`"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"`<br />`"audio"` |
+| `resolution` | Output video resolution (default: "1080p"). | COMBO | No | `"720p"`<br />`"1080p"` |
+| `aspect_ratio` | Output aspect ratio. 'auto' follows the avatar's source footage (default: "auto"). | COMBO | No | `"auto"`<br />`"16:9"`<br />`"9:16"`<br />`"1:1"`<br />`"4:5"`<br />`"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<br />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<br />Max: 1.5<br />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
@@ -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"`<br />`"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
@@ -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"`<br />`"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"`<br />`"1080p"` |
+| `aspect_ratio` | Output aspect ratio. 'auto' follows the input image (default: "auto"). | COMBO | No | `"auto"`<br />`"16:9"`<br />`"9:16"`<br />`"1:1"`<br />`"4:5"`<br />`"5:4"` |
+| `expressiveness` | How expressive the animated face and gestures are (default: "low"). | COMBO | No | `"low"`<br />`"medium"`<br />`"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
@@ -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
@@ -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"<br />"Bengali"<br />"Chinese"<br />"Danish"<br />"Dutch"<br />"English"<br />"French"<br />"German"<br />"Greek"<br />"Hindi"<br />"Indonesian"<br />"Italian"<br />"Japanese"<br />"Korean"<br />"Malay"<br />"Polish"<br />"Portuguese"<br />"Russian"<br />"Spanish"<br />"Swedish"<br />"Tamil"<br />"Telugu"<br />"Thai"<br />"Turkish"<br />"Ukrainian"<br />"Vietnamese" |
+| `mode` | 'speed' is faster; 'precision' produces higher-quality lip sync at twice the price. | STRING | Yes | "speed"<br />"precision" |
+| `translate_audio_only` | Only swap the audio track, keeping the original mouth movements (no lip sync). (default: False) | BOOLEAN | No | True<br />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
@@ -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
@@ -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`