# 3D シーン編集

> クレイ調の 3D シーンを、普通の言葉による指示か無料の直接編集で変更します。変えてはいけないオブジェクトはロックでき、すべてのリビジョンが残るので、比較や復元もできます。

Source: https://nodaro.ai/ja/docs/nodes/video/edit-3d-scene

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

- Found in: Video › Titles, Graphics & Captions
- Output: data
- API type: `edit-3d-scene`

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

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

## クイックスタート
### ノードを追加する
キャンバス上で Tab を押し、**動画 › タイトル、グラフィック、字幕 › 3D シーン編集**を選びます。

### シーンを接続する
3D シーン生成、または別の 3D シーン編集の**コンポジション**出力から、**シーン**入力までドラッグします。

### 変えてはいけないものをロックする
プレビューのオブジェクトリストで、変更されずに返される必要があるオブジェクトをすべてロックします。

### 変更内容を書いて実行する
**編集の指示**に、変更内容を書きます。たとえば `Move the camera lower and push the back wall two metres further away` のように書きます。**実行**をクリックします。新しいリビジョンがプレビューに表示されます。

Workflow: 生成したシーンを編集の指示で修正し、クレイ調の MP4 としてエクスポートします。

- 3D シーン生成 → 3D シーン編集 (シーン)
- 3D シーン編集 → 動画レンダリング (コンポジション)

## 入力
| 入力 | 接続できるノード | 説明 |
| --- | --- | --- |
| **シーン** | 3D シーン生成、3D シーン編集、または **3D レンダリング Pro**（3D Render Pro）の**コンポジション**出力 | 変更するシーンです。必須です。 |
| **リファレンス** | 画像ノードと動画ノード | 任意。変更をさらにガイドするもので、見た目、レイアウト、動きを示します。合計したリファレンスは、3D シーン生成と同じ上限内に収まります。最大 8 個で、そのうち動画は 1 本までです。 |

出力の**コンポジション**は、新しいリビジョンです。[動画レンダリング](https://nodaro.ai/docs/nodes/video/render-video)か、別の 3D シーン編集に接続します。

## 設定
| 設定 | 説明 |
| --- | --- |
| **シーン作成エンジン** | インストール環境にアドバンスエンジンがある場合にだけ表示されます。アドバンスエンジンで作られたシーンは、そのエンジンで編集されます。そのシーンでは、ベーシックは無効になります。 |
| **AI モデル** | 指示を適用する言語モデルです。デフォルトは **Claude Sonnet 4.6** です。モデルのティア（**エコノミー**、**スタンダード**、**プレミアム**）によって料金が決まります。 |
| **推論の強度** | 推論できるモデルで表示されます。**非常に高い**と**最大**では、1 段階上のティアで課金される場合があります。 |
| **編集の指示** | 普通の言葉で書いた変更内容です。 |
| **リファレンス** | 接続した各リファレンスに、**appearance**、**layout**、**motion** のいずれかの役割を 1 つ指定します。 |
| **前後のテキスト** | 実行時に指示の前後に追加されるテキストです。[プロンプトの前後のテキスト](https://nodaro.ai/docs/concepts/prompt-pre-post-text)を参照してください。 |

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

## 2 つの編集方法
| | 編集の指示 | 直接編集 |
| --- | --- | --- |
| **方法** | 変更内容を書いて**実行**をクリック | プレビューで値を変更するか、API で編集オペレーションを送信 |
| **AI モデル** | あり（選んだモデル） | なし |
| **クレジット** | Nodaro Cloud では、モデルのティアに応じて 10、30、40 | 無料 |
| **結果** | 新しいリビジョン | 新しいリビジョン |

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

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

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

MP4 は編集可能なシーンではありません。動画をもとに作業するには、その動画をリファレンスとして [3D シーン生成](https://nodaro.ai/docs/nodes/video/generate-3d-scene)に接続し、生成されたシーンを編集します。

## クレジット
| 操作 | Nodaro Cloud でのクレジット |
| --- | --- |
| 直接編集と API の編集オペレーション | 0 |
| 編集の指示 | エコノミー、スタンダード、プレミアムのモデルでそれぞれ 10、30、40 |
| 動画リファレンス | その動画の[**動画分析**（Video Analysis）](https://nodaro.ai/docs/nodes/video/video-analysis#credits)の料金 |
| 新しいリビジョンを動画レンダリングでレンダリング | 長辺が 1920 ピクセルまでは 50、5.12 メガピクセルまでは 75、それを超える場合は 125 |

レンダリングは常に別のステップです。[3D シーンのレンダリング料金](https://nodaro.ai/docs/nodes/video/render-video#what-a-3d-scene-render-costs)を参照してください。Community エディションと Business エディションでは、クレジットによる課金はありません。

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

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

| オペレーション | フィールド |
| --- | --- |
| `set-object` | `objectId`、`changes`（ID 以外の任意のオブジェクトフィールド） |
| `add-object` | `object` |
| `remove-object` | `objectId` |
| `set-camera` | `changes` |
| `set-lighting` | `changes` |
| `set-background` | `color` |

```typescript
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](https://nodaro.ai/docs/nodes/video/pro-3d-render#what-happens-when-a-run-does-not-pass) を参照してください。

AI アシスタントは、MCP の `edit_3d_scene` ツールを使い、ロックには `locked_object_ids` を指定します。[MCP での 3D シーン](https://nodaro.ai/docs/mcp/3d-scenes)を参照してください。

## Frequently asked questions

### 3D シーンの編集にはクレジットがかかりますか？

プレビューでの直接編集と API の編集オペレーションは、モデルを実行しないので無料です。編集の指示は AI モデルを呼び出し、Nodaro Cloud ではエコノミー、スタンダード、プレミアムのモデルでそれぞれ 10、30、40 クレジットかかります。

### オブジェクトをそのままの状態に保つにはどうすればよいですか？

指示を実行する前に、プレビューのオブジェクトリストでそのオブジェクトをロックします。Nodaro は、モデルの応答後に、ロックしたすべてのオブジェクトが変更されずに返されたかを確認します。

### 3D シーン編集で MP4 を編集できますか？

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

### 以前のバージョンに戻せますか？

はい。編集するたびに新しいリビジョンが作られ、古いリビジョンも残ります。リビジョンリストで任意のリビジョンを選ぶと、そのリビジョンが再び使用中になります。

### 手作業でシーンを変更した後にモデルの編集が完了した場合は、どうなりますか？

あなたの編集が有効なまま残ります。お知らせに「新しいリビジョンを使用」と「自分の編集を保持」が表示されるので、手作業で行った変更が失われることはありません。