Introduzione
Qwen Image 2 Modifica immagine riceve esattamente un’immagine di riferimento e un’istruzione e restituisce un solo risultato modificato: con una nuova luce, un nuovo stile, abiti diversi o una scritta aggiunta, come descrive il prompt.
Qwen Image 2 è il modello di immagini generalista di Alibaba: prompt fino a 800 caratteri letti in modo nativo in cinese o in inglese, cinque formati nel testo in immagine e un endpoint di modifica che rielabora un riferimento nel formato che scegli. Un’immagine per richiesta, con un seed facoltativo per tenere ferma un’estrazione mentre confronti.
Scegli la modalità di Qwen Image 2 in base al materiale di partenza
| Materiale di partenza | Modalità |
|---|---|
| Una direzione artistica o un brief di design scritto | Qwen Image 2 Testo in immagine |
| Un’immagine sorgente approvata da rivedere | Qwen Image 2 Modifica immagine |
Caratteristiche principali
Prompt in due lingue
Qwen Image 2 legge direttamente prompt in cinese e in inglese, così il team può lavorare nella lingua in cui il brief è più chiaro, senza riscriverlo al momento del passaggio.
Una modifica scritta su un’immagine fornita
La modalità di modifica parte da un’immagine fornita e da un’istruzione scritta. Usala quando identità o composizione esistono già e la revisione riguarda un cambiamento voluto, non un concetto nuovo.
Due punti di partenza ben distinti
Il testo in immagine serve a costruire una scena nuova da una direzione artistica; la modifica serve a rivedere un’immagine sorgente. Scegliere prima il materiale di partenza evita di giudicare un brief di modifica come una generazione da zero.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Fino a 800 caratteri che descrivono il risultato, non la sorgente. Di' che cosa deve restare identico e che cosa cambia; ciò che non dici può derivare. almeno 1 caratteri · al massimo 800 caratteri |
image_urls | Sì | Esattamente un URL jpeg, png o webp raggiungibile pubblicamente, per un'immagine di cui detieni i diritti. almeno 1 elementi · al massimo 1 elementi |
aspect_ratio | No | 1:1 per impostazione predefinita, oppure 4:3, 3:4, 16:9, 9:16, 3:2, 2:3 e 21:9. |
seed | No | Omettilo per una nuova estrazione a ogni chiamata; impostalo per confrontare due formulazioni dello stesso edit a parità di estrazione. |
Prezzi
$0.035 / immagine
Casi d’uso
Rifinire un’immagine fornita
Usa questa modalità quando una foto esistente deve fissare soggetto, composizione o stile. Inviala come unica voce di image_urls, di’ cosa cambia e cosa deve restare identico, e confronta il risultato con l’originale alla dimensione in cui verrà usato.
Un prodotto in una scena nuova
Invia la foto del prodotto e descrivi l’ambiente in cui deve stare, compresa la luce che deve ricevere. Una chiamata, un’immagine. Se l’ambiente deve arrivare da una seconda foto, usa un modello di modifica che accetta più riferimenti.
Produzione di campagne bilingue
Adatta un key visual approvato a un altro mercato chiedendo una scritta su una superficie libera, riportata nel prompt esattamente come deve apparire, in cinese o in inglese. Tienila breve: insegne e testi lunghi sono compito della linea Qwen Image 3.0.
Personaggi e costumi
Tieni la persona di una foto e descrivi a parole il nuovo capo, compresi tessuto e lucentezza. Imposta aspect_ratio sulla forma della foto — il valore predefinito è 1:1 — così il risultato non diventa un quadrato che non hai chiesto.
Consigli avanzati
Scegli l’inquadratura prima di scrivere
La forma dell’output la decide aspect_ratio, non l’originale. Il valore predefinito è 1:1 e i formati disponibili sono otto, tra cui 3:2, 2:3 e 21:9; imposta quello della tua foto prima di scrivere l’istruzione.
Usa gli 800 caratteri per una scena completa
Descrivi il risultato, non l’originale. Di’ prima cosa deve restare identico, poi cosa cambia, e usa il resto per il nuovo set e la luce: tutto ciò che non viene detto può derivare.
Adatta l’esempio incluso
Parti dall’esempio pubblicato e sostituisci la direzione creativa mantenendo intatto il contratto di input di questa modalità.
Keep the woman and her satin robe from the image. Place her leaning on the bar of a narrow neon-lit cocktail lounge, and match the warm red lantern light onto her face and shoulders so it reads as one photograph.
Una rimessa in scena con un solo riferimento: la donna e la vestaglia restano, il bar al neon è descritto a parole e l’accordo della luce è chiesto in modo esplicito. L’immagine devi fornirla tu: l’URL qui è un segnaposto, non un campione ospitato.
Controlla il risultato prima di iterare
Qui non c’è un controllo dell’intensità e si accetta esattamente un riferimento: un secondo viene rifiutato prima che la richiesta lasci la piattaforma. aspect_ratio vale 1:1 per impostazione predefinita e non segue l’originale, quindi una foto verticale torna quadrata se non imposti il formato. Quanto resta dell’originale dipende da quanto è precisa l’istruzione. Fissa seed quando vuoi confrontare due formulazioni della stessa modifica sulla stessa estrazione.
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/edit",
"input": {
"aspect_ratio": "1:1",
"image_urls": [
"https://example.com/reference.png"
],
"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.


















