一、教程简介

HunyuanWorld-Mirror 是腾讯混元团队于 2025 年 10 发布的开源 3D 世界生成模型。支持多视图图像、视频等多种输入方式，可输出点云、深度图、相机参数等多种 3D 几何预测结果。模型采用纯前馈架构，可在单张显卡上部署，处理 8-32 视图输入时，本地耗时仅 1 秒，实现秒级推理。技术架构包括多模态先验提示、通用几何预测架构和课程学习策略。通过动态先验注入机制，模型能灵活适应任意先验组合。训练时采用任务顺序、数据调度和分辨率渐进的课程学习策略，最大化泛化能力。 HunyuanWorld-Mirror 在 3D 点云重建和端到端 3DGS 重建等方面表现优异，几何精度与细节还原能力突出。相关论文成果为「WorldMirror: Universal 3D World Reconstruction with Any-Prior Prompting」。

本教程默认使用资源为单卡 RTX 5090，最低可用单卡 RTX 4090 启动使用。

二、效果展示

三、运行步骤

1. 启动容器

2. 使用步骤

若显示「Bad Gateway」，这表示模型正在初始化，由于模型较大，请等待约 2-3 分钟后刷新页面。  第一次重建大约需要 2 分钟，加载数据和显示 3D 效果可能需要一些时间。

参数选项：

• Video Sample interval：视频采样间隔。
• Reconstruction Options（not applied to 3DGS）：
  • Show Camera：是否显示 Camera 。
  • Show Mesh：是否显示 Mesh 。
  • Filter low confidence & depth/normal edges：是否过滤低置信度与深度/正常边缘。
  • Filter Sky Background：是否过滤天空背景。
• 3D Gaussian Splatting：带有 RGB 和深度视频的交互式 3D 高斯溅射可视化（可作为 PLY 下载）。
• Point Cloud/Mesh：点云。
• Depth Maps: 单视图深度估计结果（可下载为 PNG 格式）。
• Normal Maps：逐视角表面方向可视化（可下载为 PNG）。
• Camera Parameters: 估计的相机姿态和内参（可下载为 JSON）。

四、交流探讨

🖌️ 如果大家看到优质项目，欢迎后台留言推荐！另外，我们还建立了教程交流群，欢迎小伙伴们扫码备注【SD 教程】入群探讨各类技术问题、分享应用效果↓

引用信息

本项目引用信息如下：

@article{liu2025worldmirror,
  title={WorldMirror: Universal 3D World Reconstruction with Any-Prior Prompting},
  author={Liu, Yifan and Min, Zhiyuan and Wang, Zhenwei and Wu, Junta and Wang, Tengfei and Yuan, Yixuan and Luo, Yawei and Guo, Chunchao},
  journal={arXiv preprint arXiv:2510.10726},
  year={2025}
}