Introduzione
FLUX.1 Fill Dev LoRA Inpainting ridisegna la parte mascherata di un’immagine con FLUX.1 Fill [dev], il modello di riempimento da 12 miliardi di parametri di Black Forest Labs, con fino a tre file LoRA tuoi caricati. Il bianco della maschera viene ridipinto secondo il tuo prompt; il nero torna com’era. La piattaforma non aggiunge alcun filtro sui contenuti a prompt, pesi o immagine.
Caratteristiche principali
Il resto dell’immagine resta
Nei nostri test l’area non mascherata è tornata intatta e una maschera tutta nera ha restituito la foto invariata, quindi un volto, una stanza o uno scatto di prodotto sopravvivono alla modifica.
Riempimenti che si adattano alla luce
Il modello è stato addestrato per fondersi con ciò che lo circonda: un abito di seta ha raccolto la luce al tungsteno di un atelier e una felpa il sole basso di una sala, senza bisogno di indicazioni aggiuntive.
I tuoi LoRA dentro la maschera
Per richiesta si caricano fino a tre LoRA per FLUX.1 dev. Un LoRA pixel art ha trasformato un muro mascherato in un murale; un LoRA senza filtri ha restituito ciò che il modello base aveva ammorbidito.
Fino a quattro versioni per esecuzione
Chiedi da una a quattro immagini sulla stessa maschera e scegli il riempimento migliore, addebitato per immagine.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Descrivi cosa deve stare nell’area bianca: l’oggetto o il capo, il suo materiale e la luce in cui si trova. Metti per prima la frase trigger del LoRA. almeno 1 caratteri · al massimo 5000 caratteri |
image_url | Sì | La foto da ridipingere. Il risultato ne mantiene le proporzioni; il livello di risoluzione stabilisce il lato lungo. |
mask_url | Sì | Un’immagine in bianco e nero delle stesse dimensioni dell’originale: il bianco viene ridisegnato, il nero resta. |
resolution | No | 1k restituisce un lato lungo di 1.024 pixel ed è il default; 1.5k restituisce 1.536. I lati vengono arrotondati per difetto a un multiplo di 32. |
num_outputs | No | Quante versioni sulla stessa maschera, da 1 a 4; 1 di default. Ogni immagine viene addebitata, quindi quattro immagini costano quattro volte una sola. |
loras | No | Fino a tre voci {path, scale} addestrate per FLUX.1 dev; scale da 0 a 4, 1 è neutro. Usa un link diretto pubblico al file .safetensors. Predefinito: |
guidance_scale | No | Quanto rigorosamente il riempimento segue il prompt, da 28 a 35; 30 di default. Non cambia il prezzo. |
steps | No | Passi di denoising, da 1 a 50; 28 di default. Meno passi significano risultati più rapidi e un po’ più morbidi. |
seed | No | Mantiene confrontabili i riempimenti mentre cambi il prompt o un LoRA. Non garantisce gli stessi identici pixel a ogni esecuzione. |
Prezzi
$0.042 / immagine
Addebitato per immagine: un’esecuzione da quattro immagini costa quattro volte una sola. Livello di risoluzione e caricamento dei LoRA non cambiano il prezzo.
Casi d’uso
Moda e cambi di guardaroba
Cambia un capo, un colore o una scollatura su una foto finita, mentre modella, posa e set restano esattamente come nello scatto.
Ritocco
Ridipingi una mano, rimuovi un oggetto o sostituisci un elemento dello sfondo mascherando solo quella zona.
Arte dentro una scena
Maschera una parete, una tela o un foglio di carta e dipingici sopra un murale o uno schizzo con un LoRA di stile.
Consigli avanzati
Descrivi l’area bianca
Scrivi cosa va nella maschera e come è illuminato: "a floor-length crimson silk slip dress with thin straps, catching warm tungsten light". Non serve ridescrivere il resto della foto.
Maschera con generosità
Includi spalline, colletti, cappucci e riflessi allo specchio di ciò che cambi. Quello che resta fuori dalla maschera resta nell’immagine.
Tieni la maschera sul canvas dell’originale
Esporta la maschera con le stesse dimensioni della foto. Una maschera di dimensioni diverse viene stirata, e questo sposta l’area bianca.
Chiedi più versioni
I riempimenti variano con il seed. Da due a quattro immagini per esecuzione sono il modo più rapido per ottenere un bordo pulito.
Avvio rapido dell’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"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.
