メインコンテンツへ移動

クラウドで提供されるPrusaプリンターフリート向けREST API

Prusa Prusa API

SimplyPrintはPrusaのプリンター群を管理するクラウドパネルです。APIを使えば、独自のソフトウェアからプリンター群を操作できます。特定のMK4へのプリントのキュー追加、XLで実行中のジョブの一時停止、Mini+へのG-codeコマンドの送信、作業場のすべてのPrusaのリアルタイム状態の取得が可能です。ヘッダーは1つ、入力も出力もJSONです。Prusaが1台でも200台でも、同じAPIを使用できます。

APIの概要を表示 無料で始める 詳細情報と使い方

Prusaの現行モデル全機種に対応

MK4、MK4S、MK3.9、MK3.5、Mini+、XL、CORE OneはいずれもSimplyPrintに接続でき、同じAPIを使用できます。旧型のMK3系プリンターはOctoPrintホストとプラグインを使用して接続します。

1回のAPI呼び出しで指定したPrusaにプリントをキュー登録

ファイルIDをPOSTし、プリンターと位置を指定します。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"
  }'
特定のPrusaではなく、最適なPrusaをSimplyPrintで選ぶこともできます。for_printersフィールドを省略すると、必要なビルドボリュームがあり、適切なフィラメントがセットされた稼働可能なPrusaをキューが選びます。

SimplyPrintとPrusaプリンターの接続方法

SimplyPrintはPrusa Connectのプラグインではありません。Prusaに直接接続する独立したクラウドパネルです。プリンターに応じて、2つの接続方法があります。

  • MK4、MK4S、XL、MK3.9、MK3.5、Mini、Mini+、CORE One:SimplyPrintのオープンソースファームウェアバンドルをプリンターに一度インストールします(現在ベータ版)。ファームウェアはプリンター自身のWi-Fi / Ethernet経由でSimplyPrintと通信するため、Pi、別の機器、ホストコンピューターは不要です。ウェブカメラはまだサポートされていません。
  • MK3 / MK3S / MK3S+(および旧モデル):OctoPrintホスト(Raspberry Piなど)とSimplyPrint OctoPrintプラグインを使って接続します。APIから見たプリンターの動作は、ファームウェア連携の場合と同じです。
接続後、プリンターはAPIに標準のプリンターオブジェクトとして表示されます。GET /printers/Getは、Prusa、Bambu Lab、Crealityなど、プリンターの種類にかかわらず同じ形式でデータを返します。そのため、異なるブランドの機器を使っていても、ブランドに依存しないコードを維持できます。

一覧表示、確認、一時停止、再開などの日常操作

すべてのプリンター制御エンドポイントは、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 }'

Prusa APIを使った開発例

ERP連携、ラボのダッシュボード、Slack/Discordボット、学校のLMS連携などは、いずれも一般的な利用例です。利用例の一覧はAPIのメインページをご覧ください。すべてPrusaプリンター群でも同様に利用できます。

Prusa ConnectのAPIではなくSimplyPrintを使う理由

Prusa Connectの多くの画面は読み取り専用です。監視はできますが、プリントの開始、キューの管理、G-codeのリモート送信はできません。SimplyPrintでは、1回のREST呼び出しからすべての書き込み操作を実行できます。Prusa ConnectはPrusa純正の管理画面で、独自のAPIを提供していますが、その機能は限定的です。SimplyPrintは同じプリンターに対してより幅広いAPIを提供するほか、Prusa Connectにはない次の機能も備えています:

  • 複数ブランドのプリンター管理:Prusa、Bambu Lab、Creality、Anycubic、Elegoo、OctoPrintホスト、Klipperベースの機器を1つのAPIで管理できます。ブランドごとに使い分ける必要はありません。
  • キュー、フィラメント、ジョブ履歴のエンドポイント:プリンター制御だけでなく、保留中のジョブ、フィラメントスプールの状態、過去のジョブ統計、カスタムフィールドも網羅します。
  • パートナー連携向けOAuth2:Prusa Connectのトークンを共有する必要がなく、各ユーザーのSimplyPrintアカウントに接続できる連携を提供できます。
  • Webhookプッシュイベント:プリントが完了した瞬間にSimplyPrintがPOSTします。ポーリングは不要です。
SimplyPrintとPrusa Connectは共存でき、両方を同時に使用できます。Prusa純正スライサーやアップロード機能も並行して使えます。クラウドスライスが必要な場合は、PrusaSlicer Cloud連携で、キューに追加する前に独自のコードからSTLをG-codeにスライスできます。

PrusaSlicerクラウド連携

Prusa APIのプラン別利用条件

SimplyPrintのメインAPIと同じプラン制限が適用されます。FreeとBasicプランではAPIを利用できません。Pro以上ではBasic API、Print Farm以上ではEnhanced APIを利用できます。Enhanced APIではキューの変更やプリントの開始が可能です。

機能 / 制限 無料 基本 Pro プリントファーム エンタープライズ 学校 クラウドスライサー フィラメントマネージャー
1分あたりのAPIリクエスト数
アカウントのすべてのAPI呼び出しに共通する、直近1分間の制限です。
- - 60 180 600 180 - -
基本APIアクセス
アカウント内のすべてのPrusaプリンターの状態、キュー、ジョブ、履歴を読み取ります。
拡張API(プリントを開始、G-codeを送信)
ファイルのアップロード、プリントを開始するキューの変更、G-codeの直接送信が利用可能になります。

プランについて詳しく確認しますか?

料金と機能の比較をすべて表示

Webhookやクラウド版PrusaSlicerと連携

Prusa APIは、より広範な開発者向け機能の一部です。Webhookと組み合わせると、Prusaのプリント完了時にプッシュイベントを受け取れます。また、クラウド版PrusaSlicerと組み合わせれば、独自のコードからSTLファイルをG-codeにスライスしてキューに追加できます。

APIのメインページを見る

Prusa APIのよくある質問

MK4、MK4S、MK3.9、MK3.5、Mini+、Mini、XL、CORE Oneはファームウェアバンドルを使用して接続します。旧型のMK3系プリンター(MK3、MK3S、MK3S+)はOctoPrintとプラグインを使用して接続します。接続後は、いずれも同じAPIを使用できます。
いいえ。SimplyPrintはPrusa Connectのプラグインではなく、Prusaに独自に接続する別のパネルです。両方を併用することもできますが、SimplyPrintにPrusa Connectは必要ありません。
はい。for_printers: "42"(対象のPrusaのプリンターID)を指定して/queue/AddItemにPOSTすると、キューからそのプリンターにジョブが送られます。アカウントでキュー項目の承認が必要な場合を除き、プリンターが稼働可能になるとすぐにプリントが開始されます。
はい。/printers/actions/SendGcodeを使い、指定したプリンターにG-codeを1行送信できます。Prusa固有のメンテナンス、キャリブレーション手順、復旧処理に役立ちます。書き込み操作にはEnhanced APIプラン(Print Farm以上)が必要です。
https://api.simplyprint.io/{companyId}/{endpoint}。{companyId}はバージョンではなくアカウントIDです。サインイン後、パネルのURLで確認できます。認証にはヘッダーを1つ使用します:X-API-KEY: your_key_here。
はい。OAuth2フローにより、各Prusaオーナーは同意画面を通じて自身のSimplyPrintアカウントをアプリに接続できます。APIキーの共有は不要です。OAuth2の詳細とクライアント申請フォームについては、APIのメインページをご覧ください。

目次