TripoRetopologyNode - ComfyUI Built-in Node Documentation - ComfyUI

Tripo: Retopology takes a high-poly 3D model that was generated by an earlier Tripo node and rebuilds it as a low-poly version with clean topology. It submits the model to the Tripo retopology service, waits for the task to finish, then downloads the finished model and exposes its task ID for use by other Tripo nodes.

Inputs

Parameter	Description	Data Type	Required	Range
`model_task_id`	Task ID of the source high-poly model. Accepts a model task ID from a Tripo generation node or a segment task ID from Tripo: Segment Model.	STRING	Yes	Tripo task ID
`face_limit`	Target face count: 500-20,000 triangles or 500-10,000 quads. -1 lets Tripo choose. (default: -1)	INT	Yes	-1 (automatic) 500 to 20,000 (triangles) 500 to 10,000 (quads)
`quad`	Quad mesh output. Tripo delivers quad meshes as FBX, so the result arrives on the FBX output and the GLB output stays empty. (default: False)	BOOLEAN	Yes	True False (default)
`bake`	Bake the source textures onto the low-poly mesh. (default: True)	BOOLEAN	No	True (default) False
`part_names`	Comma-separated part names from Tripo: Segment Model. Empty processes the whole model. (default: "")	STRING	No	Model part names or empty

Note: When face_limit is set to -1, Tripo decides the face count automatically. When quad is enabled, the maximum face limit is 10,000 quads instead of 20,000 triangles, and the result is provided as FBX (the GLB output stays empty). When part_names is empty, the whole model is processed.

Outputs

Output Name	Description	Data Type
`model_file`	Backward-compatible output that identifies the completed model file. Newer workflows should use the GLB or FBX outputs instead.	STRING
`model task_id`	Task ID of the finished retopology result. Can be passed to other Tripo nodes to reference this model.	STRING
`GLB`	The retopologized low-poly model in GLB format. Empty when `quad` is enabled.	GLB FILE
`FBX`	The retopologized low-poly model in FBX format. Only populated when `quad` is enabled.	FBX FILE

This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! Edit on GitHub

Source fingerprint (SHA-256): dc15f469b160a1d738e8089cf18de4a8262721bc77ebafa45bf194f04c7726b6