> ## 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.

# Moodboards

> 了解如何在 Krea 网页应用中创建由参考图像组成的 moodboard（情绪板），并在 Krea 2 API 请求中通过 ID 引用它来引导生成，锁定调色板、纹理、光照、氛围与构图方向，页面附多组示例对比和请求参数的详细说明，帮助你在批量生成与系列创作中始终保持统一的视觉方向。

Moodboard 是使用 Krea 2 设定视觉方向最精准的方式。Moodboard 是一组共享整体创作方向的图像——调色板、纹理、风格、氛围或构图。你先在 Krea 网页应用中创建它，然后从 API 中引用它。

> [!WARNING]
>
> **Moodboard 必须先在 Krea 网页应用中创建。** API 通过 ID 引用已有的 moodboard；它不会创建新的 moodboard。

## 示例

每个示例左侧显示 **moodboard**，右侧显示 **生成结果**。点击任意 moodboard 封面即可在 Krea 中打开。

[![Moodboard for flying whale](https://s.krea.ai/docs/krea-2/moodboard-flying-whale-cover.webp)](https://www.krea.ai/moodboards?share=1e51738c-7413-469e-93b6-ad50db460a1f)

![Output: a flying whale](https://s.krea.ai/docs/krea-2/moodboard-flying-whale-out.webp)

提示词：*a flying whale with small fish swimming around her in the air*

[![Moodboard for samurai mask](https://s.krea.ai/docs/krea-2/moodboard-samurai-mask-cover.webp)](https://www.krea.ai/moodboards?share=2ab1e2e1-b561-4fc5-8bf1-0250a948f22f)

![Output: a samurai mask](https://s.krea.ai/docs/krea-2/moodboard-samurai-mask-out.webp)

提示词：*a samurai mask*

[![Moodboard for chrome jaguar teeth](https://s.krea.ai/docs/krea-2/moodboard-jaguar-chrome-cover.webp)](https://www.krea.ai/moodboards?share=98930754-e374-4ef8-837a-8fa2daaa0df7)

![Output: jaguar with chrome teeth](https://s.krea.ai/docs/krea-2/moodboard-jaguar-chrome-out.webp)

提示词：*extreme close-up of a jaguar's mouth with chromed teeth, side view*

[![Moodboard for house of ramen](https://s.krea.ai/docs/krea-2/moodboard-ramen-house-cover.webp)](https://www.krea.ai/moodboards?share=5ef5c53c-af9a-4fc1-8602-01dba7da0250)

![Output: a house made of ramen](https://s.krea.ai/docs/krea-2/moodboard-ramen-house-out.webp)

提示词：*a house made of ramen*

## 工作原理

**1. 在 Krea 中创建 moodboard**

打开 [krea.ai](https://www.krea.ai/)，新建一个 moodboard，放入代表你创作方向的图片，并保存它。

**2. 获取 moodboard ID**

打开 [API playground](https://www.krea.ai/app/api/playground)——你保存的 moodboard 会在其中显示，并附有 ID。你也可以从 moodboard 的分享 URL 中获取：`https://www.krea.ai/moodboards?share=<id>`——`?share=` 后面的 UUID 就是 ID。

**3. 从 API 中引用它**

在 `moodboards` 数组中传入 UUID 作为 `id`，同时提供 -0.5 到 1.5 之间的 `strength`。可在 `krea-2/medium` 或 `krea-2/large` 中使用。可以从 `0.35` 附近开始，如果希望 moodboard 更强烈地主导输出，则逐步增加。

## 代码示例

```javascript Node.js theme={"theme":{"light":"github-light-default","dark":"vesper"}}
// 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]);
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.