# 説明をピッカーへ

> ビジョンモデルで写真を分析し、接続した人物、スタイリング、フレーミング、レンズ、カメラ／フィルムの各ピッカーに、カタログにある有効な選択肢を入力します。

Source: https://nodaro.ai/ja/docs/nodes/image/describe-to-picker

**説明をピッカーへ**（Describe to Picker）ノードは、写真を分析し、接続したピッカーノードに値を入力します。ビジョンモデルが、メインの被写体とシーンを読み取ります。そして、人物の年齢や髪、メイク、ショットサイズ、レンズなど、各ピッカーのカタログにある選択肢を返します。1 回の実行で、接続したすべてのピッカーに値が入力されます。

- Found in: Image › Understand
- Output: data
- API type: `describe-to-picker`

## 使いどころ
- リファレンスのポートレートを、完全なキャスティングの指示に変えます。[**人物**（Person）](https://nodaro.ai/docs/nodes/creative-controls/person)、[**スタイリング**（Styling）](https://nodaro.ai/docs/nodes/creative-controls/styling)、[**フレーミング**（Framing）](https://nodaro.ai/docs/nodes/creative-controls/framing)を接続し、それらを[**画像生成**（Generate Image）](https://nodaro.ai/docs/nodes/image/generate-image)や[**動画生成**（Generate Video）](https://nodaro.ai/docs/nodes/video/generate-video)に渡します。
- 繰り返し登場するキャラクターを、スタイリングやレンズの見え方も含めて、1 枚の写真から設定します。
- リファレンス画像のカメラに合わせます。ショットサイズ、アングル、レンズ、フィルムストックを検出します。

## クイックスタート
### ノードを追加する
キャンバス上で Tab を押し、**画像 › 解析 › 説明をピッカーへ**を選びます。

### 写真を接続する
[**画像アップロード**（Upload Image）](https://nodaro.ai/docs/nodes/image/upload-image)などの画像ノードから、**画像**入力までドラッグします。

### 値を入力するピッカーを接続する
**ピッカー JSON** 出力から、値を入力したい各ピッカーの**ピッカー JSON** 入力までドラッグします。設定パネルでは、それらのピッカーが**分析対象**の下に一覧表示されます。

### 実行して結果を適用する
ノードの**実行**をクリックします。各ピッカーは、結果のうち自分の部分を受け取ります。デフォルトでは、各ピッカーの**取り込んだ値で更新**をクリックして適用します。

Workflow: 1 枚の写真から人物、スタイリング、フレーミングのピッカーに値が入力され、それらのピッカーが新しい画像を形作ります。

- 画像アップロード → 説明をピッカーへ (画像)
- 説明をピッカーへ → 人物 (ピッカー JSON)
- 説明をピッカーへ → スタイリング (ピッカー JSON)
- 説明をピッカーへ → フレーミング (ピッカー JSON)
- 人物 → 画像生成 (エレメント)
- スタイリング → 画像生成 (エレメント)
- フレーミング → 画像生成 (ルック)

## 入力
| 入力 | 接続できるノード | 説明 |
| --- | --- | --- |
| **画像** | 画像アップロード、画像生成などの画像系ノード | 分析する写真です。必須です。 |

出力の**ピッカー JSON** は、接続したピッカーごとに 1 つずつ部分を持つ構造化データです。これを読み取れるのはピッカーノードだけで、テキスト入力には接続できません。

## 値が入力されるピッカー
ノードが分析するのは、出力に接続したピッカーだけです。それ以外のピッカーは分析しません。どのピッカーを使うかを選ぶ設定はなく、接続そのものが選択になります。

| ピッカー | 検出する内容 |
| --- | --- |
| [人物](https://nodaro.ai/docs/nodes/creative-controls/person) | タイプ、年齢、民族、体格、髪、目、肌などの特徴 |
| [スタイリング](https://nodaro.ai/docs/nodes/creative-controls/styling) | メイク、アイウェア、ジュエリーなど、ピッカーのカタログにあるスタイリングの選択肢 |
| [フレーミング](https://nodaro.ai/docs/nodes/creative-controls/framing) | ショットサイズ、アングル、構図 |
| [**レンズ**（Lens）](https://nodaro.ai/docs/nodes/creative-controls/lens) | レンズ |
| [**カメラ／フィルム**（Camera / Film Stock）](https://nodaro.ai/docs/nodes/creative-controls/camera-format) | カメラ、またはフィルムのフォーマット |

どの値も、そのピッカー自身のカタログにある実際の選択肢なので、ピッカーが知らない値を受け取ることはありません。写真に写っていない特徴は、入力されません。

## ピッカーが結果を適用する仕組み
結果のうち自分の部分をどう使うかは、各ピッカーが設定パネルの 2 つの設定で決めます。

**画像 JSON が挿入されたとき**の設定で、新しい値をピッカーの現在の選択内容とどのように統合するかを選びます。

| モード | 説明 |
| --- | --- |
| **完全に上書き（検出されなかった項目はクリア）** | デフォルトです。検出されたすべての値を書き込み、検出されなかった値はすべてクリアします。写真だけでピッカーの内容を決めたい場合に使います。 |
| **検出された項目を上書き（残りは保持）** | 検出された値だけを書き込み、ほかの選択内容はそのまま残します。 |
| **空の項目のみ入力** | 項目が空の場合にだけ、検出された値を書き込みます。あなたが選んだ内容を上書きすることはありません。 |

**変更時に自動適用**は、デフォルトでオフです。オフの場合、新しい結果が前回適用した内容と異なると、ピッカーに**取り込んだ値で更新**ボタンが表示されます。それ以外の場合は**最新の状態**と表示されます。オンの場合は、新しい結果が選んだモードですぐに適用されます。同じ結果で分析をもう一度実行しても、ピッカーは変更ありとは見なされません。

どのモードでも、変わるのはピッカーの選択内容だけです。ピッカーのラベル、前後のテキスト、レイアウトはそのまま残ります。

## 設定
| 設定 | 説明 |
| --- | --- |
| **分析対象** | 読み取り専用です。次の実行で値が入力される、接続済みのピッカーです。ピッカーを接続したり、接続を解除したりして変更します。 |
| **AI モデル** | ビジョンモデルです。デフォルトは Claude Opus 5 で、肌の色合いなどの細部を正確に捉えるために選ばれています。一覧には、この構造化された結果を確実に返せるビジョンモデルだけが、Claude、Gemini、GPT、Grok の各ファミリーから表示されます。 |
| **推論の強度** | モデルが回答する前にどれだけ推論するかを決めます。対応しているモデルで使えます。デフォルトは**自動（モデルのデフォルト）**です。 |
| **詳細モード** | Gemini モデル専用です。モデルをプロバイダー上で直接実行するので、**温度**、**最大トークン数**、推論の深さの全範囲が有効になります。 |
| **追加の指示（任意）** | 分析のための独自の指示です。最大 2,000 文字で、たとえば `focus on the foreground subject` のように書きます。 |

## クレジット
モデルや接続するピッカーの数にかかわらず、1 回の実行につき一律 10 クレジットです。分析全体は、モデルへの 1 回の呼び出しで行われます。クレジットは実行の開始時に確保され、分析に失敗した場合は返還されます。

## トラブルシューティング
**ピッカーノードを接続するよう求めるメッセージが表示され、実行が拒否される**：ノードが値を入力できるものが、出力に何も接続されていません。人物、スタイリング、フレーミング、レンズ、カメラ／フィルムのピッカーを少なくとも 1 つ接続してください。

**実行後もピッカーが変わらない**：**変更時に自動適用**は、デフォルトでオフです。ピッカーの**取り込んだ値で更新**をクリックするか、**変更時に自動適用**をオンにしてください。

**ノードが違う人物を説明した**：写真に複数の人物が写っている場合や、背景が雑然としている場合は、`describe the woman in the red coat` のように**追加の指示（任意）**を加えてください。

## ヒント
- **1 回の実行で複数のピッカーに入力する**：人物、スタイリング、フレーミングを組み合わせると、1 枚の写真から、キャスティング、ルック、ショットの指示をまとめて作れます。料金はピッカー 1 つの場合と同じです。
- **自分の選択を守る**：決め手となるいくつかの特徴を手動で選んでおき、残りを写真から入力したい場合は、**空の項目のみ入力**を使います。
- **手動で追加した選択を残して更新する**：写真に写っている内容を更新しつつ、手動で追加した選択を残したい場合は、**検出された項目を上書き（残りは保持）**を使います。
- **一から作り直す**：写真だけに基づいた、まっさらな状態のピッカーにしたい場合は、**完全に上書き（検出されなかった項目はクリア）**を使います。

## Frequently asked questions

### 「説明をピッカーへ」ノードは、どのピッカーに値を入力できますか？

人物、スタイリング、フレーミング、レンズ、カメラ／フィルムです。出力に接続したピッカーだけに、1 回の分析でまとめて値を入力します。

### 「説明をピッカーへ」ノードには何クレジットかかりますか？

モデルや接続するピッカーの数にかかわらず、1 回の実行につき一律 10 クレジットです。分析に失敗した場合、クレジットは返還されます。

### 手動で選んだ内容は上書きされますか？

各ピッカーの「画像 JSON が挿入されたとき」の設定によって決まります。「空の項目のみ入力」では、あなたの選択は上書きされません。「検出された項目を上書き（残りは保持）」では、検出されなかった項目はすべてそのまま残ります。デフォルトの「完全に上書き（検出されなかった項目はクリア）」では、検出されなかった項目もすべてクリアされます。

### ピッカーが何も変わらなかったのはなぜですか？

「変更時に自動適用」は、デフォルトでオフになっています。ピッカーの「取り込んだ値で更新」をクリックして新しい値を適用するか、「変更時に自動適用」をオンにしてください。

### 「説明をピッカーへ」と「画像の説明」の違いは何ですか？

「画像の説明」は、自由形式のテキストを書きます。「説明をピッカーへ」は、各ピッカーのカタログにある構造化された選択肢を返すので、ピッカーがそれを直接適用できます。