Introduction
FLUX.2 Dev Retouche d’image modifie ou combine jusqu’à trois images source avec FLUX.2 [dev] de Black Forest Labs, un modèle à poids ouverts de 32 milliards de paramètres. Décrivez la nouvelle tenue, le nouveau décor ou la nouvelle lumière, indiquez ce qui doit rester, et recevez une image. Il garde les visages proches des sources, peut placer dans une même scène des personnes issues de photos distinctes et n’applique aucun filtre aux sources, au prompt ni au résultat.
Choisir un mode selon le matériau de départ
| Matériau de départ | Mode |
|---|---|
| une à trois images à modifier ou à combiner | FLUX.2 Dev Retouche d’image |
| un brief écrit uniquement | FLUX.2 Dev Texte vers image |
Fonctionnalités et points forts
Jusqu’à trois références
Listez les images dans l’ordre où votre prompt les mentionne et désignez-les par image 1, image 2 et image 3. Lors de notre test, une femme issue d’un portrait et un homme issu d’un autre dansaient ensemble dans une nouvelle scène, avec les deux visages toujours proches de leurs photos.
Un cadrage qui suit la source
Avec le format sur auto, le résultat garde les proportions de la première image à environ un mégapixel. Choisissez un ratio et le 2k quand vous voulez un autre recadrage ou plus de pixels.
Un prix fixe
Le prix par image reste le même pour une, deux ou trois sources, et en 1k comme en 2k.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Jusqu’à 5 000 caractères. Dites ce qui doit changer et ce qui doit rester identique. 1 caractères minimum · 5000 caractères maximum |
image_urls | Oui | Une à trois images source de 10 Mo maximum chacune, dans l’ordre où votre prompt les mentionne (« image 1 », « image 2 »). 1 éléments minimum · 3 éléments maximum |
aspect_ratio | Non | auto (par défaut) suit le format de la première image source, à environ un mégapixel. Choisissez l’un des neuf ratios, du 21:9 au 9:21, pour recadrer. |
resolution | Non | 1k (par défaut) ou 2k, pris en compte uniquement si vous choisissez un ratio précis. Avec auto, le résultat reste à environ un mégapixel. |
seed | Non | Un nombre entier de 0 à 2 147 483 647. Gardez-le fixe pendant que vous ajustez le prompt pour comparer facilement les résultats ; il ne garantit pas une image identique. |
Tarification
$0.023 / image
Facturation à l’image à un prix fixe, quel que soit le nombre d’images source ou le palier de taille. Les requêtes en échec ne sont pas facturées.
Cas d’utilisation
Une nouvelle tenue et un nouveau décor pour la même personne
Faites passer une personne d’un bureau à un bar ou d’une rue à une plage, avec une autre tenue et une autre lumière, sans changer son visage.
Deux personnes dans une même scène
Réunissez dans un seul cadre des personnes issues de portraits distincts, pour une photo de couple ou un duo de personnages.
Changements de lumière et de couleur
Demandez une nouvelle source de lumière avec une couleur hexadécimale et gardez le reste de la composition.
Guide de prompt et conseils pratiques
Dites ce qui reste
Commencez par « même homme, même visage et même barbe », puis listez ce qui change. De courtes listes explicites fonctionnent mieux que de longues descriptions.
Numérotez vos personnes
Quand vous combinez des photos, écrivez « la femme de l’image 1 et l’homme de l’image 2 » et demandez de garder les deux visages exactement comme sur les photos.
Une seule personne par cadre quand c’est important
Ajoutez « seul dans le cadre, aucune autre personne » pour éviter que des figurants n’apparaissent à l’arrière-plan.
Commencez par auto
Laissez d’abord le format sur auto. Choisissez un ratio et le 2k une fois le contenu à votre goût, et gardez la seed pour comparer la version plus grande.
Utilisez des sources nettes
Les photos bien éclairées et de face reportent le mieux les visages. La deuxième et la troisième personne sont un peu moins stables que la première.
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-dev/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.
























