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

# TripoImageToModelNode - ComfyUI Built-in Node Documentation

> 使用 Tripo 的 API 基于单张图像同步生成 3D 模型。

使用 Tripo 的 API 基于单张图像同步生成 3D 模型。提供输入图像后，此节点会基于该图像创建完整的 3D 模型，并可选择控制模型版本、纹理生成、细节级别和输出格式。这是图像到模型节点的旧版实现，保留用于较旧的工作流。

## 输入

| 参数               | 描述                                                                                                   | 数据类型    | 必需 | 范围                                                                                                 |
| ---------------- | ---------------------------------------------------------------------------------------------------- | ------- | -- | -------------------------------------------------------------------------------------------------- |
| `图像`             | 用于生成 3D 模型的输入图像。必须提供图像，否则节点会引发错误。                                                                    | IMAGE   | 是  | -                                                                                                  |
| `模型版本`           | 用于生成的模型版本。                                                                                           | COMBO   | 否  | `"v1.4"`<br />`"v3.0"`<br />`"v3.5"`<br />`"v3.6"`                                                 |
| `风格`             | Tripo 已不再支持并忽略此参数。保留用于较旧的工作流。（默认值：`"None"`）                                                          | COMBO   | 否  | `"None"`<br />`"realistic"`<br />`"cartoon"`<br />`"sculpture"`<br />`"low_poly"`                  |
| `纹理`             | 生成纹理贴图。关闭时返回裸几何体并忽略 `pbr`。（默认值：True）                                                                 | BOOLEAN | 否  | True<br />False                                                                                    |
| `PBR`            | PBR 材质贴图（基础颜色、金属度、粗糙度、法线）。需要 `texture`。（默认值：True）                                                    | BOOLEAN | 否  | True<br />False                                                                                    |
| `模型种子`           | 用于模型生成的随机种子。（默认值：42）                                                                                 | INT     | 否  | 0 到 2147483647                                                                                     |
| `朝向`             | 生成模型的方向设置。（默认值：`"default"`）                                                                          | COMBO   | 否  | `"default"`<br />`"front"`<br />`"back"`<br />`"left"`<br />`"right"`<br />`"top"`<br />`"bottom"` |
| `纹理种子`           | 用于纹理生成的随机种子。（默认值：42）                                                                                 | INT     | 否  | 0 到 2147483647                                                                                     |
| `纹理质量`           | 纹理生成的质量级别：`detailed` = HD 纹理，`extreme` = 8K 超高清纹理。（默认值：`"standard"`）                                 | COMBO   | 否  | `"standard"`<br />`"detailed"`<br />`"extreme"`                                                    |
| `纹理对齐`           | 纹理映射的对齐方法。（默认值：`"original_image"`）                                                                   | COMBO   | 否  | `"original_image"`<br />`"geometry"`                                                               |
| `面数限制`           | 最大面数。-1 让 Tripo 自适应选择（v3.x 标准约 140 万面，详细约 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"`                                                                     |
| `smart_low_poly` | 具有干净、手工风格拓扑的低多边形网格（500-20,000 面，四边形 500-10,000）。最适合简单主体；复杂主体可能会失败。（默认值：False）                        | BOOLEAN | 否  | True<br />False                                                                                    |
| `auto_size`      | 将带纹理的模型缩放为其真实世界尺寸（以米为单位）。Tripo 会将尺寸存储为模型的场景变换，并在模型转换、绑定或重定向时烘焙进去；没有纹理时忽略。（默认值：True）                  | BOOLEAN | 否  | True<br />False                                                                                    |

注意：`image` 是必需的；如果缺失，节点会引发 RuntimeError。当 `texture` 为 False 时，模型仅包含裸几何体，并且 `pbr` 会被强制设为 False。当启用 `smart_low_poly` 时，对于三角形网格，`face_limit` 必须在 500 到 20,000 之间；如果同时启用了 `quad`，则必须在 500 到 10,000 之间；如果限制无效，节点会引发 ValueError。将 `face_limit` 设置为 -1（默认值）时，不会向 API 发送明确的面数限制，让 Tripo 自适应选择。

## 输出

| 输出名称     | 描述                                | 数据类型            |
| -------- | --------------------------------- | --------------- |
| `模型文件`   | 生成的 3D 模型文件（仅用于向后兼容）。             | STRING          |
| `模型任务ID` | 用于跟踪模型生成过程的任务 ID。                 | MODEL\_TASK\_ID |
| `GLB`    | 生成的 GLB 格式 3D 模型。启用 `quad` 时为空。   | FILE3DGLB       |
| `FBX`    | 生成的 FBX 格式 3D 模型。仅在启用 `quad` 时填充。 | FILE3DFBX       |

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

***

**Source fingerprint (SHA-256):** `3b278abfd13329ee58ebab1bfeb47d32d09f4797f3d8628a35a028c3d15a7314`