API Krea 2

Krea 2 é nosso primeiro modelo base de imagem, treinado completamente do zero para dar aos usuários controle total sobre a aparência, sensação e direção criativa de cada imagem que criam.

A partir de hoje, você pode acessar o Krea 2 através de nossos parceiros de API, como Fal, Comfy ou Runware. Também estamos lançando com a Nous Research, oferecendo acesso ao Hermes desde o dia 0, e você pode encontrar suporte para Claude, OpenClaw e Codex em nossa documentação.

Aqui está o que ele oferece:\

• Diversidade estética – Krea 2 pode gerar uma gama incrivelmente ampla de estilos, com força particular em direções artísticas e expressivas que outros modelos tendem a nivelar.
• Transferência de estilo – Krea 2 vem com o sistema de transferência de estilo mais avançado disponível. Ele pode extrair o estilo de uma ou várias imagens de referência e aplicá-lo às suas saídas com precisão.
• Criatividade – este é um parâmetro real que você pode ajustar com o Krea 2. Em valores altos, ele faz o modelo adicionar profundidade estética, interpretação e riqueza visual ao que você fornecer.
• Moodboards – você pode passar um moodboard inteiro com dezenas de imagens e o Krea 2 entenderá a direção criativa geral, produzindo saídas alinhadas a ela.

Encontre centenas de exemplos com seus respectivos prompts clicando no link abaixo:

Construímos o Krea 2 para criativos que querem controle real sobre o que a IA produz. Trabalhamos de perto com equipes de estúdios criativos, agências de marketing e publicidade, moda, jogos e arquitetura — levando continuamente o feedback deles para nosso laboratório de pesquisa para aprimorar o modelo para cada caso de uso. É um modelo que evolui ativamente com as pessoas que o utilizam.

Também foi feito para exploração. Você nem sempre chega com uma ideia totalmente formada, e o Krea 2 foi projetado para ser um colaborador criativo nesses momentos — algo que pode pegar uma direção vaga e devolver visuais que inspiram a próxima ideia, em vez de forçar você a especificar cada detalhe desde o início.

Variantes do modelo

A API Krea 2 oferece duas variantes do modelo: Krea 2 Medium e Krea 2 Large. Ambos suportam os mesmos parâmetros e conjunto de recursos — as diferenças estão no tamanho do modelo, estágio de treinamento e no caráter das saídas que produzem.

Se não souber por qual começar, experimente o Krea 2 Medium — é mais rápido, mais barato e lida com a maior variedade de casos de uso de forma confiável.

Krea 2 Medium

Um modelo menor, mais rápido e mais econômico com pós-treinamento extensivo aplicado. Isso torna suas saídas especialmente estáveis e consistentes entre gerações. O Medium é particularmente forte em ilustração, anime, pintura e outros estilos expressivos ou artísticos.

Krea 2 Large

Mais que o dobro do tamanho do Medium, com um pós-treinamento mais suave – o que dá às suas saídas um caráter mais bruto, texturizado e flexível. O Large é o modelo mais poderoso no geral – em seu melhor, produz resultados que o Medium não consegue igualar. Ele lida bem com estilos expressivos e artísticos, e brilha em fotorrealismo e visuais "brutos" como borrões de movimento, grãos ou baixos alcances dinâmicos.

Recursos & Exemplos

Compilamos esta lista de exemplos que você pode usar para testar as capacidades do modelo.

Diversidade estética

A maioria dos modelos de imagem lida bem com prompts complexos, mas tende a falhar no estilo — padrão para algo nítido, polido e "seguro". Isso limita o alcance criativo que você pode realmente obter deles.

Com o Krea 2, colocamos tanto esforço em como o modelo entende estilo quanto em como entende prompts. O resultado é um modelo que pode renderizar uma ampla gama de estéticas – expressivas, cruas, nicho, experimentais – sem cair em visuais típicos de IA.

A seguir, um conjunto de exemplos criados com Krea 2 mostrando uma variedade de estéticas:

"ilustração de um gato andando de bicicleta"

Modelo: Krea 2 Large

Transferência de estilo

Krea 2 vem com o sistema de transferência de estilo mais poderoso do mercado. Passe uma única imagem de referência ou combine várias, e o Krea 2 extrairá o estilo e aplicará à sua saída — permitindo que você decida a força com que cada referência molda a imagem final.

Os seguintes foram gerados usando referências de estilo:

"um gato pulando de lado"

Criatividade

Criatividade é um parâmetro real que você pode ajustar para o Krea 2. Quando um prompt é curto ou vago, o modelo pode preencher as peças faltantes — estilo, composição, ângulo da câmera, paleta de cores — adicionando profundidade visual onde você não especificou. O parâmetro creativity controla até onde essa expansão vai.

Defina como high e a expansão fica mais forte — o modelo toma mais liberdades criativas com estilo, humor e estética. Defina como low e o modelo segue mais de perto o que está no seu prompt. Defina como raw e o modelo não faz nenhuma expansão, renderizando apenas o que você descreveu explicitamente.

Os exemplos a seguir foram criados com creativity definido como medium:

"cena cinematográfica, cena dramática"

Modelo: Krea 2 Large

Moodboards

Um moodboard é a forma mais precisa de definir uma direção visual com o Krea 2. Moodboards são construídos a partir de um grupo de imagens que compartilham uma direção criativa geral — paleta, textura, estilo, humor ou composição. Você pode criar um no Krea e referenciá-lo ao executar inferência por esta API.

Os exemplos a seguir mostram como ativar um moodboard pode transformar a saída mesmo de prompts muito simples.

Moodboard Analog Neon Glitchwave

"uma baleia voadora com pequenos peixes nadando ao redor dela no ar"

Modelo: Krea 2 Large

Configuração da API

Crie um token de API nas configurações da sua conta Krea. O Krea 2 tem duas versões do modelo disponíveis na 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

Parâmetros

Ambas as versões do Krea 2 suportam os seguintes parâmetros.

Buscar trabalhos concluídos

Trabalhos concluídos podem ser buscados em: https://api.krea.ai/jobs/{job_id}. Você também pode passar um cabeçalho X-Webhook-URL para receber um POST quando o trabalho for concluído.

Documentação mais detalhada da API está disponível em https://docs.krea.ai/developers/introduction. Cobre coisas como ciclo de vida do trabalho, integrações webhook, geração de tokens de API, etc.

Exemplos de API

Abaixo você encontra um conjunto de guias curtos que mostram como usar todos os diferentes recursos que vêm com o Krea 2:

Gerar uma imagem

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(`Falha ao buscar trabalho: ${response.status}`);
    }

    const job = await response.json();

    if (job.status === "completed") return job;
    if (job.status === "failed" || job.status === "canceled") {
      throw new Error(`Trabalho ${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: "Uma foto cinematográfica de um produto: uma lâmpada de vidro sobre uma mesa de mármore",
    aspect_ratio: "4:5",
    resolution: "1K",
    creativity: "low"
  })
});

if (!response.ok) {
  throw new Error(`Falha na geração: ${response.status}`);
}

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

console.log(completedJob.result.urls);

Usar transferência de estilo

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(`Falha ao buscar trabalho: ${response.status}`);
    }

    const job = await response.json();

    if (job.status === "completed") return job;
    if (job.status === "failed" || job.status === "canceled") {
      throw new Error(`Trabalho ${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", "Referência de estilo para Krea 2");

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

if (!uploadResponse.ok) {
  throw new Error(`Falha no upload: ${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: "Um retrato de um dançarino em um estúdio silencioso",
    aspect_ratio: "4:3",
    resolution: "1K",
    creativity: "medium",
    image_style_references: [
      {
        url: asset.image_url,
        strength: 0.6
      }
    ]
  })
});

if (!generationResponse.ok) {
  throw new Error(`Falha na geração: ${generationResponse.status}`);
}

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

console.log(completedJob.result.urls);

Ajustar o pensamento criativo

Use o parâmetro creativity para controlar o quão literalmente o Krea 2 segue o prompt.

• raw: prompt bruto
• low: próximo ao prompt
• medium: equilibrado, padrão
• high: interpretação mais expressiva

Usar moodboards

Depois de criar um moodboard no app web Krea, você pode usá-lo na 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: "Uma imagem de campanha para uma nova coleção de lâmpadas externas",
    aspect_ratio: "16:9",
    resolution: "1K",
    creativity: "high",
    moodboards: [
      {
        id: "seu-id-do-moodboard",
        strength: 0.35
      }
    ]
  })
});

const job = await response.json();

Preços

Nota: combinar moodboards com referências de estilo não aumentará o preço por geração, ou seja, será $0.04 para Medium e $0.07 para Large.