> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-recommend-assets-api.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# MeshyTextureNode - ComfyUI Built-in Node Documentation

> Complete documentation for the MeshyTextureNode node in ComfyUI. Learn its inputs, outputs, parameters and usage.

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

Meshy: Texture 节点将 AI 生成的纹理应用到 3D 模型上。它接收来自先前 Meshy 3D 生成或转换节点的任务 ID，并使用文本描述或参考图像为模型创建新纹理。该节点以 GLB 和 FBX 文件格式输出带纹理的模型。

## 输入参数

| 参数                   | 数据类型            | 必填 | 范围         | 描述                                                                |
| -------------------- | --------------- | -- | ---------- | ----------------------------------------------------------------- |
| `model`              | COMBO           | 是  | `"latest"` | 用于纹理生成的 AI 模型版本。目前仅提供 "latest" 版本。                                |
| `meshy_task_id`      | MESHY\_TASK\_ID | 是  | -          | 来自先前 Meshy 3D 生成或转换任务的唯一标识符（任务 ID）。这提供了待纹理化的基础 3D 模型。             |
| `enable_original_uv` | BOOLEAN         | 否  | -          | 启用时（默认：`True`），节点将使用上传模型的原始 UV 布局，保留任何现有纹理。如果模型没有原始 UV，输出质量可能会降低。 |
| `pbr`                | BOOLEAN         | 否  | -          | 为带纹理的模型启用基于物理的渲染（PBR）材质输出（默认：`False`）。                            |
| `text_style_prompt`  | STRING          | 否  | -          | 对象所需纹理风格的文本描述。最多 600 个字符。不能与 `image_style` 同时使用。                  |
| `image_style`        | IMAGE           | 否  | -          | 用于指导纹理生成过程的 2D 参考图像。不能与 `text_style_prompt` 同时使用。                 |

**参数约束：**

* 必须提供 `text_style_prompt` 或 `image_style` 中的一个，但不能同时提供两者。
* `text_style_prompt` 最多限制为 600 个字符。

## 输出参数

| 输出名称            | 数据类型            | 描述                           |
| --------------- | --------------- | ---------------------------- |
| `model_file`    | STRING          | 生成的 GLB 模型的文件名。此输出为向后兼容性而提供。 |
| `meshy_task_id` | MODEL\_TASK\_ID | 此纹理生成任务的唯一任务标识符，可用于引用结果。     |
| `GLB`           | FILE3DGLB       | 以 GLB 文件格式保存的带纹理 3D 模型。      |
| `FBX`           | FILE3DFBX       | 以 FBX 文件格式保存的带纹理 3D 模型。      |