> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# TripoP1MultiviewToModelNode - ComfyUI Built-in Node Documentation

> 此节点可根据物体或角色的两到四张参考图像生成 3D 模型。

此节点可根据物体或角色的两到四张参考图像生成 3D 模型。提供正视图，再加上左视图、后视图、右视图中的任意组合，节点会将重建的主体以 GLB 网格的形式返回。

## 输入

### 通用输入

| 参数 | 描述 | 数据类型 | 必填 | 取值范围 |
| - | - | - | - | - |
| `图像` | 正视图（0°）。必填。 | IMAGE | 是 | - |
| `左侧图像` | 左视图（90°），即主体自身的左侧。 | IMAGE | 否 | - |
| `背面图像` | 后视图（180°）。 | IMAGE | 否 | - |
| `右侧图像` | 右视图（270°），即主体自身的右侧。 | IMAGE | 否 | - |
| `输出模式` | 选择要生成的模型类型。"Geometry only" 返回无贴图的网格。"Textured" 会添加颜色/PBR 贴图。 | DYNAMIC\_COMBO | 是 | "Geometry only"<br />"Textured" |
| `面数限制` | 目标面数，介于 48-20000 之间。-1 表示由 Tripo 自适应选取。（默认值：-1） | INT | 否 | -1 到 20000 |
| `模型种子` | 用于可复现模型生成的随机种子。（默认值：42） | INT | 否 | 0 到 2147483647 |
| `自动缩放` | 将输出缩放至接近真实世界米制尺寸。（默认值：False） | BOOLEAN | 否 | True<br />False |
| `导出 UV` | 在生成过程中进行 UV 展开。若只需几何体且追求更快速度，可将其关闭。（默认值：True） | BOOLEAN | 否 | True<br />False |
| `压缩几何体` | 应用 meshopt 几何压缩（EXT\_meshopt\_compression）。文件更小，但 ComfyUI 的 3D 预览无法显示它们；编辑前请先解压。（默认值：False） | BOOLEAN | 否 | True<br />False |

### Geometry only 输入

此模式下不会显示额外输入。生成的模型不带贴图返回。

### Textured 输入

当 `output_mode` 设为 `"Textured"` 时，会显示这些输入。

| 参数 | 描述 | 数据类型 | 必填 | 取值范围 |
| - | - | - | - | - |
| `pbr` | 是否包含 PBR 贴图。开启时会强制同时开启基础贴图。（默认值：True） | BOOLEAN | 是 | True<br />False |
| `texture_quality` | 贴图质量级别。`detailed` = 高清贴图，`extreme` = 8K 超清贴图。（默认值："standard"） | COMBO | 是 | "standard"<br />"detailed"<br />"extreme" |
| `texture_alignment` | 优先保证与源图像的视觉保真度，或优先与网格几何体对齐。（默认值："original\_image"） | COMBO | 是 | "original\_image"<br />"geometry" |
| `orientation` | 旋转输出以匹配源图像。仅在启用贴图时适用。（默认值："default"） | COMBO | 是 | "default"<br />"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 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TripoP1MultiviewToModelNode/zh.md)

***

**Source fingerprint (SHA-256):** `1153f74ac76603829142959844e701f3c8f16be080e3de849951cffdda322d12`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.