文档 /
节点说明 /
Tripo P1:多视图转模型
Tripo P1:多视图转模型
此节点可根据物体或角色的两到四张参考图像生成 3D 模型。提供正视图,再加上左视图、后视图、右视图中的任意组合,节点会将重建的主体以 GLB 网格的形式返回。
节点说明
TripoP1MultiviewToModelNode 更新于 2026-11-12
Tripo P1:多视图转模型 - ComfyUI Built-in Node Documentation
此节点可根据物体或角色的两到四张参考图像生成 3D 模型。提供正视图,再加上左视图、后视图、右视图中的任意组合,节点会将重建的主体以 GLB 网格的形式返回。
此节点可根据物体或角色的两到四张参考图像生成 3D 模型。提供正视图,再加上左视图、后视图、右视图中的任意组合,节点会将重建的主体以 GLB 网格的形式返回。
输入
通用输入
| 参数 | 描述 | 数据类型 | 必填 | 取值范围 |
|---|---|---|---|---|
图像 | 正视图(0°)。必填。 | IMAGE | 是 | - |
左侧图像 | 左视图(90°),即主体自身的左侧。 | IMAGE | 否 | - |
背面图像 | 后视图(180°)。 | IMAGE | 否 | - |
右侧图像 | 右视图(270°),即主体自身的右侧。 | IMAGE | 否 | - |
输出模式 | 选择要生成的模型类型。"Geometry only" 返回无贴图的网格。"Textured" 会添加颜色/PBR 贴图。 | DYNAMIC\_COMBO | 是 | "Geometry only" "Textured" |
面数限制 | 目标面数,介于 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 |
注意: 至少需要提供 2 张图像:正视图(image)加上其他视图(image_left、image_back 或 image_right)中的至少一张。如果提供的图像少于 2 张,节点将报错。
输出
| 输出名 | 描述 | 数据类型 |
|---|---|---|
模型文件 | 生成的 GLB 模型的文件名(仅为向后兼容而保留)。 | STRING |
模型任务 ID | 此次模型生成请求的唯一任务 ID。 | MODEL\_TASK\_ID |
GLB | 生成的 GLB 格式 3D 模型。 | FILE3DGLB |
本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! 在 GitHub 上编辑
Source fingerprint (SHA-256): 1153f74ac76603829142959844e701f3c8f16be080e3de849951cffdda322d12