Construire avec CometAPIBesoin d'une seule API pour plusieurs modèles ?Testez le workflow dans Playground, puis créez une clé API lorsque le modèle et le coût correspondent à votre cas d'usage.
Utilisez FLUX 3 Image sur CometAPI pour la génération et la retouche. Découvrez les paramètres d’image, la gestion des tâches asynchrones, des exemples de prompts et les tarifs.
Deon GoodwinÉquipe de recherche sur les modèles IA et API
Réalisez des photos produit, des affiches et des retouches guidées par référence avec FLUX 3 Image, disponible via CometAPI sous l’ID flux-3-image, à partir de 0,0384 $ par requête. Ce guide vous aide à choisir les réglages d’image, préparer une requête, gérer une tâche asynchrone et examiner l’image finale. Vous aurez besoin d’un compte CometAPI, d’une clé API et de la configuration de requête FLUX 3 Image fournie pour votre compte.
Points clés
Choisissez le texte-vers-image pour de nouvelles compositions et l’édition guidée par références lorsqu’un produit ou un sujet doit rester reconnaissable.
Utilisez une petite ébauche pour vérifier la composition avant d’investir dans une image finale plus grande.
Utilisez les identifiants CometAPI et son schéma de requête spécifique au modèle ; les clés et exemples natifs BFL relèvent d’une autre intégration.
Revu pour la clarté, l'attribution des sources et la terminologie API actuelle.
Estimez les coûts à partir du tarif CometAPI applicable, puis mesurez la dépense par livrable accepté.
Menez à bien une soumission, une récupération de résultat, un téléchargement et une revue visuelle avant de lancer un lot.
Qu’est-ce que l’API FLUX 3 Image ?
FLUX 3 Image est le modèle de Black Forest Labs destiné à créer et retoucher des images fixes. Un prompt texte décrit une nouvelle scène ; des images de référence fournissent la matière visuelle à préserver, combiner ou modifier. Pour une équipe e-commerce, cela peut signifier développer une scène produit à partir d’un brief, puis réutiliser une photo produit validée tout en changeant son environnement.
Choisissez un flux de travail avant d’écrire le prompt. Pour un visuel neuf, précisez le sujet, le décor, l’éclairage et le cadrage. Pour une retouche, identifiez l’image source, nommez le changement et indiquez les détails à conserver. Pour une composition utilisant plusieurs références, attribuez un rôle à chacune afin que l’identité produit et le style visuel ne se concurrencent pas.
Spécifications FLUX 3 Image et paramètres API
Planifiez votre image avec les réglages ci-dessous. Les contrôles du modèle suivent la référence API BFL FLUX 3 Image ; l’authentification et le routage des requêtes suivent votre intégration CometAPI. Utilisez les noms de champs acceptés par votre route FLUX 3 Image sur CometAPI.
Fonctionnalité / paramètre
Ce que cela contrôle
Comment l’utiliser avec CometAPI
Identité du modèle
FLUX 3 Image ; ID de catalogue flux-3-image
Utilisez la route spécifique au modèle et la convention de routage de l’exemple de votre compte.
Génération / prompt
La scène, la composition, ou l’instruction de retouche
Commencez par un sujet clair et un résultat attendu.
Images de référence / images natives
Une liste ordonnée de 1–10 images de référence, fournies en URL HTTP(S) ou en base64 dans l’API native.
Confirmez le nom du champ de la passerelle, le format d’entrée et la limite de références.
Rapport d’aspect / natif aspect_ratio
Les proportions de la toile. En mode auto, un ratio demandé dans le prompt est prioritaire ; sinon, les retouches conservent le cadrage de la première référence.
Choisissez un ratio adapté au format de livraison et confirmez les valeurs acceptées.
Résolution / résolution native
Paliers natifs : 768sq, 1k (par défaut), 1.5k, 2k et 4k. Les dimensions exactes dépendent du rapport d’aspect.
Pour les retouches, match_input conserve la taille de la première référence, réduite à 4 MP si plus grande ; un aspect_ratio explicite sélectionne le palier le plus proche. width et height explicites sont prioritaires.
Dimensions exactes / width + height
Fournissez deux entiers, chacun entre 256 et 6256 pixels. Ils remplacent resolution et aspect_ratio. La surface totale est limitée à 16 822 272 px, ou 4 194 304 px avec références.
Utilisez des dimensions explicites pour une taille de livraison fixe, par ex. 1024 × 1280. Confirmez que votre route CometAPI accepte ces contrôles natifs.
Contrôle de mise en page
Guidage par boîtes englobantes pour le placement des éléments
Utilisez la syntaxe de mise en page documentée lorsque le placement exact est important.
Choisissez les dimensions de trois façons : un palier de résolution plus un rapport d’aspect, width plus height pour une toile exacte, ou match_input pour une retouche. Conservez l’original de référence pour comparer le cadrage et le détail après génération. Le point de terminaison natif rejette les champs non pris en charge ; utilisez le schéma de la route que vous appelez.
FLUX.2 vs FLUX 3 Image
Dimension
FLUX 2 MAX / FLUX 2 PRO
FLUX 3 Image
Évaluation pratique
Cas d’usage
Texte-vers-image/retouche puissants, variantes famille
Composition détaillée et retouches préservant les pixels
Comparez les mêmes prompts de marque
Résolution
Génération haute résolution selon la variante
2K/4K natifs explicites
Inspectez les détails fins en plein zoom
Retouche
Capacités multi-références sur certaines variantes
Démos de retouches localisées
Mesurez la dérive des zones non retouchées
Coût
Variable selon variante et plateforme
Tarification CometAPI pour la configuration choisie
Comparez par image acceptée
Accès CometAPI
Disponible via CometAPI en FLUX 2 PRO et FLUX 2 MAX
Disponible via CometAPI sous flux-3-image
Validez la requête spécifique au modèle avant de changer le routage en production
Conservez votre intégration FLUX.2 actuelle comme référence pendant l’évaluation de FLUX 3 Image. Exécutez les mêmes briefs et références dans les deux flux, puis comparez les sorties acceptées, les délais et le coût total.
Comment générer une image avec l’API FLUX 3 Image dans CometAPI ?
POST https://api.cometapi.com/flux/v1/flux-3-image
L’authentification utilise un jeton Bearer (style CometAPI). Les requêtes sont asynchrones par défaut.
3. Exemple de base texte-vers-image (cURL)
curl https://api.cometapi.com/flux/v1/flux-3-image \
-H "Authorization: Bearer $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Ultra-wide cinematic shot of a fog-drenched coastal highway at dawn, cliffs on one side, turquoise sea on the other, a single vintage car with headlights on, soft golden rim light",
"aspect_ratio": "21:9",
"resolution": "1k"
}'
Interrogez jusqu’à ce que status soit "Ready". L’URL de l’image apparaît dans result.sample (téléchargez-la rapidement ; les URL signées sont temporaires).
Pour attendre de manière synchrone dans la même requête, ajoutez "async": false au corps (gardez la connexion ouverte ; utilisez un délai client généreux).
5. Exemple Python (soumission + polling)
import os
import time
import requests
API_KEY = os.environ["COMETAPI_KEY"]
BASE = "https://api.cometapi.com/flux/v1"
def generate_image(payload, name="flux3_image"):
# Submit
r = requests.post(
f"{BASE}/flux-3-image",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json=payload,
timeout=60,
)
r.raise_for_status()
task = r.json()
task_id = task["id"]
# Poll
while True:
time.sleep(1.5)
result = requests.get(
f"{BASE}/get_result",
params={"id": task_id},
headers={"Authorization": f"Bearer {API_KEY}"},
timeout=60,
).json()
status = result.get("status")
if status not in ("Pending", "Reasoning", "Generating"):
break
if status != "Ready":
raise RuntimeError(result)
# Download
img_url = result["result"]["sample"]
img = requests.get(img_url, timeout=120)
with open(f"{name}.png", "wb") as f:
f.write(img.content)
return f"{name}.png"
# Example call
generate_image({
"prompt": "A two-color risograph narrative illustration... a rabbit rides a pumpkin...",
"aspect_ratio": "16:9",
"resolution": "1k",
})
FLUX 3 Image prend en charge le texte-vers-image pur et la retouche/multi-références via le même endpoint—incluez simplement images et décrivez leur usage dans le prompt (pas de champ “mode” séparé).
Alternative : route compatible OpenAI
Vous pouvez aussi essayer le point de terminaison d’images unifié avec l’ID du modèle :
POST https://api.cometapi.com/v1/images/generations
(Le point de terminaison natif `/flux/v1/...` est préféré pour l’ensemble des paramètres FLUX 3.)
### Conseils
* Vérifiez la disponibilité et la tarification exacte sur la [page modèle FLUX 3 Image de CometAPI](https://www.cometapi.com/models/flux/flux-3-image/).
* Téléchargez toujours l’URL `result.sample` rapidement.
* Pour la liste de paramètres la plus récente ou des exemples de playground, consultez la documentation Flux de CometAPI et la référence officielle FLUX 3 Image de Black Forest Labs.
Cela reflète le flux officiel BFL tout en utilisant l’authentification et l’infrastructure unifiées de CometAPI.
## Comment rédiger des prompts pour FLUX 3 Image ? Exemples
### Exemple : prompt de photographie produit
Utilisez ce prompt pour un premier test de photo produit.
A premium amber perfume bottle centered on matte limestone,
three-quarter product perspective, exact bottle silhouette,
softbox key light camera-left, detailed contact shadow,
subtle natural reflections, beige seamless studio backdrop,
no extra bottles, no watermark, no altered brand lettering.
Output: clean 4:5 e-commerce hero creative.
Remplacez la valeur de prompt dans request.json par ce brief, en conservant le corps de requête attendu par votre route CometAPI. Une toile 4:5 convient à une mise en page produit portrait. Si votre route accepte les contrôles de dimensions natifs, 1024 × 1280 est une option 4:5 exacte ; fournissez les deux valeurs ensemble.
Commencez par une petite ébauche et vérifiez la silhouette du flacon, l’étiquette, les reflets et les objets supplémentaires. Si l’identité exacte du produit est cruciale, utilisez une référence produit plutôt que d’espérer qu’un prompt textuel la reconstitue. Consignez le prompt et les réglages de sortie avant de modifier quoi que ce soit.
### Exemple : typographie et mise en page d’affiche
Prompt d’affiche avec un titre explicitement spécifié.
An editorial art poster on warm off-white paper.
Title text exactly: THE SEED PARADE.
Three stylized walking seed characters below the title.
Two-color risograph-inspired printing, generous margins,
balanced hierarchy, crisp legible typography, portrait format.
Utilisez ce brief comme prompt dans votre requête CometAPI et choisissez une toile portrait. Commencez par une ébauche pour vérifier la position du titre et la disposition des personnages, puis augmentez la taille de sortie pour l’art final.
Considérez l’exactitude des lettres comme un critère d’acceptation mesurable. Vérifiez chaque lettre et signe de ponctuation dans la sortie en résolution finale ; des images impressionnantes ne garantissent pas l’absence d’erreurs sur votre texte de marque spécifique.
## Comment modifier des images avec des références
Pour une retouche, décrivez à la fois le changement souhaité et les détails à préserver. L’API FLUX 3 Image native reçoit les références dans images ; mappez-les sur le champ d’entrée correspondant dans votre exemple CometAPI. Placez la référence produit en premier et conservez cet ordre dans le prompt.
### Modification d’une seule image : changer l’arrière-plan, préserver le produit
Gardez edit.py à côté de submit.py, poll.py et download.py. Définissez PRODUCT\_IMAGE\_URL sur une photo produit HTTPS publiquement accessible, puis exécutez python edit.py. L’exemple ci-dessous nécessite une route qui accepte le tableau images natif. Utilisez un corps de requête d’édition sans champs source conflictuels, et adaptez le mapping si votre exemple CometAPI utilise un champ différent. Pour reprendre une tâche de retouche sauvegardée, exécutez python poll\_download.py editing-task.json.
import json
import os
from pathlib import Path
from submit import submit
from poll import wait_for_image
from download import download_image
This request variant requires a route accepting the native images array.
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["images"] = [os.environ["PRODUCT_IMAGE_URL"]]
payload["prompt"] = (
"Use image 1 as the authoritative product reference. "
"Replace only the studio background with pale limestone and warm "
"morning window light. Preserve bottle shape, cap, label text, logo "
"position, and product color. Do not crop the product or add objects."
)
task_id = submit(payload, "editing-task.json")
image_url = wait_for_image(task_id)
print(download_image(image_url, "edited-product"))
Choisissez une photo produit nette avec une étiquette lisible et une silhouette claire. Soumettez-la dans le format d’entrée image accepté par votre route CometAPI. Si cette route prend en charge le réglage de résolution natif, utilisez match\_input pour conserver le cadrage et la taille de la référence sous réserve des limites de retouche du modèle.
Exemple officiel BFL de retouche, avant : la scène sous-marine originale avec un plongeur.
Exemple officiel BFL de retouche, après : deux plongeurs sont ajoutés à la scène. Inspectez le fond inchangé ainsi que les nouveaux sujets.
### Modification multi-références : combiner le style et l’identité produit
Placez le produit en premier et la référence d’éclairage/style en second. Définissez PRODUCT\_IMAGE\_URL et STYLE\_IMAGE\_URL, enregistrez le code ci-dessous sous multi\_edit.py à côté des trois clients, puis exécutez python multi\_edit.py. Cet exemple requiert une route acceptant au moins deux références dans images. Commencez par un corps de requête d’édition sans champs source conflictuels. Reprenez une tâche sauvegardée avec python poll\_download.py multi-edit-task.json.
import json
import os
from pathlib import Path
from submit import submit
from poll import wait_for_image
from download import download_image
Preserve this order: product first, lighting/style second.
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["images"] = [
os.environ["PRODUCT_IMAGE_URL"],
os.environ["STYLE_IMAGE_URL"],
]
payload["prompt"] = (
"Image 1 defines product identity. Image 2 defines lighting and color. "
"Create one promotional image with the exact product from image 1 "
"and the lighting mood of image 2. Preserve product lettering and "
"geometry. Do not copy logos, text, or extra objects from image 2."
)
task_id = submit(payload, "multi-edit-task.json")
print(download_image(wait_for_image(task_id), "multi-edited-product"))
Joignez les deux références en utilisant le format spécifique au modèle sur CometAPI. Vérifiez d’abord si le produit a conservé son identité ; évaluez ensuite si la seconde référence a apporté la lumière et la couleur souhaitées. Si elle introduit aussi des objets ou lettrages indésirables, simplifiez cette référence ou explicitez davantage le prompt.
## Comment utiliser des boîtes englobantes pour contrôler la mise en page
Utilisez des boîtes lorsque le flacon et le titre doivent occuper des zones prévisibles. Rédigez une légende de scène avec un ID pour chaque élément, puis ajoutez un tableau JSON au prompt. Le format BFL utilise bbox dans l’ordre [haut, gauche, bas, droite] sur une grille 0–1000 ; les boîtes appartiennent au prompt, pas à un champ API séparé.
L’exemple ci-dessous réserve un espace pour un titre au-dessus du flacon. Conservez un réglage de sortie portrait dans request.json et enregistrez ce fichier sous layout.py à côté de submit.py. Exécutez python layout.py, puis python poll\_download.py layout-task.json. Utilisez une route qui prend en charge cette syntaxe de mise en page ; inspectez le résultat pour vérifier si le flacon et le titre occupent les régions prévues.
import json
from pathlib import Path
from submit import submit
caption = (
"A portrait perfume advertisement: an amber bottle <bottle_1> "
"below a headline <title_1>, on a warm beige background."
)
elements = [
{"id": "title_1", "bbox": [80, 120, 220, 880],
"desc": "Dark brown text reading AMBER, centered"},
{"id": "bottle_1", "bbox": [300, 300, 880, 700],
"desc": "One amber glass perfume bottle with a black cap"},
]
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["prompt"] = caption + " " + json.dumps(elements)
print(submit(payload, "layout-task.json"))
Conservez un rapport d’aspect cohérent avec la mise en page. Les boîtes guident le placement plutôt que de découper un objet selon une limite stricte. Vérifiez l’orthographe et l’espacement du titre dans l’image enregistrée ; ajoutez le lettrage de marque final dans un outil de design lorsque la typographie exacte est essentielle.
## Combien coûte l’API FLUX 3 Image ?
CometAPI propose FLUX 3 Image à partir de [0,0384 $ par requête](https://www.cometapi.com/models/flux/flux-3-image/) (9 novembre 2026). Utilisez ce tarif de départ pour un budget initial, puis appliquez le tarif affiché pour votre configuration sélectionnée. Les exemples ci-dessous supposent que chaque requête facturée utilise le tarif de départ.
| Requêtes facturées | Tarif supposé / requête | Coût illustratif |
| ------------------ | ----------------------- | ---------------- |
| 1 | 0,0384 $ | 0,0384 $ |
| 10 | 0,0384 $ | 0,3840 $ |
| 100 | 0,0384 $ | 3,84 $ |
| 1000 | 0,0384 $ | 38,40 $ |
Vérifiez le tarif de votre configuration et compte avant d’engager un lot. Le prix public de départ n’établit pas le prix de chaque option de résolution ou de retouche. Suivez les essais créatifs rejetés autant que les sorties approuvées : si vous dépensez 3,84 $ pour 100 requêtes facturées et approuvez 80 livrables, le coût API par livrable accepté est de 0,048 $, hors revue humaine et stockage. Il s’agit d’un calcul illustratif, non d’un taux d’acceptation mesuré.
### Choix de résolution selon le flux de travail
| Flux de travail | Premier test | Vérification d’approbation |
| -------------------------------- | ---------------------------------------------- | --------------------------------------------------- |
| Exploration par prompt | Plus petit palier utile pris en charge | Composition et placement du sujet |
| Images produits e-commerce | Une ébauche avec le recadrage souhaité | Géométrie du produit, étiquettes, détails de bord |
| Illustrations de campagne/édito | Ébauche d’abord ; sortie plus grande après validation de la mise en page | Typographie et détails à la taille de livraison |
| Retouches basées sur références | Réglage pris en charge adapté à la source | Zones inchangées, identité produit, éclairage |
## Quand utiliser plutôt FLUX 3 Video ?
Utilisez FLUX 3 Image pour des assets fixes comme une image héro produit, une affiche ou une image de campagne. Si le livrable nécessite du mouvement, consultez [FLUX 3 Video sur CometAPI](https://www.cometapi.com/models/flux-3/), sous l’ID de modèle séparé flux-3. Son [flux vidéo](https://apidoc.cometapi.com/api/video/flux-3/create) utilise des réglages et une facturation spécifiques à la vidéo. Gardez les requêtes image et vidéo séparées ; la durée, l’audio et les contrôles de trames vidéo n’ont pas leur place dans une requête d’image fixe.
Pour une campagne mixte, validez d’abord la composition de l’image fixe, puis préparez le brief motion séparément. Vérifiez les exigences d’entrée de référence du modèle vidéo avant de réutiliser une image approuvée comme source.
## Conclusion
Commencez avec un brief produit et une petite tâche d’image. Soumettez-la via votre route FLUX 3 Image sur CometAPI, enregistrez l’ID de tâche, récupérez l’image terminée et examinez le résultat avant de monter en charge. Utilisez width et height lorsque vous avez besoin d’une toile exacte, ou match\_input pour une retouche par référence lorsque c’est pris en charge. Comparez la dépense totale au nombre d’images acceptées afin que votre budget reflète des résultats utilisables.
## Métadonnées SEO
Meta title: Guide de l’API FLUX 3 Image : génération, édition et CometAPI
Meta description: Utilisez FLUX 3 Image sur CometAPI pour la génération et la retouche. Découvrez les paramètres d’image, la gestion asynchrone, des exemples de prompts et une tarification à partir de 0,0384 $ par requête.
Keywords: API FLUX 3 Image, CometAPI FLUX 3 Image, édition d’images FLUX 3, tarification FLUX 3, génération avec images de référence, migration FLUX.2
URL slug: flux-3-image-api-guide
Modifications ciblées
Changements sur des sujets ou zones sélectionnés
Comparez la source et le résultat dans les zones censées rester inchangées.
Authentification
Clé API CometAPI pour les requêtes vers la passerelle
Suivez les en-têtes d’authentification de l’exemple CometAPI ; conservez la clé côté serveur.
Gestion des résultats
Génération asynchrone : soumettez une tâche, suivez son ID et récupérez l’image finale.
Utilisez le modèle Python ci-dessous si la route de votre compte suit le contrat de tâche FLUX documenté par CometAPI.
Tarification
Tarifs CometAPI à partir de 0,0384 $ par requête (9 novembre 2026).
Utilisez la section prix ci-dessous pour un budget illustratif ; vérifiez la configuration sélectionnée.
Champs supplémentaires
Les schémas natifs et gateway varient selon les générations de modèles
FLUX 3 Image natif accepte width et height. Ne réutilisez pas seed ou input_image d’un ancien modèle ; utilisez images pour les entrées de référence natives et suivez le schéma gateway pour CometAPI.
