FLUX 3 pour développeurs : workflows d'images

Si je devais déployer FLUX 3 aujourd'hui, je me concentrerais d'abord sur trois points : la sécurité des clés, le contrôle des tâches asynchrones et le stockage rapide des ressources. C'est le cœur de ce guide. Il explique comment envoyer des tâches de génération et de retouche, comment interroger l'état des tâches, comment travailler avec la retouche d'une image, la retouche locale par bbox et les références multi-images, et ce qu'il faut vérifier avant le lancement. Vous pouvez essayer FLUX 3 Image API directement sur APIMart.

Voici la version courte :

• FLUX 3 gère à la fois la génération et la retouche dans un même flux d'image.
• Les tâches sont asynchrones : j'envoie la tâche, j'enregistre le task_id et j'interroge /v1/tasks/{task_id} jusqu'à ce que l'état soit completed ou failed.
• APIMart conserve les résultats générés pendant 72 heures.
• Les règles de nouvelle tentative comptent : relancez 429 et 5xx avec repli, mais corrigez 400, 401 et 402 avant de réessayer.
• La résolution détermine l'attente et le coût : 4k peut prendre plusieurs minutes, et la documentation recommande un délai d'attente total de 10 minutes.
• Envoyez les images source sous forme d'URL publiques dans image_urls. Base64 fonctionne aussi, mais alourdit la charge utile d'environ 33 %.
• Aux tarifs catalogue d’octobre 2026, FLUX 3 Image coûte 0,048 USD par image en 1k et 0,607 USD en 4k, soit environ 12,6 fois plus. FLUX 3 Image
• Avant le lancement, je vérifierais les files d'attente, les limites de débit, les journaux, la validation de sécurité et le suivi des dépenses en USD.

Si vous ne devez retenir qu'une idée : FLUX 3 ne se résume pas à un appel API, il exige un pipeline propre autour des tâches, fichiers, nouvelles tentatives et coûts.

Comparaison rapide

J'apprécie que cet article reste centré sur ce qu'il faut réellement livrer : flux de requêtes, contrôle des retouches, configuration de production et points de vigilance sur les coûts, plutôt que sur une simple démonstration.

Points clés

• FLUX 3 Image gère le texte vers image, la retouche d'une image, les références multi-images (jusqu'à 10) et la retouche locale par bbox écrite dans le prompt, via un seul endpoint asynchrone. Il n'a ni paramètre mask ni paramètre d'intensité (strength).
• Les tâches suivent le flux « POST renvoie task_id » : interrogez /v1/tasks/{task_id} et arrêtez lorsque l'état est completed ou failed. 4k peut prendre plusieurs minutes, et la documentation recommande un délai d'attente total de 10 minutes.
• Réessayez les réponses 429 et 5xx avec un backoff exponentiel, corrigez les erreurs 400, 401 et 402 avant de réessayer, et persistez le task_id pour que les nouvelles tentatives ne créent pas de jobs facturables en double.
• APIMart conserve les résultats générés pendant 72 heures.
• Aux tarifs catalogue d’octobre 2026, FLUX 3 Image coûte 0,048 USD par image en 1k et 0,607 USD en 4k, soit environ 12,6 fois plus. Une seule clé API APIMart permet d’appeler les modèles de plusieurs fournisseurs.

FLUX 3 en bref

Présentation vidéo du flux FLUX 3

Flux FLUX 3, authentification, requêtes et gestion des tâches

Une intégration FLUX 3 stable dépend de trois éléments : des clés sécurisées, des URL d'images temporaires et une gestion asynchrone des tâches.

Configurer les clés API en toute sécurité

N'intégrez jamais les clés API en dur dans le code source. Conservez-les côté serveur dans un gestionnaire de secrets et ne les exposez jamais dans le code client ou un dépôt public. Si une clé fuit, renouvelez-la immédiatement depuis le tableau de bord APIMart.

Il est préférable de considérer la rotation des clés comme une maintenance ordinaire, et non comme une urgence extrême. Cette approche maintient une configuration plus propre et réduit les risques avant qu'ils ne deviennent problématiques.

Ces mécanismes, à savoir des identifiants sécurisés, un traitement prévisible des requêtes et une gestion fiable des tâches, constituent la base de fonctions d'image capables de tenir en production.

Construire des requêtes texte vers image et traiter les réponses

Une requête de génération d'image FLUX 3 de base nécessite :

• un ID de modèle
• un prompt texte
• une taille ou un format

APIMart conserve les résultats générés pendant 72 heures. Téléchargez les images dès la fin de la tâche et transférez-les vers votre propre stockage, par exemple S3, pour les conserver durablement.

Gérer l'interrogation, les nouvelles tentatives et les erreurs des tâches longues

La génération d'images est asynchrone. Une requête POST soumet la tâche et renvoie un task_id. Interrogez ensuite GET /v1/tasks/{task_id} et arrêtez lorsque l'état est completed ou failed. La documentation ne fixe pas d'intervalle d'interrogation : commencez par quelques secondes, puis allongez progressivement l'intervalle.

Fixez la limite d'attente selon la résolution. 4k peut prendre plusieurs minutes, et la documentation recommande un délai d'attente total de 10 minutes ; les résolutions plus basses peuvent utiliser une limite plus courte. Atteindre cette limite signifie seulement que votre client cesse d'attendre. La tâche n'a pas échoué pour autant : elle n'échoue que si l'état renvoie failed. Conservez le task_id pour l'interroger plus tard au lieu de soumettre une tâche en double.

Les nouvelles tentatives exigent du discernement. Toutes les erreurs ne se traitent pas de la même façon.

• Les réponses 429 et 5xx doivent déclencher un repli exponentiel et une nouvelle tentative.
• Les erreurs 400, 401 et 402 signalent un problème dans la requête elle-même, comme des paramètres incorrects, une clé absente ou non valide, ou un solde nul.

Si la requête est incorrecte, la relancer sans corriger la cause gaspille simplement des crédits et du temps. Enregistrez aussi le task_id avant toute nouvelle tentative afin d'éviter les doublons facturés.

Ces règles de nouvelle tentative s'appliquent de la même façon au texte vers image, à la retouche d'une image et à la retouche locale.

Les workflows diffèrent surtout par le contenu de la requête. Ils utilisent tous le même endpoint et le même modèle, et sont facturés selon resolution.

La documentation du modèle ne propose ni webhook ni callback_url : en production, vous devez donc gérer l'interrogation vous-même, en limitant la concurrence avec une file d'attente et en consignant l'état de chaque task_id.

Une fois le traitement des requêtes stabilisé, l'étape suivante consiste à décider comment transmettre au modèle les images source et les instructions de retouche.

Workflows de retouche FLUX 3 : retouche d'une image, retouche locale et références multi-images

Une fois la soumission des tâches et les nouvelles tentatives en place, la décision suivante est simple : quelle part de l'image source conserver, et quelle part modifier ? Toutes les retouches FLUX 3 Image passent par image_urls et le prompt, selon trois modèles principaux : retouche d'une image, retouche locale par bbox et références multi-images.

Retouche d'une image pour des modifications visuelles maîtrisées

Envoyez une image source dans image_urls et indiquez dans le prompt ce qui doit changer et ce qui doit rester. Le modèle n'a pas de paramètre d'intensité de type strength : le prompt est le seul moyen de doser la retouche. Avec aspect_ratio sur auto, la sortie reprend le format de la première image de référence.

Cette méthode convient aux variantes produit, au renouvellement de publicités et à la réinterprétation d'une marque. Indiquez très clairement ce qui ne doit pas changer. Si vous restez vague, le modèle peut s'éloigner de l'image source. Un cas pratique consiste à réutiliser la même photo de base pour créer des variantes saisonnières, au lieu d'organiser une nouvelle séance.

Les images source peuvent être des URL HTTP(S) publiques ou du Base64. Base64 alourdit la charge utile d'environ 33 % ; une URL publique, par exemple servie par un CDN, est donc généralement préférable.

Cibler une retouche locale avec bbox

Le modèle n'a pas de paramètre mask, et envoyer mask_url renvoie HTTP 400. Pour ne modifier qu'une zone, désignez les éléments dans le prompt avec des balises comme <car_1>, puis ajoutez un tableau JSON de bbox à la fin de la même chaîne. Les boîtes utilisent [top, left, bottom, right] sur une grille normalisée de 0 à 1000, pas des pixels. Si tgt_bbox est identique à src_bbox, l'élément reste en place ; une boîte différente le déplace. L'exemple ci-dessous colore en rouge la voiture encadrée et conserve l'arrière-plan :

{
  "model": "flux-3-image",
  "prompt": "In <ref_image_0>, make the car <car_1> red and preserve the background <background_1>. [{\"id\":\"car_1\",\"from\":null,\"src_bbox\":null,\"tgt_bbox\":[250,300,750,800],\"desc\":\"A red car, preserving its original shape and orientation.\"},{\"id\":\"background_1\",\"from\":\"ref_image_0\",\"src_bbox\":[0,0,1000,1000],\"tgt_bbox\":[0,0,1000,1000],\"desc\":\"Preserve the original road, background, and lighting.\"}]",
  "image_urls": [
    "https://example.com/car.jpg"
  ],
  "aspect_ratio": "auto",
  "resolution": "2k"
}

Il n'existe pas de paramètre dédié à l'outpainting. Pour les références multi-images, les images sont numérotées dans l'ordre ref_image_0, ref_image_1, etc., et vous pouvez aussi écrire Image 1 / Image 2 dans le prompt, par exemple « Turn Image 1 into the style of Image 2. »

Pour les aperçus, utilisez resolution: "768sq", puis choisissez 1k, 1.5k, 2k ou 4k pour la livraison. Ce sont des paliers, pas des dimensions width/height en pixels : 4k correspond à environ 16 MP et 2k à environ 4 MP. FLUX 3 Image

Enchaîner les retouches dans des pipelines répétables

Voici une structure simple :

• Utiliser la retouche d'une image pour ajuster le style ou les détails
• Utiliser la retouche locale par bbox pour modifier ou déplacer des éléments précis
• Utiliser la référence multi-images pour combiner sujets et styles
• Enregistrez chaque étape comme ressource intermédiaire

Avant l'envoi, évitez les exports via le canvas du navigateur et toute recompression supplémentaire afin de ne pas perdre de détails. Transmettez directement le fichier d'origine.

Une fois ces étapes stables, le défi suivant consiste à les intégrer dans un flux produit unique doté de contrôles d'accès et de suivi des coûts.

Intégrer FLUX 3 avec APIMart et maîtriser les coûts

Lorsque les étapes de retouche deviennent répétables, APIMart peut servir de couche de contrôle intermédiaire en production. Au lieu de relier séparément chaque composant, vous faites passer le pipeline de retouche par une couche API unique pour gérer les accès, les dépenses et l'automatisation en aval.

Connecter FLUX 3 à un flux API unifié

Si vous utilisez déjà des clients de type OpenAI, la configuration est généralement légère. Il suffit le plus souvent d'adopter une nouvelle URL de base, d'ajouter votre clé API et de diriger les requêtes vers l'ID du modèle FLUX 3.

L'avantage est de pouvoir conserver la même structure de requête, la même analyse, les mêmes règles de nouvelle tentative et la même logique asynchrone. Les tâches FLUX 3 suivent dans APIMart le même enchaînement, de POST à task_id, puis l'interrogation avec GET. Votre code existant de gestion des tâches continue donc de fonctionner, qu'il lance une génération unique ou enchaîne plusieurs retouches dans un pipeline complet. Une clé API APIMart peut également couvrir plusieurs modèles et projets.

Suivre l'usage, les budgets et la charge des équipes en USD

Le tableau de bord APIMart rassemble l'usage de plusieurs modèles et projets, puis affiche les coûts en USD. Il devient plus facile d'identifier les flux prêts pour la production et ceux qui nécessitent encore des ajustements.

Vous pouvez par exemple imposer un plafond mensuel à un projet de génération de catalogue et définir une alerte avant d'atteindre cette limite. L'équipe dispose ainsi d'une marge pour ralentir ou suspendre les lots avant que les dépenses ne dérapent.

Aux tarifs catalogue d’octobre 2026, FLUX 3 Image coûte 0,048 USD par image en 1k et 0,607 USD en 4k, soit environ 12,6 fois plus. Voici les tarifs catalogue d’octobre 2026, en USD par image. Les images de référence ne sont pas facturées en supplément. Consultez la grille tarifaire FLUX 3 Image pour les prix actuels.

Associer la génération FLUX 3 à de plus vastes flux multimodaux

Intégrez FLUX 3 comme étape de génération d’images dans un pipeline plus large, avec des étapes de rédaction, d’analyse visuelle ou d’étiquetage. Une seule clé API APIMart donne accès aux modèles de plusieurs fournisseurs. APIMart

Vous pouvez aussi définir des autorisations par rôle afin que l'accès aux analyses reste réservé aux personnes concernées, tandis que la gestion des clés se limite aux ingénieurs approuvés.

Cette configuration fait de l'évolutivité, des limites de débit et des journaux la prochaine couche des opérations quotidiennes.

Déploiement en production, évolutivité, observabilité et décisions de lancement

Planifier les files d'attente, la concurrence et les limites de débit

Une fois la génération et les retouches stabilisées, la production change la donne. Il ne s'agit plus seulement de réussir une requête, mais de gérer le trafic sans que le système s'effondre.

La demande de génération peut connaître des pics soudains. Il vaut donc mieux ne pas traiter chaque requête directement. Une file d'attente apporte une marge de manœuvre. Elle sépare la réception de l'exécution, empêchant un pic de trafic de submerger tous les workers en même temps.

La concurrence doit également rester alignée sur vos limites de débit. Associer les files à des plafonds de concurrence par modèle constitue une solution simple. Vous absorbez ainsi les pics sans dépasser les limites du fournisseur.

Journaliser les bonnes données pour le débogage et la reproductibilité

Lorsque les résultats varient entre les exécutions, le débogage devient vite difficile si les champs appropriés ne sont pas enregistrés.

Pour assurer la reproductibilité et résoudre les problèmes, journalisez l'ID de requête, l'ID de tâche, le prompt et les métadonnées de génération. Ces éléments fournissent assez de contexte pour retrouver les événements et relancer les tâches plus tard. La profondeur des journaux doit aussi correspondre à l'environnement. Ceux de préproduction et de production doivent rester utiles sans exposer plus de données de charge utile que nécessaire.

Il est également judicieux de journaliser la résolution et le coût estimé de chaque tâche. Vous repérerez ainsi les valeurs anormalement coûteuses avant qu'elles ne causent une mauvaise surprise sur la facture.

Conclusion, comment évaluer les fonctions d'image FLUX 3 avant le lancement

Avant de placer FLUX 3 en production, validez la configuration dans les environnements ci-dessous avec des règles différentes d'accès, de journalisation et d'examen.

Utilisez cette matrice pour vérifier que le lancement est prêt.

Préparez la fiabilité à partir de vos tests de charge, de la supervision et des procédures de reprise. Avant le lancement, vérifiez les pics de trafic, les ID de requête et de tâche dans les journaux, les limites de débit, les contrôles de sécurité et le suivi des coûts par résolution.

Si ces contrôles réussissent les tests de charge, FLUX 3 est prêt pour la production.

Pour une présentation complète du modèle, consultez FLUX 3 expliqué : modèles, disponibilité et prix.

FAQ

Combien de temps interroger une tâche FLUX 3 ?

Interrogez GET /v1/tasks/{task_id} jusqu'à ce que l'état soit completed ou failed. La documentation du modèle ne propose ni webhook ni callback_url : l'interrogation est donc le moyen d'obtenir les résultats.

Fixez la limite d'attente selon la résolution : 4k peut prendre plusieurs minutes, et la documentation recommande un délai d'attente total de 10 minutes. Une fois la limite atteinte, votre client cesse d'attendre, mais la tâche n'a pas forcément échoué. Conservez le task_id pour l'interroger plus tard.

Comment stocker les images FLUX 3 en production ?

APIMart conserve les résultats générés pendant 72 heures. Téléchargez les images dès la fin de la tâche et transférez-les vers votre propre stockage, par exemple S3, pour les conserver durablement.

Utilisez un flux asynchrone. Interrogez le task_id jusqu'à la fin de la tâche, puis enregistrez le fichier dans votre infrastructure permanente. Il est également utile de tenir un journal de base de données avec le task_id, les horodatages et le chemin interne afin de conserver une piste d'audit claire.

Quel est le meilleur flux FLUX 3 pour les retouches ?

Utilisez un flux de retouche qui part d'une image existante, puis applique un prompt ciblé pour modifier uniquement les éléments voulus. Vous pouvez également inclure du texte dans d'autres langues, tout en conservant le reste de la mise en page.

En production, configurez un pipeline API asynchrone. Envoyez une requête POST pour commencer la retouche, récupérez un task_id, puis interrogez la tâche jusqu'à ce qu'elle soit completed ou failed. Une fois l'URL finale renvoyée, enregistrez l'image dans votre stockage avant son expiration.

Quelques règles fondamentales s'appliquent :

• Garder les clés API uniquement dans le backend
• Valider les entrées avant d'envoyer la requête
• APIMart conserve les résultats générés pendant 72 heures.

Cette configuration maintient un flux propre et évite des erreurs facilement prévisibles lorsque le trafic augmente.