动作重定向
本文列出 animate_retarget 支持的全部参数。
接口地址
参数
必填参数
type: 该字段必须设置为 animate_retarget。
original_model_task_id: 上游 animate_rig 任务的 task_id。
绑骨数据
网格编辑和 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。如果必须用上述任务处理已绑骨模型，请在得到的静态网格上重新跑完整动画流程。
可选参数
out_format: 文件格式。仅支持 glb 或 fbx，不传时默认 glb。
bake_animation: 控制输出时是否将动画烘焙进模型。默认值为 true。仅对 glb 模型可实现。
export_with_geometry: 控制输出是否包含几何信息。默认值为 true。
animation：预设动画。可用值取决于上游 animate_rig 使用的绑骨模型版本。
- Rig v2.5（
v2.5-20260210）：固定白名单，共 27 个预设。下列双足移动/战斗动作名同时支持preset:<name>与preset:biped:<name>：idle、walk、run、dive、climb、jump、slash、shoot、hurt、fall、turn。preset:idle/preset:biped:idlepreset:walk/preset:biped:walkpreset:run/preset:biped:runpreset:dive/preset:biped:divepreset:climb/preset:biped:climbpreset:jump/preset:biped:jumppreset:slash/preset:biped:slashpreset:shoot/preset:biped:shootpreset:hurt/preset:biped:hurtpreset:fall/preset:biped:fallpreset:turn/preset:biped:turnpreset:quadruped:walkpreset:hexapod:walkpreset:octopod:walkpreset:serpentine:marchpreset:aquatic:march
- Rig v1.0（
v1.0-20240301）：仅双足（101 个动作名，202 个标识）。下面每个<name>同时支持preset:<name>与preset:biped:<name>（例如preset:walk与preset:biped:walk）。
双足（Biped） — 点击展开全部动作名
- afraid
- agree
- angry_01
- angry_02
- angry_03
- basketball_shot
- bow
- box_01
- box_02
- box_03
- cast_a_spell
- cheer
- chop
- clap
- climb
- complain_01
- complain_02
- cpr
- cross_body_crunch
- crossover_dribble
- cry
- dance_01
- dance_02
- dance_03
- dance_04
- dance_05
- dance_06
- defeat_02
- defeat_03
- depressed
- dig
- dive
- dribble
- fall
- fire
- flee_01
- flee_02
- flip
- fold_arms
- football_catch
- football_pass
- football_save
- freaky
- frightened
- front_kick_01
- front_kick_02
- frustrated_01
- frustrated_02
- golf
- greet_01
- greet_02
- greet_03
- greet_04
- heart_pose
- hit_to_body_01
- hit_to_body_02
- hit_to_head
- hit_to_side
- hit_to_stomach
- hug
- hurt
- idle
- jump
- jump_down
- jump_rope_01
- jump_rope_02
- laugh_01
- laugh_02
- lift_heavy
- look_around
- make_a_call_01
- make_a_call_02
- pitch_baseball
- play_mobile_game
- play_video_game
- run
- run_upstairs
- scared_01
- scared_02
- scratch
- shoot
- shovel
- sing_01
- sing_02
- sing_03
- sing_04
- sit
- slash
- sob
- standing_relax
- surf
- swagger
- swim
- turn
- victory_celebration
- volleyball
- wait
- walk
- warm_up
- wave_goodbye_01
- wave_goodbye_02
animate_in_place：bool 值，用于控制模型是否原地播放动画。默认值为 false。
animations：预设动画数组。每个元素必须是上游绑骨版本对应的预设值之一。长度不能超过 5。
animation与animations必须至少设置其中一个。
返回值
task_id: 成功提交任务后的唯一标识。