Zum Hauptinhalt springen

Image Blaster / Anleitung

Image Blaster Quickstart: Von einem Bild zur 3D-Welt

Image Blaster ist ein Image-to-World-Skillset für Claude. Es liest ein Ausgangsbild, entscheidet, welche Objekte sich zum Meshen lohnen, baut eine erkundbare Umgebung und erzeugt Ambient- sowie objektspezifischen Sound — meist in unter fünf Minuten.

Was du brauchst

  • Einen Klon des Image Blaster-Repositoriums
  • Claude Code, installiert mit curl -fsSL https://claude.ai/install.sh | bash
  • Einen World Labs API-Schlüssel von platform.worldlabs.ai
  • Einen FAL API-Schlüssel von fal.ai
  • Node.js und Bun für die mitgelieferten Skripte und den Viewer

Kopiere .env.example nach .env und trage WORLD_LABS_API_KEY und FAL_KEY ein.

Einen Blast ausführen

  1. Öffne ein Terminal und cd image-blaster.
  2. Führe claude aus und teile beide API-Schlüssel, wenn du danach gefragt wirst.
  3. Lege ein Bild in das Verzeichnis input/.
  4. Bitte Claude: blast it and confirm each step with me.

Claude legt ein Projekt unter worlds/<slug> an, analysiert das Ausgangsbild, bestätigt die Objektliste mit dir und generiert dann die Welt, die Meshes, die Clean Plate und die Soundeffekte.

Was dabei herauskommt

Standardmäßig erzeugt ein Image Blaster-Blast:

  • 3D-Modelle (.glb, .obj) jedes dynamischen Objekts
  • Ein Gaussian Splat (.spz) der statischen Umgebung
  • Eine Clean Plate mit entfernten Vordergrundobjekten
  • Loopenden Ambient-Sound und objektspezifische Physik-SFX (.mp3)

Alles wird unter worlds/<slug> auf der Festplatte gespeichert. Anbieter-URLs in den JSON-Sidecars sind nur Herkunfts- und Fortsetzungs-Metadaten, damit die generierten Assets auch offline funktionieren.

Im Viewer ansehen

Image Blaster liefert einen React- und react-three-fiber-Viewer in app/ mit. Führe vom Repository-Stamm bun install && bun run dev aus und öffne dann die ausgegebene URL, um die Welt zu durchqueren, jedes Mesh zu inspizieren und das Audio abzuspielen.

Die Meshes abstimmen

Der image-blast-3d-Skill von Image Blaster gibt Hunyuan-Parameter direkt weiter:

ParameterWerteStandard
--face-count40000–150000050000
--enable-pbrtrue / falsetrue
--generate-typeNormal / LowPoly / GeometryNormal
--polygon-typetriangle / quadrilateraltriangle

Wähle LowPoly, wenn eine Game-Engine ein leichteres Mesh braucht, oder Geometry, wenn du nur einen weißen Geometrie-Durchlauf möchtest.

Weiter gehen

  • Wechsle den Bildedit-Anbieter zwischen nano-banana und gpt-image-2.
  • Nutze den image-blast-wildcard-Skill, um fast jedes FAL-Modell nach Bestätigung auszuführen.
  • Ändere --provider im 3D-Skill, um Meshy statt Hunyuan auszuprobieren.

Wenn etwas repariert werden muss, identifiziere den richtigen Skill und führe ihn erneut aus, statt generierte Dateien von Hand zu bearbeiten — die Skills von Image Blaster halten Projektstatus und Herkunft konsistent.