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 guia-o pelo fluxo completo, desde o envio de um pedido de geração até à obtenção da imagem final.
A geração de imagens é assíncrona. Receberá imediatamente um ID de tarefa e, em seguida, deverá consultar o estado até a imagem estar pronta.

​
Playground interativo

Aqui está um exemplo completo em várias 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 marcador YOUR_API_TOKEN nos exemplos acima, terá de gerar um token de API em krea.ai/settings/api-tokens. Siga as instruções na página Chaves de API e faturação se precisar de ajuda.
Para encontrar todos os modelos disponíveis, consulte a página APIs de modelos.

​
Detalhe

De seguida, vamos guiá-lo através do fluxo completo, desde o envio de um pedido de geração até à obtenção da imagem final.

​
Passo 1: Criar uma tarefa de geração de imagem

Faça um pedido POST para /generate/image/bfl/flux-1-dev com o seu prompt e parâmetros. A API devolve imediatamente um ID de tarefa — 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: Consultar os resultados

Consulte /jobs/{job_id} a cada 2 segundos até a tarefa terminar. A Krea API fornece resultados intermédios 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 as tarefas terminarem. Consulte o guia de Webhooks para começar.
Para uma lista detalhada dos parâmetros de todos os modelos, consulte a página APIs de modelos.
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 saber mais sobre todos os estados possíveis das tarefas e o ciclo de vida completo, consulte a página Ciclo de vida das tarefas.