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.

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