SuperAPI AI 工具集

auto-rig

设计与创作

查看项目

更新于 10-16 02:32

技能介绍

用途:让 3D 模型具备动画能力。提供两条路径,取决于是否已有网格。两个工具均位于 three.ws MCP 服务器(@three-ws/mcp-server)。

主要能力:

  1. rig_mesh($0.20 USDC):为静态 GLB 自动绑定,通过 three.ws 绑定管线(默认 Make-It-Animatable)添加人形骨骼与逐顶点蒙皮权重。必填参数 glb_url,为静态 GLB 的 http(s) 地址,例如 forge-3d(forge_free)、mesh-forge 或 text-to-avatar 返回的 glbUrl。返回绑定后的 glbUrl 与 three.ws 姿态工作室链接(https://three.ws/forge?action=rig...),模型可播放标准 idle/walk 动画库。
  2. forge_avatar($0.45 USDC):一次调用完成文本/图片到已绑定角色。串联 Granite 提示词导演 → FLUX + TRELLIS/Hunyuan3D 网格 → Make-It-Animatable 自动绑定,模型可直接载入姿态工作室。参数:prompt 与 image_url/image_urls 二选一(prompt 为单个人形角色描述;image_urls 支持单图或 1–4 个角度提升重建保真度);direct 可选,默认 true,控制是否运行 Granite 提示词导演阶段(文本模式);aspect_ratio 可选,默认 3:4 竖版,适合全身人物;allow_non_humanoid 默认关闭,明显非人形主体(家具、车辆、四足动物)会被拒绝且不收费,仅在强制绑定时设为 true。返回绑定后的 glbUrl、中间网格 URL、姿态工作室链接、导演后的提示词及各阶段耗时;未产出绑定角色则不收费。

使用方式:先判断是否已有 GLB——已有则用 rig_mesh,仅从提示词或照片开始则用 forge_avatar。两者均通过 x402 付费;遇到 PaymentRequired 结果时应展示价格与充值路径,不要盲目重试。forge_avatar 若因人形门槛拒绝非角色提示词(不收费),可建议改用 mesh-forge 或 forge-3d 处理该物体。最后返回绑定 glbUrl 与姿态工作室链接供预览。

限制:绑定输出驱动 three.ws 标准动画片段库,任何人形骨骼都会被重定向(无固定绑定白名单)。x402 以 USDC 结算,$THREE 是平台唯一代币。其他平台支持、免费额度或具体效果资料暂未提供。