Introduction
FLUX 3 Klein Base Retouche d’image modifie ou combine une à trois images sources à partir d’une instruction écrite sur le FLUX 3 Image Klein Base de Black Forest Labs, le point de contrôle non distillé de 5,6 milliards de paramètres. Désignez les sources par image 1, image 2 et image 3, gardez la forme de la première image avec auto ou choisissez l’un des quinze formats, puis optez pour le 1k ou le 2k. Dans nos tests, une retouche a pris environ 20 à 40 secondes en 1k, et rien n’est filtré.
Choisir un mode selon le matériau de départ
| Matériau de départ | Mode |
|---|---|
| une description écrite | FLUX 3 Klein Base Texte vers image |
| une à trois images à modifier ou combiner | FLUX 3 Klein Base Retouche d’image |
Fonctionnalités et points forts
Vêtements d’une photo produit
Donnez la personne en image 1 et un vêtement photographié sur un cintre en image 2, et la retouche habille l’une avec l’autre. Dans nos tests, une femme en parka d’hiver est revenue en robe-nuisette de velours bordeaux, dans un vestiaire de sauna, avec son visage et ses cheveux conservés.
La même personne, un nouveau lieu
Le visage, la barbe et la carrure ont suivi un changement complet de tenue et de décor : un randonneur en veste rouge dans une forêt enneigée est devenu le même homme, en chemise de lin ouverte sur un banc de cèdre. Des instructions courtes et concrètes ont le mieux conservé les visages.
Combiner jusqu’à trois images
Deux photos séparées de deux femmes sont devenues une scène unique sur un banc de sauna, dans des robes assorties, avec les deux visages reconnaissables. Avec trois sources, dites ce que chacune apporte pour que rien ne soit perdu.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Obligatoire, jusqu’à 5 000 caractères. Nommez ce qui doit rester (visage, cheveux, carrure), puis le changement. 1 caractères minimum · 5000 caractères maximum |
image_urls | Oui | Obligatoire, une à trois images publiques, de 10 Mo maximum chacune. Un lien qui ne s’ouvre pas ou qui n’est pas une image fait échouer la requête sans facturation. 1 éléments minimum · 3 éléments maximum |
aspect_ratio | Non | auto (par défaut) garde la forme de la première source : un portrait de 880 x 1184 est revenu en 880 x 1184 avec |
resolution | Non | 1k (par défaut) ou 2k, appliqué aussi avec auto. Le 2k coûte environ quatre fois le 1k pour la sortie, et le double par source. |
output_format | Non | JPEG (par défaut), PNG ou WebP. Ne change pas le prix. |
seed | Non | Facultatif, de 0 à 2 147 483 647. Réutilisez-la pour comparer des changements de prompt ; les retouches sont proches, mais pas toujours identiques au pixel près. |
Tarification
Facturé à l’image : une charge pour le palier de taille de sortie et une charge pour chaque image source, toutes deux plus élevées en 2k. Le ratio et le format de sortie ne changent pas le prix.
| Spécification | Prix |
|---|---|
| $0.054 / image |
| $0.216 / image |
Cas d’utilisation
Lookbooks et stylisme
Placez un vêtement d’une photo produit sur une personne d’une autre photo, dans un nouveau lieu et une nouvelle lumière, pour des lookbooks et des planches d’ambiance.
Changements de lieu et de tenue
Déplacez une personne dans un nouveau décor et une nouvelle tenue en une seule passe, tout en gardant son identité, pour des fiches de personnage et des séries.
Guide de prompt et conseils pratiques
Utilisez les numéros d’image
Écrivez image 1, image 2 et image 3 dans l’ordre d’import, et donnez un rôle à chacune : la femme de l’image 1, la robe de l’image 2. La première image fixe aussi la forme quand le ratio est auto.
Protégez d’abord, changez ensuite
Commencez par ce qui doit rester identique, comme le visage, les cheveux et la carrure, puis décrivez le changement : vêtement, lieu, pose et lumière. Le modèle peut laisser des vêtements en place ; dites donc exactement ce que la personne doit porter.
Surveillez le prix par source
Chaque source ajoute au prix, et le 2k double cette charge. Utilisez une seule source quand une suffit, et faites vos brouillons en 1k.
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-base/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.
