# 3D レンダリング Pro

> 説明文からアニメーション付きの 3D シーンを作成し、ホスト型のエンジンで、1 回の実行でレンダリングします。MP4、編集できるシーン、ショットごとの静止画 1 枚が返されます。

Source: https://nodaro.ai/ja/docs/nodes/video/pro-3d-render

**3D レンダリング Pro**（3D Render Pro）ノードは、説明文からアニメーション付きの 3D シーンを作成し、ホスト型のビルドエンジンで、1 回の実行でレンダリングします。1 回の実行で、完成した MP4、レンダリングに使った正確なシーン、ショットごとの静止画 1 枚が返されます。[**3D シーン生成**（Generate 3D Scene）](https://nodaro.ai/docs/nodes/video/generate-3d-scene)とは別のノードです。3D シーン生成は低コストで編集できるクレイ調のプリビズで、その MP4 は、別途[**動画レンダリング**（Render Video）](https://nodaro.ai/docs/nodes/video/render-video)を実行して作ります。

- Found in: Video › Titles, Graphics & Captions
- Output: video
- API type: `pro-3d-render`

3D レンダリング Pro は Nodaro Cloud でだけ実行でき、それも Cloud の 3D エンジンが提供している間に限られます。セルフホスティングのエディションでは、このノードは提供されません。

## 使いどころ
- 後でレンダリングするプリビズではなく、完成した 3D ショットを、説明文から 1 ステップで作りたいとき。
- 既存のシーンを、作成し直す料金を払わずに、もう一度エクスポートしたいとき。
- 後の生成で画像リファレンスとして使うために、ショットごとの静止画が欲しいとき。
- 3D シーン生成にはない、横長の `21:9` のフレームを使いたいとき。

## 利用できる場所
- **ノードピッカー**：Nodaro Cloud では、3D エンジンがこのノードを提供している間、**動画 › タイトル、グラフィック、字幕 › 3D レンダリング Pro** にあります。エンジンが利用できないときは、ノードは無効な状態で表示されるのではなく、一覧にまったく表示されません。
- **API と SDK**：`GET /v1/3d-scene/capabilities` が `pro.available` を返します。ノードを利用できない環境では、`GET /v1/nodes` の結果にノードが含まれず、リクエストは `503 SCENE_CAPABILITY_UNAVAILABLE` で拒否されます。代わりにベーシックエンジンで実行されることはありません。
- **MCP**：`pro_3d_render` ツールは、ノードを実行できる環境でだけ一覧に表示されます。そのため、ツールの一覧にあるかどうかで確認できます。

すでにこのノードを含むワークフローは、後でエンジンがオフになっても、保存済みのシーンと動画を保持します。拒否されるのは、新しい実行だけです。

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

### シーンのソースを選ぶ
**シーンのソース**で**説明文から新しいシーンを作成**を選び、**シーン**にショットの内容を書きます。リファレンスがあれば、それも使います。または、**既存のシーン**を選んで**シーン**入力にシーンを接続し、レンダリングだけを行う場合は**編集指示（任意）**を空欄のままにします。

### 修正パスの上限とフレームを確認する
**修正パスの上限**は 2 のままにするか、それより下げます。**設定**の中で、**FPS**、**長さ（秒）**、**アスペクト比**を確認します。

### 実行する
**実行**をクリックします。Nodaro が実行の見積もりを出してから実行を開始し、ノードには上限が**最大 N クレジット**と表示されます。実行が終わると、ノードに MP4、シーン、静止画がそろいます。

Workflow: 3D レンダリング Pro を 1 回実行すると、キーフレーム用のショットの静止画と、最終的な生成のためのレイアウト動画が得られます。

- 画像アップロード → 3D レンダリング Pro (リファレンス)
- 3D レンダリング Pro → 画像生成 (リファレンス)
- 3D レンダリング Pro → 動画生成 (動画リファレンス)
- 画像生成 → 動画生成 (開始フレーム)

## シーンのソース
どの実行にも、ソースは必ず 1 つだけです。何が起こるかと、何に料金がかかるかは、どちらもソースによって決まります。

| **シーンのソース** | 何が起こるか | 料金がかかるもの |
| --- | --- | --- |
| **説明文から新しいシーンを作成** | 説明文とリファレンスからシーンを作成し、レンダリングします。 | シーンの作成、ホスト型ビルド、レンダリング |
| **既存のシーン**（編集指示なし） | そのシーンのリビジョンを、そのままレンダリングします。 | レンダリングのみ |
| **既存のシーン**（編集指示あり） | 先にシーンを修正してから、レンダリングします。 | シーンの作成、ホスト型ビルド、レンダリング |

**編集指示（任意）**が空欄であることが、実行をレンダリングのみにする条件です。API で単純なエクスポートを行う場合は、`editPrompt` フィールドを省略してください。空の文字列は、別のリクエストとして扱われます。

4 つ目のソースとして、ペアリングしたデスクトップ版 Blender からの完了済みのエクスポートがあります。これは、インストール環境が対応している場合に、API から使えます。

## 入力
| 入力 | 接続できるノード | 説明 |
| --- | --- | --- |
| **シーン** | 3D シーン生成、**3D シーン編集**（Edit 3D Scene）、または別の 3D レンダリング Pro の**コンポジション**出力 | レンダリングまたは修正する、既存のシーンです。**既存のシーン**で使います。 |
| **リファレンス** | 画像ノードと動画ノード | 最大 8 個のリファレンスで、そのうち動画は 1 本までです。画像は外見とレイアウトを、動画は動きとレイアウトをガイドします。**説明文から新しいシーンを作成**で使います。 |

## 出力
| 出力 | 渡す内容 | 接続先 |
| --- | --- | --- |
| **コンポジション** | この実行で作られたシーンのリビジョン | [動画レンダリング](https://nodaro.ai/docs/nodes/video/render-video)、または別の 3D ノードの**シーン**入力。作成の料金を払わずに、もう一度エクスポートできます |
| **Stills** | ショットごとに 1 枚の静止画で、ショットの順に並びます。各ショットの最初のフレームです | 画像を受け取る任意のノード。最初の静止画だけでなく、セット全体が接続を通じて渡されます。 |
| **動画** | レンダリングされた MP4 | 動画を受け取る任意のノード |

動画ノードは、**コンポジション**ではなく**動画**に接続します。コンポジションはシーンであり、動画ではありません。

**静止画はコンタクトシートであり、2 回目のレンダリングではない**：静止画は同じ実行から作られ、追加料金はかかりません。ショットが 1 つだけのシーンでは、静止画はフレーム 0 の 1 枚だけです。静止画を使うと、ショットの最初のフレームを画像モデルや動画モデルに渡したり、MP4 をスクラブせずに、ショットごとのブロッキングを確認したりできます。

**静止画は、どの画像入力でも使える**：静止画は非公開で保存されます。**Stills** 出力を画像入力やリファレンス入力に接続すると、Nodaro は、モデルが必要とする静止画そのものを、短時間だけ読み取れるようにします。この読み取りはその実行専用で、あなた自身のアクセス権に基づきます。リンクは数分後に期限切れになり、保存されることはありません。

## 設定
| 設定 | 説明 |
| --- | --- |
| **シーンのソース** | **説明文から新しいシーンを作成**（デフォルト）または**既存のシーン**です。 |
| **シーン** | 新しいシーンの説明文です。オブジェクト、その動き、カメラ、タイミングを書きます。 |
| **編集指示（任意）** | **既存のシーン**で使います。シーンをそのままレンダリングするには、空欄のままにします。変更内容を書くと先にシーンが修正され、作成の料金がかかります。 |
| **リファレンス** | 接続した各リファレンスに、**appearance**、**layout**、**motion** のいずれかの役割を割り当てます。新しいシーンのみ。 |
| **修正パスの上限** | 最初の試行の後に行う修正パスの回数で、0、1、2 のいずれかです。デフォルトは 2 です。パスごとに料金がかかる作業なので、この上限が表示されています。 |
| **品質** | インストール環境に複数の品質プロファイルがある場合にだけ表示されます。現在のプロファイルは standard です。**設定**の中にあります。 |
| **このシーンのタイミングを再設定（シーン自体の長さ、fps、アスペクト比を上書き）** | **既存のシーン**で使います。デフォルトはオフで、シーンは自身のタイミングを保ちます。**設定**の中にあります。 |
| **FPS** | `24`（デフォルト）、`30`、`60` のいずれかです。**設定**の中にあります。 |
| **長さ（秒）** | 1〜60 秒です。デフォルトは 10 秒です。**設定**の中にあります。 |
| **アスペクト比** | `16:9`（デフォルト）、`9:16`、`1:1`、`4:5`、`21:9` のうち、インストール環境が提供しているものです。**設定**の中にあります。 |
| **前後のテキスト** | 実行時に説明文の前後に追加されるテキストです。[プロンプトの前後のテキスト](https://nodaro.ai/docs/concepts/prompt-pre-post-text)を参照してください。 |

モデルや推論の設定はありません。プランナーは固定されていて、Nodaro が実行します。スタイルはクレイです。

**既存のシーンのタイミング**：シーンにはもともと長さ、フレームレート、アスペクト比があり、実行ではそれらが保たれます。意図的に変更するには、**このシーンのタイミングを再設定**にチェックを入れます。シーンに合わない変更は、何も知らせずに適用されるのではなく、拒否されます。

## 結果を動画リファレンスとして使う
MP4 は、[3D シーン生成のレンダリング](https://nodaro.ai/docs/nodes/video/generate-3d-scene#use-the-render-as-a-video-reference)と同じく、レイアウトのリファレンスです。位置、オクルージョン、フレーミング、カメラの動き、タイミングに加えて、グレーのクレイ調のルックも含まれます。動画モデルは、そうしないように指示されない限り、このルックも真似します。

- **Nodaro が範囲を限定する一文を加える**：**動画**出力を、[**動画生成**（Generate Video）](https://nodaro.ai/docs/nodes/video/generate-video)ノードの**動画リファレンス**入力に接続します。すると Nodaro が、レイアウトだけを真似てクレイ調のルックは無視するよう、モデルに伝える一文を加えます。ショットが複数あるシーンでは、この一文でカットの位置も伝えます。
- **人物 1 人につきキャラクター 1 つ**：フォトリアルな処理は、リファレンスを指定した被写体ごとに行われます。本物らしく見せる必要がある人物には、それぞれ専用のキャラクターリファレンスを用意し、ロケーションやスタイルの画像のために、リファレンスの枠を 2 つ空けておきます。
- **リファレンスのない人物は通知される**：ワークフローの実行で、キャラクターリファレンスの数よりシーンの人物のほうが多いとわかった場合でも、実行は続行されます。クレイ調の人物を望む場合もあるからです。その場合は、ジョブに `scene3d_unreferenced_figures` 警告が記録されます。警告には、リファレンスのない人物の数と、人物 1 人につき 1 つのリファレンスがモデルのリファレンス上限に収まるかどうかが含まれます。
- **開始フレームには使わない**：レンダリングは、リファレンス入力に接続します。開始フレームはルックを決めてしまい、範囲を限定する一文もそこには届きません。

## クレジット
3D レンダリング Pro は、1 つの課金対象の処理です。新しいシーンでは、シーンの作成、ホスト型ビルド、レンダリングの料金がかかります。編集指示のない既存のシーンでは、レンダリングの料金だけがかかります。修正パスの上限の範囲で行われる修正パスは、1 回ごとに料金がかかる作業です。

**見積もってから実行する**：料金はデプロイメントごとに設定されるため、決まった定価はありません。すべての実行で先に見積もりが出され、見積もりには請求額ではなく**上限**が示されます。キャンバス上では、ノードにこの上限が**最大 N クレジット**と表示されます。実行で使われなかった枠は、精算時に返還されます。料金が設定されていないインストール環境では、何も確保する前に実行が拒否されます。

見積もりには、修正パスのほかに、次の 2 つの枠が含まれる場合があります。

| 枠 | 内容 |
| --- | --- |
| 受理の再試行（最大 3 回、プランナーのみ） | エンジンがレシピを構築前に拒否したときに、プランナーをもう一度呼び出します。ビルドもレンダリングも行いません。 |
| 機械的なパス（最大 2 回、プランナーなし） | エンジン自身が見つけた修正を適用するビルドで、プランナーは呼び出しません。修正パスの回数は減りません。 |

**フレームサイズと長さ**：レンダリングの段階は出力フレームごとに料金がかかるため、シーンが長いほど、またフレームレートが高いほど、料金が高くなります。1 フレームあたりの料金は、[動画レンダリング](https://nodaro.ai/docs/nodes/video/render-video#what-a-3d-scene-render-costs)と同じフレームサイズの段階表に従います。長辺が 1920 ピクセルまでのフレームは、基本料金です。それより大きいフレームは、5.12 メガピクセルまでは基本料金の 1.5 倍、それを超えると 2.5 倍です。

保存済みのシーンを、動画レンダリングで、または**既存のシーン**を指示なしで使ってもう一度レンダリングする場合は、通常のレンダリングとして課金されます。失敗の前に完了した作業（それより前の修正パスなど）は、通常どおり請求されます。

## 実行が合格しなかった場合
ビジュアルレビューが構築されたシーンをチェックし、修正パスの上限に達するまで、修正パスがレビューの異議に対応します。実行は、次のいずれかの形で終わります。

| 終わり方 | 動画の有無 | 意味 |
| --- | --- | --- |
| **納品** | あり | すべてのチェックに合格し、レビューがシーンを承認しました。 |
| **納品（レビューの異議あり）** | あり | 必須のチェックにはすべて合格しましたが、修正パスを使い切った時点でも、レビューが異議を示していました。異議の内容は、結果と一緒に返されます。 |
| **納品（レビューなし）** | あり | 必須のチェックにはすべて合格しましたが、レビューが有効な判定を返さなかったため、シーンは誰にも評価されていません。 |
| **失敗（下書きを保持）** | なし | 最後のビルドで、必須のチェックが失敗しました。構築されたシーンは、下書きとして保持されます。 |
| **失敗（何も構築されず）** | なし | エンジンがすべてのレシピを拒否しました。最後のレシピが、証拠として保持される場合があります。 |

**承認なしでシーンが納品された場合**、実行は完了し、MP4 は実際に作られ、クレジットは請求されます。そのまま使うか、レビューの修正内容を編集の指示として扱います。つまり、その修正内容を**編集指示**にして、**既存のシーン**を実行します。この場合は、シーンの作成 1 回分の料金がかかります。オブジェクトの移動、色の変更、非表示などの直接編集は無料です。誰もレビューしていないシーンには参考にできる修正内容がなく、同じジョブをもう一度実行すると新しいシーンが作成されます。そのため、MP4 は自分で判断してください。

**実行が失敗しても下書きが保持された場合**、MP4 はありませんが、下書きは通常のシーンのリビジョンです。

- **そのままレンダリングする**：指示なしの**既存のシーン**として実行します。その実行ではレンダリングの料金だけがかかり、その実行自体のチェックで下書きが再判定されることはありません。
- **自分で修正する**：直接編集は、ほかのシーンと同じように下書きにも適用でき、作成の料金はかかりません。
- **下書きから作成し直す**：編集指示付きの**既存のシーン**として実行します。

下書きの保持に料金はかかりません。キャンバス上では、ページを再読み込みした後も、ノードに下書きと失敗が一緒に表示されます。そのため、シーンがあるからといって、実行が合格したとは限りません。実行中に行った編集は引き続き優先され、届いた下書きはリビジョン履歴に保存されます。

### 計画のエラー
| エラー | 再試行 | 意味 |
| --- | --- | --- |
| `SCENE_PROVIDER_UNAVAILABLE` | はい（数分後） | プランナーのモデルプロバイダーが利用できないか、過負荷の状態でした。説明文に問題があったわけではありません。 |
| `SCENE_PLANNING_TIMEOUT` | はい | 計画に時間がかかりすぎました。もう一度試すか、説明文とリファレンスを短くします。 |
| `SCENE_PLANNER_OUTPUT_INVALID` | そのままでは不可 | プランナーは応答しましたが、そのレシピを構築できませんでした。説明文を簡単にするか、リファレンスを減らします。 |

## ヒント
- **先にプリビズ、次に Pro**：[3D シーン生成](https://nodaro.ai/docs/nodes/video/generate-3d-scene)と [3D シーン編集](https://nodaro.ai/docs/nodes/video/edit-3d-scene)で安くショットをブロッキングしてから、最終版をここでレンダリングします。
- **作成し直さずにもう一度エクスポートする**：同じシーンをもう一度エクスポートするには、指示なしで**既存のシーン**を使うか、**コンポジション**を[動画レンダリング](https://nodaro.ai/docs/nodes/video/render-video)に接続します。
- **下書きでは上限を下げる**：**修正パスの上限**を 0 か 1 にすると、料金のかかる修正作業を抑えられます。
- **静止画を使う**：各ショットの静止画は、[**画像生成**（Generate Image）](https://nodaro.ai/docs/nodes/image/generate-image)や[動画生成](https://nodaro.ai/docs/nodes/video/generate-video)で、そのまま使える画像リファレンスになります。

## API から
API では、1 つの有料ジョブを 2 回の呼び出しで行います。`POST /v1/pro-3d-render/quote` はリクエストを受け取り、`quoteId` と上限である `maxCredits` を返します。見積もりでは、何も確保されず、何も消費されません。続いて `POST /v1/pro-3d-render` が、同じボディに `quoteId` を加えたものと、8〜255 文字の `Idempotency-Key` ヘッダーを受け取り、`jobId` を返します。2 つの呼び出しの間でボディが変わった場合も、見積もりの有効期限が切れた場合も、リクエストは拒否されます。タイムアウトした送信を再試行するときは、同じ `Idempotency-Key` を使ってください。

```typescript
const caps = await client.scene3d.capabilities();
if (!caps.pro?.available) return; // this install cannot run it

// Author a new scene and render it: quotes and runs in one call.
const shot = await client.scene3d.renderProAndWait({
source: {
kind: "prompt",
prompt: "A red suitcase rolls behind a central pillar and reappears. Dolly right over thirty seconds.",
references: [{ id: "look", kind: "image", role: "appearance", url: appearanceImageUrl }],
},
durationSeconds: 30,
fps: 24,
aspectRatio: "21:9",
maxRepairPasses: 2,
});

// Later: render the same revision again, with no authoring charge.
await client.scene3d.renderProAndWait({
source: { kind: "scene", revisionId: shot.sceneRevisionId, sourceJobId: shotJobId },
});
```

- **完了したジョブ**には、`videoUrl`、`scenePlan`、`sceneRevisionId`、`shotStills`（ショットごとに 1 つの `{ shotIndex, frame, assetId, url }`）、`validation`、そしてフレームサイズ、フレームレート、フレーム数、長さを含む `metadata` が含まれます。
- **承認されなかった納品**では、`metadata.review` が追加されます。`validation.status` はどちらの場合も `passed` になるため、代わりにこのフィールドと、その `verdict`（`refused` または `unavailable`）を確認してください。
- **下書きのある失敗したジョブ**にも、`scenePlan`、`sceneRevisionId`、そして `status` が `failed` の `validation` が含まれます。
- **フレームレート**：API では、`fps` に 15〜60 の任意の値を指定できます。

AI アシスタントは、`pro_3d_render` MCP ツールを使います。このツールは、同じパラメーターで見積もりと送信を行います。すべてのフィールド、警告コード、エラーについては、[MCP での 3D シーン](https://nodaro.ai/docs/mcp/3d-scenes)と [3D シーン API](https://nodaro.ai/docs/developers/api/3d-scenes) を参照してください。

## Frequently asked questions

### 3D レンダリング Pro と 3D シーン生成の違いは何ですか？

3D シーン生成は、低コストで編集できるクレイ調のプリビズで、MP4 は別途、動画レンダリングを実行して作ります。3D レンダリング Pro は、ホスト型のビルドエンジンでより詳細なシーンを作成し、MP4、シーン、ショットごとの静止画 1 枚を、1 回の実行で返します。

### ノードピッカーに 3D レンダリング Pro が見つからないのはなぜですか？

このノードは Nodaro Cloud にだけ表示され、それも Cloud の 3D エンジンが提供している間に限られます。セルフホスティングのエディションでは提供されません。提供されていないときは、ノードは一覧にまったく表示されません。

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

決まった料金はありません。実行ごとに先に見積もりが出され、ノードには上限が「最大 N クレジット」と表示されます。料金は、ソース、修正パスの上限、フレーム数、フレームサイズによって決まります。既存のシーンを編集指示なしでレンダリングする場合は、レンダリングの料金だけがかかります。

### レビューの承認なしでシーンが納品されるのは、どういう状態ですか？

実行は完了しており、MP4 も実際に作られています。ただし、修正パスの上限に達した後もビジュアルレビューが異議を示していたか、レビューが判定を出せなかった状態です。動画をそのまま使うか、レビューの修正内容を編集指示にして、新しいパスを実行してください。

### 静止画は何に使うのですか？

「Stills」出力には、ショットごとに 1 枚の画像が入っています。各ショットの最初のフレームで、追加料金はかかりません。画像モデルや動画モデルでそのショットを生成するときに、そのショットの静止画を画像リファレンスとして使います。