### 概述

Meshy：文本转模型节点使用 Meshy API 根据文本描述生成 3D 模型。它会向 API 发送包含提示词和设置的请求，然后等待生成完成并下载生成的模型文件。

### 输入

| 参数名 | 描述 | 数据类型 | 是否必填 | 取值范围 |
| --- | --- | --- | --- | --- |
| `model` | 指定要使用的 AI 模型版本。目前仅提供 "latest"（最新）版本。 | COMBO | 是 | `"latest"` |
| `prompt` | 您想要生成的 3D 模型的文本描述。长度必须在 1 到 600 个字符之间。 | STRING | 是 | - |
| `style` | 生成 3D 模型的艺术风格。 | COMBO | 是 | `"realistic"`<br>`"sculpture"` |
| `should_remesh` | 控制是否对生成的网格进行处理。设置为 "false" 时，节点返回未处理的三角网格。选择 "true" 会显示拓扑和多边形数量的额外参数。 | DYNAMIC COMBO | 是 | `"true"`<br>`"false"` |
| `topology` | 重新网格化后模型的目标多边形类型。此参数仅在 `should_remesh` 设置为 "true" 时可用且必填。 | COMBO | 否* | `"triangle"`<br>`"quad"` |
| `target_polycount` | 重新网格化后模型的目标多边形数量。默认值为 300000。此参数仅在 `should_remesh` 设置为 "true" 时可用且必填。 | INT | 否* | 100 - 300000 |
| `symmetry_mode` | 控制生成模型中的对称性。 | COMBO | 是 | `"auto"`<br>`"on"`<br>`"off"` |
| `pose_mode` | 指定生成模型的姿态模式。空字符串表示不要求特定姿态。 | COMBO | 是 | `""`<br>`"A-pose"`<br>`"T-pose"` |
| `seed` | 用于生成的种子值。设置此值可控制节点是否应重新运行，但无论种子值如何，结果都是非确定性的。默认值为 0。 | INT | 是 | 0 - 2147483647 |

*注意：`topology` 和 `target_polycount` 参数是条件必填项。它们仅在 `should_remesh` 参数设置为 "true" 时出现且必须设置。

### 输出

| 输出名称 | 描述 | 数据类型 |
| --- | --- | --- |
| `model_file` | 生成的 GLB 模型文件名。此输出提供用于向后兼容。 | STRING |
| `meshy_task_id` | Meshy API 任务的唯一标识符。 | MESHY_TASK_ID |
| `GLB` | 以 GLB 格式生成的 3D 模型文件。 | FILE3DGLB |
| `FBX` | 以 FBX 格式生成的 3D 模型文件。 | FILE3DFBX |

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

---
**Source fingerprint (SHA-256):** `122eee5488a89433bd1f3bf79ccd8e9c51fd23cc1dfb208c39a0628c2ad3d817`
