优先选择云端api调用，3分钟即可生成首条视频；仅当设备满足rtx 4090/5090、cuda 12.4、torch 2.5.1、≥16gb显存且无网络/数据安全限制时，才考虑本地comfyui部署。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在腾讯混元文生视频功能上线后快速产出视频，但不确定该走云端API调用还是本地部署ComfyUI运行——这直接关系到你能否今天就生成第一条视频，还是得先折腾三天环境、卡在CUDA版本或显存不足上。
先看是否必须本地运行
如果你的设备是AMD显卡、NVIDIA 20系显卡（如RTX 2080 Ti）、或者显存≤12GB（例如RTX 3060 12G），【本地运行HunyuanVideo将大概率失败】。官方明确要求CUDA 12.4 + torch 2.5.1 + 至少16GB显存（推荐RTX 4090/5090），且HunyuanVideoWrapper节点对A卡无支持。此时强行本地部署，会在模型加载阶段报“out of memory”或“no kernel image is available”错误，无法继续。
如果你所在单位网络完全隔离、禁止外网调用API、或输入视频含敏感人脸/内部产品画面，【必须本地运行】，否则数据会经公网传输至腾讯云服务器，违反安全策略。
云端调用：3分钟完成首条视频生成
第一步：登录腾讯云控制台→进入「混元大模型」服务页→开通「混元生视频」API权限；
第二步：在API密钥管理页创建一对SecretId/SecretKey，并记下Region（如ap-guangzhou）；
第三步：用curl或Python requests调用/v20241201/GenerateVideo接口，POST body中传入text字段（如“一只橘猫在太空站飘浮，尾巴缓慢摆动，高清4K”）和resolution参数（"1080p"）；
第四步：收到返回的TaskId后，轮询/v20241201/DescribeVideoTaskStatus接口，状态变为SUCCESS时，response里直接给出可下载的HTTPS视频URL。整个过程无需装CUDA、不占本地显存、不编译任何代码。
本地运行：仅限满足全部硬件与系统条件者
方法一：ComfyUI一键包直装（仅限Windows/NVIDIA用户）
下载WAN 2.1配套的ComfyUI Windows一键安装包→双击运行→安装路径不要含中文或空格→启动后选择GPU类型为CUDA→等待自动下载基础节点；
接着在ComfyUI-Manager界面搜索“HunyuanVideoWrapper”→点击Install→安装完成后重启UI；
然后从腾讯云控制台下载hunyuan-video-1.0模型文件（约12GB）→放入ComfyUI/models/checkpoints/目录→重命名为hunyuan_video.safetensors；
最后加载官方提供的HunyuanVideo工作流JSON→填入提示词→点Queue即可生成。注意：若未将config.ini中security_level设为weak，节点安装会静默失败，无任何报错提示。
方法二：手动构建（Linux/CUDA 12.4环境专用）
git clone https://github.com/comfyanonymous/ComfyUI.git → cd ComfyUI → conda create -n hunyuan3d python=3.10 → conda activate hunyuan3d；
pip3 install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/cu124 → 这一步必须用nightly版，稳定版2.4.0会导致输出全黑帧；
cd custom_nodes → git clone https://github.com/kijai/ComfyUI-HunyuanVideoWrapper.git → 启动ComfyUI后，在浏览器打开http://127.0.0.1:8188 → 加载工作流→确认模型路径指向正确safetensors文件→执行生成。
