Introduction
FLUX.2 [pro] Edit applique FLUX.2 [pro] de Black Forest Labs à des images que vous avez déjà. Il accepte une à trois sources, applique le changement que vous décrivez et renvoie du 1k ou du 2k 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 [pro], texte vers image |
| une à trois images à modifier ou à combiner | FLUX.2 [pro], retouche |
Fonctionnalités et points forts
Compositions multi-références
Combinez une personne, un produit et un lieu issus de photos séparées. Dans notre publicité de casque, le visage, les cheveux et le cardigan ainsi que le design du casque sont restés fidèles aux sources.
Changements de scène et de lumière
Changez le décor ou rééclairez une photo sans que le sujet bouge. Notre rue ensoleillée est devenue une nuit de néons sous la pluie, avec des gouttes sur le blazer.
Texte ajouté pendant la retouche
Ajoutez un titre à l’image dans la même étape. Le nôtre est sorti orthographié comme cité.
Prix fixe par image
Une source ou trois, 1k ou 2k, une retouche coûte le même prix.
Strict sur les personnes
Dans nos tests, des sources de portrait ont été refusées même pour un changement de tenue de niveau Léger. Les demandes refusées ne sont pas facturées.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Obligatoire, jusqu’à 5 000 caractères. 1 caractères minimum · 5000 caractères maximum |
image_urls | Oui | Obligatoire, une à trois images sources, 10 Mo au maximum chacune. Importez-les dans l’ordre où votre prompt les cite. 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. Il ne s’applique que si vous choisissez un format ; avec auto, le résultat reste à environ un mégapixel. |
seed | Non | Entier facultatif de 0 à 2147483647. Réutilisez-le en changeant le prompt pour comparer des variantes ; il ne garantit pas une image identique. |
Tarification
$0.058 / image
Facturé à prix fixe par image, quel que soit le nombre de sources ou le niveau de taille. Les requêtes refusées ou échouées ne sont pas facturées.
Cas d’utilisation
Publicités à partir d’éléments séparés
Réunissez une photo de mannequin, une photo de produit et un lieu dans un seul visuel.
Variations d’ambiance
Montrez la même scène de jour, de nuit ou sous la pluie pour un client qui choisit une direction.
Nouveau style pour produits et lieux
Changez l'arrière-plan, la lumière ou le style d'un produit, d'une pièce ou d'un portrait.
Guide de prompt et conseils pratiques
Numérotez les sources
Dites que l’image 1 est la personne, l’image 2 le produit, l’image 3 le lieu, dans l’ordre d’importation.
Nommez ce qui doit rester
Après le changement, listez le visage, la tenue, la pose ou le design qui doit rester exactement tel quel.
Changez une seule chose à la fois
Un seul changement clair garde le reste du cadre stable ; enchaînez les retouches plutôt que d’en regrouper plusieurs.
Prévoyez du temps
Les retouches ont pris de 45 à 120 secondes dans nos tests.
Rester compatible avec le travail
Ce modèle est strict avec les personnes ; réservez-le donc aux produits, lieux et portraits compatibles avec un usage professionnel.
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-pro/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.
























