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

オブジェクトと小道具

オブジェクト/小道具スタジオで、再利用できる商品や小道具を作ります。承認したメイン画像をもとに、アングル、素材、状態のバリエーションとモーションクリップを追加できます。

オブジェクトは、再利用できる商品、小道具、乗り物、家具で、プロジェクトのどの画像や動画でも同じ見た目を保ちます。オブジェクト/小道具スタジオでメイン画像を一度承認したら、アングル、素材、状態、モーションクリップを追加します。オブジェクトが登場する場所にオブジェクト/小道具アセット(Object/Props Asset)ノードを接続すれば、どのショットにも同じアイテムが映ります。

オブジェクトに含まれるもの

要素内容
メイン画像承認したオブジェクトの画像です。すべてのバリエーションとモーションクリップは、この画像から作られます。
基準となる説明承認時にメイン画像から書かれる、80〜120 語の説明です。接続したノードは、この説明をプロンプトに追加します。
アングル別の視点から見たオブジェクトです。
素材素材や仕上げを変えた、同じオブジェクトです。
バリエーション「経年変化」や「磨き上げ」など、状態やスタイルを変えた同じオブジェクトです。
モーションクリップ360 度の回転など、メイン画像から作る短い動画です。
リファレンス写真実物のオブジェクトや、目指すルックの写真です。最大 20 枚まで追加できます。
スタイルの固定すべてのバリエーションを、メイン画像を基準にして作ります。デフォルトでオンです。

オブジェクトを作成する

ノードを追加してスタジオを開く

キャンバスで Tab を押し、アセット › オブジェクト › オブジェクト/小道具アセットを選びます。ノードのスタジオを開くをクリックするか、ノードを選択して設定パネルのオブジェクト/小道具スタジオを開くをクリックします。

リファレンス写真を追加する

リファレンスページで、オブジェクトの写真を追加します。実在する商品なら、すっきりした正面の写真と側面の写真があると、モデルが実物に合わせやすくなります。種類を選び、写真の URL を貼り付けて、追加をクリックします。

オブジェクトに名前と説明を付ける

Appearance ページで、名前と説明を入力します。素材や質感は具体的に書いてください。たとえば「brushed stainless steel coffee mug with a matte black handle」のように書きます。

メイン画像を生成して承認する

候補の数を 1、2、4 から選び、生成をクリックします。候補が 1 枚なら、結果が自動的にメイン画像になります。2 枚または 4 枚の場合は、使いたい候補の承認をクリックするか、それ以外の候補の破棄をクリックします。

保存する

ヘッダーの保存をクリックすると、名前、説明、スタイルの固定が保存されます。生成した画像とクリップは、自動的にオブジェクトに保存されます。

承認にクレジットはかかりません。承認すると基準となる説明が書き込まれ、メイン画像の下に表示されます。

リファレンス写真

種類用途
正面すっきりした、正面から撮った写真です。
側面横から見た写真です。乗り物、家具、武器に役立ちます。
ディテール刻印、ヒンジ、質感など、特徴的な部分のクローズアップです。
環境手に持った状態、取り付けた状態、シーンの中など、使われているオブジェクトの写真です。大きさと配置の参考になります。
ムードボード目指すムード、配色、テイストです。
その他上記以外のすべてです。

1 つのオブジェクトには最大 20 枚のリファレンス写真を登録でき、同じ種類の写真を複数追加することもできます。オブジェクトを使うすべてのノードが、これらの写真を追加のリファレンスとして受け取ります。種類は、それぞれの写真が何のためのものかをモデルに伝えます。

ピッカーでオブジェクトを説明する

ノードの左端には、オブジェクトの種類入力があります。ここに動物(Animal)、乗り物(Vehicle)、家具(Furniture)、武器(Weapon)、素材(Material)、手に持つ小道具(Held Prop)のいずれかのピッカーを接続します。ピッカーで選んだ内容は、オブジェクトの生成プロンプトに追加されます。たとえば、素材ピッカーからは「antique brass」が追加されます。

ピッカーを使うと、説明を自分で書く代わりに、カタログの選択肢からすばやく始められます。

アングル、素材、バリエーション

ページプリセット
アングル正面、側面、真上、背面、斜め、ディテール、使用シーン、分解図、遠近感
素材木材、金属、ガラス、プラスチック、布、石、陶器、革、紙、金、銀、銅、大理石
バリエーション新品、経年変化、傷だらけ、装飾的、ミニマル、破損、アンティーク、近未来、ホログラフィック、汚れ、磨き上げ
  • プリセットをクリックすると、そのバリエーションが生成されます。すべて生成をクリックすると、まだ生成されていないすべてのプリセットが生成されます。
  • それ以外のバリエーションは、カスタムプロンプト(自由入力)に入力して生成をクリックします。
  • 素材ページで素材カタログを閲覧をクリックすると、より細かな選択肢から選べます。たとえば、単なる「金」ではなく「polished brushed brass」を選べます。選んだ項目ごとに、カタログの表現でバリエーションが生成されます。

バリエーションのためにオブジェクトを説明し直す必要はありません。Nodaro は、オブジェクトの基準となる説明とバリエーションの名前から、各バリエーションのプロンプトを書きます。各バリエーションの費用は、オブジェクトの画像モデルで画像 1 枚を生成するのと同じです。

最初にアングルを生成してください。オブジェクトがシーンに登場するとき、アングルは最も役立つリファレンスになります。

スタイルの固定

スタイルの固定は、オブジェクトの一貫性を保つための主要なスイッチです。新しく作るオブジェクトでは、どれも最初からオンになっています。

スタイルの固定:オン(デフォルト)スタイルの固定:オフ
バリエーション承認済みのメイン画像から生成されます。プロポーション、シルエット、特徴的な部分は変わりません。テキストだけから生成されます。モデルが毎回、形を解釈し直す場合があります。
他のノード基準となる説明を、固定のコンテキストとして受け取ります。基準となる説明を、ゆるやかな指針として受け取ります。
用途複数のショットで同じアイテムを見せる必要があるすべての場面。デザインの検討や A/B 比較。

スタイルの固定のオンとオフは、スタジオのヘッダーまたはノードの設定パネルで切り替えます。

モーションクリップ

モーションページでは、承認済みのメイン画像から、ゆっくりした回転や浮遊など、短いショーケースクリップを作ります。クリップは、商品動画や B ロールとして使えます。

  • 先にメイン画像を承認してください。承認するまで、生成は使えません。
  • プリセット:360 度回転、浮遊、ゆっくり回転、パララックス、パルス、漂う、ドリーで回り込み、プッシュイン、ドローン周回。
  • モデル:Kling 2.5 Turbo Pro(デフォルトで、最も高速)、Kling 2.6、Kling 3.0、Hailuo 02 I2V Pro、Hailuo 2.3 Standard、Wan 2.6 I2V、Seedance、Bytedance Lite I2V。
  • フレーム:デフォルトは、商品を見せる構図に合う 1:1 です。3:4、16:9、9:16 も選べます。
  • 費用:クリップ 1 本の費用は、選んだモデルで画像から動画を 1 回生成するのと同じです。

シーンでオブジェクトを使う

ノードのオブジェクト/小道具出力を、画像生成(Generate Image)ノードまたは動画生成(Generate Video)ノードのアセット入力に接続します。接続先のノードは、メイン画像、リファレンス写真、基準となる説明を受け取ります。

オブジェクトの種類アセットプロンプト開始フレーム素材アンティーク調の真鍮オブジェクト/小道具アセットAntique Lanternテキストほこりっぽい作業台の上画像生成動画生成ゆっくりプッシュイン
素材ピッカーでオブジェクトの質感を決め、そのオブジェクトを画像に渡し、画像を動画の最初のフレームにします。

文中の狙った位置にオブジェクトを置くには、プロンプトでメンションします。メンション名は、オブジェクトの名前から作られます。たとえば「Antique Lantern」は @antique-lantern:1 になります。

メンションノードがプロンプトに書き込む内容
@antique-lantern:1メンションの位置に「the object from reference image A」を書き込みます。
@antique-lantern:1:material「the material from reference image A」を書き込みます。
@antique-lantern:1:engraving任意の単語を役割にできます。この例では「the engraving from reference image A」になります。
@antique-lantern:1~lockこのメンションで顔の固定をオンにします。短い 1 行が加わり、このオブジェクトをそのまま保つようモデルに指示します。
@antique-lantern:1~nolockこのメンションに限り、顔の固定をオフにします。

オブジェクトの役割は、object(デフォルト)、shape、material、color、texture、style のほか、自分で決めた任意の単語です。

オブジェクトのメンションは、手で入力してください。@ メニューとメンションのチップが対象にするのは、キャラクター、ロケーション、名前付きの画像で、オブジェクトは含まれません。メンションを使うと、オブジェクトのフレーズが入る位置が変わります。メンションがない場合、フレーズはプロンプトの末尾に追加されます。すると、モデルが文中のオブジェクト名との関係を見落とすことがあります。メンションがあれば、フレーズは入力した位置に 1 回だけ入ります。書き方の詳細は、リファレンスの役割を参照してください。

ノードの画像出力は、説明を含まない、メイン画像そのものです。画像ノードや動画ノードの設定パネルでは、挿入されたリファレンスの一覧に、そのノードが送るすべての画像が表示されます。接続を外さずに、あるノードからだけオブジェクトの画像を除くには、この一覧から削除します。

既存のオブジェクトを使う

ノードの既存のものを選択をクリックするか、設定パネルの Choose from Library / Gallery(ライブラリまたはギャラリーから選択)をクリックします。

  • マイライブラリには、自分のオブジェクトが表示されます。
  • 公開ギャラリーには、コミュニティが共有したオブジェクトが表示されます。選ぶと、まず自分のライブラリにコピーされます。このタブは、Nodaro Cloud のようなマルチユーザー環境に表示されます。

オブジェクトを選んだり置き換えたりすると、そのメイン画像とすべてのバリエーションが読み込まれるため、接続したノードですぐに使えます。

オブジェクトの削除と復元

アセットピッカーのマイライブラリタブで、オブジェクトにポインターを合わせてライブラリから削除をクリックします。オブジェクトはアーカイブされ、そのオブジェクトを使っているノードは引き続き動作します。

アーカイブしたオブジェクトの復元や完全な削除は、API、SDK、CLI で行います。完全に削除できるのは、すでにアーカイブされたオブジェクトだけです。復元したオブジェクトの名前がすでに使われている場合は、名前に「(restored)」が付きます。

ヒント

  • 素材は具体的に書く。「handle」より「Matte black handle」のほうが効果的です。モデルは、指定されたものを再現します。
  • 実在する商品にはリファレンス写真を追加する。正面と側面の写真があれば、モデルは実物に合わせられます。
  • シーンの前にアングルを生成する。構図を作るとき、アングルは最も役立つリファレンスです。
  • 商品ではスタイルの固定をオンのままにする。オフにするのは、新しいデザインを検討するときだけにします。
  • 商品クリップは正方形にする。デフォルトの 1:1 は、商品を見せるときの一般的な構図です。

コードとエージェントから使う

REST API、SDK、CLI では、オブジェクトの作成、メイン画像の生成と承認、バリエーションとモーションクリップの追加ができます。オブジェクトのアーカイブ、復元、完全な削除や、カテゴリーとスタイルの設定もできます。カテゴリーは furniture、vehicle、weapon、food、clothing、electronics、nature、tool、animal、other です。詳しくは、オブジェクト API を参照してください。

MCP ツールには、generate_object、approve_object_main_image、recaption_object、generate_object_motion、list_objects、get_object があります。アシスタントはオブジェクトを生成することで作成し、削除や復元はできません。詳しくは、MCP ツールを参照してください。

よくある質問

最終更新

目次