一、简介
Tripo 自动绑骨接口，自动为 3D 模型添加骨骼绑定。
二、1. 获取 API Key
1. 进入 API Key 管理 页面，单击创建 API Key。操作详情请参见 创建 API Key。
2. 创建完成后，请你务必复制并妥善保管 API Key，在后续配置到工具的流程中将会使用该信息。
注意：说明：
注意：每个账户的密钥都只能当前账户查询，主账户的密钥信息子账户是看不到，子账户如果需要调用接口，需要使用账户自行创建密钥信息。
注意：如果子账户没有办法创建，可能是没有权限创建密钥，需要主账户授权，主账户登录之后点击用户列表，在对应的子账户后面选择授权，会弹出关联策略的弹窗，输入授权策略名称之后搜索，选择对应的策略点击确认。
注意：授权策略：QcloudTokenhubFullAccess
三、2. 并发额度
默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
并发任务数：表示在调用对应服务的时段内最大可运行的任务数，该任务未完成时，无法提交下一个任务，该任务完成后，可提交下一个任务。
四、提交 Tripo 自动绑骨任务
输入参数
| 参数名称 | 必选 | 类型 | 参数描述 |
| model | 是 | string | 模型名称，默认为：tripo-3d-rigging示例值：tripo-3d-rigging |
| input | 是 | string | 模型 URL：可公开访问的 3D 模型文件直链。示例： https://example.com/model.glb 支持格式：GLB、GLTF、FBX、OBJ、STL最大文件大小：150 MB |
| rig_type | 否 | string | 骨骼类型。建议先调用 rig-check。biped：双足人形。quadruped：四足动物。hexapod：六足生物。octopod：八足生物。avian：鸟类/有翼生物。serpentine：蛇形生物。aquatic：鱼类/水生生物。默认值: biped |
| spec | 否 | string | 绑骨规范。tripo：Tripo 原生骨骼命名。mixamo：兼容 Mixamo 的骨骼命名。默认值: tripo |
| out_format | 否 | string | 输出格式。glb：二进制 glTF，适用于 Web。fbx：FBX，适用于 DCC 工具和游戏引擎。默认值: glb |
输出参数
| 参数名称 | 类型 | 描述 |
| 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-rigging示例值：tripo-3d-rigging |
| 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 |
| output.rendered_image_url | string | 渲染图片 URL |
| input | string | 输入参数回显 |
| object | string | 返回对象类型。3d 任务固定返回 3d_job。 |
| created_at | integer | 任务创建时间。 |
| completed_at | integer | 任务完成时间。 |
| credits_consumed | number | 当前任务实际消耗的积分数。 |
六、提交 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-rigging", "input": "https://example.com/test.glb" }'
输出示例
{ "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-rigging", "id": "14721*****320" }'
输出示例
{ "status": "completed", "input":"{\\"spec\\":\\"tripo\\",\\"topology\\":\\"biped\\",\\"out_format\\":\\"glb\\",\\"original_model_id\\":\\"XXXXX-c1ac-49fb-8fe8-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", "credits_consumed": 25, "created_at": 1785989483, "completed_at": 1785989483}