メインコンテンツへスキップ

Image Blaster / ガイド

Image Blaster クイックスタート:1枚の画像を3Dの世界に

Image Blaster は Claude 向けの image-to-world スキルセットです。元画像を読み取り、メッシュ化する価値のあるオブジェクトを判断し、探索できる環境を構築し、環境音とオブジェクト固有のサウンドを生成します — 通常5分以内です。

必要なもの

.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)
  • 前景オブジェクトを除去したクリーンプレート
  • ループする環境音とオブジェクト固有の物理SFX(.mp3)

すべて worlds/<slug> の下にディスクへ書き込まれます。JSON サイドカーのプロバイダー URL は来歴と再開のメタデータのみなので、生成アセットはオフラインでも動作し続けます。

ビューアで見る

Image Blaster は app/ に React と react-three-fiber のビューアを同梱しています。リポジトリのルートで bun install && bun run dev を実行し、表示された URL を開くと、世界を歩き、各メッシュを確認し、オーディオを再生できます。

メッシュを調整する

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 を変更して、Hunyuan の代わりに Meshy を試します。

修正が必要なときは、生成ファイルを手で編集するのではなく、適切なスキルを見つけて再実行してください — Image Blaster のスキルがプロジェクト状態と来歴の一貫性を保ちます。