跳至主要內容

Image Blaster / 指南

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-count40000–150000050000
--enable-pbrtrue / falsetrue
--generate-typeNormal / LowPoly / GeometryNormal
--polygon-typetriangle / quadrilateraltriangle

遊戲引擎需要更輕的網格時選 LowPoly,只想要白色幾何體時選 Geometry。

進階玩法

  • 在 nano-banana 和 gpt-image-2 之間切換圖片編輯供應商。
  • 用 image-blast-wildcard 技能在確認後執行幾乎任意 FAL 模型。
  • 給 3D 技能換 --provider,用 Meshy 替代 Hunyuan。

需要修復時,請找出對應的技能重新執行,而不是手動編輯生成檔案——Image Blaster 的技能會保持專案狀態和來源記錄一致。