Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.comfy.org/llms.txt

Use this file to discover all available pages before exploring further.

This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! Edit on GitHub

Overview

This node generates a 3D model from 2 to 4 reference images of an object or character. You provide images from different angles (front, left, back, right), and the node creates a 3D mesh in GLB format. The front view is required, and you can optionally add any combination of the other three views for better results.

Inputs

ParameterData TypeRequiredRangeDescription
imageIMAGEYes-Front view (0°). Required.
image_leftIMAGENo-Left view (90°), i.e. the subject’s left side.
image_backIMAGENo-Back view (180°).
image_rightIMAGENo-Right view (270°), i.e. the subject’s right side.
output_modeCOMBOYes"geometry"
"textured"
"detailed"
The output mode for the generated model. "geometry" produces a raw mesh, "textured" adds a standard texture, and "detailed" creates a high-detail textured model (default: "textured").
face_limitINTNo-1 to 100000Maximum number of faces for the output mesh. Set to -1 for no limit (default: -1).
model_seedINTNo0 to 2147483647Seed for reproducible model generation. Set to 0 for random (default: 0).
auto_sizeBOOLEANNoTrue / FalseAutomatically size the model to fit within a standard bounding box (default: False).
export_uvBOOLEANNoTrue / FalseExport UV coordinates with the model (default: True).
compress_geometryBOOLEANNoTrue / FalseCompress the geometry data to reduce file size (default: False).
Note: You must provide at least 2 images: the front view (image) plus at least one of the other views (image_left, image_back, or image_right). If fewer than 2 images are provided, the node will raise an error.

Outputs

Output NameData TypeDescription
model_fileSTRINGThe filename of the generated GLB model (for backward compatibility only).
model_task_idMODEL_TASK_IDThe unique task ID for this model generation request.
GLBFILE3DGLBThe generated 3D model in GLB format.

Source fingerprint (SHA-256): 29bb87cdc5d3eef891a653c622e8876a37d6e6dc1a43e5c248b184060ead9029