> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-recommend-assets-api.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# TencentImageToModelNode - ComfyUI Built-in Node Documentation

> Complete documentation for the TencentImageToModelNode node in ComfyUI. Learn its inputs, outputs, parameters and usage.

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TencentImageToModelNode/zh.md)

此节点使用腾讯的 Hunyuan3D Pro API，根据一张或多张输入图像生成 3D 模型。它会处理图像，将其发送到 API，并以 GLB 和 OBJ 格式返回生成的 3D 模型文件。

## 输入参数

| 参数                           | 数据类型         | 必填 | 取值范围                                          | 描述                                                                                |
| ---------------------------- | ------------ | -- | --------------------------------------------- | --------------------------------------------------------------------------------- |
| `model`                      | COMBO        | 是  | `"3.0"`<br />`"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"`<br />`"LowPoly"`<br />`"Geometry"` | 要生成的 3D 模型类型。选择某个选项会显示其相关的附加参数。                                                   |
| `generate_type.pbr`          | BOOLEAN      | 否  | -                                             | 启用基于物理的渲染（PBR）材质生成。此参数仅在 `generate_type` 设置为 "Normal" 或 "LowPoly" 时可见（默认值：False）。 |
| `generate_type.polygon_type` | COMBO        | 否  | `"triangle"`<br />`"quadrilateral"`           | 用于网格的多边形类型。此参数仅在 `generate_type` 设置为 "LowPoly" 时可见。                               |
| `seed`                       | INT          | 是  | 0 - 2147483647                                | 生成过程的种子值。种子控制节点是否应重新运行；无论种子如何，结果都是非确定性的（默认值：0）。                                   |

**注意：** 所有输入图像的最小宽度和高度必须为 128 像素。

## 输出参数

| 输出名称         | 数据类型      | 描述                                |
| ------------ | --------- | --------------------------------- |
| `model_file` | STRING    | 用于向后兼容的遗留输出。                      |
| `GLB`        | FILE3DGLB | 生成的 3D 模型，格式为 GLB（二进制 GL 传输格式）文件。 |
| `OBJ`        | FILE3DOBJ | 生成的 3D 模型，格式为 OBJ（Wavefront）文件。   |