TripoTextToModelNode - ComfyUI Built-in Node Documentation

Generates finished 3D models from a text description using Tripo’s API.

Generates finished 3D models from a text description using Tripo’s API. The node waits for generation to complete and then returns the model file, optionally with textures and PBR materials.

Inputs

Parameter	Description	Data Type	Required	Range
prompt	Text description of the 3D model to generate (multiline). This parameter is required and cannot be empty.	STRING	Yes	-
negative_prompt	Text description of what to avoid in the generated model (multiline). Up to 255 characters. Sent to the API only when non-empty.	STRING	No	Up to 255 characters
model_version	Version of the Tripo model to use for generation (default: v3.1-20260211).	COMBO	No	Multiple options available
style	Style applied to the generated model (default: None). No longer supported by Tripo and ignored; kept for older workflows.	COMBO	No	Multiple options available
texture	Whether to generate texture maps. Off returns bare geometry and ignores pbr (default: True).	BOOLEAN	No	true / false
pbr	Whether to generate PBR material maps (base color, metallic, roughness, normal). Requires texture; forced off when texture is off (default: True).	BOOLEAN	No	true / false
image_seed	Seed used for the image generation stage (default: 42).	INT	No	0 to 2147483647
model_seed	Seed used for the model generation stage (default: 42).	INT	No	0 to 2147483647
texture_seed	Seed used for the texture generation stage (default: 42).	INT	No	0 to 2147483647
texture_quality	Quality of the generated textures. detailed = HD textures, extreme = 8K Ultra textures (default: standard).	COMBO	No	”standard" "detailed" "extreme”
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 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:

• The prompt parameter is mandatory: an empty prompt causes the node to raise an error.
• pbr requires texture. When texture is off, the node forces pbr to off and ignores its value. auto_size also has no effect without texture.
• When smart_low_poly is enabled and face_limit is set to a value other than -1, the face limit must be between 500 and 20,000 for triangle output, or between 500 and 10,000 when quad is enabled; otherwise the node raises an error.
• When quad is enabled, the generated quad mesh is delivered as FBX, so the FBX output is populated and the GLB output stays empty.

Outputs

Output Name	Description	Data Type
model_file	The generated 3D model file, kept for backward compatibility only.	STRING
model task_id	The unique task identifier for 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): 3f4bc09d125fedb6c30968f31804cfc7ec6d2f068a7c28d90b006137803020b0