跳转到主要内容
本文档由 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;它们是互斥的。

输出

输出名称数据类型描述
meshy_task_idSTRING生成的 GLB 模型的文件名。此输出提供用于向后兼容。
GLBMESHY_TASK_IDMeshy API 任务的唯一标识符。
FBXFILE3DGLB以 GLB 格式生成的 3D 模型。
FBXFILE3DFBX以 FBX 格式生成的 3D 模型。

Source fingerprint (SHA-256): e6f75f50645c8b2cf5ebbe037edb077ef1eb0ea1baf67c581d60ac0033686d00