Tripo：图像转模型 - ComfyUI Built-in Node Documentation

Tripo: Image to Model 节点使用 Tripo 的图像到模型服务，将单张参考图像转换为 3D 模型。

Tripo: Image to Model 节点使用 Tripo 的图像到模型服务，将单张参考图像转换为 3D 模型。它会上传图像、提交生成任务、等待任务完成，并返回生成的 3D 文件以及任务 ID。这是一个 API 节点，因此需要有效的 Comfy API 密钥。

输入

参数	描述	数据类型	必填	范围
`图像`	用于生成 3D 模型的参考图像。	IMAGE	是	—
`模型版本`	用于生成的模型版本。如果未设置，节点将回退到 Tripo 的 v3.1（20260211）版本。	COMBO	否	Tripo 模型版本列表
`纹理`	生成纹理贴图。关闭时返回裸几何体并忽略 `pbr`（默认：true）。	BOOLEAN	否	true false
`pbr`	PBR 材质贴图（基础色、金属度、粗糙度、法线）。需要启用 `texture`（默认：true）。	BOOLEAN	否	true false
`模型种子`	用于几何体生成步骤的种子（默认：42）。	INT	否	0 到 2147483647
`方向`	应用于生成模型的朝向设置（默认：DEFAULT）。	COMBO	否	Tripo 朝向选项，默认 `DEFAULT`
`纹理种子`	用于纹理生成步骤的种子（默认：42）。	INT	否	0 到 2147483647
`纹理质量`	detailed = HD 纹理，extreme = 8K Ultra 纹理（默认："standard"）。	COMBO	否	"standard" "detailed" "extreme"
`纹理对齐`	纹理在生成几何体上的对齐方式（默认："original\_image"）。	COMBO	否	"original\_image" "geometry"
`面数上限`	最大面数。-1 让 Tripo 自适应选择（v3.x standard 下约 140 万面，detailed 下约 200 万面）。Tripo 会静默限制：v2.5 为 500,000，四边面网格为 150,000（默认：-1）。	INT	否	-1 到 2000000
`四边形`	输出四边面网格。Tripo 以 FBX 形式提供四边面网格，因此结果会出现在 FBX 输出上，而 GLB 输出保持为空（默认：false）。	BOOLEAN	否	true false
`几何质量`	生成几何体的质量级别（默认："standard"）。	COMBO	否	"standard" "detailed"
`智能低模`	具有干净、手工风格拓扑的低多边形网格（500-20,000 面，四边面为 500-10,000）。最适合简单主体；复杂主体可能会失败（默认：false）。	BOOLEAN	否	true false
`自动尺寸`	将带纹理的模型缩放到其真实世界尺寸（以米为单位）。Tripo 会将该尺寸存储为模型的场景变换，并在模型转换、绑定或重定向时烘焙进去；未启用纹理时忽略（默认：true）。	BOOLEAN	否	true false

注意：

image 为必填项；如果未提供图像，节点会报错。
当启用 smart_low_poly 且 face_limit 设置为 -1 以外的值时，三角形网格的限制必须介于 500 到 20,000 之间；启用 quad 时必须介于 500 到 10,000 之间。其他值会引发错误。
当禁用 texture 时，无论 pbr 如何设置都会被强制关闭，并且 auto_size 不会产生效果。
face_limit 为 -1 时会作为“无限制”发送给 Tripo，让服务自适应选择。
节点无法返回的新的 3D 文件格式（除 GLB 或 FBX 以外的任何格式）会导致错误。

输出

输出名称	描述	数据类型
`model task_id`	生成任务的 Tripo 任务 ID。	MODEL\_TASK\_ID
`GLB`	生成的模型，以 GLB 文件形式返回。启用 `quad` 时为空。	FILE3DGLB
`FBX`	生成的模型，以 FBX 文件形式返回。仅在启用 `quad` 时填充。	FILE3DFBX

本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！在 GitHub 上编辑

Source fingerprint (SHA-256): c8c069432f67a019995b9f4dedbf5ca3f7594ae4004104277068106821189c11