胜算云 胜算云 文档中心 ↗ 精益社区

动画绑骨

tripo/rig — 检查模型能否绑骨并获取建议骨骼类型(tripo/rig-check);按骨骼类型自动绑骨:人形 biped 用 tripo/rig_v1.0-20240301,非类人型用 tripo/rig_v2.5-20260210。
异步任务:POST /v1/tasks/generations 提交 → GET /v1/tasks/generations/{request_id} 轮询结果(POST 发送后 request_id 自动填入 GET)。

BASE URLhttps://router.shengsuanyun.com/api
认证方式Authorization: Bearer YOUR_API_KEY
仅存 localStorage 🗝 控制台获取 Key → ✓ 已保存

Tripo 动画绑骨

对 3D 模型执行绑骨前检查与自动绑骨:先检查模型是否适合绑骨并获取建议骨骼类型,再选择对应的自动绑骨模型。参数遵循 Tripo 官方文档 的 snake_case 风格,平台透传。

统一入口 POST /v1/tasks/generations 异步任务 覆盖 3 个模型

1绑骨前检查

提交检查任务后,在查询结果中获取模型能否绑骨及建议的骨骼类型。

POST /v1/tasks/generations · tripo/rig-check 检查模型是否适合绑骨
绑骨前检查 · rig-check
{
  "model": "tripo/rig-check",
  "input": "https://example.com/model.glb"
}

input 为可公开访问的 GLB 模型文件 URL。任务完成后,查询结果中的 data.data.upstream_extra.riggable 表示能否绑骨,data.data.upstream_extra.rig_type 表示建议的骨骼类型。

⚠
检查和自动绑骨是两次独立请求——自动绑骨不会自动读取检查结果,需按建议的骨骼类型手动选择对应的绑骨模型。

2自动绑骨

按骨骼类型选择绑骨模型:tripo/rig_v1.0-20240301 或 tripo/rig_v2.5-20260210。

rig_type=biped(双足人形、类人型)选择 tripo/rig_v1.0-20240301;quadruped、hexapod、octopod、avian、serpentine、aquatic 等非类人型选择 tripo/rig_v2.5-20260210。适配器会校验模型版本与 rig_type 是否匹配,不匹配时会提示更换模型。省略 rig_type 时按上游默认值 biped 校验,因此使用非类人型版本时须显式传入 rig_type。

绑骨模型版本描述信息
tripo/rig_v1.0-20240301双足人形自动绑骨,仅适用于(且推荐用于)双足类人型绑骨
tripo/rig_v2.5-20260210非类人型自动绑骨,适用于非类人型的动物绑骨(四足、六足、八足、蛇形、水生、鸟类)

双足人形示例:

双足人形 · biped
{
  "model": "tripo/rig_v1.0-20240301",
  "input": "https://example.com/humanoid.glb",
  "rig_type": "biped",
  "spec": "mixamo",
  "out_format": "glb"
}

鸟类或有翼生物示例:

鸟类或有翼生物 · avian
{
  "model": "tripo/rig_v2.5-20260210",
  "input": "https://example.com/bird.glb",
  "rig_type": "avian",
  "out_format": "glb"
}

任务完成后,绑骨模型文件位于 data.data.file_urls。spec 和 out_format 可按需传入。

⚠
动画重定向暂不上线:该功能需要以已绑骨任务的上游 task_id 作为 input,当前尚无法据此完成端到端测试。tripo/retarget 暂不开放,待任务 ID 链路验证通过后再上线。

3官方文档参考