用途:把文本、单张参考图或同一物体的多视角照片转成高保真带纹理的 3D GLB 模型。
主要能力:文本模式下由 IBM Granite 将提示改写为优化后的 3D 规格,FLUX 渲染参考图,再由 Microsoft TRELLIS / 腾讯 Hunyuan3D 重建网格;图像模式直接传入 image_url 重建单张参考图,跳过提示改写与文生图阶段;多视角模式传入 image_urls(1–4 个角度,如正/背/左/右),后端融合多视角,避免臆造物体背面。
使用方式:通过 three.ws MCP 服务器(@three-ws/mcp-server)的 mesh_forge 工具调用。参数包括 prompt(文本模式必填,3–1000 字符,描述单个物体;提供图像时可选作引导)、image_url(图像模式,单张参考图 http(s) 地址)、image_urls(多视角,1–4 个同一物体不同角度的 http(s) 地址,优先于 image_url)、direct(是否运行 Granite 提示改写阶段,默认 true)、aspect_ratio(文本模式参考图比例,默认 1:1,可选 4:3、3:4、16:9、9:16)。输出 glbUrl、viewerUrl(https://three.ws/viewer?src=<glbUrl>),以及融合视角数、所用后端、改写后的提示与耗时。
适用场景:需要高保真带纹理 3D 资产时;有多个角度照片时优先用多视角模式,几何最干净。可将 glbUrl 交给 auto-rig(rig_mesh)生成可动画模型。
限制:该通道为付费,每次调用 0.25 USDC(x402),未附带支付载荷会返回 PaymentRequired,此时应说明价格与充值方式而非重试。每次调用仅处理一个物体;多物体场景请用场景服务器的 compose_scene。若需免费纯文本草稿,改用 forge-3d(forge_free)。