Introduzione
Qwen Image Edit Spicy modifica una sola immagine sorgente con una sola istruzione in inglese semplice. Non ci sono maschera, selettore di zona né controllo dello scostamento: la frase è l’unico comando, e resta protetto solo ciò che nomini.
La richiesta è image_url, prompt e un seed facoltativo; un seed pari a 0 chiede un’estrazione casuale. Ogni richiesta restituisce un’immagine.
Caratteristiche principali
Niente maschera, niente intensità, niente flusso di inpainting
La maggior parte degli editor ti fa scegliere una zona e un grado di scostamento prima di poter cambiare qualcosa. Questo prende una frase. Nomina cosa cambia, nomina cosa deve restare e inviala. L’assenza di un controllo dell’intensità è voluta: la conservazione si esprime a parole, ed è anche così che una modifica si verifica dopo.
Cambi di look audaci, non filtrati
Un cambio di look che gli editor filtrati rifiutano è qui un'istruzione ordinaria, non un caso speciale. Non c’è un flag di maturità da impostare né un altro endpoint verso cui la richiesta venga deviata. Le tue formulazioni nell’istruzione passano così come sono scritte.
Riscrivi un’insegna senza ridisegnare la stanza
Poiché eredita la tipografia della linea Qwen Image, può cambiare un testo già presente nell’immagine: un cartellino per la porta, una lavagna del menu, l’etichetta di una bottiglia. Cita la stringa che c’è e quella che vuoi, e specifica che posa, inquadratura e color grading restano intatti.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
image_url | Sì | Un link pubblico e scaricabile direttamente a un’immagine di cui detieni i diritti. almeno 1 caratteri |
prompt | Sì | Un’unica istruzione che porta entrambe le metà della modifica. almeno 1 caratteri |
seed | No | Passa lo stesso seed con la stessa immagine e la stessa istruzione per tenere identico il disegno tra due modifiche, così l’unica differenza è quello che hai cambiato; è uno str… |
Prezzi
$0.038 / immagine
Casi d’uso
Rifinire un’immagine fornita
Usa questo endpoint quando una foto esistente deve restare quella foto e deve cambiare una sola cosa. Inviala come image_url, nomina la modifica e gli elementi che devono restare — posa, inquadratura, luce, color grading — e confronta il risultato con l’originale.
Istruzioni che altri editor rifiutano
Le istruzioni audaci sul guardaroba che le API di modifica con filtri respingono qui girano come modifiche ordinarie. Nella richiesta non cambia nulla: stessi nomi dei campi, stesso ciclo di vita del task, stessa interrogazione asincrona del risultato.
Cambi di guardaroba su un’immagine approvata
Hai già un ritratto in cui posa e luce funzionano. Sostituisci il look con abiti da sera o con un aspetto più audace senza rigenerare la scena, così viso, stanza e grading restano invariati e il set resta coerente.
Varianti di testo su una foto già pagata
Cambia solo le parole di un’insegna, di un cartellino o di un’etichetta e lascia la fotografia identica. Costa meno ed è molto più coerente che rigenerare l’intera scena per ogni lingua o per ogni riga della campagna.
Consigli avanzati
Ospita l’immagine sorgente in un posto raggiungibile
image_url deve essere un link pubblico scaricabile direttamente: non una pagina di visualizzazione né un URL firmato che scade prima che il task venga eseguito. L’originale fissa la composizione e il tetto di qualità dell’intero passaggio.
Scrivi un’istruzione che nomini entrambi i lati della modifica
Di’ cosa cambia e cosa deve restare identico, con una frase ciascuno. La modifica di questo endpoint è nata da: «Keep the woman, the bed and the hotel room exactly as they are. Change her outfit to a black lace bodysuit with sheer black stockings, and change the brass door hanger text to read 'BACK AT MIDNIGHT'. Keep the same pose, framing, lighting and colour grade.»
Adatta l’esempio incluso
Parti dall’esempio pubblicato, con un URL pubblicamente accessibile in image_url. Sostituisci soggetto e direzione creativa mantenendo intatto il contratto di input di questa modalità.
Keep the woman, the bed and the hotel room exactly as they are. Change her outfit to a black lace bodysuit with sheer black stockings, and change the brass door hanger text to read 'BACK AT MIDNIGHT'. Keep the same pose, framing, lighting and colour grade.
L'istruzione esatta dietro la modifica mostrata per questo endpoint: un cambio di look più un cambio di testo sul gancio della porta, con posa, inquadratura, illuminazione e grading tutti indicati come invariati. Fornisci la tua immagine sorgente: l’image_url qui è un segnaposto, non un campione ospitato.
Controlla il risultato prima di iterare
La strada affidabile è una modifica per chiamata, nominando esplicitamente ciò che si conserva: posa, inquadratura, luce, color grading. Se chiedi un cambio di guardaroba e un cambio di testo nella stessa istruzione, di solito uno dei due deriva. L’identità regge bene su una singola modifica mirata e peggiora nelle catene lunghe, quindi riparti dall’originale invece che dall’output precedente. Non c’è un controllo dell’intensità: se una modifica è andata troppo oltre, la soluzione è una frase più precisa, non un numero più basso.
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-spicy-edit/edit",
"input": {
"image_url": "https://example.com/reference.png",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# 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.
