3D シーン
4 つの 3D シーンツールのパラメーターです。プロンプトから編集できるクレイ調のシーンを作成し、修正し、MP4 にレンダリングするか、1 つのジョブで完成したショットを作ります。
3D シーンツールは、単純な形状とキーフレームで付けた動きからなる、編集できるアニメーション付きのクレイ調のシーンを作成し、修正し、動画にレンダリングします。レンダリングした動画は、動画モデルのレイアウトと動きのガイドとして使えます。このページでは、各ツールのパラメーターを一覧にしています。一連の流れと結果の読み方は、3D シーンで説明しています。
どのツールにも workflows:execute 権限が必要で、ジョブ ID を返します。結果は get_job か wait_for_job で読み取ります。
generate_3d_scene
プロンプトと任意のリファレンスから、編集できるアニメーション付きのクレイ調のシーンを作成します。フォトリアルな動画は作りません。3D シーン生成ノードと同じように動作します。
権限:workflows:execute。クレジット:3D シーン生成ノードと同じです。シーンの作成は LLM の 1 回の呼び出しで、実際に使ったトークンに応じて、プランナーのモデルの単価で課金されます。最初にクレジットが確保されます。長いプロンプト、多くのリファレンス、修復のパスでは高くなります。LLM 呼び出しの課金のしくみを参照してください。
| パラメーター | 型 | 説明 |
|---|---|---|
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 のいずれかで、画像は見た目とレイアウトを、動画はレイアウトと動きをガイドします。動画リファレンスは全体が使われます。一部の区間だけを使うには、先にトリミングします。任意の objectId には、リファレンスが写しているシーン内のオブジェクト(たとえば主人公)を指定します。 |
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 シーン編集ノードと同じように動作します。
権限:workflows:execute。クレジット:3D シーン編集ノードと同じです。操作は無料です。プロンプトでの編集は LLM の 1 回の呼び出しで、実際に使ったトークンに応じて、プランナーのモデルの単価で課金されます。
| パラメーター | 型 | 説明 |
|---|---|---|
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
特定のシーンのリビジョンを、動画レンダリングのエンジンで MP4 にレンダリングします。LLM は実行されません。カメラ、長さ、フレームは、シーンプランから取得されます。
権限:workflows:execute。クレジット:プランのフレームサイズによって決まります。長辺が 1920 ピクセルまでは 55、それを超えて 5.12 メガピクセルまでは 83、それより大きなフレームは 138 です。
| パラメーター | 型 | 説明 |
|---|---|---|
scene_plan | object | 必須。レンダリングするシーンプランです。 |
戻り値:ジョブ ID です。結果は動画の URL です。プランの width と height は、意図して設定してください。2560 × 2560 のシーンは 1920 × 1080 のシーンの 2.5 倍の料金がかかりますが、1920 × 1920 は 1920 × 1080 と同じ料金です。料金の一覧は、動画レンダリングに記載されています。
pro_3d_render
完成した 3D ショットを 1 つのジョブで作ります。完了したジョブには、シーンプラン、MP4、ショットごとの静止画 1 枚が含まれます。このツールは、対応するエンジンがある環境でだけ、ツールの一覧に表示されます。3D レンダリング Proノードと同じように動作します。
権限: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 } です。モデルや推論のパラメーターはありません。プランナーは固定です。
よくある質問
3D シーンのレンダリングには、何クレジットかかりますか?
レンダリングの料金は、シーンプランのフレームサイズで決まります。長辺が 1920 ピクセルまでは 55 クレジット、それを超えて 5.12 メガピクセルまでは 83 クレジット、それより大きなフレームは 138 クレジットです。
3D シーンを編集すると、常に AI モデルが呼び出されますか?
いいえ。オブジェクトの移動やカメラの変更などの操作で編集する場合は、LLM を呼び出さずに、操作が直接適用されます。プロンプトで編集する場合は、プランナーに変更を依頼します。
render_3d_scene と pro_3d_render の違いは何ですか?
render_3d_scene は、既存のシーンのリビジョンを MP4 にエクスポートします。pro_3d_render は、シーンの作成、修正、エクスポートを 1 つのジョブで行い、シーンプラン、MP4、ショットごとの静止画 1 枚を返します。pro_3d_render は、そのエンジンがある環境でだけ使えます。
関連ページ
3D シーン
3D シーン生成
3D レンダリング Pro
3D シーン
最終更新