TripoPSeriesMultiviewToModelNode - ComfyUI Built-in Node Documentation - ComfyUI

使用 Tripo 的 P2 模型，根据同一主体的多个视图生成具有干净拓扑的低多边形 3D 模型。正面视图是必需的，并且可以添加左视图、后视图和右视图中的一到三个来改善结果。模型会以三角网格（GLB）返回，或者当启用 model.quad 时，以四边形为主的网格（FBX）返回。

输入

通用输入

参数	描述	数据类型	必需	范围
`model`	要使用的 Tripo P 系列模型。选择模型后会在下方显示其各自的输入。	DYNAMIC_COMBO	是	`"P2"`

P2 输入

参数	描述	数据类型	必需	范围
`model.image`	主体的正面视图（0°）。	IMAGE	是	-
`model.image_left`	左视图（90°），主体自身的左侧。	IMAGE	否	-
`model.image_back`	背面视图（180°）。	IMAGE	否	-
`model.image_right`	右视图（270°），主体自身的右侧。	IMAGE	否	-
`quad`	在 FBX 输出上返回以四边形为主的网格，而不是在 GLB 输出上返回三角网格（默认：False）。	BOOLEAN	是	True/False
`face_limit`	目标面数。`-1` 让 Tripo 自行选择。启用 `model.quad` 时，限制为 48 到 25,000；否则为 48 到 50,000（默认：-1）。	INT	是	-1，或 48 到 50000
`纹理`	基础颜色纹理分辨率：standard 为 2K，detailed 为 4K，extreme 为 8K。`"none"` 返回无纹理网格（默认：`"standard"`）。	COMBO	是	`"standard"` `"detailed"` `"extreme"` `"none"`
`pbr`	为基础颜色添加金属度、粗糙度和法线贴图。当 `model.texture` 为 `"none"` 时忽略（默认：True）。	BOOLEAN	是	True/False
`model_seed`	几何体种子（默认：42）。	INT	是	0 到 2147483647
`texture_alignment`	匹配输入图像的颜色，或使纹理适配生成的几何体。当 `model.texture` 为 `"none"` 时忽略（默认：`"original_image"`）。高级设置。	COMBO	是	`"original_image"` `"geometry"`
`orientation`	`"align_image"` 将模型旋转到输入图像的视角。当 `model.texture` 为 `"none"` 时忽略（默认：`"default"`）。高级设置。	COMBO	是	`"default"` `"align_image"`
`texture_seed`	纹理种子（默认：42）。高级设置。	INT	是	0 到 2147483647
`auto_size`	通过其场景变换将模型缩放为其以米为单位的真实世界尺寸，当 `model.texture` 为 `"none"` 时忽略（默认：False）。高级设置。	BOOLEAN	是	True/False
`export_uv`	当网格无纹理时对其进行 UV 展开。有纹理的网格始终会展开（默认：True）。高级设置。	BOOLEAN	是	True/False
`compress_geometry`	应用 meshopt 几何压缩：文件小得多，但 ComfyUI 的 3D 预览无法显示它们。对四边形网格忽略（默认：False）。高级设置。	BOOLEAN	是	True/False

备注：

model.image 是必需的，并且还必须连接 model.image_left、model.image_back 或 model.image_right 中的至少一个；如果正面视图是唯一图像，该节点会报错。
仅使用每个批次中的第一张图像。
model.face_limit 是目标值而非硬性上限，因此结果可能包含比要求更多的面。-1 将选择权留给 Tripo。
model.quad 决定哪个输出携带网格。启用它时，模型会出现在 FBX 输出上，而 GLB 输出保持为空；禁用它时，模型会出现在 GLB 上，而 FBX 保持为空。如果连接的是空输出，该节点会报错。
model.texture、model.pbr、model.texture_seed、model.auto_size、model.texture_alignment 和 model.orientation 仅适用于有纹理的模型：当为 "none" 时，节点不发送任何纹理设置，并返回裸几何体。
model.compress_geometry 对四边形网格没有效果。

输出

输出名	描述	数据类型
`model task_id`	模型生成请求的唯一任务 ID。	MODEL_TASK_ID
`GLB`	以 GLB 格式生成的 3D 模型。启用 `model.quad` 时为空。	FILE3DGLB
`FBX`	以 FBX 格式生成的 3D 模型。仅在启用 `model.quad` 时填充。	FILE3DFBX

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

Source fingerprint (SHA-256): cea0a65ca001bc8298af9fbe2a83f592abf497987e634b0126482f3d2a18571c