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

# TripoConversionNode - ComfyUI Built-in Node Documentation

> 此节点将现有的 Tripo 3D 模型转换为另一种 3D 文件格式。

此节点将现有的 Tripo 3D 模型转换为另一种 3D 文件格式。它接收先前由 Tripo 操作（例如模型生成、骨骼绑定、重定向或分割）创建或处理的模型的任务 ID，向 Tripo API 提交转换任务，等待该任务完成，然后返回转换后的模型文件。

## 输入

| 参数         | 描述                                                                          | 数据类型    | 必填 | 范围                                                                                     |
| ---------- | --------------------------------------------------------------------------- | ------- | -- | -------------------------------------------------------------------------------------- |
| `原始模型任务ID` | 要转换的 Tripo 模型的任务 ID。它必须来自先前的 Tripo 模型生成、骨骼绑定、重定向或分割任务。如果该 ID 缺失或为空，节点会引发错误。 | STRING  | 是  | MODEL\_TASK\_ID<br />RIG\_TASK\_ID<br />RETARGET\_TASK\_ID<br />SEGMENT\_TASK\_ID      |
| `格式`       | 转换后的 3D 模型的目标文件格式。                                                          | COMBO   | 是  | GLTF<br />USDZ<br />FBX<br />OBJ<br />STL<br />3MF                                     |
| `四边形`      | 启用时将三角形转换为四边形（默认值：False）。                                                   | BOOLEAN | 否  | True or False                                                                          |
| `面数限制`     | 转换后模型的最大面数。设为 -1 表示不限制（默认值：-1）。                                             | INT     | 否  | -1 到 2000000                                                                           |
| `纹理大小`     | 输出纹理的分辨率（像素）（默认值：4096）。                                                     | INT     | 否  | 128 到 8192                                                                             |
| `纹理格式`     | 导出纹理使用的文件格式（默认值：JPEG）。                                                      | COMBO   | 否  | BMP<br />DPX<br />HDR<br />JPEG<br />OPEN\_EXR<br />PNG<br />TARGA<br />TIFF<br />WEBP |
| `强制对称`     | 启用时强制模型对称（默认值：False）。                                                       | BOOLEAN | 否  | True or False                                                                          |
| `平滑底部`     | 启用时展平模型底部（默认值：False）。                                                       | BOOLEAN | 否  | True or False                                                                          |
| `平滑底部阈值`   | 与 `flatten_bottom` 配合使用的展平深度（默认值：0.01）。仅当启用 `flatten_bottom` 时才应用此值。        | FLOAT   | 否  | 0.01 到 1.0                                                                             |
| `对齐底部中心`   | 启用时将轴心点移动到模型底部中心（默认值：False）。                                                | BOOLEAN | 否  | True or False                                                                          |
| `缩放系数`     | 应用于转换后模型的缩放因子（默认值：1.0）。                                                     | FLOAT   | 否  | 0.01 及以上                                                                               |
| `加入动画`     | 保留已绑定骨骼或重定向模型的骨架和动画（默认值：True）。                                              | BOOLEAN | 否  | True or False                                                                          |
| `打包uv`     | 启用时重新打包 UV 坐标（默认值：False）。                                                   | BOOLEAN | 否  | True or False                                                                          |
| `烘焙`       | 将高级材质烘焙到基础纹理中，以获得更广泛的兼容性（默认值：True）。                                         | BOOLEAN | 否  | True or False                                                                          |
| `部件名称`     | 要发送到转换操作的模型部件名称列表，以逗号分隔。空项会被忽略，重复名称会被移除。留空以省略此选项（默认值：空）。                    | STRING  | 否  | 以逗号分隔的部件名称列表                                                                           |
| `fbx预设`    | FBX 兼容性预设。`bake_scale` 会将缩放变换烘焙到几何体中（默认值：blender）。                          | COMBO   | 否  | blender<br />mixamo<br />3dsmax<br />bake\_scale                                       |
| `导出顶点色`    | 启用时导出顶点颜色（默认值：False）。                                                       | BOOLEAN | 否  | True or False                                                                          |
| `导出朝向`     | 导出模型的前向轴。default 会保留 Tripo 的 +x（默认值：default）。                               | COMBO   | 否  | default<br />+x<br />-x<br />+y<br />-y                                                |
| `原地动画`     | 启用时让模型原地动画（默认值：False）。                                                      | BOOLEAN | 否  | True or False                                                                          |

**注意：** 除 `original_model_task_id` 和 `format` 外，所有输入均为可选的高级设置。大多数保持默认值的设置会从转换请求中省略，以便 Tripo API 使用其标准行为。`with_animation` 和 `bake` 选项始终会被发送。仅当启用 `flatten_bottom` 时，才会应用 `flatten_bottom_threshold`。

## 输出

| 输出名称       | 描述                                                 | 数据类型     |
| ---------- | -------------------------------------------------- | -------- |
| `model_3d` | 按请求格式转换后的模型。OBJ 由 Tripo 以 ZIP 压缩包形式交付（包含网格、材质和纹理）。 | FILE\_3D |

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

***

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