Introduzione
Invia un’immagine di partenza e descrivi il risultato. L’intensità decide quanto l’output si allontana dall’originale; aggiungi una maschera in bianco e nero e viene ridisegnata solo l’area bianca, il resto resta com’era. Puoi caricare fino a tre file LoRA addestrati per FLUX.1 [dev], il prezzo per immagine è fisso e niente viene filtrato.
| Campo | Valore |
|---|---|
| Input | Immagine |
| Output | Immagine |
| Endpoint | Testo in immagine e modifica di immagini (intensità, maschera di inpainting facoltativa), entrambi con supporto LoRA |
| Modello base | FLUX.1 [dev], il rectified flow transformer di Black Forest Labs da 12 miliardi di parametri |
| Input LoRA | Fino a 3 voci, ciascuna {path, scale}; path è un URL HTTPS diretto a un file .safetensors |
| Intensità del LoRA | Da 0 a 4 per voce (1 di default) |
| Guidance | Da 0 a 20 (3,5 di default) |
| Dimensioni dell’output | Circa un megapixel: 1024 x 1024 in 1:1, 1344 x 768 in 16:9, 1536 x 640 in 21:9 |
| Proporzioni | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21 |
| Formati di output | JPEG (default), PNG, WebP |
Caratteristiche principali
Fotografie, non render
Un LoRA Super Realism e un divanetto a tarda notte accanto a una finestra bagnata dalla pioggia: due uomini che si sporgono l’uno verso l’altro sotto una calda lampada a sospensione. Pelle, tessuti e luce della finestra si leggono come in una fotografia.
Un look da rivista con un solo trigger
"MJ v6" e un LoRA in stile Midjourney danno a FLUX una finitura editoriale patinata: un abito da sera di raso rosso con la schiena scoperta su una scalinata di marmo, illuminato di lato.
Cambia l’intero medium
Un LoRA cartoon dagli arti allungati a 1,2 trasforma lo stesso modello in un illustratore pin-up: un ombrello rosso, una strada di ciottoli bagnata e proporzioni esagerate.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Descrivi l’intera immagine che vuoi ottenere. Con una maschera, descrivi cosa deve comparire nell’area bianca. almeno 1 caratteri · al massimo 5000 caratteri |
image_url | Sì | L’immagine da modificare. Il risultato ne mantiene la forma a circa 0,7 megapixel: nei nostri test un originale 1024 x 1536 è tornato a 672 x 1008. |
mask_url | No | Facoltativa. Un’immagine in bianco e nero delle stesse dimensioni dell’originale: le aree bianche vengono ridisegnate dal prompt, quelle nere restano come sono. |
strength | No | Quanto allontanarsi dall’originale, da 0 a 1 (predefinito 0,8). Con una maschera usa da 0,9 a 1 perché l’area bianca cambi davvero. |
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 il risultato segue il prompt, da 0 a 20 (predefinito 3,5). I LoRA di realismo spesso rendono più naturali un po’ più in basso. |
steps | No | Passi di denoising, da 1 a 50 (predefinito 28). Più passi richiedono più tempo. |
output_format | No | JPEG di default, PNG o WebP se ti servono. Non cambia il prezzo. |
seed | No | Mantiene i risultati confrontabili mentre regoli intensità o maschera; lo stesso seed non garantisce un’immagine identica. |
Prezzi
$0.018 / immagine
Si paga per immagine a prezzo fisso. Maschera, intensità, passi e LoRA non costano in più.
Casi d’uso
Il LoRA che hai già trovato
Se il look che cerchi esiste su Hugging Face o su un hub della community come LoRA per FLUX, qui gira come una semplice chiamata API: incolla il link del file, imposta lo scale, scrivi il prompt.
Immagini di moda ed editoriali
I LoRA di realismo e in stile rivista ti danno abiti da sera con la schiena scoperta su scalinate di marmo e divanetti notturni accanto a finestre bagnate dalla pioggia, con luce e pelle credibili.
Campagne stilizzate
I LoRA cartoon, pin-up e di illustrazione trasformano un unico modello di prompt in una serie coerente in nove formati.
Immagini senza censura
I LoRA senza filtri vengono caricati senza revisione e il risultato non viene filtrato, per piattaforme i cui utenti si aspettano questa libertà.
Consigli avanzati
Trova il trigger del LoRA
La maggior parte dei LoRA per FLUX indica una frase trigger nella propria scheda del modello, come "Super Realism" o "MJ v6". Mettila all’inizio del prompt, poi descrivi l’immagine.
Regola la guidance con i LoRA di realismo
La guidance di default è 3,5. I LoRA di realismo spesso rendono in modo più naturale tra 2 e 3,5; valori molto alti spingono verso un look patinato e troppo nitido.
Alza lo scale per gli stili forti
Alcuni LoRA di stile hanno bisogno di uno scale sopra 1 per prendere il sopravvento. Il nostro esempio cartoon è stato generato a 1,2; parti da 1 e muoviti a passi di 0,2.
Controlla che il file sia pubblico
Usa un link diretto che scarichi il file .safetensors. I repository ad accesso limitato rispondono con HTTP 401 e la richiesta fallisce prima che venga creata qualsiasi immagine.
Introduzione
FLUX.1 Dev LoRA Modifica immagine cambia un’immagine di partenza su FLUX.1 [dev] di Black Forest Labs, guidata dal tuo prompt e da fino a tre file LoRA tuoi. Senza maschera cambia stile all’intera immagine, e un valore di intensità da 0 a 1 decide quanto si allontana dall’originale. Con una maschera in bianco e nero ridisegna solo l’area bianca e mantiene il resto. Il risultato torna in JPEG, PNG o WebP a prezzo fisso, e niente viene filtrato.
Scegli la modalità in base al materiale
| Cosa hai | Modalità |
|---|---|
| un’immagine da cambiare, in tutto o in parte | FLUX.1 Dev LoRA Modifica immagine |
| solo una descrizione scritta | FLUX.1 Dev LoRA Testo in immagine |
Funzionalità e punti di forza
Inpainting con maschera
Colora di bianco l’area da cambiare e di nero tutto il resto. Nei nostri test, una maschera sulla parte superiore del corpo di un ritratto in studio ha cambiato solo quell'area, mentre volto, capelli e pantaloni sono rimasti invariati.
Un’intensità facile da capire
Il valore predefinito 0,8 mantiene posa e composizione; 0,95 lascia ridisegnare quasi tutto, viso compreso. Con una maschera, da 0,9 a 1 garantisce che l’area bianca cambi davvero.
Senza censura, con pesi tuoi
Originale, prompt, pesi e risultato non vengono mai filtrati. Con forza 0,95 un ritratto in studio è stato modificato come richiesto dal nostro test più spinto, con e senza un LoRA senza filtri.
Casi d’uso
Cambiare una parte di una foto
Sostituisci un outfit, uno sfondo o un oggetto lasciando intatto il resto dell'immagine, per varianti di prodotto, test di guardaroba o ritocco di ritratti.
Cambiare stile con un LoRA della community
Fai passare una foto per uno degli oltre mille LoRA FLUX per darle l’aspetto della pellicola, una lucentezza editoriale o un tratto da illustrazione, con la composizione ferma.
Guida ai prompt e consigli
Descrivi il risultato, non l’istruzione
Scrivi cosa deve contenere l’immagine finale. Con una maschera, descrivi solo ciò che deve comparire nell'area bianca, come «un top di velluto nero, luce da studio morbida».
Ammorbidisci i bordi netti della maschera
Un rettangolo netto lascia una cucitura visibile dove incontra i pixel conservati. Sfuma il bordo della maschera o segui il contorno dell’oggetto da sostituire.
Parti da 0,8 e muoviti di 0,05 alla volta
Se l’originale traspare, alza l’intensità; se il viso si sposta, abbassala. Tieni fisso il seed mentre confronti, così cambia solo l’intensità.
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-dev-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"
}
}'
# 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.
