Skip to main content

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

ParameterDescriptionData TypeRequiredRange
imageFront view (0°). Required.IMAGEYes-
image_leftLeft view (90°), i.e. the subject’s left side.IMAGENo-
image_backBack view (180°).IMAGENo-
image_rightRight view (270°), i.e. the subject’s right side.IMAGENo-
output_modeThe 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").COMBOYes"geometry"
"textured"
"detailed"
face_limitMaximum number of faces for the output mesh. Set to -1 for no limit (default: -1).INTNo-1 to 100000
model_seedSeed for reproducible model generation. Set to 0 for random (default: 0).INTNo0 to 2147483647
auto_sizeAutomatically size the model to fit within a standard bounding box (default: False).BOOLEANNoTrue / False
export_uvExport UV coordinates with the model (default: True).BOOLEANNoTrue / False
compress_geometryCompress the geometry data to reduce file size (default: False).BOOLEANNoTrue / 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 NameDescriptionData Type
model_fileThe filename of the generated GLB model (for backward compatibility only).STRING
model_task_idThe unique task ID for this model generation request.MODEL_TASK_ID
GLBThe generated 3D model in GLB format.FILE3DGLB
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): 29bb87cdc5d3eef891a653c622e8876a37d6e6dc1a43e5c248b184060ead9029