必须先开通混元视频api权限并启用hunyuanvideo-i2v插件，再在工作流中串联开始节点、图像输入与视频生成节点，配置image_url、prompt和duration参数，试运行验证后发布为api。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在腾讯元器平台中搭建一个可稳定调用混元图生视频能力的工作流，必须先确认已开通混元视频API权限，并在工作流编辑器中正确串联图像输入、提示词处理与视频生成节点，否则流程会在试运行时直接中断报错。
准备工作：开通权限并获取可用插件
登录腾讯元器控制台 → 进入【我的创建】→ 点击【插件管理】→ 在搜索框输入“混元图生视频” → 找到官方插件【HunyuanVideo-I2V】→ 点击【启用】。若列表中未出现该插件，说明账号尚未开通混元视频服务权限，需前往腾讯云控制台申请开通并完成实名认证。
启用后，刷新页面，在左侧节点栏的【工具节点】下即可看到该插件图标。注意：【插件启用后需等待3–5分钟同步生效，立即拖拽会提示“节点不可用”】。
搭建核心工作流：三步连通图像→提示→视频
第一步：从左侧【开始节点】拖入画布，双击编辑，设置触发方式为【手动触发】或【API调用】，勾选【允许上传图片】；
第二步：拖入【HunyuanVideo-I2V】工具节点，连接开始节点的输出箭头至该节点输入口；
第三步：双击该工具节点，在参数面板中填入以下三项必填字段：① 【image_url】必须为公网可直访问的图片地址（本地文件路径或base64无效）；② prompt填写中文引导语（如“镜头缓慢推进，樱花飘落，春日庭院”）；③ duration设为2–4秒（超出4秒将触发超时中断）。其他参数保持默认即可。
调试与发布：避免常见失败点
点击右上角【试运行】→ 上传一张尺寸不小于512×512像素的JPG/PNG图 → 输入简短提示词 → 点击【运行】。若返回“模型加载失败”，说明GPU资源未就绪，需等待后台自动调度；若返回“输入格式错误”，大概率是image_url未托管在CDN或OSS且未配置跨域头；若长时间卡在“生成中”，检查是否duration＞4秒或prompt含敏感词（如暴力、政治人物）。
试运行成功后，点击【发布】→ 勾选【对外暴露API】→ 复制生成的Endpoint地址。该地址即为后续集成到网页、小程序或Multi-Agent系统的调用入口。
