用途:把已有的静态 GLB 模型转成可动画模型。three.ws 的自动绑定流程(Make-It-Animatable)会添加人形骨架和逐顶点蒙皮权重,使模型可摆姿势并播放动画片段。结果包含 riggedGlbUrl 和一个在浏览器中打开已绑定模型的 pose-studio 链接。
适用与不适用:绑定假设模型大致为人形(头、躯干、双臂、双腿、站立)。道具、家具和车辆无法有意义地绑定。若需从文本生成新的静态物体用 generate-3d-model;若需一次调用从文本/图像生成新的已绑定角色用 create-3d-avatar。
用法一(MCP 工具):连接 three.ws MCP 服务器后直接调用 rig_mesh,输入 {"glb_url": "<静态 GLB 的 HTTPS URL>"}。任何可访问的 GLB URL 均可,如 generate-3d-model 返回的 glbUrl、CDN 链接或自托管模型。返回 riggedGlbUrl、sourceGlbUrl、poseStudioUrl、jobId、creationId、durationMs。
用法二(托管 HTTP 端点):无需 MCP 客户端,rig_mesh 免费暴露在 https://three.ws/api/mcp-studio(无需密钥与账号),用 JSON-RPC 调用 tools/call,参数 name 为 rig_mesh、arguments 含 glb_url。structuredContent 返回绑定后的模型信息。
用法三(原始 REST 流程):先 POST https://three.ws/api/forge?action=rig 提交任务,得到 job_id;再轮询 https://three.ws/api/forge?job=<job_id>(约每 3 秒一次,预算约 180 秒),直到 status 为 done 并取得 glb_url。pose-studio 链接可自行拼接:https://three.ws/pose?src=<URL 编码后的 riggedGlbUrl>。
结果使用:把 pose-studio 链接给用户以便在浏览器中摆姿势预览;把 riggedGlbUrl 用于下载或导入,它带有人形骨架与蒙皮权重,动画片段可重定向到其上。原始网格不会被修改,sourceGlbUrl 始终有效。
错误处理:rate_limited / 429 表示绑定器繁忙,按 retryAfter 重试;not_configured / 503 表示自动绑定暂时不可用,稍后重试;rig_failed 表示模型无法绑定(通常是人形程度不足),应告知原因并建议用 create-3d-avatar 生成可绑定的角色;timeout 表示任务超出轮询预算,响应含 resumeUrl,应继续轮询而非重启任务。不要把失效或空链接当作成功,只返回任务实际产出的 riggedGlbUrl。