☰
一张照片 5 分钟变成能走进去的 3D 世界?image-blaster 图像转3D入门指南
2026/11/4 11:12:19 网站建设 项目流程

一张照片 5 分钟变成能走进去的 3D 世界?image-blaster 图像转3D入门指南

【免费下载链接】image-blasterAn image-to-world skillset for Claude.项目地址: https://gitcode.com/gh_mirrors/im/image-blaster

image-blaster 是一个面向图像转 3D 的开源 AI 技能包:丢进一张普通照片,它会在几分钟内产出一整套能走进去逛的 3D 世界——高斯泼溅静态环境、动态物体的 3D 模型、配套环境音效,一次给齐。本文按"入门 + 使用步骤"的路子带你从零跑通图像转 3D 全流程,不需要建模或图形学背景,准备好 API Key 就能开始。

🌍 它到底在做什么

自己找建模师搭一套可漫游的 3D 环境,往往要排期好几天;而 image-blaster 把建模、环境生成、音效这几件事拆给一组 AI 模型自动完成,人只负责给图和确认。默认组合是 World Labs 的marble-1.1负责环境、Hunyuan 3D 负责物体建模、ElevenLabs SFX 负责声音。

输入关键处理输出
一张源图片读图分析 + 背景清理 + World Labs 生成.spz高斯泼溅静态环境
从图中拆出的动态物体Hunyuan 3D 逐物体建模(可换 Meshy).glb/.obj模型
场景文字描述ElevenLabs SFX 合成.mp3环境循环与碰撞音效

官方说明见 README.md,环境变量模板在 .env.example。

⚙️ 6 步流水线:一条链子怎么串起来

整个图像转 3D 流程被拆成独立技能(Skills),全部放在 .claude/skills/ 目录下,由 Claude 依次调度:

  1. 搭项目骨架— 建出worlds/<世界名>/目录,把源图收进source/
  2. 读图找物体— AI 识别画面里哪些是"可以搬走"的动态物体,把场景描述写进image.json
  3. 清理背景— 从原图中去掉已确认的物体,输出一张干净底片,免得这些物体在 3D 环境里被二次生成
  4. 生成环境— 把底片交给 World Labs,产出可漫游的.spz高斯泼溅世界
  5. 逐物建模— 每个被确认的物体单独生成为独立 3D 模型
  6. 合成音效— 产出环境循环音,以及每个物体各自的碰撞音

仓库内置示例中 3D 蝴蝶模型的翅膀纹理,由这套建模流程产出

🚀 跑一遍图像转3D:5 分钟出片

git clone https://gitcode.com/gh_mirrors/im/image-blaster cd image-blaster
  1. 在项目根目录运行claude启动会话
  2. 按提示填入 World Labs 与 FAL 的 API Key
  3. 把你的图片放进input/目录
  4. 告诉 Claude:用这张图生成世界,每步先给我看再动手
  5. 等待完成,产物统一收在worlds/<世界名>/output/下

💡 读图和物体确认阶段不产生费用——可以先让它列一遍识别到的物体,挑值得建模的再继续,省钱又省事。

🕹️ 在浏览器里打开你的世界

仓库自带一个网页查看器,技术栈是 React + Three.js,入口在 WorldViewer.tsx。根目录执行bun run dev启动后,它会扫描本地worlds/目录自动列出所有已生成的世界:

  • 侧边栏可在多个世界、同一世界的多个版本之间切换
  • 按`键隐藏全部 UI,进入纯探索模式
  • 支持触屏操作,也能环绕单个物体观察
  • 光照由内置全景环境贴图驱动,画面更接近真实场景

查看器内置的全景环境贴图,为整个 3D 世界提供光照

🎛️ 模型质量想调细?说一句话就行

默认情况下 Hunyuan 3D 会生成约 5 万面、带 PBR 材质的模型;想更精细或更轻,直接调下面这几个参数:

参数作用可选值
--face-count目标面数,越大细节越多40000 ~ 1500000
--generate-type建模输出类型Normal / LowPoly / Geometry
--enable-pbr是否生成 PBR 材质true / false
--polygon-typeLowPoly 时的多边形形式triangle / quadrilateral

用自然语言说一句"这个物体给我 10 万面、关掉 PBR",Claude 会自动翻译成对应参数,不用背命令。

📦 你还能拿它做什么

  • 🎮 游戏关卡概念预演、机器人训练场景,先跑一版能走的环境再迭代
  • 🏠 把童年卧室、现在的工位拍一张照,3D 还原出来
  • 🎬 电影场地勘察、建筑渲染草图,几分钟出可漫游版本
  • 🧩 生成的.glb/.spz可以直接塞进 Unity、Unreal、Godot、Blender,或任意 Three.js 网页项目

一张照片进,一个世界出——推门进去看看。

【免费下载链接】image-blasterAn image-to-world skillset for Claude.项目地址: https://gitcode.com/gh_mirrors/im/image-blaster

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询