> ## 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.

# TripoImageToModelNodeV2 - ComfyUI Built-in Node Documentation

> Tripo: Image to Model 节点使用 Tripo 的图像到模型服务，将单张参考图像转换为 3D 模型。

Tripo: Image to Model 节点使用 Tripo 的图像到模型服务，将单张参考图像转换为 3D 模型。它会上传图像、提交生成任务、等待任务完成，并返回生成的 3D 文件以及任务 ID。这是一个 API 节点，因此需要有效的 Comfy API 密钥。

## 输入

| 参数     | 描述                                                                                                                  | 数据类型    | 必填 | 范围                                        |
| ------ | ------------------------------------------------------------------------------------------------------------------- | ------- | -- | ----------------------------------------- |
| `图像`   | 用于生成 3D 模型的参考图像。                                                                                                    | IMAGE   | 是  | —                                         |
| `模型版本` | 用于生成的模型版本。如果未设置，节点将回退到 Tripo 的 v3.1（20260211）版本。                                                                    | COMBO   | 否  | Tripo 模型版本列表                              |
| `纹理`   | 生成纹理贴图。关闭时返回裸几何体并忽略 `pbr`（默认：true）。                                                                                 | BOOLEAN | 否  | true<br />false                           |
| `pbr`  | PBR 材质贴图（基础色、金属度、粗糙度、法线）。需要启用 `texture`（默认：true）。                                                                   | BOOLEAN | 否  | true<br />false                           |
| `模型种子` | 用于几何体生成步骤的种子（默认：42）。                                                                                                | INT     | 否  | 0 到 2147483647                            |
| `方向`   | 应用于生成模型的朝向设置（默认：DEFAULT）。                                                                                           | COMBO   | 否  | Tripo 朝向选项，默认 `DEFAULT`                   |
| `纹理种子` | 用于纹理生成步骤的种子（默认：42）。                                                                                                 | INT     | 否  | 0 到 2147483647                            |
| `纹理质量` | detailed = HD 纹理，extreme = 8K Ultra 纹理（默认："standard"）。                                                              | COMBO   | 否  | "standard"<br />"detailed"<br />"extreme" |
| `纹理对齐` | 纹理在生成几何体上的对齐方式（默认："original\_image"）。                                                                               | COMBO   | 否  | "original\_image"<br />"geometry"         |
| `面数上限` | 最大面数。-1 让 Tripo 自适应选择（v3.x standard 下约 140 万面，detailed 下约 200 万面）。Tripo 会静默限制：v2.5 为 500,000，四边面网格为 150,000（默认：-1）。 | INT     | 否  | -1 到 2000000                              |
| `四边形`  | 输出四边面网格。Tripo 以 FBX 形式提供四边面网格，因此结果会出现在 FBX 输出上，而 GLB 输出保持为空（默认：false）。                                              | BOOLEAN | 否  | true<br />false                           |
| `几何质量` | 生成几何体的质量级别（默认："standard"）。                                                                                          | COMBO   | 否  | "standard"<br />"detailed"                |
| `智能低模` | 具有干净、手工风格拓扑的低多边形网格（500-20,000 面，四边面为 500-10,000）。最适合简单主体；复杂主体可能会失败（默认：false）。                                       | BOOLEAN | 否  | true<br />false                           |
| `自动尺寸` | 将带纹理的模型缩放到其真实世界尺寸（以米为单位）。Tripo 会将该尺寸存储为模型的场景变换，并在模型转换、绑定或重定向时烘焙进去；未启用纹理时忽略（默认：true）。                                | BOOLEAN | 否  | true<br />false                           |

**注意：**

* `image` 为必填项；如果未提供图像，节点会报错。
* 当启用 `smart_low_poly` 且 `face_limit` 设置为 -1 以外的值时，三角形网格的限制必须介于 500 到 20,000 之间；启用 `quad` 时必须介于 500 到 10,000 之间。其他值会引发错误。
* 当禁用 `texture` 时，无论 `pbr` 如何设置都会被强制关闭，并且 `auto_size` 不会产生效果。
* `face_limit` 为 -1 时会作为“无限制”发送给 Tripo，让服务自适应选择。
* 节点无法返回的新的 3D 文件格式（除 GLB 或 FBX 以外的任何格式）会导致错误。

## 输出

| 输出名称            | 描述                                  | 数据类型            |
| --------------- | ----------------------------------- | --------------- |
| `model task_id` | 生成任务的 Tripo 任务 ID。                  | MODEL\_TASK\_ID |
| `GLB`           | 生成的模型，以 GLB 文件形式返回。启用 `quad` 时为空。   | FILE3DGLB       |
| `FBX`           | 生成的模型，以 FBX 文件形式返回。仅在启用 `quad` 时填充。 | FILE3DFBX       |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TripoImageToModelNodeV2/zh.md)

***

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