ComfyPilotComfyPilot
文档 / 节点说明 / Tripo P2：图像转模型

Tripo P2：图像转模型

使用 Tripo 的 P2 模型，从单张图像生成具有干净拓扑的低多边形 3D 模型。

节点说明 TripoPSeriesImageToModelNode 更新于 2026-11-12

查看官方原文

Tripo P2：图像转模型 - ComfyUI Built-in Node Documentation

使用 Tripo 的 P2 模型，从单张图像生成具有干净拓扑的低多边形 3D 模型。

使用 Tripo 的 P2 模型，从单张图像生成具有干净拓扑的低多边形 3D 模型。结果以三角网格（GLB）返回；当启用 model.quad 时，则以四边形为主的网格（FBX）返回。

Inputs

通用输入

参数描述数据类型必填范围
model要使用的 Tripo P 系列模型。选择模型后，下方会显示该模型自身的输入。DYNAMIC\_COMBO是"P2"

P2 输入

参数描述数据类型必填范围
model.image用于生成模型的图像。IMAGE是-
quad在 FBX 输出上返回以四边形为主的网格，而不是在 GLB 输出上返回三角网格（默认：False）。BOOLEAN是True/False
face_limit目标面数。-1 表示由 Tripo 选择。启用 model.quad 时，限制为 48 到 25,000，否则为 48 到 50,000（默认：-1）。INT是-1，或 48 到 50000
texture基础颜色纹理分辨率：standard 为 2K，detailed 为 4K，extreme 为 8K。"none" 返回无纹理网格（默认："standard"）。COMBO是"standard" "detailed" "extreme" "none"
pbr为基础颜色添加金属度、粗糙度和法线贴图。当 model.texture 为 "none" 时忽略（默认：True）。BOOLEAN是True/False
model_seed几何体的种子（默认：42）。INT是0 到 2147483647
texture_alignment匹配输入图像的颜色，或将纹理适配到生成的几何体。当 model.texture 为 "none" 时忽略（默认："original_image"）。高级设置。COMBO是"original_image" "geometry"
orientation"align_image" 将模型旋转到输入图像的视角。当 model.texture 为 "none" 时忽略（默认："default"）。高级设置。COMBO是"default" "align_image"
enable_image_autofix让 Tripo 在建模前增强低分辨率或低质量图像（默认：False）。高级设置。BOOLEAN是True/False
texture_seed纹理的种子（默认：42）。高级设置。INT是0 到 2147483647
auto_size通过场景变换将模型缩放到其以米为单位的真实世界尺寸，当 model.texture 为 "none" 时忽略（默认：False）。高级设置。BOOLEAN是True/False
export_uv当网格无纹理时对其进行 UV 展开。带纹理的网格始终会展开 UV（默认：True）。高级设置。BOOLEAN是True/False
compress_geometry应用 meshopt 几何压缩：文件会小很多，但 ComfyUI 的 3D 预览无法显示它们。对四边形网格忽略（默认：False）。高级设置。BOOLEAN是True/False

注意：

  • model.image 为必填项，且仅使用批次中的第一张图像。
  • model.face_limit 是目标值而非硬性上限，因此结果可能包含比请求更多的面。-1 表示由 Tripo 决定。
  • model.quad 决定网格由哪个输出承载。启用时，模型从 FBX 输出返回，GLB 输出保持为空；禁用时，模型从 GLB 输出返回，FBX 保持为空。如果连接的是为空的输出，节点会报错。
  • model.texture、model.pbr、model.texture_seed、model.auto_size、model.texture_alignment 和 model.orientation 仅适用于带纹理的模型：当为 "none" 时，节点不发送纹理设置，并返回裸几何体。
  • model.compress_geometry 对四边形网格没有效果。

Outputs

输出名称描述数据类型
model task_id模型生成请求的唯一任务 ID。MODEL\_TASK\_ID
GLB生成的 GLB 格式 3D 模型。启用 model.quad 时为空。FILE3DGLB
FBX生成的 FBX 格式 3D 模型。仅在启用 model.quad 时填充。FILE3DFBX
本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ 在 GitHub 上编辑

Source fingerprint (SHA-256): 9bfad31ee00546d0603ce3273502cfc93c79e3b125941fed255866aa83f770a5