Introduction
FLUX.2 [klein] 9B Retouche est le mode retouche du petit modèle d’image rapide de Black Forest Labs, publié le 15 janvier 2026. Il accepte une à trois images source et une instruction, renvoie un JPEG à environ un mégapixel ou au palier 1k ou 2k de votre choix, et n’a aucun filtre de contenu.
Choisir un mode selon le matériau de départ
| Matériau de départ | Mode |
|---|---|
| un brief écrit | FLUX.2 Klein 9B Texte vers image |
| des images à modifier | FLUX.2 Klein 9B Retouche |
Fonctionnalités et points forts
Même personne, nouveau look
Lors de nos tests, le visage, les cheveux et la pose ont été conservés malgré les changements de tenue et d’arrière-plan. Listez ce qui doit rester, puis décrivez le changement.
Redimensionner pendant la retouche
Choisissez un format et un palier de taille, et la retouche revient à 2048 pixels sur le grand côté. Avec auto, elle garde le format de la source.
Un prix fixe
Une retouche coûte le même prix avec une source ou avec trois, en 1k comme en 2k.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Obligatoire, jusqu’à 5 000 caractères. Dites ce qui doit changer et ce qui doit rester identique, par exemple le visage, les cheveux et la pose, et nommez les nouveaux vêtements. 1 caractères minimum · 5000 caractères maximum |
image_urls | Oui | Obligatoire, une à trois images source de 10 Mo maximum chacune, dans l’ordre où votre prompt les mentionne. Le nombre d’images ne change pas le prix. 1 éléments minimum · 3 éléments maximum |
aspect_ratio | Non | auto (par défaut) garde le format 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. Ne change pas le prix. |
seed | Non | Nombre entier facultatif de 0 à 2 147 483 647. Réutilisez-le pour comparer côte à côte des variantes du prompt ; laissez le champ vide pour une seed aléatoire. |
Tarification
$0.016 / image
Un prix fixe par image, quel que soit le nombre d’images source et que la taille soit en 1k ou en 2k. Les requêtes en échec ou refusées ne sont pas facturées.
Cas d’utilisation
Changements de tenue et de décor
Changez les vêtements, la pièce ou le moment de la journée en gardant les personnes reconnaissables.
Variantes rapides d’une photo
Plusieurs ambiances d’une même image, le temps d’un café.
Combiner jusqu’à trois sources
Une personne, un lieu et un objet réunis dans un même cadre, chacun désigné dans le prompt.
Guide de prompt et conseils pratiques
Nommez ce qui reste
Visage, cheveux, pose, place assise. Puis décrivez le changement en une ou deux phrases.
Nommez les nouveaux vêtements
Précisez la coupe et la matière voulues. Lors de nos tests, la retouche a suivi les vêtements nommés dans le prompt.
Changez une seule chose à la fois
Pour les transformations plus importantes, enchaînez deux retouches.
Choisissez un format pour le 2k
Auto donne environ un mégapixel ; choisissez un format si vous voulez le palier 2k.
Vérifiez les mains et les visages
Les petits modèles peuvent déraper sur les deux. Essayez une autre seed si c’est le cas.
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-klein-9b/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.
























