パレットとムードボード

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

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

それぞれの中身

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

パレットが画像をどう方向づけるか

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

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

ムードボードが画像をどう方向づけるか

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

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

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

画像が送られなかったときの警告

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

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.」（使うにはワークフローを実行してください。課金はされていません）です。
• 公開したアプリでは、 ワークフローに保存されたパレットやムードボードは、作成者のものの中から探されます。アプリを実行する人が指定したものは、その人自身のものの中から探されるので、作成者のほかのパレットやムードボードを指定することはできません。
• 見つからないパレットやムードボードがあると、何かが作られたり課金されたりする前に、そのノードが失敗します。

コードから作成して使う