API Krea 2

Krea 2 è il nostro primo modello di base per immagini, completamente addestrato da zero per offrire agli utenti il pieno controllo sull'aspetto, la sensazione e la direzione creativa di ogni immagine che creano.

Da oggi, puoi accedere a Krea 2 tramite i nostri partner API, come Fal, Comfy o Runware. Lanciamo anche con Nous Research, offrendo accesso a Hermes fin dal primo giorno, e puoi trovare supporto per Claude, OpenClaw e Codex nella nostra documentazione.

Ecco cosa offre:

• Diversità estetica – Krea 2 può generare una gamma incredibilmente ampia di stili, con particolare forza nelle direzioni artistiche ed espressive che altri modelli tendono a appiattire.
• Trasferimento di stile – Krea 2 include il sistema di trasferimento di stile più avanzato disponibile. Può estrarre lo stile da una o più immagini di riferimento e applicarlo con precisione ai tuoi output.
• Creatività – questo è un parametro reale che puoi regolare con Krea 2. A valori elevati, il modello aggiunge profondità estetica, interpretazione e ricchezza visiva a qualsiasi input.
• Moodboard – puoi fornire un intero moodboard con decine di immagini e Krea 2 comprenderà la direzione creativa complessiva, producendo output coerenti.

Trova centinaia di esempi con i rispettivi prompt cliccando il link qui sotto:

Abbiamo creato Krea 2 per creativi che vogliono un vero controllo su ciò che l'IA produce. Collaboriamo strettamente con team di studi creativi, agenzie di marketing e pubblicità, moda, gaming e architettura — raccogliendo continuamente i loro feedback per migliorare il modello per ogni caso d'uso. È un modello in continua evoluzione con le persone che lo usano.

È anche pensato per l'esplorazione. Non sempre si parte con un'idea completamente formata, e Krea 2 è progettato per essere un collaboratore creativo in quei momenti — qualcosa che può prendere una direzione vaga e restituirti immagini che stimolano la prossima idea, senza costringerti a specificare ogni dettaglio in anticipo.

Varianti del modello

L'API Krea 2 offre due varianti del modello: Krea 2 Medium e Krea 2 Large. Entrambi supportano gli stessi parametri e funzionalità — le differenze riguardano dimensione del modello, fase di addestramento e carattere degli output prodotti.

Se non sai da quale iniziare, prova Krea 2 Medium — è più veloce, economico e gestisce la più ampia gamma di casi d'uso in modo affidabile.

Krea 2 Medium

Un modello più piccolo, veloce e più economico con un ampio post-addestramento applicato. Questo rende i suoi output particolarmente stabili e coerenti tra le generazioni. Medium è particolarmente forte in illustrazione, anime, pittura e altri stili espressivi o artistici.

Krea 2 Large

Più del doppio della dimensione di Medium, con un post-addestramento più leggero – che conferisce ai suoi output un carattere più grezzo, più testurizzato e flessibile. Large è il modello più potente in generale – al meglio produce risultati che Medium non può eguagliare. Gestisce bene stili espressivi e artistici, e brilla nel fotorealismo e negli aspetti "grezzi" come sfocature di movimento, grana o gamme dinamiche basse.

Funzionalità ed esempi

Abbiamo compilato questa lista di esempi che puoi usare per testare le capacità del modello.

Diversità estetica

La maggior parte dei modelli di immagini gestisce bene prompt complessi, ma tende a deludere sullo stile — preferendo qualcosa di nitido, levigato e "sicuro". Questo restringe la gamma creativa effettivamente ottenibile.

Con Krea 2, abbiamo dedicato tanto impegno a come il modello comprende lo stile quanto a come comprende i prompt. Il risultato è un modello che può rendere una vasta gamma di estetiche – espressive, grezze, di nicchia, sperimentali – senza cadere in look da IA.

Di seguito una serie di esempi creati con Krea 2 che mostrano varie estetiche:

"illustrazione di un gatto che va in bicicletta"

Modello: Krea 2 Large

Trasferimento di stile

Krea 2 include il sistema di trasferimento di stile più potente sul mercato. Fornisci un'immagine di riferimento singola o combinane diverse, e Krea 2 estrarrà lo stile e lo applicherà al tuo output — permettendoti di decidere quanto ogni riferimento influenzi l'immagine finale.

I seguenti sono stati generati usando riferimenti di stile:

"un gatto che salta di lato"

Creatività

La creatività è un parametro reale che puoi regolare per Krea 2. Quando un prompt è breve o vago, il modello può completare i pezzi mancanti — stile, composizione, angolo di ripresa, palette di colori — aggiungendo profondità visiva dove non hai specificato nulla. Il parametro creativity controlla quanto questa espansione si spinge.

Impostalo su high e l'espansione è più forte — il modello prende più libertà creativa con stile, atmosfera ed estetica. Impostalo su low e il modello si attiene più strettamente al prompt. Impostalo su raw e il modello non espande affatto, rendendo solo ciò che hai descritto esplicitamente.

I seguenti esempi sono stati creati con creativity impostato su medium:

"fermo immagine cinematografico, scena drammatica"

Modello: Krea 2 Large

Moodboard

Un moodboard è il modo più preciso per impostare una direzione visiva con Krea 2. I moodboard sono composti da un gruppo di immagini che condividono una direzione creativa complessiva — palette, texture, stile, atmosfera o composizione. Puoi crearne uno in Krea e usarlo come riferimento quando esegui inferenze tramite questa API.

I seguenti esempi mostrano come attivare un moodboard possa trasformare l'output anche di prompt molto semplici.

Moodboard Analog Neon Glitchwave

"una balena volante con piccoli pesci che nuotano intorno a lei nell'aria"

Modello: Krea 2 Large

Configurazione API

Genera un token API dalle impostazioni del tuo account Krea. Krea 2 ha due versioni del modello disponibili nell'API:

Endpoint

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

Parametri

Entrambe le versioni di Krea 2 supportano i seguenti parametri.

Recupero lavori completati

I lavori completati possono essere recuperati da: https://api.krea.ai/jobs/{job_id}. Puoi anche passare un header X-Webhook-URL per ricevere una POST quando il lavoro è completato.

Documentazione API più dettagliata è disponibile su https://docs.krea.ai/developers/introduction. Copre il ciclo di vita dei lavori, integrazioni webhook, generazione di token API, ecc.

Esempi API

Di seguito trovi una serie di brevi guide che ti mostrano come usare tutte le diverse funzionalità di Krea 2:

Genera un'immagine

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(`Impossibile recuperare il lavoro: ${response.status}`);
    }

    const job = await response.json();

    if (job.status === "completed") return job;
    if (job.status === "failed" || job.status === "canceled") {
      throw new Error(`Lavoro ${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: "Una foto prodotto cinematografica di una lampada di vetro su un tavolo di marmo",
    aspect_ratio: "4:5",
    resolution: "1K",
    creativity: "low"
  })
});

if (!response.ok) {
  throw new Error(`Generazione fallita: ${response.status}`);
}

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

console.log(completedJob.result.urls);

Usa il trasferimento di stile

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(`Impossibile recuperare il lavoro: ${response.status}`);
    }

    const job = await response.json();

    if (job.status === "completed") return job;
    if (job.status === "failed" || job.status === "canceled") {
      throw new Error(`Lavoro ${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", "Riferimento di stile per Krea 2");

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

if (!uploadResponse.ok) {
  throw new Error(`Upload fallito: ${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: "Un ritratto di un ballerino in uno studio tranquillo",
    aspect_ratio: "4:3",
    resolution: "1K",
    creativity: "medium",
    image_style_references: [
      {
        url: asset.image_url,
        strength: 0.6
      }
    ]
  })
});

if (!generationResponse.ok) {
  throw new Error(`Generazione fallita: ${generationResponse.status}`);
}

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

console.log(completedJob.result.urls);

Regola il pensiero creativo

Usa la creatività per controllare quanto letteralmente Krea 2 segue il prompt.

• raw: prompt grezzo
• low: vicino al prompt
• medium: bilanciato, predefinito
• high: interpretazione più espressiva

Usa i moodboard

Dopo aver creato un moodboard nell'app web Krea, puoi usarlo nell'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: "Un'immagine per una campagna di una nuova collezione di lampade da esterno",
    aspect_ratio: "16:9",
    resolution: "1K",
    creativity: "high",
    moodboards: [
      {
        id: "your-moodboard-id",
        strength: 0.35
      }
    ]
  })
});

const job = await response.json();

Prezzi

Nota: combinare moodboard con riferimenti di stile non aumenta il prezzo per generazione, cioè sarà $0.04 per Medium e $0.07 per Large.