Tripo3D H3.1 图生 3D

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

{
  "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 H3.1 图生 3D 将参考图片转为 3D 模型，可控制几何细节、纹理和网格拓扑。

​

模型

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

​

功能

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

​

输出选项

​

面数上限

• face_limit：可选。设置面数上限。1000 到 2000000 的整数。

​

几何质量

• geometry_quality：可选。可选值：standard、detailed。默认：standard。

​

高级参数

model 和可选的 callback_url 放在请求根级。所有工作流参数（包括输出选项）都放在 input 内。 本生成工作流使用下列输入参数。使用可公开访问、带主机名的 HTTP(S) 图片 URL。

​

图片 URL

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

​

纹理

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

​

PBR

• pbr：可选。texture 为 true 时生成基于物理的渲染（PBR）材质。使用 true 或 false。

​

模型种子

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

​

纹理种子

• texture_seed：可选。设置纹理生成种子。整数。

​

纹理质量

• texture_quality：可选。可选值：standard、detailed。默认：standard。

​

自动尺寸

• auto_size：可选。控制是否自动调整模型尺寸。使用 true 或 false。

​

四边形网格

• quad：可选。请求四边形拓扑。使用 true 或 false。默认：false。

​

输出文件

• 读取返回的 files 数组中的每一项。
• 模型资源为 file_type: "3d"；预览图为 file_type: "image"。
• 其他产物可能为 file_type: "other"。保留附带资源以及可用的 label、format、content_type、file_name 和 file_size 元数据。