跳转到主要内容
本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! 在 GitHub 上编辑
此节点使用 Meshy API 从多个输入图像生成 3D 模型。它会上传提供的图像,提交处理任务,并返回生成的 3D 模型文件(GLB 和 FBX)以及用于参考的任务 ID。

输入参数

参数数据类型必填取值范围描述
modelCOMBO"latest"指定要使用的 AI 模型版本。
imagesIMAGE2 到 4 张图像用于生成 3D 模型的一组图像。必须提供 2 到 4 张图像。
should_remeshCOMBO"true"
"false"
确定是否对生成的网格进行处理。当设置为 "false" 时,节点将返回未经处理的三角网格。
topologyCOMBO"triangle"
"quad"
重新网格化输出的目标多边形类型。此参数仅在 should_remesh 设置为 "true" 时可用且必需。
target_polycountINT100 到 300000重新网格化模型的目标多边形数量(默认值:300000)。此参数仅在 should_remesh 设置为 "true" 时可用。
symmetry_modeCOMBO"auto"
"on"
"off"
控制是否对生成的模型应用对称性。
should_textureCOMBO"true"
"false"
确定是否生成纹理。将其设置为 "false" 将跳过纹理阶段,并返回一个没有纹理的网格。
enable_pbrBOOLEANTrue / Falseshould_texture"true" 时,此选项会生成 PBR 贴图(金属度、粗糙度、法线)以及基础颜色(默认值:False)。
texture_promptSTRING-用于指导纹理生成过程的文本提示(最多 600 个字符)。不能与 texture_image 同时使用。此参数仅在 should_texture 设置为 "true" 时可用。
texture_imageIMAGE-用于指导纹理生成过程的图像。texture_imagetexture_prompt 只能同时使用其中一个。此参数仅在 should_texture 设置为 "true" 时可用。
pose_modeCOMBO""
"A-pose"
"T-pose"
指定生成模型的姿态模式。
seedINT0 到 2147483647生成过程的种子值(默认值:0)。无论种子值如何,结果都是非确定性的,但更改种子值可以触发节点重新运行。
参数约束:
  • 必须为 images 输入提供 2 到 4 张图像。
  • topologytarget_polycount 参数仅在 should_remesh 设置为 "true" 时生效。
  • enable_pbrtexture_prompttexture_image 参数仅在 should_texture 设置为 "true" 时生效。
  • 不能同时使用 texture_prompttexture_image;它们是互斥的。

输出参数

输出名称数据类型描述
model_fileSTRING生成的 GLB 模型的文件名。此输出是为了向后兼容而提供的。
meshy_task_idMESHY_TASK_IDMeshy API 任务的唯一标识符。
GLBFILE3DGLB生成的 GLB 格式的 3D 模型。
FBXFILE3DFBX生成的 FBX 格式的 3D 模型。