本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! 在 GitHub 上编辑此节点使用腾讯的 Hunyuan3D Pro API,根据一张或多张输入图像生成 3D 模型。它会处理图像,将其发送到 API,并以 GLB 和 OBJ 格式返回生成的 3D 模型文件。
输入参数
| 参数 | 数据类型 | 必填 | 取值范围 | 描述 |
|---|---|---|---|---|
model | COMBO | 是 | "3.0""3.1" | 要使用的 Hunyuan3D 模型版本。3.1 模型不支持 LowPoly 选项。 |
image | IMAGE | 是 | - | 用于生成 3D 模型的主要输入图像。 |
image_left | IMAGE | 否 | - | 用于多视角生成的可选图像,展示物体左侧。 |
image_right | IMAGE | 否 | - | 用于多视角生成的可选图像,展示物体右侧。 |
image_back | IMAGE | 否 | - | 用于多视角生成的可选图像,展示物体背面。 |
face_count | INT | 是 | 40000 - 1500000 | 生成的 3D 模型的目标面数(默认值:500000)。 |
generate_type | DYNAMICCOMBO | 是 | "Normal""LowPoly""Geometry" | 要生成的 3D 模型类型。选择某个选项会显示其相关的附加参数。 |
generate_type.pbr | BOOLEAN | 否 | - | 启用基于物理的渲染(PBR)材质生成。此参数仅在 generate_type 设置为 “Normal” 或 “LowPoly” 时可见(默认值:False)。 |
generate_type.polygon_type | COMBO | 否 | "triangle""quadrilateral" | 用于网格的多边形类型。此参数仅在 generate_type 设置为 “LowPoly” 时可见。 |
seed | INT | 是 | 0 - 2147483647 | 生成过程的种子值。种子控制节点是否应重新运行;无论种子如何,结果都是非确定性的(默认值:0)。 |
输出参数
| 输出名称 | 数据类型 | 描述 |
|---|---|---|
model_file | STRING | 用于向后兼容的遗留输出。 |
GLB | FILE3DGLB | 生成的 3D 模型,格式为 GLB(二进制 GL 传输格式)文件。 |
OBJ | FILE3DOBJ | 生成的 3D 模型,格式为 OBJ(Wavefront)文件。 |