Introduction
FLUX 3 Klein Retouche d’image modifie une à trois images de référence que vous importez sur FLUX 3 Klein de Black Forest Labs, le modèle à poids ouverts de 5,6 B publié en octobre 2026, dans sa version distillée en quelques étapes. Choisissez 1k ou 2k et l’un des quinze ratios d’image, récupérez un JPEG, PNG ou WebP, et payez à l’image. La plateforme n’ajoute aucun filtre de contenu.
Choisir un mode selon le matériau de départ
| Matériau de départ | Mode |
|---|---|
| une description écrite | FLUX 3 Klein Texte vers image |
| une à trois images à modifier | FLUX 3 Klein Retouche d’image |
Fonctionnalités et points forts
Nommez chaque source
Écrivez <ref_image_1>, <ref_image_2> et <ref_image_3> dans le prompt, dans l’ordre d’import, la notation que Black Forest Labs documente pour ce modèle. Lors de nos tests, un vêtement ou un chapeau d’une photo a été posé sur une personne d’une autre, son visage conservé.
Aucun filtre de contenu
Les prompts, les sources et les résultats ne sont pas examinés. Lors de nos tests, des portraits de femmes majeures sans filtre sont passés et des retouches sans filtre ont été exécutées comme demandé ; seules les requêtes les plus fortes ont été atténuées par le modèle lui-même.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Obligatoire, jusqu’à 5 000 caractères. Désignez les sources par < |
image_urls | Oui | Obligatoire, une à trois liens publics vers des images, de 10 Mo maximum chacune, dans l’ordre où votre prompt les désigne. 1 éléments minimum · 3 éléments maximum |
aspect_ratio | Non | auto (par défaut) garde la forme de la première image, par exemple 880 x 1184 avec |
resolution | Non | 1k (par défaut) fait environ un mégapixel ; le 2k en fait environ quatre, par exemple 1760 x 2368 pour une source en portrait. Le 2k coûte plus cher. |
output_format | Non | jpeg (par défaut), png ou webp. Même prix pour les trois. |
seed | Non | Facultative, de 0 à 2 147 483 647. Réutilisez-la pour comparer des formulations sur les mêmes sources. |
Tarification
Facturée à l’image selon le palier de taille (1k ou 2k) ; chaque image de référence après la première ajoute une petite somme. Le ratio d’image et le format de fichier ne changent pas le prix.
| Spécification | Prix |
|---|---|
| $0.0192 / image |
| $0.0768 / image |
Cas d’utilisation
Échanges de tenues et d’accessoires
Placez une robe, un chapeau ou une veste d’une photo produit sur une personne d’une autre photo, en une seule requête.
Relumière et changement de style
Faites passer un matin à un coucher de soleil, ou midi à l’heure bleue, pendant que le visage et la pièce restent.
Guide de prompt et conseils pratiques
Rédigez une légende complète
Décrivez le cadrage, le sujet, les vêtements, le lieu, la lumière et l’objectif en phrases complètes. Il n’y a pas de prompt négatif : dites ce que vous voulez plutôt que ce que vous voulez éviter.
Listez ce qui reste
À côté du changement, nommez ce qui ne doit pas bouger : le visage, les cheveux, la pose, la pièce. Sans cela, le modèle est libre de réinterpréter tout le cadre.
Brouillon en 1k, finition en 2k
Fixez la seed pendant le travail en 1k, puis relancez les mêmes entrées en 2k pour l’image finale.
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-3-klein/edit",
"input": {
"aspect_ratio": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"output_format": "jpeg",
"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.
