动作重定向

本文列出 animate_retarget 支持的全部参数。

接口地址

参数

必填参数

type: 该字段必须设置为 animate_retarget。

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: 文件格式。仅支持 glb 或 fbx，不传时默认 glb。

bake_animation: 控制输出时是否将动画烘焙进模型。默认值为 true。仅对 glb 模型可实现。

export_with_geometry: 控制输出是否包含几何信息。默认值为 true。

animation：预设动画。可选值如下：

preset:idle · preset:walk · preset:run · preset:dive · preset:climb · preset:jump · preset:slash · preset:shoot · preset:hurt · preset:fall · preset:turn · preset:quadruped:walk · preset:hexapod:walk · preset:octopod:walk · preset:serpentine:march · preset:aquatic:march

animate_in_place：bool 值，用于控制模型是否原地播放动画。默认值为 false。

animations：预设动画的 array 值，每个元素须为上方列出的预设值之一。长度不能超过 5。

animation 与 animations 必须至少设置其中一个。

返回值

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