Introduction
FLUX.2 [flex] Edit applique FLUX.2 [flex] de Black Forest Labs à des images que vous avez déjà. Il prend une à trois sources et une consigne, comme une nouvelle lumière, une nouvelle scène ou un lettrage ajouté, et renvoie un résultat en 1k dans la forme de la source ou dans l’un des neuf formats.
Choisir un mode selon votre point de départ
| Ce que vous avez | Mode |
|---|---|
| un brief écrit | FLUX.2 [flex], texte vers image |
| des images à modifier ou à combiner | FLUX.2 [flex], retouche |
Fonctionnalités et points forts
Rééclairage avec le sujet conservé
Dans notre test, un portrait de jour est devenu une nuit pluvieuse avec pavés mouillés, lumière de vitrine et gouttes de pluie, alors que la femme, son manteau et sa pose sont restés tels quels.
Compositions avec plusieurs sources
Désignez chaque source par son numéro et dites comment elles se combinent. Notre test de parfum a placé un flacon d’une photo sur un rebord de marbre d’une autre, en harmonisant la lumière et le reflet.
Texte ajouté par-dessus le résultat
Mettez entre guillemets tout titre ou toute étiquette à ajouter. Notre composition est revenue avec le titre orthographié comme écrit ; un « No. » dans une étiquette peut revenir sous forme de signe numéro.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Jusqu’à 5 000 caractères. Dites ce qu’il faut changer et ce qui doit rester identique, et désignez chaque source par sa position, comme image 1 et image 2. 1 caractères minimum · 5000 caractères maximum |
image_urls | Oui | De 1 à 3 images sources, dans l’ordre où votre prompt les cite. Le prix est le même quel que soit le nombre de sources. 1 éléments minimum · 3 éléments maximum |
aspect_ratio | Non | auto (par défaut) garde à peu près la taille et la forme de la première source ; ou choisissez l’un des neuf formats, du 21:9 au 9:21. Le format ne change pas le prix. |
resolution | Non | Seul le 1k est disponible en retouche. Il s’applique lorsque vous choisissez un ratio fixe ; avec auto, le résultat suit la taille de la première source. |
seed | Non | Entier facultatif de 0 à 2147483647. Réutilisez-le avec le même prompt et les mêmes sources pour comparer des variantes côte à côte. |
Tarification
$0.115 / image
Facturé à l’image à un prix fixe : le nombre d’images sources et le ratio d’image ne le changent pas. Les requêtes refusées ou échouées ne sont pas facturées.
Cas d’utilisation
Scènes de produit
Déplacez une photo de produit dans un décor stylisé et ajoutez une étiquette ou un titre.
Variations d’ambiance et de météo
Montrez un portrait au crépuscule, sous la pluie ou sous néon, à un client qui choisit une direction.
Paysages et images du quotidien
Changez le moment de la journée, la saison ou l’arrière-plan d’un paysage ou d’une scène de rue.
Guide de prompt et conseils pratiques
Dites ce qui reste
Après le changement, listez le visage, la tenue et la pose qui doivent rester identiques.
Numérotez vos sources
Écrivez image 1 et image 2 dans le prompt pour que chaque source ait un rôle clair.
Restez sur du contenu tout public
L'édition refuse les portraits bien plus facilement que le texte vers image, même au niveau Léger ; utilisez-la donc pour les produits, les paysages et les portraits du quotidien.
Choisissez auto pour garder le cadrage
Avec auto, le résultat suit la taille de votre première source. Choisissez un format fixe seulement pour recadrer.
Prévoyez une à deux minutes
Les retouches ont pris de 45 à 120 secondes dans nos tests.
Démarrage rapide de l’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "black-forest-labs/flux-2-flex/edit",
"input": {
"aspect_ratio": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.

























