Introduzione
Qwen Image 3.0 Testo in immagine trasforma un brief scritto in un’immagine per richiesta. Il suo tratto distintivo è la tipografia: le stringhe che metti tra virgolette — un cartellino per la porta, un’insegna da bar, il titolo di un poster — vengono rese come testo vero e non come una texture a forma di lettere.
Qwen Image 3.0 è il modello di immagini di Alibaba specializzato nella resa del testo: prompt fino a 5.000 caratteri, otto formati, un livello 1K o 2K e un endpoint di modifica che legge da uno a tre riferimenti. Senza censura, senza etichette da impostare.
Scegli la modalità di Qwen Image 3.0 in base al materiale di partenza
| Materiale di partenza | Modalità |
|---|---|
| Una direzione artistica o un brief di design scritto | Qwen Image 3.0 Testo in immagine |
| Un’immagine sorgente approvata da rivedere | Qwen Image 3.0 Modifica immagine |
Caratteristiche principali
Composizione dell’immagine attenta al testo
Qwen Image 3.0 è utile per concept visivi in cui testo fornito, composizione e trattamento dell’immagine vanno considerati insieme. Tratta le scritte generate come una bozza di design e rileggile prima della pubblicazione.
Comporre da zero e rivedere una sorgente sono lavori diversi
Usa il testo in immagine per costruire un visual da un brief scritto. Usa la modifica immagine quando un’immagine esistente fornisce identità, impaginazione o materiale da mantenere mentre si apporta una modifica precisa.
Controlla la gerarchia prima del dettaglio decorativo
Per poster, packaging e concept di campagna, decidi prima la gerarchia del messaggio e il punto focale. Un risultato gradevole manca comunque l’obiettivo se il testo approvato o i dati del prodotto non sono rappresentati correttamente.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Fino a 5.000 caratteri, in cinese o in inglese, senza alcun indicatore di lingua. almeno 1 caratteri · al massimo 5000 caratteri |
aspect_ratio | No | Compone l'inquadratura prima della generazione invece di ritagliarla dopo, quindi scegli la forma in cui l'immagine verrà pubblicata. |
resolution | No | 1k o 2k, di serie 2k, ed è l'unica variante di prezzo qui. |
num_outputs | No | Fissato a 1: ogni richiesta restituisce un'immagine. Per un provino da un solo brief, manda richieste in parallelo senza seed; ognuna viene quotata e liquidata per conto suo. |
enable_prompt_expansion | No | Attivo di serie su questa famiglia. Completa i brief scarni e riscrive quelli dettagliati, quindi disattivalo quando il tuo prompt è già una descrizione precisa dell'inquadratura. Predefinito: |
negative_prompt | No | Fino a 2.000 caratteri di esclusioni, tenute fuori dal prompt principale. al massimo 2000 caratteri |
prompt_optimization_mode | No | Come l’espansione del prompt riscrive il tuo brief mentre |
seed | No | Omettilo mentre esplori e ogni chiamata estrae il suo. Fissalo quando un'inquadratura funziona, poi cambia un altro campo alla volta per vedere che cosa ha fatto ciascuna modifica. |
Prezzi
| Specifiche | Prezzo |
|---|---|
| $0.03 / immagine |
| $0.03 / immagine |
Casi d’uso
Partire da un brief scritto
Usa questa modalità quando l’immagine non ha ancora una sorgente e parte del testo deve leggersi: un’insegna, un’etichetta, un titolo. Scegli il formato in cui pubblicherai, lascia la risoluzione su 2k e metti ogni stringa tra apici singoli dentro il prompt.
Set di personaggi e serie moda
I prompt di styling che altre API respingono girano qui senza flag. Fissa il seed che ti ha dato il personaggio, poi cambia un dettaglio per richiesta — abbigliamento, luce, posa — per ottenere un insieme coerente invece di un mucchio di risultati slegati.
Bozze di poster e packaging
Titolo, sottotitolo e una riga legale, tutti resi nell’immagine a 2k, nel formato che il posizionamento usa davvero. Utile per presentare un layout prima che un grafico metta la tipografia vera su un’immagine pulita.
Ambientazioni per hotellerie e allestimenti
Camere d’albergo, bar e hall in cui un’insegna precisa deve leggersi correttamente: cartellini per la porta, numeri di camera, carte dei cocktail, neon sopra il bancone. Genera l’immagine con il testo già al suo posto invece di sovrapporre la tipografia a un render dopo.
Consigli avanzati
Scegli prima formato e livello
aspect_ratio compone l’immagine, non la ritaglia, quindi scegli la forma in cui pubblicherai. Lascia la risoluzione a 2k ogni volta che l’immagine contiene testo; scendi a 1k solo per bozze di layout in cui nulla deve essere leggibile.
Descrivi la scena e cita il testo alla lettera
Descrivi soggetto, guardaroba, luce e obiettivo, poi metti ogni stringa esatta tra apici singoli, intorno alle otto parole. enable_prompt_expansion è attivo per impostazione predefinita e riscrive i prompt dettagliati, quindi spegnilo quando il tuo testo è già una descrizione precisa dell’inquadratura.
Adatta l’esempio incluso
Parti dall’esempio pubblicato con aspect_ratio: 3:4 e resolution: 2k. Sostituisci soggetto e direzione creativa mantenendo intatto il contratto di input di questa modalità.
Editorial photograph, an adult woman sitting on a hotel bed in a navy satin slip dress, city lights blurred through the window behind her, a brass door hanger hanging in sharp foreground reading 'DO NOT DISTURB', warm tungsten bedside lamp, cinematic 35mm, shallow focus, moody blue and amber palette.
È la richiesta esatta dietro l’immagine pubblicata: una scena d’albergo in 3:4 al livello 2k, con il testo del cartellino citato nel prompt.
Controlla il risultato prima di iterare
Le stringhe brevi tra virgolette sono il caso affidabile: una testata, un’insegna, un’etichetta, più o meno otto parole o meno per elemento. Il testo lungo come un paragrafo degenera ancora in nonsenso dall’aria plausibile, e la scrittura piccola e fitta è la prima a rompersi al livello 1k: genera la tipografia a 2k. Gli alfabeti non latini vengono resi, ma rileggili: sui glifi rari il modello è più sicuro che corretto.
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-3.0/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k",
"num_outputs": 1,
"aspect_ratio": "1:1",
"prompt_optimization_mode": "direct"
}
}'
# 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.


















