> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-recommend-assets-api.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# CosmosImageToVideoLatent - ComfyUI Built-in Node Documentation

> Complete documentation for the CosmosImageToVideoLatent node in ComfyUI. Learn its inputs, outputs, parameters and usage.

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/CosmosImageToVideoLatent/zh.md)

CosmosImageToVideoLatent 节点可从输入图像创建视频潜空间表示。它会生成一个空白视频潜空间，并可选地将起始图像和/或结束图像编码到视频序列的开端和/或末尾帧。当提供图像时，它还会创建相应的噪声掩码，以指示在生成过程中应保留潜空间的哪些部分。

## 输入参数

| 参数     | 数据类型  | 必需 | 取值范围                 | 描述                    |
| ------ | ----- | -- | -------------------- | --------------------- |
| `vae`  | VAE   | 是  | -                    | 用于将图像编码到潜空间的 VAE 模型   |
| `宽度`   | INT   | 否  | 16 至 MAX\_RESOLUTION | 输出视频的宽度（像素）（默认值：1280） |
| `高度`   | INT   | 否  | 16 至 MAX\_RESOLUTION | 输出视频的高度（像素）（默认值：704）  |
| `长度`   | INT   | 否  | 1 至 MAX\_RESOLUTION  | 视频序列的帧数（默认值：121）      |
| `批量大小` | INT   | 否  | 1 至 4096             | 要生成的潜空间批次数量（默认值：1）    |
| `开始图像` | IMAGE | 否  | -                    | 可选，在视频序列开头编码的图像       |
| `结束图像` | IMAGE | 否  | -                    | 可选，在视频序列末尾编码的图像       |

**注意：** 当既未提供 `start_image` 也未提供 `end_image` 时，节点将返回一个空白潜空间且不带任何噪声掩码。当提供任一图像时，潜空间的相应部分会被编码并生成对应的掩码。

## 输出参数

| 输出名称     | 数据类型   | 描述                           |
| -------- | ------ | ---------------------------- |
| `latent` | LATENT | 生成的视频潜空间表示，包含可选的编码图像及相应的噪声掩码 |