image-blaster：一张图片 5 分钟炸出完整 3D 世界的简单教程

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

先说结果。你把一张普通照片丢进image-blaster，5 分钟后手里会有三样东西：一个用高斯泼溅（Gaussian Splat）表示的静态 3D 环境（.spz），一组动态物体的 GLB 3D 模型（.glb/.obj），加上一段环境循环音和每个物体的碰撞音效（.mp3）。这不是拼贴出来的场景，而是可以走进去漫游、可以拿起来检查的完整 3D 世界。

整个流水线由 Claude 自动调度 5 个 AI 技能完成。你只提供三样输入：图片、两个 API Key、一句自然语言指令。

一条流水线分 5 个阶段，各管一件事

image-blaster 把"图变世界"拆成 5 个独立技能，全部定义在 .claude/skills/，按顺序执行：

1. image-blast-project— 建好worlds/<世界名>/目录，源图归档到source/。先搭骨架，后面每个阶段才有固定落点。
2. image-blast-uncover— 读图，挑出"能被搬走"的动态物体，写入场景描述image.json。物体清单需要你确认，这一步不花钱。
3. image-blast-plate— 把已确认的物体从图里抹掉，得到"干净底片"。底片不干净，这些物体会在环境里被重复生成一遍。
4. image-blast-world— 底片发给 World Labsmarble-1.1，产出可漫游的高斯泼溅环境。这是整个世界的地基。
5. image-blast-3d— 每个物体单独喂给 Hunyuan 3D（默认，可换 Meshy），产出独立模型。
6. image-blast-sfx— ElevenLabs SFX 生成环境循环音 + 每个物体的碰撞音。

跑起来要几步：配置 API Key 到 5 分钟出片

git clone https://gitcode.com/gh_mirrors/im/image-blaster # 克隆仓库 cd image-blaster # 进入项目根目录 curl -fsSL https://claude.ai/install.sh | bash # 安装 Claude CLI cp .env.example .env # 复制密钥模板 claude # 启动 Claude

接下来做三件事：

1. 打开.env，把WORLD_LABS_API_KEY和FAL_KEY换成你自己的。前者管 3D 环境，后者管物体建模与音效。
2. 把图片放进input/目录。
3. 对 Claude 说："blast it and confirm each step with me"。

图片分析与物体确认环节不产生费用。先看 Claude 列出的物体清单，圈定要生成 3D 模型的目标，再让它往下跑。

Claude 会逐阶段向你确认。全部跑完后，产物统一归档在worlds/<世界名>/output/：环境在world/，音效在sfx/，每个物体的模型在各自命名的子目录里。

在浏览器里实时漫游这个世界

仓库自带一个 React + Three.js 网页查看器，入口是 WorldViewer.tsx。根目录执行bun run dev即可启动，它会扫描本地worlds/目录，自动列出你生成的每一个世界：

• 侧边栏可切换不同世界，以及同一世界的多个生成版本
• 按`键隐藏全部界面，进入纯漫游模式
• 支持触屏，也可以环绕任一物体观察

查看器的光照由一张内置的 2048×1024 全景 HDRI（High Dynamic Range Image）环境贴图驱动，模型拿到的是连续反射光，不是打出来的单点灯。

模型太糊还是太重？3 个参数拨质量

Hunyuan 3D 默认产出约 5 万面、开启 PBR（Physically Based Rendering）材质的贴图模型。对细节要求高，或者想塞进游戏引擎，直接对 Claude 说参数即可：

• --face-count 40000~1500000：目标面数，越大细节越足
• --generate-type Normal / LowPoly / Geometry：贴图模型 / 低模减面 / 纯白几何体
• --enable-pbr true / false：开关 PBR 材质生成

试一句："把蝴蝶做成 150000 面、LowPoly、纯几何体。"

产物能去哪

.glb、.obj、.spz、.mp3都是标准格式，没有私有容器：拖进 Unity、Unreal、Godot 或 Blender，直接嵌入任意 Three.js 网页应用。游戏关卡概念、机器人训练场景、电影场地预勘、建筑草模，都是同一套产物。

图片进，世界出——Go full blast。

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