TripoTextureNode - ComfyUI Built-in Node Documentation

The TripoTextureNode adds textures to an existing Tripo 3D model using the Tripo API.

The TripoTextureNode adds textures to an existing Tripo 3D model using the Tripo API. It takes the task ID of a model created by another Tripo node and returns a textured GLB or FBX model after the texture job finishes. You can control material maps, texture quality, alignment, seed, and guide the textures with a text prompt, a style image, or reference images.

Inputs

Common Inputs

Parameter	Description	Data Type	Required	Range
model_task_id	The Tripo task ID of the model to texture. Accepts model task IDs and segmentation task IDs.	MODEL_TASK_ID	Yes	-
texture	Ignored: this node always generates textures. Kept for older workflows. (default: True)	BOOLEAN	No	true false
pbr	PBR material maps (base color, metallic, roughness, normal); off gives a plain color texture. (default: True)	BOOLEAN	No	true false
texture_seed	Random seed for texture generation. Using the same seed with the same inputs produces the same result. (default: 42)	INT	No	0 – 2147483647
texture_quality	Texture resolution quality: detailed = HD textures, extreme = 8K Ultra textures. (default: “standard”). Approximate cost: standard $0.10, detailed$0.20, extreme $0.30.	COMBO	No	”standard" "detailed" "extreme”
texture_alignment	Method used to align the generated textures to the model. (default: “original_image”).	COMBO	No	”original_image" "geometry”
texture_prompt	Optional text guidance for texturing. Required in practice for imported models (Tripo: Import Model), which carry no source image to infer colors from. Cannot be combined with reference images. (default: "")	STRING	No	-
model_version	Texture model: v3.0 for meshes generated with v3.x, v2.5 for meshes generated with v2.5. (default: the latest v3.0 version)	COMBO	No	Multiple options available
style_image	Reference image for the artistic style of the textures. Only used together with texture_prompt.	IMAGE	No	-
reference	Reference images guiding the textures. Cannot be combined with texture_prompt or style_image. (default: “none”)	DYNAMIC_COMBO	No	”none" "image" "multiview”
part_names	Comma-separated part names from Tripo: Segment Model to texture. Empty textures every part. (default: "")	STRING	No	-

”image” Reference Inputs

These inputs are available when reference is set to "image".

Parameter	Description	Data Type	Required	Range
reference_image	Single reference image the textures should follow.	IMAGE	No	-

”multiview” Reference Inputs

These inputs are available when reference is set to "multiview".

Parameter	Description	Data Type	Required	Range
image_front	Front view (0°).	IMAGE	No	-
image_left	Left view (90°).	IMAGE	No	-
image_back	Back view (180°).	IMAGE	No	-
image_right	Right view (270°).	IMAGE	No	-

Note: The "image" and "multiview" reference modes cannot be combined with a non-empty texture_prompt or with style_image. The style_image input requires a non-empty texture_prompt. When texture_prompt is left empty, the source model must already have its own source image (for example, models produced by text-to-model, image-to-model, multiview-to-model, or an earlier texturing task). Models that carry no source image — such as imported, segmented, completed, or retopologized models — must be textured with a texture_prompt; reference images are accepted only for models the Tripo API generated itself.

Outputs

Output Name	Description	Data Type
model_file	The generated model file (for backward compatibility only).	STRING
model task_id	The task ID of the completed texture generation task, usable as input for other Tripo nodes.	MODEL_TASK_ID
GLB	The generated textured model in GLB format. Empty when the source is a quad mesh or an FBX import.	FILE3DGLB
FBX	The generated textured model in FBX format. Tripo returns FBX for quad meshes and FBX imports; empty otherwise.	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): 815c22a9d8f4785ef5219789e0f2eee804776ec7e4752099ec0db0a2b5ad4bb2