TripoTextToModelNode - ComfyUI Built-in Node Documentation

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

​Inputs

​Outputs

Inputs

Outputs