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から見たプリンターの動作は、ファームウェア連携の場合と同じです。
一覧表示、確認、一時停止、再開などの日常操作
すべてのプリンター制御エンドポイントは、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します。ポーリングは不要です。
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のメインページを見る