# リファレンスの役割

> 各リファレンスに顔、衣装、背景、スタイルなどの役割を付け、必要なときは被写体の同一性を固定し、プロンプトの中でリファレンスを名前でメンションする方法を説明します。

Source: https://nodaro.ai/ja/docs/guides/reference-roles

**リファレンスの役割**は、1 つのリファレンスから何を取り込むかをモデルに伝えます。たとえば、同一性、衣装、背景、スタイルなどです。リファレンスには、[**画像生成**（Generate Image）](https://nodaro.ai/docs/nodes/image/generate-image)ノードや[**動画生成**（Generate Video）](https://nodaro.ai/docs/nodes/video/generate-video)ノードに接続した、通常の画像や、キャラクター、ロケーション、オブジェクト、動物のアセットを使えます。Nodaro は各リファレンスの役割を 1 つのシンプルなフレーズとしてプロンプトに書き込むので、モデルはどの画像のどの部分を使えばよいかを正確に把握できます。

## プロンプトでの役割の書かれ方
役割を付けたリファレンスは、最終プロンプトの中で 1 つのフレーズになります。

| ノード | フレーズ | リファレンスの呼び方 |
| --- | --- | --- |
| 画像生成 | `the {role} from reference image A` | 英字：A、B、C |
| 動画生成 | `the {role} from @image_1` | 番号：`@image_1`、`@image_2` |

役割は両方のノードで共通です。通常の画像とアセットは 1 つの連番を共有するので、2 つのリファレンスが同じ名前になることはありません。

## デフォルトの役割
新しいリファレンスには、その種類で最も役立つ役割が最初から設定されているので、設定しなくてもそのまま使えます。

| 接続元 | デフォルトの役割 |
| --- | --- |
| [**キャラクターアセット**（Character Asset）](https://nodaro.ai/docs/nodes/assets/character) | person |
| [**ロケーションアセット**（Location Asset）](https://nodaro.ai/docs/nodes/assets/location) | location |
| [**オブジェクト／小道具アセット**（Object/Props Asset）](https://nodaro.ai/docs/nodes/assets/object) | object |
| [**動物／クリーチャーアセット**（Animal/Creature Asset）](https://nodaro.ai/docs/nodes/assets/creature) | creature |
| [**顔を作成**（Create Face）](https://nodaro.ai/docs/nodes/assets/create-face) | face |
| 通常の画像またはアップロード | Ref only |
| 動画またはオーディオ | Ref only |

## 役割を選ぶ
リファレンスのチップをクリックすると、役割メニューが開きます。その種類で最も役立つ役割が先頭に並び、デフォルトの役割は太字で表示されます。末尾には常に**カスタム…**があり、一覧にない役割を入力できます。

| 接続元 | 選べる役割 |
| --- | --- |
| **キャラクター** | Ref only、**person**、face、clothes、hair、pose、expression、style |
| **ロケーション** | Ref only、**location**、background、atmosphere、as-is、empty background、layout、lighting、style |
| **オブジェクト** | **object**、shape、material、color、texture、style |
| **動物またはクリーチャー** | **creature**、anatomy、markings、pose、color、style |
| **通常の画像** | **Ref only**、object、person、face、clothes、background、style、pose、texture |

次の 2 つの役割は、プロンプトが自然に読めるよう、より長いフレーズになります。

| 役割 | フレーズ |
| --- | --- |
| as-is | `reference image A, used as-is` |
| empty background | `the background from reference image A (without its foreground objects)` |

### Ref only
**Ref only** は、何を取り込むかを示すフレーズを付けずにリファレンスを送ります。画像ノードではプロンプトに `reference image A` とだけ書かれ、動画ノードでは `@image_1`、`@video_1`、`@audio_1` のいずれかだけが書かれます。モデルはリファレンスを見ますが、その使い方は伝えられません。通常の画像、動画、オーディオでは、Ref only がデフォルトです。キャラクターアセットやロケーションアセットでも、意図的に Ref only を選べます。その場合、チップに小さな **ref** バッジが表示されます。

### カスタムの役割
**カスタム…**を選び、`dragon`、`hoodie`、`Danny` など、任意の単語を入力します。カスタムの役割は 32 文字まで入力でき、スペースはハイフンに置き換わります。カスタムの役割は、フレーズの中で役割の位置に入ります。たとえば `the hoodie from reference image A` です。固有名詞は、書いたとおりに使われます。たとえば `Danny from reference image A` です。

## 複数のリファレンスを組み合わせる
複数のリファレンスを接続し、それぞれに役割を付けて、それらがどう組み合わさるかを説明します。

```
A portrait of the person from reference image A wearing the clothes from reference image B, standing in the background from reference image C, lit by the lighting from reference image D.
```

Workflow: 人物はキャラクターから、衣装は 1 枚目の写真から、背景は 2 枚目の写真から取り込みます。

- 画像アップロード → 画像生成 (リファレンス)
- 画像アップロード → 画像生成 (リファレンス)
- キャラクターアセット → 画像生成 (アセット)

**リファレンスの順番**。リファレンスには 1 つの連番が振られます。**リファレンス**入力に接続した画像が先に並び、その後に**アセット**入力に接続したアセットが続きます。どちらも表示されている順番どおりです。プロンプトとモデルに送る画像には同じ番号が使われるので、最終プロンプトのプレビューには、実行される内容がそのまま表示されます。

## リファレンスを名前でメンションする
`@` メンションを使うと、文中のふさわしい位置にリファレンスを正確に配置できます。

### キャラクターとロケーション
プロンプトで `@` を入力し、キャラクターまたはロケーションを選びます。メンションでは、送る画像（**バリエーション**）と、そこから取り込む部分（**役割**）も選べます。

| メンション | 動作 |
| --- | --- |
| `@abi:1:walking:clothes` | Abi の walking の画像を送り、`the clothes from reference image A` を追加します |
| `@abi:1:walking:ref-only` | walking の画像を、単なる `reference image A` として送ります |
| `@library:1:weather/rain:lighting` | ロケーションの雨のバリエーションを送り、そのライティングを取り込みます |

プロンプト内のメンションは、2 つの操作部を持つチップとして表示されます。**サムネイル**をクリックすると、画像を変更できます。同じキャラクターの別の画像に切り替えても、役割はそのままです。**ラベル**をクリックすると、役割を変更できます。このとき画像はそのままで、**デフォルト**を選ぶとデフォルトの役割に戻ります。

### 通常の画像
[**画像アップロード**（Upload Image）](https://nodaro.ai/docs/nodes/image/upload-image)ノードに**ラベル**を付けます。ラベルが画像のメンション名になるので、ラベルが `Town` のノードは `@town:1` になります。

| メンション | 動作 |
| --- | --- |
| `@town:1` | 入力した位置に、`reference image A` を正確に配置します |
| `@town:1:background` | `the background from reference image A` を配置します |
| `@town:1:signage` | 任意の 1 語を役割として使います |
| `@town:1~lock` または `@town:1~nolock` | このメンションの顔の固定を、オンまたはオフにします |

メンションは任意です。ラベルのない画像も、これまでどおり送られます。メンションに使う名前がないだけです。`3D Render` のように数字で始まるラベルはメンション名にできないので、メンションしたい場合はラベルを変更してください。

### クリーチャーとオブジェクト
動物／クリーチャーアセットとオブジェクト／小道具アセットも、それぞれの名前と役割を使って、同じ短い形式で書きます。Nessie という名前のクリーチャーは `@nessie:1` で、`@nessie:1:markings` と書くと、その模様を取り込みます。エディターはこれらのメンションを候補として表示しないので、手で入力してください。

メンションが最も重要になるのは、クリーチャーとオブジェクトです。接続したクリーチャーやオブジェクトは、メンションしなくてもフレーズを追加しますが、その位置はプロンプトの末尾です。メンションすると、フレーズは文中に 1 回だけ入り、モデルはそのフレーズを、あなたが書いた内容と結び付けます。

```
A wide shot of @nessie:1 rising from the lake
```

これは「A wide shot of the creature from reference image A rising from the lake」になります。

2 つの種類で名前が同じ場合は、キャラクター、ロケーション、画像、クリーチャー、オブジェクトの順で、先にある種類が優先されます。

## 被写体の同一性を固定する
デフォルトでは、Nodaro は同一性に関する指示を追加しません。リファレンスは単なる画像として扱われ、結果は役割だけで決まります。被写体を変えてはいけない場合は、そのリファレンスの**顔の固定**をオンにします。オンにすると、プロンプトの先頭に次の 1 行が追加されます。

```
Lock the exact identity of the person in reference image A — face, bone structure, skin tone, all unique features.
```

- **リファレンスごと**。顔の固定はデフォルトでオフで、リファレンスごとにオンにします。組み込みの文言は、人物、顔、クリーチャー、ロケーションの種類ごとに用意されており、自分の文言に置き換えることもできます。
- **メンションごと**。キャラクターやロケーションのメンションのメニューで、**顔の固定**をオンにします。すると、リファレンス自体の固定がオフでも、そのメンションには `@kira:1:face~lock` のように `~lock` が付きます。
- **1 つのメンションだけオフにする**。`@kira:1:face~nolock` のように、メンションの後に `~nolock` を入力します。すると、リファレンスの固定がオンでも、そのメンションでは固定がオフになります。どちらも付いていないメンションは、リファレンスの設定に従います。

ロケーションの場合、この固定は顔ではなく場所を保ちます。

```
Lock the exact look of reference image A — match the location's architecture, layout, and lighting.
```

## API から設定する
コードや AI アシスタントからも、各リファレンスの役割と顔の固定を設定できます。画像生成や動画生成のリクエストに、構造化されたリファレンスとして含めて送ります。詳しくは、[単体のノードを実行する](https://nodaro.ai/docs/developers/api/nodes)と [MCP ツール](https://nodaro.ai/docs/mcp/tools)を参照してください。

## ヒント
- **クリーチャーとオブジェクトはメンションする**。メンションすると、それらのフレーズが文中に入り、モデルが、あなたが説明した動作と結び付けられるようになります。
- **固定は変えてはいけないものだけにする**。固定がオフなら、プロンプトは短いままで、文言を完全にコントロールできます。同一性を保つ必要がある被写体にだけ、固定をオンにしてください。
- **繰り返し登場する被写体には基準を作る**。多くのショットで使うキャラクターは、[一貫性グリッド](https://nodaro.ai/docs/guides/reference-boards)を一度作り、それをリファレンスとして接続します。
- **最終プロンプトを確認する**。プロンプト欄の最終プロンプト表示を開くと、役割によって追加されたすべてのフレーズを確認できます。

## Frequently asked questions

### リファレンスの役割とは何ですか？

役割は、リファレンスのどの部分を使うかをモデルに伝える短いラベルです。たとえば、顔、服装、背景、スタイルなどです。Nodaro は役割を「the clothes from reference image B」のようなフレーズとして、プロンプトに書き込みます。

### 通常の画像リファレンスに役割がないのはなぜですか？

通常の画像、動画、オーディオは、最初は Ref only になっています。モデルはリファレンスを受け取りますが、そこから何を取り込むかは伝えられません。リファレンスのチップをクリックして、background や style などの役割を選んでください。

### 顔の固定にはどんな効果がありますか？

顔の固定は、そのリファレンスの被写体の同一性（人物なら顔や骨格など）を正確に保つようモデルに指示する 1 行を、プロンプトに追加します。デフォルトではオフです。変えてはいけないリファレンスごとにオンにしてください。

### アップロードした画像をプロンプトでメンションするにはどうすればよいですか？

画像アップロードノードに、Town などのラベルを付けます。すると画像に @town:1 というメンション名が付き、@town:1:background と書くと、その画像から背景を取り込むようモデルに指示できます。

### 役割は画像ノードと動画ノードの両方で使えますか？

はい。役割は画像生成と動画生成で共通です。違うのはプロンプト内でのリファレンスの呼び方だけで、画像ノードでは英字、動画ノードでは番号で呼びます。