Introduzione
Qwen Image 2 Testo in immagine trasforma un brief scritto in una sola immagine. Legge i prompt in modo nativo in cinese e in inglese: non c’è un parametro della lingua né un passaggio di traduzione, quindi cambiare lingua di lavoro a metà progetto non cambia nulla nella richiesta.
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, in cinese o in inglese, letti nativamente senza indicatore di lingua. È un tetto vero: spendilo su soggetto, abbigliamento, set e luce, non sugli aggettivi. almeno 1 caratteri · al massimo 800 caratteri |
aspect_ratio | No | Fissa le dimensioni in uscita prima che la generazione parta, quindi sceglilo prima di scrivere il prompt: l’inquadratura viene composta per quella forma, non ritagliata dentro… |
seed | No | Omettilo per una nuova estrazione a ogni chiamata; impostalo per tenere ferma un’estrazione mentre cambi una cosa per volta. |
Prezzi
$0.035 / immagine
Casi d’uso
Partire da un brief scritto
Usa questa modalità per una scena, un’illustrazione o un concept di prodotto che non ha ancora immagini di riferimento. Scegli prima l’inquadratura — 1:1, 4:3, 3:4, 16:9 o 9:16 —, poi descrivi soggetto, composizione e luce, e confronta qualche estrazione prima di fissare una direzione.
Produzione di campagne bilingue
Il team creativo scrive il brief in cinese, un partner all’estero itera in inglese e nessuno riscrive il prompt. L’inquadratura si sceglie in partenza con aspect_ratio, così ogni posizionamento viene generato nel suo formato invece di essere ritagliato da un quadrato.
Personaggi e costumi
Accessori per costumi, oggetti di scena e set di bar al neon: brief in cui guardaroba, oggetti di scena e set devono arrivare in un unico passaggio. Fissa un seed appena un personaggio funziona, poi varia set e guardaroba attorno a un volto stabile.
Un prodotto in una scena nuova
Se non esiste ancora una foto del prodotto, descrivi l’oggetto, il materiale e il set in cui si trova, e tratta il risultato come un’immagine di concept, non come una documentazione del prodotto reale. Quando c’è una foto approvata, inviala all’endpoint di modifica e rimetti in scena quella.
Consigli avanzati
Scegli l’inquadratura prima di scrivere
aspect_ratio compone l’immagine invece di ritagliarla, quindi la descrizione deve adattarsi al formato scelto: un brief in 9:16 impila il soggetto in verticale, uno in 16:9 può distendere il set in larghezza.
Usa gli 800 caratteri per una scena completa
Soggetto, guardaroba, set, luce, obiettivo: tutto in un passaggio, in una delle due lingue. Il limite scatta prima dell’invio della richiesta, quindi taglia gli aggettivi prima della descrizione del set. Lascia fuori seed mentre cerchi una direzione; quando un’immagine merita di restare, fissa il suo seed e cambia un elemento alla volta.
Adatta l’esempio incluso
Parti dall’esempio pubblicato con aspect_ratio: 1:1. Sostituisci soggetto e direzione creativa mantenendo intatto il contratto di input di questa modalità.
Photorealistic cinematic still of a real adult woman in a dim neon cocktail bar at night, wearing a loose chocolate satin robe slipping off one shoulder, and a large fluffy orange-and-white faux fox tail accessory clipped at the small of her back, curving up behind her hip. She leans on the bar and glances back over her shoulder at the camera with a teasing half-smile. Red paper lanterns overhead, a neon sign on the back wall reading 'MIDNIGHT FOX', bottles bokeh, 35mm film grain, warm amber and crimson light.
È la richiesta esatta dietro l’immagine pubblicata: un brief quadrato che copre guardaroba, un accessorio a coda, il set del bar e la luce delle lanterne.
Controlla il risultato prima di iterare
800 caratteri sono un tetto rigido: un prompt più lungo viene rifiutato prima dell’invio, quindi investi il budget in soggetto, guardaroba, luce e obiettivo invece che negli aggettivi. Ogni richiesta restituisce un’immagine; non c’è un campo batch, quindi esplorare vuol dire ripetere la chiamata. Il testo nell’immagine non è il punto forte di questo modello: per insegne e testate usa la linea Qwen Image 3.0.
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/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1"
}
}'
# 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.
