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/text-to-3d",
  "input": {
    "prompt": "A quiet forest under soft morning light, with natural detail.",
    "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 物体，可控制网格细节、表面质量和 PBR 材质。

​

模型

• tripo3d/h3.1/text-to-3d - 根据文本提示词生成 3D 模型。

​

功能

• 根据文本提示词生成 3D 模型。
• 从任务结果中获取模型资源，以及可用的预览图或辅助文件。

​

输出选项

​

面数上限

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

​

几何质量

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

​

高级参数

model 和可选的 callback_url 放在请求根级。所有工作流参数（包括输出选项）都放在 input 内。 本生成工作流使用下列输入参数。

​

提示词

• prompt：必填。描述所需的 3D 物体。长度：1-1,024 个字符。

​

负面提示词

• negative_prompt：可选。描述要避免的内容。最大长度：1,024 个字符。

​

纹理

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

​

PBR

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

​

模型种子

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

​

图片种子

• image_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 元数据。