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.
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.
💡 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.
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.
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.
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.
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.
Tarifs images et vidéo de FLUX 3
FLUX 3 répartit la tarification des images selon la taille de sortie.
Niveau de sortie
Taille approximative
Prix par image
768sq
768 x 768 pixels
0,041 $
1k
environ 1 mégapixel
0,048 $
2k
environ 4 mégapixels
0,100 $
4k
environ 16 mégapixels
0,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 ?
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
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
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.
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
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 :
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 ».
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.
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.
Sélectionnez le format de sortie et la qualité, puis lancez la génération.
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ètre
Par défaut
Conseil
Format
1:1
Choisissez 16:9 pour les bannières de blog, 9:16 pour les stories, ou une taille personnalisée
Résolution
1 MP
Jusqu’à 4 MP est possible, mais 2 MP ou moins est recommandé
Images d’entrée
Aucune
Maximum 8, mélangez des références de style et de sujet
Format de sortie
WebP
Utilisez PNG quand vous avez besoin de fichiers sans perte
Qualité de sortie
80
Augmentez-la pour l’impression, baissez-la pour des pages plus rapides
Tolérance de sécurité
2
1 est le plus strict et 5 le plus permissif
Seed
Aléatoire
Dé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.
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.