Uma API REST para sua frota Bambu Lab, incluindo AMS

Bambu Lab API da Bambu Lab

O SimplyPrint é o painel em nuvem para frotas Bambu Lab, com visibilidade completa do AMS, roteamento da fila, rastreamento de filamento e estado em tempo real. A API permite que seu próprio software controle essa frota. Coloque impressões na fila de uma X1C específica, pause uma P1S, veja quais bobinas estão carregadas em uma unidade AMS, envie um comando G-code, um cabeçalho, JSON entra, JSON sai. A mesma API funciona tanto para uma P1S quanto para duzentas X1Cs.

Ver visão geral de API Começar de graça Mais informações e guia
Imagem do recurso

Compatível com toda a linha Bambu Lab

X1C, X1E, P1S, P1P, A1, A1 Mini e H2D se conectam ao SimplyPrint e expõem a mesma interface de API. AMS, AMS Lite, AMS 2 Pro e AMS HT são reconhecidos, e as bobinas carregadas aparecem na mesma resposta do inventário de filamentos que as impressoras conectadas por qualquer outro caminho.

Enfileire uma impressão em uma Bambu Lab específica com uma chamada de API

Envie por POST o ID de um arquivo 3MF ou G-code, direcione uma impressora Bambu Lab pelo ID, e o SimplyPrint o coloca na fila. Arquivos 3MF multicoloridos são fatiados pelo mesmo mecanismo usado pelo painel, e a fila direciona o trabalho a uma impressora cujo AMS tenha as cores necessárias carregadas.

# 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 automação: ignore for_printers completamente e o SimplyPrint escolhe a primeira Bambu Lab operacional cujo AMS já tenha as cores certas carregadas, útil para oficinas de frota com mais de 10 X1Cs lado a lado.

Como o SimplyPrint se conecta à sua impressora Bambu Lab

O controle total de uma impressora Bambu Lab pelo SimplyPrint requer o SimplyPrint Bambu Lab Client, um pequeno processo de ponte executado na sua rede em um Raspberry Pi, mini PC ou qualquer máquina Mac/Windows/Linux sempre ligada. A ponte fica na mesma LAN das suas impressoras e se comunica localmente com elas; depois, ela se conecta à nuvem do SimplyPrint pela internet em seu nome. As próprias impressoras nunca precisam de conexão pública, elas permanecem restritas à LAN enquanto você mantém o controle remoto total de qualquer lugar.

  • Controle total (iniciar impressões, AMS, temperatura, movimento, webcam): impressora no LAN-only Mode, com Developer Mode ativado, mais o SimplyPrint Bambu Lab Client em execução como ponte. Este é o caminho compatível no firmware Bambu atual.
  • Somente monitoramento (status, progresso, estado do AMS, webcam, estatísticas): impressora no modo Cloud + SimplyPrint Bambu Lab Client. Você vê tudo, mas não pode iniciar impressões pelo SimplyPrint, o Authorization Control System (ACS, 2025) da Bambu bloqueia ações de escrita de terceiros pela nuvem da Bambu.
  • Sem conexão com a impressora: não adicione a impressora. O Slicer em nuvem, o Gerenciador de filamento, o armazenamento de arquivos e as ferramentas de etiquetas continuam funcionando. Inicie as impressões pelo Bambu Studio / Bambu Handy normalmente.
Depois de conectar a ponte, a impressora aparece como um objeto de impressora padrão na API. GET /printers/Get retorna a mesma estrutura, seja a impressora uma Bambu Lab, Prusa, Creality ou outra, para que seu código continue independente da marca.

Guia completo de configuração da Bambu Lab: somente LAN ou Cloud
Imagem do recurso
Imagem do recurso

Use o SimplyPrint junto com o Bambu Studio Cloud

Você não precisa escolher um ou outro. Continue usando Bambu Studio e Bambu Handy como slicer e app de controle rápido, e use o SimplyPrint para gerenciar a fila da frota, o roteamento compatível com AMS, o inventário de filamento e a API REST. Ambos usam a mesma conexão da impressora, não há conflito, sinalizador de exclusividade nem configuração extra na impressora para coexistirem.

Leia o status, controle impressões e envie G-code

Todos os endpoints de controle de impressora funcionam da mesma forma em uma Bambu Lab e em qualquer outra impressora. Informe o ID da impressora e receba 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 uma impressão em andamento sem tocar na impressora:
# 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 }'

Imagem do recurso

Automação compatível com AMS: lê as bobinas carregadas e enfileira o trabalho certo

Os slots AMS de cada impressora Bambu Lab são rastreados como bobinas de filamento no Gerenciador de filamento do SimplyPrint. A API expõe os mesmos dados: a marca, o material, a cor, o peso restante de cada bobina e o slot em que ela está. Sua automação pode verificar o que está carregado agora e enfileirar uma impressão compatível ou notificar uma pessoa para trocar uma 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"
A funcionalidade multimaterial do SimplyPrint inclui AMS, AMS Lite, AMS 2 Pro e AMS HT, 4 unidades AMS encadeáveis por impressora × 4 slots cada = até 16 cores em uma X1C/P1S. A API não tem um endpoint separado por AMS, o estado do AMS fica no objeto da impressora e as bobinas carregadas ficam no inventário de filamentos.

Ver suporte ao AMS da Bambu Lab

O que as pessoas criam com a API da Bambu Lab

  • Integrações com Shopify / WooCommerce: chega um pedido multicolorido e um item da fila de impressão do SimplyPrint é criado automaticamente para a Bambu Lab cujo AMS já tem a paleta correta carregada.
  • Painéis da frota: painéis Grafana, Notion ou Svelte personalizados montados na parede, exibindo o estado em tempo real de cada X1C, P1S e A1 na oficina, com dados dos slots AMS por impressora.
  • Bots do Slack / Discord: bots que pausam uma impressão fora de controle, informam "a P1S acabou de concluir a impressão nº 128" ou resumem o uso de filamento em toda a frota Bambu durante uma semana.
  • Reservas para educação e makerspaces: um sistema de reservas reserva uma P1S, coloca o G-code do aluno na fila e arquiva o trabalho no histórico acadêmico do aluno quando termina.

Por que usar SimplyPrint em vez da própria nuvem da Bambu?

O Bambu Handy e a nuvem do Bambu Studio oferecem o painel remoto da Bambu Lab e impressões pelo slicer Bambu Studio. SimplyPrint atua junto, oferecendo à sua frota recursos que a nuvem própria da Bambu não oferece:

  • API para frotas de várias marcas: o mesmo código que controla uma Bambu Lab X1C também controla uma Prusa MK4, uma Anycubic Kobra ou qualquer impressora compatível com OctoPrint.
  • Lógica de fila, aprovação e roteamento: não apenas controle impressora por impressora, mas uma fila de impressão real para várias impressoras com fluxos de aprovação, permissões por usuário e roteamento automático.
  • Inventário de filamento em toda a operação: não só o que está carregado em um AMS, mas todas as bobinas no seu Gerenciador de filamento, com acompanhamento de custo por grama.
  • OAuth2 para integrações de parceiros: crie uma integração que seus usuários conectem à própria conta SimplyPrint, em vez de precisarem compartilhar credenciais Bambu.
  • Eventos push de Webhook: SimplyPrint envia via POST assim que algo acontece, sem consultas recorrentes.
O SimplyPrint e as ferramentas oficiais da Bambu podem coexistir, e não há problema em usar os dois.

Ver a página principal da API

Acesso por plano à API Bambu Lab

Mesmas restrições de plano da API principal do SimplyPrint. Os planos Free e Basic não disponibilizam API; Pro e superiores liberam a API básica; Print Farm e superiores liberam a API avançada (capacidade de escrita para alterar a fila e iniciar impressões).

Recurso / limite Grátis Básico Pro Print farm Enterprise Escola Cloud Slicer Gerenciador de filamento
Solicitações de API por minuto
Limitador por minuto em janela móvel, compartilhado entre todas as chamadas de API da conta.
- - 60 180 600 180 - -
Acesso à API básica
Leia o status da impressora, a fila de impressão, os trabalhos e o histórico de todas as impressoras Bambu Lab da conta.
API avançada (iniciar impressões, enviar G-code)
Libera uploads de arquivos, alterações na fila que iniciam impressões e envio direto de G-code.

Quer saber mais sobre nossos planos?

Ver preços e comparação completa de recursos

Perguntas frequentes sobre a API da Bambu Lab

X1C, X1E, P1S, P1P, A1, A1 Mini e H2D se conectam ao SimplyPrint. Depois de conectadas, todas expõem a mesma interface de API: a mesma estrutura de resposta de /printers/Get, os mesmos endpoints de fila e as mesmas ações de controle.
Sim. Cada slot AMS é rastreado como uma bobina de filamento no Gerenciador de filamento, então as bobinas carregadas aparecem em /filament/GetFilament com marca, material, cor, peso restante e em qual impressora e slot estão. SimplyPrint cobre AMS, AMS Lite, AMS 2 Pro e AMS HT.
Sim. Envie um 3MF ou G-code fatiado, faça POST para /queue/AddItem com o ID do arquivo e a impressora de destino. A fila direciona o trabalho para uma Bambu Lab cujo AMS tenha as cores certas carregadas. Se nenhuma Bambu corresponder, o item ficará na fila até que uma corresponda.
O SimplyPrint é independente, não faz parte da Bambu Lab. O SimplyPrint se conecta a impressoras Bambu Lab pelos protocolos publicamente disponíveis que a Bambu Lab oferece para ferramentas de terceiros, da mesma forma que qualquer outro painel em nuvem.
Sim. SimplyPrint é compatível com impressoras Bambu Lab conectadas à nuvem e com o modo apenas LAN por uma ponte local leve. Pela perspectiva da API, impressoras apenas LAN se comportam de forma idêntica às impressoras em nuvem.
https://api.simplyprint.io/{companyId}/{endpoint}. O {companyId} é o ID da sua conta, não uma versão. A autenticação usa um cabeçalho: X-API-KEY: your_key_here.
Sim. O fluxo OAuth2 permite que cada proprietário conecte sua própria conta SimplyPrint ao seu aplicativo por uma tela de consentimento, sem chaves de API compartilhadas. Veja a página principal da API para todos os detalhes de OAuth2 e o formulário de solicitação de cliente.

Índice