11.4K ·GitHub
这是什么?
image-blaster 是一套面向 Claude 的技能集,它通过调度 Claude 技能,并结合 World Labs 和 FAL 的 API,把单张图片转换成带有网格模型和音效的 3D 环境。
这是 Claude 技能还是独立应用?
主要是一个 Claude 技能:你把图片交给 Claude,它会调用外部 API 来构建 3D 场景。项目还附带了一个 React 查看器应用(位于 /app 目录),方便你预览和调整生成的结果。
我该怎么让它运行起来?
克隆仓库,然后使用随附的脚本运行查看器:'bun --cwd=app run dev' 会在本地启动它,'bun --cwd=app run build' 则生成生产构建版本;技能本身则通过 Claude 调用。
使用 World Labs 和 FAL 需要 API 密钥吗?
需要。image-blaster 会调用 World Labs 和 FAL 服务(也可以选用混元的 3D API)来生成网格和环境,因此使用前需要具备这些 API 的访问权限。
我能控制输出的网格质量和风格吗?
可以,通过参数控制:--enable-pbr 用于开启或关闭 PBR 材质(默认开启),--generate-type 可选择 Normal、LowPoly 或 Geometry-only 输出,--polygon-type 则为 LowPoly 设置三角形或四边形面。默认目标面数为 50000,远低于混元 API 的默认值 500000。
什么类型的图片效果最好?
该项目定位于电子游戏关卡概念设计、童年卧室、机器人环境、电影外景勘景和建筑效果图,本质上,任何你想转换成可探索 3D 空间的单张参考图都适用。
我能自定义查看器应用吗?
可以。从 .claudeignore 文件中删除 /app 条目后,Claude 就获得了直接编辑随附 React 查看器的权限。
为什么文中会同时提到 Hunyuan、World Labs 和 FAL?
Hunyuan 的 API 似乎被用作网格生成的后端(或与之配合使用)。文中提到其默认目标面数为 500000,远高于 image-blaster 自身的默认值 50000。
What are similar projects?
threejs-game-skills, godogen, modly, anyCreature, skills, image-to-3dlab, img2threejs, Procedura
Which topics is it in?
image-to-3d, 3d-modeling, 3d-generation, audio-generation, claude-skill, game-development, claude-skills, 3d, computer-vision, claude, agent-skills, react