Introduction
FLUX 3 Klein Base LoRA 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, avec jusqu’à trois de vos fichiers LoRA chargés. 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’une des quinze, puis optez pour le 1k ou le 2k. Le modèle laisse parfois des vêtements en place.
Choisir un mode selon le matériau de départ
| Matériau de départ | Mode |
|---|---|
| une description écrite | FLUX 3 Klein Base LoRA Texte vers image |
| une à trois images à modifier ou combiner | FLUX 3 Klein Base LoRA Retouche d’image |
Fonctionnalités et points forts
LoRA de retouche
Les LoRA entraînés pour la retouche sur Klein Base changent la façon dont le modèle retouche. Un LoRA d’outpainting, appliqué à un portrait bordé de gris uni, a rempli le gris avec le reste d’un vestiaire de sauna et gardé l’image d’origine à sa place ; sans lui, la même requête redessinait davantage de la scène.
Plusieurs sources avec un LoRA
Combinez jusqu’à trois images et chargez des LoRA dans la même requête. Dites ce que chaque source apporte et mettez en premier le déclencheur ou l’instruction du LoRA, pour que le modèle sache quelle partie du prompt revient au LoRA.
Aucun contrôle des fichiers LoRA
Les fichiers LoRA et les résultats ne sont pas filtrés. Le modèle de base se retient lui-même aux niveaux plus forts : le résultat dépend donc du LoRA que vous apportez et de l’instruction que vous écrivez.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Obligatoire, jusqu’à 5 000 caractères. Mettez en premier le déclencheur ou l’instruction d’un LoRA, puis ce qui doit rester et ce qui change. 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 ; ou choisissez l’une des quinze formes, de 3:1 à 1:3. Pour un outpainting, prenez la forme de la toile remplie. |
resolution | Non | 1k (par défaut) ou 2k, aussi appliqué avec auto. Le 2k coûte plus cher pour la sortie et pour chaque source. |
loras | Non | Jusqu’à trois entrées {path, scale} entraînées pour FLUX 3 Image Klein ; scale de 0 à 4, 1 par défaut. Les LoRA de retouche entraînés vont ici. Valeur par défaut: |
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 un LoRA et l’absence de LoRA ; 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. Les LoRA, le ratio et le format de sortie ne changent pas le prix.
| Spécification | Prix |
|---|---|
| $0.06 / image |
| $0.222 / image |
Cas d’utilisation
Outpainting et recadrage
Bordez une image de gris pour l’élargir ou la rallonger, et laissez un LoRA d’outpainting prolonger la scène, pour des bannières et des formats sociaux découpés à partir de portraits.
Stylisme avec des références
Placez un vêtement d’une photo produit sur une personne d’une autre photo, pendant qu’un LoRA fixe le rendu de la série.
Guide de prompt et conseils pratiques
Suivez la fiche du LoRA à la lettre
Les LoRA de retouche attendent souvent une instruction fixe et une entrée préparée, comme un remplissage gris uniforme #808080 pour l’outpainting. Recopiez l’instruction de la fiche en début de prompt et préparez l’image de la même façon.
Choisissez la forme de la toile
Pour l’outpainting, réglez le ratio sur la forme de la toile remplie, ou laissez auto pour que la première image décide. Le modèle garde cette forme au palier de taille choisi.
Comparez avec la même seed
Lancez la même retouche avec et sans LoRA. Les retouches sont proches, mais pas toujours identiques au pixel près d’un passage à l’autre ; cherchez donc une différence nette avant de l’attribuer au LoRA.
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-lora/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.
