内置节点参考
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" |
"3.1" |
||||
图像 |
用于生成3D模型的主要输入图像。分辨率至少为128x128像素。 | IMAGE | 是 | - |
左侧图像 |
物体左侧的可选图像，用于多视角生成。分辨率至少为128x128像素。 | IMAGE | 否 | - |
右侧图像 |
物体右侧的可选图像，用于多视角生成。分辨率至少为128x128像素。 | IMAGE | 否 | - |
背面图像 |
物体背面的可选图像，用于多视角生成。分辨率至少为128x128像素。 | IMAGE | 否 | - |
面数 |
生成3D模型的目标面数（默认值：500000）。 | INT | 是 | 3000 - 1500000 |
生成类型 |
要生成的3D模型类型。选择某个选项会显示额外的相关参数。 | DYNAMICCOMBO | 是 | "Normal" |
"LowPoly" "Geometry" | | generate_type.pbr | 启用基于物理渲染（PBR）材质生成。此参数仅在生成类型设置为"Normal"或"LowPoly"时可见（默认值：False）。 | BOOLEAN | 否 | - | | generate_type.polygon_type | 网格使用的多边形类型。此参数仅在生成类型设置为"LowPoly"时可见。 | COMBO | 否 | "triangle" "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 上编辑
Source fingerprint (SHA-256): 56ac9e55bd9bb3a5c7c46c2de1ea06921cf41c0971471f6d0b64166722705e4d
官方原文
本页来自 Comfy-Org 官方中文文档的固定版本，并转换为 xueai 静态页面。内容以官方持续更新的页面为准。