Prusa API

通过一次API调用将打印任务加入指定Prusa的队列

POST文件ID，指定目标打印机并设置位置。SimplyPrint会使用与面板相同的打印队列、审批和路由逻辑处理该打印任务，因此它会在您的Prusa上启动，就像用户亲自点击“打印”时一样。

# Queue a print on a specific Prusa MK4 (printer id 42)
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": "benchy_gcode_file_id",
    "amount": 1,
    "for_printers": "42",
    "position": "top"
  }'

您想让SimplyPrint匹配最合适的Prusa，而非指定机型？去掉for_printers字段，队列会选择一台可正常运行、成型尺寸符合要求且已装载相应耗材的Prusa。

列出、检查、暂停、恢复，日常操作

每个打印机控制端点在Prusa和您机群中的任何其他打印机上的工作方式都相同。传入打印机ID，即可获得JSON。

# List every printer in the account (Prusa, Bambu, anything)
curl "https://api.simplyprint.io/{companyId}/printers/Get" \
  -H "X-API-KEY: your_api_key_here"

发送您的固件支持的任何G-code，适用于Prusa专用维护流程、校准序列或快速修复：

# Send a one-off G-code command - home all axes on a Prusa MK4
curl -X POST "https://api.simplyprint.io/{companyId}/printers/actions/SendGcode" \
  -H "X-API-KEY: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "pid": 42, "gcode": "G28" }'

无需操作打印机LCD即可暂停或继续打印：

# Pause a running print on a Prusa
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": 42 }'

为什么使用SimplyPrint而非Prusa Connect的API？

在许多视图中，Prusa Connect仅提供只读功能，您可以监控，但不能开始打印、管理队列或远程发送G-code。SimplyPrint通过一次REST调用即可提供完整写入功能。Prusa Connect是Prusa自己的第一方控制面板，并提供自己的（有限）API功能。SimplyPrint则为相同打印机提供更广泛的API，以及Prusa Connect未涵盖的功能：

SimplyPrint与Prusa Connect可共存，同时使用两者没有问题，Prusa自家的切片软件和上传也可并行使用。还需要云端切片？请查看PrusaSlicer云集成，可在加入队列前从您自己的代码将STL切片为G-code。

PrusaSlicer云端集成

与webhook和云端PrusaSlicer自然搭配

Prusa API是更大开发者功能的一部分。它可搭配webhook，在Prusa完成打印时推送事件；若您想在将STL文件加入队列前从自己的代码将其切片为G-code，还可搭配我们的云端PrusaSlicer。

查看主要API页面