Repolode
Tencent-Hunyuan

Tencent-Hunyuan/Hunyuan-GameCraft-1.0

开源的交互式游戏视频生成模型,可根据参考图和键鼠操作生成可控的游戏风格视频。

Star
760
Fork
78
未关闭 Issue
19
最近提交
11个月前

这是什么?

Hunyuan-GameCraft 是腾讯混元推出的视频生成模型,面向交互式游戏画面。输入一张参考图、一段文本提示词,以及一串键盘或鼠标操作(如 W、A、S、D),模型即可生成跟随这些镜头运动的视频。键盘和鼠标输入会被映射到统一的相机表示空间,使各类移动之间能够平滑插值。

项目重点支持长视频延展。它采用混合历史条件训练策略,在自回归扩展视频序列的同时保留早前帧的场景信息。仓库还提供蒸馏版模型,推理步数从 50 步降至 8 步,并支持 FP8 以加快生成。

仓库包含基于 Linux 与 CUDA 的多 GPU 并行推理脚本、带 CPU 卸载的单卡低显存模式,以及基于分布式推理 API 的 Gradio 网页界面。模型权重发布在 Hugging Face 上。

核心功能

  • 01将键盘和鼠标操作映射到统一的相机空间,实现细粒度动作控制。
  • 02通过混合历史条件自回归延长视频。
  • 03提供仅需 8 步推理的蒸馏模型。
  • 04支持 FP8 优化与 SageAttention。
  • 05提供带 CPU 卸载的单卡低显存推理模式。
  • 06附带 Gradio 网页界面和分布式推理 API。

适用场景

  • 研究可由动作控制的游戏视频生成。
  • 基于单张概念图和移动输入快速原型化游戏风格片段。
  • 在多 GPU Linux 服务器上试验长时程视频延展。

快速上手

  1. 1

    克隆代码仓库

    git clone https://github.com/Tencent-Hunyuan/Hunyuan-GameCraft-1.0.git
  2. 2

    创建 conda 环境

    conda create -n HYGameCraft python==3.10
  3. 3

    安装 PyTorch 及 pip 依赖

    python -m pip install -r requirements.txt
  4. 4

    下载预训练模型权重(参见 weights/README.md)

  5. 5

    启动 Gradio 网页界面

    bash scripts/launch_app_sp.sh

使用前须知

  • 需要支持 CUDA 的 NVIDIA GPU,至少 24GB 显存,推荐 80GB。
  • 仅在 Linux 上测试过。
  • 低显存推理速度非常慢。
  • 推理时间与动作序列长度呈线性增长。

标签

常见问题

Hunyuan-GameCraft-1.0 是什么?
开源的交互式游戏视频生成模型,可根据参考图和键鼠操作生成可控的游戏风格视频。 Hunyuan-GameCraft 是腾讯混元推出的视频生成模型,面向交互式游戏画面。输入一张参考图、一段文本提示词,以及一串键盘或鼠标操作(如 W、A、S、D),模型即可生成跟随这些镜头运动的视频。键盘和鼠标输入会被映射到统一的相机表示空间,使各类移动之间能够平滑插值。
Hunyuan-GameCraft-1.0 可以免费使用吗?用的什么许可证?
Hunyuan-GameCraft-1.0 以 Other 许可证开源。用于商业产品前,请先确认许可证条款。
Hunyuan-GameCraft-1.0 还在维护吗?
超过半年未提交。Hunyuan-GameCraft-1.0 最近一次提交是在 2025年11月28日。
Hunyuan-GameCraft-1.0 适合用来做什么?
研究可由动作控制的游戏视频生成。 基于单张概念图和移动输入快速原型化游戏风格片段。 在多 GPU Linux 服务器上试验长时程视频延展。
Hunyuan-GameCraft-1.0 怎么安装和运行?
克隆代码仓库: git clone https://github.com/Tencent-Hunyuan/Hunyuan-GameCraft-1.0.git 创建 conda 环境: conda create -n HYGameCraft python==3.10 安装 PyTorch 及 pip 依赖: python -m pip install -r requirements.txt 下载预训练模型权重(参见 weights/README.md) 启动 Gradio 网页界面: bash scripts/launch_app_sp.sh
在哪里获取 Hunyuan-GameCraft-1.0?
源代码和安装说明在 GitHub 上:https://github.com/Tencent-Hunyuan/Hunyuan-GameCraft-1.0

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目