> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# MiniMaxH3AddGuide - ComfyUI Built-in Node Documentation

> This node anchors an image, a short clip, audio, or a clip with its soundtrack at any frame of a MiniMax H3 video.

This node anchors an image, a short clip, audio, or a clip with its soundtrack at any frame of a MiniMax H3 video. It adds a guide keyframe to the conditioning at the chosen frame index, and you can chain several of these nodes to anchor several frames in the same video.

## Inputs

| Parameter | Description | Data Type | Required | Range |
| - | - | - | - | - |
| `positive` | The conditioning to which the guide keyframe is attached. | CONDITIONING | Yes | - |
| `vae` | Video VAE, needed when an image is connected. | VAE | No | - |
| `audio_vae` | Audio VAE, needed when an audio is connected. | VAE | No | - |
| `latent` | The MiniMax H3 audio-video latent that defines the target video. Must be a MiniMax H3 AV latent (nested, with two 5D tensors, the video tensor having 24 channels). | LATENT | Yes | - |
| `image` | Image or video frames to anchor. Multi-frame batches are anchored as a clip and cropped down to the model's valid clip lengths: 5, 22, 39... (17k + 5) frames. Batches shorter than 5 frames use only the first image. | IMAGE | No | - |
| `audio` | Soundtrack to anchor starting at the same frame index, cropped to the video's remaining duration. | AUDIO | No | - |
| `frame_idx` | Frame index to anchor the image or the clip's first frame at. Negative values are counted from the end of the video. (default: 0) | INT | Yes | -9999 to 9999 |

**Constraints:**

* At least one of `image` or `audio` must be provided; otherwise the node raises an error.
* `vae` is required when `image` is connected.
* `audio_vae` is required when `audio` is connected.
* `image` batches with fewer than 5 frames use only the first image; batches of 5 or more frames are cropped down to a valid clip length (5, 22, 39, etc.).
* `frame_idx` must place the guide within the video's frame range, and a multi-frame clip must fit entirely in the video; otherwise the node raises an error.
* When audio is connected, the frame index must not be past the end of the video's audio track.

## Outputs

| Output Name | Description | Data Type |
| - | - | - |
| `positive` | The conditioning with the guide keyframe added, containing the resolved frame index and, when provided, the encoded image or audio latents. | 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/MiniMaxH3AddGuide/en.md)

***

**Source fingerprint (SHA-256):** `7a2f742421cc2655bd9c914258801e4538f1554a7c5e2b0836b2df1577f5a104`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.