TripoImageToModelNode - ComfyUI Built-in Node Documentation

Generates 3D models synchronously based on a single image using Tripo’s API.

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. This is the legacy version of the image-to-model node, kept for older workflows.

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): 3b278abfd13329ee58ebab1bfeb47d32d09f4797f3d8628a35a028c3d15a7314