Nodaro ドキュメント
ドキュメントノードリファレンスモデルAI エージェント(MCP)開発者向けセルフホスティングリサーチ
ツールリファレンス

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 です。

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

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

edit_3d_scene

シーンを修正し、以前のリビジョンも残します。プランナーが適用するプロンプトか、LLM を呼び出さずに直接適用される操作のどちらかを送ります。3D シーン編集(Edit 3D Scene)ノードと同じように動作します。

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

パラメーター型説明
scene_planobject必須。シーンのジョブから得た scenePlan の全体です。
expected_revision_idstring必須。プランの revisionId です。一致しない場合、編集は拒否されます。
promptstring変更内容を言葉で書いたもので、最大 8,000 文字です。
operationsarray1〜100 個の正確な変更です。set-object、add-object、remove-object、set-camera、set-lighting、set-background のいずれかです。
locked_object_idsarray編集で変更してはいけないオブジェクトです。
selected_object_idsarray編集の対象になるオブジェクトです。
referencesarraygenerate_3d_scene と同じです。
replace_referencesbooleanシーンの画像リファレンスと動画リファレンスを、references で置き換えます。
engine, max_repair_passes, llm_model, reasoning_effort, local_connection_id, accepted_scene_schema_versionsgenerate_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_planobject必須。レンダリングするシーンプランです。

戻り値:ジョブ 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 のみ。

パラメーター型説明
sourceobject必須。下の 3 つのソースのうち、ちょうど 1 つです。
duration_seconds, fpsnumber1〜60 秒と、15〜60 fps です。シーンをソースにする場合は、タイミングを変更するつもりがない限り省略します。矛盾する値は拒否されます。
aspect_ratiostring16:9、9:16、1:1、4:5、21:9 のいずれかです。シーンをソースにする場合は省略します。
max_repair_passesinteger修正パスの上限回数で、0〜2 です。デフォルトは 2 です。各パスは有料です。
enginestringblender-cloud または blender-local です。
quality, stylestringstandard と clay です。
client_request_idstring再試行用のトークンで、英字、数字、_ - . : からなる 8〜128 文字です。タイムアウトの後に再試行するときに同じ値を使うと、ジョブが二重に開始されたり、二重に課金されたりしません。
source.kindフィールド動作
promptprompt。任意で references と input_assets説明文から新しいシーンを作成し、レンダリングします。
scenerevision_id。任意で source_job_id と edit_prompt既存のリビジョンをレンダリングします。edit_prompt がない場合は、そのままエクスポートします。ある場合は、先にシーンを修正するため、作成の料金がかかります。ジョブの履歴にだけ残っている basic のシーンには、source_job_id が必要です。
local-exportexport_id、connection_id利用できる場合、ペアリング済みのデスクトップアプリで完了したエクスポートを使います。

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

よくある質問

最終更新

目次