# パレットとムードボード

> 自分のカラーパレットとムードボードを一度保存すれば、自分の色、説明、スタイルのリファレンス画像で、画像生成ノードの実行を毎回方向づけられます。

Source: https://nodaro.ai/ja/docs/guides/palettes-and-moodboards

**パレット**は自分で決めた色のセットで、**ムードボード**は自分のリファレンス画像と説明文のセットです。一度保存すれば、どの[**画像生成**](https://nodaro.ai/docs/nodes/image/generate-image)の実行もそれで方向づけられます。組み込みのカラールックやスタイルと同じように働きますが、使われるのはあなたの色とあなたの画像です。

パレットとムードボードは、REST API、SDK、CLI、または MCP 経由の AI アシスタントから作ります。エディターには、これらを作成・編集する画面はありません。すべてのエディションで使えます。

## それぞれの中身
| | パレット | ムードボード |
| --- | --- | --- |
| **中身** | 名前、`#RRGGBB` 形式の 2〜12 色、最大 500 文字の任意のメモ | 名前、最大 1,000 文字の任意の説明、1〜12 件の画像リンク（それぞれに任意のキャプション） |
| **実行での使い方** | `direction.colorLook: "palette:<id>"` | `direction.style: "moodboard:<id>"` |
| **実行に渡るもの** | すべての色が、日常的な色名と 16 進コードでプロンプトに入ります | 説明がプロンプトに入り、画像がスタイルリファレンスとして送られます |

どちらもあなただけのものです。ほかの人の ID には、存在しない ID と同じく `404` が返ります。

## パレットが画像をどう方向づけるか
実行では、パレットの各色が、あなたの決めた順番で、`color palette: <name> <hex>, …` の形でプロンプトに書き込まれます。各色には、いちばん近い日常的な色名と正確な 16 進コードが付きます。モデルは名前の付いた色のほうに確実に従うからです。パレットのメモはあなた用のもので、プロンプトには追加されません。

この語句は、組み込みのカラールックが入るのと同じ場所、つまりプロンプトの末尾のスタイルの部分に入ります。プロンプトがモデルの上限を超えると、これらの語句が最初に削られます。あなた自身のプロンプトとリファレンスが削られることはありません。

## ムードボードが画像をどう方向づけるか
ムードボードは、あなたが書いたとおりの説明をプロンプトに追加します。説明のないムードボードは、画像だけを送ります。

画像はリファレンス画像としてモデルに送られます。各画像には、被写体や構図ではなく、色、光、質感、雰囲気をそこから取り入れるようモデルに伝える短い一文が付きます。キャプションがある場合は、それも追加されます。

- **自分のリファレンスが先です。** 自分で送った画像や接続したキャラクターは、その位置を保ちます。ムードボードの画像は、それらのあとに残ったリファレンスの枠だけを埋めます。
- **モデルが受け付ける枚数を超えることはありません。** モデルごとに、受け付けるリファレンス画像の枚数が決まっています。収まらない画像は、ムードボードの順番に従って送られません。リファレンス画像を受け付けないモデルには画像は送られませんが、説明は入ります。
- **アスペクト比が自動**の場合は、実行が最初に送る画像の形を保ちます。自分の画像を送らない場合は、ムードボードの最初の画像がそれにあたります。

### 画像が送られなかったときの警告
収まらない画像がある場合も実行は進み、応答には、コード `moodboard_images_not_sent` の警告が含まれます。メッセージには、送られなかった枚数とその理由が書かれています。ジョブにも同じ警告が残ります。例：

```text
5 of the 12 images of moodboard "Nordic calm" were not sent as style references: the model (nano-banana-pro) takes at most 8 reference images, and your own references come first.
```

（ムードボード「Nordic calm」の 12 枚のうち 5 枚は、スタイルリファレンスとして送られませんでした。モデル（nano-banana-pro）が受け付けるリファレンス画像は最大 8 枚で、自分のリファレンスが優先されます。）

## 制限
- **コピーではなく画像リンクです。** 各画像は、最大 2,048 文字の公開された `http` または `https` のリンクです。キャプションは最大 200 文字です。プライベートネットワークへのリンクは拒否されます。あなたが削除した画像や、プランのメディア保持期間によって削除された画像は、ムードボードからも消えます。
- **画像生成のみです。** パレットやムードボードを指定した動画のリクエストには `400` が返ります。
- **同じリクエストでプリセットとは併用できません。** プリセット（`presetId`）を適用する呼び出しではパレットやムードボードを使えず、`400` が返ります。direction にパレットやムードボードを含めて保存されたプリセットも同じです。
- **最新の版が使われます。** 実行が記録するのは ID で、コピーではありません。パレットを変更すると、次の実行から新しい色が使われます。削除すると、それを指定したままの実行には `404` が返ります。
- **エラーは課金の前に返ります。** 形式が正しくない ID には `400` が、自分のものではない ID や存在しなくなった ID には `404` が返ります。不明な組み込みの ID はスキップされますが、あなた自身のパレットやムードボードが黙って無視されることはありません。

## 料金
パレットとムードボードの保存、一覧表示、変更は無料です。ムードボードの画像はリファレンスなので、実行の料金は、同じ枚数のリファレンスを使うほかの実行と同じです。リファレンス付きのテキストから画像のモデルは、その画像から画像のバージョンで実行されます。リファレンス画像ごとに料金が決まるモデルでは、その枚数が数えられます。実行前に確認される料金では、実際に送られる画像だけが数えられます。

## ワークフローでの使い方
direction でパレットやムードボードを指定した画像生成ノードは、アプリの実行、スケジュール、Webhook を含め、ワークフローが実行されるたびに解決されます。こうしたノードは、コードから、または AI アシスタントによってワークフローに書き込まれます。

- **最終プロンプト表示には注記が表示されます。** パレットやムードボードの語句は実行の開始時に追加されるため、それが入る場所に注記が表示されます。
- **ノードではなくワークフローを実行してください。** こうしたノードは、ノード自体の実行ボタンでは拒否され、何も送られず課金もされません。メッセージの最後は「Run the workflow to use it — nothing was charged.」（使うにはワークフローを実行してください。課金はされていません）です。
- **公開したアプリでは、** ワークフローに保存されたパレットやムードボードは、作成者のものの中から探されます。アプリを実行する人が指定したものは、その人自身のものの中から探されるので、作成者のほかのパレットやムードボードを指定することはできません。
- **見つからないパレットやムードボード**があると、何かが作られたり課金されたりする前に、そのノードが失敗します。

## コードから作成して使う
**REST**

`/v1/palettes` と `/v1/moodboards` に対する `GET`、`POST`、`PATCH`、`DELETE` で、一覧表示、作成、変更、削除を行います。OAuth アプリには、読み取りに `assets:read`、書き込みに `assets:write` が必要です。書き込みは 1 分あたり 30 リクエストまでです。そのあと、`POST /v1/generate-image` の `direction` に ID を渡します。[自分のパレットとムードボード](https://nodaro.ai/docs/developers/api/nodes#palettes-and-moodboards)を参照してください。

**SDK**

`client.palettes` と `client.moodboards` で管理します。`nodes.run("generate-image", …)` では、`direction: { colorLook: paletteDirectionId(id), style: moodboardDirectionId(id) }` を渡します。応答では `warnings` が型付けされています。[ピッカー、プリセット、プロンプト](https://nodaro.ai/docs/developers/sdk/pickers-and-prompts)と[ノードの実行](https://nodaro.ai/docs/developers/sdk/nodes)を参照してください。

**CLI**

`nodaro palettes` と `nodaro moodboards` で、一覧表示、作成、変更、削除を行います。[コマンド](https://nodaro.ai/docs/developers/cli/commands)を参照してください。

**MCP**

AI アシスタントは `list_palettes`、`save_palette`、`list_moodboards`、`save_moodboard` を使います。`generate_image` ツールは `palette_id` と `moodboard_id` を受け取り、警告をそのまま伝えます。MCP には削除のツールはありません。MCP の[画像](https://nodaro.ai/docs/mcp/tools/image)ツールを参照してください。

## よくある質問

### パレットとムードボードの違いは何ですか？

パレットは 2〜12 色に名前を付けたセットで、実行時にプロンプトの中で色名として書き込まれます。ムードボードは説明文と 1〜12 件の画像リンクで、実行時に説明がプロンプトに追加され、画像がスタイルリファレンスとして送られます。

### パレットやムードボードはどうやって作りますか？

REST API、SDK、CLI、または MCP で接続した AI アシスタントから作ります。エディターには、これらを作る画面はありません。

### ムードボードの画像には追加料金がかかりますか？

画像はリファレンスとして送られるので、実行の料金は、同じ枚数のリファレンスを使うほかの実行と同じです。実行前に確認される料金では、実際に送られる画像だけが数えられます。

### ムードボードの画像がモデルの受け付ける枚数より多い場合はどうなりますか？

自分のリファレンスが先に並び、残った枠をムードボードの画像が埋めます。収まらない画像は送られず、応答には、送られなかった枚数を伝える警告が含まれます。

### 自分のパレットをほかの人が使えますか？

いいえ。パレットとムードボードはあなただけのものです。ほかの人の ID には、存在しない ID と同じく 404 が返ります。公開したアプリでは、ワークフローに保存されたムードボードであれば、作成者のムードボードを使えます。