> ## Documentation Index
> Fetch the complete documentation index at: https://www.krea.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ムードボード

> 参照画像のムードボードで Krea 2 の生成を制御し、すべての API リクエストでパレット、テクスチャ、ライティング、ムード、構図を安定させます。

ムードボードは、Krea 2 でビジュアルの方向性を最も精密に指定する方法です。ムードボードとは、パレット、テクスチャ、スタイル、ムード、構図など、全体的なクリエイティブディレクションを共有する画像のグループです。Krea のウェブアプリで作成してから、API から参照します。

<Warning>
  **ムードボードはあらかじめ Krea ウェブアプリで作成する必要があります。** API は既存のムードボードを ID で参照するのみで、作成はできません。
</Warning>

## 例

各例では、左に **ムードボード**、右に **生成された出力** を表示しています。ムードボードのカバーをクリックすると Krea で開けます。

<div className="not-prose space-y-8">
  <div>
    <div className="grid grid-cols-2 gap-3">
      <a href="https://www.krea.ai/moodboards?share=1e51738c-7413-469e-93b6-ad50db460a1f" target="_blank" rel="noopener noreferrer" className="block">
        <img src="https://s.krea.ai/docs/krea-2/moodboard-flying-whale-cover.webp" alt="空飛ぶクジラのムードボード" className="rounded-lg w-full object-cover m-0 hover:opacity-90 transition-opacity" style={{ aspectRatio: "4/3" }} />
      </a>

      <img src="https://s.krea.ai/docs/krea-2/moodboard-flying-whale-out.webp" alt="出力: 空飛ぶクジラ" className="rounded-lg w-full object-cover m-0" style={{ aspectRatio: "4/3" }} />
    </div>

    <p className="mt-2 text-sm text-gray-600 dark:text-gray-400">プロンプト: <em>a flying whale with small fish swimming around her in the air</em></p>
  </div>

  <div>
    <div className="grid grid-cols-2 gap-3">
      <a href="https://www.krea.ai/moodboards?share=2ab1e2e1-b561-4fc5-8bf1-0250a948f22f" target="_blank" rel="noopener noreferrer" className="block">
        <img src="https://s.krea.ai/docs/krea-2/moodboard-samurai-mask-cover.webp" alt="侍のマスクのムードボード" className="rounded-lg w-full object-cover m-0 hover:opacity-90 transition-opacity" style={{ aspectRatio: "4/3" }} />
      </a>

      <img src="https://s.krea.ai/docs/krea-2/moodboard-samurai-mask-out.webp" alt="出力: 侍のマスク" className="rounded-lg w-full object-cover m-0" style={{ aspectRatio: "4/3" }} />
    </div>

    <p className="mt-2 text-sm text-gray-600 dark:text-gray-400">プロンプト: <em>a samurai mask</em></p>
  </div>

  <div>
    <div className="grid grid-cols-2 gap-3">
      <a href="https://www.krea.ai/moodboards?share=98930754-e374-4ef8-837a-8fa2daaa0df7" target="_blank" rel="noopener noreferrer" className="block">
        <img src="https://s.krea.ai/docs/krea-2/moodboard-jaguar-chrome-cover.webp" alt="クロームのジャガーの歯のムードボード" className="rounded-lg w-full object-cover m-0 hover:opacity-90 transition-opacity" style={{ aspectRatio: "4/3" }} />
      </a>

      <img src="https://s.krea.ai/docs/krea-2/moodboard-jaguar-chrome-out.webp" alt="出力: クロームの歯を持つジャガー" className="rounded-lg w-full object-cover m-0" style={{ aspectRatio: "4/3" }} />
    </div>

    <p className="mt-2 text-sm text-gray-600 dark:text-gray-400">プロンプト: <em>extreme close-up of a jaguar's mouth with chromed teeth, side view</em></p>
  </div>

  <div>
    <div className="grid grid-cols-2 gap-3">
      <a href="https://www.krea.ai/moodboards?share=5ef5c53c-af9a-4fc1-8602-01dba7da0250" target="_blank" rel="noopener noreferrer" className="block">
        <img src="https://s.krea.ai/docs/krea-2/moodboard-ramen-house-cover.webp" alt="ラーメンの家のムードボード" className="rounded-lg w-full object-cover m-0 hover:opacity-90 transition-opacity" style={{ aspectRatio: "4/3" }} />
      </a>

      <img src="https://s.krea.ai/docs/krea-2/moodboard-ramen-house-out.webp" alt="出力: ラーメンでできた家" className="rounded-lg w-full object-cover m-0" style={{ aspectRatio: "4/3" }} />
    </div>

    <p className="mt-2 text-sm text-gray-600 dark:text-gray-400">プロンプト: <em>a house made of ramen</em></p>
  </div>
</div>

## 仕組み

<Steps>
  <Step title="Krea でムードボードを作成する">
    [krea.ai](https://www.krea.ai/) を開き、新しいムードボードを作成して、クリエイティブディレクションを共有する画像を追加し、保存します。
  </Step>

  <Step title="ムードボード ID を取得する">
    [API プレイグラウンド](https://www.krea.ai/app/api/playground) を開くと、保存済みのムードボードとその ID が一覧表示されます。また、ムードボードの共有 URL からも取得できます: `https://www.krea.ai/moodboards?share=<id>` — `?share=` の後の UUID が ID です。
  </Step>

  <Step title="API から参照する">
    UUID を `moodboards` 配列の `id` として渡し、`strength` を -0.5 から 1.5 の間で指定します。`krea-2/medium` または `krea-2/large` と組み合わせて使用します。まず `0.35` 付近から始め、ムードボードを出力により強く反映したい場合は値を上げてください。
  </Step>
</Steps>

## コード例

```javascript Node.js theme={null}
// npm install @krea-ai/sdk
import { Krea } from "@krea-ai/sdk";

const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

const result = await krea.subscribe("image/krea/krea-2/large", {
  input: {
    prompt: "A campaign image for a new outdoor lamp collection",
    aspect_ratio: "16:9",
    resolution: "1K",
    creativity: "high",
    // From a share URL like https://www.krea.ai/moodboards?share=<id>
    moodboards: [{ id: "1e51738c-7413-469e-93b6-ad50db460a1f", strength: 0.35 }],
  },
});

console.log(result.data?.urls[0]);
```