自动绑定（v1.0-20240301）

本页列出 animate_rig 在 model_version 为 v1.0-20240301 时支持的全部参数。

注意

仅适用于（且推荐用于）biped 骨骼类型。

绑骨数据

网格编辑和 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: 应设置为 v1.0-20240301。

rig_type: text 值，指定应用到模型上的骨骼类型。默认值为 biped。

spec: 指定绑骨方法。可选值为 mixamo 和 tripo，默认值为 tripo。动作重定向仅支持 tripo。

返回值

task_id: 成功提交任务后的唯一标识。