一张照片 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 依次调度:
- 搭项目骨架— 建出
worlds/<世界名>/目录,把源图收进source/ - 读图找物体— AI 识别画面里哪些是"可以搬走"的动态物体,把场景描述写进
image.json - 清理背景— 从原图中去掉已确认的物体,输出一张干净底片,免得这些物体在 3D 环境里被二次生成
- 生成环境— 把底片交给 World Labs,产出可漫游的
.spz高斯泼溅世界 - 逐物建模— 每个被确认的物体单独生成为独立 3D 模型
- 合成音效— 产出环境循环音,以及每个物体各自的碰撞音
仓库内置示例中 3D 蝴蝶模型的翅膀纹理,由这套建模流程产出
🚀 跑一遍图像转3D:5 分钟出片
git clone https://gitcode.com/gh_mirrors/im/image-blaster cd image-blaster- 在项目根目录运行
claude启动会话 - 按提示填入 World Labs 与 FAL 的 API Key
- 把你的图片放进
input/目录 - 告诉 Claude:用这张图生成世界,每步先给我看再动手
- 等待完成,产物统一收在
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-type | LowPoly 时的多边形形式 | 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),仅供参考