Tripo：模型纹理化（旧版）
此节点在源代码中标记为已弃用（旧版）；显示名称为 “Tripo: Texture model (Legacy)”。
Tripo：模型纹理化（旧版） - ComfyUI Built-in Node Documentation
此节点在源代码中标记为已弃用（旧版）；显示名称为 “Tripo: Texture model (Legacy)”。
此节点在源代码中标记为已弃用（旧版）；显示名称为 “Tripo: Texture model (Legacy)”。现有文档的参数表与当前源代码保持一致。这些参数表将被保留，并在概述中注明其旧版状态。
Tripo: Texture model (Legacy) 节点通过 Tripo API 为现有的 Tripo 3D 模型添加纹理。它接收由另一个 Tripo 节点创建的模型的 task ID，并在纹理任务完成后返回带纹理的 GLB 或 FBX 模型。你可以控制材质贴图、纹理质量、对齐方式和种子，并可通过文本提示、风格图像或参考图像来引导纹理生成。此节点是纹理工具的旧版版本。
输入
通用输入
| 参数 | 描述 | 数据类型 | 必填 | 范围 |
|---|---|---|---|---|
模型任务ID | 要添加纹理的模型的 Tripo task ID。接受模型 task ID 和分割 task ID。 | MODEL\_TASK\_ID, SEGMENT\_TASK\_ID | 是 | - |
纹理 | 已忽略：此节点始终生成纹理。保留它是为了兼容较旧的工作流。（默认：True） | BOOLEAN | 否 | true false |
PBR | PBR 材质贴图（base color、metallic、roughness、normal）；关闭时生成纯色纹理。（默认：True） | BOOLEAN | 否 | true false |
纹理种子 | 纹理生成的随机种子。（默认：42） | INT | 否 | 0 – 2147483647 |
纹理质量 | 纹理分辨率质量：detailed = HD 纹理，extreme = 8K Ultra 纹理。（默认："standard"）。大致费用：standard $0.10，detailed $0.20，extreme \$0.30。 | COMBO | 否 | "standard" "detailed" "extreme" |
纹理对齐 | 用于将生成的纹理对齐到模型的方法。（默认："original\_image"） | COMBO | 否 | "original\_image" "geometry" |
texture_prompt | 用于纹理生成的可选文本引导。对于导入的模型（Tripo: Import Model）实际上必需，因为这些模型没有可用于推断颜色的源图像。不能与参考图像组合使用。（默认：""） | STRING | 否 | - |
model_version | 纹理模型：v3.0 用于使用 v3.x 生成的网格，v2.5 用于使用 v2.5 生成的网格。（默认：v3.0\_20250812） | COMBO | 否 | 提供多个选项 |
style_image | 用于纹理艺术风格的参考图像。仅与 texture_prompt 一起使用。 | IMAGE | 否 | - |
reference | 用于引导纹理的参考图像。不能与 texture_prompt 或 style_image 组合使用。（默认："none"） | DYNAMIC\_COMBO | 否 | "none" "image" "multiview" |
part_names | 来自 Tripo: Segment Model 的逗号分隔部件名称，用于指定要纹理化的部件。留空则为每个部件生成纹理。（默认：""） | STRING | 否 | - |
image 参考输入
当 reference 设置为 "image" 时，这些输入可用。
| 参数 | 描述 | 数据类型 | 必填 | 范围 |
|---|---|---|---|---|
reference_image | 纹理应遵循的单个参考图像。 | IMAGE | 是 | - |
multiview 参考输入
当 reference 设置为 "multiview" 时，这些输入可用。
| 参数 | 描述 | 数据类型 | 必填 | 范围 |
|---|---|---|---|---|
image_front | 前视图（0°）。 | IMAGE | 是 | - |
image_left | 左视图（90°）。 | IMAGE | 是 | - |
image_back | 后视图（180°）。 | IMAGE | 是 | - |
image_right | 右视图（270°）。 | IMAGE | 是 | - |
注意： "image" 和 "multiview" 参考模式不能与非空的 texture_prompt 或 style_image 组合使用。style_image 输入要求 texture_prompt 非空。当 texture_prompt 留空时，源模型必须已经带有自己的源图像（例如，由文本到模型、图像到模型、多视图到模型或更早的纹理化任务生成的模型）。不携带源图像的模型——例如导入、分割、完成或重拓扑的模型——必须使用 texture_prompt 进行纹理化；参考图像仅适用于 Tripo API 自身生成的模型。part_names 输入可以留空，以便为每个部件生成纹理。
输出
| 输出名称 | 描述 | 数据类型 |
|---|---|---|
model_file | 生成的模型文件（仅用于向后兼容）。 | STRING |
model task_id | 已完成的纹理生成任务的任务 ID，可用作其他 Tripo 节点的输入。 | MODEL\_TASK\_ID |
GLB | 以 GLB 格式生成的带纹理模型。当源为四边形网格或 FBX 导入时为空。 | FILE3DGLB |
FBX | 以 FBX 格式生成的带纹理模型。对于四边形网格和 FBX 导入，Tripo 返回 FBX；否则为空。 | FILE3DFBX |
本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ 在 GitHub 上编辑
Source fingerprint (SHA-256): 850685123b5f14cded5829d86a7307452a1e812e78d11f52806e64ea41d66350