Introduzione
Cosa fa questo endpoint
Qwen Image 2.1 Turbo Modifica immagini rielabora le tue immagini sorgente seguendo un’istruzione scritta e restituisce da uno a sei nuovi fotogrammi con il checkpoint a 8 passi di Qwen Image 2.1 di Alibaba. Le nostre modifiche hanno impiegato da 26 a 59 secondi da un capo all’altro.
Input
image_urls contiene da uno a dieci riferimenti, nell’ordine in cui li chiami Image 1, Image 2 e così via. prompt è l’istruzione. Se ometti aspect_ratio, l’output mantiene la forma dell’originale a circa 2K; impostalo insieme a resolution per una dimensione fissa. num_outputs chiede da uno a sei risultati, enable_prompt_expansion (spento di default) ed enable_thinking controllano la riscrittura di Alibaba e seed stabilizza una serie.
Contenuti
Nessun filtro della piattaforma. Con l’espansione spenta, le modifiche che cambiavano un capo d’abbigliamento o scoprivano di più sono uscite come richieste; con l’espansione attiva, la stessa istruzione è tornata invariata.
| Campo | Valore |
|---|---|
| Input | Immagine |
| Output | Immagine |
| Stato su SpicyAPI | Attivo: da testo a immagine e modifica di immagini |
| Basato su | Qwen Image 2.1, come checkpoint accelerato a 8 passi dello stesso modello da 7B |
| 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 13 a 39 secondi per il da testo a immagine, da 26 a 59 per le modifiche, nei nostri test |
| Politica sui contenuti | Senza censura: nessun filtro della piattaforma, nessun flag di maggiore età |
| Pesi aperti | Qwen/Qwen-Image-2.1-Turbo con la Qwen Research License Agreement |
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | L’istruzione di modifica, fino a 5.000 caratteri. Di’ prima cosa cambia, poi cosa deve restare: viso, capelli, posa, luce. almeno 1 caratteri · al massimo 5000 caratteri |
image_urls | Sì | Da una a dieci immagini sorgente, nell’ordine in cui le richiami. Il numero di riferimenti non cambia il prezzo. almeno 1 elementi · al massimo 10 elementi |
aspect_ratio | No | Se lo ometti, il risultato mantiene la forma dell’originale a circa 2K. |
resolution | No | 1k, 1.5k o 2k, usato solo se imposti le proporzioni. Ogni livello costa uguale per immagine. |
num_outputs | No | Da uno a sei risultati dalla stessa istruzione in una sola richiesta. Ogni immagine restituita viene addebitata. |
enable_prompt_expansion | No | Spenta di default. Predefinito: |
enable_thinking | No | Dedica ragionamento extra alla riscrittura, a costo di un’attesa più lunga. Funziona solo se l’espansione del prompt è attiva. Predefinito: |
seed | No | Stabilizza un’estrazione così puoi confrontare un cambiamento alla volta. Non garantisce un’immagine identica al pixel. |
Prezzi
$0.014 / immagine
Casi d’uso
Lavori per adulti senza censura
SpicyAPI non mette alcun filtro di contenuto davanti a Turbo. Con l'espansione dei prompt disattivata, i nostri test sono usciti come scritti a ogni livello di contenuto che eseguiamo, da Lieve a Massimo, per donne e uomini allo stesso modo. Al livello Molto forte è passata una delle due esecuzioni; l'altra si è fermata prima della fine della richiesta.
Tante bozze per trovarne una buona
Otto passi e fino a sei immagini a chiamata danno un ventaglio di opzioni a basso costo. Esplora abiti, pose e luce in una sola richiesta, tieni il fotogramma che funziona e spendi le modifiche su quello.
Un personaggio lungo tutta 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 fotogramma che hai approvato invece che da un nuovo tentativo, così il volto resta lo stesso 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 si sono ritrovati a ridere fianco a fianco su un tetto al tramonto, entrambi ancora riconoscibili.
Poster e tipografia
Turbo compone con pulizia i titoli brevi. Metti le parole tra virgolette, di’ dove stanno e descrivi lo stile del poster: il nostro poster da cabaret è tornato con entrambe le righe scritte esattamente.
Foto di prodotto e copertine
Il prezzo fisso fino al 2K e sei immagini a chiamata vanno bene per miniature, copertine e foto di prodotto, dove vuoi più tagli della stessa idea e un master a dimensione piena da ridurre.
Consigli avanzati
Lascia spenta l’espansione del prompt per i lavori per adulti
L'espansione passa il prompt al riscrittore di Alibaba prima che l'immagine venga disegnata, e il riscrittore attenua i brief non filtrati: nei nostri test ha ammorbidito un'immagine di livello Forte, ha trasformato una scena di livello Molto forte in una che solo lasciava intendere, e ha restituito una modifica che chiedeva di spingersi oltre senza cambiare nulla. Con l’espansione spenta, gli stessi prompt sono usciti come scritti. Qui è spenta di default: lasciala così, a meno che tu non voglia la riscrittura.
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 una risposta un po’ più rapida.
Chiedi più immagini in una volta
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 passare alle modifiche.Per le modifiche, scrivi prima il cambiamento e poi cosa conservare
Scrivi l’unica cosa che cambia, poi tutto ciò che deve restare: “Change her dark velvet dress into a backless crimson satin gown; keep her face, hair and expression.” (cambia il suo abito di velluto scuro in un abito di raso cremisi a schiena scoperta; mantieni viso, capelli ed espressione). Indica i riferimenti con il numero. Nel nostro test con due ritratti, “the man from Image 1 and the woman from Image 2” (l’uomo dell’Image 1 e la donna dell’Image 2) ha mantenuto riconoscibili entrambi i volti nella stessa inquadratura.
Metti tra virgolette le parole che devono comparire
Scrivi il testo esatto tra virgolette e di’ dove va. Il nostro poster di prova, “VELVET HOUR” in alto e “LATE SHOW · FRIDAYS 11 PM” in basso, è tornato 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 fonte di luce e la sua direzione (una lampada calda a sinistra, un vetro rigato di pioggia dietro di lei) invece di una parola d’atmosfera. Con l’espansione spenta, Turbo disegna quello che scrivi e non riempie i vuoti al posto tuo.
Introduzione
Qwen Image 2.1 Turbo Modifica immagini cambia un’immagine esistente a partire da un’istruzione in linguaggio naturale. Il team Qwen di Alibaba ha rilasciato Turbo con pesi aperti il 9 ottobre 2026 e l’ha pensato per la creazione continua tramite modifiche in linguaggio naturale, dall’aggiunta di un accessorio al cambio di scena, in 8 passi di denoising sulla stessa architettura da 7B di Qwen Image 2.1.
Su SpicyAPI è attivo. Una richiesta accetta da uno a dieci riferimenti e restituisce da uno a sei risultati a un prezzo fisso per immagine, senza alcun filtro di contenuto davanti al modello. Ogni esempio di questa pagina è stato generato con Turbo con il prompt mostrato.
Scegli una modalità in base a ciò che hai
| Materiale di partenza | Modalità |
|---|---|
| Una o più immagini da modificare | Qwen Image 2.1 Turbo Modifica immagini |
| Un brief scritto e nient’altro | Qwen Image 2.1 Turbo Da testo a immagine |
Cosa abbiamo misurato
Velocità
Da 26 a 59 secondi per modifica da un capo all’altro nei nostri test.
Forma
Senza proporzioni, un ritratto 2:3 è tornato come inquadratura 2:3 a circa 2K (1680 × 2512). Imposta le proporzioni quando ti serve una dimensione fissa.
Contenuti
Con l'espansione dei prompt disattivata, quella predefinita, le modifiche a ogni livello di contenuto testato sono tornate come richiesto, per un ritratto di donna e uno di uomo. Con l'espansione attiva, la richiesta di spingersi oltre è tornata due volte come immagine originale invariata ed è stata addebitata come completata.
Due riferimenti
Un uomo e una donna fotografati separatamente sono tornati fianco a fianco sullo stesso tetto, entrambi riconoscibili, con l’abito di lei cambiato come richiesto.
Turbo o modifica con Qwen Image 2.1
| Turbo | Qwen Image 2.1 | |
|---|---|---|
| Passi di denoising | 8 | 40 |
| Risultati per richiesta | Da 1 a 6 | 1 |
| Prezzo per riferimento in più | Nessuno | Ognuno aumenta il prezzo |
| Maschera per modifiche locali | No | Sì |
| Formato di output | PNG | JPEG, PNG o WebP |
| Filtro di contenuto | Nessuno | Nessuno |
Scegli Turbo per catene rapide di modifiche e per il lavoro multi-riferimento a prezzo fisso. Scegli Qwen Image 2.1 quando ti serve una maschera.
Guida ai prompt e consigli
Prima il cambiamento, poi ciò che resta
“Change her dark velvet dress into a backless crimson satin gown; keep her face, hair and expression” (cambia il suo abito di velluto scuro in un abito di raso cremisi a schiena scoperta; mantieni viso, capelli ed espressione) è una modifica. “Make it better” (fallo meglio) è un nuovo tentativo.
Dai un nome a ogni riferimento
Il modello non assegna da solo i ruoli ai riferimenti. Di’ quale immagine è la persona, quale il capo d’abbigliamento e quale il luogo.
Lascia spenta l’espansione
La riscrittura può scartare la tua istruzione e restituirti l’originale. Da spenta, l’istruzione arriva al modello come l’hai scritta.
Un cambiamento per passaggio
Un solo cambiamento è facile da valutare. Cinque insieme rendono difficile capire quale istruzione abbia spostato il viso o le mani.
Dopo qualche modifica, torna all’originale
I volti possono derivare lungo una lunga catena di modifiche. Torna al primo fotogramma approvato quando i dettagli iniziano a spostarsi.
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-turbo/edit",
"input": {
"image_urls": [
"https://example.com/reference.png"
],
"num_outputs": 1,
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k"
}
}'
# 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.
