跳转到主要内容
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": [
    {
      "url": "<string>",
      "type": "OBJ，GLB，STL，USDZ，FBX，MP4",
      "preview_url": "<string>"
    }
  ],
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.geekai.co/llms.txt

Use this file to discover all available pages before exploring further.

注：该接口用于查询3D生成任务状态和结果，仅支持异步模式的3D生成资产获取。

授权

​
Authorization
string
header
必填

API认证token

路径参数

​
task_id
string<uuid>
必填

任务ID

响应

成功响应

​
model
string
必填

使用的3D模型

示例:

"hunyuan-3d"

​
task_id
string<uuid>
必填

任务ID（3D生成接口返回的 task_id 值）

​
task_status
enum<string>
必填

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

可用选项:
pending,
running,
succeed,
failed
示例:

"succeed"

​
data
object[]

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

​
error
object

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