> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-claude-comfy-concurrency-limits-page-s84u33.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# TripoPSeriesImageToModelNode - ComfyUI Built-in Node Documentation
> 使用 Tripo 的 P2 模型，从单张图像生成具有干净拓扑的低多边形 3D 模型。
使用 Tripo 的 P2 模型，从单张图像生成具有干净拓扑的低多边形 3D 模型。结果以三角网格（GLB）返回；当启用 `model.quad` 时，则以四边形为主的网格（FBX）返回。
## Inputs
### 通用输入
| 参数 | 描述 | 数据类型 | 必填 | 范围 |
| - | - | - | - | - |
| `model` | 要使用的 Tripo P 系列模型。选择模型后，下方会显示该模型自身的输入。 | DYNAMIC\_COMBO | 是 | `"P2"` |
### P2 输入
| 参数 | 描述 | 数据类型 | 必填 | 范围 |
| - | - | - | - | - |
| `model.image` | 用于生成模型的图像。 | 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 |
| `texture` | 基础颜色纹理分辨率：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"` |
| `enable_image_autofix` | 让 Tripo 在建模前增强低分辨率或低质量图像（默认：False）。高级设置。 | BOOLEAN | 是 | True/False |
| `texture_seed` | 纹理的种子（默认：42）。高级设置。 | INT | 是 | 0 到 2147483647 |
| `auto_size` | 通过场景变换将模型缩放到其以米为单位的真实世界尺寸，当 `model.texture` 为 `"none"` 时忽略（默认：False）。高级设置。 | BOOLEAN | 是 | True/False |
| `export_uv` | 当网格无纹理时对其进行 UV 展开。带纹理的网格始终会展开 UV（默认：True）。高级设置。 | BOOLEAN | 是 | True/False |
| `compress_geometry` | 应用 meshopt 几何压缩：文件会小很多，但 ComfyUI 的 3D 预览无法显示它们。对四边形网格忽略（默认：False）。高级设置。 | BOOLEAN | 是 | True/False |
**注意：**
* `model.image` 为必填项，且仅使用批次中的第一张图像。
* `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` 对四边形网格没有效果。
## Outputs
| 输出名称 | 描述 | 数据类型 |
| - | - | - |
| `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/TripoPSeriesImageToModelNode/zh.md)
***
**Source fingerprint (SHA-256):** `9bfad31ee00546d0603ce3273502cfc93c79e3b125941fed255866aa83f770a5`
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.