> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# TripoPSeriesMultiviewToModelNode - 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"`<br />`"detailed"`<br />`"extreme"`<br />`"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"`<br />`"geometry"`                          |
| `orientation`       | `"align_image"` 将模型旋转到输入图像的视角。当 `model.texture` 为 `"none"` 时忽略（默认：`"default"`）。高级设置。  | COMBO   | 是  | `"default"`<br />`"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 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TripoPSeriesMultiviewToModelNode/zh.md)

***

**Source fingerprint (SHA-256):** `cea0a65ca001bc8298af9fbe2a83f592abf497987e634b0126482f3d2a18571c`