start_print
Start a 3D print job directly from a file already stored on the printer's SD card. Supports .3mf and .gcode files, so you can begin printing without uploading again.
Instructions
Start printing a file that is already on the printer's SD card. Supports .3mf and .gcode files. Use list_files to see available files, or upload_file to add one first.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"file": "<file>"
},
"name": "start_print"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file | Yes | Filename on the printer's SD card (e.g. 'model.3mf' or 'benchy.gcode') | |
| path | No | Directory path where the file was found by list_files (e.g. '/', '/cache/'). If omitted, defaults based on printer model. | |
| plate | No | Plate number for .3mf files (1-based, default: 1) | |
| printer | No | Printer ID, 'all', or omit for single printer | |
| use_ams | No | Use AMS for filament. Default: true | |
| bed_type | No | Bed/plate type. Default: auto | |
| flow_cali | No | Enable flow calibration. Default: false | |
| timelapse | No | Record timelapse. Default: false | |
| ams_mapping | No | AMS slot mapping array. Index = color in file, value = AMS slot (0-3) or -1 for external spool. Default: [0] | |
| bed_leveling | No | Enable auto bed leveling. Default: true | |
| layer_inspect | No | Enable first layer inspection. Default: false | |
| vibration_cali | No | Enable vibration calibration. Default: false | |
| nozzle_offset_cali | No | Enable nozzle offset calibration check before printing (H2D dual-nozzle only). Default: false |