Une API REST pour votre flotte Bambu Lab, AMS compris

Bambu Lab API Bambu Lab

SimplyPrint est le tableau de bord cloud des flottes Bambu Lab, avec visibilité complète sur l’AMS, routage de la file d’impression, suivi du filament et état en direct. L’API permet à votre propre logiciel de piloter cette flotte. Vous pouvez mettre des impressions en file sur une X1C spécifique, mettre en pause une P1S, consulter les bobines chargées dans une unité AMS et envoyer une commande G-code, avec un seul en-tête, JSON en entrée et JSON en sortie. La même API fonctionne que vous ayez une P1S ou deux cents X1C.

Se oversikt over API Kom gratis i gang Mer info og guide
Funksjonsbilde

Compatible avec toute la gamme Bambu Lab

X1C, X1E, P1S, P1P, A1, A1 Mini et H2D se connectent tous à SimplyPrint et exposent tous la même interface API. AMS, AMS Lite, AMS 2 Pro et AMS HT sont reconnus, les bobines chargées apparaissent dans la même réponse d’inventaire de filament que les imprimantes connectées par toute autre voie.

Mettez une impression en file sur une Bambu Lab spécifique en un appel API

Envoyez via POST l’ID d’un fichier 3MF ou G-code, ciblez une imprimante Bambu Lab par son ID et SimplyPrint l’ajoute à la file d’impression. Les fichiers 3MF multicolores sont slicés par le même moteur que celui utilisé par l’interface, et la file d’impression dirige la tâche vers une imprimante dont l’AMS contient les couleurs requises.

# 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"
  }'
Pour l’automatisation, il suffit d’omettre entièrement for_printers, et SimplyPrint sélectionne la première imprimante Bambu Lab opérationnelle dont l’AMS contient déjà les bonnes couleurs, utile pour les ateliers exploitant plus de 10 X1C côte à côte.

Comment SimplyPrint se connecte à votre imprimante Bambu Lab

Le contrôle complet d’une imprimante Bambu Lab depuis SimplyPrint nécessite le SimplyPrint Bambu Lab Client : un petit service passerelle qui s’exécute sur votre réseau, sur un Raspberry Pi, un mini PC ou toute machine Mac/Windows/Linux toujours allumée. La passerelle se trouve sur le même LAN que vos imprimantes et communique avec elles localement, puis se connecte au cloud de SimplyPrint via Internet en votre nom. Les imprimantes elles-mêmes n’ont jamais besoin de connexion publique : elles restent en mode LAN uniquement tout en vous laissant le contrôle à distance complet, où que vous soyez.

  • Contrôle total (lancement des impressions, AMS, température, mouvements, webcam) : imprimante en mode LAN uniquement, avec le mode développeur activé, et le SimplyPrint Bambu Lab Client comme passerelle. C’est le parcours pris en charge par le firmware Bambu actuel.
  • Supervision uniquement (état, progression, état de l’AMS, webcam, statistiques) : imprimante en mode Cloud + SimplyPrint Bambu Lab Client. Vous voyez tout, mais ne pouvez pas lancer d’impressions depuis SimplyPrint : l’Authorization Control System (ACS, 2025) de Bambu bloque les actions d’écriture tierces via le cloud Bambu.
  • Aucune connexion à l’imprimante : n’ajoutez pas du tout l’imprimante. Le slicer cloud, le gestionnaire de filament, le stockage de fichiers et les outils d’étiquetage fonctionnent toujours, vous lancez les impressions depuis Bambu Studio / Bambu Handy comme d’habitude.
Une fois le pont connecté, l’imprimante apparaît comme un objet d’imprimante standard dans l’API. GET /printers/Get renvoie la même structure, qu’il s’agisse d’une Bambu Lab, d’une Prusa, d’une Creality ou de tout autre modèle, votre code reste donc indépendant de la marque.

Guide complet de configuration Bambu Lab : LAN uniquement ou Cloud
Funksjonsbilde
Funksjonsbilde

Utilisez SimplyPrint avec Bambu Studio Cloud

Vous n’avez pas à choisir l’un ou l’autre. Continuez à utiliser Bambu Studio et Bambu Handy comme slicer et application de contrôle rapide, et laissez SimplyPrint gérer la file d’impression de votre parc, le routage tenant compte de l’AMS, l’inventaire de filament et l’API REST. Les deux utilisent la même connexion à l’imprimante : il n’y a ni conflit, ni indicateur d’exclusivité, ni configuration supplémentaire sur l’imprimante pour les faire coexister.

Lire l’état, contrôler les impressions, envoyer du G-code

Chaque point de terminaison de contrôle d’imprimante fonctionne de la même façon sur une Bambu Lab que sur toute autre imprimante. Transmettez l’ID de l’imprimante, recevez du JSON en retour.

# 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"
Mettre en pause une impression en cours sans toucher à l’imprimante :
# 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 }'

Funksjonsbilde

Automatisation adaptée à l’AMS : lit les bobines chargées, met en file l’impression adaptée

Les emplacements AMS de chaque imprimante Bambu Lab sont suivis comme des bobines de filament dans le gestionnaire de filaments SimplyPrint. L’API expose les mêmes données : la marque, le matériau, la couleur et le poids restant de chaque bobine, ainsi que son emplacement. Votre automatisation peut vérifier ce qui est chargé maintenant, puis soit mettre en file une impression correspondante, soit avertir quelqu’un pour changer une bobine.

# Inspect filament spools - useful for AMS-aware automation
curl "https://api.simplyprint.io/{companyId}/filament/GetFilament" \
  -H "X-API-KEY: your_api_key_here"
Le volet multi-matériaux de SimplyPrint prend en charge AMS, AMS Lite, AMS 2 Pro et AMS HT : 4 unités AMS chaînables par imprimante × 4 emplacements chacune = jusqu’à 16 couleurs sur une X1C/P1S. L’API ne dispose pas d’un point de terminaison distinct par AMS ; l’état AMS se trouve dans l’objet imprimante et les bobines chargées dans l’inventaire de filament.

Voir la prise en charge du Bambu Lab AMS

Ce que les utilisateurs créent avec l’API Bambu Lab

  • Connexions Shopify / WooCommerce : une commande multicolore arrive et un élément de la file d’impression SimplyPrint est créé automatiquement pour la Bambu Lab dont l’AMS contient déjà la bonne palette.
  • Tableaux de bord de parc : tableaux Grafana / Notion / Svelte personnalisés, montés au mur, affichant l’état en direct de chaque X1C, P1S et A1 de l’atelier, avec les données des emplacements AMS par imprimante.
  • Bots Slack / Discord : des bots qui mettent en pause une impression incontrôlée, signalent « la P1S vient de terminer l’impression n° 128 » ou résument l’utilisation de filament de la flotte Bambu sur une semaine.
  • Réservations pour l’éducation / makerspaces : un système de réservation réserve une P1S, met le G-code de l’étudiant en file, puis archive l’impression dans son dossier lorsqu’elle se termine.

Pourquoi utiliser SimplyPrint plutôt que le cloud de Bambu ?

Bambu Handy et le cloud de Bambu Studio vous donnent accès à l’interface de contrôle à distance de Bambu Lab et aux impressions issues du slicer Bambu Studio. SimplyPrint les complète en apportant à votre flotte ce que le cloud propriétaire de Bambu n’offre pas :

  • API de parc multi-marque : le même code qui pilote une Bambu Lab X1C pilote aussi une Prusa MK4, une Anycubic Kobra ou toute imprimante compatible OctoPrint.
  • File d’impression, approbation et logique de routage : pas seulement le contrôle imprimante par imprimante : une véritable file multi-imprimantes avec des processus d’approbation, des autorisations par utilisateur et le routage automatique.
  • Inventaire de filament dans tout l’atelier : pas uniquement ce qui est chargé dans un AMS, mais chaque bobine de votre gestionnaire de filament, avec suivi du coût au gramme.
  • OAuth2 pour les intégrations partenaires : proposez une intégration que vos utilisateurs connectent à leur propre compte SimplyPrint, sans devoir partager leurs identifiants Bambu.
  • Événements push par Webhook : SimplyPrint envoie un POST dès qu’un événement se produit, sans interrogation.
SimplyPrint et les outils officiels de Bambu peuvent coexister, utiliser les deux ne pose aucun problème.

Voir la page principale de l’API

Accès par forfait : API Bambu Lab

Même accès par forfait que l’API SimplyPrint principale. Les forfaits Free et Basic n’exposent pas d’API ; Pro et les forfaits supérieurs débloquent l’API Basic ; Print Farm et les forfaits supérieurs débloquent Enhanced (capacité d’écriture pour modifier la file d’impression et démarrer des impressions).

Funksjon / begrensning Gratis Basic Pro Printfarm Enterprise Skole Cloud Slicer Filamenthåndterer
Requêtes API par minute
Limite glissante par minute partagée entre tous les appels API du compte.
- - 60 180 600 180 - -
Accès à l’API de base
Lire l’état, la file d’attente, les tâches d’impression et l’historique de chaque imprimante Bambu Lab du compte.
API avancée (démarrer des impressions, envoyer du G-code)
Permet l’import de fichiers, les modifications de la file d’impression déclenchant des impressions et l’envoi direct de G-code.

Vil du vite mer om abonnementene våre?

Se full pris- og funksjonssammenligning

Questions fréquentes sur l’API Bambu Lab

X1C, X1E, P1S, P1P, A1, A1 Mini et H2D se connectent tous à SimplyPrint. Une fois connectés, ils exposent tous la même interface API, le même format de réponse /printers/Get, les mêmes points de terminaison de file d’impression et les mêmes actions de contrôle.
Oui. Chaque emplacement AMS est suivi comme une bobine de filament dans le Filament Manager. Les bobines chargées apparaissent donc dans /filament/GetFilament avec la marque, le matériau, la couleur, le poids restant et l’imprimante et l’emplacement où elles se trouvent. SimplyPrint prend en charge AMS, AMS Lite, AMS 2 Pro et AMS HT.
Oui. Téléversez un 3MF ou un G-code préparé, envoyez une requête POST à /queue/AddItem avec l’ID du fichier et l’imprimante cible. La file achemine la tâche vers une Bambu Lab dont l’AMS contient les bonnes couleurs. Si aucune Bambu Lab ne convient, l’élément reste dans la file jusqu’à ce que ce soit le cas.
SimplyPrint est indépendant, nous ne faisons pas partie de Bambu Lab. SimplyPrint se connecte aux imprimantes Bambu Lab via les protocoles accessibles publiquement que Bambu Lab prend en charge pour les outils tiers, comme le ferait tout autre tableau de bord cloud.
Oui. SimplyPrint prend en charge les imprimantes Bambu Lab connectées au cloud comme le mode LAN uniquement via une fine passerelle locale. Du point de vue de l’API, les imprimantes en mode LAN uniquement se comportent exactement comme les imprimantes cloud.
https://api.simplyprint.io/{companyId}/{endpoint}. Le {companyId} est l’ID de votre compte, pas une version. L’authentification se fait avec un seul en-tête : X-API-KEY: your_key_here.
Oui. Le flux OAuth2 permet à chaque propriétaire de connecter son propre compte SimplyPrint à votre application via un écran de consentement, sans clés API partagées. Consultez la page principale de l’API pour tous les détails OAuth2 et le formulaire de demande client.

Innholdsfortegnelse