Hunyuan 3D v3.1 Rapid 图生 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/rapid/image-to-3d",
  "input": {
    "image_urls": [
      "https://example.com/image.png"
    ],
    "enable_pbr": true,
    "enable_geometry": 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>"
}

使用 Hunyuan 3D v3.1 Rapid 图生 3D 根据参考图片生成 3D 模型，支持可选的文本引导和几何体生成。

​

模型

• hunyuan-3d/v3.1/rapid/image-to-3d - 根据图片生成 3D 模型。

​

功能

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

​

输出选项

​

启用几何体模式

• enable_geometry：可选。设为 true 生成仅含几何体的白模，设为 false 生成带纹理的模型。

​

高级参数

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

​

提示词

• prompt：可选。描述所需的 3D 物体。最小长度：1 个字符。
• 提供此参数时请使用非空字符串。

​

图片 URL

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

​

PBR

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

​

输出文件

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