3D レンダリング Pro

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

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 ツールは、ノードを実行できる環境でだけ一覧に表示されます。そのため、ツールの一覧にあるかどうかで確認できます。

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

クイックスタート

シーンのソース

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

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

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

入力

出力

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

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

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

設定

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

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

結果を動画リファレンスとして使う

MP4 は、3D シーン生成のレンダリングと同じく、レイアウトのリファレンスです。位置、オクルージョン、フレーミング、カメラの動き、タイミングに加えて、グレーのクレイ調のルックも含まれます。動画モデルは、そうしないように指示されない限り、このルックも真似します。

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

クレジット

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

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

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

フレームサイズと長さ：レンダリングの段階は出力フレームごとに料金がかかるため、シーンが長いほど、またフレームレートが高いほど、料金が高くなります。1 フレームあたりの料金は、動画レンダリングと同じフレームサイズの段階表に従います。長辺が 1920 ピクセルまでのフレームは、基本料金です。それより大きいフレームは、5.12 メガピクセルまでは基本料金の 1.5 倍、それを超えると 2.5 倍です。

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

実行が合格しなかった場合

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

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

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

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

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

計画のエラー

ヒント

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

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 を使ってください。

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 シーンと 3D シーン API を参照してください。