Skip to main content

​
Modelos populares

​
Visão geral

Gere imagens a partir de descrições em texto usando Flux, Nano Banana Pro e outros modelos de IA de última geração. Este exemplo apresenta o fluxo completo, do envio da requisição de geração até a obtenção da imagem final.
A geração de imagens é assíncrona. Você receberá um ID de job imediatamente e, em seguida, faz polling dos resultados até a imagem ficar pronta.

​
Playground interativo

Aqui está um exemplo completo em diferentes linguagens: 
// 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/bfl/flux-1-dev", {
  input: {
    prompt: "a serene mountain landscape at sunset",
    width: 1024,
    height: 576,
    steps: 28
  }
});

console.log(`Image ready: ${result.data?.urls[0]}`);
Substitua pelo seu token de APIPara substituir o placeholder YOUR_API_TOKEN nos exemplos acima, gere um token de API em krea.ai/settings/api-tokens. Siga as instruções da página API Keys & Billing se precisar de ajuda.
Para ver todos os modelos disponíveis, acesse a página Model APIs.

​
Detalhamento

Abaixo, apresentamos o fluxo completo do envio da requisição de geração até a obtenção da imagem final.

​
Passo 1: Criar um job de geração de imagem

Faça uma requisição POST para /generate/image/bfl/flux-1-dev com seu prompt e parâmetros. A API retorna um ID de job imediatamente — a geração acontece de forma assíncrona. 
// npm install @krea-ai/sdk
import { Krea } from "@krea-ai/sdk";

const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

const job = await krea.image("bfl/flux-1-dev", {
  prompt: "a serene mountain landscape at sunset",
  width: 1024,
  height: 576,
  steps: 28
});

console.log(`Job ID: ${job.job_id}`);
Exemplo de resposta 
{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued",
  "created_at": "2025-01-15T10:30:00.000Z"
}

​
Passo 2: Fazer polling dos resultados

Faça polling em /jobs/{job_id} a cada 2 segundos até o job concluir. A Krea API fornece saídas intermediárias de geração para alguns modelos. 
// npm install @krea-ai/sdk
import { Krea } from "@krea-ai/sdk";

const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

async function waitForJob(jobId) {
  const completed = await krea.jobs.wait(jobId, { intervalMs: 2000 });
  return completed.result.urls[0];
}

const imageUrl = await waitForJob(job.job_id);
console.log(`Image ready: ${imageUrl}`);
Webhooks disponíveis!Configure webhooks para receber notificações quando os jobs forem concluídos. Consulte o guia de Webhooks para começar.
Para uma lista detalhada dos parâmetros de todos os modelos, consulte a página Model APIs.
Exemplo de resposta concluída 
{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "created_at": "2025-01-15T10:30:00.000Z",
  "completed_at": "2025-01-15T10:30:25.000Z",
  "result": {
    "urls": [
      "https://krea.ai/generations/your-image.png"
    ]
  }
}
Para conhecer todos os possíveis status de job e o ciclo de vida completo, veja a página Ciclo de vida do job.