Introduzione
FLUX.1 Schnell LoRA Modifica immagine ridisegna un’immagine di partenza su FLUX.1 [schnell], il modello FLUX veloce con licenza Apache-2.0 di Black Forest Labs, con fino a tre file LoRA tuoi caricati. Un controllo di strength stabilisce quanto il risultato si allontana dalla sorgente, una maschera facoltativa limita il cambiamento a un’area, e l’output mantiene la proporzione della sorgente. La piattaforma non aggiunge alcun filtro sui contenuti a prompt, pesi o immagine.
Scegli la modalità in base al materiale di partenza
| Cosa hai | Modalità |
|---|---|
| una descrizione scritta | FLUX.1 Schnell LoRA Testo in immagine |
| un’immagine a cui dare un nuovo stile o da ritoccare con inpainting | FLUX.1 Schnell LoRA Modifica immagine |
Caratteristiche principali
Vero inpainting con una maschera
Invia una maschera in bianco e nero e viene ridisegnata solo l’area bianca. Nel nostro test un trench è diventato una vestaglia di raso rosso mentre volto, capelli e la palestra alle spalle sono rimasti esattamente com’erano.
Modifiche sull’intera inquadratura con una manopola di strength
Senza maschera viene ridisegnata l’intera inquadratura. Una strength da 0,8 a 0,9 ha mantenuto inquadratura e posa cambiando abito e ambientazione.
LoRA sulle modifiche
I LoRA per FLUX.1 [dev] si caricano anche nella modifica, fino a tre alla volta, ciascuno con uno scale da 0 a 4.
Nessun filtro sui contenuti
Le immagini di partenza possono essere ridisegnate con qualsiasi prompt, dentro una maschera o sull'intera inquadratura. Nulla viene filtrato né in entrata né in uscita.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Con una maschera, descrivi solo ciò che va nell’area bianca. Senza, descrivi l’intera immagine compreso chi c’è. almeno 1 caratteri · al massimo 5000 caratteri |
image_url | Sì | L’immagine da modificare. Il risultato ne mantiene la proporzione; il livello di risoluzione imposta il lato lungo. |
mask_url | No | Maschera facoltativa in bianco e nero delle dimensioni della sorgente: le aree bianche vengono ridisegnate, quelle nere vengono mantenute. |
resolution | No | 1k restituisce un lato lungo di circa 1.000 pixel ed è il valore predefinito; 1.5k circa 1.500. Costano uguale, e la proporzione segue sempre la sorgente. |
strength | No | Quanto allontanarsi dalla sorgente, da 0 a 1; 0,8 di default. |
loras | No | Fino a tre voci {path, scale} addestrate per FLUX.1 [dev] o FLUX.1 [schnell]; scale da 0 a 4, 1 di default. I LoRA si applicano anche dentro una maschera e non cambiano il prezzo. Predefinito: |
output_format | No | JPEG di default, oppure PNG o WebP. Il formato non cambia il prezzo. |
seed | No | Mantiene confrontabili i risultati mentre regoli la strength o la maschera. Senza seed ne viene usato uno casuale. |
Prezzi
$0.006 / immagine
Addebitato per immagine, alla stessa tariffa del testo in immagine. Maschera, livello di risoluzione, formato di output e caricamento dei LoRA non cambiano il prezzo.
Casi d’uso
Cambiare un solo capo
Maschera i vestiti, descrivi il nuovo capo e lascia intatti la persona e la stanza.
Dare un nuovo stile a un servizio
Esegui una serie di foto a strength da 0,8 a 0,9 con lo stesso prompt e lo stesso LoRA per ottenere abiti o ambientazioni nuovi e coerenti.
Varianti veloci
Tieni sorgente e prompt, cambia il seed e ottieni versioni alternative in pochi secondi.
Consigli avanzati
Modella la maschera sull’oggetto
Un rettangolo netto che tagliava i capelli ha lasciato una cucitura visibile nel nostro test. Una maschera che segue il capo si è fusa in modo pulito.
Con una maschera, descrivi solo l’area mascherata
"A red satin boxing robe slipping off one shoulder" basta; il resto dell’immagine viene mantenuto dalla sorgente.
Senza maschera, descrivi la persona
Sopra strength 0,85 i volti si scostano dall’originale. Ripetere chi c’è nell’immagine ha mantenuto le persone riconoscibili nei nostri test.
Scegli la strength in base al lavoro
0,5 cambia appena la foto, intorno a 0,7 cambiano i dettagli, da 0,85 a 0,9 è un abito nuovo nella stessa inquadratura, e 1 è un’immagine nuova. Con una maschera, usa da 0,9 a 1.
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-schnell-lora/edit",
"input": {
"image_url": "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"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.



























