---
title: "3D生成结果查询接口"
method: GET
path: "/image3ds/{task_id}"
tags: ["Image3d"]
---

# 3D生成结果查询接口

`GET /image3ds/{task_id}`

根据任务ID查询3D生成任务的状态和结果

## Path parameters

- `task_id` string, uuid, required

## Response `200`

成功响应

- object
  - `model` string, required — 使用的3D模型
  - `task_id` string, uuid, required — 任务ID（3D生成接口返回的 task_id 值）
  - `task_status` 'pending' | 'running' | 'succeed' | 'failed', required — 任务状态： - pending：任务排队中 - running：任务执行中 - succeed：任务生成成功 - failed：任务生成失败
  - `data` object[] — 生成的3D文件列表(仅在task_status=succeed时返回)
    - `type` 'OBJ，GLB，STL，USDZ，FBX，MP4' — 3D文件类型
    - `url` string, uri, required — 3D文件URL
    - `preview_url` string, uri — 3D预览图URL
  - `error` object — 错误信息(仅在生成失败时返回)
    - `code` string — 错误代码
    - `message` string — 错误描述
    - `details` object — 详细错误信息

## Other responses

- `400` — 参数验证错误
- `401` — 未授权
- `404` — 任务不存在
- `500` — 标准错误响应

---

[API](https://skmtc.dev/geekai/apis/api.md) · [All operations](https://skmtc.dev/geekai/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/geekai/api/revisions/2bf0c8f70a39/schema)