Load3DAdvanced - ComfyUI Built-in Node Documentation

The Load 3D (Advanced) node loads a 3D model file from ComfyUI’s input/3d directory and provides the model data together with model placement and camera information captured in the

The Load 3D (Advanced) node loads a 3D model file from ComfyUI’s input/3d directory and provides the model data together with model placement and camera information captured in the 3D viewer’s viewport state. It supports common 3D file formats and lets you set the render width and height of the viewport in pixels. This node is experimental.

Inputs

Parameter	Description	Data Type	Required	Range
model_file	The 3D model file to load. Select “none” to skip loading a model file. Files can also be uploaded through the widget.	COMBO	Yes	"none" Available 3D model files in the input/3d directory
viewport_state	The current viewport state containing camera and model information from the 3D viewer.	LOAD3D	Yes	-
width	Render width of the viewport in pixels (default: 1024).	INT	Yes	Min: 1 Max: 4096 Default: 1024 Step: 1
height	Render height of the viewport in pixels (default: 1024).	INT	Yes	Min: 1 Max: 4096 Default: 1024 Step: 1

Notes on Parameters:

• The model_file parameter only lists files with the following extensions: .gltf, .glb, .obj, .fbx, .stl
• Files must be placed in the input/3d directory of your ComfyUI installation; subfolders are searched as well, and file paths are shown relative to the input directory
• If model_file is “none”, no model data is loaded and the model_3d output will be empty
• If model_file is set to a file that does not exist, the node returns a validation error: “Invalid 3D model file: {model_file}”
• If viewport_state is not a valid viewport state object, it is treated as empty, so model_3d_info becomes an empty list and camera_info is returned as empty

Outputs

Output Name	Description	Data Type
model_3d	Loaded 3D model file (glb/obj/stl/etc.). Empty if no model file was selected.	FILE3DANY
model_3d_info	Placement of each model in the scene: position, rotation, and scale (Y-up world space).	LOAD3DMODELINFO
camera_info	Viewport camera information: position, look-at target, zoom, and type.	LOAD3DCAMERA
width	Render width of the viewport in pixels.	INT
height	Render height of the viewport in pixels.	INT

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): c79c53dde0c8b3afb7df7b972df749f5040c92d48b47e355c4497d9b0cbf1c22