> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-comfy-docs-comfyapi-search.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`