跳转到主要内容
GET
/
image3ds
/
{task_id}
3D生成结果查询接口
curl --request GET \
  --url https://geekai.co/api/v1/image3ds/{task_id} \
  --header 'Authorization: Bearer <token>'
{
  "model": "hunyuan-3d",
  "task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "task_status": "succeed",
  "data": [
    {
      "type": "OBJ,GLB,STL,USDZ,FBX,MP4",
      "url": "<string>",
      "preview_url": "<string>"
    }
  ],
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}
注:该接口用于查询3D生成任务状态和结果,仅支持异步模式的3D生成资产获取。

Authorizations

Authorization
string
header
required

API认证token

Path Parameters

task_id
string<uuid>
required

任务ID

Response

成功响应

model
string
required

使用的3D模型

Example:

"hunyuan-3d"

task_id
string<uuid>
required

任务ID(3D生成接口返回的 task_id 值)

task_status
enum<string>
required

任务状态: - pending:任务排队中 - running:任务执行中 - succeed:任务生成成功 - failed:任务生成失败

Available options:
pending,
running,
succeed,
failed
Example:

"succeed"

data
object[]

生成的3D文件列表(仅在task_status=succeed时返回)

error
object

错误信息(仅在生成失败时返回)