> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# MeshyTextToModelNode - ComfyUI Built-in Node Documentation
> Meshy: Text to Model 节点使用 Meshy API 根据文本描述生成 3D 模型。
Meshy: Text to Model 节点使用 Meshy API 根据文本描述生成 3D 模型。它会使用你的提示词和设置向 API 发送请求，然后等待生成完成并下载生成的模型文件。
## 输入
| 参数 | 描述 | 数据类型 | 必需 | 范围 |
| - | - | - | - | - |
| `model` | 指定用于生成的 AI 模型版本。 | COMBO | 是 | `"meshy-7.1"`
`"meshy-7"`
`"meshy-6"`
`"latest"` |
| `prompt` | 你想要生成的 3D 模型的文本描述。长度必须在 1 到 600 个字符之间。默认值为空字符串。 | STRING | 是 | 1 - 600 characters |
| `style` | 生成的 3D 模型的艺术风格。 | COMBO | 是 | `"realistic"` |
| `should_remesh` | 当设置为 false 时，返回未处理的三角网格。选择 "true" 会显示用于拓扑和目标多边形数量的额外参数。 | DYNAMIC\_COMBO | 是 | `"true"`
`"false"` |
| `topology` | 重新网格化模型的目标多边形类型。此参数仅在 `should_remesh` 设置为 "true" 时可用。 | COMBO | 否\* | `"triangle"`
`"quad"` |
| `target_polycount` | 重新网格化模型的目标多边形数量。默认值为 300000。此参数仅在 `should_remesh` 设置为 "true" 时可用。 | INT | 否\* | 100 - 300000 |
| `symmetry_mode` | 控制生成模型中的对称性。这是一个高级参数。选项为 `"auto"`、`"on"` 和 `"off"`。 | COMBO | 是 | `"auto"`
`"on"`
`"off"` |
| `pose_mode` | 指定生成模型的姿态模式。空字符串表示不请求特定姿态。这是一个高级参数。 | COMBO | 是 | `""`
`"A-pose"`
`"T-pose"` |
| `seed` | `seed` 控制节点是否应重新运行；无论 `seed` 如何，结果都是非确定性的。默认值为 0。 | INT | 是 | 0 - 2147483647 |
| `超精细模式` | 运行额外的细化处理，以获得具有更精细表面细节的高保真几何体。默认值为 false。 | BOOLEAN | 是 | true
false |
| `ultra_resolution` | 超精细处理的分辨率：`"2k"` 以 2048³ 运行，`"4k"` 以 4096³ 运行，以获得最精细的表面细节。`"4k"` 需要 `"meshy-7.1"` 或 `"latest"` 模型。仅在启用 `ultra_mode` 时使用（默认：`"2k"`）。 | COMBO | 否 | `"2k"`
`"4k"` |
\*注意：`topology` 和 `target_polycount` 参数为条件可用。仅当 `should_remesh` 参数设置为 "true" 时才会出现。
当启用 `ultra_mode` 时，`model` 参数必须设置为 `"meshy-7.1"`、`"meshy-7"` 或 `"latest"`；选择任何其他模型都会引发错误。使用 `"meshy-7"` 时，超精细处理始终以 2048³ 运行，而 `"4k"` 的超精细分辨率需要 `"meshy-7.1"` 或 `"latest"`。
## 输出
| 输出名称 | 描述 | 数据类型 |
| - | - | - |
| `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):** `a02a5ae28bcae343c628d11ba3efa952b61b8bdf867669f58f1beb0f7c9e49f9`
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.