SuperAPI AI 工具集

image-to-3d

设计与创作

查看项目

更新于 10-15 23:46

技能介绍

用途:把用户提供的照片或图片转换为带纹理的 3D 模型,并导入当前 Blender 场景。当用户说“把这个做成 3D”“转成 3D”“从图片生成 3D 模型”,或提供图片并希望得到 Blender 中的 3D 对象时触发。

前提条件:需要 Meshy API Key,存于环境变量 MESHY_API_KEY 或直接传入;Blender MCP 必须已连接(blender-mcp 插件运行在 9876 端口);图片为本地路径(.jpg、.jpeg、.png)或可公开访问的 URL。

主要流程:本地图片先 base64 编码为 data URI;调用 https://api.meshy.ai/openapi/v1/image-to-3d 创建任务,请求体可含 ai_model、enable_pbr、should_remesh、should_texture、topology、target_polycount、target_formats 等参数;返回 task_id 后每 10 秒轮询任务状态,PENDING 为排队、IN_PROGRESS 为生成中、SUCCEEDED 完成、FAILED 需查看 task_error.message;完成后从 model_urls.glb 下载 GLB;最后通过 Blender MCP 的 execute_blender_code 工具执行 bpy.ops.import_scene.gltf 导入模型,并可清空场景、居中与取景。

配置选项:ai_model 默认 meshy-6,可选 meshy-5、meshy-6、latest;model_type 默认 standard,可选 lowpoly;topology 默认 triangle,可选 quad;target_polycount 默认 30000,范围 100–300000;enable_pbr 默认 true;symmetry_mode 默认 auto,可选 off、auto、on;pose_mode 可填 a-pose、t-pose 或空;should_texture 默认 true(消耗额外积分);remove_lighting 默认 true。

输出:模型导入 Blender 场景,启用 PBR 时带纹理,可用于渲染、动画或进一步编辑。

限制与错误处理:402 表示 Meshy 积分不足;429 表示限流,需等待重试;FAILED 需报告 task_error.message;Blender MCP 断开时需用户重新连接插件。其他未提供的信息暂未说明。