简介
Tripo 动画重定向接口，将预设动画应用到已绑骨的 3D 模型上。
对接说明
1. 获取 API Key
1. 进入 API Key 管理 页面，单击创建 API Key。操作详情请参见 创建 API Key。
2. 创建完成后，请您务必复制并妥善保管 API Key，在后续配置到工具的流程中将会使用该信息。
说明：
每个账户的密钥都只能当前账户查询，主账户的密钥信息子账户是看不到，子账户如果需要调用接口，需要使用账户自行创建密钥信息。
如果子账户没有办法创建，可能是没有权限创建密钥，需要主账户授权，主账户登录之后点击用户列表，在对应的子账户后面选择授权，会弹出关联策略的弹窗，输入授权策略名称之后搜索，选择对应的策略点击确认。
授权策略：QcloudTokenhubFullAccess
2. 并发额度
默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
并发任务数：表示在调用对应服务的时段内最大可运行的任务数，该任务未完成时，无法提交下一个任务，该任务完成后，可提交下一个任务。
接口文档
提交 Tripo 动画重定向任务
输入参数
参数名称 | 必选 | 类型 | 参数描述 |
model | 是 | string | 模型名称，默认为：tripo-3d-animation 示例值：tripo-3d-animation |
input | 是 | string | 已绑骨模型的 id |
animation | 条件必选 | string | 单个预设动画标识符。 与 animations 互斥，只能二选一。 |
animations | 条件必选 | string[] | 多个预设动画标识符列表。 与 animation 互斥，只能二选一。 |
out_format | 否 | string | 输出格式。 glb：二进制 glTF，适用于 Web。 fbx：FBX，适用于 DCC 工具和游戏引擎。 默认值: glb |
bake_animation | 否 | boolean | 将动画烘焙到模型中。仅对 glb 输出有效。 默认值: true |
export_with_geometry | 否 | boolean | 导出时包含几何体。 默认值: true |
animate_in_place | 否 | boolean | 原地播放动画，无位移。 默认值: false |
输出参数
参数名称 | 类型 | 描述 |
id | string | 任务 id（有效期24小时）。 示例值：1315932989749215232 |
request_id | string | 唯一请求 id，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 request_id）。定位问题时需要提供该次请求的 request_id。 |
object | string | 返回对象类型。3d 任务固定返回 3d_job。 |
created_at | integer | 任务创建时间。 |
status | string | completed：任务成功，failed：任务失败，in_progress：执行中，queued：等待中。 示例值：completed |
查询 Tripo 动画重定向任务
输入参数
参数名称 | 必选 | 类型 | 描述 |
model | 是 | string | 模型名称，默认为：tripo-3d-animation 示例值：tripo-3d-animation |
id | 是 | string | 任务 id。 示例值：1357237233311637504 |
输出参数
参数名称 | 类型 | 描述 |
status | string | completed：任务成功，failed：任务失败，in_progress：执行中，queued：等待中。 示例值：completed |
request_id | string | 唯一请求 id，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 request_id）。定位问题时需要提供该次请求的 request_id。 |
output | object | 输出结果（TripoResult，任务完成时返回） |
output.model_url | string | 模型下载 URL |
input | string | 输入参数回显 |
object | string | 返回对象类型。3d 任务固定返回 3d_job。 |
created_at | integer | 任务创建时间。 |
completed_at | integer | 任务完成时间。 |
示例
提交 Tripo 动画重定向任务
输入示例
curl -X POST 'https://tokenhub.tencentmaas.com/v1/api/3d/submit' \\-H 'Authorization: Bearer YOUR_API_KEY' \\-H 'Content-Type: application/json' \\-H 'Accept: */*' \\-H 'Connection: keep-alive' \\-d '{"model": "tripo-3d-animation","input": "ID","animation": "preset:walk"}'
输出示例
{"id": "14721*****320","request_id": "11f64379-bb0b-46b2-b89f-17d75fc12365","object": "3d_job","created_at": 1784885898,"status": "queued"}
查询 Tripo 动画重定向任务
输入示例
curl -X POST 'https://tokenhub.tencentmaas.com/v1/api/3d/query' \\-H 'Authorization: Bearer YOUR_API_KEY' \\-H 'Content-Type: application/json' \\-H 'Connection: keep-alive' \\-d '{"model": "tripo-3d-animation","id": "14721*****320"}'
输出示例
{"status": "completed","input":"{\\"animations\\":[\\"preset:walk\\",\\"preset:run\\"],\\"out_format\\":\\"fbx\\",\\"original_model_id\\":\\"XXXXX-5f79-4bfb-9de9-XXXXX\\"}","object": "3d_job","output": {"model_url": "https://vcg-prod-1258344699.cos.ap-guangzhou.tencentcos.cn/**********12.glb"},"request_id": "XXXXX-c925-4dda-90f0-XXXXX","created_at": 1785989483,"completed_at": 1785989483}
骨骼类型说明：
Rig v2.5-20260210 — 所有骨骼类型
双足：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
Rig v1.0-20240301 — 仅双足（90+ 预设动画）
preset:biped:afraid | preset:biped:agree |
preset:biped:angry_01 | preset:biped:angry_02 |
preset:biped:angry_03 | preset:biped:basketball_shot |
preset:biped:bow | preset:biped:box_01 |
preset:biped:box_02 | preset:biped:box_03 |
preset:biped:cast_a_spell | preset:biped:cheer |
preset:biped:chop | preset:biped:clap |
preset:biped:climb | preset:biped:complain_01 |
preset:biped:complain_02 | preset:biped:cross_body_crunch |
preset:biped:crossover_dribble | preset:biped:cry |
preset:biped:dance_01 | preset:biped:dance_02 |
preset:biped:dance_03 | preset:biped:dance_04 |
preset:biped:dance_05 | preset:biped:dance_06 |
preset:biped:defeat_02 | preset:biped:defeat_03 |
preset:biped:depressed | preset:biped:dig |
preset:biped:dive | preset:biped:dribble |
preset:biped:fall | preset:biped:fire |
preset:biped:flee_01 | preset:biped:flee_02 |
preset:biped:flip | preset:biped:fold_arms |
preset:biped:football_catch | preset:biped:football_save |
preset:biped:football_pass | preset:biped:freaky |
preset:biped:frightened | preset:biped:front_kick_01 |
preset:biped:front_kick_02 | preset:biped:frustrated_01 |
preset:biped:frustrated_02 | preset:biped:golf |
preset:biped:greet_01 | preset:biped:greet_02 |
preset:biped:greet_03 | preset:biped:greet_04 |
preset:biped:heart_pose | preset:biped:hit_to_body_01 |
preset:biped:hit_to_body_02 | preset:biped:hit_to_head |
preset:biped:hit_to_side | preset:biped:hit_to_stomach |
preset:biped:hug | preset:biped:hurt |
preset:biped:idle | preset:biped:jump_down |
preset:biped:jump | preset:biped:jump_rope_01 |
preset:biped:jump_rope_02 | preset:biped:laugh_01 |
preset:biped:laugh_02 | preset:biped:lift_heavy |
preset:biped:look_around | preset:biped:make_a_call_01 |
preset:biped:make_a_call_02 | preset:biped:pitch_baseball |
preset:biped:play_mobile_game | preset:biped:play_video_game |
preset:biped:press‑up | preset:biped:run_upstairs |
preset:biped:run | preset:biped:scared_01 |
preset:biped:scared_02 | preset:biped:scratch |
preset:biped:shoot | preset:biped:shovel |
preset:biped:sing_01 | preset:biped:sing_02 |
preset:biped:sing_03 | preset:biped:sing_04 |
preset:biped:sit | preset:biped:slash |
preset:biped:sob | preset:biped:standing_relax |
preset:biped:surf | preset:biped:swagger |
preset:biped:swim | preset:biped:turn |
preset:biped:victory_celebration | preset:biped:volleyball |
preset:biped:wait | preset:biped:walk |
preset:biped:warm_up | preset:biped:wave_goodbye_01 |
preset:biped:wave_goodbye_02 | - |
