Skip to content

自动绑定(v2.0-20250506)

本页列出 animate_rigmodel_versionv2.0-20250506 时支持的全部参数。

骨骼与动画

以下任务会重建或改写网格几何体,输出模型不会保留输入中的骨骼绑定与动画数据:

  • 重拓扑(Remesh)
    • 格式转换(convert_model)中启用 quad,或设置 face_limit 触发重拓扑时
    • 智能低模(highpoly_to_lowpoly,含启用 quad 的情况)
  • 网格分割mesh_segmentation
  • 网格补全mesh_completion):将拆分后的部件编辑结果合并回完整模型

若模型已完成绑定或动作重定向,建议先完成全部网格编辑,再执行绑定与重定向;或在上述任务完成后重新执行绑定与重定向。

接口地址

参数

必填参数

type: 该字段必须设置为 animate_rig

original_model_task_id: 上一个模型任务的 task_id。上游任务的 model_version 需为 Turbo-v1.0-20250506v2.0-20240919 及以上。仅支持使用具有 model 输出 的任务 ID。

注意

text_to_modelimage_to_modelmultiview_to_model 的 1.x 版本任务不支持作为上游任务。

可选参数

out_format: 文件格式 text 值。仅支持 glbfbx,不传时默认 glb

model_version: 应设置为 v2.0-20250506

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

spec: text 值,指定绑定方法。可选 mixamotripo。默认值为 tripo

返回值

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