REST API dla floty Bambu Lab, włącznie z AMS

Bambu Lab Bambu Lab API

SimplyPrint to panel chmurowy dla flot Bambu Lab z pełnym wglądem w AMS, kierowaniem kolejką, śledzeniem filamentu i bieżącym stanem. API pozwala własnemu oprogramowaniu sterować tą flotą. Można ustawiać wydruki w kolejce dla konkretnego X1C, wstrzymać P1S, odczytać szpule załadowane do jednostki AMS, wysłać polecenie G-code, jeden nagłówek, JSON wejściowy, JSON wyjściowy. To samo API działa zarówno dla jednego P1S, jak i dwustu X1C.

Zobacz przegląd funkcji: API Rozpocznij za darmo Więcej informacji i poradnik
Ilustracja funkcji

Zgodność z całą ofertą Bambu Lab

X1C, X1E, P1S, P1P, A1, A1 Mini i H2D łączą się z SimplyPrint oraz udostępniają ten sam zakres API. AMS, AMS Lite, AMS 2 Pro i AMS HT są rozpoznawane, a załadowane szpule pojawiają się w tej samej odpowiedzi API magazynu filamentu co drukarki podłączone inną metodą.

Dodawanie wydruku do kolejki na konkretnej drukarce Bambu Lab jednym wywołaniem API

Po przesłaniu metodą POST ID pliku 3MF lub G-code i wskazaniu po ID drukarki Bambu Lab, SimplyPrint dodaje zadanie do kolejki. Wielokolorowe pliki 3MF są przygotowywane przez ten sam silnik, którego używa panel, a kolejka kieruje zadanie do drukarki z AMS zawierającym załadowane wymagane kolory.

# 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"
  }'
W automatyzacji należy całkowicie pominąć for_printers, a SimplyPrint wybierze pierwszą działającą drukarkę Bambu Lab, której AMS ma już załadowane właściwe kolory. Przydatne w pracowniach z flotą ponad 10 X1C stojących obok siebie.

Jak SimplyPrint łączy się z drukarką Bambu Lab

Pełna kontrola nad drukarką Bambu Lab z SimplyPrint wymaga SimplyPrint Bambu Lab Client, niewielkiego procesu pośredniczącego działającego w sieci na Raspberry Pi, mini PC lub dowolnym stale włączonym komputerze Mac/Windows/Linux. Most działa w tej samej sieci LAN co drukarki i komunikuje się z nimi lokalnie, następnie łączy się z chmurą SimplyPrint przez internet w imieniu użytkownika. Same drukarki nigdy nie wymagają publicznego połączenia, pozostają tylko w LAN, a pełna zdalna kontrola jest dostępna z dowolnego miejsca.

  • Pełna kontrola (uruchamianie wydruków, AMS, temperatura, ruch, kamera): drukarka w trybie tylko LAN z włączonym trybem deweloperskim, a SimplyPrint Bambu Lab Client działa jako most. To obsługiwana ścieżka w obecnym firmware Bambu.
  • Tylko monitorowanie (stan, postęp, stan AMS, kamera internetowa, statystyki): drukarka w trybie Cloud + SimplyPrint Bambu Lab Client. Wszystko jest widoczne, ale nie można uruchamiać wydruków z SimplyPrint, system Bambu Authorization Control System (ACS, 2025) blokuje zewnętrzne działania zapisu przez chmurę Bambu.
  • Brak połączenia z drukarką: nie należy dodawać drukarki. Slicer chmurowy, Menedżer filamentu, przechowywanie plików i narzędzia etykiet nadal działają, a wydruki uruchamia się standardowo z Bambu Studio / Bambu Handy.
Po podłączeniu mostka drukarka pojawia się w API jako standardowy obiekt drukarki. GET /printers/Get zwraca tę samą strukturę niezależnie od tego, czy jest to Bambu Lab, Prusa, Creality czy inna drukarka, więc kod pozostaje niezależny od marki.

Pełny przewodnik konfiguracji Bambu Lab: tylko LAN czy chmura
Ilustracja funkcji
Ilustracja funkcji

Korzystać z SimplyPrint razem z Bambu Studio Cloud

Nie trzeba wybierać jednego rozwiązania. Można nadal używać Bambu Studio i Bambu Handy jako slicera i aplikacji szybkiego sterowania, a SimplyPrint wykorzystać do obsługi kolejki floty, trasowania uwzględniającego AMS, magazynu filamentu i REST API. Oba rozwiązania korzystają z tego samego połączenia z drukarką, nie ma więc konfliktu, flagi wyłączności ani potrzeby dodatkowej konfiguracji drukarki.

Odczyt stanu, sterowanie wydrukami, wysyłanie G-code

Każdy punkt końcowy sterowania drukarką działa tak samo dla Bambu Lab jak dla każdej innej drukarki. Wystarczy przekazać ID drukarki, aby otrzymać 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"
Wstrzymać trwający wydruk bez dotykania drukarki:
# 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 }'

Ilustracja funkcji

Automatyzacja uwzględniająca AMS: odczyt załadowanych szpul, kolejkowanie właściwego zadania

Gniazda AMS każdej drukarki Bambu Lab są śledzone jako szpule filamentu w Menedżerze filamentu SimplyPrint. API udostępnia te same dane: markę każdej szpuli, materiał, kolor, pozostałą masę i zajmowane gniazdo. Automatyzacja może sprawdzić, co jest teraz załadowane, i albo dodać do kolejki pasujący wydruk, albo powiadomić osobę o konieczności zmiany szpuli.

# Inspect filament spools - useful for AMS-aware automation
curl "https://api.simplyprint.io/{companyId}/filament/GetFilament" \
  -H "X-API-KEY: your_api_key_here"
Obsługa wielu materiałów w SimplyPrint obejmuje AMS, AMS Lite, AMS 2 Pro i AMS HT: 4 jednostki AMS można połączyć na drukarkę × 4 gniazda każda = do 16 kolorów na X1C/P1S. API nie ma osobnego punktu końcowego dla każdego AMS: stan AMS znajduje się w obiekcie drukarki, a załadowane szpule są w magazynie filamentów.

Zobacz obsługę Bambu Lab AMS

Co ludzie tworzą za pomocą API Bambu Lab

  • Integracje z Shopify / WooCommerce: po złożeniu wielokolorowego zamówienia automatycznie tworzony jest element kolejki SimplyPrint dla drukarki Bambu Lab, której AMS ma już załadowaną właściwą paletę.
  • Panele floty: montowane na ścianie panele Grafana / Notion / własne w Svelte, pokazujące na żywo stan każdej drukarki X1C, P1S i A1 w pracowni, z danymi o slotach AMS dla każdej drukarki.
  • Boty Slack / Discord: boty, które wstrzymują wydruk wymykający się spod kontroli, zgłaszają „Drukarka P1S właśnie ukończyła wydruk nr 128” albo podsumowują tygodniowe zużycie filamentu we flocie Bambu.
  • Rezerwacje dla edukacji i makerspace'ów: system rezerwacji rezerwuje P1S, dodaje G-code ucznia do kolejki, a po zakończeniu archiwizuje zlecenie w historii ucznia.

Dlaczego warto wybrać SimplyPrint zamiast własnej chmury Bambu?

Bambu Handy i chmura Bambu Studio zapewniają własny panel zdalny Bambu Lab oraz wydruki ze slicera Bambu Studio. SimplyPrint działa obok nich, zapewniając flocie funkcje, których nie oferuje chmura Bambu:

  • API dla floty wielu marek: ten sam kod, który obsługuje Bambu Lab X1C, obsługuje też Prusa MK4, Anycubic Kobra i wszystko zgodne z OctoPrint.
  • Logika kolejki, zatwierdzania i kierowania: nie tylko sterowanie drukarkami pojedynczo - prawdziwa kolejka wielodrukarkowa z procesami zatwierdzania, uprawnieniami dla użytkowników i automatycznym kierowaniem.
  • Magazyn filamentu w całej pracowni: nie tylko to, co załadowano do jednego AMS, lecz każda szpula w Menedżerze filamentu, ze śledzeniem kosztu za gram.
  • OAuth2 dla integracji partnerów: integracja umożliwia użytkownikom połączenie własnego konta SimplyPrint zamiast udostępniania danych uwierzytelniających Bambu.
  • Zdarzenia push Webhook: SimplyPrint wysyła POST w chwili wystąpienia zdarzenia, bez odpytywania.
SimplyPrint i narzędzia Bambu własnej produkcji mogą współistnieć, korzystanie z obu jest możliwe.

Zobacz główną stronę API

Dostęp w planach do API Bambu Lab

Takie same ograniczenia planów jak w głównym API SimplyPrint. Plany Free i Basic nie udostępniają API; Pro i wyższe odblokowują Basic API; Print Farm i wyższe odblokowują Enhanced (możliwość zapisu przy modyfikacji kolejki i uruchamianiu wydruków).

Funkcja / limit Za darmo Basic Pro Farma druku Enterprise Szkoła Slicer w chmurze Menedżer filamentu
Żądania API na minutę
Kroczący limit liczby wywołań na minutę, wspólny dla wszystkich wywołań API konta.
- - 60 180 600 180 - -
Dostęp do podstawowego API
Odczyt stanu drukarki, kolejki wydruku, zadań i historii dla każdej drukarki Bambu Lab na koncie.
Rozszerzone API (rozpoczynanie wydruków, wysyłanie G-code)
Odblokowuje przesyłanie plików, modyfikacje kolejki uruchamiające wydruki i bezpośrednie wysyłanie G-code.

Więcej informacji o naszych planach?

Zobacz pełny cennik i porównanie funkcji

Najczęstsze pytania o API Bambu Lab

X1C, X1E, P1S, P1P, A1, A1 Mini i H2D łączą się z SimplyPrint. Po podłączeniu wszystkie udostępniają ten sam zakres API, ten sam format odpowiedzi /printers/Get, te same endpointy kolejki i działania sterujące.
Tak. Każde gniazdo AMS jest śledzone jako szpula filamentu w Menedżerze filamentu, więc załadowane szpule pojawiają się w /filament/GetFilament wraz z marką, materiałem, kolorem, pozostałą masą oraz informacją, w której drukarce i gnieździe się znajdują. SimplyPrint obsługuje AMS, AMS Lite, AMS 2 Pro i AMS HT.
Tak. Można przesłać 3MF lub przetworzony przez slicer G-code i wykonać POST na /queue/AddItem z identyfikatorem pliku i docelową drukarką. Kolejka kieruje zlecenie do drukarki Bambu Lab z właściwymi kolorami załadowanymi w AMS; jeśli żadna nie pasuje, pozycja pozostaje w kolejce, aż taka się znajdzie.
SimplyPrint jest niezależny, nie należy do Bambu Lab. SimplyPrint łączy się z drukarkami Bambu Lab przez publicznie dostępne protokoły, które Bambu Lab obsługuje dla narzędzi innych firm, tak jak każdy inny panel chmurowy.
Tak. SimplyPrint obsługuje zarówno drukarki Bambu Lab połączone z chmurą, jak i tryb tylko LAN przez lekką lokalną bramę. Z perspektywy API drukarki tylko LAN działają identycznie jak drukarki chmurowe.
https://api.simplyprint.io/{companyId}/{endpoint}. {companyId} to identyfikator konta, nie wersja. Do uwierzytelnienia wystarczy jeden nagłówek: X-API-KEY: your_key_here.
Tak. Przepływ OAuth2 pozwala każdemu właścicielowi połączyć własne konto SimplyPrint z aplikacją przez ekran zgody, bez wspólnych kluczy API. Pełne informacje o OAuth2 oraz formularz wniosku o utworzenie klienta znajdują się na głównej stronie API.

Spis treści