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

Tripo P1: Image to Model 使用 Tripo P1 API 将单张 2D 图像转换为 3D 模型。

Tripo P1: Image to Model 使用 Tripo P1 API 将单张 2D 图像转换为 3D 模型。它针对生成低多边形、游戏就绪的网格进行了优化，并允许你在仅几何体网格或带 PBR 贴图的纹理模型之间进行选择。完成的模型以 GLB 文件形式返回。

输入

通用输入

这些参数始终可用。

参数	描述	数据类型	必需	范围
`输出模式`	选择结果类型。"Geometry only" 返回无纹理网格；"Textured" 添加颜色/PBR 贴图并显示额外的纹理设置。	DYNAMIC\_COMBO	是	`"Geometry only"` `"Textured"`
`图像`	用于生成 3D 模型的源 2D 图像。需要提供单张图像；如果未提供，节点会报错。	IMAGE	是	-
`启用图像自动修复`	对输入图像进行预处理，以获得更好的生成质量。（默认值：False）	BOOLEAN	否	True False
`面数限制`	目标面数，48-20000。-1 让 Tripo 自适应选择。（默认值：-1）	INT	否	-1 到 20000
`模型种子`	用于几何体生成的种子，以便结果可复现。（默认值：42）	INT	否	0 到 2147483647
`自动缩放`	将输出缩放至接近真实世界的米制尺寸。（默认值：False）	BOOLEAN	否	True False
`导出 UV`	在生成期间进行 UV 展开。关闭可加快仅几何体运行速度。（默认值：True）	BOOLEAN	否	True False
`压缩几何体`	应用 meshopt 几何压缩（EXT\_meshopt\_compression）。文件更小，但 ComfyUI 的 3D 预览无法显示它们；编辑前请先解压。（默认值：False）	BOOLEAN	否	True False

Geometry only 输入

没有其他参数。输出为无纹理网格。

Textured 输入

当 output_mode 设置为 "Textured" 时，这些参数会出现。

参数	描述	数据类型	必需	范围
`pbr`	包含 PBR 贴图。开启时，基础纹理也会被强制开启。（默认值：True）	BOOLEAN	是	True False
`texture_quality`	detailed = 高清纹理，extreme = 8K 超高清纹理。（默认值："standard"）	COMBO	是	`"standard"` `"detailed"` `"extreme"`
`texture_alignment`	优先考虑与源图像的视觉保真度，或与网格几何体的对齐。（默认值："original\_image"）	COMBO	是	`"original_image"` `"geometry"`
`orientation`	旋转输出以匹配源图像。仅在纹理模式下适用。（默认值："default"）	COMBO	是	`"default"` `"align_image"`
`texture_seed`	用于纹理生成的种子，以便纹理结果可复现。（默认值：42）	INT	是	0 到 2147483647

注意：当 output_mode 为 "Geometry only" 时，请求中的纹理功能会被禁用。在 "Textured" 模式下，始终会请求颜色纹理；禁用 pbr 会移除 PBR 贴图，但保留基础颜色纹理，而启用 pbr 会同时强制开启基础纹理。texture_alignment 和 orientation 仅在 "Textured" 模式下可用。

输出

输出名称	描述	数据类型
`model_file`	一个包含生成的模型文件名的字符串（`<task_id>.glb`）。仅为向后兼容而保留。	STRING
`model task_id`	Tripo API 为完成的生成任务返回的唯一任务 ID。	MODEL\_TASK\_ID
`GLB`	生成的 GLB 格式 3D 模型。	FILE3DGLB

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

Source fingerprint (SHA-256): 1369da2ef732556896bce3415e7b99023f310544b8077ea4c6b1730bec59ee99