TripoPSeriesImageToModelNode - ComfyUI Built-in Node Documentation

Generates a low-poly 3D model with clean topology from a single image using Tripo’s P2 model. The result comes back as a triangle mesh (GLB) or, when model.quad is enabled, as a quad-dominant mesh (FBX).

Inputs

Common Inputs

Parameter	Description	Data Type	Required	Range
`model`	Tripo P-series model to use. Selecting a model reveals its own inputs below.	DYNAMIC_COMBO	Yes	`"P2"`

P2 Inputs

Parameter	Description	Data Type	Required	Range
`model.image`	The image the model is generated from.	IMAGE	Yes	-
`model.quad`	Return a quad-dominant mesh on the FBX output instead of a triangle mesh on the GLB output (default: False).	BOOLEAN	Yes	True/False
`model.face_limit`	Target face count. `-1` lets Tripo choose. With `model.quad` enabled the limit is 48 to 25,000, otherwise 48 to 50,000 (default: -1).	INT	Yes	-1, or 48 to 50000
`model.texture`	Base color texture resolution: standard is 2K, detailed 4K and extreme 8K. `"none"` returns an untextured mesh (default: `"standard"`).	COMBO	Yes	`"standard"` `"detailed"` `"extreme"` `"none"`
`model.pbr`	Add metallic, roughness and normal maps to the base color. Ignored when `model.texture` is `"none"` (default: True).	BOOLEAN	Yes	True/False
`model.model_seed`	Seed for the geometry (default: 42).	INT	Yes	0 to 2147483647
`model.texture_alignment`	Match the colors of the input image, or fit the textures to the generated geometry. Ignored when `model.texture` is `"none"` (default: `"original_image"`). Advanced setting.	COMBO	Yes	`"original_image"` `"geometry"`
`model.orientation`	`"align_image"` rotates the model to the viewpoint of the input image. Ignored when `model.texture` is `"none"` (default: `"default"`). Advanced setting.	COMBO	Yes	`"default"` `"align_image"`
`model.enable_image_autofix`	Let Tripo enhance a low-resolution or low-quality image before modeling (default: False). Advanced setting.	BOOLEAN	Yes	True/False
`model.texture_seed`	Seed for the textures (default: 42). Advanced setting.	INT	Yes	0 to 2147483647
`model.auto_size`	Scale the model to its real-world size in meters through its scene transform. Ignored when `model.texture` is `"none"` (default: False). Advanced setting.	BOOLEAN	Yes	True/False
`model.export_uv`	UV unwrap the mesh when it is untextured. Textured meshes are always unwrapped (default: True). Advanced setting.	BOOLEAN	Yes	True/False
`model.compress_geometry`	Apply meshopt geometry compression: much smaller files, but ComfyUI’s 3D preview cannot display them. Ignored for quad meshes (default: False). Advanced setting.	BOOLEAN	Yes	True/False

Notes:

model.image is required and only the first image of the batch is used.
model.face_limit is a target rather than a hard cap, so the result can contain more faces than requested. -1 leaves the choice to Tripo.
model.quad decides which output carries the mesh. With it enabled the model arrives on the FBX output and the GLB output stays empty; with it disabled the model arrives on GLB and FBX stays empty. The node raises an error if the empty output is the one you connected.
model.texture, model.pbr, model.texture_seed, model.auto_size, model.texture_alignment and model.orientation only apply to textured models: with "none" the node sends no texture settings and returns bare geometry.
model.compress_geometry has no effect on quad meshes.

Outputs

Output Name	Description	Data Type
`model task_id`	The unique task ID for the model generation request.	MODEL_TASK_ID
`GLB`	The generated 3D model in GLB format. Empty when `model.quad` is enabled.	FILE3DGLB
`FBX`	The generated 3D model in FBX format. Only populated when `model.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): 9bfad31ee00546d0603ce3273502cfc93c79e3b125941fed255866aa83f770a5

​Inputs

​Common Inputs

​P2 Inputs

​Outputs

Inputs

Common Inputs

P2 Inputs

Outputs