Tripo-动画重定向

​

前提条件

1. 开通服务：前往千问AI平台控制台，搜索“Tripo”，找到Tripo模型卡片，单击立即开通，在弹窗内确认开通及授权。
2. 配置 API Key：获取与配置 API Key，再配置API Key到环境变量。
3. 准备前序任务：先通过Tripo-自动绑骨创建任务（spec不能为mixamo），待任务执行成功后，将其task_id传入original_model_task_id。

​

HTTP调用

​

步骤1：创建任务获取任务ID

curl --location 'https://maas.qianwenaiapi.com/api/v1/services/aigc/video-generation/3d-generation' \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "Tripo/Tripo-AnimationRetarget",
    "input": {
        "original_model_task_id": "ca51d54a-ffba-4ecc-8e42-xxxxxx"
    },
    "parameters": {
        "animations": ["preset:walk"],
        "out_format": "fbx"
    }
}'

curl --location 'https://maas.qianwenaiapi.com/api/v1/services/aigc/video-generation/3d-generation' \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "Tripo/Tripo-AnimationRetarget",
    "input": {
        "original_model_task_id": "ca51d54a-ffba-4ecc-8e42-xxxxxx"
    },
    "parameters": {
        "animations": ["preset:walk", "preset:run"],
        "out_format": "glb"
    }
}'

curl --location 'https://maas.qianwenaiapi.com/api/v1/services/aigc/video-generation/3d-generation' \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "Tripo/Tripo-AnimationRetarget",
    "input": {
        "original_model_task_id": "ca51d54a-ffba-4ecc-8e42-xxxxxx"
    },
    "parameters": {
        "animations": ["preset:quadruped:walk"]
    }
}'

{
    "output": {
        "task_status": "PENDING",
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
    },
    "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

{
    "code": "InvalidApiKey",
    "message": "No API-key provided.",
    "request_id": "7438d53d-6eb8-4596-8835-xxxxxx"
}

​

步骤2：根据任务ID查询结果

curl -X GET https://maas.qianwenaiapi.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

{
    "request_id": "36a8ae2d-e929-9315-8394-xxxxxx",
    "output": {
        "task_id": "00195645-f254-41bd-8354-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2026-10-19 12:56:48.349",
        "scheduled_time": "2026-10-19 12:56:48.399",
        "end_time": "2026-10-19 12:57:04.742",
        "results": [
            {
                "model_url": "https://openapi.cdn.tripo3d.com/xxxx/tripo_retarget_xxxx.fbx?auth_key=xxxx"
            }
        ]
    },
    "usage": {
        "3d_task_type": "animation-retarget",
        "credits_consumed": 10
    }
}

{
    "request_id": "e5d70b02-ebd3-98ce-9fe8-xxxxxx",
    "output": {
        "task_id": "86ecf553-d340-4e21-af6e-xxxxxx",
        "task_status": "FAILED",
        "code": "InvalidParameter",
        "message": "The parameter is invalid xxxxxx"
    }
}

{
    "request_id": "a4de7c32-7057-9f82-8581-xxxxxx",
    "output": {
        "task_id": "502a00b1-19d9-4839-a82f-xxxxxx",
        "task_status": "UNKNOWN"
    }
}

​

动画名称列表

​

常用动画

• preset:idle：待机
• preset:walk：行走
• preset:run：奔跑
• preset:jump：跳跃
• preset:climb：攀爬
• preset:dive：俯冲
• preset:slash：挥砍
• preset:shoot：射击
• preset:hurt：受击
• preset:fall：跌落
• preset:turn：转身

​

非人形骨骼

• 四足（quadruped）：preset:quadruped:walk、preset:quadruped:catwalk
• 水生（aquatic）：preset:aquatic:march
• 蛇形（serpentine）：preset:serpentine:march
• 六足（hexapod）：preset:hexapod:walk
• 八足（octopod）：preset:octopod:walk

​

人形骨骼

• preset:afraid、preset:agree、preset:angry_01、preset:angry_02、preset:angry_03
• preset:basketball_shot、preset:blade_wraparound_test、preset:bow、preset:box_01、preset:box_02、preset:box_03
• preset:cast_a_spell、preset:cheer、preset:chop、preset:clap、preset:climb、preset:complain_01、preset:complain_02、preset:cpr、preset:cross_body_crunch、preset:crossover_dribble、preset:cry
• preset:dance_01、preset:dance_02、preset:dance_03、preset:dance_04、preset:dance_05、preset:dance_06、preset:defeat_02、preset:defeat_03、preset:depressed、preset:dig、preset:dive、preset:dribble
• preset:fall、preset:fire、preset:flee_01、preset:flee_02、preset:flip、preset:fold_arms、preset:football_catch、preset:football_pass、preset:football_save、preset:freaky、preset:frightened、preset:front_kick_01、preset:front_kick_02、preset:frustrated_01、preset:frustrated_02
• preset:golf、preset:greet_01、preset:greet_02、preset:greet_03、preset:greet_04
• preset:heart_pose、preset:hit_to_body_01、preset:hit_to_body_02、preset:hit_to_head、preset:hit_to_side、preset:hit_to_stomach、preset:hug、preset:hurt
• preset:idle
• preset:jump、preset:jump_down、preset:jump_rope_01、preset:jump_rope_02
• preset:laugh_01、preset:laugh_02、preset:lift_heavy、preset:look_around
• preset:make_a_call_01、preset:make_a_call_02
• preset:pitch_baseball、preset:play_mobile_game、preset:play_video_game、preset:press-up
• preset:run、preset:run_upstairs
• preset:scared_01、preset:scared_02、preset:scratch、preset:shoot、preset:shovel、preset:sing_01、preset:sing_02、preset:sing_03、preset:sing_04、preset:sit、preset:slash、preset:sob、preset:standing_relax、preset:surf、preset:swagger、preset:swim、preset:sword_judgment_test
• preset:turn
• preset:victory_celebration、preset:volleyball
• preset:wait、preset:walk、preset:warm_up、preset:wave_goodbye_01、preset:wave_goodbye_02

​

错误码

​

其他接口

• 查询任务结果