TripoTextToModelNode - ComfyUI Built-in Node Documentation - ComfyUI

此旧版节点使用 Tripo 的 API 根据文本描述生成成品 3D 模型。它会等待生成完成，然后返回模型文件，并可选包含纹理和 PBR 材质。它已被标记为弃用，仅为兼容旧工作流而保留。

输入

参数	描述	数据类型	必填	范围
`提示词`	要生成的 3D 模型的文本描述（多行）。此参数为必填项，不能为空。	STRING	是	-
`负面提示词`	要避免在生成模型中出现的文本描述（多行）。最多 255 个字符。仅在非空时发送到 API。	STRING	否	最多 255 个字符
`模型版本`	用于生成的 Tripo 模型版本（默认：v3_1_20260211）。	COMBO	否	多个可用选项
`风格`	Tripo 已不再支持并被忽略。为兼容旧工作流而保留（默认：“None”）。	COMBO	否	多个可用选项
`纹理`	生成纹理贴图。关闭时返回裸几何体并忽略 `pbr`（默认：True）。	BOOLEAN	否	true / false
`PBR`	PBR 材质贴图（基础色、金属度、粗糙度、法线）。需要 `texture`；当 `texture` 关闭时会强制关闭（默认：True）。	BOOLEAN	否	true / false
`图像种子`	用于图像生成阶段的种子（默认：42）。	INT	否	0 到 2147483647
`模型种子`	用于模型生成阶段的种子（默认：42）。	INT	否	0 到 2147483647
`纹理种子`	用于纹理生成阶段的种子（默认：42）。	INT	否	0 到 2147483647
`纹理质量`	生成纹理的质量。detailed = HD 纹理，extreme = 8K Ultra 纹理（默认：standard）。	COMBO	否	”standard" "detailed" "extreme”
`面数限制`	最大面数。-1 让 Tripo 自适应选择（在 v3.x standard 下约 140 万面，在 detailed 下约 200 万面）。Tripo 会静默限制：v2.5 为 500,000，四边形网格为 150,000。（默认：-1）	INT	否	-1 到 2000000
`四边形`	四边形网格输出。Tripo 以 FBX 格式交付四边形网格，因此结果会出现在 FBX 输出上，而 GLB 输出保持为空。（默认：False）	BOOLEAN	否	true / false
`几何质量`	生成几何体的质量（默认：standard）。	COMBO	否	”standard" "detailed”
`smart_low_poly`	具有干净、手工风格拓扑的低多边形网格（500-20,000 个面，quad 为 500-10,000）。最适合简单主体；复杂主体可能会失败。（默认：False）	BOOLEAN	否	true / false
`auto_size`	将带纹理模型缩放到其以米为单位的真实世界尺寸。Tripo 会将尺寸存储为模型的场景变换，并在模型被转换、绑定或重定向时将其烘焙进去；没有纹理时会被忽略。（默认：True）	BOOLEAN	否	true / false

注意：

此节点已弃用，并标记为旧版节点。保留它是为了向后兼容旧工作流。
prompt 参数为必填项：空提示会导致节点抛出错误。
pbr 需要 texture。当 texture 关闭时，节点会强制关闭 pbr 并忽略其值。没有 texture 时，auto_size 也不起作用。
当启用 smart_low_poly 且 face_limit 设置为 -1 以外的值时，对于三角形输出，面数限制必须介于 500 和 20,000 之间；当启用 quad 时，必须介于 500 和 10,000 之间；否则节点会抛出错误。
当启用 quad 时，生成的四边形网格以 FBX 格式交付，因此 FBX 输出会被填充，而 GLB 输出保持为空。
style 参数会被接受但会被忽略。

输出

输出名称	描述	数据类型
`模型文件`	生成的 3D 模型文件名，格式为 `<task_id>.<format>`，仅为向后兼容而保留。	STRING
`模型任务ID`	模型生成过程的唯一任务标识符。	MODEL_TASK_ID
`GLB`	生成的 GLB 格式 3D 模型。启用 `quad` 时为空。	FILE3DGLB
`FBX`	生成的 FBX 格式 3D 模型。仅在启用 `quad` 时填充。	FILE3DFBX

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

Source fingerprint (SHA-256): c26c8437ea66d08f7f39865fedeaaf4cf8583ca64b368f3b767ea18918dd6c08