Una API REST para tu flota Bambu Lab, AMS incluido

Bambu Lab Bambu Lab API

SimplyPrint es el panel en la nube para flotas Bambu Lab, con visibilidad completa de AMS, enrutamiento de cola, seguimiento de filamento y estado en directo. La API permite que tu propio software gestione esa flota. Pon impresiones en cola en una X1C específica, pausa una P1S, consulta qué bobinas están cargadas en una unidad AMS, envía un comando G-code, una cabecera, JSON de entrada, JSON de salida. La misma API funciona tanto si tienes una P1S como doscientas X1C.

查看API概览 免费开始使用 更多信息和操作指南
功能图像

Compatible con toda la gama de Bambu Lab

X1C, X1E, P1S, P1P, A1, A1 Mini y H2D se conectan a SimplyPrint y todas exponen la misma interfaz API. AMS, AMS Lite, AMS 2 Pro y AMS HT se reconocen, las bobinas cargadas aparecen en la misma respuesta del inventario de filamento que las impresoras conectadas por cualquier otra vía.

Pon una impresión en la cola de una Bambu Lab específica con una llamada a la API

Envía mediante POST un ID de archivo 3MF o G-code, indica una impresora Bambu Lab por ID y SimplyPrint lo añade a la cola de impresión. Los 3MF multicolor se laminan con el mismo motor que usa el panel, y la cola de impresión dirige el trabajo a una impresora cuyo AMS tiene cargados los colores necesarios.

# 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"
  }'
Para la automatización: omite por completo for_printers y SimplyPrint elegirá la primera Bambu Lab operativa cuyo AMS ya tenga cargados los colores adecuados, útil para talleres con flotas de más de 10 X1C lado a lado.

Cómo se conecta SimplyPrint a tu impresora Bambu Lab

Para controlar por completo una impresora Bambu Lab desde SimplyPrint necesitas el SimplyPrint Bambu Lab Client, un pequeño proceso puente que se ejecuta en tu red en una Raspberry Pi, mini PC o cualquier equipo Mac/Windows/Linux siempre encendido. El puente está en la misma LAN que tus impresoras y se comunica con ellas localmente; después se conecta a la nube de SimplyPrint por Internet en tu nombre. Las impresoras nunca necesitan una conexión pública, se mantienen solo en LAN mientras conservas el control remoto total desde cualquier lugar.

  • Control total (iniciar impresiones, AMS, temperatura, movimiento, webcam): impresora en modo solo LAN con modo desarrollador activado, además del cliente SimplyPrint Bambu Lab ejecutándose como puente. Esta es la vía compatible con el firmware Bambu actual.
  • Solo monitorización (estado, progreso, estado de AMS, webcam, estadísticas): impresora en modo Cloud + SimplyPrint Bambu Lab Client. Lo ves todo, pero no puedes iniciar impresiones desde SimplyPrint: el Authorization Control System de Bambu (ACS, 2025) bloquea las acciones de escritura de terceros en la nube de Bambu.
  • Sin conexión de impresora: no añadas la impresora. Cloud Slicer, Filament Manager, el almacenamiento de archivos y las herramientas de etiquetas siguen funcionando; inicia las impresiones desde Bambu Studio/Bambu Handy como siempre.
Una vez conectado el puente, la impresora aparece como un objeto de impresora estándar en la API. GET /printers/Get devuelve la misma estructura tanto si la impresora es una Bambu Lab, una Prusa, una Creality o cualquier otra, por lo que tu código sigue siendo independiente de la marca.

Guía completa de configuración de Bambu Lab: solo LAN o Cloud
功能图像
功能图像

Usa SimplyPrint junto con Bambu Studio Cloud

No tienes que elegir una u otra. Sigue usando Bambu Studio y Bambu Handy como slicer y aplicación de control rápido, y deja que SimplyPrint se encargue de la cola de la flota, la asignación según AMS, el inventario de filamento y la API REST. Ambas leen de la misma conexión de impresora: no hay conflicto, indicador de exclusividad ni configuración adicional en la impresora para que convivan.

Consultar el estado, controlar impresiones y enviar G-code

Cada endpoint de control de impresoras funciona igual en una Bambu Lab que en cualquier otra impresora. Pasa el ID de impresora y recibe 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"
Pausa una impresión en curso sin tocar la impresora:
# 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 }'

功能图像

Automatización compatible con AMS: lee las bobinas cargadas y pone en cola el trabajo adecuado

Las ranuras AMS de cada impresora Bambu Lab se registran como bobinas de filamento en el Gestor de filamento de SimplyPrint. La API expone los mismos datos: la marca, el material, el color, el peso restante y la ranura de cada bobina. Tu automatización puede comprobar qué hay cargado ahora y poner en cola una impresión compatible o avisar a una persona para cambiar una 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 parte multimaterial de SimplyPrint cubre AMS, AMS Lite, AMS 2 Pro y AMS HT, 4 unidades AMS encadenables por impresora × 4 ranuras cada una = hasta 16 colores en una X1C/P1S. La API no tiene un endpoint separado por AMS; el estado de AMS está dentro del objeto de impresora y las bobinas cargadas están en el inventario de filamento.

Ver compatibilidad con Bambu Lab AMS

Lo que la gente crea con la API de Bambu Lab

  • Integraciones de Shopify / WooCommerce: llega un pedido multicolor y se crea automáticamente un elemento de la cola de impresión para la Bambu Lab cuyo AMS ya tiene cargada la paleta correcta.
  • Paneles de flota: paneles de Grafana, Notion o personalizados en Svelte, montados en la pared y con el estado en directo de cada X1C, P1S y A1 del taller, además de los datos de las ranuras AMS de cada impresora.
  • Bots de Slack / Discord: bots que pausan una impresión descontrolada, informan de "la P1S acaba de terminar la impresión #128" o resumen el uso de filamento de la flota Bambu durante una semana.
  • Reservas para educación/makerspaces: un sistema de reservas reserva una P1S, pone en cola el G-code del estudiante y archiva el trabajo en su expediente cuando termina.

¿Por qué usar SimplyPrint en lugar de la nube propia de Bambu?

Bambu Handy y la nube de Bambu Studio te ofrecen el panel remoto de Bambu Lab y las impresiones del slicer Bambu Studio. SimplyPrint funciona junto a ellos y ofrece a tu flota funciones que la nube propia de Bambu no tiene:

  • API para flotas multimarca: el mismo código que gestiona una Bambu Lab X1C también gestiona una Prusa MK4, una Anycubic Kobra o cualquier equipo compatible con OctoPrint.
  • Lógica de cola, aprobación y enrutamiento: no solo control impresora a impresora, sino una verdadera cola multiimpresora con flujos de aprobación, permisos por usuario y enrutamiento automático.
  • Inventario de filamento de todo el taller: no solo lo cargado en un AMS, sino cada bobina de tu Gestor de filamento, con seguimiento del coste por gramo.
  • OAuth2 para integraciones de socios: desarrolla una integración que tus usuarios conecten a su propia cuenta de SimplyPrint, sin tener que compartir credenciales de Bambu.
  • Eventos push de Webhook: SimplyPrint envía mediante POST en cuanto sucede algo, sin sondeos.
SimplyPrint y las herramientas oficiales de Bambu pueden coexistir; no hay problema en usarlos a la vez.

Ver la página principal de la API

Acceso según el plan para la API de Bambu Lab

Mismas limitaciones por plan que la API principal de SimplyPrint. Los planes Free y Basic no incluyen API; Pro y superiores desbloquean la API básica; Print Farm y superiores desbloquean la API mejorada (capacidad de escritura para modificar la cola e iniciar impresiones).

功能/限制 免费 基础 专业版 打印农场 企业版 学校 云切片 耗材管理器
Solicitudes API por minuto
Limitador con ventana móvil de un minuto compartido por todas las llamadas a la API de la cuenta.
- - 60 180 600 180 - -
Acceso básico a la API
Consulta el estado de la impresora, la cola, los trabajos y el historial de todas las impresoras Bambu Lab de la cuenta.
API avanzada (iniciar impresiones, enviar G-code)
Permite subir archivos, modificar la cola para iniciar impresiones y enviar G-code directamente.

您想详细了解我们的套餐吗?

查看完整价格和功能对比

Preguntas frecuentes sobre la API de Bambu Lab

X1C, X1E, P1S, P1P, A1, A1 Mini y H2D se conectan a SimplyPrint. Una vez conectadas, todas exponen la misma interfaz API: la misma estructura de respuesta de /printers/Get, los mismos endpoints de la cola de impresión y las mismas acciones de control.
Sí. Cada ranura AMS se rastrea como una bobina de filamento en el Gestor de filamento, por lo que las bobinas cargadas aparecen en /filament/GetFilament con marca, material, color, peso restante y la impresora y ranura donde están. SimplyPrint admite AMS, AMS Lite, AMS 2 Pro y AMS HT.
Sí. Sube un 3MF o G-code laminado y haz POST a /queue/AddItem con el ID del archivo y la impresora objetivo. La cola dirige el trabajo a una Bambu Lab cuyo AMS tenga cargados los colores adecuados. Si ninguna Bambu coincide, el elemento espera en la cola hasta que haya una.
SimplyPrint es independiente, no forma parte de Bambu Lab. SimplyPrint se conecta a impresoras Bambu Lab mediante los protocolos disponibles públicamente que Bambu Lab admite para herramientas de terceros, igual que cualquier otro panel en la nube.
Sí. SimplyPrint admite tanto impresoras Bambu Lab conectadas a la nube como el modo solo LAN mediante un puente local ligero. Desde la perspectiva de la API, las impresoras solo LAN se comportan de forma idéntica a las impresoras en la nube.
https://api.simplyprint.io/{companyId}/{endpoint}. El {companyId} es el ID de tu cuenta, no una versión. La autenticación usa un encabezado: X-API-KEY: your_key_here.
Sí. El flujo OAuth2 permite que cada propietario conecte su propia cuenta de SimplyPrint a tu app mediante una pantalla de consentimiento, sin claves API compartidas. Consulta la página principal de la API para conocer todos los detalles de OAuth2 y el formulario de solicitud de cliente.

目录