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。
跑一次爆破
- 開啟終端機並
cd image-blaster。 - 執行
claude,按提示提供兩個 API 金鑰。 - 把一張圖片放進
input/目錄。 - 讓 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 的技能會保持專案狀態和來源記錄一致。