Tripo -- 查询 3D 生成结果

GET

/tasks/{task_id}

cURL - 查询任务结果

# 将 {task_id} 替换为提交任务时返回的实际任务 ID
curl -X GET 'https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

{
  "request_id": "c11018a8-3f83-9591-a636-xxxxxx",
  "output": {
    "task_id": "051c7b40-b2c5-4341-aee4-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2026-04-26 14:13:14.373",
    "scheduled_time": "2026-04-26 14:13:14.419",
    "end_time": "2026-04-26 14:14:13.679",
    "results": [
      {
        "pbr_model_url": "https://openapi.cdn.tripo3d.com/xxxx.glb?auth_key=xxxx",
        "rendered_image_url": "https://openapi.cdn.tripo3d.com/xxxx.webp?auth_key=xxxx"
      }
    ]
  },
  "usage": {
    "3d_task_type": "text-to-3d",
    "count": 1,
    "texture_quality": "standard"
  }
}

轮询任务状态，任务成功后下载 3D 模型文件。

轮询策略

保存提交任务响应中的 task_id。
每 15 秒轮询本接口，直到 task_status 为 SUCCEEDED 或 FAILED。
在 30 天内通过 pbr_model_url 下载 GLB 模型文件 -- 链接过期后将无法访问。

鉴权

string

header

必填

千问云 API Key。详见获取 API Key。

路径参数

string

必填

提交任务时返回的任务 ID。

响应

200-application/json

string

请求唯一标识。联系技术支持时请提供此 ID。

object

显示子属性

string

任务 ID。提交后 24 小时内可查询。

enum<string>

任务状态流转：PENDING -> RUNNING -> SUCCEEDED 或 FAILED。手动取消为 CANCELED，过期为 UNKNOWN。

可选值：PENDING,RUNNING,SUCCEEDED,FAILED,CANCELED,UNKNOWN

string

任务提交时间（UTC+8，YYYY-MM-DD HH:mm:ss.SSS）。

string

任务开始执行时间（UTC+8，YYYY-MM-DD HH:mm:ss.SSS）。

string

任务结束时间（UTC+8）。仅在 SUCCEEDED 或 FAILED 时返回。

object[]

生成结果列表。仅在 task_status 为 SUCCEEDED 时返回。

显示子属性

string

PBR 材质模型（GLB 格式）的下载 URL。当请求参数中 pbr 为 true（默认）时返回。链接有效期 2 小时，请及时下载。

string

无贴图基础模型（GLB 格式）的下载 URL。当请求参数中 texture 和 pbr 均为 false 时返回。链接有效期 2 小时，请及时下载。

string

3D 模型预览渲染图的 URL（1 张）。链接有效期 2 小时，请及时下载。

string

错误码。仅在 task_status 为 FAILED 时返回。

string

错误信息。仅在 task_status 为 FAILED 时返回。

object

资源消耗统计。仅在 task_status 为 SUCCEEDED 时返回。

显示子属性

enum<string>

3D 模型生成任务类型。枚举值：text-to-3d（文生 3D 模型）、image-to-3d（单图生 3D 模型）、multi-image-to-3d（多图生 3D 模型）。

可选值：text-to-3d,image-to-3d,multi-image-to-3d

integer

生成的 3D 模型数量。

string

贴图质量。

​轮询策略

鉴权

路径参数

响应

轮询策略