Tripo P2：文本转模型 - ComfyUI Built-in Node Documentation

使用 Tripo 的 P2 模型，根据文本提示生成具有干净拓扑的低多边形 3D 模型。

使用 Tripo 的 P2 模型，根据文本提示生成具有干净拓扑的低多边形 3D 模型。结果会以三角网格 (GLB) 返回；当启用 model.quad 时，则以四边形为主的网格 (FBX) 返回。

输入

通用输入

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

P2 输入

参数	描述	数据类型	必填	范围
`提示词`	要生成的 3D 模型的文本描述。不能为空，最多 1024 个字符（默认：空）。	STRING	是	最多 1024 个字符
`negative_prompt`	生成模型中要避免的内容的文本描述（默认：空）。	STRING	否	最多 255 个字符
`quad`	返回以四边形为主的网格，并输出到 FBX 输出，而不是输出到 GLB 输出的三角网格（默认：False）。	BOOLEAN	是	True/False
`face_limit`	目标面数。`-1` 表示让 Tripo 自行选择。启用 `model.quad` 时，限制为 48 到 25,000；否则为 48 到 50,000（默认：-1）。	INT	是	-1，或 48 到 50000
`纹理`	基础颜色纹理分辨率：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
`image_seed`	建模前 Tripo 根据提示绘制图像的种子（默认：42）。高级设置。	INT	是	0 到 2147483647
`texture_seed`	纹理的种子（默认：42）。高级设置。	INT	是	0 到 2147483647
`auto_size`	通过场景变换将模型缩放到其真实世界尺寸（以米为单位），当 `model.texture` 为 `"none"` 时忽略（默认：False）。高级设置。	BOOLEAN	是	True/False
`export_uv`	当网格不带纹理时对其进行 UV 展开。带纹理的网格始终会展开（默认：True）。高级设置。	BOOLEAN	是	True/False
`compress_geometry`	应用 meshopt 几何压缩：文件会小很多，但 ComfyUI 的 3D 预览无法显示它们。对四边形网格忽略（默认：False）。高级设置。	BOOLEAN	是	True/False

注意：

model.prompt 为必填项；model.negative_prompt 为可选项，限制为 255 个字符。
model.face_limit 是目标值而非硬性上限，因此结果可能包含比请求更多的面。-1 表示交由 Tripo 选择。
model.quad 决定由哪个输出承载网格。启用它时，模型会出现在 FBX 输出上，而 GLB 输出保持为空；禁用它时，模型会出现在 GLB 上，而 FBX 保持为空。如果空输出正是你连接的那个，节点会报错。
model.texture、model.pbr、model.texture_seed 和 model.auto_size 仅适用于带纹理的模型：使用 "none" 时，节点不发送纹理设置，并返回裸几何体。
model.compress_geometry 对四边形网格没有效果。

输出

输出名称	描述	数据类型
`model task_id`	模型生成请求的唯一任务 ID。	MODEL\_TASK\_ID
`GLB`	生成的 3D 模型，采用 GLB 格式。启用 `model.quad` 时为空。	FILE3DGLB
`FBX`	生成的 3D 模型，采用 FBX 格式。仅在启用 `model.quad` 时填充。	FILE3DFBX

本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！在 GitHub 上编辑

Source fingerprint (SHA-256): e55596c1a237cf6b92e3bdead4359f380c6cba60992dcc61b5ee4e6b1bdd843b