Introduzione
Cosa fa questo endpoint
Qwen Image 2.1 Pro Da testo a immagine trasforma un brief scritto in da una a sei immagini per richiesta con il livello Pro ospitato di Qwen Image 2.1 di Alibaba. Le nostre richieste hanno impiegato da 14 a 43 secondi da un capo all’altro.
Input
prompt contiene l’intero brief, fino a 5.000 caratteri. num_outputs chiede da una a sei immagini. aspect_ratio sceglie una di quindici forme e resolution il livello 1k, 1.5k o 2k, tutti allo stesso prezzo per immagine. enable_prompt_expansion (spenta di default) lascia che Alibaba riscriva prima il prompt, con prompt_optimization_mode ed enable_thinking a modellare quella riscrittura. seed stabilizza una serie.
Contenuti
Nessun filtro della piattaforma. Con l’espansione spenta, ogni test sui contenuti che abbiamo eseguito è uscito come scritto.
| Campo | Valore |
|---|---|
| Input | Testo |
| Output | Immagine |
| Stato su SpicyAPI | Attivo: da testo a immagine e modifica di immagini |
| Basato su | Qwen Image 2.1, come livello Pro ospitato di Alibaba |
| Immagini per richiesta | Da 1 a 6, addebitate per immagine restituita |
| Prezzo | Un prezzo fisso per immagine ai livelli 1k, 1.5k e 2k; la quotazione in tempo reale è in questa pagina |
| Proporzioni | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21, 2:1, 1:2, 3:1, 1:3, 5:4, 4:5 |
| Dimensioni 2K | 1:1 2048 × 2048, 16:9 2688 × 1536, 9:16 1536 × 2688, 4:3 2368 × 1760, 3:2 2496 × 1664, 2:3 1664 × 2496 |
| Modifica | Da 1 a 10 immagini di riferimento; senza proporzioni l’output segue l’originale a circa 2K |
| Prompt | Fino a 5.000 caratteri; niente prompt negativo, quindi scrivi le esclusioni nel prompt |
| Espansione del prompt | Spenta di default; se attiva, riscrittura direct o agent, con un passaggio thinking opzionale |
| Attesa misurata | Da 14 a 43 secondi per il da testo a immagine, da 39 a 48 per le modifiche, nei nostri test |
| Politica sui contenuti | Senza censura: nessun filtro della piattaforma, nessun flag di maggiore età |
| Pesi | Non pubblicati; Alibaba offre Pro come API ospitata |
Caratteristiche principali
Una testata scritta giusta al primo colpo
Metti il testo tra virgolette e di’ dove va. "AFTER DARK" in alto e la piccola riga di copertina sotto sono tornati lettera per lettera, in entrambe le immagini della richiesta.
Due ritratti, un solo tavolo a lume di candela
Un uomo e una donna fotografati separatamente, indicati come Image 1 e Image 2, finiscono allo stesso tavolo su una terrazza tra i vigneti, con entrambi i volti ancora riconoscibili e l’abito di lei cambiato come richiesto.
Pro o Turbo, senza riscrivere una riga
Pro e Turbo leggono gli stessi campi su SpicyAPI, quindi un prompt che funziona su uno si può inviare all’altro senza modifiche. Fai le bozze in fretta su Turbo e tieni su Pro i fotogrammi che contano, o viceversa.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | L’intero brief, fino a 5.000 caratteri. Scrivi soggetto, abbigliamento, posa, luce e obiettivo con frasi semplici. almeno 1 caratteri · al massimo 5000 caratteri |
aspect_ratio | No | Quindici forme, dalle strisce 3:1 e 21:9 alle colonne 1:3 e 9:21. L’inquadratura viene composta in quella forma, non ritagliata da un quadrato. |
resolution | No | 1k, 1.5k o 2k. Ogni livello costa uguale per immagine, quindi 2k è il predefinito. |
num_outputs | No | Da una a sei immagini dallo stesso prompt in una sola richiesta. Ogni immagine restituita viene addebitata, quindi sei immagini costano sei volte una. |
enable_prompt_expansion | No | Disattivata di default, quindi la tua formulazione viene disegnata come scritta. Predefinito: |
enable_thinking | No | Dedica ragionamento extra alla riscrittura per un’immagine migliore, a costo di un’attesa più lunga. Funziona solo se l’espansione del prompt è attiva. Predefinito: |
prompt_optimization_mode | No | Come l’espansione riscrive il brief quando è attiva: direct è un solo passaggio e va bene per la maggior parte dei prompt, agent è una riscrittura in più passaggi con più dettag… |
seed | No | Stabilizza un’estrazione così puoi cambiare una cosa alla volta e confrontare in modo equo. Non garantisce un’immagine identica al pixel. |
Prezzi
$0.036 / immagine
Casi d’uso
Lavoro sulle immagini senza censura
SpicyAPI non mette alcun filtro dei contenuti davanti a Pro. Con l’espansione del prompt disattivata, i nostri test sono tornati come scritti a ogni livello di intensità che abbiamo provato, dal Lieve al Massimo, con soggetti femminili e maschili.
Copertine e poster con testo esatto
Alibaba indica una tipografia migliorata per Pro. Metti tra virgolette la testata e la riga di copertina, di’ dove sta ciascuna e descrivi la fotografia: la nostra copertina di rivista è tornata con entrambe le righe scritte esattamente, in entrambe le immagini della richiesta.
Un solo personaggio in una serie
Genera un personaggio, poi rimanda il fotogramma come riferimento e cambia l’abito, la stanza o la luce in passaggi separati. Ogni modifica parte dal tuo fotogramma approvato invece che da un nuovo tentativo, così il volto resta coerente in tutta la serie.
Coppie da due ritratti
Invia due ritratti come Image 1 e Image 2 e descrivi la scena che condividono. Nel nostro test un uomo e una donna fotografati separatamente sono finiti allo stesso tavolo a lume di candela su una terrazza tra i vigneti, entrambi ancora riconoscibili.
Ritratti d’atmosfera e luce
Alibaba indica la luce dei ritratti e il dettaglio fine come punti di forza di Pro. Indica una sola sorgente di luce e dove cade, una lampada da tempesta, una finestra alta, un’applique, e l’inquadratura si costruisce attorno a essa.
Molte bozze prima di quella buona
Fino a sei immagini a chiamata a un prezzo fisso danno un ventaglio di opzioni a basso costo. Esplora abbigliamento, posa e luce in una sola richiesta, tieni il fotogramma che funziona e spendi le tue modifiche su quello.
Consigli avanzati
Lascia spenta l’espansione del prompt quando conta la formulazione
L’espansione passa il tuo prompt al riscrittore di Alibaba prima che l’immagine venga disegnata, e quella riscrittura può attenuare una richiesta audace. Qui è disattivata di default, e ogni test sui contenuti che abbiamo fatto con l’espansione disattivata è tornato come scritto. Nella nostra unica esecuzione Pro con l’espansione attiva, un prompt che l’app ufficiale bloccherebbe è passato comunque, ma tienila disattivata ogni volta che conta la formulazione esatta.
Accendila per i prompt brevi di uso quotidiano
Un brief di sei parole ottiene una scena più ricca con l’espansione attiva. direct riscrive in un solo passaggio e va bene per la maggior parte dei prompt; agent riscrive in più passaggi per un risultato più fine. La modalità thinking dedica ragionamento extra a quella riscrittura e allunga i tempi; non fa nulla finché l’espansione è spenta.
Usa il 2K, costa uguale
Ogni livello ha lo stesso prezzo per immagine, quindi 2K è il predefinito e la scelta sensata. Scendi a 1k solo se vuoi un file più piccolo o un ritorno un po’ più rapido.
Chiedi più immagini insieme
Imposta
num_outputsda 1 a 6 per ottenere varianti dello stesso prompt in una sola chiamata. Ogni immagine restituita viene addebitata, quindi sei immagini costano sei volte una. È il modo più economico per trovare una posa o una composizione che ti piace prima di iniziare a modificare.Modifica con il cambiamento prima e l’elenco di ciò che resta dopo
Scrivi prima l’unica cosa che cambia, poi tutto ciò che deve restare: «Cambia il suo abito di velluto in un abito da sera avorio; mantieni volto, capelli ed espressione». Indica i riferimenti per numero. Nel nostro test con due ritratti, «l’uomo dell’immagine 1 e la donna dell’immagine 2» a un tavolo a lume di candela hanno mantenuto entrambi i volti riconoscibili in un unico fotogramma.
Metti tra virgolette le parole che devono comparire
Scrivi il testo esatto tra virgolette e di’ dove va. La nostra copertina di rivista, "AFTER DARK" in alto e "THE SILK ISSUE · NO. 07" in piccolo sotto, è tornata lettera per lettera. Tieni ogni riga breve e controllala a dimensione piena prima di pubblicare.
Scrivi il prompt in un ordine fisso
Soggetto, abbigliamento, posa, luce, obiettivo e palette, con frasi semplici. Indica la sorgente di luce e la sua direzione (una lampada a olio a sinistra, un fascio rotante dietro di lei) invece di una parola d’atmosfera. Con l’espansione spenta, Pro disegna ciò che scrivi e non riempie i vuoti al posto tuo.
Introduzione
Qwen Image 2.1 Pro Da testo a immagine trasforma un brief scritto in immagini. Pro è il livello ospitato di Qwen Image 2.1 di Alibaba, che Alibaba ha annunciato come ufficialmente attivo insieme all’API Turbo il 9 ottobre 2026 e descrive come un equilibrio tra qualità di generazione, efficienza di inferenza e costo, con tipografia, luce dei ritratti e dettaglio fine migliorati. Alibaba lo offre come API e non ne ha pubblicato i pesi.
Su SpicyAPI è attivo. Una richiesta restituisce da una a sei immagini, i livelli 1k, 1.5k e 2k costano uguale per immagine e davanti al modello non c’è alcun filtro di contenuto. Ogni immagine di questa pagina è stata generata con Pro con il prompt mostrato.
Scegli una modalità in base a ciò che hai
| Materiale di partenza | Modalità |
|---|---|
| Un brief scritto e nient’altro | Qwen Image 2.1 Pro Da testo a immagine |
| Una o più immagini da modificare | Qwen Image 2.1 Pro Modifica immagini |
Cosa abbiamo misurato
Velocità
Da 14 a 31 secondi per una singola immagine e da 39 a 43 secondi per due immagini 2K in una sola chiamata, da un capo all’altro nei nostri test. L’espansione del prompt e la modalità thinking aggiungono tempo quando sono attive.
Contenuti
Con l’espansione del prompt disattivata, che è il predefinito, ogni test sui contenuti è tornato come scritto, dal Lieve fino al livello Massimo, con un soggetto femminile e uno maschile. Nemmeno una richiesta è stata rifiutata. Nella nostra unica esecuzione con l’espansione attiva, un prompt senza filtro è tornato comunque come richiesto.
Testo nell’immagine
La nostra copertina di rivista chiedeva "AFTER DARK" come testata e "THE SILK ISSUE · NO. 07" sotto, e li ha ottenuti entrambi, lettera per lettera, in entrambe le immagini della richiesta.
Dimensioni a 2K
| Proporzioni | Dimensioni di output |
|---|---|
| 1:1 | 2048 × 2048 |
| 16:9 | 2688 × 1536 |
| 9:16 | 1536 × 2688 |
| 4:3 | 2368 × 1760 |
| 3:2 | 2496 × 1664 |
| 2:3 | 1664 × 2496 |
In tutto quindici proporzioni, da 3:1 a 1:3, a 1k, 1.5k e 2k. L’output è PNG.
Pro o Turbo
| Pro | Turbo | |
|---|---|---|
| Che cos’è | Livello Pro ospitato di Alibaba | Checkpoint a 8 passi |
| Pesi | Non pubblicati | Aperti, Qwen Research License |
| Immagini per richiesta | Da 1 a 6 | Da 1 a 6 |
| Prezzo per livello | Fisso | Fisso |
| Prezzo per immagine | Più alto | Più basso |
| Filtro di contenuto | Nessuno | Nessuno |
La richiesta è la stessa, quindi puoi inviare un prompt a entrambi e tenere il risultato che preferisci. Alibaba non ha pubblicato un confronto di qualità tra i due.
Guida ai prompt e consigli su Pro
Tieni spenta l’espansione per una formulazione esatta
La riscrittura può attenuare una richiesta audace. Disattivata, Pro disegna ciò che scrivi.
Accendi l’espansione per i prompt brevi di uso quotidiano
Un’idea di sei parole ottiene una scena più ricca. direct va bene per la maggior parte dei prompt, agent riscrive con più dettaglio e la modalità thinking dedica tempo extra a una riscrittura migliore.
Scrivi in un ordine fisso
Soggetto, abbigliamento, posa, luce, obiettivo e palette, con frasi semplici. Indica la sorgente di luce e la sua direzione invece di una parola d’atmosfera.
Metti tra virgolette le parole che devono comparire
Scrivi il testo esatto tra virgolette, tieni ogni riga breve e di’ dove si trova.
Chiedine sei, tienine una
Le varianti costano uguale ciascuna, quindi una richiesta da sei immagini è il modo più rapido per trovare la posa o la composizione che vale la pena modificare.
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-pro/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.
