TripoImageToModelNode - ComfyUI Built-in Node Documentation - ComfyUI

使用 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