AI 视频生成

AI 视频生成 用于根据文字提示生成短视频。它属于桌面端本地内置能力，出现在指令树「常用智能能力 / AI 创作」中，适合生成演示短片、营销素材、概念视频和视觉草稿。

先选使用方式

方式	怎么用	适合人群
可视化编排（推荐）	拖入 AI 生视频，填写提示词、模型、时长和分辨率	需要快速生成视频素材的用户
代码编排（执行指令 XML）	通过「执行指令（XML）」动态调用 AIVideoGenerate	需要批量生成或动态拼接提示词的用户

什么时候用？

• 将文案、脚本或创意描述转成短视频。
• 为活动页、产品介绍、内容发布生成视频草稿。
• 在自动化流程中批量生成候选视频并保存本地路径。

使用前确认

• 已配置可用的 AI 视频生成服务。
• prompt 必填，建议描述主体、场景、动作、镜头和风格。
• 视频生成是异步任务，节点会自动轮询并下载结果。

可视化编排：从 0 到跑通

1. 在指令树「常用智能能力」中拖入 AI 生视频。
2. 在 提示词 中描述视频内容，例如：

一段 5 秒的产品展示视频，镜头缓慢推进，背景干净，光线柔和

3. 选择模型、时长和分辨率。
4. 设置输出目录，运行后在输出变量中读取 videoUrl 和 localPath。

参数说明

输入参数

界面名称	代码属性名	类型	必填	默认值	说明
提示词	prompt	String	是	-	描述视频画面、动作和风格。
模型	model	String	否	wan-ai-t2v	可选择常用模型，也可输入网关支持的新模型。
时长（秒）	duration	Number	否	模型默认	常用值为 5、10、15。
分辨率	size	String	否	模型默认	例如 1280x720、1080x1920。
输出目录	outDir	Directory	否	默认输出目录	视频下载保存的位置。
将结果保存至	outKey	Output	是	当前节点	保存生成结果，供下游引用。

输出参数

字段	类型	说明
videoUrl	String	远端生成视频 URL。
localPath	String	下载到本地的视频文件路径。
taskId	String	视频生成任务 ID。
model	String	实际使用模型。
duration	Number	请求的视频时长。
size	String	请求的视频分辨率。

成功标准

• 节点运行成功并返回 taskId。
• 输出变量中包含 videoUrl 或 localPath。
• 本地输出目录中生成可播放的视频文件。

失败排查

报错 / 现象	可能原因	处理建议
AIVideoGenerate requires "prompt"	未填写提示词	填写视频描述。
NEWAPI_API_KEY 未配置	未配置鉴权	检查桌面端环境配置。
NEWAPI_BASE_URL 未配置	未配置服务地址	配置可访问的 AI 网关地址。
未获取到 taskId	生成任务启动失败	检查模型、提示词和服务状态后重试。
长时间无结果	视频生成耗时较长或服务拥塞	缩短时长、降低分辨率或稍后重试。

代码编排

<AIVideoGenerate
  prompt="一段 5 秒的产品展示视频，镜头缓慢推进"
  model="wan-ai-t2v"
  duration="5"
  size="1280x720"
  outKey="videoResult"
/>

相关指令

• AI 图片生成
• 语音转写（ASR）