3D ファイルを API(と MCP)で MP4 に

更新 2026-10-07

JANCTION Render は 3D ファイルを HTTP 4 回で動画にします。POST /v1/keys で鍵(登録不要)、POST /v1/files/url にファイルの https リンク(scene_id が返る)、POST /v1/jobs に kind 'final'・output 'mp4' と、orbit true(ターンテーブル)かコマ範囲(ファイル自身のアニメーション)、そして GET /v1/jobs/{id} が done になったら成果物のリンクから output.mp4 を取る。AI エージェントからは render_final(scene_url=..., orbit=True, output='mp4') の 1 回です。読み込みと描画はデータセンターの GPU の Blender 5.0(Cycles)。glTF や OBJ の隣のテクスチャは自動で取ります。無料ベータは鍵ごとに 1 日 10 GPU 分、1 回 240 コマ・1080p まで。

HTTP: 4 回の呼び出し

# 1. 鍵(登録不要。控えておく)
KEY=$(curl -s -X POST https://render.janction.jp/v1/keys | python -c "import sys,json;print(json.load(sys.stdin)['api_key'])")

# 2. ファイルを https のリンクで(.glb .gltf .fbx .usd .usdc .usdz .obj .stl .ply .abc か .blend / .py)
curl -s -X POST https://render.janction.jp/v1/files/url -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/model.glb"}'
# -> {"scene_id": "f_...", ...}

# 3a. ターンテーブル動画(1 回転、48 コマ、studio の照明)
curl -s -X POST https://render.janction.jp/v1/jobs -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
  -d '{"scene_id": "f_...", "kind": "final", "orbit": true, "orbit_frames": 48, "width": 1280, "height": 720,
       "samples": 64, "environment": "studio", "output": "mp4", "fps": 24}'
# 3b. またはファイル自身のアニメーション(アニメーションクリップを持つ glTF の 1〜120 コマ)
#  -d '{"scene_id": "f_...", "kind": "final", "frame_start": 1, "frame_end": 120, "width": 1280, "height": 720,
#       "samples": 64, "environment": "studio", "output": "mp4", "fps": 24}'
# -> {"job_id": "j_...", "status": "queued", "estimate": {"seconds": ..., "human": "..."}, ...}

# 4. 待って、取る
curl -s https://render.janction.jp/v1/jobs/j_... -H "X-API-Key: $KEY"        # status, progress, eta, artifacts[]
curl -s -o output.mp4 "https://render.janction.jp/v1/jobs/j_.../artifacts/output.mp4" -H "X-API-Key: $KEY"

3 の前に同じ本文を POST /v1/estimate に送ると、GPU 秒と今日の枠に収まるかが返ります。仕事の本文の notify_url には終了時に JSON が 1 回 POST されるので、パイプラインは待ち受けなくて済みます。項目は全部 OpenAPI に。試し描き("kind": "preview"、1〜4 コマを 1 枚に)は GPU 数秒で、最初の 1 手に向いています。

MCP: 1 回

render_preview(scene_url="https://example.com/model.glb", orbit=True, environment="studio")   # 4 方向、数秒
render_final(scene_url="https://example.com/model.glb", orbit=True, orbit_frames=48, width=1280, height=720,
             environment="studio", output="mp4")                                                 # 動画

MCP の URL は https://render.janction.jp/mcp。Claude.ai・ChatGPT・Claude Code・Codex・Cursor は OAuth でつながり、同意ページで無料の鍵が出ます。

サービスがファイルにすること

形式読み込み一緒に要るもの
.glbBlender の glTF インポーター全部ファイルの中
.gltfglTF インポーター.bin とテクスチャを .gltf と同じフォルダから取る
.objOBJ インポーター.mtl とそこに書かれたテクスチャを同じフォルダから
.fbx、.usd / .usdc / .usdz、.stl、.ply、.abcBlender のインポーターテクスチャを埋め込むか、asset_urls で渡す(ファイルの隣に置かれる)

モデルは中心に置かれます。orbit ならカメラが指定の高さと距離で周り(床や壁のような平らなものは画角決めから外す)、orbit 無しならファイルにカメラがあればそれ、無ければ既定のカメラが全体を収めます。出力は mp4(H.264)、webm(VP9、transparent で透過)、prores(.mov、編集用)、gif / webp(960 px まで)、または png / exr の連番。

ベータ中の上限

1 回 240 コマ・1080p まで(長いクリップは分ける。notify_url で連結できる)、鍵ごとに 1 日 10 GPU 分、入力と結果は最後に使ってから 24 時間で削除。実測: ヘッドホンの 24 コマ 720p ターンテーブルが GPU 58 秒、EEVEE の 48 コマ 720p クリップが 46〜57 秒(実例、費用)。

どこからやること
手元にあるファイル(.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 は送信ツール

よくある質問

Blender を入れておく必要はありますか?

ありません。サービスの GPU ワーカーが Blender 5.0 を動かします。送るのはファイルのリンク、返るのもリンクです。

ファイル自身のアニメーションは描けますか?

描けます。glTF・FBX・USD・Alembic のアニメーションを読み込むので、orbit の代わりに frame_start / frame_end を渡します。コマ範囲は scene_info(MCP)か kind 'info' の仕事で分かります。

ファイルの大きさは?

数十 MB なら問題ありません。受付が 1 回取り込み、最後に使ってから 24 時間保持します。テクスチャが多いときは asset_urls で渡すか埋め込み(GLB・USDZ)に。

Webhook はありますか?

あります。仕事の本文の notify_url に、終了時(job.done か job.failed、成果物のリンクつき)JSON が 1 回 POST されます。

関連

案内 · llms.txt

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