Saltar al contenido principal

Image Blaster / Guía

Inicio rápido de Image Blaster: de una imagen a un mundo 3D

Image Blaster es un conjunto de habilidades de imagen a mundo para Claude. Lee una imagen de origen, decide qué objetos merece la pena mallar, construye un entorno explorable y genera sonido ambiente y específico por objeto, normalmente en menos de cinco minutos.

Qué necesitas

Copia .env.example a .env y rellena WORLD_LABS_API_KEY y FAL_KEY.

Ejecuta un blast

  1. Abre un terminal y cd image-blaster.
  2. Ejecuta claude y comparte ambas claves de API cuando te las pida.
  3. Coloca una imagen en el directorio input/.
  4. Pídele a Claude que blast it and confirm each step with me.

Claude prepara un proyecto en worlds/<slug>, analiza la imagen de origen, confirma contigo la lista de objetos y luego genera el mundo, las mallas, la placa limpia y los efectos de sonido.

Qué sale

Por defecto, un blast de Image Blaster produce:

  • Modelos 3D (.glb, .obj) de cada objeto dinámico
  • Un Gaussian splat (.spz) del entorno estático
  • Una placa limpia con los objetos en primer plano eliminados
  • Sonido ambiente en bucle y efectos físicos específicos por objeto (.mp3)

Todo se escribe en disco bajo worlds/<slug>. Las URL de los proveedores en los sidecars JSON son solo metadatos de procedencia y reanudación, así que los recursos generados siguen funcionando sin conexión.

Míralo en el visor

Image Blaster incluye un visor de React y react-three-fiber en app/. Desde la raíz del repositorio ejecuta bun install && bun run dev y luego abre la URL que se imprime para recorrer el mundo, inspeccionar cada malla y reproducir el audio.

Ajusta las mallas

La habilidad image-blast-3d de Image Blaster pasa los parámetros de Hunyuan directamente:

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

Elige LowPoly cuando un motor de juego necesite una malla más ligera, o Geometry cuando solo quieras una pasada de geometría blanca.

Ve más allá

  • Cambia el proveedor de edición de imagen entre nano-banana y gpt-image-2.
  • Usa la habilidad image-blast-wildcard para ejecutar casi cualquier modelo de FAL tras confirmarlo.
  • Cambia --provider en la habilidad 3D para probar Meshy en lugar de Hunyuan.

Cuando algo necesite una corrección, identifica la habilidad adecuada y vuelve a ejecutarla en lugar de editar a mano los archivos generados: las habilidades de Image Blaster mantienen el estado del proyecto y la procedencia coherentes.