TripoImageToModelNode - ComfyUI Built-in Node Documentation

Generates 3D models synchronously based on a single image using Tripo’s API. Provide an input image, and the node creates a finished 3D model from it, with optional controls for model version, texture generation, level of detail, and output format.

Inputs

Parameter	Description	Data Type	Required	Range
`image`	The input image used to generate the 3D model. An image must be provided, otherwise the node raises an error.	IMAGE	Yes	-
`model_version`	The model version to use for generation.	COMBO	No	`"v1.4"` `"v3.0"` `"v3.5"` `"v3.6"`
`style`	No longer supported by Tripo and ignored. Kept for older workflows. (default: `"None"`)	COMBO	No	`"None"` `"realistic"` `"cartoon"` `"sculpture"` `"low_poly"`
`texture`	Generate texture maps. Off returns bare geometry and ignores `pbr`. (default: True)	BOOLEAN	No	True False
`pbr`	PBR material maps (base color, metallic, roughness, normal). Requires `texture`. (default: True)	BOOLEAN	No	True False
`model_seed`	Random seed for model generation. (default: 42)	INT	No	0 to 2147483647
`orientation`	Orientation setting for the generated model. (default: `"default"`)	COMBO	No	`"default"` `"front"` `"back"` `"left"` `"right"` `"top"` `"bottom"`
`texture_seed`	Random seed for texture generation. (default: 42)	INT	No	0 to 2147483647
`texture_quality`	Quality level for texture generation: `detailed` = HD textures, `extreme` = 8K Ultra textures. (default: `"standard"`)	COMBO	No	`"standard"` `"detailed"` `"extreme"`
`texture_alignment`	Alignment method for texture mapping. (default: `"original_image"`)	COMBO	No	`"original_image"` `"geometry"`
`face_limit`	Maximum face count. -1 lets Tripo pick adaptively (about 1.4M faces on v3.x standard, 2M on detailed). Tripo clamps silently: v2.5 at 500,000, quad meshes at 150,000. (default: -1)	INT	No	-1 to 2000000
`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	No	True False
`geometry_quality`	Quality level for geometry generation. (default: `"standard"`)	COMBO	No	`"standard"` `"detailed"`
`smart_low_poly`	Low-poly mesh with clean, hand-crafted style topology (500-20,000 faces, quad 500-10,000). Best for simple subjects; complex ones may fail. (default: False)	BOOLEAN	No	True False
`auto_size`	Scale textured models to their real-world size in meters. Tripo stores the size as the model’s scene transform and bakes it in when the model is converted, rigged or retargeted; ignored without texture. (default: True)	BOOLEAN	No	True False

Note: An image is required; if it is missing, the node raises a RuntimeError. When texture is False, the model contains bare geometry only and pbr is forced to False. When smart_low_poly is enabled, face_limit must be between 500 and 20,000 for triangle meshes, or between 500 and 10,000 when quad is also enabled; if the limit is invalid, the node raises a ValueError. Setting face_limit to -1 (the default) sends no explicit face limit to the API, letting Tripo choose adaptively.

Outputs

Output Name	Description	Data Type
`model_file`	The generated 3D model file (for backward compatibility only).	STRING
`model task_id`	The task ID for tracking the model generation process.	MODEL_TASK_ID
`GLB`	The generated 3D model in GLB format. Empty when `quad` is enabled.	FILE3DGLB
`FBX`	The generated 3D model in FBX format. Only populated when `quad` is enabled.	FILE3DFBX

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): 79ebe76234036e8284640d7eaeee3a1220975b8adc043994de7de0ee161ccd45

​Inputs

​Outputs

Inputs

Outputs