视频生成节点

视频生成节点根据文字提示词生成视频，也可以在图文生视频模式中结合首帧和尾帧图片生成视频。它适合产品演示、场景预览、短视频素材和工业流程可视化等任务。

视频生成通常比文本处理耗时更长。当前属性面板明确提示任务可能超过 2 分钟，正式流程应优先采用异步调用方式，并为超时、重试和失败分支预留处理逻辑。

当前功能与旧文档差异

本页沿用旧文档中仍然适用的模式选择、模型设置、参考图片、动态输入、提示词、输出和异常处理结构，并按当前系统修正以下内容：

• 当前线上模型由模型工厂动态提供。核对时可见 happyhorse-1.0-t2v、happyhorse-1.0-i2v、wan2.7-t2v 和 wan2.7-i2v，不再照搬旧文档固定列出的豆包 Seedance 模型。
• 当前前端统一把视频时长限制为 3～12 秒，没有按不同模型展示不同的时长范围；模型服务是否接受具体值，应以单节点试运行结果为准。
• 当前图文生视频面板只提供“首帧图片”和“尾帧图片”。虽然面板提示语提到多图参考，现有可操作界面没有独立的多参考图列表，因此本文不继续沿用旧文档“最多 4 张参考图”的说法。
• 当前界面没有展示固定帧率、账号并发数或视频链接有效期。旧文档中的 24 FPS、固定并发和 URL 24 小时有效等信息不再作为现行承诺。
• 当前视频生成节点没有注册独立的发布校验函数。属性面板会提示“提示词不能为空”，但不能只依赖发布操作检查模型、图片和参数是否完整。
• 当前异常处理支持不重试或重试 1～3 次，并支持中断流程、返回设定内容和执行异常流程，不再局限于旧文档中的简单失败说明。

配置示例

下面的截图工作流只保留视频生成节点，开始与结束节点已移出截图范围。示例没有执行视频生成，不会产生模型调用费用。

文生视频示例使用当前空间可用的 happyhorse-1.0-t2v，比例 16:9、分辨率 720P、时长 5 秒，种子值为 -1。

图文生视频示例改用 happyhorse-1.0-i2v。切换模式后，比例固定为“保持上传图片比例”，并显示首帧和尾帧图片配置。

生成模式

模式	输入素材	当前界面行为
文生视频	提示词，可选 String 输入参数	比例可选；固定镜头和水印默认关闭。
图文生视频	提示词、必填首帧图片、可选尾帧图片	比例固定为“保持上传图片比例”；切换到该模式时固定镜头和水印默认开启。

模式和模型是两个独立配置。当前选择器不会保证在切换模式时自动替换为匹配模型，因此应手动确认：文生视频选择带 t2v 能力的模型，图文生视频选择带 i2v 或图片理解能力的模型。

模型设置

视频生成模型

模型列表来自当前空间的模型工厂，不应在工作流之外硬编码模型名称。核对时线上可见：

• happyhorse-1.0-t2v：视频生成；
• happyhorse-1.0-i2v：视频生成、图片理解；
• wan2.7-t2v：视频生成；
• wan2.7-i2v：视频生成、图片理解。

模型列表会随空间配置、权限和模型工厂发布情况变化。截图中的列表只表示核对时可用，不保证其他空间或后续版本完全相同。

比例

文生视频当前提供以下比例：

21:9、16:9、4:3、1:1、3:4、9:16、9:21 和“保持上传图片比例”。默认是 16:9。

图文生视频模式强制使用“保持上传图片比例”，比例下拉框不可编辑。首尾帧比例不一致时，当前前端不会自动提示如何裁剪或补边，应在上传前统一素材比例，并通过所选模型试运行确认结果。

分辨率

当前选项为 480P、720P 和 1080P，默认 720P。属性面板不会依据每个模型动态隐藏不支持的分辨率，因此“界面可选”不等于“当前模型一定支持”。

时长

当前默认 5 秒，前端接受 3～12 秒的整数。旧文档按模型区分 3～12 秒、4～12 秒等范围，而当前界面没有继续做这种差异化限制。

固定镜头

开启后，向生成服务传递固定镜头要求；关闭时模型可以根据提示词生成运镜。图文生视频模式切换时默认开启，文生视频模式切换时默认关闭。

“固定镜头”不代表画面中的主体不能运动。需要限制相机运动时，还应在提示词中写明“机位固定”“无推拉摇移”等要求，并检查实际结果。

种子值

默认值为 -1，表示不指定固定种子。当前前端允许 -1 或非负整数。相同种子能否稳定复现结果取决于模型服务、模型版本和其他参数，不能只凭前端字段承诺完全一致。

水印与音频

• 是否包含水印：控制是否向模型服务传递水印要求。具体水印样式和位置由服务决定。
• 是否包含音频：控制是否请求同步音频。该开关始终显示，但所选模型是否真正支持音频生成，应以模型能力和试运行结果为准。

参考图片

图文生视频模式提供：

配置	类型	是否必填	说明
首帧图片	Image	是	可上传本地图片，或引用上游 Image 变量。
尾帧图片	Image	否	可上传本地图片，或引用上游 Image 变量。是否被模型采用取决于模型能力。

当前界面没有独立的“参考图数组”操作入口。选择仅支持首帧的模型时，不要因为界面仍显示尾帧输入就假定模型一定支持尾帧控制。

上传前应检查图片比例、主体一致性、素材授权和隐私要求。首尾帧中的人物、物体位置或光线差异过大，可能导致生成过程突变。

输入参数与提示词

“输入”可以新增 String 参数，每项包含变量名和固定值或上游变量引用。提示词中使用 <code v-pre>{{变量名}}</code> 引用。

例如定义：

变量名	示例值
scene	未来智慧工厂
subject	巡检机器人
camera	从入口缓慢推进

提示词可写成：

<pre v-pre><code>清晨的{{scene}}，镜头{{camera}}，{{subject}}沿通道移动，蓝白色工业建筑，光线自然，运动稳定。</code></pre>

提示词是当前面板明确标注不能为空的字段。推荐包含：

1. 主体和动作；
2. 场景、时间和光线；
3. 镜头景别与运动；
4. 画面风格和节奏；
5. 需要保持不变或避免出现的内容；
6. 开启音频时的环境声、对白或同步声音要求。

不要只写抽象形容词。把“有科技感”改为可观察的元素，例如“蓝白色厂房、冷色灯带、巡检机器人沿通道移动、镜头稳定缓慢推进”。

输出

输出字段只读：

输出	类型	说明
video	Video	模型生成的视频结果。下游节点必须接受 Video 类型。
msg	String	节点执行信息。不能只根据文本字段判断成功，应结合节点运行状态和异常输出。

当前节点配置面板没有承诺视频结果永久保存或固定 URL 有效期。重要结果应由后续流程保存到受控对象存储或业务资源库，并记录访问权限和保留策略。

异常处理

设置	当前范围或选项	说明
整体执行超时	0.1～600 秒，默认 360 秒	视频生成可能超过 2 分钟，超时值应覆盖模型排队和生成时间。
重试次数	不重试、重试 1 次、2 次或 3 次	重试可能重复产生模型调用和费用。
异常处理方式	中断流程、返回设定内容、执行异常流程	默认中断流程。

• 中断流程：节点失败后停止正常流程。
• 返回设定内容：按合法 JSON 返回兜底内容，供下游继续处理。
• 执行异常流程：进入节点异常分支，由后续节点记录、降级或通知。

启用非中断异常处理后，底层输出契约还会附加 isSuccess（Boolean）和 errorBody（Object，包含 String 类型的 errorMessage、errorCode）。普通输出区域默认只显示 video 和 msg。

提示词为空、首帧缺失、模式与模型能力不匹配等确定性错误不适合重试。只有临时网络错误、服务繁忙或短暂限流才适合有限重试。

发布前检查

当前视频生成节点没有注册独立的发布校验函数，属性面板中的即时提示不能覆盖所有配置。发布前至少检查：

1. 模式与模型能力匹配，t2v/i2v 没有选反。
2. 提示词非空，所有 <code v-pre>{{变量}}</code> 都已定义并能取得值。
3. 图文生视频已配置首帧，尾帧是否支持已通过当前模型确认。
4. 比例、分辨率、时长、固定镜头、水印和音频已用所选模型试运行。
5. 超时覆盖实际耗时，重试不会造成不可接受的重复费用。
6. 下游能处理 Video 类型、空结果和异常分支。
7. 重要视频有明确的转存、权限和保留策略。

推荐工作流

1. 先用文生视频和固定提示词完成一次单节点试运行。
2. 确认模型可用后再调整比例、分辨率、时长和镜头设置。
3. 需要画面一致性时，切换图文生视频并选择匹配的 i2v 模型。
4. 只把会随运行变化的内容抽成 String 输入变量。
5. 配置合理超时和异常流程；对临时错误设置有限重试。
6. 将生成结果转存到受控存储，再交给发布、审核或下游业务流程。

常见问题

为什么旧文档中的 Seedance 模型找不到？

模型列表已改为由当前模型工厂动态返回。应从下拉框选择当前空间可用模型，不要按旧文档硬填模型名称。

为什么切换图文生视频后模型没有自动换成 i2v？

模式和模型是独立字段。当前界面会改变比例、固定镜头、水印和参考图片区域，但不会保证自动替换模型。请手动选择带 i2v 或图片理解能力的模型。

为什么选择 1080P 后仍可能运行失败？

480P、720P、1080P 是通用前端选项，不会按模型动态裁剪。当前模型可能有更严格的时长、比例或分辨率组合限制，应以单节点试运行结果为准。

尾帧图片一定会生效吗？

不一定。当前界面提供尾帧输入，但模型是否支持首尾帧控制取决于其能力。发布前应查看模型说明并实际验证。

可以直接同步等待视频结果吗？

不建议在长链路中无条件同步等待。当前面板提示生成可能超过 2 分钟，优先使用异步调用方式，并为超时、查询状态和失败处理设计完整流程。

生成的视频会永久保存吗？

当前节点面板没有承诺永久存储或固定有效期。重要视频应由后续流程转存到受控存储。