视频生成

开始

从GUI开始

参考 生成3D模型 的开始部分。

从CLI开始

使用 generate_video 工具启动视频生成任务。提交后立即返回 task_id 和占位 MP4 路径，将占位 MP4 赋值给场景中的 VideoPlayer 即可预览。生成完成后，真实视频文件会自动替换占位文件。

输入模式：

模式	参数	说明
文生视频	prompt	纯文字描述
图生视频	prompt + image_path	参考图 + 文字指导
场景转视频	场景截图 + prompt	从当前场景截图生成转场/宣传视频

⚠️ prompt 参数必须用英文，中文提示词无法正确生成。

异步流程：

1. 调用 generate_video → 返回 task_id + 占位 MP4 路径
2. 在场景中配置 VideoPlayer 并绑定占位 MP4 → 占位视频立即可预览
3. 结束当前回合，等待 <bg_task_done> 通知自动到达
4. 收到通知后，占位 MP4 被真实视频自动替换

---

模型

火山 SeeDream（SeeDance）

• 适用场景： 概念视频、动态图形、视觉特效、转场视频、宣传视频、过场动画
• 输出： 视频文件自动导入为 VideoClip，保存到 Assets/Video/
• 分辨率： 480p / 720p
• 宽高比： 16:9 / 9:16 / 1:1
• 时长： 3–15 秒
• 关键参数：
  • prompt（必填，必须英文）：视频描述
  • image_path：参考图路径（图生视频模式）
  • resolution："480p" / "720p"
  • aspect_ratio："16:9" / "9:16" / "1:1"
  • duration：视频时长（3–15 秒）

---

优化

提示词优化（⚠️ 必须英文）

• 描述动态变化："a majestic dragon flying over a medieval castle, cinematic lighting, 4K quality" > "a dragon"
• 指定镜头运动："slow zoom into..." / "panning shot of..." / "aerial view of..."
• 包含视觉细节："cinematic lighting" / "dramatic shadows" / "volumetric fog"

场景转视频工作流

• 可从当前 Unity 场景截图作为参考图生成转场/宣传视频
• 适合生成过场动画和宣传素材

分辨率与时长

• 480p：快速预览，文件小
• 720p：推荐产出质量
• 3–5 秒：转场/短视频效果
• 10–15 秒：宣传/概念视频

并行生成

• 可同时提交多个视频生成任务

---

注意事项

• ⚠️ 提示词必须用英文，中文提示词会生成错误结果；如用户用中文描述，需先翻译为英文
• ⚠️ 生成耗时 30–120 秒，工具调用立即返回，禁止轮询
• ⚠️ 视频时长有限（3–15 秒），不适合生成长视频
• ⚠️ 分辨率上限 720p，如需更高分辨率需使用其他工具链
• ⚠️ VideoPlayer 配置：生成完成后检查 VideoPlayer 的 source、clip、loop、play_on_awake 设置
• ⚠️ 输出路径：视频默认保存到 Assets/Video/（与其他类型不同，不是 Assets/TJGenerators/History/）
• ⚠️ Domain Reload：生成期间不要在磁盘写入 .cs 文件