Introduction
FLUX.2 [klein] 4B Retouche d’image modifie ou combine jusqu’à trois images source avec une instruction écrite, grâce au plus petit modèle FLUX.2 de Black Forest Labs, open source sous licence Apache 2.0. Gardez le format de votre première image avec auto, ou choisissez un ratio et un palier de taille 1k ou 2k. Chaque retouche coûte un prix fixe par image, et aucun filtre de contenu n’est appliqué.
Choisir un mode selon le matériau de départ
| Matériau de départ | Mode |
|---|---|
| une description écrite | FLUX.2 Klein 4B Texte vers image |
| une à trois images à modifier ou à combiner | FLUX.2 Klein 4B Retouche d’image |
Fonctionnalités et points forts
Jusqu’à trois références
Combinez deux portraits et un lieu, ou restylisez une seule photo. Le prix ne change pas avec le nombre de sources.
Des retouches qui gardent les personnes
Demandez un nouvel arrière-plan, une nouvelle lumière ou une autre météo en conservant les visages, les vêtements et la pose. Avec une source, cela fonctionne proprement ; avec trois, les visages peuvent dériver légèrement.
Ouvert, sans filtre
Rien n'est examiné ni refusé. Dans nos tests, les retouches ont conservé la source sans filtre telle quelle ; seul le niveau Très fort est revenu adouci.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Dites ce qui doit changer et ce qui doit rester identique, jusqu’à 5 000 caractères. Avec plusieurs sources, désignez-les par image 1, image 2 et image 3. 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. Obligatoire. 1 éléments minimum · 3 éléments maximum |
aspect_ratio | Non | Auto (par défaut) garde le format de la première source à environ un mégapixel. Ou choisissez l’un des neuf ratios, du 21:9 au 9:21. |
resolution | Non | 1k (par défaut) ou 2k, soit 2048 pixels sur le grand côté. Il ne s’applique que si vous choisissez un ratio ; avec auto, la taille est d’environ un mégapixel. |
seed | Non | Un nombre de 0 à 2147483647. Réutilisez-le pour comparer les retouches pendant que vous changez un détail du prompt. |
Tarification
$0.013 / 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
Changements d’arrière-plan et d’ambiance
Faites passer un couple d’une rue ensoleillée à une nuit de pluie au néon en un seul passage.
Amener des personnes dans un lieu
Placez deux portraits dans une photo de lieu pour des storyboards, des couvertures et des planches de personnages.
Restylisations rapides
Changez la lumière, la saison ou la palette pendant que la composition reste en place.
Guide de prompt et conseils pratiques
Protéger d’abord, changer ensuite
Ouvrez avec ce qui doit rester identique, puis décrivez seulement le changement. Des instructions courtes et concrètes donnent les meilleurs résultats.
Donnez un rôle à chaque source
Avec plusieurs images, dites ce qu’apporte chacune : cette personne, cette autre personne, ce lieu.
Vérifiez les détails
Avec deux ou trois sources, regardez les mains, les cheveux et les accessoires ; un petit objet en trop peut apparaître. Lancez une autre seed si quelque chose cloche.
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-4b/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.
