Introduzione
Cosa fa questo endpoint
Qwen Image 2.1 Pro Modifica immagini rivede le tue immagini sorgente in base a un’istruzione scritta e restituisce da uno a sei nuovi fotogrammi con il livello Pro ospitato di Qwen Image 2.1 di Alibaba. Le nostre modifiche hanno impiegato da 39 a 48 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. Ometti aspect_ratio per mantenere la forma dell’originale a circa 2K, oppure impostala insieme a resolution per una dimensione fissa. num_outputs chiede da uno a sei risultati, enable_prompt_expansion (spenta di default) ed enable_thinking controllano la riscrittura di Alibaba e seed stabilizza una serie.
Contenuti
Nessun filtro della piattaforma. Con l’espansione disattivata, ogni modifica testata è tornata come richiesto, a tutti e cinque i livelli di intensità, dal Lieve al Massimo.
| 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 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’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 | Disattivata di default, quindi la tua istruzione arriva al modello come scritta. Attivata, Alibaba la riscrive prima, e questo può attenuare una richiesta più audace. 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.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 Modifica immagini cambia un’immagine esistente a partire da un’istruzione in linguaggio naturale. Pro è il livello ospitato di Qwen Image 2.1 di Alibaba, che riunisce generazione e modifica in un solo modello; Alibaba indica la modifica con fino a dieci riferimenti, modifiche locali che lasciano intatti persone e prodotti, e luce dei ritratti e dettaglio fine migliorati.
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 Pro 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 Pro Modifica immagini |
| Un brief scritto e nient’altro | Qwen Image 2.1 Pro Da testo a immagine |
Cosa abbiamo misurato
Velocità
Da 39 a 48 secondi per modifica da un capo all’altro nei nostri test, compresi due risultati da due riferimenti in una sola chiamata.
Forma
Senza proporzioni, un ritratto 2:3 è tornato come inquadratura 2:3 a circa 2K (1664 × 2496). Imposta le proporzioni quando ti serve una dimensione fissa.
Contenuti
Con l’espansione del prompt disattivata, che è il predefinito, ogni modifica testata è tornata come richiesto, a tutti e cinque i livelli di intensità, dal Lieve al Massimo. Nemmeno una modifica è stata rifiutata.
Due riferimenti
Un uomo e una donna fotografati separatamente sono tornati fianco a fianco allo stesso tavolo a lume di candela, entrambi riconoscibili, con l’abito di lei cambiato come richiesto.
Modifica con Pro o con Turbo
| Pro | Turbo | |
|---|---|---|
| Che cos’è | Livello Pro ospitato di Alibaba | Checkpoint a 8 passi |
| Pesi | Non pubblicati | Aperti, Qwen Research License |
| Risultati per richiesta | Da 1 a 6 | Da 1 a 6 |
| Prezzo per riferimento in più | Nessuno | Nessuno |
| Prezzo per immagine | Più alto | Più basso |
| Filtro di contenuto | Nessuno | Nessuno |
La richiesta è la stessa, quindi puoi eseguire un’istruzione su entrambi e tenere il risultato che preferisci.
Guida ai prompt e consigli su Pro
Prima il cambiamento, poi ciò che resta
«Cambia il suo abito di velluto in un abito da sera avorio; mantieni volto, capelli ed espressione» è una modifica. «Rendilo migliore» è un nuovo tiro.
Nomina ogni riferimento
Il modello non assegna da solo dei ruoli ai riferimenti. Di’ quale immagine è la persona, quale è l’indumento e quale è il luogo.
Lascia spenta l’espansione
La riscrittura può smorzare la tua istruzione prima che il modello la veda. Spenta, l’istruzione arriva al modello come scritta.
Un cambiamento per passaggio
Un singolo cambiamento è facile da valutare. Cinque insieme rendono difficile capire quale istruzione abbia spostato il viso o le mani.
Torna all’originale dopo qualche modifica
I volti possono derivare lungo una catena lunga di modifiche. Torna al primo fotogramma approvato quando i dettagli iniziano a muoversi.
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/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.
