> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/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.

此节点使用腾讯混元3D Pro API，根据一张或多张输入图像生成3D模型。它会处理图像、发送至API，并返回生成的GLB和OBJ格式3D模型文件，以及可选的纹理贴图。

## 输入

| 参数                           | 描述                                                                | 数据类型         | 是否必填 | 范围                                            |
| ---------------------------- | ----------------------------------------------------------------- | ------------ | ---- | --------------------------------------------- |
| `模型`                         | 要使用的混元3D模型版本。`3.1`模型不支持LowPoly选项。                                 | COMBO        | 是    | `"3.0"`<br />`"3.1"`                          |
| `图像`                         | 用于生成3D模型的主要输入图像。分辨率至少为128x128像素。                                  | IMAGE        | 是    | -                                             |
| `左侧图像`                       | 物体左侧的可选图像，用于多视角生成。分辨率至少为128x128像素。                                | IMAGE        | 否    | -                                             |
| `右侧图像`                       | 物体右侧的可选图像，用于多视角生成。分辨率至少为128x128像素。                                | IMAGE        | 否    | -                                             |
| `背面图像`                       | 物体背面的可选图像，用于多视角生成。分辨率至少为128x128像素。                                | IMAGE        | 否    | -                                             |
| `面数`                         | 生成3D模型的目标面数（默认值：500000）。                                          | INT          | 是    | 3000 - 1500000                                |
| `生成类型`                       | 要生成的3D模型类型。选择某个选项会显示额外的相关参数。                                      | DYNAMICCOMBO | 是    | `"Normal"`<br />`"LowPoly"`<br />`"Geometry"` |
| `generate_type.pbr`          | 启用基于物理渲染（PBR）材质生成。此参数仅在`生成类型`设置为"Normal"或"LowPoly"时可见（默认值：False）。 | BOOLEAN      | 否    | -                                             |
| `generate_type.polygon_type` | 网格使用的多边形类型。此参数仅在`生成类型`设置为"LowPoly"时可见。                            | COMBO        | 否    | `"triangle"`<br />`"quadrilateral"`           |
| `种子`                         | 生成过程的种子值。种子控制节点是否应重新运行；无论种子如何，结果均非确定性（默认值：0）。                     | INT          | 是    | 0 - 2147483647                                |

**注意：** 所有输入图像的最小宽度和高度必须为128像素。如果图像最长边超过4900像素，则会自动缩小。

## 输出

| 输出名称                 | 描述                          | 数据类型      |
| -------------------- | --------------------------- | --------- |
| `模型文件`               | 用于向后兼容的旧版输出。                | STRING    |
| `GLB`                | 以GLB（二进制GL传输格式）文件格式生成的3D模型。 | FILE3DGLB |
| `OBJ`                | 以OBJ（Wavefront）文件格式生成的3D模型。 | FILE3DOBJ |
| `texture_image`      | 生成3D模型的纹理图像。                | IMAGE     |
| `optional_metallic`  | PBR材质的金属度贴图。若不可用则返回黑色图像。    | IMAGE     |
| `optional_normal`    | PBR材质的法线贴图。若不可用则返回黑色图像。     | IMAGE     |
| `optional_roughness` | PBR材质的粗糙度贴图。若不可用则返回黑色图像。    | IMAGE     |

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

***

**Source fingerprint (SHA-256):** `56ac9e55bd9bb3a5c7c46c2de1ea06921cf41c0971471f6d0b64166722705e4d`