Un'API REST per una flotta Bambu Lab, AMS incluso

Bambu Lab API Bambu Lab

SimplyPrint è il pannello cloud per flotte Bambu Lab, con visibilità completa sull'AMS, instradamento della coda, tracciamento del filamento e stato in tempo reale. L'API consente al software proprietario di controllare la flotta. Mettere in coda stampe su uno specifico X1C, mettere in pausa un P1S, leggere quali bobine sono caricate in un'unità AMS, inviare un comando G-code, un solo header, JSON in entrata, JSON in uscita. La stessa API funziona sia con un P1S sia con duecento X1C.

Voir l’aperçu de API Commencer gratuitement Plus d’infos & mode d’emploi
Image de la fonctionnalité

Compatibile con l'intera gamma Bambu Lab

X1C, X1E, P1S, P1P, A1, A1 Mini e H2D si collegano tutte a SimplyPrint ed espongono la stessa interfaccia API. AMS, AMS Lite, AMS 2 Pro e AMS HT vengono riconosciuti, mentre le bobine caricate compaiono nella stessa risposta dell'inventario filamenti delle stampanti collegate con qualsiasi altro metodo.

Accodare una stampa su una Bambu Lab specifica con una chiamata API

Inviare una richiesta POST con l'ID di un file 3MF o G-code, selezionare una stampante Bambu Lab tramite ID e SimplyPrint lo inserisce nella coda. I 3MF multicolore vengono sottoposti a slicing con lo stesso motore usato dal pannello e la coda instrada il lavoro a una stampante il cui AMS contiene i colori richiesti.

# 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"
  }'
Per l'automazione: omettendo completamente for_printers, SimplyPrint seleziona la prima Bambu Lab operativa il cui AMS ha già caricati i colori corretti, utile per farm con oltre 10 X1C affiancate.

Come SimplyPrint si connette a una stampante Bambu Lab

Il controllo completo di una stampante Bambu Lab da SimplyPrint richiede il SimplyPrint Bambu Lab Client: un piccolo processo ponte eseguito sulla rete locale, su un Raspberry Pi, mini PC o qualsiasi macchina Mac/Windows/Linux sempre accesa. Il ponte si trova nella stessa LAN delle stampanti e comunica con esse localmente, quindi si collega al cloud di SimplyPrint via Internet per tuo conto. Le stampanti non richiedono mai una connessione pubblica, restano solo LAN e il controllo remoto resta completo da qualsiasi luogo.

  • Controllo completo, avvio stampe, AMS, temperatura, movimento e webcam: stampante in Modalità solo LAN con Modalità sviluppatore attiva, più SimplyPrint Bambu Lab Client in esecuzione come ponte. Questo è il percorso supportato nel firmware Bambu attuale.
  • Solo monitoraggio (stato, avanzamento, stato AMS, webcam, statistiche): stampante in modalità Cloud + SimplyPrint Bambu Lab Client. Tutto è visibile, ma non è possibile avviare stampe da SimplyPrint: l'Authorization Control System (ACS, 2025) di Bambu blocca le azioni di scrittura di terze parti attraverso il cloud Bambu.
  • Nessuna connessione alla stampante: non aggiungere affatto la stampante. Cloud Slicer, Gestore del filamento, archiviazione file e strumenti per etichette restano utilizzabili; le stampe si avviano da Bambu Studio / Bambu Handy come di consueto.
Una volta connesso il bridge, la stampante appare come oggetto stampante standard nell'API. GET /printers/Get restituisce la stessa struttura sia per una Bambu Lab, una Prusa, una Creality o qualsiasi altra stampante, quindi il codice resta indipendente dal marchio.

Guida completa alla configurazione Bambu Lab: solo LAN o Cloud
Image de la fonctionnalité
Image de la fonctionnalité

Utilizzare SimplyPrint insieme a Bambu Studio Cloud

Non occorre scegliere tra i due. Si può continuare a usare Bambu Studio e Bambu Handy come slicer e app per il controllo rapido, lasciando a SimplyPrint la coda della flotta, l'instradamento compatibile con AMS, l'inventario filamenti e la REST API. Entrambi usano la stessa connessione alla stampante: non ci sono conflitti, flag di esclusività né configurazioni aggiuntive sulla stampante per farli coesistere.

Leggere lo stato, controllare le stampe, inviare G-code

Ogni endpoint di controllo stampante funziona allo stesso modo su una Bambu Lab e su qualsiasi altra stampante. Si passa l'ID stampante e si riceve 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"
Mettere in pausa una stampa in corso senza toccare la stampante:
# 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 }'

Image de la fonctionnalité

Automazione basata su AMS: lettura delle bobine caricate, accodamento del lavoro corretto

Gli slot AMS di ogni stampante Bambu Lab sono tracciati come bobine di filamento nel Gestore filamenti di SimplyPrint. L'API espone gli stessi dati: marca, materiale, colore, peso residuo e slot di ogni bobina. L'automazione può controllare cosa è caricato al momento e inserire in coda una stampa compatibile oppure avvisare una persona per cambiare bobina.

# Inspect filament spools - useful for AMS-aware automation
curl "https://api.simplyprint.io/{companyId}/filament/GetFilament" \
  -H "X-API-KEY: your_api_key_here"
La funzionalità multimateriale di SimplyPrint supporta AMS, AMS Lite, AMS 2 Pro e AMS HT: 4 unità AMS collegabili in catena per stampante × 4 slot ciascuna = fino a 16 colori su X1C/P1S. L'API non ha un endpoint separato per AMS: lo stato AMS è incluso nell'oggetto stampante e le bobine caricate sono nell'inventario filamenti.

Vedi il supporto per Bambu Lab AMS

Cosa si crea con l'API Bambu Lab

  • Hook Shopify / WooCommerce: arriva un ordine multicolore e viene creata automaticamente una voce nella coda di SimplyPrint per la stampante Bambu Lab nel cui AMS è già caricata la palette corretta.
  • Dashboard della flotta: dashboard Grafana / Notion / Svelte personalizzate montate a parete, con lo stato in tempo reale di ogni X1C, P1S e A1 nel laboratorio e i dati degli slot AMS per stampante.
  • Bot Slack / Discord: bot che mettono in pausa una stampa fuori controllo, segnalano "la P1S ha appena terminato la stampa n. 128" o riassumono l'uso di filamento della flotta Bambu in una settimana.
  • Prenotazioni per didattica/makerspace: un sistema di prenotazione riserva una P1S, mette in coda il G-code dello studente e archivia il lavoro nella sua carriera al termine.

Perché usare SimplyPrint invece del cloud di Bambu?

Bambu Handy e il cloud di Bambu Studio offrono il pannello remoto di Bambu Lab e stampe dallo slicer Bambu Studio. SimplyPrint si affianca, offrendo alla flotta funzionalità che il cloud proprietario di Bambu non include:

  • API per flotte multimarca: lo stesso codice che gestisce una Bambu Lab X1C gestisce anche una Prusa MK4, una Anycubic Kobra o qualsiasi sistema compatibile con OctoPrint.
  • Logica di coda, approvazione e instradamento: non solo controllo stampante per stampante: una vera coda multi-stampante con flussi di approvazione, autorizzazioni per utente e instradamento automatico.
  • Inventario filamento dell'intera officina: non solo ciò che è caricato in un AMS, ma ogni bobina nel Gestore filamento, con tracciamento del costo per grammo.
  • OAuth2 per integrazioni partner: offrire un'integrazione che gli utenti collegano al proprio account SimplyPrint, senza dover condividere credenziali Bambu.
  • Eventi push Webhook: SimplyPrint invia POST non appena accade qualcosa, senza polling.
SimplyPrint e gli strumenti ufficiali Bambu possono coesistere; usarli entrambi non crea problemi.

Visualizzare la pagina principale dell'API

Accesso all'API Bambu Lab per piano

Stesse limitazioni per piano della principale API SimplyPrint. I piani Free e Basic non offrono API; Pro e successivi sbloccano l'API Basic; Print Farm e successivi sbloccano Enhanced (capacità di scrittura per modificare la coda e avviare stampe).

Fonctionnalité / limite Gratuit Basic Pro Ferme d’impression Enterprise École Slicer cloud Gestionnaire de filament
Richieste API al minuto
Limite mobile al minuto condiviso tra tutte le chiamate API dell'account.
- - 60 180 600 180 - -
Accesso API di base
Leggere stato della stampante, coda di stampa, lavori e cronologia di ogni Bambu Lab dell'account.
API avanzata (avviare stampe, inviare G-code)
Consente caricamenti di file, modifiche alla coda di stampa che avviano stampe e invio diretto di G-code.

Vous voulez en savoir plus sur nos forfaits ?

Voir tous les tarifs et comparer les fonctionnalités

Domande frequenti sull'API Bambu Lab

X1C, X1E, P1S, P1P, A1, A1 Mini e H2D si collegano tutte a SimplyPrint. Una volta collegate, espongono la stessa interfaccia API, con la stessa struttura di risposta /printers/Get, gli stessi endpoint della coda e le stesse azioni di controllo.
Sì. Ogni slot AMS è tracciato come bobina di filamento in Filament Manager, quindi le bobine caricate vengono visualizzate in /filament/GetFilament con marca, materiale, colore, peso rimanente e stampante + slot in cui si trovano. SimplyPrint supporta AMS, AMS Lite, AMS 2 Pro e AMS HT.
Sì. È possibile caricare un 3MF o G-code sezionato ed eseguire POST su /queue/AddItem con ID file e stampante di destinazione. La coda inoltra il lavoro a una Bambu Lab il cui AMS contiene i colori corretti. Se nessuna Bambu corrisponde, l'elemento resta in coda finché non ne è disponibile una.
SimplyPrint è indipendente, non fa parte di Bambu Lab. SimplyPrint si collega alle stampanti Bambu Lab tramite i protocolli pubblicamente disponibili supportati da Bambu Lab per strumenti di terze parti, come farebbe qualsiasi altro pannello cloud.
Sì. SimplyPrint supporta sia le stampanti Bambu Lab collegate al cloud sia la modalità solo LAN tramite un leggero bridge locale. Dal punto di vista dell'API, le stampanti solo LAN si comportano in modo identico alle stampanti cloud.
https://api.simplyprint.io/{companyId}/{endpoint}. {companyId} è l'ID dell'account, non una versione. L'autenticazione richiede un'intestazione: X-API-KEY: your_key_here.
Sì. Il flusso OAuth2 consente a ogni proprietario di collegare il proprio account SimplyPrint all'app tramite una schermata di consenso, senza chiavi API condivise. Vedere la pagina API principale per i dettagli completi su OAuth2 e il modulo di richiesta client.

Table des matières