Eine REST-API für deine Prusa-Flotte, in der Cloud gehostet

Prusa Prusa API

SimplyPrint ist das Cloud-Panel für Prusa-Flotten, und über die API steuert deine eigene Software diese Flotte. Drucke auf einem bestimmten MK4 in die Warteschlange stellen, einen laufenden Auftrag auf dem XL pausieren, einen G-Code-Befehl an einen Mini+ senden, den Live-Status jedes Prusa-Druckers in deiner Werkstatt abrufen. Ein Header, JSON rein, JSON raus. Dieselbe API funktioniert, egal ob du einen Prusa-Drucker oder zweihundert hast.

API-Übersicht anzeigen Kostenlos loslegen Mehr Info & How-to

Kompatibel mit allen modernen Prusa-Modellen

MK4, MK4S, MK3.9, MK3.5, Mini+, XL und CORE One: Sie alle verbinden sich mit SimplyPrint und bieten denselben API-Umfang. Ältere Drucker der MK3-Klasse verbinden sich über einen OctoPrint-Host und unser Plugin.

Einen Druck mit einem API-Aufruf auf einem bestimmten Prusa-Drucker in die Druckwarteschlange stellen

Sende per POST eine Datei-ID, wähle einen Drucker und lege die Position fest. SimplyPrint führt den Druck über dieselbe Druckwarteschlangen-, Freigabe- und Routing-Logik aus, die auch das Panel nutzt. So startet der Druck auf deinem Prusa genau so, als hätte ein Mensch auf Drucken geklickt.

# 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"
  }'
Soll SimplyPrint statt eines bestimmten Prusa den am besten passenden auswählen? Lass das Feld for_printers weg. Dann wählt die Warteschlange einen betriebsbereiten Prusa mit passendem Bauraum und geladenem Filament.

So verbindet sich SimplyPrint mit deinem Prusa-Drucker

SimplyPrint ist kein Prusa Connect-Plugin. Es ist ein separates Cloud-Panel, das sich direkt mit deinem Prusa-Drucker verbindet, mit zwei Verbindungswegen, abhängig von deinem Drucker:

  • MK4, MK4S, XL, MK3.9, MK3.5, Mini, Mini+, CORE One: Installiere einmal das Open-Source-Firmware-Bundle von SimplyPrint auf dem Drucker (derzeit in Beta). Die Firmware kommuniziert über das Wi-Fi oder Ethernet des Druckers mit SimplyPrint. Du brauchst weder einen Pi noch ein zweites Gerät oder einen Host-Computer. Webcam-Unterstützung gibt es noch nicht.
  • MK3 / MK3S / MK3S+ (und älter): über einen OctoPrint-Host (Raspberry Pi oder ähnlich) und unser SimplyPrint-OctoPrint-Plugin verbinden. Aus API-Sicht verhält sich der Drucker genauso wie bei der Firmware-Integration.
Nach der Verbindung erscheint der Drucker als Standarddruckerobjekt in der API. GET /printers/Get liefert dieselbe Struktur, unabhängig davon, ob es ein Prusa, ein Bambu Lab, ein Creality oder ein anderer Drucker ist. So bleibt dein Code markenunabhängig, auch wenn deine Hardware nicht markenunabhängig ist.

Auflisten, prüfen, pausieren, fortsetzen: die alltäglichen Vorgänge

Jeder Endpunkt zur Druckersteuerung funktioniert bei Prusa genauso wie bei jedem anderen Drucker in deiner Flotte. Übergib die Drucker-ID, erhalte JSON zurück.

# 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"
Sende beliebigen G-code, den deine Firmware akzeptiert, etwa für Prusa-spezifische Wartungsroutinen, Kalibrierungsabläufe oder schnelle Korrekturen:
# 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" }'
Einen Druck pausieren oder fortsetzen, ohne das LCD des Druckers anzufassen:
# 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 }'

Was Nutzer mit der Prusa-API entwickeln

ERP-Anbindungen, Labordashboards, Slack/Discord-Bots und LMS-Integrationen für Schulen sind gängige Muster. Die zentrale API-Seite zeigt die vollständige Liste der Anwendungsfälle, alles dort funktioniert genauso mit einer Prusa-Flotte.

Warum SimplyPrint statt der API von Prusa Connect nutzen?

Prusa Connect ist in vielen Ansichten schreibgeschützt: Du kannst überwachen, aber keine Drucke starten, Warteschlangen verwalten oder G-code aus der Ferne senden. SimplyPrint ermöglicht dir mit nur einem REST-Aufruf volle Schreibzugriffe. Prusa Connect ist das First-Party-Panel von Prusa und bietet eine eigene, begrenzte API. SimplyPrint bietet dir eine umfassendere API für dieselben Drucker sowie Funktionen, die Prusa Connect nicht abdeckt:

  • Markenübergreifende Flotte: Eine API für Prusa, Bambu Lab, Creality, Anycubic, Elegoo, OctoPrint-Hosts und alles Klipper-Basierte. Kein Marken-Hopping.
  • Endpunkte für Druckwarteschlange, Filament und Druckverlauf: nicht nur Druckersteuerung, sondern vollständige Übersicht über ausstehende Druckaufträge, Filamentspulenstatus, Statistiken vergangener Aufträge und benutzerdefinierte Felder.
  • OAuth2 für Partnerintegrationen: Stelle eine Integration bereit, die deine Nutzer mit ihrem eigenen SimplyPrint-Konto verknüpfen, statt Prusa Connect-Token mit dir zu teilen.
  • Webhook-Push-Ereignisse: SimplyPrint sendet per POST, sobald ein Druck fertig ist, kein Polling.
SimplyPrint und Prusa Connect können nebeneinander genutzt werden, beides parallel zu nutzen ist kein Problem und Prusas eigener Slicer sowie Uploads funktionieren weiterhin. Brauchst du auch Cloud-Slicing? Sieh dir die PrusaSlicer Cloud-Integration an, um STL aus deinem eigenen Code vor dem Einreihen in die Warteschlange in G-code zu slicen.

PrusaSlicer-Cloud-Integration

Plan-Zugriff für die Prusa API

Gleiche Tarifbeschränkungen wie bei der Haupt-API von SimplyPrint. Free- und Basic-Tarife bieten keine API, Pro und höher schalten Basic API frei, Print Farm und höher Enhanced (Schreibzugriff für Änderungen an der Warteschlange und zum Starten von Drucken).

Funktion / Limit Kostenlos Einfach Pro Druckfarm Enterprise Schule Cloud Slicer Filament-Manager
API-Anfragen pro Minute
Gemeinsames gleitendes Limit pro Minute für alle API-Aufrufe im Konto.
- - 60 180 600 180 - -
Basis-API-Zugriff
Druckerstatus, Druckwarteschlange, Aufträge und Verlauf für jeden Prusa-Drucker im Konto lesen.
Erweiterte API (Drucke starten, G-code senden)
Ermöglicht Datei-Uploads, Warteschlangenänderungen, die Drucke starten, und direktes Senden von G-code.

Möchtest du mehr über unsere Tarife erfahren?

Vollständigen Preis- und Funktionsvergleich anzeigen

Passt gut zu Webhooks und dem Cloud-PrusaSlicer

Die Prusa-API ist ein Teilbereich einer umfassenderen Entwicklerplattform. Kombiniere sie mit Webhooks für Push-Ereignisse, wenn ein Prusa-Drucker einen Druck fertigstellt, und mit unserem Cloud-PrusaSlicer, wenn du STL-Dateien aus deinem eigenen Code vor dem Einreihen in die Druckwarteschlange in G-code slicen möchtest.

API-Hauptseite ansehen

Häufige Fragen zur Prusa-API

MK4, MK4S, MK3.9, MK3.5, Mini+, Mini, XL und CORE One verbinden sich über ein Firmware-Bundle. Ältere Drucker der MK3-Klasse (MK3, MK3S, MK3S+) verbinden sich über OctoPrint und unser Plugin. Nach dem Verbinden bieten sie alle denselben API-Umfang.
Nein. SimplyPrint ist ein eigenständiges Panel mit eigener Verbindung zu deinem Prusa, kein Prusa-Connect-Plugin. Du kannst beide parallel betreiben, wenn du möchtest, aber SimplyPrint benötigt Prusa Connect nicht.
Ja. Sende eine POST-Anfrage an /queue/AddItem mit for_printers: "42" (der Drucker-ID des gewünschten Prusa-Druckers). Dann leitet die Druckwarteschlange den Auftrag an diesen Drucker weiter. Der Druck beginnt, sobald der Drucker betriebsbereit ist, sofern dein Konto keine Freigabe für Druckwarteschlangeneinträge erfordert.
Ja, /printers/actions/SendGcode sendet eine einzelne G-code-Zeile an einen bestimmten Drucker. Nützlich für Prusa-spezifische Wartung, Kalibrierungssequenzen oder Wiederherstellungsroutinen. Für Schreibaktionen ist die API-Stufe Enhanced erforderlich, die ab dem Tarif Print Farm verfügbar ist.
https://api.simplyprint.io/{companyId}/{endpoint}. Die {companyId} ist deine Konto-ID, keine Version. Du findest sie nach der Anmeldung in der Panel-URL. Die Authentifizierung erfolgt mit einem Header: X-API-KEY: your_key_here.
Ja. Der OAuth2-Flow ermöglicht jedem Prusa-Besitzer, sein eigenes SimplyPrint-Konto über einen Zustimmungsbildschirm mit deiner App zu verbinden, ohne gemeinsame API-Schlüssel. Auf der Haupt-API-Seite findest du die vollständigen OAuth2-Details und das Formular für Client-Anfragen.

Inhaltsverzeichnis