# 3D シーン

> 4 つの 3D シーンツールのパラメーターです。プロンプトから編集できるクレイ調のシーンを作成し、修正し、MP4 にレンダリングするか、1 つのジョブで完成したショットを作ります。

Source: https://nodaro.ai/ja/docs/mcp/tools/3d-scenes

**3D シーンツール**は、単純な形状とキーフレームで付けた動きからなる、編集できるアニメーション付きのクレイ調のシーンを作成し、修正し、動画にレンダリングします。レンダリングした動画は、動画モデルのレイアウトと動きのガイドとして使えます。このページでは、各ツールのパラメーターを一覧にしています。一連の流れと結果の読み方は、[3D シーン](https://nodaro.ai/docs/mcp/3d-scenes)で説明しています。

どのツールにも `workflows:execute` 権限が必要で、ジョブ ID を返します。結果は `get_job` か `wait_for_job` で読み取ります。

## `generate_3d_scene`
プロンプトと任意のリファレンスから、編集できるアニメーション付きのクレイ調のシーンを作成します。フォトリアルな動画は作りません。[**3D シーン生成**（Generate 3D Scene）](https://nodaro.ai/docs/nodes/video/generate-3d-scene)ノードと同じように動作します。

**権限**：`workflows:execute`。**クレジット**：3D シーン生成ノードと同じで、10〜40 です。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `prompt` | string | **必須**。ショットの説明で、最大 8,000 文字です。 |
| `duration_seconds` | number | 1〜60 です。 |
| `fps` | integer | 15〜60 です。 |
| `aspect_ratio` | string | フレームの形です。 |
| `references` | array | 最大 8 個のリファレンスで、そのうち動画は 1 本までです。各リファレンスは `{ id, url, kind, role }` です。`kind` は `image` か `video` です。`role` は `appearance`、`layout`、`motion` のいずれかで、画像は見た目とレイアウトを、動画はレイアウトと動きをガイドします。動画リファレンスは全体が使われます。一部の区間だけを使うには、先にトリミングします。 |
| `input_assets` | array | 最大 8 個の既存の 3D モデル（GLB）で、それぞれ `{ id, revisionId, assetId, label }` です。インポートに対応したアドバンスエンジンが必要です。対応していない場合、呼び出しは課金の前に拒否されます。URL は送らないでください。 |
| `engine` | string | `basic`（デフォルト）、`blender-cloud`、`blender-local` のいずれかです。環境にないエンジンを指定すると拒否され、`basic` に切り替わることはありません。 |
| `max_repair_passes` | integer | アドバンスエンジンの修正パスの上限回数で、0〜2 です。 |
| `llm_model`, `reasoning_effort` | string | `basic` エンジンのプランナーです。アドバンスエンジンは固定のプランナーを使うため、省略します。 |
| `local_connection_id` | string | `blender-local` で使う、ペアリング済みのデスクトップの接続です。 |
| `accepted_scene_schema_versions` | array | クライアントが受け付ける、シーン形式のバージョンです。 |

**戻り値**：ジョブ ID です。完了したジョブの `output_data.scenePlan` が、`revisionId` を含むシーンです。

## `edit_3d_scene`
シーンを修正し、以前のリビジョンも残します。プランナーが適用するプロンプトか、LLM を呼び出さずに直接適用される操作のどちらかを送ります。[**3D シーン編集**（Edit 3D Scene）](https://nodaro.ai/docs/nodes/video/edit-3d-scene)ノードと同じように動作します。

**権限**：`workflows:execute`。**クレジット**：3D シーン編集ノードと同じで、0〜40 です。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `scene_plan` | object | **必須**。シーンのジョブから得た `scenePlan` の全体です。 |
| `expected_revision_id` | string | **必須**。プランの `revisionId` です。一致しない場合、編集は拒否されます。 |
| `prompt` | string | 変更内容を言葉で書いたもので、最大 8,000 文字です。 |
| `operations` | array | 1〜100 個の正確な変更です。`set-object`、`add-object`、`remove-object`、`set-camera`、`set-lighting`、`set-background` のいずれかです。 |
| `locked_object_ids` | array | 編集で変更してはいけないオブジェクトです。 |
| `selected_object_ids` | array | 編集の対象になるオブジェクトです。 |
| `references` | array | `generate_3d_scene` と同じです。 |
| `replace_references` | boolean | シーンの画像リファレンスと動画リファレンスを、`references` で置き換えます。 |
| `engine`, `max_repair_passes`, `llm_model`, `reasoning_effort`, `local_connection_id`, `accepted_scene_schema_versions` | | `generate_3d_scene` と同じです。 |

**戻り値**：ジョブ ID です。完了したジョブの `output_data` には、新しい `scenePlan` と `changeSummary` が入ります。MP4 だけでは、編集できるシーンにはなりません。動画からシーンを作り直すには、その動画をリファレンスにして `generate_3d_scene` を使います。

## `render_3d_scene`
特定のシーンのリビジョンを、**動画レンダリング**（Render Video）のエンジンで MP4 にレンダリングします。LLM は実行されません。カメラ、長さ、フレームは、シーンプランから取得されます。

**権限**：`workflows:execute`。**クレジット**：プランのフレームサイズによって決まります。長辺が 1920 ピクセルまでは 50、それを超えて 5.12 メガピクセルまでは 75、それより大きなフレームは 125 です。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `scene_plan` | object | **必須**。レンダリングするシーンプランです。 |

**戻り値**：ジョブ ID です。結果は動画の URL です。プランの `width` と `height` は、意図して設定してください。2560 × 2560 のシーンは 1920 × 1080 のシーンの 2.5 倍の料金がかかりますが、1920 × 1920 は 1920 × 1080 と同じ料金です。料金の一覧は、[動画レンダリング](https://nodaro.ai/docs/nodes/video/render-video)に記載されています。

## `pro_3d_render`
完成した 3D ショットを 1 つのジョブで作ります。完了したジョブには、シーンプラン、MP4、ショットごとの静止画 1 枚が含まれます。このツールは、対応するエンジンがある環境でだけ、ツールの一覧に表示されます。[**3D レンダリング Pro**（3D Render Pro）](https://nodaro.ai/docs/nodes/video/pro-3d-render)ノードと同じように動作します。

**権限**：`workflows:execute`。**クレジット**：同じ呼び出しの中で見積もられ、課金されます。シーンの作成と各修正パスは有料です。既存のシーンをそのままエクスポートする場合は、作成の料金はかかりません。**Nodaro Cloud のみ**。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `source` | object | **必須**。下の 3 つのソースのうち、ちょうど 1 つです。 |
| `duration_seconds`, `fps` | number | 1〜60 秒と、15〜60 fps です。シーンをソースにする場合は、タイミングを変更するつもりがない限り省略します。矛盾する値は拒否されます。 |
| `aspect_ratio` | string | `16:9`、`9:16`、`1:1`、`4:5`、`21:9` のいずれかです。シーンをソースにする場合は省略します。 |
| `max_repair_passes` | integer | 修正パスの上限回数で、0〜2 です。デフォルトは `2` です。各パスは有料です。 |
| `engine` | string | `blender-cloud` または `blender-local` です。 |
| `quality`, `style` | string | `standard` と `clay` です。 |
| `client_request_id` | string | 再試行用のトークンで、英字、数字、`_ - . :` からなる 8〜128 文字です。タイムアウトの後に再試行するときに同じ値を使うと、ジョブが二重に開始されたり、二重に課金されたりしません。 |

| `source.kind` | フィールド | 動作 |
| --- | --- | --- |
| `prompt` | `prompt`。任意で `references` と `input_assets` | 説明文から新しいシーンを作成し、レンダリングします。 |
| `scene` | `revision_id`。任意で `source_job_id` と `edit_prompt` | 既存のリビジョンをレンダリングします。`edit_prompt` がない場合は、そのままエクスポートします。ある場合は、先にシーンを修正するため、作成の料金がかかります。ジョブの履歴にだけ残っている `basic` のシーンには、`source_job_id` が必要です。 |
| `local-export` | `export_id`、`connection_id` | 利用できる場合、ペアリング済みのデスクトップアプリで完了したエクスポートを使います。 |

**戻り値**：ジョブ ID です。完了したジョブの `output_data` には、`scenePlan`、`videoUrl`、`shotStills` が入ります。`shotStills` はショットごとの静止画で、それぞれ `{ shotIndex, frame, assetId, url }` です。モデルや推論のパラメーターはありません。プランナーは固定です。

## Frequently asked questions

### 3D シーンのレンダリングには、何クレジットかかりますか？

レンダリングの料金は、シーンプランのフレームサイズで決まります。長辺が 1920 ピクセルまでは 50 クレジット、それを超えて 5.12 メガピクセルまでは 75 クレジット、それより大きなフレームは 125 クレジットです。

### 3D シーンを編集すると、常に AI モデルが呼び出されますか？

いいえ。オブジェクトの移動やカメラの変更などの操作で編集する場合は、LLM を呼び出さずに、操作が直接適用されます。プロンプトで編集する場合は、プランナーに変更を依頼します。

### render_3d_scene と pro_3d_render の違いは何ですか？

render_3d_scene は、既存のシーンのリビジョンを MP4 にエクスポートします。pro_3d_render は、シーンの作成、修正、エクスポートを 1 つのジョブで行い、シーンプラン、MP4、ショットごとの静止画 1 枚を返します。pro_3d_render は、そのエンジンがある環境でだけ使えます。