# ComfyUI-StepVideo 插件保姆级教程 ## 1. 插件简介 ComfyUI-StepVideo 是一个专门为 ComfyUI 设计的视频生成插件。这个插件包含了 StepVideo 的自定义节点，可以帮助你在 ComfyUI 中生成各种类型的视频。 **插件原地址**: https://github.com/stepfun-ai/ComfyUI-StepVideo 这个插件的主要功能包括： - 文字生成视频（就像你写一段话，然后变成一段视频） - 图片生成视频（把一张静态图片变成会动的视频） - 支持高质量视频生成（可以生成很清晰的视频） 简单来说，就是让你在 ComfyUI 里面也能做视频，而不只是图片。 ## 2. 如何安装 ### 方法一：Git 安装（推荐） 1. 打开命令行工具（Windows 用户按 Win+R，输入 cmd 回车） 2. 进入你的 ComfyUI 文件夹下的 custom_nodes 目录 3. 输入以下命令： ```bash cd ComfyUI/custom_nodes git clone https://github.com/stepfun-ai/ComfyUI-StepVideo.git ``` ### 方法二：手动下载 1. 访问 https://github.com/stepfun-ai/ComfyUI-StepVideo 2. 点击绿色的 "Code" 按钮 3. 选择 "Download ZIP" 4. 解压到 ComfyUI/custom_nodes/ 文件夹中 ### 额外步骤 你还需要从这个链接下载模型权重文件：https://huggingface.co/stepfun-ai/stepvideo-ti2v ## 3. 节点详细解析 根据插件说明，这个插件包含了4个主要节点：TI2V node、TI2V_API node、T2V node、T2V_API node。 ### 3.1 TI2V 节点（图片转视频节点） 这个节点就像一个"图片动画师"，能把一张静态图片变成会动的视频。 #### 参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 | |:---|:---|:---|:---|:---|:---|:---| | 输入图片 | input_image | 图片文件 | - | 你要让它动起来的那张图片 | 作为视频生成基础的源图像 | 上传一张风景照，让云朵飘动 | | 提示词 | prompt | 文本内容 | 具体描述 | 告诉电脑你想要什么样的动画效果 | 描述视频内容和动作的文本指令 | "云朵在天空中缓缓飘动" | | 视频长度 | video_length | 数字 | 16-32 | 生成视频有多少帧（帧越多视频越长） | 输出视频的帧数 | 设置24就是24帧的短视频 | | 步数 | steps | 数字 | 20-50 | 电脑计算的次数（越多越精细但越慢） | 扩散模型的采样步数 | 设置30就是计算30次 | | 随机种子 | seed | 数字 | 随机或固定 | 就像抽奖的号码，影响最终效果 | 控制随机性的数值 | 用同一个数字能得到相同结果 | ### 3.2 TI2V_API 节点（图片转视频云端节点） 这个节点和上面的 TI2V 节点功能一样，但是是通过网络调用云端服务来生成视频，就像在线PS软件。 #### 参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 | |:---|:---|:---|:---|:---|:---|:---| | API密钥 | api_key | 密钥字符串 | 你的密钥 | 就像你的会员卡号，证明你有权限用这个服务 | 访问云端服务的身份验证密钥 | 从官网获取后填入 | | 输入图片 | input_image | 图片文件 | - | 你要让它动起来的那张图片 | 作为视频生成基础的源图像 | 上传一张人物照片 | | 提示词 | prompt | 文本内容 | 具体描述 | 告诉电脑你想要什么样的动画效果 | 描述视频内容和动作的文本指令 | "人物在微笑和眨眼" | | 视频长度 | video_length | 数字 | 16-32 | 生成视频有多少帧 | 输出视频的帧数 | 设置20帧 | | 服务器地址 | api_url | 网址 | 官方地址 | 云端服务的网址 | API服务端点URL | 使用默认地址即可 | ### 3.3 T2V 节点（文字转视频节点） 这个节点就像一个"文字魔法师"，你只需要写一段文字描述，它就能生成对应的视频。 #### 参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 | |:---|:---|:---|:---|:---|:---|:---| | 提示词 | prompt | 文本内容 | 详细描述 | 你想要的视频内容的文字描述 | 描述视频场景和动作的文本提示 | "一只猫在花园里追蝴蝶" | | 负面提示词 | negative_prompt | 文本内容 | 不想要的内容 | 告诉电脑什么东西不要出现在视频里 | 用于排除不需要内容的反向提示 | "模糊，低质量，扭曲" | | 视频长度 | video_length | 数字 | 16-32 | 生成视频有多少帧 | 输出视频的帧数 | 设置28帧 | | 宽度 | width | 数字 | 512/768/1024 | 视频的宽度（像素） | 视频分辨率的宽度值 | 设置768像素 | | 高度 | height | 数字 | 512/768/1024 | 视频的高度（像素） | 视频分辨率的高度值 | 设置768像素 | | 步数 | steps | 数字 | 20-50 | 电脑计算的次数 | 扩散模型的采样步数 | 设置35步 | | 引导强度 | guidance_scale | 数字 | 7.5-15 | 电脑听你话的程度（越高越严格按你的要求） | 控制模型对提示词的遵循程度 | 设置10.0 | | 随机种子 | seed | 数字 | 随机或固定 | 抽奖号码，影响最终效果 | 控制随机性的数值 | 用-1表示随机 | ### 3.4 T2V_API 节点（文字转视频云端节点） 这个节点和 T2V 节点功能相同，但是通过云端服务来生成视频，速度可能更快。 #### 参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 | |:---|:---|:---|:---|:---|:---|:---| | API密钥 | api_key | 密钥字符串 | 你的密钥 | 云端服务的会员卡号 | 访问云端服务的身份验证密钥 | 从 platform.stepfun.com 获取 | | 提示词 | prompt | 文本内容 | 详细描述 | 你想要的视频内容描述 | 描述视频场景和动作的文本提示 | "海浪拍打着海岸，夕阳西下" | | 负面提示词 | negative_prompt | 文本内容 | 不想要的内容 | 不希望出现在视频中的内容 | 用于排除不需要内容的反向提示 | "人物，建筑，文字" | | 视频长度 | video_length | 数字 | 16-32 | 生成视频的帧数 | 输出视频的帧数 | 设置24帧 | | 服务器地址 | api_url | 网址 | 官方地址 | 云端服务的网址 | API服务端点URL | https://api.stepfun.com/v1/video/generations | | 模型名称 | model | 字符串 | 模型名 | 使用哪个版本的生成模型 | 指定使用的模型版本 | 使用默认模型即可 | ## 4. 使用技巧和建议 ### 4.1 提示词写作技巧 - **要具体不要抽象**：写"一只橙色的猫在绿色草地上跳跃"而不是"猫在玩耍" - **描述动作**：加入"缓缓地"、"快速地"、"轻柔地"等动作描述词 - **环境描述**：描述光线、天气、时间等，比如"阳光明媚的下午" ### 4.2 参数调节建议 - **新手建议**：步数用20-30，引导强度用7.5-10 - **追求质量**：步数可以提高到40-50，但生成时间会变长 - **批量生成**：固定随机种子，只改变提示词，可以得到风格一致的视频 ### 4.3 硬件要求 - **本地运行**：需要较好的显卡（至少8GB显存） - **云端服务**：只需要网络连接，但需要付费 ## 5. 常见问题解答 ### Q1: 为什么我的视频生成很慢？ A: 这通常是因为你的显卡性能不够或者步数设置太高。建议： - 降低步数到20-25 - 减少视频长度到16帧 - 使用 API 节点调用云端服务 ### Q2: 生成的视频质量不好怎么办？ A: 可以尝试： - 提高步数到35-40 - 优化提示词，写得更详细 - 调整引导强度到10-12 - 使用更高的分辨率 ### Q3: API 节点连接失败怎么办？ A: 检查： - API 密钥是否正确 - 网络连接是否正常 - 服务器地址是否正确 ### Q4: 如何获取 API 密钥？ A: 访问 https://platform.stepfun.com 获取 API 密钥 ## 6. 总结 ComfyUI-StepVideo 插件为我们提供了强大的视频生成能力，无论是从文字生成视频还是让图片动起来，都能实现。记住： - 新手先从简单的提示词开始 - 多尝试不同的参数组合 - 网络不好的时候用本地节点，追求速度用 API 节点 - 耐心调试，好的视频需要时间 这个插件让视频创作变得更加简单，你只需要会打字和上传图片，就能创作出令人惊艳的视频作品！
ComfyUI图像合并插件comfyui-merge使用教程 2025-07-03 22:44 ComfyUI 图像合并插件教程 (comfyui-merge) 1. 插件简介 这是一个专门用来合并图片的 ComfyUI 插件，就像用 PS 把多张图片叠在一起那样。它的特别之处在于你精确控制每张图片的混合方式。 GitHub 地址：https://github.com/LingSss9/com
%20(1).png)
