> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# PixVerse Image to Video - ComfyUI 原生节点文档

> 使用PixVerse的AI技术将静态图像转换为动态视频的节点

<img src="https://mintcdn.com/dripart-matt-router-pricing-pika-and-guard/QTMyKFkoVk7odD-Y/images/built-in-nodes/api_nodes/pixverse/pixverse-image-to-video.jpg?fit=max&auto=format&n=QTMyKFkoVk7odD-Y&q=85&s=5adabe940da4bbfe36df1c4c7cb71543" alt="ComfyUI 原生 PixVerse Image to Video 节点" width="1731" height="1659" data-path="images/built-in-nodes/api_nodes/pixverse/pixverse-image-to-video.jpg" />

PixVerse Image to Video 节点通过 PixVerse 的API服务，可以将静态图像转换为动态视频。它能保留原始图像的视觉特征，同时根据文本提示词添加自然的动态效果。

## 参数说明

### 必需参数

| 参数 | 类型 | 默认值 | 说明 |
| - | - | - | - |
| image | 图像 | - | 要转换为视频的输入图像 |
| prompt | 字符串 | "" | 描述视频动作和内容的文本提示词 |
| negative\_prompt | 字符串 | "" | 指定不希望在视频中出现的元素 |
| seed | 整数 | -1 | 生成过程的随机种子，-1为随机 |
| quality | 选择项 | "high" | 生成视频的质量级别 |
| aspect\_ratio | 选择项 | "r16\_9" | 输出视频的宽高比 |
| duration | 选择项 | "seconds\_4" | 生成视频的持续时间 |
| motion\_mode | 选择项 | "standard" | 视频的动作模式 |

### 可选参数

| 参数 | 类型 | 默认值 | 说明 |
| - | - | - | - |
| pixverse\_template | PIXVERSE\_TEMPLATE | None | 可选的PixVerse模板配置 |

### 输出

| 输出 | 类型 | 说明 |
| - | - | - |
| VIDEO | 视频 | 生成的视频结果 |

## 源码参考

\[节点源码 (更新于2025-05-05)]

```python theme={null}
class PixverseImageToVideoNode(ComfyNodeABC):
    """
    Pixverse Image to Video

    Generates videos from an image and prompts.
    """

    @classmethod
    def INPUT_TYPES(s):
        return {
            "required": {
                "image": ("IMAGE",),
                "prompt": ("STRING", {"multiline": True, "default": ""}),
                "negative_prompt": ("STRING", {"multiline": True, "default": ""}),
                "seed": ("INT", {"default": -1, "min": -1, "max": 0xffffffffffffffff}),
                "quality": (list(PixverseQuality.__members__.keys()), {"default": "high"}),
                "aspect_ratio": (list(PixverseAspectRatio.__members__.keys()), {"default": "r16_9"}),
                "duration": (list(PixverseDuration.__members__.keys()), {"default": "seconds_4"}),
                "motion_mode": (list(PixverseMotionMode.__members__.keys()), {"default": "standard"}),
            },
            "optional": {
                "pixverse_template": ("PIXVERSE_TEMPLATE",),
            },
            "hidden": {
                "auth_token": "AUTH_TOKEN_COMFY_ORG",
            },
        }

    RETURN_TYPES = ("VIDEO",)
    DESCRIPTION = "Generates videos from an image and prompts using Pixverse's API"
    FUNCTION = "generate_video"
    CATEGORY = "api node/video/Pixverse"
    API_NODE = True
    OUTPUT_NODE = True
```


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