用途:Forge 3D 把一段文字提示转成带纹理、可下载的 3D 模型,零成本使用,与 three.ws/forge 网页的提示草稿使用同一免费引擎。
主要能力:通过 three.ws MCP 服务器(@three-ws/mcp-server)的 forge_free 工具调用,走 FREE 通道,无需 x402 支付、API 密钥、钱包或 $THREE。后端为 three.ws 的 POST /api/forge 流水线,运行在免费 NVIDIA NIM 通道上(Microsoft TRELLIS 文字转 3D 预览)。仅支持文字输入;NVIDIA 托管的 TRELLIS 预览不接受上传照片,图像或多视图转 3D 需改用 mesh-forge 技能。
输入参数:prompt 必填,3–1000 字符,描述单个物体或角色;TRELLIS 以约 77 字符为条件,建议开头写主体及其关键材质与颜色,例如“a friendly round robot mascot, glossy white plastic”。tier 可选,draft(快速,默认)、standard(均衡)或 high(网格最密),三者均免费,更高档位只增加耗时。
输出:glbUrl(生成的 .glb 文件持久链接,可下载或直接载入任意 glTF 查看器 / Three.js 场景)、viewerUrl(three.ws 查看链接,格式为 https://three.ws/viewer?src=<glbUrl>,可在浏览器渲染模型),以及所用质量档位和后端信息。
使用方式:读取用户描述,选择档位(默认 draft,除非要求更高保真度);调用 forge_free 传入 { prompt, tier };把 glbUrl(供下载)和 viewerUrl(可点击预览)返回给用户,并说明所用档位。若要让结果可做动画,可将 glbUrl 交给 auto-rig 技能(rig_mesh)。
适用场景与限制:每个提示只描述一个物体或角色可获得最干净的网格;需要多个物体组成的完整场景时,改用场景服务器的 compose_scene。免费档是真实生成而非占位,生成耗时从几秒(draft)到几分钟(high)不等,应如实告知等待时间,不要伪造进度。其他收费、平台或效果细节暂未提供。