AI-translated from English; not yet reviewed by a fluent editor.

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

> Utilisez les cadres de mise en page et les images de référence de FLUX 3 Image pour composer une image ou retoucher des éléments précis. Guide fondé sur la documentation : coordonnées, récupération des résultats, tarifs et limites.

By BIG CHANGE Editorial

Published: 2026-10-03T04:10:59.237Z
Updated: 2026-10-03T04:10:59.237Z
Canonical: https://bigchange.ai/blog/flux-3-image-layout-editing-guide

![Conceptual charcoal illustration of one right hand placing a flat runner cutout on an orange square art backing.](https://bigchange.ai/api/media/file/flux-layout-collage-hero-v1.png)
AI-generated conceptual editorial illustration by BIG CHANGE.

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](https://docs.bfl.ai/release-notes).

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](https://docs.bfl.ai/release-notes)
- **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](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes)
- **À 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](https://docs.bfl.ai/quick_start/pricing), [les limites de retouche](https://docs.bfl.ai/flux_3/flux3_image_layout)

## Choisir entre le navigateur et l’API

La [page produit](https://bfl.ai/models/flux-3-image) 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](https://playground.bfl.ai) 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](https://dashboard.bfl.ai). 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](https://docs.bfl.ai/flux_3/flux3_image_generate), [les tarifs et la configuration](https://docs.bfl.ai/quick_start/pricing)

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](https://bfl.ai/models/flux-3-image)

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

| Tâche | Entrée documentée | Commande à utiliser |
| --- | --- | --- |
| Générer une nouvelle composition | Un prompt décrivant la scène, éventuellement suivi d’un tableau des éléments | `bbox` pour chaque élément dont l’emplacement importe |
| Modifier un détail identifiable | Une instruction et une image de référence | Une description précise peut suffire ; inspecter le prompt développé |
| Choisir exactement les éléments à retoucher | Une instruction, une image de référence et un tableau de retouche | Cadres source et cible, avec des lignes « conserver » pour les éléments à préserver |
| Combinez des images de référence | Un prompt qui précise le rôle de chacune et de 2 à 10 images | Indiquez quelle image fournit chaque sujet, objet ou décor |

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](https://docs.bfl.ai/flux_3/flux3_image_layout)

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](https://docs.bfl.ai/flux_3/flux3_image_overview)

## 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](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes#format)

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 :

| Bord | Position en pixels | Calcul | Valeur dans la grille |
| --- | --- | --- | --- |
| Haut | 108 | 108 ÷ 1080 × 1000 | 100 |
| Gauche | 384 | 384 ÷ 1920 × 1000 | 200 |
| Bas | 972 | 972 ÷ 1080 × 1000 | 900 |
| Droite | 1536 | 1536 ÷ 1920 × 1000 | 800 |

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](https://docs.bfl.ai/flux_3/flux3_image_layout#send-a-request)

## 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 :

```json
{
  "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](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes)

## 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 :

| Opération | `from` | `src_bbox` | `tgt_bbox` |
| --- | --- | --- | --- |
| Conserver un élément | `"ref_image_0"` | Son cadre source | Le même cadre |
| Le déplacer ou le redimensionner | `"ref_image_0"` | Son cadre source | Un cadre de destination différent |
| Ajouter, remplacer ou recolorer | `null` | `null` | Le cadre de sortie souhaité |
| Supprimer un élément | `"ref_image_0"` | Son cadre source | `null` |

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](https://docs.bfl.ai/flux_3/flux3_image_layout), [le schéma des lignes de retouche](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes#edit-an-image-box-by-box)

## 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](https://docs.bfl.ai/flux_3/flux3_image_overview)

| Résolution | Taille de sortie documentée | Prix par image | Coût calculé pour dix requêtes |
| --- | --- | --- | --- |
| `768sq` | 768 × 768 | $0.041 | $0.41 |
| `1k` | Environ 1 mégapixel | $0.048 | $0.48 |
| `2k` | Environ 4 mégapixels | $0.100 | $1.00 |
| `4k` | Environ 16 mégapixels | $0.607 | $6.07 |

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](https://docs.bfl.ai/quick_start/pricing)

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](https://docs.bfl.ai/flux_3/flux3_image_overview#ground-the-prompt)

## 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](https://docs.bfl.ai/flux_3/flux3_image_generate#results-and-errors)

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](https://docs.bfl.ai/flux_3/flux3_image_generate)

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](https://bfl.ai/models/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](https://docs.bfl.ai/release-notes) : 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](https://docs.bfl.ai/flux_3/flux3_image_overview) : 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](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes) : explique les deux schémas de lignes et l’exemple de silhouette en course adapté plus haut.
- [Guide de retouche](https://docs.bfl.ai/flux_3/flux3_image_layout) : é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](https://docs.bfl.ai/flux_3/flux3_image_generate) : documente l’authentification, la récupération asynchrone, l’expiration des liens et les erreurs.
- [Tarifs](https://docs.bfl.ai/quick_start/pricing) : 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.

## Sources

- [FLUX 3 Image](https://bfl.ai/models/flux-3-image) — établit les voies navigateur/API et l’accès commercial aux poids. Ses démonstrations proviennent du fournisseur, pas de nos propres essais. Les sources consultées ne confirment pas qu’un téléchargement des poids de ce point de terminaison Image soit disponible en accès libre.
- [Présentation de FLUX 3 Image](https://docs.bfl.ai/flux_3/flux3_image_overview) — fournit les paramètres, les limites des références, les choix de résolution et le comportement d’ancrage.
- [Mise en page et retouche avec FLUX 3 Image](https://docs.bfl.ai/flux_3/flux3_image_layout) — étaye la conversion des coordonnées, l’ordre des références et les réserves concernant les petites zones et les pixels environnants.
- [Génération avec FLUX 3 Image](https://docs.bfl.ai/flux_3/flux3_image_generate) — documente l’authentification, la récupération asynchrone, l’expiration des liens et les erreurs.
- [Notes de version](https://docs.bfl.ai/release-notes) — 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.
- [Tarifs](https://docs.bfl.ai/quick_start/pricing) — 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.
- [Cadres de délimitation de FLUX 3 Image](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes) — explique les deux schémas de lignes et l’exemple de silhouette en course adapté plus haut.