Meshy：文本生成模型 - 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 个字符
`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 上编辑

Source fingerprint (SHA-256): a02a5ae28bcae343c628d11ba3efa952b61b8bdf867669f58f1beb0f7c9e49f9