3D シーン
4 つの 3D シーンツールのパラメーターです。プロンプトから編集できるクレイ調のシーンを作成し、修正し、MP4 にレンダリングするか、1 つのジョブで完成したショットを作ります。
3D シーンツールは、単純な形状とキーフレームで付けた動きからなる、編集できるアニメーション付きのクレイ調のシーンを作成し、修正し、動画にレンダリングします。レンダリングした動画は、動画モデルのレイアウトと動きのガイドとして使えます。このページでは、各ツールのパラメーターを一覧にしています。一連の流れと結果の読み方は、3D シーンで説明しています。
どのツールにも workflows:execute 権限が必要で、ジョブ ID を返します。結果は get_job か wait_for_job で読み取ります。
generate_3d_scene
プロンプトと任意のリファレンスから、編集できるアニメーション付きのクレイ調のシーンを作成します。フォトリアルな動画は作りません。3D シーン生成(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)ノードと同じように動作します。
権限: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 と同じ料金です。料金の一覧は、動画レンダリングに記載されています。
pro_3d_render
完成した 3D ショットを 1 つのジョブで作ります。完了したジョブには、シーンプラン、MP4、ショットごとの静止画 1 枚が含まれます。このツールは、対応するエンジンがある環境でだけ、ツールの一覧に表示されます。3D レンダリング Pro(3D Render 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 シーン
3D シーン生成
3D レンダリング Pro
3D シーン
最終更新