文档 /
节点说明 /
Tripo：图像转模型（旧版）
Tripo：图像转模型（旧版）
使用 Tripo 的 API 基于单张图像同步生成 3D 模型。提供输入图像后，此节点会基于该图像创建完整的 3D 模型，并可选择控制模型版本、纹理生成、细节级别和输出格式。
节点说明
TripoImageToModelNode 更新于 2026-11-12
Tripo：图像转模型（旧版） - ComfyUI Built-in Node Documentation
使用 Tripo 的 API 基于单张图像同步生成 3D 模型。提供输入图像后，此节点会基于该图像创建完整的 3D 模型，并可选择控制模型版本、纹理生成、细节级别和输出格式。
使用 Tripo 的 API 基于单张图像同步生成 3D 模型。提供输入图像后，此节点会基于该图像创建完整的 3D 模型，并可选择控制模型版本、纹理生成、细节级别和输出格式。这是图像到模型节点的旧版实现，保留用于较旧的工作流。
输入
| 参数 | 描述 | 数据类型 | 必需 | 范围 |
|---|---|---|---|---|
图像 | 用于生成 3D 模型的输入图像。必须提供图像，否则节点会引发错误。 | IMAGE | 是 | - |
模型版本 | 用于生成的模型版本。 | COMBO | 否 | "v1.4" "v3.0" "v3.5" "v3.6" |
风格 | Tripo 已不再支持并忽略此参数。保留用于较旧的工作流。（默认值："None"） | COMBO | 否 | "None" "realistic" "cartoon" "sculpture" "low_poly" |
纹理 | 生成纹理贴图。关闭时返回裸几何体并忽略 pbr。（默认值：True） | BOOLEAN | 否 | True False |
PBR | PBR 材质贴图（基础颜色、金属度、粗糙度、法线）。需要 texture。（默认值：True） | BOOLEAN | 否 | True False |
模型种子 | 用于模型生成的随机种子。（默认值：42） | INT | 否 | 0 到 2147483647 |
朝向 | 生成模型的方向设置。（默认值："default"） | COMBO | 否 | "default" "front" "back" "left" "right" "top" "bottom" |
纹理种子 | 用于纹理生成的随机种子。（默认值：42） | INT | 否 | 0 到 2147483647 |
纹理质量 | 纹理生成的质量级别：detailed = HD 纹理，extreme = 8K 超高清纹理。（默认值："standard"） | COMBO | 否 | "standard" "detailed" "extreme" |
纹理对齐 | 纹理映射的对齐方法。（默认值："original_image"） | COMBO | 否 | "original_image" "geometry" |
面数限制 | 最大面数。-1 让 Tripo 自适应选择（v3.x 标准约 140 万面，详细约 200 万面）。Tripo 会静默限制：v2.5 为 500,000，四边形网格为 150,000。（默认值：-1） | INT | 否 | -1 到 2000000 |
四边形 | 四边形网格输出。Tripo 以 FBX 格式提供四边形网格，因此结果通过 FBX 输出，而 GLB 输出保持为空。（默认值：False） | BOOLEAN | 否 | True False |
几何质量 | 几何体生成的质量级别。（默认值："standard"） | COMBO | 否 | "standard" "detailed" |
smart_low_poly | 具有干净、手工风格拓扑的低多边形网格（500-20,000 面，四边形 500-10,000）。最适合简单主体；复杂主体可能会失败。（默认值：False） | BOOLEAN | 否 | True False |
auto_size | 将带纹理的模型缩放为其真实世界尺寸（以米为单位）。Tripo 会将尺寸存储为模型的场景变换，并在模型转换、绑定或重定向时烘焙进去；没有纹理时忽略。（默认值：True） | BOOLEAN | 否 | True False |
注意：image 是必需的；如果缺失，节点会引发 RuntimeError。当 texture 为 False 时，模型仅包含裸几何体，并且 pbr 会被强制设为 False。当启用 smart_low_poly 时，对于三角形网格，face_limit 必须在 500 到 20,000 之间；如果同时启用了 quad，则必须在 500 到 10,000 之间；如果限制无效，节点会引发 ValueError。将 face_limit 设置为 -1（默认值）时，不会向 API 发送明确的面数限制，让 Tripo 自适应选择。
输出
| 输出名称 | 描述 | 数据类型 |
|---|---|---|
模型文件 | 生成的 3D 模型文件（仅用于向后兼容）。 | STRING |
模型任务ID | 用于跟踪模型生成过程的任务 ID。 | MODEL\_TASK\_ID |
GLB | 生成的 GLB 格式 3D 模型。启用 quad 时为空。 | FILE3DGLB |
FBX | 生成的 FBX 格式 3D 模型。仅在启用 quad 时填充。 | FILE3DFBX |
本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ 在 GitHub 上编辑
Source fingerprint (SHA-256): 3b278abfd13329ee58ebab1bfeb47d32d09f4797f3d8628a35a028c3d15a7314