本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ 在 GitHub 上编辑Meshy：图像转模型节点使用 Meshy API 从单张输入图像生成 3D 模型。它会上传您的图像、提交处理任务，并返回生成的 3D 模型文件（GLB 和 FBX）以及用于参考的任务 ID。
输入
| 参数 | 数据类型 | 是否必填 | 范围 | 描述 |
|---|---|---|---|---|
model | COMBO | 是 | "latest" | 指定用于生成的 AI 模型版本。 |
image | IMAGE | 是 | - | 要转换为 3D 模型的输入图像。 |
should_remesh | DYNAMIC COMBO | 是 | "true""false" | 决定是否对生成的网格进行处理。设置为 "false" 时，节点返回未经处理的三角网格。 |
topology | COMBO | 否* | "triangle""quad" | 重新网格化后模型的目标多边形拓扑结构。此输入仅在 should_remesh 设置为 "true" 时可用。 |
target_polycount | INT | 否* | 100 - 300000 | 重新网格化后模型的目标多边形数量。此输入仅在 should_remesh 设置为 "true" 时可用。默认值为 300000。 |
symmetry_mode | COMBO | 是 | "auto""on""off" | 控制应用于生成的 3D 模型的对称性。 |
should_texture | DYNAMIC COMBO | 是 | "true""false" | 决定是否为模型生成纹理。设置为 "false" 会跳过纹理阶段，返回无纹理的网格。 |
enable_pbr | BOOLEAN | 否* | - | 当 should_texture 为 "true" 时，此选项会在基础颜色之外生成 PBR 贴图（金属度、粗糙度、法线）。默认值为 False。 |
texture_prompt | STRING | 否* | - | 用于引导纹理生成过程的文本提示（最多 600 个字符）。此输入仅在 should_texture 设置为 "true" 时可用。不能与 texture_image 同时使用。 |
texture_image | IMAGE | 否* | - | 用于引导纹理生成过程的图像。此输入仅在 should_texture 设置为 "true" 时可用。不能与 texture_prompt 同时使用。 |
pose_mode | COMBO | 是 | ""（空）"A-pose""T-pose" | 指定生成模型的姿态模式。这是一个高级参数。 |
seed | INT | 是 | 0 - 2147483647 | 生成过程的种子值。无论种子值如何，结果都是非确定性的。默认值为 0。 |
topology和target_polycount输入仅在should_remesh设置为"true"时可用。enable_pbr、texture_prompt和texture_image输入仅在should_texture设置为"true"时可用。- 您不能同时使用
texture_prompt和texture_image。如果当should_texture为"true"时同时提供了两者，节点将引发错误。
输出
| 输出名称 | 数据类型 | 描述 |
|---|---|---|
meshy_task_id | STRING | 生成的 GLB 模型的文件名。（为保持向后兼容性而保留）。 |
GLB | MESHY_TASK_ID | Meshy API 任务的唯一标识符，可用于参考或故障排除。 |
FBX | FILE3DGLB | 以 GLB 文件格式生成的 3D 模型。 |
FBX | FILE3DFBX | 以 FBX 文件格式生成的 3D 模型。 |
Source fingerprint (SHA-256):
134d9250d8b447bbbd2905f827e81b67f491ba355ebb93d4d256324b644100a2