Image Blaster 快速上手：一张图变 3D 世界

Image Blaster 是一套面向 Claude 的 image-to-world 技能集。它会读取源图，判断哪些物体值得建模，构建可探索的环境，并生成环境音和物体专属音效——通常不到五分钟。

你需要准备

• 克隆 Image Blaster 仓库
• 用 curl -fsSL https://claude.ai/install.sh | bash 安装 Claude Code
• 在 platform.worldlabs.ai 申请 World Labs API 密钥
• 在 fal.ai 申请 FAL API 密钥
• 自带的脚本和查看器需要 Node.js 和 Bun

把 .env.example 复制为 .env，填入 WORLD_LABS_API_KEY 和 FAL_KEY。

跑一次爆破

1. 打开终端并 cd image-blaster。
2. 运行 claude，按提示提供两个 API 密钥。
3. 把一张图片放进 input/ 目录。
4. 让 Claude blast it and confirm each step with me。

Claude 会在 worlds/<slug> 下建立项目，分析源图，与你确认物体清单，然后依次生成世界、网格、干净背景板和音效。

会产出什么

默认一次 Image Blaster 爆破会生成：

• 每个动态物体的 3D 模型（.glb、.obj）
• 静态环境的高斯泼溅（.spz）
• 清除前景物体后的干净背景板
• 循环环境音和物体专属物理音效（.mp3）

所有内容都会写入磁盘的 worlds/<slug> 下。随附的 JSON 文件里的提供方 URL 只是来源和续传元数据，因此生成的资源可以离线使用。

在查看器里预览

Image Blaster 在 app/ 下自带 React 与 react-three-fiber 查看器。在仓库根目录运行 bun install && bun run dev，打开打印出的地址即可漫游世界、检查每个网格并试听音频。

调整网格参数

Image Blaster 的 image-blast-3d 技能会把 Hunyuan 参数直接透传：

参数	取值	默认值
--face-count	40000–1500000	50000
--enable-pbr	true / false	true
--generate-type	Normal / LowPoly / Geometry	Normal
--polygon-type	triangle / quadrilateral	triangle

游戏引擎需要更轻的网格时选 LowPoly，只想要白色几何体时选 Geometry。

进阶玩法

• 在 nano-banana 和 gpt-image-2 之间切换图片编辑提供方。
• 用 image-blast-wildcard 技能在确认后运行几乎任意 FAL 模型。
• 给 3D 技能换 --provider，用 Meshy 替代 Hunyuan。

需要修复时，请找出对应的技能重新运行，而不是手动编辑生成文件——Image Blaster 的技能会保持项目状态和来源记录一致。