TripoConversionNode - ComfyUI Built-in Node Documentation - ComfyUI

This node converts an existing Tripo 3D model into another 3D file format. It takes the task ID of a model previously created or processed by a Tripo operation (such as model generation, rigging, retargeting, or segmentation), submits a conversion task to the Tripo API, waits for that task to finish, and then returns the converted model file.

Inputs

Parameter	Description	Data Type	Required	Range
`original_model_task_id`	Task ID of the Tripo model to convert. It must come from an earlier Tripo model generation, rigging, retargeting, or segmentation task. If the ID is missing or empty, the node raises an error.	STRING (Tripo task ID)	Yes	MODEL_TASK_ID RIG_TASK_ID RETARGET_TASK_ID SEGMENT_TASK_ID
`format`	Target file format for the converted 3D model.	COMBO	Yes	GLTF USDZ FBX OBJ STL 3MF
`quad`	Convert triangles to quads when enabled (default: False).	BOOLEAN	No	True or False
`face_limit`	Maximum number of faces in the converted model. Set to -1 for no limit (default: -1).	INT	No	-1 to 2000000
`texture_size`	Resolution of the output textures in pixels (default: 4096).	INT	No	128 to 8192
`texture_format`	File format used for exported textures (default: JPEG).	COMBO	No	BMP DPX HDR JPEG OPEN_EXR PNG TARGA TIFF WEBP
`force_symmetry`	Force the model to be symmetrical when enabled (default: False).	BOOLEAN	No	True or False
`flatten_bottom`	Flatten the bottom of the model when enabled (default: False).	BOOLEAN	No	True or False
`flatten_bottom_threshold`	Flattening depth used with `flatten_bottom` (default: 0.01). This value is only applied when `flatten_bottom` is enabled.	FLOAT	No	0.01 to 1.0
`pivot_to_center_bottom`	Move the pivot point to the center bottom of the model when enabled (default: False).	BOOLEAN	No	True or False
`scale_factor`	Scale factor applied to the converted model (default: 1.0).	FLOAT	No	0.01 and above
`with_animation`	Keep the skeleton and animation of rigged or retargeted models (default: True).	BOOLEAN	No	True or False
`pack_uv`	Repack the UV coordinates when enabled (default: False).	BOOLEAN	No	True or False
`bake`	Bake advanced materials into the base textures for broader compatibility (default: True).	BOOLEAN	No	True or False
`part_names`	Comma-separated list of model part names to send to the conversion. Empty entries are ignored and duplicate names are removed. Leave empty to omit this option (default: empty).	STRING	No	Comma-separated list of part names
`fbx_preset`	FBX compatibility preset. bake_scale bakes the scale transform into the geometry (default: blender).	COMBO	No	blender mixamo 3dsmax bake_scale
`export_vertex_colors`	Export vertex colors when enabled (default: False).	BOOLEAN	No	True or False
`export_orientation`	Forward axis of the exported model. default keeps Tripo’s +x (default: default).	COMBO	No	default +x -x +y -y
`animate_in_place`	Animate the model in place when enabled (default: False).	BOOLEAN	No	True or False

Note: Except for original_model_task_id and format, all inputs are optional advanced settings. Settings left at their default values are omitted from the conversion request so the Tripo API uses its standard behavior. The input flatten_bottom_threshold is only meaningful when flatten_bottom is enabled.

Outputs

Output Name	Description	Data Type
`model_3d`	Converted model in the requested format. OBJ is delivered by Tripo as a ZIP archive (mesh, material and textures).	FILE_3D

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): 5fd181d15025576083769e1ce31fb20cabb33096a01c67be50c3d9bb332739bf