本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! 在 GitHub 上编辑此节点使用 Meshy API 从多个输入图像生成 3D 模型。它会上传提供的图像,提交处理任务,并返回生成的 3D 模型文件(GLB 和 FBX)以及用于参考的任务 ID。
输入参数
| 参数 | 数据类型 | 必填 | 取值范围 | 描述 |
|---|---|---|---|---|
model | COMBO | 是 | "latest" | 指定要使用的 AI 模型版本。 |
images | IMAGE | 是 | 2 到 4 张图像 | 用于生成 3D 模型的一组图像。必须提供 2 到 4 张图像。 |
should_remesh | COMBO | 是 | "true""false" | 确定是否对生成的网格进行处理。当设置为 "false" 时,节点将返回未经处理的三角网格。 |
topology | COMBO | 否 | "triangle""quad" | 重新网格化输出的目标多边形类型。此参数仅在 should_remesh 设置为 "true" 时可用且必需。 |
target_polycount | INT | 否 | 100 到 300000 | 重新网格化模型的目标多边形数量(默认值:300000)。此参数仅在 should_remesh 设置为 "true" 时可用。 |
symmetry_mode | COMBO | 是 | "auto""on""off" | 控制是否对生成的模型应用对称性。 |
should_texture | COMBO | 是 | "true""false" | 确定是否生成纹理。将其设置为 "false" 将跳过纹理阶段,并返回一个没有纹理的网格。 |
enable_pbr | BOOLEAN | 否 | True / False | 当 should_texture 为 "true" 时,此选项会生成 PBR 贴图(金属度、粗糙度、法线)以及基础颜色(默认值:False)。 |
texture_prompt | STRING | 否 | - | 用于指导纹理生成过程的文本提示(最多 600 个字符)。不能与 texture_image 同时使用。此参数仅在 should_texture 设置为 "true" 时可用。 |
texture_image | IMAGE | 否 | - | 用于指导纹理生成过程的图像。texture_image 和 texture_prompt 只能同时使用其中一个。此参数仅在 should_texture 设置为 "true" 时可用。 |
pose_mode | COMBO | 是 | """A-pose""T-pose" | 指定生成模型的姿态模式。 |
seed | INT | 是 | 0 到 2147483647 | 生成过程的种子值(默认值:0)。无论种子值如何,结果都是非确定性的,但更改种子值可以触发节点重新运行。 |
- 必须为
images输入提供 2 到 4 张图像。 topology和target_polycount参数仅在should_remesh设置为"true"时生效。enable_pbr、texture_prompt和texture_image参数仅在should_texture设置为"true"时生效。- 不能同时使用
texture_prompt和texture_image;它们是互斥的。
输出参数
| 输出名称 | 数据类型 | 描述 |
|---|---|---|
model_file | STRING | 生成的 GLB 模型的文件名。此输出是为了向后兼容而提供的。 |
meshy_task_id | MESHY_TASK_ID | Meshy API 任务的唯一标识符。 |
GLB | FILE3DGLB | 生成的 GLB 格式的 3D 模型。 |
FBX | FILE3DFBX | 生成的 FBX 格式的 3D 模型。 |