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

> Dirige una generación de Krea 2 con un moodboard de imágenes de referencia para fijar paleta, textura, iluminación y composición desde la API.

Un moodboard es la forma más precisa de definir una dirección visual con Krea 2. Los moodboards son grupos de imágenes que comparten una dirección creativa general — paleta, textura, estilo, ambiente o composición. Se crean en la webapp de Krea y luego se referencian desde la API.

<Warning>
  **Los moodboards deben crearse primero en la webapp de Krea.** La API referencia moodboards existentes por ID; no los crea.
</Warning>

## Ejemplos

Cada ejemplo muestra el **moodboard** a la izquierda y la **salida generada** a la derecha. Haz clic en cualquier portada de moodboard para abrirlo en 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 de ballena voladora" 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="Salida: una ballena voladora" 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 de máscara samurái" 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="Salida: una máscara samurái" 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 de jaguar con dientes cromados" 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="Salida: jaguar con dientes cromados" 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 de casa 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="Salida: una casa hecha 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>

## Cómo funciona

<Steps>
  <Step title="Crea un moodboard en Krea">
    Abre [krea.ai](https://www.krea.ai/), crea un nuevo moodboard, agrega las imágenes que compartan tu dirección creativa y guárdalo.
  </Step>

  <Step title="Obtén el ID del moodboard">
    Abre el [playground de la API](https://www.krea.ai/app/api/playground) — tus moodboards guardados aparecen ahí con sus IDs. También puedes obtener uno desde la URL de compartir de un moodboard: `https://www.krea.ai/moodboards?share=<id>` — el UUID después de `?share=` es el ID.
  </Step>

  <Step title="Referéncialo desde la API">
    Pasa el UUID como `id` en el arreglo `moodboards`, junto con un `strength` entre -0.5 y 1.5. Úsalo con `krea-2/medium` o `krea-2/large`. Comienza alrededor de `0.35` y súbelo si quieres que el moodboard domine la salida.
  </Step>
</Steps>

## Ejemplo de código

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


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