TripoConversionNode - ComfyUI Built-in Node Documentation

This node converts an existing Tripo 3D model into another 3D file format.

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	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. Most settings left at their default values are omitted from the conversion request so the Tripo API can use its standard behavior. The with_animation and bake options are always sent. flatten_bottom_threshold is only applied 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): b6be09bf6b1c5ccd6de5ae56ed28bfe1f0b81c1ca8ff61623e3094917c98d68a