Introduction
FLUX.1 Fill Dev LoRA Inpainting redessine la partie masquée d’une image avec FLUX.1 Fill [dev], le modèle de remplissage de 12 milliards de paramètres de Black Forest Labs, avec jusqu’à trois de vos propres fichiers LoRA chargés. Le blanc du masque est repeint d’après votre prompt ; le noir revient tel quel. La plateforme n’ajoute aucun filtre de contenu au prompt, aux poids ni à l’image.
Fonctionnalités et points forts
Le reste de l’image est conservé
Lors de nos tests, la zone non masquée est revenue intacte et un masque entièrement noir a renvoyé la photo inchangée : un visage, une pièce ou une photo de produit survivent donc à la retouche.
Des remplissages qui épousent la lumière
Le modèle a été entraîné à se fondre dans son environnement : une robe de soie a pris la lumière au tungstène d’un atelier, et un sweat le soleil bas d’un studio, sans aucune consigne supplémentaire.
Vos propres LoRA dans le masque
Jusqu’à trois LoRA FLUX.1 dev se chargent par requête. Un LoRA pixel art a transformé un mur masqué en fresque ; un LoRA sans filtre a rendu ce que le modèle de base avait atténué.
Jusqu’à quatre essais par exécution
Demandez de une à quatre images sur le même masque et gardez le meilleur remplissage, facturé à l’image.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Décrivez ce qui doit se trouver dans la zone blanche : l’objet ou le vêtement, sa matière et la lumière qui l’éclaire. Placez l’expression déclencheuse d’un LoRA en premier. 1 caractères minimum · 5000 caractères maximum |
image_url | Oui | La photo à repeindre. Le résultat garde son ratio ; le palier de résolution fixe le grand côté. |
mask_url | Oui | Une image noir et blanc de la même taille que la source : le blanc est redessiné, le noir est conservé. |
resolution | Non | 1k renvoie un grand côté de 1 024 pixels et c’est la valeur par défaut ; 1.5k renvoie 1 536. Les côtés sont arrondis à l’inférieur au multiple de 32. |
num_outputs | Non | Combien d’essais sur le même masque, de 1 à 4 ; 1 par défaut. Chaque image est facturée : quatre images coûtent quatre fois le prix d’une seule. |
loras | Non | Jusqu’à trois entrées {path, scale} entraînées pour FLUX.1 dev ; scale de 0 à 4, 1 est neutre. Utilisez un lien direct public vers le fichier .safetensors. Valeur par défaut: |
guidance_scale | Non | À quel point le remplissage suit le prompt, de 28 à 35 ; 30 par défaut. Ne change pas le prix. |
steps | Non | Étapes de débruitage, de 1 à 50 ; 28 par défaut. Moins d’étapes reviennent plus vite et un peu plus doux. |
seed | Non | Garde les remplissages comparables pendant que vous changez le prompt ou un LoRA. Elle ne garantit pas les mêmes pixels à chaque exécution. |
Tarification
$0.042 / image
Facturé à l’image : une exécution de quatre images coûte quatre fois le prix d’une seule. Le palier de résolution et le chargement de LoRA ne changent pas le prix.
Cas d’utilisation
Mode et changements de garde-robe
Changez un vêtement, une couleur ou une encolure sur une photo terminée, tandis que le modèle, la pose et le décor restent exactement tels que photographiés.
Retouche
Repeignez une main, retirez un objet ou remplacez un élément d’arrière-plan en ne masquant que cette zone.
De l’art dans une scène
Masquez un mur, une toile ou une feuille de papier et peignez-y une fresque ou un croquis avec un LoRA de style.
Guide de prompt et conseils pratiques
Décrire la zone blanche
Écrivez ce qui va dans le masque et comment il est éclairé : "a floor-length crimson silk slip dress with thin straps, catching warm tungsten light". Inutile de redécrire le reste de la photo.
Masquer large
Incluez les bretelles, les cols, les capuches et les reflets dans les miroirs de tout ce que vous changez. Tout ce qui reste hors du masque demeure dans l’image.
Garder le masque sur le canevas de la source
Exportez le masque à la même taille que la photo. Un masque d’une autre taille est étiré, ce qui déplace la zone blanche.
Demander plusieurs essais
Les remplissages varient avec la graine. De deux à quatre images par exécution, c’est le moyen le plus rapide d’obtenir un bord propre.
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-1-fill-dev-lora/edit",
"input": {
"image_url": "https://example.com/reference.png",
"mask_url": "https://example.com/reference.png",
"num_outputs": 1,
"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.
