SuperAPI AI 工具集

generate-3d-model

设计与创作

查看项目

更新于 10-16 02:31

技能介绍

用途:把一段自然语言描述转成带纹理、可下载的GLB三维模型,运行在three.ws免费的文本转3D通道上(NVIDIA NIM / Microsoft TRELLIS),无需API密钥和账号,由平台服务端密钥承担提供方成本。结果包含两部分:可长期使用的glbUrl(下载或导入任意3D工具)和可在浏览器中渲染模型的viewer链接。

主要能力与用法:若已连接three.ws MCP服务器,可直接调用免费工具forge_free,输入{"prompt":"<描述>","tier":"draft"}。prompt为3–1000字符,先写主体,再写关键材质与颜色;免费通道按约77字符做条件化,因此把重点前置,例如“a friendly round robot mascot, glossy white plastic, big blue eyes”。tier可选draft(快速,默认)、standard或high,均免费,更高档位只是耗时更长。返回glbUrl、viewerUrl、tier、backend、durationMs。

也可不依赖MCP客户端,直接调用公开JSON-RPC端点https://three.ws/api/mcp-studio(无鉴权、无账号),用curl POST调用tools/call,name为forge_free,arguments含prompt与tier;响应structuredContent携带kind、glbUrl、viewerUrl、format、prompt。可先用{"jsonrpc":"2.0","id":1,"method":"tools/list"}发现完整免费工具集。

结果处理:把viewer链接给用户即可在浏览器旋转查看;把glbUrl用于下载或导入Blender、Unity、three.js等;若需动画,可将glbUrl交给rig-a-model技能。

适用场景:从文本生成单个物体、道具或生物。若需带骨骼的可摆姿势人形角色,用create-3d-avatar;给已有GLB加骨骼用rig-a-model。

限制:免费通道仅支持文本,不接受上传图片;图像或多视图转3D需使用reference.md中描述的定向通道。免费通道为共享资源,受按IP限流和全局容量熔断保护,遇到rate_limited/busy应遵守retryAfter秒数重试,not_configured表示通道暂时冷启动可稍后重试,lane_degraded表示结果已生成但URL不可达需重试;不要把失效或空链接当作成功,只返回调用实际产生的glbUrl。更高保真与定向通道(mesh_forge)、付费通道、原始POST /api/forge REST形式及完整错误处理见reference.md,仅在需要超出免费文本转3D路径时加载。