Clé API Flux : tarifs, offre gratuite et docs Black Forest Labs

Comment ouvrir un compte Black Forest Labs et créer vos identifiants API Flux, ce que coûtent les crédits à 0,01 $ l’unité, le prix par image de FLUX.1, FLUX.2 et FLUX 3, s’il existe une offre gratuite, les limites de débit à prendre en compte et une requête Python fonctionnelle.

Clé API Flux : tarifs, offre gratuite et docs Black Forest Labs
Cristian Da Conceicao
Fondateur de Picasso IA

Vous avez cherché une clé API Flux parce que vous voulez générer des images depuis du code, et vous voulez connaître le prix avant d’enregistrer une carte bancaire. Logique. Black Forest Labs vend Flux via une API à crédits, et les réponses sur les tarifs, l’usage gratuit et les limites sont réparties entre plusieurs pages de documentation. Cet article les rassemble en un seul endroit, à partir de la documentation officielle telle qu’elle était consultée en octobre 2026.

En bref : 1 crédit équivaut à 0,01 $, vous payez par image (ou par seconde de vidéo), la documentation n’annonce aucun crédit gratuit pour les nouveaux comptes, et le plafond par défaut est de 24 tâches actives simultanément. La suite de cette page montre comment ces éléments se traduisent concrètement, avec un tableau de tous les prix actuels et une requête que vous pouvez lancer dès aujourd’hui.

Un développeur barbu tapant sur un ordinateur portable, assis près d’une fenêtre de café sous la pluie

💡 Les prix évoluent. Tous les chiffres proviennent de la page tarifaire et du centre d’aide de Black Forest Labs. Vérifiez la page en ligne avant de budgéter un gros projet, car de nouveaux modèles et de nouveaux niveaux de résolution apparaissent souvent.

Configurer votre compte Black Forest Labs

Tout commence sur dashboard.bfl.ai. Le compte, les identifiants et la facturation s’y trouvent, et la configuration prend environ cinq minutes.

Créer le compte

Ouvrez le tableau de bord, cliquez sur Login, et inscrivez-vous avec une adresse e-mail et un mot de passe, ou avec Google. L’inscription crée automatiquement une Default Organization et un Default Project, donc il n’y a rien d’autre à configurer. L’organisation contient votre facturation et votre solde de crédits. Le projet contient vos identifiants API. Si vous répartissez plus tard le travail entre clients ou produits, vous pouvez ajouter des projets sans ouvrir un second compte.

Générer et conserver le secret

Dans votre projet, allez dans API, puis Keys, et cliquez sur Add Key. Donnez-lui un nom descriptif, par exemple production-images. La clé API complète n’est affichée qu’une seule fois, copiez-la donc directement dans un gestionnaire de mots de passe ou une variable d’environnement. Trois bonnes habitudes vous éviteront bien des ennuis :

  • Gardez le secret hors de Git et hors du code du navigateur. Quiconque le détient peut dépenser vos crédits.
  • Créez un identifiant par environnement, pour que la révocation d’un secret de préproduction ne casse jamais la production.
  • Envoyez-le dans l’en-tête x-key de chaque requête, exactement comme le fait l’exemple plus loin dans cet article.

Gros plan en contre-plongée sur les mains d’un développeur posées sur un clavier mécanique

Ajouter des crédits avant d’appeler l’API

Les requêtes échouent sans solde, alors commencez par alimenter le compte. Dans la barre latérale, allez dans API, puis Credits, cliquez sur Add Credits et choisissez un montant. Stripe gère le paiement, et les crédits sont disponibles immédiatement. La documentation n’indique aucun minimum pour un achat manuel.

La recharge automatique est facultative. Le seuil de déclenchement doit être d’au moins 5 $, et l’objectif de recharge doit se situer d’au moins 10 $ au-dessus de ce seuil. Si un débit automatique échoue, la recharge automatique se désactive d’elle-même jusqu’à ce que vous la réactiviez. Vérifiez donc les coordonnées de votre carte avant une longue exécution sans surveillance.

Ce que coûte Flux par image

Black Forest Labs applique trois modes de tarification en parallèle. Les anciens modèles FLUX.1 facturent un nombre fixe de crédits par image. La famille FLUX.2 facture au mégapixel. Les nouveaux modèles FLUX 3 facturent selon le niveau de résolution ou, pour la vidéo, à la seconde. Le playground est facturé au même tarif que l’API, donc tester dans le navigateur n’est pas une astuce pour éviter les frais.

Vue de dessus de factures, d’une calculatrice et d’un carnet posés sur un bureau en noyer

Tarifs fixes en crédits de FLUX.1

Ce sont les plus simples à budgéter, car une requête coûte le même prix quelle que soit la taille prise en charge.

ModèleCréditsPrix par image
Flux 1.1 Pro40,04 $
Flux 1.1 Pro Ultra (Ultra et Raw)60,06 $
Flux Kontext Pro40,04 $
Flux Kontext Max80,08 $
Flux Fill Pro50,05 $

Kontext est la gamme d’édition : vous envoyez une image accompagnée d’une instruction, et elle modifie ce que vous décrivez. Fill Pro gère l’inpainting et l’outpainting.

Tarification FLUX.2 au mégapixel

Les prix de FLUX.2 commencent bas et augmentent avec la résolution : le premier mégapixel coûte un tarif fixe, et chaque mégapixel supplémentaire s’ajoute au total. Les chiffres ci-dessous sont les prix de départ.

ModèleTexte vers imageÉdition d’image
Flux 2 Klein 4Bà partir de 0,014 $à partir de 0,014 $
Flux 2 Klein 9Bà partir de 0,015 $à partir de 0,015 $
Flux 2 Proà partir de 0,03 $à partir de 0,045 $
Flux 2 Flexà partir de 0,05 $à partir de 0,05 $
Flux 2 Maxà partir de 0,07 $à partir de 0,07 $
Flux 2 DevLocal uniquementLocal uniquement

Klein 4B et 9B forment la paire économique, Pro est le choix habituel pour la production, et Max se situe en haut de la grille tarifaire. Flux 2 Dev n’a pas de prix d’API, car la documentation le classe comme local uniquement.

Un photographe ajustant une softbox à côté d’un flacon de parfum dans un petit studio produit

Tarifs images et vidéo de FLUX 3

FLUX 3 répartit la tarification des images selon la taille de sortie.

Niveau de sortieTaille approximativePrix par image
768sq768 x 768 pixels0,041 $
1kenviron 1 mégapixel0,048 $
2kenviron 4 mégapixels0,100 $
4kenviron 16 mégapixels0,607 $

La vidéo est facturée à la seconde. La génération de texte vers vidéo et d’image vers vidéo va de 0,17 $ à 0,80 $ par seconde pour un rendu complet, tandis qu’un rendu brouillon coûte 0,06 $ par seconde. Un brouillon de 5 secondes coûte donc 0,30 $, et un rendu complet de 5 secondes coûte au moins 0,85 $. Vous pouvez essayer Flux 3 comme modèle de texte vers vidéo sur PicassoIA avant de vous engager sur ses tarifs API.

Existe-t-il une vraie offre gratuite ?

Une jeune femme étudiant avec un ordinateur portable et un carnet à une longue table de bibliothèque en chêne

Réponse courte : pas d’offre que la documentation annonce.

Ce que disent vraiment les docs

La page tarifaire commence par une règle unique : 1 crédit équivaut à 0,01 $, paiement par image, même prix pour l’API et le playground. Elle ne mentionne aucun crédit à l’inscription, aucun forfait gratuit mensuel ni aucun essai. Les pages sur les crédits et la facturation ne disent rien non plus sur les crédits d’essai. Les comparateurs de prix indépendants arrivent à la même conclusion : il n’existe pas d’offre gratuite classique. Si une promotion est en cours, vérifiez votre tableau de bord après inscription, car aucune n’est documentée.

Prévoyez donc un petit premier dépôt. Une recharge de 10 $ achète 1 000 crédits. Cela représente 250 images avec Flux 1.1 Pro à 4 crédits chacune, ou plus de 700 images avec Flux 2 Klein 4B à 0,014 $ chacune.

💡 Testez d’abord le moins cher. Lancez vos modèles de prompts sur le modèle le moins cher avant de dépenser des crédits sur Max ou Ultra. Un mauvais prompt coûte le même prix sur tous les modèles.

Les options gratuites qui existent

Trois solutions permettent d’éviter de payer Black Forest Labs par image :

  • Auto-hébergement des poids ouverts. Flux 2 Klein 4B et Flux Schnell sont des modèles à poids ouverts : vous pouvez les exécuter sur votre propre matériel sans frais par image, dans les limites de leurs licences. Vous payez alors votre propre GPU, et la licence varie selon le modèle, donc consultez la fiche de chacun. Flux 2 Dev est listé comme local uniquement, et ses poids sont sous licence non commerciale : lisez-la avant de l’utiliser dans un produit payant.
  • Utiliser un outil hébergé dans le navigateur. PicassoIA exécute les modèles Flux dans le navigateur, sans configuration d’API. Sa page Flux 2 Pro présente le modèle comme gratuit, en ligne et ne nécessitant aucune connaissance en programmation.
  • Prototyper sur le modèle payant le moins cher. À 0,014 $ par image, quelques centaines d’essais coûtent moins qu’un café.

Limites de débit et URL des résultats

Vue à hauteur des yeux d’une allée de centre de données bordée de baies de serveurs grises

Deux règles encadrent chaque intégration : combien de tâches peuvent tourner en même temps, et combien de temps vous avez pour récupérer le résultat.

24 tâches actives par défaut

La limite de concurrence correspond au nombre de requêtes qu’un compte peut avoir en cours à un instant donné. Par défaut, elle est de 24 tâches actives. Deux modèles ont des plafonds plus stricts : flux-kontext-max est limitée à 6 tâches actives, et la vidéo FLUX 3 commence à 5 tâches vidéo simultanées. Des limites plus élevées sont possibles si vous contactez le support de Black Forest Labs.

Lorsque vous dépassez la limite, l’API répond par HTTP 429. Rien n’est perdu : attendez qu’une de vos tâches précédentes se termine, puis renvoyez la requête. Dans le code, cela signifie un sémaphore plafonné un peu en dessous de 24 et une nouvelle tentative avec backoff sur un 429. La limite compte les tâches encore en cours, et non les requêtes par seconde : un modèle plus rapide vous permet donc de faire passer plus d’images sous le même plafond.

Dix minutes pour télécharger

La réponse à votre premier POST contient un id et une polling_url. Utilisez cette URL, et non une que vous construisez vous-même, surtout sur le point de terminaison global api.bfl.ai ou sur les points régionaux, api.eu.bfl.ai et api.us.bfl.ai. Interrogez le statut jusqu’à ce qu’il affiche Ready, Error ou Failed.

L’URL signée d’un résultat prêt n’est valable que 10 minutes. Téléchargez le fichier et copiez-le dans votre propre stockage, comme S3 ou R2, dès que le statut passe à Ready. Si votre worker est hors service à la fin de la tâche, la sortie expire et vous devez régénérer l’image.

Faire votre première requête

Voici un script Python minimal utilisant le point de terminaison de Flux 1.1 Pro, qui coûte 4 crédits (0,04 $) par image. Définissez d’abord BFL_API_KEY dans votre environnement.

import os, time, requests

BASE = "https://api.bfl.ai/v1"
HEADERS = {"x-key": os.environ["BFL_API_KEY"], "accept": "application/json"}

job = requests.post(
    f"{BASE}/flux-pro-1.1",
    headers=HEADERS,
    json={
        "prompt": "A ceramic perfume bottle on a white table, soft window light",
        "width": 1024,
        "height": 768,
    },
).json()

while True:
    result = requests.get(job["polling_url"], headers=HEADERS).json()
    if result["status"] == "Ready":
        break
    if result["status"] in ("Error", "Failed"):
        raise RuntimeError(result)
    time.sleep(1)

image = requests.get(result["result"]["sample"]).content
open("bottle.jpg", "wb").write(image)

Le script envoie une tâche, lit le polling_url dans la réponse, vérifie le statut une fois par seconde et enregistre l’image avant l’expiration de l’URL signée. Pour utiliser un autre modèle, remplacez le chemin du point de terminaison par celui indiqué pour ce modèle dans la référence API sur docs.bfl.ai. La référence API documente aussi un appel qui renvoie vos crédits restants, ce qui vaut la peine d’être lancé avant tout gros lot.

Maîtriser les coûts à grande échelle

Trois collègues autour d’un tableau blanc en train de planifier le budget d’un projet

De petites différences par image deviennent de vraies sommes à grande échelle. Le tableau montre ce que coûtent 1 000 images à chaque prix de départ.

Choisir le modèle le moins cher qui fonctionne

ModèlePrix par imagePour 1 000 images
Flux 2 Klein 4B0,014 $14 $
Flux 2 Klein 9B0,015 $15 $
Flux 2 Proà partir de 0,03 $30 $
Flux 1.1 Pro0,04 $40 $
Flux Kontext Pro0,04 $40 $
Image FLUX 3, 1k0,048 $48 $
Flux 2 Flexà partir de 0,05 $50 $
Flux 1.1 Pro Ultra0,06 $60 $
Flux 2 Maxà partir de 0,07 $70 $
Flux Kontext Max0,08 $80 $

Une méthode raisonnable consiste à générer les brouillons avec un modèle Klein, puis à régénérer seulement les meilleurs résultats sur Pro ou Max. Pour les retouches, commencez par Kontext Pro et passez à Kontext Max seulement si le résultat l’exige. Kontext Max a aussi la limite de concurrence la plus stricte, il convient donc mal aux traitements en masse.

Budgéter avant de lancer les lots

Les requêtes par lot multiplient le coût de base par le nombre d’images : 200 images sur Flux 1.1 Pro coûtent 200 fois 0,04 $, soit 8 $. Les crédits sont rattachés au niveau de l’organisation et partagés entre ses projets, donc séparer les projets ne donne pas des budgets distincts. N’activez la recharge automatique qu’après avoir fixé un plafond de dépense que vous pouvez vous permettre de perdre à cause d’une boucle incontrôlée, et vérifiez le solde de crédits au début de chaque gros lot.

Flux 2 Pro sur PicassoIA

Un graphiste examinant une grille de photos de paysages sur un grand écran

Si vous voulez des images plutôt qu’une intégration, vous pouvez vous passer de la configuration du compte, des crédits et du code. PicassoIA héberge Flux 2 Pro dans le navigateur, et accepte jusqu’à huit images de référence en plus de votre prompt.

Comment utiliser Flux 2 Pro

Voici comment utiliser Flux 2 Pro sur PicassoIA, étape par étape :

  1. Ouvrez la page Flux 2 Pro sur PicassoIA.
  2. Rédigez votre prompt. C’est le seul champ obligatoire. Nommez le sujet, la lumière et l’objectif, comme dans « un flacon de parfum en céramique sur une table blanche, lumière douce de fenêtre, objectif 85mm ».
  3. Ajoutez éventuellement jusqu’à 8 images de référence (JPEG, PNG, GIF ou WebP) pour orienter le style, le sujet ou la composition. Faites-y référence dans le prompt sous les noms image 1, image 2, et ainsi de suite.
  4. Choisissez un format et une résolution. La valeur par défaut est 1 MP, et la page du modèle recommande 2 MP ou moins.
  5. Sélectionnez le format de sortie et la qualité, puis lancez la génération.
  6. Enregistrez le résultat qui vous plaît, et réutilisez son seed si vous voulez le reproduire plus tard.

Conseils de paramètres qui comptent

ParamètrePar défautConseil
Format1:1Choisissez 16:9 pour les bannières de blog, 9:16 pour les stories, ou une taille personnalisée
Résolution1 MPJusqu’à 4 MP est possible, mais 2 MP ou moins est recommandé
Images d’entréeAucuneMaximum 8, mélangez des références de style et de sujet
Format de sortieWebPUtilisez PNG quand vous avez besoin de fichiers sans perte
Qualité de sortie80Augmentez-la pour l’impression, baissez-la pour des pages plus rapides
Tolérance de sécurité21 est le plus strict et 5 le plus permissif
SeedAléatoireDéfinissez-le pour reproduire un résultat à l’identique

La largeur et la hauteur personnalisées doivent être des multiples de 32, et la plus grande sortie fait 2048 x 2048 pixels : les formats très larges n’atteindront donc pas les 4 MP complets.

Autres modèles Flux à essayer

Essayez Flux sur PicassoIA dès aujourd’hui

Mains marquées tenant une photo fraîchement imprimée d’un lac de montagne dans la brume

L’API de Black Forest Labs est l’outil adapté quand vous développez un produit qui appelle Flux des milliers de fois. Pour tout le reste, le moyen le plus rapide de voir ce que font ces modèles est de taper un prompt et d’observer le résultat.

Ouvrez PicassoIA, choisissez Flux 2 Pro ou n’importe quel modèle de la liste complète des modèles, et générez votre première image en quelques minutes. Essayez le même prompt sur deux ou trois modèles, comparez les résultats côte à côte et notez celui qui en vaut le prix. Une fois que vous savez quel modèle convient à votre travail, vous saurez aussi quel point de terminaison API budgéter.

Partager cet article

Choisissez votre langue