Bambu Lab API
兼容全系列Bambu Lab产品
X1C、X1E、P1S、P1P、A1、A1 Mini和 H2D均可连接到 SimplyPrint，并提供相同的 API接口。可识别 AMS、AMS Lite、AMS 2 Pro和 AMS HT；已装载的料盘会显示在与其他连接方式的打印机相同的耗材库存响应中。
通过一次API调用将打印任务加入指定Bambu Lab的队列
POST一个3MF或G-code文件ID，指定一个Bambu Lab打印机ID，SimplyPrint便会将其加入队列。多色3MF会通过面板所用的同一引擎切片，打印队列会将任务路由到AMS中已装入所需颜色的打印机。
# 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"
}'SimplyPrint如何连接到您的Bambu Lab打印机
要从SimplyPrint全面控制Bambu Lab打印机，需要使用SimplyPrint Bambu Lab Client，这是运行在您网络中的小型桥接进程，可部署在Raspberry Pi、迷你PC，或任何始终在线的Mac/Windows/Linux设备上。该桥接程序与打印机位于同一LAN，并在本地与其通信；随后它会代表您通过互联网连接到SimplyPrint云端。打印机本身从不需要公网连接，它们始终处于仅LAN模式，您仍可随时随地远程全面控制。
- 完全控制（启动打印、AMS、温度、移动、摄像头）：打印机处于LAN-only Mode并启用Developer Mode，再运行SimplyPrint Bambu Lab Client作为桥接。这是当前Bambu固件支持的方式。
- 仅监控（状态、进度、AMS状态、打印机摄像头、统计）：处于云端模式的打印机+SimplyPrint Bambu Lab Client。您可查看所有信息，但无法从SimplyPrint开始打印，Bambu的Authorization Control System（ACS，2025）会阻止通过Bambu云端执行第三方写入操作。
- 无需连接打印机：完全不要添加打印机。云端切片软件、耗材管理器、文件存储和标签工具仍可使用，照常从Bambu Studio/Bambu Handy启动打印即可。
将SimplyPrint与Bambu Studio Cloud配合使用
您无需二选一。继续将Bambu Studio和Bambu Handy作为切片软件和快速控制应用，同时让SimplyPrint负责机群队列、支持AMS的路由、耗材库存和REST API。两者读取同一打印机连接，互不冲突，无需排他标记，也无需在打印机上额外设置即可共存。
读取状态、控制打印、发送 G-code
每个打印机控制端点在Bambu Lab和其他任何打印机上的工作方式都相同。传入打印机ID，即可获得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 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 }'
感知AMS状态的自动化：读取已装载的料盘，将正确的打印任务加入打印队列
每台 Bambu Lab 打印机的 AMS 槽位都会在 SimplyPrint 耗材管理器中作为料盘进行跟踪。API 公开相同数据：每个料盘的品牌、材料、颜色、剩余重量及其所在槽位。您的自动化系统可检查当前装载的耗材，然后将匹配的打印任务加入队列，或通知人员更换料盘。
# Inspect filament spools - useful for AMS-aware automation
curl "https://api.simplyprint.io/{companyId}/filament/GetFilament" \
-H "X-API-KEY: your_api_key_here"用户使用Bambu Lab API构建什么
- Shopify/WooCommerce挂钩：多色订单到达时，会自动为一台AMS已加载正确调色板的Bambu Lab打印机创建SimplyPrint打印队列项目。
- 打印机群仪表板：安装在墙上的Grafana / Notion / 定制Svelte仪表板，实时显示车间中每台X1C、P1S和A1的状态，以及每台打印机的AMS槽位数据。
- Slack/Discord机器人：可暂停失控打印、报告“P1S刚完成打印#128”，或汇总Bambu机群一周的耗材使用情况。
- 教育/创客空间预约：预约系统预留一台 P1S，将学生的 G-code 加入队列，完成后把打印任务归档至学生成绩单。
为什么使用SimplyPrint而非Bambu自有云服务？
Bambu Handy和Bambu Studio云服务为您提供Bambu Lab自家的远程面板，以及来自Bambu Studio切片软件的打印任务。SimplyPrint与其配合使用，为您的设备群提供Bambu第一方云服务未提供的功能：
- 跨品牌机群 API：驱动 Bambu Lab X1C 的同一套代码，也能驱动 Prusa MK4、Anycubic Kobra 或任何兼容 OctoPrint 的设备。
- 队列、审批与路由逻辑：不只是逐台打印机控制，而是具备审批工作流、按用户权限和自动路由的真正多打印机队列。
- 整个工作室的耗材库存：不仅是一台 AMS 中装载的耗材，还包括耗材管理器中的每个料盘，并按克跟踪成本。
- 用于合作伙伴集成的OAuth2：发布集成，让您的用户将自己的SimplyPrint账户连接到该集成，无需分享Bambu凭据。
- Webhook推送事件：SimplyPrint在事件发生时立即发出POST请求，无需轮询。
Bambu Lab API的套餐使用权限
与SimplyPrint主API采用相同的套餐限制。免费版和基础版套餐不提供API；专业版及更高套餐解锁基础API；打印农场版及更高套餐解锁增强API（可修改队列并启动打印）。
| 功能/限制 | 免费 | 基础 | 专业版 | 打印农场 | 企业版 | 学校 | 云切片 | 耗材管理器 |
|---|---|---|---|---|---|---|---|---|
|
每分钟API请求数
整个账户的所有API调用共享的滚动式每分钟限流器。
|
- | - | 60 | 180 | 600 | 180 | - | - |
|
基础API访问权限
读取账户中每台 Bambu Lab 的打印机状态、队列、任务和历史记录。
|
||||||||
|
增强型API（启动打印、发送G-code）
解锁文件上传、会启动打印的队列变更和直接发送G-code。
|
您想详细了解我们的套餐吗？
查看完整价格和功能对比