Tripo-网格补全：查询任务结果

查询任务结果的请求参数、响应和代码示例。

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 时，响应中将包含补全后的3D模型URL。
若状态为 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 时返回。各URL均为带签名的临时链接，有效期2小时，请及时下载。

显示子属性

string

补全后3D模型的URL。

string

请求失败的错误码。请求成功时不会返回此参数，详情请参见错误码。

string

请求失败的详细信息。请求成功时不会返回此参数，详情请参见错误码。

string

请求唯一标识。可用于请求明细溯源和问题排查。

object

输出信息统计。仅在任务成功时返回，任务失败时不返回。

显示子属性

enum<string>

任务类型。网格补全固定为mesh-completion。

可选值：mesh-completion

integer

网格补全消耗的积分，按补全方式计算。

integer

本次任务消耗的积分，等于completion_mode。

string

请求失败的错误码。请求成功时不会返回此参数，详情请参见错误码。

string

请求失败的详细信息。请求成功时不会返回此参数，详情请参见错误码。