REST API для парка Bambu Lab, включая AMS

Bambu Lab Bambu Lab API

SimplyPrint является облачной панелью для парков Bambu Lab с полной информацией об AMS, маршрутизацией очереди, отслеживанием филамента и текущим состоянием. API позволяет собственному ПО управлять этим парком: ставить задания печати в очередь на конкретном X1C, приостанавливать P1S, узнавать, какие катушки загружены в блок AMS, и отправлять команду G-code. Один заголовок, JSON на вход, JSON на выход. Один API работает как для одного P1S, так и для двух сотен X1C.

Visa översikt över API Kom igång gratis Mer info och guide
Funktionsbild

Совместимость со всей линейкой Bambu Lab

X1C, X1E, P1S, P1P, A1, A1 Mini и H2D подключаются к SimplyPrint и предоставляют одинаковый API. AMS, AMS Lite, AMS 2 Pro и AMS HT распознаются, а загруженные катушки отображаются в ответе инвентаря филамента так же, как для принтеров, подключённых любым другим способом.

Поставьте задание печати в очередь на конкретном Bambu Lab одним вызовом API

Отправьте через POST ID файла 3MF или G-code и укажите ID нужного принтера Bambu Lab, после чего файл попадёт в очередь SimplyPrint. Многоцветные файлы 3MF обрабатываются тем же движком, который используется в панели, а очередь направляет задание на принтер, в AMS которого загружены необходимые цвета.

# Queue a print on a specific Bambu Lab X1C (printer id 84)
curl -X POST "https://api.simplyprint.io/{companyId}/queue/AddItem" \
  -H "X-API-KEY: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "fileId": "multi_color_3mf_file_id",
    "amount": 1,
    "for_printers": "84",
    "position": "top"
  }'
Для автоматизации вообще не указывайте for_printers, и SimplyPrint выберет первый готовый к работе Bambu Lab, в AMS которого уже загружены нужные цвета. Это полезно для ферм с 10+ X1C, работающими рядом.

Как SimplyPrint подключается к вашему принтеру Bambu Lab

Для полного управления принтером Bambu Lab из SimplyPrint требуется SimplyPrint Bambu Lab Client: небольшой процесс-посредник, который работает в вашей сети на Raspberry Pi, mini PC или любом постоянно включённом компьютере Mac/Windows/Linux. Процесс находится в той же LAN, что и ваши принтеры, и взаимодействует с ними локально; затем он подключается к облаку SimplyPrint через интернет от вашего имени. Принтерам не нужно публичное подключение: они остаются в режиме LAN-only, а полный удалённый контроль доступен откуда угодно.

  • Полный контроль (запуск печати, AMS, температура, перемещение, веб-камера): принтер в LAN-only Mode при включённом Developer Mode, а SimplyPrint Bambu Lab Client работает как мост. Это поддерживаемый способ для текущих прошивок Bambu.
  • Только мониторинг (статус, ход печати, состояние AMS, веб-камера, статистика): принтер в облачном режиме + SimplyPrint Bambu Lab Client. Можно видеть всё, но нельзя начать печать из SimplyPrint: система Bambu Authorization Control System (ACS, 2025) блокирует сторонние действия записи через облако Bambu.
  • Нет подключения принтера: не добавляйте принтер вообще. Облачный слайсер, менеджер филамента, хранилище файлов и инструменты для этикеток всё равно работают; запускайте печать из Bambu Studio / Bambu Handy как обычно.
После подключения моста принтер отображается в API как стандартный объект принтера. GET /printers/Get возвращает одинаковую структуру для Bambu Lab, Prusa, Creality и других брендов, поэтому ваш код не зависит от бренда.

Полное руководство по настройке Bambu Lab: LAN-only или Cloud
Funktionsbild
Funktionsbild

Используйте SimplyPrint вместе с Bambu Studio Cloud

Не нужно выбирать что-то одно. Продолжайте использовать Bambu Studio и Bambu Handy как слайсер и приложение быстрого управления, а SimplyPrint используйте для очереди парка, маршрутизации с учётом AMS, учёта филамента и REST API. Оба сервиса используют одно подключение к принтеру, поэтому нет конфликта, флага эксклюзивности или необходимости дополнительно настраивать принтер для совместной работы.

Получайте состояние, управляйте печатью, отправляйте G-code

Каждая конечная точка управления принтером работает одинаково для Bambu Lab и любого другого принтера. Передайте ID принтера, получите JSON.

# List every printer - response includes loaded AMS spools per Bambu Lab unit
curl "https://api.simplyprint.io/{companyId}/printers/Get" \
  -H "X-API-KEY: your_api_key_here"
Приостановите выполняющуюся печать, не касаясь принтера:
# Pause a Bambu Lab print mid-run
curl -X POST "https://api.simplyprint.io/{companyId}/printers/actions/Pause" \
  -H "X-API-KEY: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "pid": 84 }'

Funktionsbild

Автоматизация с учётом AMS: считывание загруженных катушек, постановка нужного задания в очередь

Слоты AMS каждого принтера Bambu Lab отслеживаются как катушки филамента в менеджере филамента SimplyPrint. API предоставляет те же данные: бренд, материал, цвет, остаточный вес и слот каждой катушки. Автоматизация может проверить, что сейчас загружено, и поставить в очередь подходящую печать или уведомить оператора о замене катушки.

# Inspect filament spools - useful for AMS-aware automation
curl "https://api.simplyprint.io/{companyId}/filament/GetFilament" \
  -H "X-API-KEY: your_api_key_here"
Часть SimplyPrint для работы с несколькими материалами поддерживает AMS, AMS Lite, AMS 2 Pro и AMS HT: до 4 блоков AMS, соединяемых последовательно на принтер × 4 слота в каждом = до 16 цветов на X1C/P1S. API не предоставляет отдельную конечную точку для каждого AMS: состояние AMS входит в объект принтера, а загруженные катушки находятся в инвентаре филамента.

Посмотреть поддержку Bambu Lab AMS

Что люди создают с API Bambu Lab

  • Интеграции Shopify / WooCommerce: поступает многоцветный заказ, и для Bambu Lab с уже загруженной нужной палитрой AMS автоматически создаётся элемент очереди SimplyPrint.
  • Дашборды парка: настенные дашборды в Grafana и Notion, а также пользовательские дашборды на Svelte с актуальным состоянием каждого принтера X1C, P1S и A1 в мастерской и данными о слотах AMS для каждого принтера.
  • Боты Slack / Discord: боты, которые приостанавливают вышедшую из-под контроля печать, сообщают «P1S только что завершил печать #128» или суммируют использование филамента по парку Bambu за неделю.
  • Бронирование в учебных заведениях и мейкерспейсах: система бронирования резервирует P1S, ставит G-code учащегося в очередь, затем архивирует задание в академическую выписку учащегося после завершения.

Почему стоит использовать SimplyPrint вместо собственного облака Bambu?

Bambu Handy и облако Bambu Studio предоставляют удалённую панель Bambu Lab и печать из слайсера Bambu Studio. SimplyPrint дополняет их, предоставляя парку принтеров функции, которых нет в собственном облаке Bambu:

  • API для парка разных брендов: один и тот же код управляет Bambu Lab X1C, Prusa MK4, Anycubic Kobra и любыми устройствами, совместимыми с OctoPrint.
  • Логика очереди, утверждения и маршрутизации: не только управление отдельными принтерами, но и полноценная очередь для нескольких принтеров с процессами утверждения, разрешениями для каждого пользователя и автоматической маршрутизацией.
  • Учёт филамента во всей мастерской: не только катушки, загруженные в один AMS, но и все катушки в вашем менеджере филамента, с отслеживанием стоимости за грамм.
  • OAuth2 для партнёрских интеграций: выпустите интеграцию, которую пользователи подключают к своему аккаунту SimplyPrint, вместо необходимости делиться учётными данными Bambu.
  • События Webhook: SimplyPrint отправляет POST-запрос сразу при событии, без опроса.
SimplyPrint и официальные инструменты Bambu могут работать одновременно, использовать оба можно без проблем.

Посмотреть главную страницу API

Доступность API Bambu Lab в планах

Такие же ограничения по тарифам, как у основного API SimplyPrint. На тарифах Free и Basic API недоступен; Pro и выше открывают Basic API; Print Farm и выше открывают Enhanced (возможность записи для изменения очереди и запуска печати).

Funktion / gräns Gratis Grundläggande Pro Skrivarfarm Enterprise Skola Cloud Slicer Filament Manager
Запросов API в минуту
Скользящий поминутный лимит для всех API-вызовов аккаунта.
- - 60 180 600 180 - -
Доступ к Basic API
Получайте сведения о состоянии принтера, очереди, заданиях и истории для каждого принтера Bambu Lab в аккаунте.
Расширенный API (запуск печати, отправка G-code)
Открывает загрузку файлов, операции в очереди, запускающие печать, и прямую отправку G-code.

Vill du veta mer om våra planer?

Visa fullständig pris- och funktionsjämförelse

Частые вопросы о Bambu Lab API

X1C, X1E, P1S, P1P, A1, A1 Mini и H2D подключаются к SimplyPrint. После подключения все предоставляют одинаковый API: одинаковую структуру ответа /printers/Get, одни и те же конечные точки очереди и действия управления.
Да. Каждый слот AMS отслеживается как катушка филамента в Менеджере филамента, поэтому загруженные катушки появляются в /filament/GetFilament с указанием бренда, материала, цвета, оставшегося веса, принтера и слота. SimplyPrint поддерживает AMS, AMS Lite, AMS 2 Pro и AMS HT.
Да. Загрузите 3MF или G-code после слайсинга, отправьте POST в /queue/AddItem, указав ID файла и целевой принтер. Очередь направит задание на Bambu Lab, в AMS которого загружены нужные цвета. Если подходящего Bambu нет, задание останется в очереди, пока такой принтер не появится.
SimplyPrint независим: он не является частью Bambu Lab. SimplyPrint подключается к принтерам Bambu Lab посредством общедоступных протоколов, которые Bambu Lab поддерживает для сторонних инструментов, так же, как это делает любая другая облачная панель.
Да. SimplyPrint поддерживает как облачные принтеры Bambu Lab, так и режим только LAN через лёгкий локальный мост. С точки зрения API принтеры только LAN ведут себя так же, как облачные принтеры.
https://api.simplyprint.io/{companyId}/{endpoint}. {companyId} это ID вашего аккаунта, а не версия. Аутентификация выполняется через один заголовок: X-API-KEY: your_key_here.
Да. Поток OAuth2 позволяет каждому владельцу подключить свой аккаунт SimplyPrint к вашему приложению через экран согласия, без общих ключей API. Полные сведения об OAuth2 и форму запроса клиента см. на главной странице API.

Innehållsförteckning