3D シーン

3D シーンは、編集できるアニメーション付きのクレイ調シーンです。単純な形状とキーフレームによる動きで構成され、プロンプトと、任意の画像や動画のリファレンスから作成されます。AI アシスタントからシーンを作成し、言葉による指示か正確な操作で修正して、MP4 にレンダリングします。レンダリングした動画は、動画モデルのレイアウトと動きのガイドとして使います。MCP ツールは、キャンバス上の 3D シーン生成（Generate 3D Scene）ノードと 3D シーン編集（Edit 3D Scene）ノードと同じ処理を行います。

ツール

どのツールにも workflows:execute が必要で、ツールはジョブ ID を返します。結果は get_job または wait_for_job で読み取ります。シーンのジョブは output_data.scenePlan を返し、レンダリングは動画の URL を返します。パラメーターはツールリファレンスに記載されています。

作業の流れ

クレイ調のレンダリングは、レイアウトのガイドであって、見た目の手本ではありません。キャプションがないと、動画モデルがグレーのクレイの見た目まで真似てしまうことがあります。

最初のバージョンでできること

• 形状と動き：シーンは、プリミティブな形状と、決定論的なキーフレームアニメーションを使います。
• リファレンスはおおよその再現になります。リファレンスをもとに作ったシーンは、元のリファレンスの近似です。
• 動画リファレンスは全体を使用：動画リファレンスは、クリップ全体が使われます。一部だけを使うには、先にクリップをトリミングし、トリミングした URL を渡します。一部の時間範囲を指定すると、シーン作成の料金が発生する前に拒否されます。
• 操作では LLM を呼び出しません。operations による編集は、そのまま適用されます。レンダリングも同様です。

エンジン

generate_3d_scene と edit_3d_scene は engine を受け付けます。値は、basic（デフォルト）、blender-cloud、blender-local のいずれかです。アドバンスエンジンは、デプロイメントで利用できる必要があります。利用できないエンジンを指定すると拒否され、basic に切り替わることはありません。アドバンスエンジンは固定のプランナーを使うため、llm_model と reasoning_effort は指定せず、修正の上限は max_repair_passes で設定します。

インポートに対応したアドバンスエンジンでは、generate_3d_scene は input_assets も受け付けます。既存の 3D モデル（GLB）を最大 8 個まで指定でき、それぞれ { id, revisionId, assetId, label } の形式です。画像と動画は、引き続き references に入れます。エンジンがインポートに対応していない場合、インポートは料金が発生する前に拒否されます。また、ファイルはサーバー自身が解決するため、URL やハッシュは送らないでください。

レンダリングの料金

レンダリングの料金は、渡したプランのフレームサイズで決まります。

シーンプランの width と height は、意図して設定してください。2560×2560 のシーンは 1920×1080 のシーンの 2.5 倍の料金ですが、1920×1920 は 1920×1080 と同じ料金です。完全な表は、動画レンダリングにあります。

アドバンスエンジンの結果を読む

アドバンスエンジンが作成したシーンは、エンジンが置いた前提と、実行した処理を報告します。以下のフィールドはすべて任意で、basic エンジンはどれも報告しません。

レンダリングのみのエクスポートは何も作成しないため、概要は報告されず、各回数も含まれません。

完了したシーンが承認されなかった場合

完了したジョブに metadata.review が含まれることがあります。これは、シーンがビジュアルレビューの承認なしに納品されたことを意味します。ステータスや警告の数ではなく、metadata.review があるかどうかを確認し、ユーザーに何かを伝える前に、その verdict を読んでください。

• refused：修正パスの上限を使い切り、必須のチェックにはすべて合格しましたが、それでもレビューが異議を示しました。シーンには、異議の内容と、異議 1 つにつき 1 つの SCENE_REVIEW_REFUSED 警告が付きます。
• unavailable：レビューが、attempts 回の試行で使える判定を返しませんでした。reason は、レビューがモデルに届かなかった場合は provider、応答が使えなかった場合は unusable です。シーンは誰にも評価されておらず、validation.warnings[] は SCENE_REVIEW_UNAVAILABLE から始まります。誰もレビューしていないシーンについて、拒否されたと報告しないでください。

どちらの場合も validation.status は passed のままで、異議のリストが空のこともあります。

アドバンスエンジンのジョブが失敗した場合

SCENE_QUALITY_FAILED で失敗したジョブは、品質を保証できるシーンを作れないまま、上限を使い切っています。もう一度実行する前に、その output_data を読んでください。

• 下書きが構築された場合：失敗したジョブは、scenePlan、sceneRevisionId、deliveryId、posterAssetId で下書きを示し、validation.status は failed です。下書きは通常のリビジョンなので、edit_3d_scene や render_3d_scene に渡せます。
• 何もコンパイルされなかった場合：scenePlan はありませんが、ジョブには deliveryId があり、validation.sourceRetained が、レシピが保持されたかどうかを示します。REST API の GET /v1/3d-scene/deliveries/{deliveryId} で取得し、続けてその source-json アセットを取得します。読み取りにクレジットはかかりませんが、あなた自身の認証情報と、ジョブのワークフローの編集権限が必要です。これを行う MCP ツールはありません。

まったく同じプロンプトをもう一度実行すると、同じシーン作成の料金を 2 回払うことになります。

3D レンダリング Pro

pro_3d_render は、generate_3d_scene のオプションではなく、別の操作です。1 つのジョブで、完成したショットを作ります。完了した出力には scenePlan と videoUrl の両方が含まれ、リビジョン、ポスター、検証結果、レンダラーの詳細も付きます。このツールは、それを実装したエンジンがあるデプロイメントにしか表示されません。そのため、ツールの一覧にあるかどうかで、利用できるかを確認できます。3D レンダリング Pro（3D Render Pro）ノードと同じように動作します。

出力には shotStills も含まれます。これは、コンポジションのショットごとに 1 枚の静止画を、ショットの順に並べたもので、形式は { shotIndex, frame, assetId, url } です。shotIndex は 0 から数え、frame はショットの最初のフレームなので、静止画は MP4 と位置がそろいます。ショットが 1 つだけのシーンでは、フレーム 0 の静止画がちょうど 1 枚です。静止画は同じ実行から作られ、追加料金はかかりません。動画モデルでそのショットを生成するときは、そのショットの静止画を画像リファレンスとして使います。

納品ファイルは非公開なので、各静止画の url は、インストール環境上の、認証が必要なアドレスです。取得するには、あなた自身の認証情報を使います。公開リンクではありません。それでも、この URL は generate_image や generate_video に渡せます。その実行には、そのファイル 1 つだけを読み取れる短時間の権限が与えられます。この権限は数分間だけ有効で、保存されないため、何かを保存するときは、認証が必要な URL のほうを残してください。

安価で編集できるクレイ調のプリビズには、generate_3d_scene、edit_3d_scene、render_3d_scene を使います。シーンの正確な形式と現在のデフォルト値を知るには、generate-3d-scene または edit-3d-scene を指定して get_node_skill を呼び出すよう、アシスタントに頼んでください。