slice_stl
Slice STL or 3MF files into printable G-code or sliced 3MF for Bambu Lab printers. Specify the printer model to generate safe output.
Instructions
Slice an STL or 3MF file using a slicer to generate printable G-code or sliced 3MF. IMPORTANT: bambu_model must be specified to ensure the slicer generates safe G-code for the correct printer.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scale | No | Uniform scale factor applied to all axes. 1.0 = original size, 2.0 = double, 0.5 = half. Applied before slicing. | |
| orient | No | Auto-orient the model for optimal printability (minimize supports, maximize bed adhesion). Recommended for raw STL imports that lack a pre-set orientation. | |
| rotate | No | Rotate the model around the Z-axis (vertical) by this many degrees before slicing. Positive = counterclockwise when viewed from above. | |
| arrange | No | Auto-arrange all objects on the build plate with optimal spacing. Recommended when importing STLs or adding multiple objects. Set false to preserve existing plate layout. | |
| printer | No | Configured printer ID. Omit to use the default printer or the only configured printer. | |
| bed_type | No | Bed plate type for slicing (default: textured_plate). SuperTack is accepted only for pre-sliced print jobs until the BambuStudio CLI identifier is verified. | |
| min_save | No | Write a smaller output 3MF by omitting non-essential metadata. Reduces file size for faster FTP upload to the printer. | |
| rotate_x | No | Rotate the model around the X-axis by this many degrees before slicing. Useful for reorienting prints for better layer adhesion. | |
| rotate_y | No | Rotate the model around the Y-axis by this many degrees before slicing. Useful for reorienting prints for better layer adhesion. | |
| stl_path | Yes | Path to the STL or 3MF file to slice | |
| uptodate | No | Refresh 3MF preset configs to match the latest BambuStudio version. Use when slicing downloaded or older 3MF files to prevent stale-config failures. | |
| bambu_model | Yes | REQUIRED: Bambu Lab printer model. Ask the user if not known. Using the wrong model can damage the printer. | |
| repetitions | No | Print N identical copies of the model. Each copy gets its own plate placement. Example: 3 prints three copies. | |
| slice_plate | No | Which plate index to slice. 0 = all plates (default). Use 1, 2, etc. to slice only a specific plate in multi-plate 3MF projects. | |
| slicer_path | No | Path to the slicer executable (default: value from env) | |
| slicer_type | No | Type of slicer to use. Bambu-compatible choices (bambustudio, orcaslicer, orcaslicer-bambulab) export sliced 3MF; aliases such as fulu-orca and orca-studio are accepted. | |
| skip_objects | No | Skip specific objects during slicing by index. Comma-separated, e.g. '3,5,10'. Useful for multi-object 3MFs where you only want to print some parts. | |
| template_dir | No | Optional template directory override when resolving template_name. | |
| clone_objects | No | Duplicate specific objects on the plate. Comma-separated clone counts per object index, e.g. '1,3,1,10' clones object 0 once, object 1 three times, etc. | |
| ensure_on_bed | No | Detect models floating above the bed and lower them onto the build surface. Safety net for imported models with incorrect Z origins. | |
| template_name | No | Optional named template from the local registry. Resolves to template_3mf_path automatically. | |
| allow_mix_temp | No | Allow filaments with different temperature requirements on the same plate. Required for multi-material prints mixing e.g. PLA and PETG. | |
| load_filaments | No | Override filament profiles. Semicolon-separated paths to filament JSON configs, e.g. 'pla_basic.json;petg_cf.json'. | |
| slicer_profile | No | Path to the slicer profile/config file (optional, overrides bambu_model preset) | |
| nozzle_diameter | No | Nozzle diameter in mm (default: 0.4) | |
| enable_timelapse | No | Insert timelapse parking moves into gcode. The toolhead parks at a fixed position each layer for camera capture. Adds ~10% print time. | |
| filament_profile | No | Compatibility alias for load_filaments. Semicolon-separated Orca/Bambu filament profile JSON paths. | |
| load_filament_ids | No | Map filaments to objects/parts. Comma-separated IDs matching load_filaments order, e.g. '1,2,3,1' assigns filament 1 to objects 0 and 3. | |
| template_3mf_path | No | Optional template 3MF whose embedded Bambu slicer settings should be reused when slicing a new STL or 3MF. | |
| skip_modified_gcodes | No | Strip custom start/end gcodes embedded in the 3MF. Recommended for downloaded 3MFs since custom gcodes from other users' profiles may be unsafe for your printer. | |
| use_printer_filaments | No | When true, and no explicit slicer profile or load_filaments override is provided, use the printer's current or first loaded AMS filament as the slicer filament profile. Template 3MF process settings can still be used at the same time. |