camera_snapshot
Capture a single JPEG frame from a Bambu printer's chamber camera. Returns base64 or saves to disk. Supports A1, P1, X1, P2S, H2 models.
Instructions
Capture a single JPEG frame from the printer's chamber camera. A1/P1 use TCP-on-6000; X1/P2S/H2 use RTSP via ffmpeg. Returns JPEG as base64; pass save_path to also write the bytes to disk.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| host | No | Hostname or IP of the printer (default: value from env) | |
| printer | No | Configured printer ID. Omit to use the default printer or the only configured printer. | |
| save_path | No | Optional absolute path to write the JPEG to disk. If omitted, only the base64 payload is returned. | |
| timeout_ms | No | Max ms to wait for a full frame (default 8000). Camera may take a few seconds on cold start. | |
| bambu_model | No | Printer model. Used to route to the correct protocol or fail fast on unsupported models. Defaults to BAMBU_MODEL. | |
| bambu_token | No | Access token (default: value from env) | |
| ffmpeg_path | No | Override path to the ffmpeg binary used by the RTSP path. Defaults to ffmpeg via $PATH. Required only for the RTSP transport (X1, P2S, H2 series). | |
| bambu_serial | No | Serial number (default: value from env) | |
| experimental | No | Deprecated and ignored. Earlier this flag let callers probe H2 series via the A1/P1 TCP-on-6000 path; live testing on an H2S confirmed H2 uses RTSP instead, so the flag has no effect now. |