TripoImageToModelNodeV2 - ComfyUI Built-in Node Documentation

The Tripo: Image to Model node turns a single reference image into a 3D model using Tripo’s image-to-model service. It uploads the image, submits a generation task, waits for the task to finish, and returns the resulting 3D file together with the task ID. This is an API node, so it requires a valid Comfy API key.

Inputs

Parameter	Description	Data Type	Required	Range
`image`	The reference image used to generate the 3D model.	IMAGE	Yes	—
`model_version`	The model version to use for generation. If left unset, the node falls back to Tripo’s v3.1 (20260211) version.	COMBO	No	List of Tripo model versions
`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`	Seed used for the geometry generation step (default: 42).	INT	No	0 to 2147483647
`orientation`	Orientation setting applied to the generated model (default: DEFAULT).	COMBO	No	Tripo orientation options, default `DEFAULT`
`texture_seed`	Seed used for the texture generation step (default: 42).	INT	No	0 to 2147483647
`texture_quality`	detailed = HD textures, extreme = 8K Ultra textures (default: “standard”).	COMBO	No	”standard" "detailed" "extreme”
`texture_alignment`	How textures are aligned on the generated geometry (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`	The quality level of the generated geometry (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

Notes:

image is required; the node raises an error if no image is supplied.
When smart_low_poly is enabled and face_limit is set to a value other than -1, the limit must be between 500 and 20,000 for triangle meshes, or between 500 and 10,000 when quad is enabled. Other values raise an error.
When texture is disabled, pbr is forced off regardless of its setting, and auto_size has no effect.
A face_limit of -1 is sent to Tripo as “no limit”, letting the service choose adaptively.
A new 3D file format the node cannot return (anything other than GLB or FBX) causes an error.

Outputs

Output Name	Description	Data Type
`model task_id`	The Tripo task ID of the generation job.	MODEL_TASK_ID
`GLB`	The generated model as a GLB file. Empty when `quad` is enabled.	FILE3DGLB
`FBX`	The generated model as an FBX file. 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): c8c069432f67a019995b9f4dedbf5ca3f7594ae4004104277068106821189c11

​Inputs

​Outputs

Inputs

Outputs