Introduzione
Qwen Image 2.1 Image Editing rielabora da una a dieci immagini sorgente seguendo un'istruzione scritta e restituisce una sola nuova inquadratura. Il team Qwen di Alibaba ha pubblicato i pesi del modello il 21 settembre 2026; questo endpoint è andato online qui lo stesso giorno.
Gira senza filtro sui contenuti e senza flag per adulti. Nei nostri test di accettazione ha portato un'immagine sorgente senza censura attraverso le nostre istruzioni senza rivestire il soggetto, senza sfocare nulla e senza ripiegare su una composizione più prudente: esattamente il modo di fallire che rende inutili per il lavoro senza censura quasi tutti gli endpoint di modifica.
Scegli la modalità di Qwen Image 2.1 in base al materiale di partenza
| Materiale di partenza | Modalità |
|---|---|
| Da una a dieci immagini sorgente su cui lavorare | Qwen Image 2.1 Modifica immagine |
| Solo un brief scritto | Qwen Image 2.1 Testo in immagine |
| Sorgenti più i tuoi pesi LoRA | Qwen Image 2.1 LoRA Modifica immagine |
Caratteristiche principali
Dieci riferimenti in una sola richiesta
Quasi tutti gli endpoint di modifica accettano una sorgente, o tre. Questo ne legge fino a dieci, ed è ciò che rende praticabile una serie coerente: tieni l'inquadratura che ha stabilito il personaggio, aggiungi il riferimento che porta l'outfit, aggiungi quello che porta il luogo e cambia una sola variabile per volta.
Le sorgenti restano come le invii
Un endpoint di modifica che riveste in silenzio il soggetto è peggio di uno che rifiuta, perché ti addebita l'immagine sbagliata. Gli abbiamo dato una sorgente senza censura con l'istruzione di mantenerla com'era e di aggiungere nuovi elementi: ha restituito esattamente quello, con ogni elemento richiesto al suo posto.
Ogni riferimento ha un prezzo, quindi il preventivo segue la richiesta
Aggiungere sorgenti alza il costo in modo lineare, e la stima mostrata prima dell'invio è quella che viene addebitata. A parità di fascia, una richiesta con dieci sorgenti costa diverse volte una con una sola: ottimo motivo per mandare i riferimenti che stanno lavorando e lasciare fuori gli altri.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Fino a 5.000 caratteri. almeno 1 caratteri · al massimo 5000 caratteri |
image_urls | Sì | Da una a dieci immagini di riferimento. almeno 1 elementi · al massimo 10 elementi |
mask_url | No | Immagine in bianco e nero facoltativa che porta la modifica in modalità locale: il bianco indica la zona da ridipingere, il nero resta com'è e qualche pixel di bordo sfumato aiu… |
aspect_ratio | No | Compone l'inquadratura prima della generazione invece di ritagliarla dopo, quindi scegli la forma in cui pubblicherai. |
resolution | No | La fascia che fissa dimensione dell'output e prezzo: 1k è il default ed è la più economica, 1.5k sta in mezzo, a 2k la grana della pelle, i capelli e la trama dei tessuti reggono. |
enable_prompt_expansion | No | Attivo di default: prima della generazione il prompt viene riscritto in una descrizione di scena più completa. Disattivalo per usare la tua formulazione così com'è. Predefinito: |
background | No | opaque di default. |
output_format | No | JPEG di default. PNG quando l'immagine entra in una fase di compositing, WebP quando va dritta in pagina. |
seed | No | Stabilizza l'estrazione, così una serie resta nella stessa zona. |
Prezzi
| Specifiche | Prezzo |
|---|---|
| $0.036 / immagine |
| $0.048 / immagine |
| $0.072 / immagine |
Casi d’uso
Coerenza del personaggio in un intero set
Tieni un'inquadratura approvata come riferimento d'identità e rilanciala con una nuova istruzione per ogni immagine. Molto più stabile che sperare in un seed per riprodurre un volto.
Comporre una scena per adulti a partire da una figura esistente
Parti da una figura che hai già e aggiungi il secondo soggetto, la costrizione, l'ambiente o i segni. Le istruzioni vengono eseguite come sono scritte.
Cambi di abbigliamento e di ambiente
Due riferimenti — uno per la persona, uno per il capo o per la stanza — e un prompt che dice qual è quale.
Alzare la risoluzione di uno scatto mantenendo il contesto
Rilancia un'inquadratura 1k come modifica a 2k con un'istruzione che conserva la composizione, quando vuoi il dettaglio senza rigenerare tutta la scena.
Consigli avanzati
Dichiara che cosa porta ogni riferimento
Il modello non deduce i ruoli. «La prima immagine è la donna, la seconda è la stanza in cui si trova» è la differenza tra una modifica e una fusione.
Di' che cosa non deve cambiare
Qui non c'è un negative prompt, quindi le protezioni vanno nell'istruzione principale. «Mantienila esattamente come nella sorgente, senza aggiungere nulla al suo abbigliamento» è la frase che impedisce a un modello di modifica di coprire un soggetto che ritiene debba essere coperto.
Manda meno riferimenti, ma migliori
L'identità regge bene con una sola sorgente pulita e deriva man mano che le sorgenti si accumulano. Poiché ogni riferimento aumenta anche il prezzo, di solito mandarne meno significa insieme spendere meno e ottenere un risultato più nitido.
Controlla il preventivo, non solo la fascia
Su questo endpoint il numero di riferimenti muove il prezzo quanto la fascia di risoluzione. La stima mostrata prima dell'invio fa fede: leggila prima di mandare una richiesta con dieci sorgenti.
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": "alibaba/qwen-image-2.1/edit",
"input": {
"aspect_ratio": "1:1",
"background": "opaque",
"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"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.

















