Introduction
FLUX.2 [max] Edit applique le modèle FLUX.2 de la plus haute qualité de Black Forest Labs à des photos que vous avez déjà. Il prend une à trois sources et une consigne, et renvoie une image dans la forme de la première source ou dans l’un des neuf ratios, en 1k ou 2k.
Choisir un mode selon votre point de départ
| Ce que vous avez | Mode |
|---|---|
| un brief écrit | FLUX.2 Max, texte vers image |
| une à trois photos à modifier ou à combiner | FLUX.2 Max, retouche |
Fonctionnalités et points forts
Jusqu’à trois références
Combinez des personnes et des lieux issus de photos séparées dans une seule requête. Dans notre test de la librairie, deux portraits et une pièce sont devenus une seule scène, chaque visage, coiffure et tenue étant conservé et la lumière des lampes de la pièce tombant sur les deux femmes.
Changements de fond et de lumière
Remplacez un fond de studio par un port à l’heure dorée et rééclairez le sujet, sans toucher au visage, à la barbe, à l’expression ni aux vêtements.
Un prix par retouche
Une retouche est facturée à l’image à un prix unique, quel que soit le nombre de sources ou le niveau de taille. Les requêtes refusées ne sont pas facturées.
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. 1 caractères minimum · 5000 caractères maximum |
image_urls | Oui | De 1 à 3 images sources, 10 Mo au maximum chacune. Précisez dans le prompt ce qu’apporte chacune : une personne, une pièce, un produit. 1 éléments minimum · 3 éléments maximum |
aspect_ratio | Non | auto (par défaut) garde la forme de la première image source à environ un mégapixel ; ou choisissez l’un des neuf formats, du 21:9 au 9:21. Le format ne change pas le prix. |
resolution | Non | 1k (par défaut) ou 2k, pris en compte uniquement si vous choisissez un ratio ; avec auto, le résultat reste à environ un mégapixel. |
seed | Non | Entier facultatif de 0 à 2147483647. Réutilisez-le avec le même prompt et les mêmes sources pour comparer plus facilement les changements ; il ne garantit pas une image identique. |
Tarification
$0.076 / image
Facturé à l’image, à un prix unique par retouche, quel que soit le nombre d’images sources ou le niveau de taille. Les requêtes échouées ou refusées ne sont pas facturées.
Cas d’utilisation
Photographie de produits et de lieux
Nouveaux fonds, nouvelles lumières et scènes cohérentes pour des visuels de catalogue et de campagne.
Retouche de portraits du quotidien
Modifiez le décor, la lumière ou le style d'un portrait du quotidien tout en gardant la personne reconnaissable.
Scènes de groupe à partir de photos séparées
Réunissez des personnes issues de portraits individuels dans une même pièce ou un même lieu.
Guide de prompt et conseils pratiques
Dites ce qui reste identique
Après le changement, listez les visages, les cheveux, les vêtements et la pose qui ne doivent pas bouger.
Numérotez vos sources
Appelez-les image 1, image 2 et image 3 dans l’ordre d’importation, et donnez un rôle à chacune.
Utilisez des photos sources propres et ordinaires
Les retouches sont filtrées strictement : dans nos tests, Max a refusé les retouches de portraits dès le niveau Léger. Les produits, les lieux et les portraits sobrement vêtus sont le matériau le plus sûr.
Choisissez auto pour garder le cadre
Auto garde la forme de la première source ; choisissez un ratio et un niveau de taille lorsque vous voulez un autre recadrage ou le 2k.
Prévoyez jusqu’à deux minutes
Nos retouches ont pris environ 45 à 120 secondes.
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-max/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.

























