自动绑定(v2.5-20260210)
本页列出 animate_rig 在 model_version 为 v2.5-20260210 时支持的全部参数。
注意
v2.0-20250506 已下线,不要再传这个版本。请使用 v2.5-20260210。
绑骨数据
网格编辑和 remesh 会重建模型几何体,不会保留骨骼(绑骨)数据,包括骨骼、蒙皮权重和动画绑定。输入模型即使已经绑骨或做过重定向也一样。
| 任务 | type | 说明 |
|---|---|---|
| 网格分割 | mesh_segmentation | 将模型拆成可编辑部件 |
| 网格补全 | mesh_completion | 应用分割结果并补全所选部件 |
| 智能低模 | highpoly_to_lowpoly | 将模型 remesh 到更低面数,包括 quad=true 的四边面输出 |
| 格式转换(remesh) | convert_model | 通过 quad=true 做 remesh;无论 with_animation 如何设置,都不保留骨骼数据 |
请先完成全部网格编辑和 remesh,再运行 animate_prerigcheck → animate_rig → animate_retarget。如果必须用上述任务处理已绑骨模型,请在得到的静态网格上重新跑完整动画流程。
接口地址
参数
必填参数
type: 该字段必须设置为 animate_rig。
original_model_task_id: 上一个模型任务的 task_id。上游任务的 model_version 需为 Turbo-v1.0-20250506 或 v2.0-20240919 及以上。仅支持使用具有 model 输出 的任务 ID。
注意
text_to_model、image_to_model 和 multiview_to_model 的 1.x 版本任务不支持作为上游任务。
可选参数
out_format: 文件格式 text 值。仅支持 glb 或 fbx,不传时默认 glb。
model_version: 应设置为 v2.5-20260210。
rig_type: text 值,指定应用到模型上的骨骼类型。默认值为 biped。
spec: 指定绑骨方法。可选值为 mixamo 和 tripo,默认值为 tripo。动作重定向仅支持 tripo。
返回值
task_id: 成功提交任务后的唯一标识。