CheaperGen
Black Forest LabsTutoriel

Comment utiliser l’API FLUX 3 Image Klein

Tutoriel pas à pas sur l’API FLUX 3 Image Klein avec Node.js, Python et cURL : envoyer une tâche texte en image, l’interroger ou recevoir un webhook, puis télécharger le image. L’exemple ci-dessous coûte $0,002.

Points de terminaison
2
Texte en image · Retouche d’image
Exemple de requête
$0,002
Texte en image
Langages
3
Node.js · Python · cURL
Générations échouées
$0
remboursées automatiquement
Obtenir une clé APICréer avec FLUX 3 Image KleinDocumentation API
1

Obtenir une clé API

Créez un compte, ajoutez des crédits, puis créez une clé dans Tableau de bord → Clés API. Enregistrez-la sous CHEAPERGEN_API_KEY sur votre serveur. Chaque requête la transmet comme jeton Bearer.

Comment obtenir une clé API FLUX 3 Image Klein
2

Choisissez un point de terminaison FLUX 3 Image Klein

Chaque tâche a son propre point de terminaison. Tous acceptent un corps JSON et renvoient une génération que vous pouvez interroger.

FLUX 3 Image Klein points de terminaison API, entrées obligatoires et tarifs
TâchePoint de terminaisonObligatoireÀ partir de
Texte en imagebfl/flux-3-image-klein/text-to-imageprompt$0,0011 par image
Retouche d’imagebfl/flux-3-image-klein/editprompt, image_urls$0,0011 par image
3

Envoyer une tâche texte en image

Ce programme envoie la tâche, interroge son état toutes les 3 secondes jusqu’à sa fin et affiche l’URL image. Remplacez le prompt et les paramètres par les vôtres.

const API = "https://cheapergen.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Submit the job
let job = await fetch(`${API}/run/bfl/flux-3-image-klein/text-to-image`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "Nature morte éditoriale : vase en terre cuite façonné à la main et renoncules orange séchées sur un socle en travertin, soleil bas de l’heure dorée à gauche, longues ombres douces sur un mur en plâtre chaud, photo moyen format sur pellicule",
    "aspect_ratio": "1:1",
    "resolution": "1K"
  }),
}).then((r) => r.json());

// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 3000));
  job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}

console.log(job.status === "succeeded" ? job.output.images[0].url : job.error);
4

Définissez les paramètres importants

Les paramètres de bfl/flux-3-image-klein/text-to-image, avec l’incidence de chacun sur le prix.

Paramètres Texte en image de FLUX 3 Image Klein et effet sur le prix
ParamètreType · valeur par défautDescriptionEffet sur le prix
aspect_ratiostring (enum) · 1:1Format de l’image de sortie.
1:1 · 4:5 · 3:4 · 2:3 · 9:16 · 1:2 · 9:21 · 5:4 · 4:3 · 3:2 · 16:9 · 2:1 · 21:9 · 7:5 · 5:7
1:1: $0,0011 par image
resolutionstring (enum) · 1KPaliers de taille de sortie : 768 ≈ 0.6 MP, 1K ≈ 1 MP, 1.5K ≈ 2.4 MP, 2K ≈ 4 MP, 4K ≈ 16 MP. Jusqu’à 2K, les formats larges et hauts limitent le côté le plus long à 2048 px ; le 4K utilise 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, 9:21.
768 · 1K · 1.5K · 2K · 4K
768: $0,0011 par image
1K: $0,0019 par image
1.5K: $0,0043 par image
2K: $0,0074 par image
4K: $0,0342 par image
seedintegerRéutilisez le même seed et les mêmes paramètres pour reproduire un résultat. Laissez ce champ vide pour une valeur aléatoire.Aucun
enable_safety_checkerboolean · trueSi cette option est activée, la vérification de sécurité sera appliquée. Le contenu interdit par notre politique d’utilisation acceptable reste bloqué dans tous les cas.Aucun

Les autres points de terminaison FLUX 3 Image Klein suivent la même structure, avec leurs propres entrées :

POST /api/v1/run/bfl/flux-3-image-klein/edit

{
  "prompt": "Placer la lampe de l’image 2 sur le bureau de l’image 1 ; conserver la pièce, la lumière et l’angle de caméra",
  "image_urls": [
    "https://cdn.cheapergen.com/samples/portrait.jpg"
  ],
  "aspect_ratio": "auto",
  "resolution": "1K"
}
5

Récupérer le résultat

Une tâche passe de queued à running, puis à succeeded, failed ou canceled. Interrogez GET /api/v1/generations/{id}, ou indiquez webhook_url pour que nous vous envoyions le résultat par POST. Téléchargez le résultat et stockez-le vous-même.

200 — terminée
{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "bfl/flux-3-image-klein",
  "endpoint": "bfl/flux-3-image-klein/text-to-image",
  "mode": "text-to-image",
  "status": "succeeded",
  "input": {
    "prompt": "Nature morte éditoriale : vase en terre cuite façonné à la main et renoncules orange séchées sur un socle en travertin, soleil bas de l’heure dorée à gauche, longues ombres douces sur un mur en plâtre chaud, photo moyen format sur pellicule",
    "aspect_ratio": "1:1",
    "resolution": "1K"
  },
  "output": {
    "images": [
      {
        "url": "https://cdn.cheapergen.com/outputs/gen_8c2Q-0.png",
        "content_type": "image/png",
        "width": 2048,
        "height": 2048
      }
    ]
  },
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": false,
    "official_usd": 0.264,
    "list_price_source": "official",
    "list_price_label": "Official",
    "saved_usd": 0.0385
  },
  "source": "api",
  "created_at": "2026-10-15T09:21:04Z",
  "started_at": "2026-10-15T09:21:06Z",
  "completed_at": "2026-10-15T09:22:31Z"
}
Vérifier les signatures des webhooks
6

Calculer le prix avant le lancement

Le point de terminaison de devis est gratuit et ne nécessite pas de clé. Il renvoie le prix, le prix officiel et votre remise pour exactement les paramètres que vous envoyez.

curl -X POST https://cheapergen.com/api/v1/quote/bfl/flux-3-image-klein/text-to-image \
  -H "Content-Type: application/json" \
  -d '{"prompt":"Nature morte éditoriale : vase en terre cuite façonné à la main et renoncules orange séchées sur un socle en travertin, soleil bas de l’heure dorée à gauche, longues ombres douces sur un mur en plâtre chaud, photo moyen format sur pellicule","aspect_ratio":"1:1","resolution":"1K"}'
Erreurs de l’API et marche à suivre
ÉtatCodeSignification
400invalid_requestUn paramètre manque ou dépasse les limites autorisées ; le message indique lequel.
401unauthorizedClé API manquante, mal formée ou révoquée.
402insufficient_balanceCrédits insuffisants pour le prix indiqué ; rechargez votre solde ou activez la recharge automatique.
429rate_limitedTrop de requêtes ou de générations en cours ; attendez un peu avant de réessayer.
502upstream_errorUne erreur s’est produite pendant la génération ; le montant réservé est remboursé et vous pouvez réessayer.
503model_unavailableAucune capacité n’est disponible pour le moment ; réessayez plus tard ou choisissez un autre modèle.
Documentation complète de l’API FLUX 3 Image Klein

FAQ

Questions sur l’API FLUX 3 Image Klein

Non. L’API utilise HTTPS et JSON. Les exemples Node.js (fetch) et Python (requests) de cette page sont des programmes complets. Toute langue capable d’envoyer une requête HTTP convient.

Oui. Ajoutez "webhook_url" au corps de la requête ; nous envoyons la génération terminée par POST à cette URL, avec une signature dans l’en-tête CheaperGen-Signature (HMAC-SHA256 de l’horodatage et du corps brut). Vous pouvez aussi interroger GET /api/v1/generations/{id}.

Transmettez des URL publiques dans "image_urls". Les fichiers sans URL publique peuvent d’abord être téléversés avec POST /api/v1/uploads ; l’API renvoie une URL à utiliser dans la requête.

Texte en image est proposé à partir de $0,0011 par image ; la requête d’exemple sur cette page coûte $0,002, 79 % sous le prix officiel. Les générations échouées sont automatiquement remboursées.