3D シーン編集

3D シーン編集（Edit 3D Scene）ノードは、既存の 3D シーンの新しいバージョンを作ります。「Move the pillar back one meter and keep the suitcase path unchanged」のように、変更内容を普通の言葉で説明します。AI モデルがその変更を適用し、ロックしたオブジェクトはそのままの状態に保たれます。3D シーン生成（Generate 3D Scene）のシーンをシーン入力に接続し、結果は動画レンダリング（Render Video）でエクスポートします。

使いどころ

• ブロッキング（配置と動き）はほぼ思いどおりなので、最初からやり直さずに、カメラ、1 つのオブジェクト、またはタイミングを変更したいとき。
• 1 つのシーンのバリエーションを試し、それぞれのバージョンを残したいとき。
• リファレンス画像や動画を加えて、変更をガイドしたいとき。

利用できる場所

3D シーン編集は、すべてのエディションのノードピッカーの動画 › タイトル、グラフィック、字幕にあります。コードや AI アシスタントからは、API、SDK、MCP の edit_3d_scene ツールで実行できます。

クイックスタート

入力

出力のコンポジションは、新しいリビジョンです。動画レンダリングか、別の 3D シーン編集に接続します。

設定

指示の下には、ロックされているオブジェクトの数が表示されます。ロックは、モデルの応答後にチェックされます。ロックしたオブジェクトは、すべて変更されずに返される必要があります。

2 つの編集方法

プレビューでの直接編集は、表示中のフレームに対して行われます。アニメーションしているチャンネルでは、変更によって現在のフレームのキーフレームが更新されるか、挿入されます。アニメーションしていないチャンネルでは、変更によってすべてのフレームでオブジェクトが移動します。

すべての編集は、シーン全体と照合してチェックされます。対象は、オブジェクトの ID、オブジェクトの階層、アニメーションのフレームです。編集によって、親やリファレンスが存在しないものを指したままになることはありません。元のシーンは変更されずに残り、新しいリビジョンは元のシーンを親として記録します。

リビジョン

• 何も上書きされない：編集するたびに、新しいリビジョンが作られます。リビジョンリストには以前のリビジョンが残るので、比較したり、1 つを復元したりできます。
• あなたの編集が優先される：手作業でシーンを変更した後にモデルの編集が完了した場合、あなたの変更が有効なまま残ります。お知らせに、新しいリビジョンを使用と自分の編集を保持が表示されます。
• MP4 ごとに 1 つのリビジョン：動画レンダリングは、実行時に使用中のリビジョンをエクスポートします。

MP4 は編集可能なシーンではありません。動画をもとに作業するには、その動画をリファレンスとして 3D シーン生成に接続し、生成されたシーンを編集します。

クレジット

レンダリングは常に別のステップです。3D シーンのレンダリング料金を参照してください。Community エディションと Business エディションでは、クレジットによる課金はありません。

ヒント

• 指示の前にロックする：ロックしたオブジェクトは変更されずに返される必要があり、Nodaro はモデルの応答後にそれを確認します。
• 正確な値には直接編集を使う：カメラの高さやオブジェクトの位置など、数値がわかっている場合は、プレビューで入力します。すぐに反映され、無料です。
• レンダリングの前に比較する：以前のリビジョンはリビジョンリストに残るので、エクスポートの前にバージョンを比較し、1 つを復元できます。
• 動画リファレンスは先にトリミングする：動画リファレンスは、クリップ全体が使われます。動画のトリミング（Trim Video）で、必要な部分だけを残してください。

API からの利用

POST /v1/3d-scene/edit は、scenePlan、expectedRevisionId、そして prompt または operations のリストのどちらかを受け取ります。古いリビジョンに基づくリクエストは拒否されます。編集に成功すると、ジョブが返されます。ジョブの output_data.scenePlan には新しいリビジョンが入り、あわせて changeSummary も返されます。

const edited = await client.nodes.runAndWait("edit-3d-scene", {
  scenePlan: scene.scenePlan,
  expectedRevisionId: scene.scenePlan.revisionId,
  operations: [{ op: "set-camera", changes: { focalLengthMm: 50 } }],
});

• オペレーションは送信したフィールドだけを変更する：キーフレームが設定されたポーズを変更するには、そのキーフレームの変更も含めます。
• ロック：lockedObjectIds には、変更されずに返される必要があるオブジェクトを列挙します。
• リファレンス：新しいリファレンスは ID によって既存のリファレンスと統合され、同じ ID のリファレンスは置き換えられます。replaceReferences: true を完全なリストと一緒に送るとすべてが置き換えられ、空のリストと一緒に送るとすべて消去されます。
• アドバンスエンジン：アドバンスエンジンで作られたシーンはそのエンジンで編集され、ベーシックを指定すると拒否されます。アドバンスエンジンでの指示による編集では、新しいシーンと同じ詳細が報告されます。これには、ビジュアルレビューの承認なしに納品された結果や、失敗した実行から保持された下書きも含まれます。3D レンダリング Pro を参照してください。

AI アシスタントは、MCP の edit_3d_scene ツールを使い、ロックには locked_object_ids を指定します。MCP での 3D シーンを参照してください。