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

> Guidez une génération Krea 2 avec un moodboard d'images de référence pour verrouiller la palette, la texture, l'éclairage, l'ambiance et la composition à chaque requête API.

Un moodboard est la manière la plus précise de définir une direction visuelle avec Krea 2. Les moodboards sont des groupes d'images qui partagent une direction créative globale — palette, texture, style, ambiance ou composition. Vous en créez un dans la webapp Krea, puis le référencez depuis l'API.

<Warning>
  **Les moodboards doivent d'abord être créés dans la webapp Krea.** L'API référence les moodboards existants par ID ; elle ne les crée pas.
</Warning>

## Exemples

Chaque exemple montre le **moodboard** à gauche et la **sortie générée** à droite. Cliquez sur la couverture d'un moodboard pour l'ouvrir dans 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="Moodboard pour une baleine volante" 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="Sortie : une baleine volante" 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">Prompt : <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="Moodboard pour un masque de samouraï" 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="Sortie : un masque de samouraï" 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">Prompt : <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="Moodboard pour des dents chromées de jaguar" 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="Sortie : jaguar aux dents chromées" 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">Prompt : <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="Moodboard pour une maison de ramen" 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="Sortie : une maison faite de ramen" 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">Prompt : <em>a house made of ramen</em></p>
  </div>
</div>

## Comment ça fonctionne

<Steps>
  <Step title="Créer un moodboard dans Krea">
    Ouvrez [krea.ai](https://www.krea.ai/), créez un nouveau moodboard, déposez les images qui partagent votre direction créative, et enregistrez-le.
  </Step>

  <Step title="Obtenir l'ID du moodboard">
    Ouvrez le [playground de l'API](https://www.krea.ai/app/api/playground) — vos moodboards enregistrés y sont listés avec leurs ID. Vous pouvez également en récupérer un depuis l'URL de partage d'un moodboard : `https://www.krea.ai/moodboards?share=<id>` — le UUID après `?share=` est l'ID.
  </Step>

  <Step title="Le référencer depuis l'API">
    Passez le UUID en tant que `id` dans le tableau `moodboards`, avec une `strength` comprise entre -0,5 et 1,5. Utilisez-le avec `krea-2/medium` ou `krea-2/large`. Commencez autour de `0.35` et augmentez si vous voulez que le moodboard domine la sortie.
  </Step>
</Steps>

## Exemple de code

```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]);
```