Hunyuan 3D v3.1 Pro 文生 3D

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "hunyuan-3d/v3.1/pro/text-to-3d",
  "input": {
    "prompt": "A quiet forest under soft morning light, with natural detail.",
    "face_count": 500000,
    "enable_pbr": true,
    "generate_type": "Normal"
  }
}
'

{
  "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>"
}

使用 Hunyuan 3D v3.1 Pro 文生 3D 根据文本生成 3D 物体，可控制网格复杂度，并支持仅输出几何体。

​

模型

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

​

功能

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

​

输出选项

​

生成类型

• generate_type：可选。选择 Normal 生成带纹理的模型，或选择 Geometry 生成仅含几何体的白模。

​

面数

• face_count：可选。设置目标面数。40000 到 1500000 的整数。默认：500000。

​

高级参数

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

​

提示词

• prompt：必填。描述所需的 3D 物体。长度：1-1,024 个字符。
• 提供此参数时请使用非空字符串。

​

PBR

• enable_pbr：可选。设为 true 时在纹理模式下生成 PBR 材质。仅几何体生成优先于此设置。

​

输出文件

• 读取返回的 files 数组中的每一项。
• 模型资源为 file_type: "3d"；预览图为 file_type: "image"。
• 其他产物可能为 file_type: "other"。保留返回的纹理、材质文件和文件元数据。