Перейти к основному содержимому

Image Blaster / Руководство

Image Blaster: быстрый старт — одно изображение в 3D-мир

Image Blaster — это набор навыков «изображение в мир» для Claude. Он читает исходное изображение, решает, какие объекты стоит превратить в меш, строит исследуемое окружение и генерирует фоновый звук и звуки для конкретных объектов — обычно менее чем за пять минут.

Что вам понадобится

  • Клон репозитория Image Blaster
  • Claude Code, установленный командой curl -fsSL https://claude.ai/install.sh | bash
  • API-ключ World Labs из platform.worldlabs.ai
  • API-ключ FAL из fal.ai
  • 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>. URL провайдеров в сопутствующих JSON-файлах служат только для указания происхождения и возобновления, поэтому сгенерированные ресурсы продолжают работать офлайн.

Просмотр в просмотрщике

Image Blaster поставляет просмотрщик на React и react-three-fiber в app/. Из корня репозитория выполните bun install && bun run dev, затем откройте выведенный URL, чтобы ходить по миру, осматривать каждый меш и слушать звук.

Настройка мешей

Навык image-blast-3d из Image Blaster передаёт параметры 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 после подтверждения.
  • Измените --provider в навыке 3D, чтобы попробовать Meshy вместо Hunyuan.

Когда что-то нужно исправить, определите подходящий навык и запустите его заново, а не правьте сгенерированные файлы вручную — навыки Image Blaster поддерживают согласованность состояния проекта и происхождения.