文档 /
节点说明 /
Tripo P2:多视图转模型
Tripo P2:多视图转模型
使用 Tripo 的 P2 模型,根据同一主体的多个视图生成具有干净拓扑的低多边形 3D 模型。
节点说明
TripoPSeriesMultiviewToModelNode 更新于 2026-11-12
Tripo P2:多视图转模型 - ComfyUI Built-in Node Documentation
使用 Tripo 的 P2 模型,根据同一主体的多个视图生成具有干净拓扑的低多边形 3D 模型。
使用 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