API Krea 2

Krea 2 est notre premier modèle d’image fondation, entièrement entraîné à partir de zéro pour offrir aux utilisateurs un contrôle total sur l’apparence, l’ambiance et la direction créative de chaque image qu’ils créent.

À partir d’aujourd’hui, vous pouvez accéder à Krea 2 via nos partenaires API, tels que Fal, Comfy ou Runware. Nous lançons également avec Nous Research, offrant un accès à Hermes dès le jour 0, et vous pouvez trouver un support pour Claude, OpenClaw et Codex dans nos docs.

Voici ce qu’il apporte :

• Diversité esthétique – Krea 2 peut générer une gamme incroyablement large de styles, avec une force particulière dans les directions artistiques et expressives que d’autres modèles ont tendance à uniformiser.
• Transfert de style – Krea 2 est livré avec le système de transfert de style le plus avancé disponible. Il peut extraire le style d’une ou plusieurs images de référence et l’appliquer à vos sorties avec précision.
• Créativité – c’est un paramètre réel que vous pouvez ajuster avec Krea 2. À des valeurs élevées, il pousse le modèle à ajouter de la profondeur esthétique, de l’interprétation et de la richesse visuelle à ce que vous lui donnez.
• Moodboards – vous pouvez fournir un moodboard complet de dizaines d’images et Krea 2 comprendra la direction créative globale, produisant des résultats qui s’y alignent.

Découvrez des centaines d’exemples avec leurs invites respectives en cliquant sur le lien ci-dessous :

Nous avons conçu Krea 2 pour les créatifs qui veulent un vrai contrôle sur ce que l’IA produit. Nous travaillons en étroite collaboration avec des équipes de studios créatifs, agences marketing et publicitaires, mode, jeux vidéo et architecture — en prenant continuellement leurs retours pour pousser le modèle plus loin pour chaque cas d’usage. C’est un modèle qui évolue activement avec ses utilisateurs.

Il est aussi conçu pour l’exploration. Vous n’avez pas toujours une idée complètement formée, et Krea 2 est pensé pour être un collaborateur créatif dans ces moments — capable de prendre une direction vague et de vous rendre des visuels qui inspirent la prochaine idée, plutôt que de vous forcer à spécifier chaque détail dès le départ.

Variantes du modèle

L’API Krea 2 propose deux variantes de modèle : Krea 2 Medium et Krea 2 Large. Les deux supportent les mêmes paramètres et fonctionnalités — les différences résident dans la taille du modèle, le stade d’entraînement et le caractère des résultats produits.

Si vous ne savez pas par laquelle commencer, essayez Krea 2 Medium — il est plus rapide, moins cher, et gère la plus large gamme de cas d’usage de manière fiable.

Krea 2 Medium

Un modèle plus petit, plus rapide et plus économique avec un post-entraînement étendu appliqué. Cela rend ses sorties particulièrement stables et cohérentes entre les générations. Medium est particulièrement performant pour l’illustration, l’anime, la peinture et d’autres styles expressifs ou artistiques.

Krea 2 Large

Plus de deux fois la taille de Medium, avec un post-entraînement plus léger – ce qui donne à ses sorties un caractère plus brut, texturé et flexible. Large est le modèle le plus puissant dans l’ensemble – à son meilleur, il produit des résultats que Medium ne peut égaler. Il gère bien les styles expressifs et artistiques, et excelle en photoréalisme et looks « bruts » comme les flous de mouvement, grains ou faibles dynamiques.

Fonctionnalités & Exemples

Nous avons compilé cette liste d’exemples que vous pouvez utiliser pour tester les capacités du modèle.

Diversité esthétique

La plupart des modèles d’image gèrent bien les invites complexes, mais ils ont tendance à être limités sur le style — par défaut quelque chose de net, poli et « sûr ». Cela restreint la gamme créative que vous pouvez réellement en tirer.

Avec Krea 2, nous avons mis autant d’efforts dans la compréhension du style par le modèle que dans la compréhension des invites. Le résultat est un modèle capable de rendre une large gamme d’esthétiques – expressives, brutes, de niche, expérimentales – sans tomber dans les looks typiques d’IA.

Voici une série d’exemples créés avec Krea 2 montrant une variété d’esthétiques :

"illustration d’un chat faisant du vélo"

Modèle : Krea 2 Large

Transfert de style

Krea 2 est livré avec le système de transfert de style le plus puissant du marché. Fournissez une image de référence unique ou combinez-en plusieurs, et Krea 2 extraira le style et l’appliquera à votre sortie — vous laissant décider de la force avec laquelle chaque référence influence l’image finale.

Les images suivantes ont été générées en utilisant des références de style :

"un chat sautant de côté"

Créativité

La créativité est un paramètre réel que vous pouvez ajuster pour Krea 2. Quand une invite est courte ou vague, le modèle peut combler les pièces manquantes — style, composition, angle de caméra, palette de couleurs — ajoutant de la profondeur visuelle là où vous ne l’avez pas spécifiée. Le paramètre creativity contrôle jusqu’où cette expansion va.

Réglez-le sur high et l’expansion est plus forte — le modèle prend plus de libertés créatives avec le style, l’ambiance et l’esthétique. Réglez-le sur low et le modèle reste plus proche de ce qui est dans votre invite. Réglez-le sur raw et le modèle ne fait aucune expansion, ne rendant que ce que vous avez explicitement décrit.

Les exemples suivants ont été créés avec creativity réglé sur medium :

"image cinématographique, scène dramatique"

Modèle : Krea 2 Large

Moodboards

Un moodboard est la manière la plus précise de définir une direction visuelle avec Krea 2. Les moodboards sont construits à partir d’un groupe d’images partageant une direction créative globale — palette, texture, style, ambiance ou composition. Vous pouvez en créer un dans Krea et le référencer lors de l’inférence via cette API.

Les exemples suivants montrent comment activer un moodboard peut transformer la sortie même d’invites très simples.

Moodboard Analog Neon Glitchwave

"une baleine volante avec de petits poissons nageant autour d’elle dans l’air"

Modèle : Krea 2 Large

Configuration de l’API

Créez un jeton API depuis les paramètres de votre compte Krea. Krea 2 propose deux versions du modèle disponibles dans l’API :

Endpoints

Krea 2 Medium

https://api.krea.ai/generate/image/krea/krea-2/medium

Krea 2 Large

https://api.krea.ai/generate/image/krea/krea-2/large

Paramètres

Les deux versions de Krea 2 supportent les paramètres suivants.

Récupérer les jobs terminés

Les jobs terminés peuvent être récupérés via : https://api.krea.ai/jobs/{job_id}. Vous pouvez aussi passer un header X-Webhook-URL pour recevoir un POST à la fin du job.

Une documentation API plus détaillée est disponible sur https://docs.krea.ai/developers/introduction. Elle couvre le cycle de vie des jobs, intégrations webhook, génération de jetons API, etc.

Exemples d’API

Voici un ensemble de guides courts qui vous montreront comment utiliser toutes les fonctionnalités de Krea 2 :

Générer une image

const API_BASE = "https://api.krea.ai";
const API_TOKEN = process.env.KREA_API_TOKEN;

async function waitForJob(jobId) {
  while (true) {
    const response = await fetch(`${API_BASE}/jobs/${jobId}`, {
      headers: {
        Authorization: `Bearer ${API_TOKEN}`
      }
    });

    if (!response.ok) {
      throw new Error(`Échec de récupération du job : ${response.status}`);
    }

    const job = await response.json();

    if (job.status === "completed") return job;
    if (job.status === "failed" || job.status === "canceled") {
      throw new Error(`Job ${job.status}`);
    }

    await new Promise((resolve) => setTimeout(resolve, 3000));
  }
}

const response = await fetch(`${API_BASE}/generate/image/krea/krea-2/medium`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${API_TOKEN}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    prompt: "Photo produit cinématographique d’une lampe en verre sur une table en marbre",
    aspect_ratio: "4:5",
    resolution: "1K",
    creativity: "low"
  })
});

if (!response.ok) {
  throw new Error(`Échec de génération : ${response.status}`);
}

const createdJob = await response.json();
const completedJob = await waitForJob(createdJob.job_id);

console.log(completedJob.result.urls);

Utiliser le transfert de style

import { openAsBlob } from "node:fs";

const API_BASE = "https://api.krea.ai";
const API_TOKEN = process.env.KREA_API_TOKEN;

async function waitForJob(jobId) {
  while (true) {
    const response = await fetch(`${API_BASE}/jobs/${jobId}`, {
      headers: {
        Authorization: `Bearer ${API_TOKEN}`
      }
    });

    if (!response.ok) {
      throw new Error(`Échec de récupération du job : ${response.status}`);
    }

    const job = await response.json();

    if (job.status === "completed") return job;
    if (job.status === "failed" || job.status === "canceled") {
      throw new Error(`Job ${job.status}`);
    }

    await new Promise((resolve) => setTimeout(resolve, 3000));
  }
}

const file = await openAsBlob("./style-reference.png", {
  type: "image/png"
});

const formData = new FormData();
formData.append("file", file, "style-reference.png");
formData.append("description", "Référence de style pour Krea 2");

const uploadResponse = await fetch(`${API_BASE}/assets`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${API_TOKEN}`
  },
  body: formData
});

if (!uploadResponse.ok) {
  throw new Error(`Échec du téléchargement : ${uploadResponse.status}`);
}

const asset = await uploadResponse.json();

const generationResponse = await fetch(`${API_BASE}/generate/image/krea/krea-2/medium`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${API_TOKEN}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    prompt: "Portrait d’un danseur dans un studio calme",
    aspect_ratio: "4:3",
    resolution: "1K",
    creativity: "medium",
    image_style_references: [
      {
        url: asset.image_url,
        strength: 0.6
      }
    ]
  })
});

if (!generationResponse.ok) {
  throw new Error(`Échec de génération : ${generationResponse.status}`);
}

const createdJob = await generationResponse.json();
const completedJob = await waitForJob(createdJob.job_id);

console.log(completedJob.result.urls);

Ajuster la créativité

Utilisez le paramètre creativity pour contrôler à quel point Krea 2 suit littéralement l’invite.

• raw : invite brute
• low : proche de l’invite
• medium : équilibré, par défaut
• high : interprétation plus expressive

Utiliser les moodboards

Après avoir créé un moodboard dans l’application web Krea, vous pouvez l’utiliser dans l’API :

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: "Image de campagne pour une nouvelle collection de lampes d’extérieur",
    aspect_ratio: "16:9",
    resolution: "1K",
    creativity: "high",
    moodboards: [
      {
        id: "votre-id-moodboard",
        strength: 0.35
      }
    ]
  })
});

const job = await response.json();

Tarification

Note : combiner moodboards et références de style n’augmente pas le prix par génération, c’est-à-dire 0,04 $ pour Medium et 0,07 $ pour Large.