用途:把同一物体的1-4张不同角度照片(如产品、角色、物件的前后左右视图)转换为带纹理的3D模型,并导入当前 Blender 场景。相比单图转3D,多角度输入可获得更准确的几何与纹理。
主要能力:调用 Meshy AI 的 multi-image-to-3D 接口创建任务,支持 meshy-5、meshy-6 等模型;可配置拓扑(quad/triangle)、目标面数(100–300,000)、PBR 贴图、对称模式、姿态模式、是否生成纹理、是否重网格、去除烘焙光照、图像增强,以及输出格式(glb、obj、fbx、stl、usdz、3mf)。
使用方式:需准备 Meshy API Key(从记忆文件 reference_meshy_api.md 获取)并连接 Blender MCP(blender-mcp 插件运行在 9876 端口)。图片为1-4个本地路径(.jpg/.jpeg/.png)或公开URL,且必须为同一物体。流程:将本地图片 base64 编码为 data URI;把 payload 写入 JSON 文件后 POST 到 https://api.meshy.ai/openapi/v1/multi-image-to-3d;每15秒轮询任务状态(PENDING、IN_PROGRESS、SUCCEEDED、FAILED);成功后从 model_urls.glb 下载 GLB;再用 Blender MCP 的 execute_blender_code 导入并可选清理场景、添加灯光、切换材质预览。
适用场景:用户提供同一物体多角度照片并希望生成3D模型,或明确要求“多角度3D”“把这些图片转成3D”“用这些照片做3D模型”,以及需要比单图更准确结果时。
限制:图片数量必须为1-4张且为同一物体;需有效 Meshy 额度和 API Key;需 Blender MCP 连接。错误处理:400 表示图片数量、格式或URL无效;402 表示 Meshy 额度不足;429 表示限流需重试;任务 FAILED 时需向用户报告 task_error.message。最佳效果建议使用不同角度、一致光照、干净背景,2-4张图片,超过4张收益递减。