# オブジェクトと小道具

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

Source: https://nodaro.ai/ja/docs/guides/objects

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

## オブジェクトに含まれるもの
| 要素 | 内容 |
| --- | --- |
| **メイン画像** | 承認したオブジェクトの画像です。すべてのバリエーションとモーションクリップは、この画像から作られます。 |
| **基準となる説明** | 承認時にメイン画像から書かれる、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）](https://nodaro.ai/docs/nodes/creative-controls/animal)、[**乗り物**（Vehicle）](https://nodaro.ai/docs/nodes/creative-controls/vehicle)、[**家具**（Furniture）](https://nodaro.ai/docs/nodes/creative-controls/furniture)、[**武器**（Weapon）](https://nodaro.ai/docs/nodes/creative-controls/weapon)、[**素材**（Material）](https://nodaro.ai/docs/nodes/creative-controls/material)、[**手に持つ小道具**（Held Prop）](https://nodaro.ai/docs/nodes/creative-controls/held-prop)のいずれかのピッカーを接続します。ピッカーで選んだ内容は、オブジェクトの生成プロンプトに追加されます。たとえば、素材ピッカーからは「antique brass」が追加されます。

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

## アングル、素材、バリエーション
| ページ | プリセット |
| --- | --- |
| **アングル** | 正面、側面、真上、背面、斜め、ディテール、使用シーン、分解図、遠近感 |
| **素材** | 木材、金属、ガラス、プラスチック、布、石、陶器、革、紙、金、銀、銅、大理石 |
| **バリエーション** | 新品、経年変化、傷だらけ、装飾的、ミニマル、破損、アンティーク、近未来、ホログラフィック、汚れ、磨き上げ |

- プリセットをクリックすると、そのバリエーションが生成されます。**すべて生成**をクリックすると、まだ生成されていないすべてのプリセットが生成されます。
- それ以外のバリエーションは、**カスタムプロンプト（自由入力）**に入力して**生成**をクリックします。
- **素材**ページで**素材カタログを閲覧**をクリックすると、より細かな選択肢から選べます。たとえば、単なる「金」ではなく「polished brushed brass」を選べます。選んだ項目ごとに、カタログの表現でバリエーションが生成されます。

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

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

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

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

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

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

- **先にメイン画像を承認してください**。承認するまで、**生成**は使えません。
- **プリセット**：360 度回転、浮遊、ゆっくり回転、パララックス、パルス、漂う、ドリーで回り込み、プッシュイン、ドローン周回。
- **モデル**：[Kling 2.5 Turbo Pro](https://nodaro.ai/docs/models/video/kling-2-5-turbo-pro)（デフォルトで、最も高速）、[Kling 2.6](https://nodaro.ai/docs/models/video/kling-2-6)、[Kling 3.0](https://nodaro.ai/docs/models/video/kling-3-0)、[Hailuo 02 I2V Pro](https://nodaro.ai/docs/models/video/hailuo-02-i2v-pro)、[Hailuo 2.3 Standard](https://nodaro.ai/docs/models/video/hailuo-2-3-standard)、[Wan 2.6 I2V](https://nodaro.ai/docs/models/video/wan-2-6-i2v)、Seedance、[Bytedance Lite I2V](https://nodaro.ai/docs/models/video/bytedance-lite-i2v)。
- **フレーム**：デフォルトは、商品を見せる構図に合う `1:1` です。`3:4`、`16:9`、`9:16` も選べます。
- **費用**：クリップ 1 本の費用は、選んだモデルで画像から動画を 1 回生成するのと同じです。

## シーンでオブジェクトを使う
ノードの**オブジェクト／小道具**出力を、[**画像生成**（Generate Image）](https://nodaro.ai/docs/nodes/image/generate-image)ノードまたは[**動画生成**（Generate Video）](https://nodaro.ai/docs/nodes/video/generate-video)ノードの**アセット**入力に接続します。接続先のノードは、メイン画像、リファレンス写真、基準となる説明を受け取ります。

Workflow: 素材ピッカーでオブジェクトの質感を決め、そのオブジェクトを画像に渡し、画像を動画の最初のフレームにします。

- 素材 → オブジェクト／小道具アセット (オブジェクトの種類)
- オブジェクト／小道具アセット → 画像生成 (アセット)
- テキスト → 画像生成 (プロンプト)
- 画像生成 → 動画生成 (開始フレーム)

文中の狙った位置にオブジェクトを置くには、プロンプトでメンションします。メンション名は、オブジェクトの名前から作られます。たとえば「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 回だけ入ります。書き方の詳細は、[リファレンスの役割](https://nodaro.ai/docs/guides/reference-roles)を参照してください。

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

## 既存のオブジェクトを使う
ノードの**既存のものを選択**をクリックするか、設定パネルの **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](https://nodaro.ai/docs/developers/api/objects) を参照してください。

MCP ツールには、`generate_object`、`approve_object_main_image`、`recaption_object`、`generate_object_motion`、`list_objects`、`get_object` があります。アシスタントはオブジェクトを生成することで作成し、削除や復元はできません。詳しくは、[MCP ツール](https://nodaro.ai/docs/mcp/tools)を参照してください。

## Frequently asked questions

### オブジェクトアセットは何に使いますか？

オブジェクトアセットは、1 つの商品、小道具、乗り物、家具を、どの画像や動画でも同じ見た目に保ちます。メイン画像を一度承認すると、接続したすべてのノードがその画像と説明を受け取ります。

### 同じ商品を別の素材で見せるにはどうすればよいですか？

スタジオの「素材」ページを開き、「金属」や「革」などのプリセットをクリックするか、素材カタログから選びます。スタイルの固定がオンなら、各バリエーションは承認済みのメイン画像から生成されるため、形は変わりません。

### プロンプトでオブジェクトをメンションするにはどうすればよいですか？

@ に続けて、オブジェクトの名前と番号を入力します。たとえば @antique-lantern:1 です。@antique-lantern:1:material のように役割を付けると、オブジェクトから何を取り込むかを指定できます。@ メニューにはオブジェクトが表示されないため、オブジェクトのメンションは手で入力してください。

### オブジェクトのモーションクリップの費用はどのくらいですか？

選んだモデルで、画像から動画を 1 回生成するのと同じ費用です。デフォルトの Kling 2.5 Turbo Pro は、短い商品クリップに向いた高速な選択肢です。