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

# MeshyTextToModelNode - ComfyUI Built-in Node Documentation

> Complete documentation for the MeshyTextToModelNode 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/MeshyTextToModelNode/zh.md)

Meshy: Text to Model 节点使用 Meshy API，根据文本描述生成 3D 模型。它会将您的提示词和设置发送到 API，然后等待生成完成并下载生成的模型文件。

## 输入参数

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

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

## 输出

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