comfyui-vidu-nodes

comfyui-vidu-nodes
★ 10

视频生成文本到视频视频超分ComfyUI扩展
整合VIDU API到ComfyUI，支持文本/图像/角色到视频、首尾帧生成、视频超分与下载，便捷化视频生成与增强流程
💡 在ComfyUI中通过文本或图片一键生成并提升视频质量
🍴 3 Forks💻 Python🔄 2025-03-21
📦
网盘下载
复制链接后前往夸克网盘下载
https://pan.quark.cn/s/9d76119b2ef2
📄 README

ComfyUI VIDU 节点

这是一个用于 ComfyUI 的 VIDU API 集成节点包，支持文本生成视频、图像生成视频、角色生成视频以及视频超分等功能。

功能特点

该节点包提供以下功能：

  • 文本生成视频 (Text to Video)
  • 图像生成视频 (Image to Video)
  • 角色生成视频 (Character to Video)
  • 首尾帧生成视频 (Start-End to Video)
  • 视频超分 (Video Upscale)
  • 视频下载器 (Video Downloader)

    • 安装方法

  • 进入 ComfyUI 的 custom_nodes 目录
  • 克隆本仓库：
    • git clone https://github.com/1zhangyy1/comfyui-vidu-nodes

    使用前准备

    使用前需要准备 VIDU API Token。请联系 VIDU 官方获取授权 Token。

    节点说明

    1. 文本生成视频 (Text to Video)

    将文本描述转换为视频。

    参数说明：

  • prompt: 文本描述（必填）
  • duration: 视频时长，支持 4 秒或 8 秒
  • token: API Token（必填）
  • style: 风格选择（general/anime）
  • model: 模型选择（默认 vidu-high-performance）
  • seed: 随机种子（可选）
  • enhance: 是否启用提示词增强（默认开启）
  • moderation: 是否开启审核（默认关闭）
  • negative_prompt: 反向提示词（可选）

    • 2. 图像生成视频 (Image to Video)

    将静态图像转换为动态视频。

    参数说明：

  • image: 输入图像（必填）
  • prompt: 文本描述（必填）
  • duration: 视频时长
  • token: API Token（必填）
  • model: 模型选择
  • enhance: 提示词增强
  • moderation: 审核开关
  • seed: 随机种子

    • 3. 角色生成视频 (Character to Video)

    基于角色图像生成视频。

    参数说明：

  • character_image: 角色图像（必填）
  • prompt: 文本描述（必填）
  • duration: 视频时长
  • token: API Token（必填）
  • 其他参数同上

    • 4. 首尾帧生成视频 (Start-End to Video)

    通过提供起始帧和结束帧，生成从一帧到另一帧的平滑过渡视频。

    参数说明：

  • start_frame: 起始帧图像（必填）
  • end_frame: 结束帧图像（必填）
  • prompt: 文本描述（必填）
  • token: API Token（必填）
  • model: 模型选择（vidu1.5/vidu2.0）
  • resolution: 分辨率（360p/720p/1080p）
  • duration: 视频时长（默认4秒，vidu2.0仅支持4秒）
  • seed: 随机种子
  • movement_amplitude: 运动幅度（auto/small/medium/large）
  • callback_url: 回调URL（可选）

    • 5. 视频超分 (Video Upscale)

    提升视频分辨率。

    参数说明：

  • creation_id: 生成物 ID（必填）
  • token: API Token（必填）
  • model: 超分模型（默认 stable）

    • 6. 视频下载器 (Video Downloader)

    下载生成的视频到本地。

    参数说明：

  • video_url: 视频 URL（必填）
  • output_path: 输出路径（默认为 outputs）

    • 使用限制

  • 图片格式仅支持 JPG 和 PNG
  • 图片大小需要小于 50MB
  • 图片长宽比需要小于 1:4 或 4:1
  • Character to Video 任务的图片尺寸不能小于 128*128
  • Character to Video 任务的图片比例需要小于 1:16 或 16:1
  • 视频生成数量目前仅支持 1 个
  • 视频时长目前支持 4 秒和 8 秒两种选项

    • 注意事项

  • 请确保 API Token 的安全性，不要泄露给他人
  • 生成的视频链接有效期为 1 小时
  • 建议使用视频下载器节点及时保存重要的生成结果
  • 使用 Character to Video 功能时请注意图片尺寸要求
  • 所有节点现已支持Vidu API v2版本，确保您的Token具有v2 API的访问权限
  • 使用Start-End to Video功能时，请注意起始帧和结束帧的宽高比应相似（比例在0.8到1.25之间）

    • API v2特别说明

    本插件使用Vidu API v2版本，相比v1版本有以下变化：

  • 支持新的首尾帧生成视频功能
  • 图片上传流程调整，使用/tools/v2/files/uploads接口
  • 视频生成接口统一为/v2/vidu/tasks
  • 图片上传支持的格式包括PNG、JPEG、JPG和WebP
  • 首尾帧生成视频功能的图片要求：
  • 只接受2张图片（起始帧和结束帧）
  • 起始帧和结束帧的宽高比应在0.8到1.25之间
  • 图片宽高比必须小于1:4或4:1
  • 图片大小不得超过10MB

    • 错误处理

    如果遇到错误，请检查：

  • API Token 是否正确
  • 网络连接是否正常
  • 输入参数是否符合要求
  • 图片格式和大小是否符合限制
  • 查看ComfyUI的控制台输出，所有Vidu节点都会输出详细的日志信息
  • 日志格式为：[Vidu 节点名称] 消息内容
  • 包含请求URL、参数和响应的详细信息
  • 记录所有API交互的状态变化和错误信息

    • 常见错误与解决方案

  • 404 Not Found – 通常表示API路径错误或Token无效
  • JSON解析错误 – 检查Token是否正确，服务器返回的是否为有效JSON
  • 上传图片失败 – 检查图片格式、大小是否符合要求
  • 任务状态查询失败 – 检查网络连接，任务ID是否正确
  • 未能获取etag – 图片上传过程中的问题，检查网络连接和图片格式

    • 如果在控制台看到”[Vidu XXX] 发生错误”类型的消息，可以根据附带的错误说明进行排查。

    更新日志

    2024年3月9日

  • 新增首尾帧生成视频(Start-End to Video)节点
  • 更新所有节点以支持Vidu API v2版本
  • 添加详细的日志记录和错误处理机制
  • 修复了图片上传相关的问题
  • 统一了所有节点的API基础URL格式
  • 优化了错误信息显示，便于用户调试

    • [在这里添加更多版本更新信息]

    支持与反馈

    如有问题或建议，请通过以下方式联系：

  • 提交 Issue
  • 联系 VIDU 官方支持

    • 许可证

    [添加许可证信息]