Skip to main content

​
Modelli popolari

​
Panoramica

Genera immagini a partire da descrizioni testuali usando Flux, Nano Banana Pro e altri modelli di IA all’avanguardia. Questo esempio ti guida attraverso il flusso completo, dalla richiesta di generazione al recupero dell’immagine finale.
La generazione di immagini è asincrona. Riceverai immediatamente un job ID, poi effettuerai polling per i risultati finché l’immagine non è pronta.

​
Playground interattivo

Ecco un esempio completo in diversi linguaggi: 
// 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]}`);
Sostituisci con il tuo token APIPer sostituire il segnaposto YOUR_API_TOKEN negli esempi qui sopra, dovrai generare un token API su krea.ai/settings/api-tokens. Segui le istruzioni nella pagina Chiavi API e fatturazione se hai bisogno di aiuto.
Per trovare tutti i modelli disponibili, consulta la pagina Model APIs.

​
Approfondimento

Di seguito ti guidiamo attraverso il flusso completo, dall’invio della richiesta di generazione al recupero dell’immagine finale.

​
Step 1: Crea un job di generazione immagine

Effettua una richiesta POST a /generate/image/bfl/flux-1-dev con il tuo prompt e i parametri. L’API restituisce immediatamente un job ID — la generazione avviene in modo asincrono. 
// 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}`);
Esempio di risposta 
{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued",
  "created_at": "2025-01-15T10:30:00.000Z"
}

​
Step 2: Effettua il polling per i risultati

Effettua polling su /jobs/{job_id} ogni 2 secondi finché il job non si completa. La Krea API fornisce output intermedi di generazione per alcuni modelli. 
// 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}`);
Webhook disponibili!Configura i webhook per ricevere notifiche al completamento dei job. Consulta la guida ai Webhook per iniziare.
Per l’elenco dettagliato dei parametri di tutti i modelli, consulta la pagina Model APIs.
Esempio di risposta completata 
{
  "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"
    ]
  }
}
Per conoscere tutti gli stati possibili dei job e l’intero ciclo di vita, consulta la pagina Ciclo di vita del job.