Tripo3D P1 图生 3D

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "tripo3d/p1/image-to-3d",
  "input": {
    "image_urls": [
      "https://example.com/image.png"
    ],
    "texture": true
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-example",
    "status": "running",
    "created_time": "2026-09-10T08:00:00"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Request timeout

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

使用 Tripo3D P1 图生 3D 将参考图片转为 3D 物体，可选纹理并控制面数。

​

模型

• tripo3d/p1/image-to-3d - 根据图片生成 3D 模型。

​

功能

• 根据图片生成 3D 模型。
• image_urls 只接受 1 张图片。
• 从任务结果中获取模型资源，以及可用的预览图或辅助文件。

​

输出选项

​

面数上限

• face_limit：可选。设置面数上限。48 到 20000 的整数。

​

高级参数

model 和可选的 callback_url 放在请求根级。所有工作流参数（包括输出选项）都放在 input 内。 本工作流使用下列 input 字段。提供可公开访问的 HTTP(S) 图片 URL。

​

图片 URL

• image_urls：必填。提供可公开访问的图片 URL。只能提供 1 项，每项必须是 HTTP(S) URL。

​

纹理

• texture：可选。控制是否生成纹理。使用 true 或 false。默认：true。

​

模型种子

• model_seed：可选。设置模型生成种子。整数。

​

输出文件

• 读取返回的 files 数组中的每一项。
• 模型资源为 file_type: "3d"；预览图为 file_type: "image"。
• 辅助文件为 file_type: "other"。保留返回的每个文件，以及存在时的 label、format、content_type、file_name 和 file_size 元数据。
• 存在相应 label 时，使用 model_glb 文件做 3D 预览，并使用 thumbnail 文件作为封面图。