Skip to main content

​
Modèles populaires

​
Aperçu

Générez des images à partir de descriptions textuelles en utilisant Flux, Nano Banana Pro et d’autres modèles d’IA à la pointe. Cet exemple vous guide à travers le workflow complet, depuis la soumission d’une requête de génération jusqu’à la récupération de l’image finale.
La génération d’image est asynchrone. Vous recevez immédiatement un ID de job, puis vous interrogez le statut jusqu’à ce que l’image soit prête.

​
Playground interactif

Voici un exemple complet dans différents langages : 
// 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]}`);
Remplacez par votre jeton APIPour remplacer l’espace réservé YOUR_API_TOKEN dans les exemples ci-dessus, vous devrez générer un jeton API sur krea.ai/settings/api-tokens. Suivez les instructions de la page Clés API et facturation si vous avez besoin d’aide.
Pour trouver tous les modèles disponibles, consultez la page API des modèles.

​
Détails

Ci-dessous, nous vous guidons à travers le workflow complet, depuis la soumission d’une requête de génération jusqu’à la récupération de l’image finale.

​
Étape 1 : Créer un job de génération d’image

Effectuez une requête POST vers /generate/image/bfl/flux-1-dev avec votre prompt et vos paramètres. L’API renvoie immédiatement un ID de job — la génération se déroule de manière asynchrone. 
// 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}`);
Exemple de réponse 
{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued",
  "created_at": "2025-01-15T10:30:00.000Z"
}

​
Étape 2 : Interroger les résultats

Interrogez /jobs/{job_id} toutes les 2 secondes jusqu’à ce que le job soit terminé. L’API Krea fournit des sorties de génération intermédiaires pour certains modèles. 
// 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 !Configurez des webhooks pour recevoir des notifications lorsque les jobs sont terminés. Consultez le guide des Webhooks pour commencer.
Pour une liste détaillée des paramètres de tous les modèles, consultez la page API des modèles.
Exemple de réponse terminée 
{
  "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"
    ]
  }
}
Pour en savoir plus sur tous les statuts de job possibles et le cycle de vie complet d’un job, consultez la page Cycle de vie d’un job.