Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.krea.ai/llms.txt

Use this file to discover all available pages before exploring further.

A moodboard is the most precise way to set a visual direction with Krea 2. Moodboards are groups of images that share an overall creative direction — palette, texture, style, mood, or composition. You build one in the Krea webapp, then reference it from the API.
Moodboards must be created in the Krea webapp first. The API references existing moodboards by ID; it does not create them.

​
Examples

Each example shows the moodboard on the left and the generated output on the right. Click any moodboard cover to open it in Krea.
Moodboard for flying whaleOutput: a flying whale

Prompt: a flying whale with small fish swimming around her in the air

Moodboard for samurai maskOutput: a samurai mask

Prompt: a samurai mask

Moodboard for chrome jaguar teethOutput: jaguar with chrome teeth

Prompt: extreme close-up of a jaguar’s mouth with chromed teeth, side view

Moodboard for house of ramenOutput: a house made of ramen

Prompt: a house made of ramen

​
How it works

1

Create a moodboard in Krea

Open krea.ai, create a new moodboard, drop in the images that share your creative direction, and save it.
2

Get the moodboard ID

Open the API playground — your saved moodboards are listed there with their IDs. You can also grab one from a moodboard’s share URL: https://www.krea.ai/moodboards?share=<id> — the UUID after ?share= is the ID.
3

Reference it from the API

Pass the UUID as id in the moodboards array, along with a strength between 0 and 1. Start around 0.35 and tune up if you want the moodboard to dominate the output.

​
Code example

Node.js
const response = await fetch("https://api.krea.ai/generate/image/krea/krea-2/large", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.KREA_API_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    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 }],
  }),
});

const job = await response.json();