ヘッドレス Blender の API: 自分で立てるか、呼ぶか

更新 2026-10-07

Blender は blender -b scene.blend -f 1(または -P script.py)でヘッドレスに描けるので、その API とは、NVIDIA GPU のある機械でこのコマンドを待ち行列から回し、コマを保存してリンクを渡す仕組みです。手間はその周りに集中します。Blender とドライバの導入、仕事ごとの GPU メモリの後始末、利用者のスクリプトの隔離、時間の見積もり、再試行、そして仕事の合間に遊んでいる GPU の費用。JANCTION Render はその API がデータセンターの GPU で既に動いているものです。.blend・bpy スクリプト・3D ファイルを POST すると、数秒の試し描き、見積もり、仕上げのコマか MP4、Webhook、そして AI エージェント向けの MCP サーバーが、1 日の無料枠つきで使えます。社内ネットワークから出せない、または一日中回すなら自前で。仕事が波のように来る、エージェントが動かす、手元に GPU が無いならホスト型を。

自前のヘッドレス Blender API に要るもの

部品自分でやるJANCTION Render では
機械NVIDIA GPU の箱(クラウド VM かオンプレ)、ドライバ、Blender 5.x、動画用の ffmpegデータセンターの NVIDIA RTX PRO 6000(96 GB)、Blender 5.0(ワーカーにあれば 5.2)、ffmpeg
仕事の実行blender -b scene.blend -o //out/ -F PNG -f 1 か blender -b -P script.py。ワーカーのループ。GPU 1 枚に 1 仕事POST /v1/jobs か render_final。コマを束に分けて列に入れる
隔離bpy のスクリプトはどのファイルも読めネットワークも開ける。仕事ごとのサンドボックス(コンテナ、読み取り専用 root、seccomp)が要る描画ごとに使い捨てのコンテナ、読み取り専用 root、スクリプトの検査。セキュリティ
試し描きと見積もり自分で書く: 低サンプルの並べ描きと、過去の仕事からの時間モデルrender_preview(1〜4 コマを 1 枚に、数秒)、実測のコマ単価からの render_estimate
受け渡しオブジェクトストレージ、署名付き URL、期限、MP4 の組み立て24 時間有効の署名付きリンク、MP4 / WebM / ProRes / GIF / WebP の組み立て、共有ページ
エージェントAPI を MCP の道具に自分で包むリモート MCP(OAuth)https://render.janction.jp/mcp、PyPI の stdio パッケージ、エージェント向けに書いた道具の説明
費用GPU は描いていても遊んでいても払う無料ベータ(鍵ごとに 1 日 10 GPU 分)。予定は 0.1 円/GPU 秒の従量

それでも自前で立てる場面

参考: 最小のヘッドレスのコマンド

# 1 コマを PNG に
blender -b scene.blend -o //render/frame_#### -F PNG -f 1
# 1〜48 コマを PNG に、それから ffmpeg で動画に
blender -b scene.blend -o //render/frame_#### -F PNG -s 1 -e 48 -a
ffmpeg -framerate 24 -i render/frame_%04d.png -c:v libx264 -pix_fmt yuv420p out.mp4
# スクリプトが組むシーン(AI エージェントが書くもの)を、スクリプトの設定で描く
blender -b -P build_scene.py

JANCTION Render も同じことを動かします。スクリプトはシーン・カメラ・コマ範囲だけを組み、解像度・サンプル・ノイズ除去・デバイス・出力はサービスが決めます。エージェント向けの流れは API のページ、バッチ / CI の切り口は クラウドのヘッドレス Blender に。

どこからやること
手元にあるファイル(.blend・3D ファイル)/upload に置くと 12 時間有効なリンクが出る(登録不要)。AI に「このファイルを描いて: リンク」と頼む。Blender の中からはアドオン、ターミナルは CLI が直接送る
Claude.ai(Web / アプリ)設定 → コネクタ → カスタムコネクタを追加 → https://render.janction.jp/mcp。「接続」を押すと同意ページで無料の鍵ができます
ChatGPT設定 → コネクタ → 詳細 → 開発者モード → 作成 → https://render.janction.jp/mcp(OAuth)
Claude Codeclaude mcp add --transport http janction-render https://render.janction.jp/mcp(/mcp で認証)
Codexcodex mcp add janction-render --url https://render.janction.jp/mcp
Cursor / VS CodeCursor に追加 VS Code に追加
ボタンでエディタが開き、確認して追加。手で入れるなら Streamable HTTP で https://render.janction.jp/mcp
ほかの MCP クライアントStreamable HTTP で https://render.janction.jp/mcp。OAuth か Authorization: Bearer <API キー>
ターミナル(stdio、手元のファイルを送る)claude mcp add janction-render -e JANCTION_RENDER_SERVER=https://render.janction.jp -- uvx --from janction-render janction-render-mcp
Blender の中から(人が使う)アドオン。拡張リポジトリ https://render.janction.jp/extensions/index.json。Maya / Houdini / Cinema 4D は送信ツール

よくある質問

JANCTION Render のワーカーを自分の GPU で動かせますか?

ワーカーは運営しているサービスの一部で、配布する製品ではありません。ファームを社内に置く必要があるなら上の表が作るものの一覧で、公開 API の形は OpenAPI にあるので、自前のクローンが同じ呼び出しで同じエージェントと話せます。

サービスのヘッドレス Blender はどの版ですか?

既定は 5.0、ワーカーにあれば 5.2(blender='5.2')。スクリプトは 5.x の Python API 向けに(マテリアルは常にノード、キーフレームは keyframe_insert)。

requests のような import があるスクリプトは通りますか?

通りません。ネットワーク・subprocess・仕事のフォルダ外のファイルアクセスは描く前に弾き(400 script_blocked)、実行時にも監査します。bpy・math・mathutils・random と標準の幾何の補助は使えます。

上限はありますか?

鍵ごと・回線ごとにあります。1 日の GPU 枠、1 回のコマ数と画素の上限、要求回数の上限。数字は /facts と各エラーの返事に。

関連

案内 · llms.txt

JANCTION Render v0.4.20 · JasmyLab Inc. · 更新 2026-10-07 · 検証 Blender 5.0, JANCTION Render 0.4.20 · English