GET
/api/v1/tasks/{task_id}
复制
curl -X GET https://maas.qianwenaiapi.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"复制
{
"output": {
"task_status": "PENDING",
"task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
},
"request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}完整调用流程、参数说明和示例见Tripo-可绑骨检查。
鉴权
string
header
必填
路径参数
string
必填
任务 ID,使用提交任务返回的 task_id。
响应
200-application/json
object
任务输出信息。
显示子属性
显示子属性
string
任务状态。
任务状态。
- PENDING:任务排队中
- RUNNING:任务处理中
- SUCCEEDED:任务执行成功
- FAILED:任务执行失败
- CANCELED:任务已取消
- UNKNOWN:任务不存在或状态未知
任务状态。
- PENDING:任务排队中
- RUNNING:任务处理中
- SUCCEEDED:任务执行成功
- FAILED:任务执行失败
- CANCELED:任务已取消
- UNKNOWN:任务不存在或状态未知 轮询过程中的状态流转:
- PENDING(排队中) → RUNNING(处理中)→ SUCCEEDED(成功)/ FAILED(失败)。
- 初次查询状态通常为 PENDING(排队中)或 RUNNING(处理中)。
- 当状态变为 SUCCEEDED 时,响应中将包含检查结果。
- 若状态为 FAILED,请检查错误信息并重试。
- 若状态为 CANCELED,表示任务已取消,如需继续请重新提交任务。
- 若状态为 UNKNOWN,表示任务不存在或状态未知,可能在 task_id 不存在或超过 24 小时有效期后出现。
string
任务ID。查询有效期24小时。
string
任务提交时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。
string
任务执行时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。
string
任务完成时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。
object[]
检查结果列表。仅在 task_status 为 SUCCEEDED 时返回。
显示子属性
显示子属性
string
推荐的骨骼类型,可作为Tripo-自动绑骨的rig_type参数值。
根据模型形态识别得出,无论模型能否绑骨都会返回。能否绑骨以riggable为准,riggable为false时此值仅供参考,不代表可以按该类型绑骨。
可能的值:
biped:双足人形。quadruped:四足动物。hexapod:六足生物。octopod:八足生物。avian:鸟类或有翼生物。serpentine:蛇形生物。aquatic:鱼类或水生生物。
推荐的骨骼类型,可作为Tripo-自动绑骨的rig_type参数值。 根据模型形态识别得出,无论模型能否绑骨都会返回。能否绑骨以riggable为准,riggable为false时此值仅供参考,不代表可以按该类型绑骨。 可能的值:
biped:双足人形。quadruped:四足动物。hexapod:六足生物。octopod:八足生物。avian:鸟类或有翼生物。serpentine:蛇形生物。aquatic:鱼类或水生生物。
boolean
模型是否可绑骨。
string
请求唯一标识。可用于请求明细溯源和问题排查。
object