メインコンテンツへ移動

AMSにも対応したBambu Labプリンターフリート向けREST API

Bambu Lab Bambu Lab API

SimplyPrintはBambu Labのプリンター群を管理するクラウドパネルです。AMSの全体像の確認、キューの振り分け、フィラメントの追跡、リアルタイムの状態確認に対応しています。APIを使えば、独自のソフトウェアからプリンター群を操作できます。特定のX1Cへのプリントのキュー追加、P1Sの一時停止、AMSユニットにセットされたスプールの確認、G-codeコマンドの送信が可能です。ヘッダーは1つ、入力も出力もJSONです。P1Sが1台でもX1Cが200台でも、同じAPIを使用できます。

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

Bambu Labの全機種に対応

X1C、X1E、P1S、P1P、A1、A1 Mini、H2DはすべてSimplyPrintに接続でき、同じAPI機能を利用できます。AMS、AMS Lite、AMS 2 Pro、AMS HTが認識され、装着されたスプールは、他の方法で接続されたプリンターと同じフィラメント在庫のレスポンスに表示されます。

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

3MFまたはG-codeファイルのIDをPOSTし、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"
  }'
自動化するには、for_printersを完全に省略します。SimplyPrintが、AMSに必要な色がすでにセットされている稼働可能なBambu Labを最初から順に探して選択します。X1Cを10台以上並べて運用するファームに便利です。

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

SimplyPrintからBambu Labプリンターのすべての機能を操作するには、SimplyPrint Bambu Lab Clientが必要です。これはRaspberry Pi、ミニPC、または常時稼働するMac/Windows/Linuxマシン上で動作する小さなブリッジプロセスです。ブリッジはプリンターと同じLAN上にあり、ローカルでプリンターと通信したうえで、インターネット経由でSimplyPrintのクラウドに接続します。プリンター自体をインターネットに公開する必要はありません。LAN専用モードのまま、どこからでもすべての機能を遠隔操作できます。

  • フル制御(プリント開始、AMS、温度、移動、ウェブカメラ):プリンターをLAN専用モードにし、開発者モードを有効にして、SimplyPrint Bambu Lab Clientをブリッジとして実行します。これが現在のBambuファームウェアでサポートされている方法です。
  • 監視のみ(状態、進行状況、AMSの状態、ウェブカメラ、統計):クラウドモードのプリンターとSimplyPrint Bambu Lab Clientを使用します。すべて確認できますが、SimplyPrintからプリントを開始することはできません。BambuのAuthorization Control System(ACS、2025年)が、Bambuのクラウド経由のサードパーティーによる書き込み操作をブロックするためです。
  • プリンターを接続しない:プリンターを追加しません。クラウドスライサー、フィラメント管理、ファイルストレージ、ラベルツールは引き続き利用できます。プリントは通常どおりBambu Studio / Bambu Handyから開始します。
ブリッジの接続後、プリンターはAPIに標準のプリンターオブジェクトとして表示されます。GET /printers/Getは、Bambu Lab、Prusa、Crealityなど、プリンターの種類にかかわらず同じ形式でデータを返します。そのため、ブランドに依存しないコードを維持できます。

Bambu Lab完全セットアップガイド:LAN専用モードとクラウド
機能の画像
機能の画像

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"
SimplyPrintのマルチマテリアル機能はAMS、AMS Lite、AMS 2 Pro、AMS HTに対応しています。X1C/P1Sでは、プリンター1台にAMSを4台まで連結可能×各4スロットで最大16色を使用できます。APIにはAMSごとの独立したエンドポイントはありません。AMSの状態はプリンターオブジェクトに、装着されたスプールはフィラメント在庫に含まれます。

Bambu Lab AMSのサポートを見る

Bambu Lab APIを使った開発例

  • Shopify / WooCommerceフック:多色プリントの注文を受けると、適切な色がAMSにセット済みのBambu Labに対してSimplyPrintのキュー項目が自動作成されます。
  • プリンター群のダッシュボード:作業場のすべてのX1C、P1S、A1の状態をリアルタイムで表示する壁掛けのGrafana、Notion、カスタムSvelteダッシュボードです。プリンターごとのAMSスロットデータも表示します。
  • Slack / Discordボット:問題が発生したプリントを一時停止したり、「P1Sのプリント#128が完了しました」と通知したり、Bambuプリンター群の1週間のフィラメント使用量を集計したりできます。
  • 教育機関・メイカースペースの予約:予約システムがP1Sを予約し、生徒のG-codeをキューに追加します。完了後はジョブを生徒の記録に保存します。

Bambu独自のクラウドではなくSimplyPrintを使う理由

Bambu HandyとBambu Studioのクラウドでは、Bambu Lab独自のリモートパネルを利用し、Bambu Studioスライサーからプリントできます。SimplyPrintはこれらと併用でき、Bambuの公式クラウドにはないファーム向けの機能を提供します:

  • 複数ブランドのプリンターを管理するAPI:Bambu Lab X1Cを操作するコードで、Prusa MK4、Anycubic Kobra、OctoPrint互換プリンターも操作できます。
  • キュー、承認、振り分けの仕組み:プリンターごとの制御だけでなく、承認ワークフロー、ユーザーごとの権限、自動振り分けを備えた複数プリンター用のキューです。
  • 作業場全体のフィラメント在庫:1台のAMSにセットされたものだけでなく、フィラメント管理内のすべてのスプールと、1 gあたりの原価を管理できます。
  • パートナー連携向けOAuth2:Bambuの認証情報を共有する必要がなく、各ユーザーのSimplyPrintアカウントに接続できる連携を提供できます。
  • Webhookプッシュイベント:イベントが発生した瞬間にSimplyPrintがPOSTします。ポーリングは不要です。
SimplyPrintとBambu純正ツールは共存でき、両方を同時に使用できます。

APIのメインページを見る

Bambu Lab 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アクセス
アカウント内のすべてのBambu Labプリンターの状態、キュー、ジョブ、履歴を読み取ります。
拡張API(プリントを開始、G-codeを送信)
ファイルのアップロード、プリントを開始するキューの変更、G-codeの直接送信が利用可能になります。

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

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

Bambu Lab APIのよくある質問

X1C、X1E、P1S、P1P、A1、A1 Mini、H2DはすべてSimplyPrintに接続できます。接続後は、いずれも同じAPI機能を利用でき、/printers/Getのレスポンス形式、キューのエンドポイント、制御操作も共通です。
はい。各AMSスロットはフィラメントマネージャーでフィラメントスプールとして個別に追跡されます。装填されたスプールは/filament/GetFilamentに表示され、ブランド、素材、色、残量の重量、装填先のプリンターとスロットを確認できます。SimplyPrintはAMS、AMS Lite、AMS 2 Pro、AMS HTに対応しています。
はい。3MFまたはスライス済みのG-codeをアップロードし、ファイルIDと対象プリンターを指定して/queue/AddItemにPOSTします。キューは必要な色がAMSにセットされたBambu Labプリンターにジョブを振り分けます。条件に合うBambuプリンターがない場合は、見つかるまでキューで待機します。
SimplyPrintは独立したサービスであり、Bambu Labの一部ではありません。SimplyPrintは他のクラウドパネルと同様、Bambu Labがサードパーティーツール向けにサポートする公開プロトコルを通じてBambu Labのプリンターに接続します。
はい。SimplyPrintは、クラウド接続されたBambu Labプリンターと、軽量なローカルブリッジを介したLAN専用モードの両方に対応しています。API上では、LAN専用プリンターもクラウド接続のプリンターと同じように動作します。
https://api.simplyprint.io/{companyId}/{endpoint}。{companyId}はバージョンではなくアカウントIDです。認証にはヘッダーを1つ使用します:X-API-KEY: your_key_here。
はい。OAuth2フローにより、各オーナーは同意画面を通じて自身のSimplyPrintアカウントをアプリに接続できます。APIキーの共有は不要です。OAuth2の詳細とクライアント申請フォームについては、APIのメインページをご覧ください。

目次