FLUX 3 Image : guide des cadres de mise en page et des retouches ciblées

FLUX 3 Image permet de décrire l’emplacement de chaque élément à l’aide de rectangles intégrés au prompt d’image. Le même système prend en charge les retouches d’une image de référence : pour chaque élément, on peut indiquer sa position d’origine, sa destination et ce qui doit changer. Black Forest Labs a ajouté le point de terminaison Image à ses notes de version du 1er octobre 2026.

Pour les designers et les créateurs, la distinction utile oppose la planification d’une composition entière à la modification d’un élément dans une image existante. Ce guide explique comment choisir entre les deux, convertir un rectangle en coordonnées requises et récupérer un résultat d’API. Il s’appuie uniquement sur la documentation, vérifiée le 3 octobre 2026. BIG CHANGE n’a généré ni retouché d’image avec ce produit.

Le grand changement

• Ce qui change : Dans sa version du 1er octobre, BFL documente la composition et la retouche au moyen de v1/flux-3-image. Une description de la scène et un tableau JSON des éléments tiennent dans un même prompt, les cadres précisant leur position ou les retouches à effectuer. les notes de version de BFL
• Pourquoi c’est important : Les créateurs peuvent convertir un rectangle prévu en coordonnées, puis indiquer quels éléments de référence conserver, déplacer ou remplacer. Le choix pratique porte sur le degré de précision : toute la composition, une instruction simple ou un tableau de retouche explicite. le tutoriel de BFL sur les cadres
• À surveiller : Choisissez la résolution et le budget avant l’envoi : les tarifs indiqués pour 1k et 4k sont respectivement $0.048 et $0.607 par image. Examinez le résultat complet : les éléments peuvent déborder des cadres et une retouche peut modifier l’éclairage, les ombres ou les reflets à proximité. les tarifs de BFL, les limites de retouche

Choisir entre le navigateur et l’API

La page produit de BFL décrit deux points d’entrée : dessiner les cadres dans le Playground du navigateur ou transmettre un prompt de mise en page par l’API. La documentation renvoie au Playground pour une utilisation sans code. Choisissez le navigateur si vous voulez dessiner directement les zones ; utilisez l’API si vous devez fournir des coordonnées dans une requête et récupérer le résultat par programmation. Nous n’avons pas inspecté les commandes actuelles du Playground : les instructions ci-dessous décrivent donc le format documenté de la requête, et non une séquence de boutons à cliquer.

Pour l’API, créez un compte BFL, ajoutez des crédits et obtenez une clé depuis le tableau de bord. Envoyez du JSON avec une requête POST vers https://api.bfl.ai/v1/flux-3-image, en utilisant Content-Type: application/json et la clé dans l’en-tête x-key. Seul le champ prompt est obligatoire. le guide de génération de BFL, les tarifs et la configuration

Il faut distinguer FLUX 3 Image de FLUX 3 Dev : ces instructions concernent le point de terminaison Image hébergé par BFL. La page produit d’Image propose une licence commerciale des poids, à obtenir auprès de son service commercial. Les sources consultées pour ce guide n’établissent pas qu’un téléchargement des poids de FLUX 3 Image soit disponible en accès libre. l’accès à FLUX 3 Image

Déterminer le degré de précision souhaité

BFL indique qu’une retouche simple peut recevoir automatiquement un cadre lors de l’enrichissement du prompt. Pour un contrôle explicite, fournissez votre propre tableau. Dans les instructions ordinaires, « image 1 » désigne la première référence ; dans les lignes de retouche, cette même référence est ref_image_0. le guide de retouche de BFL

Les références sont placées dans images sous forme d’URL ou de données base64, sous forme d’une chaîne ou d’une liste. Vous pouvez en fournir de 1 à 10, chacune mesurant entre 256 × 256 pixels et 16 mégapixels. Le paramètre aspect_ratio vaut auto : il reprend les proportions de la première référence ou produit une image carrée si aucune référence n’est fournie. Définissez-le explicitement si votre mise en page exige une forme particulière. la présentation du point de terminaison par BFL

Convertir un rectangle en cadre

Chaque cadre est [top, left, bottom, right], avec des coordonnées entières de 0 à 1000. Les coordonnées verticales viennent en premier. Chaque axe couvre indépendamment toute l’image : la grille s’étire donc pour s’adapter à une toile paysage ou portrait. le format de cadre de BFL

Pour convertir des positions en pixels, divisez le haut et le bas par la hauteur de l’image, et la gauche et la droite par sa largeur. Multipliez chaque résultat par 1000, puis arrondissez. La conversion documentée par BFL utilise une toile de 1920 × 1080 :

Le cadre est donc [100, 200, 900, 800]. Sa hauteur couvre de 10 % à 90 % de l’image ; sa largeur, de 20 % à 80 %. Ce calcul montre pourquoi inverser largeur et hauteur, ou saisir la gauche avant le haut, modifie la zone visée. Conservez le rapport hauteur/largeur utilisé pour concevoir la mise en page. la conversion des coordonnées par BFL

Composer une nouvelle image

Rédigez une description de l’ensemble de la composition en nommant les éléments avec les marqueurs <id> Ajoutez un tableau JSON avec un id, un bbox et un desc pour chaque élément. Le tableau est du texte à l’intérieur de prompt, et non un autre champ de premier niveau de l’API.

L’exemple documenté par BFL, représentant une silhouette en train de courir, comporte un arrière-plan qui couvre toute l’image et une silhouette placée dans le cadre central. Cette requête abrégée reprend cette mise en page ; BIG CHANGE ne l’a pas exécutée :

{
  "prompt": "A black running silhouette <silhouette_1> on a chartreuse background <background_1>. [{\"id\":\"background_1\",\"bbox\":[0,0,1000,1000],\"desc\":\"Chartreuse background with paper texture\"},{\"id\":\"silhouette_1\",\"bbox\":[150,150,850,850],\"desc\":\"Black running silhouette with stippled texture\"}]",
  "aspect_ratio": "1:1",
  "resolution": "1k"
}

Pour une mise en page contenant du texte, créez une ligne distincte pour chaque ligne de texte et placez les mots exacts demandés dans desc. Les cadres guident le placement et l’échelle, mais BFL précise qu’un élément peut dépasser de son rectangle. Ce ne sont pas des masques de découpe stricts. le tutoriel de composition et les limites de BFL

Retoucher une image existante

Fournissez l’image source dans images. Les lignes de retouche conservent id et desc mais remplacent bbox par les champs suivants :

Rassemblez l’instruction et le tableau de retouche dans prompt, comme pour une composition. Décrivez aussi bien les ajouts que les suppressions dans les deux parties. Ajoutez des lignes « conserver » pour les éléments qui doivent rester en place. Selon le guide de BFL, les pixels situés hors des cadres restent généralement inchangés, mais l’éclairage, les reflets et les ombres à proximité peuvent évoluer. Comparez l’image entière au résultat source avant d’accepter une retouche. BFL signale également que, dans ses propres essais, les nouveaux éléments placés dans des cadres d’environ 40 × 25 pixels n’apparaissaient souvent pas ; il s’agit d’une observation du fournisseur, et non d’une taille minimale universelle ni d’un essai de BIG CHANGE. les consignes de retouche de BFL, le schéma des lignes de retouche

Choisir la résolution et le budget

La présentation énumère 768sq, 1k, 1.5k, 2k et 4k, avec 1k comme valeur par défaut. La page des tarifs publie les prix suivants ; elle n’indique aucun tarif pour 1.5k. Vérifiez le coût de cette option avant de l’utiliser. la présentation de BFL

Ce sont les prix en dollars américains publiés par BFL, vérifiés le 3 octobre. La colonne pour dix requêtes est un calcul, et non une dépense mesurée. BFL indique le même tarif pour l’API et le Playground, un crédit valant $0.01. La réponse à la requête contient cost. Une requête 4k coûte environ 12,6 fois plus que 1k ; choisissez la taille de sortie adaptée à votre tâche et prévoyez un budget pour les tentatives supplémentaires. Modifier la résolution nécessite une nouvelle requête ; ce guide n’établit pas que deux requêtes produiront la même composition. les tarifs de BFL

Le paramètre facultatif grounding prend la valeur true, ce qui lance une recherche sur le Web et dans les images avant la génération. BFL indique que sa désactivation accélère les résultats en s’appuyant uniquement sur le prompt. Nous n’avons pas mesuré cet écart de vitesse ni vérifié l’exactitude des résultats issus de l’ancrage. la documentation de BFL sur l’ancrage

Envoyer la requête, suivre son état et enregistrer le résultat

Après l’envoi, conservez le polling_url retourné et interrogez cette URL précise avec votre clé d’API. Elle pointe vers la région qui héberge la tâche. Pending, Reasoning et Generating indiquent que la tâche est toujours en cours. À Ready, téléchargez le résultat result.sample ; son lien signé expire au bout d’une heure. N’envoyez pas votre en-tête x-key à l’URL de téléchargement. Le résultat contient aussi result.prompt, qui présente les instructions développées, et result.duration, la durée de génération. les instructions de récupération de BFL

Une tâche bloquée ou en échec nécessite une réponse différente d’une tâche en cours. Request Moderated indique qu’une entrée a été bloquée ; Content Moderated indique que la sortie a été bloquée. Modifiez l’entrée avant de réessayer. Pour Error, examinez la réponse : une tâche inconnue ou expirée renvoie Task not found. BFL avertit qu’une tâche en échec peut renvoyer le code HTTP 503 avec un corps JSON normal ; lisez donc son status avant toute nouvelle tentative. Des images de référence trop volumineuses entraînent l’erreur 400 ; un champ inconnu, une valeur invalide, un prompt vide ou une image trop petite peuvent entraîner 422. Les champs seed, width et input_image provenant d’autres points de terminaison ne sont pas acceptés ici. le guide de génération et des erreurs de BFL

La tentative est terminée lorsque le résultat est enregistré et que vous avez vérifié le placement, le texte demandé et les zones avoisinantes d’une retouche. Une réponse Ready confirme qu’un résultat est disponible ; seule votre vérification visuelle permet de décider s’il répond à la tâche.

Sources et lectures complémentaires

• Page produit de FLUX 3 Image : présente les voies navigateur et API, ainsi que l’accès commercial aux poids. Ses démonstrations proviennent du fournisseur et ne sont pas nos propres résultats.
• Notes de version du 1er octobre : datent la sortie Image et décrivent le point de terminaison partagé. Les affirmations générales sur le contrôle sont à lire à la lumière des limites plus précises des tutoriels.
• Présentation du point de terminaison : fournit les paramètres, les limites des images de référence, les choix de résolution et le comportement d’ancrage.
• Tutoriel sur les cadres de délimitation : explique les deux schémas de lignes et l’exemple de silhouette en course adapté plus haut.
• Guide de retouche : étaye la conversion des coordonnées, l’ordre des références et les réserves concernant les petites zones et les pixels environnants.
• Guide de génération : documente l’authentification, la récupération asynchrone, l’expiration des liens et les erreurs.
• Tarifs : fournit les prix utilisés dans nos calculs. Vérifiez à nouveau les tarifs et les paramètres de requête avant de payer une tentative : ces documents évoluent.