Skip to main content

​
Modelos populares

​
Descripción general

Genera imágenes a partir de descripciones de texto usando Flux, Nano Banana Pro y otros modelos de IA de última generación. Este ejemplo te guía por el flujo completo, desde enviar una solicitud de generación hasta obtener la imagen final.
La generación de imágenes es asíncrona. Recibirás un ID de trabajo de inmediato y luego consultarás el estado hasta que la imagen esté lista.

​
Playground interactivo

Aquí tienes un ejemplo completo en diferentes lenguajes: 
// 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]}`);
Reemplaza con tu token de APIPara reemplazar el marcador YOUR_API_TOKEN de los ejemplos anteriores, necesitarás generar un token de API en krea.ai/settings/api-tokens. Sigue las instrucciones de la página API Keys & Billing si necesitas ayuda.
Para ver todos los modelos disponibles, consulta la página de Model APIs.

​
Desglose

A continuación, te guiaremos por el flujo completo, desde enviar una solicitud de generación hasta obtener la imagen final.

​
Paso 1: Crear un trabajo de generación de imagen

Realiza una solicitud POST a /generate/image/bfl/flux-1-dev con tu prompt y parámetros. La API devuelve un ID de trabajo de inmediato — la generación ocurre de forma así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}`);
Ejemplo de respuesta 
{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued",
  "created_at": "2025-01-15T10:30:00.000Z"
}

​
Paso 2: Consultar los resultados

Consulta /jobs/{job_id} cada 2 segundos hasta que el trabajo se complete. La API de Krea ofrece salidas intermedias de generación para algunos 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 disponibles!Configura webhooks para recibir notificaciones cuando los trabajos se completen. Consulta la guía de Webhooks para comenzar.
Para ver la lista detallada de parámetros de todos los modelos, consulta la página de Model APIs.
Ejemplo de respuesta completada 
{
  "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 aprender sobre todos los posibles estados de trabajo y el ciclo de vida completo, consulta la página Job Lifecycle.