ComfyUI 实现 2.5D 视差动画(视差动画Orbital.json) 📅 2026/7/21 23:29:06 视差动画是一种视觉效果简单来讲就是通过前景和背景以不同的速度来移动创造出一种深度感使得我们的图片具备立体感看起来更加生动。Comfy魔法一、工具介绍ComfyUI 是一个基于节点的容器是用于构建和运行生成式内容工作流的环境。一个 ComfyUI 实例一套 Python 环境可以运行无数个工作流所有工作流共享同一套依赖环境。此处可能会看的比较迷茫可以直接大致粗略看一下每一个工具干啥的后续在执行完步骤三再回来看会有更深的理解。1. 基础环境组件核心用途Python 3.11整个项目的运行语言底座。所有 AI 模型推理、图像处理、插件逻辑都基于 Python 运行3.11 是当前生态适配最广的稳定版。Python 虚拟环境.venv环境隔离工具。给 ComfyUI 单独划出一套独立的依赖库和系统全局 Python、其他项目互不干扰避免版本冲突。PyTorchCPU 版AI 计算框架。Depth Anything V2 深度模型、所有 AI 推理运算都基于它运行无独立 N 卡时使用 CPU 版完成计算。2. 核心平台层组件核心用途ComfyComfy 是面向专业视觉人士的 AI 创作引擎可以掌控每个模型、每个参数和每个输出。ComfyUI可视化 AI 工作流主平台。是整个项目的底座提供节点画布、任务调度、模型加载、图像 IO 等基础能力所有插件和工作流都运行在它之上。Comfy DesktopComfyUI 的桌面启动器。简化实例管理、环境切换、启停操作相当于图形化的 “启动器 管理器”本身不提供 AI 计算能力。ComfyUI-Manager插件生态管理工具。用来搜索、安装、更新、卸载第三方自定义节点自动检测工作流缺失的插件是安装 Depthflow 的核心入口。3. 工具插件层2.5D效果核心组件核心用途ComfyUI-Depthflow-Nodes项目核心功能插件。提供视差运动计算、多帧渲染、边缘填充等全部 2.5D 动画算法节点决定最终的立体动画效果ComfyUI-DepthAnythingV2深度估计插件。调用 AI 模型把 2D 原图转换成灰度深度图越白越近、越黑越远给 Depthflow 提供 “远近层次” 的数据依据是视差效果的前提ComfyUI-VideoHelperSuite视频合成插件。把 Depthflow 渲染出的逐帧图片合并成 MP4/GIF 动画文件完成最终的视频输出rgthree-comfy通用工具插件。提供开关、循环、逻辑复用等辅助节点用来简化工作流结构不是 2.5D 效果的必需项但多数现成工作流会用到它4. 工作流与资源层组件核心用途Depthflow 工作流JSON 文件节点连线的配置文件。把 “加载图片→算深度→视差渲染→合成视频” 的完整流程固化下来导入后直接使用无需手动逐个节点连线。视差动画Orbital.json实现简单的轨道视差效果后期可以添加其他效果的节点实现all视差效果.json深度模型文件Depth Anything V2 的 AI 模型权重。是深度估计的核心数据首次运行会自动下载决定深度识别的精度二、Depthflow核心链路输入阶段ComfyUI 读取本地图片传入工作流。深度估计阶段Depth Anything V2 插件调用 AI 模型生成图片的深度图区分前景与背景的远近关系。视差计算阶段Depthflow 插件根据深度图和运动预设轨道 / 平移 / 缩放等计算每一帧的像素偏移量。渲染阶段逐帧生成带视差偏移的图像同时自动填充偏移后产生的边缘空缺。输出阶段VideoHelperSuite 把帧序列合成视频 / GIF保存到输出目录。三、ComfyUI 运行Depthflow的全流程1.下载Comfy Desktop下载Comfy DesktopComfy官网安装 Comfy 桌面版主要是为了对 ComfyUI 有更直观的理解可以看到通过Comfy Desktop创建、管理 ComfyUI 实例的过程。Comfy Desktop 默认一键创建的ComfyUI 实例会采用较新的 Python 版本此处为3.13.12后期我导入Depthflow的过程中一直报错显示节点包不兼容。此处的解决办法为手动创建合适的Python环境手动创建独立版的ComfyUI不通过 Comfy Desktop 来创建桌面版 ComfyUI 。2.创建虚拟环境、下载ComfyUI、下载ComfyUI-Manager可以使用 conda 管理虚拟环境但是 conda 很重而且属于商业产品。此处我使用的是Python原生的 venv 来管理虚拟环境。第一步在 Python 官网下载 Python 3.11.9 64 位正式版安装时必须勾选底部的Add Python.exe to PATH。第二步升级pip创建一个 ComfyUI-py311 文件夹来存放环境和开源的 ComfyUI在当前目录下打开cmd命令行窗口以下以cmd命令行窗口为例python -m pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple python -m venv .venv call .venv\Scripts\activate.bat若打开的是PowerShell窗口命令有所不同可稍微注意一下Python -m venv .venv .venv\Scripts\Activate.ps1此刻当前目录下会产生.venv文件并且命令行界面开头也会加上(.venv)说明此时已经激活了Python 环境。接下来的步骤虚拟环境应该一直处于激活状态。第三步安装 CPU版 PyTorch有独立显卡可以安装 cuda 版 Pytorch。pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu -i https://pypi.tuna.tsinghua.edu.cn/simple第四步下载ComfyUI源码如果 github 服务器不稳定也可以手动下载 zip 包到 ComfyUI-py311 文件夹下。目录结构如下。git clone https://github.com/Comfy-Org/ComfyUI.git第五步切到 ComfyUI 目录下且保证虚拟环境激活状态安装 ComfyUI 基础依赖预安装 Depthflow 等插件必备依赖。pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple pip install opencv-python numpy scipy -i https://pypi.tuna.tsinghua.edu.cn/simple第六步预装节点管理器 ComfyUI-Manager 和视差工作流全套插件。git clone https://ghproxy.com/https://github.com/ltdrdata/ComfyUI-Manager.git git clone https://ghproxy.com/https://github.com/kijai/ComfyUI-DepthAnythingV2.git git clone https://ghproxy.com/https://github.com/akatz-ai/ComfyUI-Depthflow-Nodes.git git clone https://ghproxy.com/https://github.com/Kosinkadink/ComfyUI-VideoHelperSuite.git如果不预装视差工作流全套插件后期进入 ComfyUI 导入depthflow工作流会显示确实节点包也可以在此处选择“全部安装”。3. 启动ComfyUI运行Depthflow切回ComfyUI目录执行以下命令。ComfyUI 启动时默认会优先尝试调用 NVIDIA 显卡的 CUDA 设备检测失败就直接触发断言崩溃。这是纯 CPU 环境的经典启动坑和 Python 版本、依赖完整性无关。加上--cpu这个参数后ComfyUI 会强制使用 CPU 计算跳过所有 CUDA 设备检测就能正常启动进入界面。--enable-manager参数允许使用节点管理器选择「安装缺失自定义节点」一键安装所有缺失插件安装完成后重启 ComfyUI 即可生效。python main.py --cpu --enable-manager将想要运行的视差工作流json文件导入ComfyUI进行参数的修改得到2.5D视差效果图。附速记启动ComfyUI切到E:\Project\ComfyUI-py311\.venv\Scripts目录下执行 activate激活虚拟环境切回ComfyUI目录下执行python main.py --cpu --enable-managerPycharm启动在Pycharm中添加现有虚拟环境在Pycharm终端中启动ComfyUI。四、设置Depthflow核心参数按下面数值设置优先保证能顺利跑完、速度可接受先看到完整的 2.5D 效果再慢慢调优。tips所有节点的详细信息及参数设置可参考 Depthflow Nodes 文档。1. 加载图像节点速度影响最大操作提前把图片宽度压缩到768~1024px不要直接用 1080P/2K 原图跑。原理渲染计算量和像素数成正比分辨率砍半速度能快 3~4 倍。2. 深度模型节点DownloadAndLoadDepthAnythingV2模型下拉选择depth_anything_v2_vits_fp32.safetensorsSmall 轻量版不要选vit_l大模型Small 版纯 CPU 推理速度是大模型的 2~3 倍 做视差动画精度完全够用。3. 轨道运动预设节点DepthflowMotionPresetOrbital参数推荐值作用strength0.7全局分层力度(静态立体属性)控制远近物体的位移差距管「层次感强弱」有视差intensity0.6运镜运动幅度(动态镜头属性)控制镜头移动跑多远管「画面动多大」有移动relative1.0相对深度保持默认即可数值越高层次感越明显新手先别动其他参数这三个是控制最终立体效果的核心。4. 主渲染节点Depthflow参数推荐值作用num_frames总帧数48动画总长度48 帧约2 秒24 帧 / 秒验证效果足够ssaa超级采样1.0纯 CPU 直接关闭这是头号性能杀手开 1.5 渲染耗时直接翻倍quality渲染质量得分2控制边缘插值精度1 快速低质3 高清慢速平衡选 2tiling_mode边缘填充mirror镜像用镜像像素填充边缘空缺速度远快于 AI 补全动画中几乎看不出瑕疵motion_blur运动模糊0关闭开了会让单帧渲染时间翻倍短动画提升效果有限5. 视频合成节点VHS_VideoCombinefps24格式image/gifvideo/ffmpeg-gifimage/gif 是逐帧输出静态 GIF 图片序列video/ffmpeg-gifvideo 类 GIF是合成单个动态 GIF 动图文件二者是完全不同的用途很多新手容易误选前者导致找不到成品动画。维度image/gif图像序列模式video/ffmpeg-gif视频合成模式输出形式输出 N 个独立的静态.gif 文件每一帧对应一张单独的图片输出1 个完整的动态 GIF 文件所有帧合并在一起打开即可循环播放编码逻辑每一帧单独编码成静态图帧与帧之间无关联、无压缩调用 FFmpeg 把帧序列合并编码做帧间压缩生成标准动图格式文件体积总体积更大没有帧间冗余压缩体积更小利用帧间重复像素压缩适用场景需要逐帧素材做二次后期导入 PS/AE 调色、加特效或做帧级别的素材复用直接出成品动图用于社交分享、网页展示、表情包等画质表现单帧画质理论上略好没有动图的色彩抖动损耗受 GIF 格式 256 色上限限制复杂渐变、光影画面会出现轻微色彩断层视差动画场景选择建议日常出成品优先选video/ffmpeg-gif这是绝大多数人的需求跑完工作流直接得到一个能播放的 2.5D 视差动图不用再手动合成。不要误选image/gif选这个跑完后输出文件夹里会是几十上百张静态 GIF 单图不会自动变成动画需要你自己用其他软件合并纯做视差效果完全没必要。更优替代优先用video/h264-mp4如果你不是必须要 GIF 格式MP4 格式画质更细腻、文件体积更小纯 CPU 编码速度也比 GIF 更快手机、播放器兼容性更好是视差动画成品的最优选择。优先保证合成速度文件稍大一点没关系。调优进阶逻辑确认能正常出片后可以按这个方向逐步调整找到效果和速度的平衡点先加帧数再加分辨率先把总帧数加到 90~120 帧3~5 秒动画流畅度提升最明显确认速度可接受再把分辨率提到 1024~1280px。运动强度宁小勿大feature 和 intensity 不要超过 1.0数值过高会导致前景飞出画面、边缘穿帮严重反而不自然。景深效果按需开启如果节点里有 DOF景深模糊参数测试阶段先关闭最终出片时再开低强度会额外增加渲染耗时。纯 CPU 环境避坑提醒不要直接跑默认 150 帧 1080P 的配置单张图可能要跑半小时以上很容易误以为卡死。跑任务时关掉浏览器多余标签、微信等后台软件保证至少 10G 空闲内存一旦内存占满触发虚拟内存速度会暴跌。如果渲染过程中画面出现大面积黑边优先降低运动强度而不是开 AI 补全后者纯 CPU 下速度极慢。常见问题Python 版本不匹配导致依赖异常Comfy Desktop 默认创建的实例会采用较新的 Python 版本天然存在第三方插件兼容风险。Python 3.13.12 版本过新Depthflow、VideoHelperSuite 等插件依赖的 opencv、scipy 等库适配滞后进而出现安装失败、节点加载失效节点管理器ComfyUI-Manager的核心是管理自定义节点插件本身检测工作流缺失的插件并一键安装第三方 Python 依赖库是插件附带安装的管理器会触发安装流程但本身不是通用的 pip 包管理器。在custom_nodes目录下已经有ComfyUI-Depthflow-Nodes文件夹了但是启动depthflow工作流一直显示缺失这个节点包。核心原因说明文件夹存在 ≠ 插件加载成功。90% 以上的这类问题都是插件文件虽然放在了目录里但启动时因为依赖缺失、路径错误、文件损坏等原因静默加载失败前端就会判定为「缺失节点包」。解决办法为在ComfyUI-Depthflow-Nodes目录下执行pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple命令即可正确运行depthflow工作流。如果工作流运行过程中ComfyUI在尝试从HuggingFace下载DepthAnythingV2模型时发生错误可以手动下载并且放置于ComfyUI\models\depthanything目录下具体流程可见官方链接以及readme文档。之前遇到的sqlalchemy缺失、资产管理相关报错都是Comfy Desktop 定制版专属问题原生开源 ComfyUI 不会出现。以下是原生环境下的核心问题与解决方案序号问题现象根本原因解决方案1插件安装依赖卡死、工作流节点显示 UNKNOWN插件带兼容性警告Python 3.13 版本过新Depthflow、VideoHelperSuite 等第三方插件及其依赖opencv-python、scipy尚未完成完整适配安装时易触发源码编译导致卡死更换为 Python 3.11 环境这是目前 ComfyUI 生态适配最成熟、最稳定的版本2启动报错AssertionError: Torch not compiled with CUDA enabled安装的是纯 CPU 版 PyTorch不含 CUDA 显卡加速模块但 ComfyUI 默认优先检测 NVIDIA 显卡的 CUDA 设备检测失败直接崩溃启动时添加--cpu参数强制使用 CPU 计算模式跳过 CUDA 设备检测3导入 2.5D 视差工作流后节点标红 / 显示 UNKNOWN提示缺失自定义节点原生 ComfyUI 仅自带基础节点不包含深度估计、视差渲染、视频合成等第三方功能插件无法识别工作流中的对应节点安装 ComfyUI-Manager 管理器一键补全或手动预装 Depth Anything V2、Depthflow、VideoHelperSuite 三个插件