动画绑骨
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)。
Tripo 动画绑骨
对 3D 模型执行绑骨前检查与自动绑骨:先检查模型是否适合绑骨并获取建议骨骼类型,再选择对应的自动绑骨模型。参数遵循 Tripo 官方文档 的 snake_case 风格,平台透传。
1绑骨前检查
提交检查任务后,在查询结果中获取模型能否绑骨及建议的骨骼类型。
tripo/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 | 非类人型自动绑骨,适用于非类人型的动物绑骨(四足、六足、八足、蛇形、水生、鸟类) |
双足人形示例:
{
"model": "tripo/rig_v1.0-20240301",
"input": "https://example.com/humanoid.glb",
"rig_type": "biped",
"spec": "mixamo",
"out_format": "glb"
}
鸟类或有翼生物示例:
{
"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 可按需传入。