本文档抓取自官方文档中心(2026-10-10 快照),具体功能以实际产品为准。
生视频节点
功能概述
生视频节点(原"图生视频"节点)支持三种模式,通过"图片模式"选择器切换:
- 首尾帧模式(first_last_frame):上传首帧(和可选尾帧)图片生成视频
- 多参考图模式(multi_reference):上传多张参考图作为风格参考生成视频
- 文生视频(text_to_video):纯文本提示词生成视频,无需上传任何图片
模式切换
在节点左栏"图片模式"下拉框中切换。切换时自动更新:
- 图片上传区域的显示/隐藏
- 视频模型列表(根据模式过滤)
- 参考音频/视频区域的显示/隐藏
首尾帧模式
- 默认模式,向后兼容
- 需要上传首帧图片(或通过图片节点连接)
- 尾帧可选
- 调用
/api/ai-app-run-image,image_mode=first_last_frame - 视频模型列表:所有 image_to_video 模型
多参考图模式
- 上传 1-5 张参考图作为风格参考
- 支持参考音频和参考视频
- 调用
/api/ai-app-run-image,image_mode=multi_reference - 视频模型列表:仅支持 multi_reference 的模型
文生视频模式
- 无需上传任何图片,仅凭提示词生成视频
- 调用
/api/ai-app-run(text_to_video 端点) - 视频模型列表:所有 text_to_video 类别的模型
- 不支持参考音频/视频
API 调用
图生视频(首尾帧/多参考图)
POST /api/ai-app-run-image
FormData: prompt, ratio, duration_seconds, count, task_id, image_urls, image_mode, ...
文生视频
POST /api/ai-app-run
FormData: prompt, ratio, duration_seconds, count, task_id, user_id, auth_token
task_id 通过 TaskConfig.getTaskIdByKey(model, 'text_to_video') 获取。
数据字段
| 字段 | 类型 | 说明 |
|---|---|---|
node.data.imageMode | 'first_last_frame' / 'multi_reference' / 'text_to_video' | 图片模式 |
node.data.videoUrls | Array<{name, url}> | 通过上传或视频节点连线添加的参考视频列表 |
端口与国际化
- 生视频节点标题、图片模式标签和模式选项都通过
video_workflowi18n key 渲染;工作流重新加载早于 i18n 初始化时,节点 DOM 会在ZJTi18nDOM.scanDOM()后自动刷新为当前语言。 - 输出端口连接到视频节点,用于把生视频结果写入视频节点。
- 视频节点输出端口可连接到生视频节点的参考视频端口,连接成功后写入
node.data.videoUrls,并在重新加载工作流后恢复。
向后兼容
- 旧工作流无
imageMode字段时,默认'first_last_frame' - 序列化/反序列化自动包含
imageMode字段
相关文件
web/js/nodes.js— createImageToVideoNode(): 节点创建、模式 UI、生成逻辑web/js/api.js— generateVideoFromImage() / generateVideoFromText(): API 调用web/js/workflow.js— createImageToVideoNodeWithData(): 状态恢复web/video_workflow.html— 工具栏按钮